2
<body BGCOLOR="FFFFFF">
4
<h1> Docs: Changes: 2.1.1</h1>
7
<p align="center"><font color="#FF0000" size="5"><a
8
name="CHANGES">CHANGES</a> in PETSc 2.1.1 (see new <a href="#Features">features</a>)</font></p>
9
<p><font size="4"><strong><u>General:</u></strong></font>
10
<p>Scalar -> PetscScalar ( and added PetscReal)
11
<p>The make files are reorganized. bmake/${PETSC_ARCH}/base_variables ->
12
variables, and base.site -> packages. base ->rules.<p>If using
13
makefiles from earlier version of PETSc, change<br>
14
<i>include ${PETSC_DIR}/bmake/${PETSC_ARCH}/base</i><br>
16
<i>include ${PETSC_DIR}/bmake/common/base</i><p>The windows build of
17
PETSc with win32_gnu, win32_intel and win32_mpich now default to using
18
MPICH-1.2.3 <p>The complex version of the PETSc libraries can only be
19
installed with C++ compilers that provide the std::complex implementation.
20
<p><font size="4"><strong><u>AO (Application Orderings):</u></strong></font></p>
21
<p><font size="4"><strong><u>TS (Timestepping Solvers):</u></strong></font>
22
<p><font size="4"><strong><u>DMMG</u></strong></font><p>Default Krylov
23
method on outer linear solver is now FGMRES instead of GMRES. Also default
24
multigrid type is now full instead of multiplicative
25
<p><font size="4"><strong><u>SNES (Nonlinear Solvers):</u></strong></font>
26
<p><font size="4"><strong><u>SLES (Linear Solvers):</u></strong></font>
27
<p><font size="4"><strong><u>KSP (Krylov Subspace Methods):</u></strong></font>
28
<p align="left"> All KSP methods with left preconditioning use the
29
preconditioned residual by default (before CG, CR used the unpreconditioned
30
residual). Use -ksp_norm_type <none,preconditioned,unpreconditioned,natural>
31
to change it, see next bullet.<p><b>KSPSetInitialGuessNonzero(),
32
KSPSetComputeSingularValues(), KSPSetComputeEigenvalues(),</b> all now take a PetscTruth as the second argument allowing them to each be
33
toggled on or off<p><b>KSPSetAvoidNorms(), KSPSetUseUnpreconditionedResidual(),
34
KSPSetComputeResidual()</b> have all been merged into <b>KSPSetNormType()</b>
35
<p><font size="4"><strong><u>PC (Preconditioners): </u></strong></font>
37
<p><font size="4"><strong><u>MAT (Matrices): </u></strong></font>
38
<p><font size="4">Added additional local relaxation argument to <u>MatRelax()</u></font>
39
<p><font size="4">Added additional argument to <u>MatAXPY()</u></font>
40
<p> - MatSNESMFFormJacobian() has been renamed to MatSNESMFComputeJacobian().
41
added another field to MatLUInfo and MatILUInfo
42
<p> - MatCreate() now requires a call to MatSetType() or MatSetFromOptions()
43
- The MatType is assigned in either of these calls.<br>
44
<p><font size="4"><strong><u>DA (Distributed Arrays): </u></strong></font>
45
<p>In order to set the grid sizes with -da_grid_x, -da_grid_y, -da_grid_z
46
one must pass in negative values for the M, N, and P arguments in the call
47
to DACreateXX(). If values are not set from the options database then the
48
absolute value of the M,N,P is used as the default.
49
<p>Changed DAGetColoring() to two routines, DAGetColoring() and DAGetMatrix()
50
<p><u><strong><font size="4">VEC (Vectors):
51
</font></strong></u><p>Changed VecCreate() to no longer take in size
52
arguments. Use VecCreate() & VecSetSizes()<br>
53
<font size="4"><strong><u><br>
54
IS (Index Sets): </u></strong></font>
55
<p>Changed IS_COLORING_LOCAL to IS_COLORING_GHOSTED and IS_COLORING_GLOBAL
56
to IS_COLORING_LOCAL
57
<p><font size="4"><strong><u>General:</u></strong></font><p><font size="4"><strong>PetscOptionsGetDouble()
58
</strong>is now<strong> PetscOptionsGetReal()</strong></font>
59
<p><font size="4"><strong><u>Draw (Graphics):</u></strong></font>
60
<p><font size="4"><strong><u>Viewers: </u></strong></font>
61
<p><font size="4"><strong><u>System:</u></strong></font>
62
<p><font size="4"><strong><u>Error Handling:</u></strong></font></p>
63
<p><font size="4"><strong><u>Event Logging:</u></strong></font></p>
64
<p>Logging functionality is completely reworked. Now one can register new
65
stages, classes and events. Every event is associated with a class. So,
66
users would have to create a class for all userevents. </p>
67
<p><b>PetscLogStageRegister()</b> now takes an int * as the first argument</p>
68
<p><b>PetscLogEventRegister() </b>takes an int as the third argument, not a
70
<p><font size="4"><strong><u>Fortran Interface:</u></strong></font> </p>
72
<p align="center"><font color="#FF0000" size="5">New <a name="Features">Features</a> in
73
PETSc 2.1.1 (see <a href="#CHANGES">changes</a> above)</font></p>
74
<p><font size="4"><strong><u>General:</u></strong></font>
75
<p>configure can now be used to build PETSc on some architectures. Currently
76
tested on linux, IRIX, solaris machines. We'd like your feedback on
77
this feature; please send <b>configure_petsc.log</b> and <b>config.log </b>when
78
reporting problems with configure.
79
<p>Added support for ESI vectors and matrices. Use BOPT=g_c++ or O_c++<p>Better
80
support for automatic differentiation with ADIC
81
<p><font size="4"><strong><u>AO (Application Orderings):</u></strong></font>
82
<p><font size="4"><strong><u>TS (Timestepping Solvers):</u></strong></font>
83
<p><font size="4"><strong><u>SNES (Nonlinear Solvers): </u></strong></font>
84
<p><font size="4"><strong><u>SLES (Linear Solvers):</u></strong></font>
85
<p><font size="4"><strong><u>KSP (Krylov Subspace Methods):</u></strong></font>
86
<p><font size="4"><strong><u>PC (Preconditioners): </u></strong></font>
87
<p>added -pc_lu_zeropivot and -pc_ilu_zeropivot (still need function interfaces)<br>
89
<p><font size="4"><strong><u>MAT (Matrices): </u></strong></font>
90
<p><font size="4"><strong><u>DA (Distributed Arrays): </u></strong></font>
91
<p> Added DAGetArray() and DARestoreArray() that give workspace
92
appropriate for a local function. These may be used in routines that
93
diverentiated with ADIC:-)<p><font size="4"><strong><u>VEC (Vectors):</u></strong></font>
94
<p> Added the utility routines which do special cases of vecscatters
95
VecConvertMPIToSeqAll(),VecConvertMPIToMPIZero()<br>
96
<p><font size="4"><strong><u>IS (Index Sets): </u></strong></font>
97
<p><font size="4"><strong><u>PF:</u></strong></font>
98
<p><font size="4"><strong><u>Draw (Graphics):</u></strong></font>
99
<p>added DrawEllipse()
100
<p><font size="4"><strong><u>Viewers: </u></strong></font>
101
<p>added PetscViewerASCIISetMode()
102
<p><font size="4"><strong><u>System:</u></strong></font>
103
<p><font size="4"><strong><u>Error Handling:</u></strong></font></p>
104
<p><font size="4"><strong><u>Event Logging:</u></strong></font></p>
105
<p><font size="4"><strong><u>Fortran Interface:</u></strong></font>