1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head> <link rel="canonical" href="http://www.mcs.anl.gov/petsc/petsc-current/docs/changes/211.html" />
<meta http-equiv="content-type" content="text/html;charset=utf-8">
<title>Documentation: Changes: 2.1.1</title>
</head>
<body bgcolor="#ffffff">
<div id="version" align=right><b>petsc-3.7.5 2017-01-01</b></div>
<div id="bugreport" align=right><a href="mailto:petsc-maint@mcs.anl.gov?subject=Typo or Error in Documentation &body=Please describe the typo or error in the documentation: petsc-3.7.5 v3.7.5 docs/changes/211.html "><small>Report Typos and Errors</small></a></div>
<h1>Documentation: Changes: 2.1.1</h1>
<style type="text/css">
h2 {
color: red;
}
h4 {
font-weight: bold;
text-decoration: underline;
}
</style>
<div id="main">
<div align="center">
<h2><a name="CHANGES">CHANGES</a> in PETSc 2.1.1 (see new <a href="#Features">features</a>)</h2>
</div>
<h4>General:</h4>
<ul>
<li>Scalar -> PetscScalar (and added PetscReal)</li>
<li>
The make files are reorganized. bmake/${PETSC_ARCH}/base_variables
-> variables, and base.site -> packages. base ->rules.
</li>
<li>
If using makefiles from earlier version of PETSc, change
<ul>
<li><code>include ${PETSC_DIR}/bmake/${PETSC_ARCH}/base</code></li>
</ul>
to
<ul>
<li><code>include ${PETSC_DIR}/conf/base</code></li>
</ul>
</li>
<li>
The windows build of PETSc with win32_gnu, win32_intel and
win32_mpich now default to using MPICH-1.2.3The complex version of
the PETSc libraries can only be installed with C++ compilers that
provide the std::complex implementation.
</li>
</ul>
<h4>AO (Application Orderings):</h4>
<h4>TS (Timestepping Solvers):</h4>
<h4>DMMG</h4>
<ul>
<li>
Default Krylov method on outer linear solver is now FGMRES instead
of GMRES. Also default multigrid type is now full instead of
multiplicative
</li>
</ul>
<h4>SNES (Nonlinear Solvers):</h4>
<h4>SLES (Linear Solvers):</h4>
<h4>KSP (Krylov Subspace Methods):</h4>
<ul>
<li>
All KSP methods with left preconditioning use the preconditioned
residual by default (before CG, CR used the unpreconditioned
residual). Use -ksp_norm_type <none,preconditioned,unpreconditioned,natural>
to change it, see next bullet.
</li>
<li>
<code>KSPSetInitialGuessNonzero(), KSPSetComputeSingularValues(), KSPSetComputeEigenvalues(),</code>
all now take a PetscTruth as the second argument allowing them to each be toggled on or off
</li>
<li>
<code>KSPSetAvoidNorms(), KSPSetUseUnpreconditionedResidual(),
KSPSetComputeResidual()</code> have all been merged into
<code>KSPSetNormType()</code>
</li>
</ul>
<h4>PC (Preconditioners):</h4>
<h4>MAT (Matrices):</h4>
<ul>
<li>Added additional local relaxation argument to <code>MatRelax()</code></li>
<li>
Added additional argument to <code>MatAXPY()</code>
<ul>
<li>MatSNESMFFormJacobian() has been renamed to MatSNESMFComputeJacobian()</li>
<li>added another field to MatLUInfo and MatILUInfo</li>
<li>MatCreate() now requires a call to MatSetType() or MatSetFromOptions()</li>
<li>The MatType is assigned in either of these calls.</li>
</ul>
</li>
</ul>
<h4>DA (Distributed Arrays):</h4>
In order to set the grid sizes with -da_grid_x, -da_grid_y, -da_grid_z
one must pass in negative values for the M, N, and P arguments in the call
to DACreateXX(). If values are not set from the options database then the
absolute value of the M,N,P is used as the default.
<ul>
<li>Changed DAGetColoring() to two routines, DAGetColoring() and DAGetMatrix()</li>
</ul>
<h4>VEC (Vectors):</h4>
<ul>
<li>Changed VecCreate() to no longer take in size arguments. Use VecCreate() & VecSetSizes()</li>
</ul>
<h4>IS (Index Sets):</h4>
<ul>
<li>Changed IS_COLORING_LOCAL to IS_COLORING_GHOSTED and IS_COLORING_GLOBAL to IS_COLORING_LOCAL</li>
</ul>
<h4>General:</h4>
<code>PetscOptionsGetDouble()</code> is now <code>PetscOptionsGetReal()</code>
<h4>Draw (Graphics):</h4>
<h4>Viewers:</h4>
<h4>System:</h4>
<h4>Error Handling:</h4>
<h4>Event Logging:</h4>
Logging functionality is completely reworked. Now one can register new
stages, classes and events. Every event is associated with a class. So,
users would have to create a class for all userevents.
<ul>
<li><code>PetscLogStageRegister()</code> now takes an int * as the first argument</li>
<li><code>PetscLogEventRegister()</code> takes an int as the third argument, not a char *</li>
</ul>
<h4>Fortran Interface:</h4>
<div align="center">
<h2>New features in PETSc 2.1.1 (see <a href="#CHANGES">changes</a> above)</h2>
</div>
<h4>General:</h4>
<ul>
<li>
configure can now be used to build PETSc on some architectures.
Currently tested on linux, IRIX, solaris machines.We'd like your
feedback on this feature; please send <code>configure_petsc.log</code> and
<code>config.log</code>when reporting problems with configure.
</li>
<li>Added support for ESI vectors and matrices. Use BOPT=g_c++ or O_c++Better</li>
<li>support for automatic differentiation with ADIC</li>
</ul>
<h4>AO (Application Orderings):</h4>
<h4>TS (Timestepping Solvers):</h4>
<h4>SNES (Nonlinear Solvers):</h4>
<h4>SLES (Linear Solvers):</h4>
<h4>KSP (Krylov Subspace Methods):</h4>
<h4>PC (Preconditioners):</h4>
<ul>
<li>added -pc_lu_zeropivot and -pc_ilu_zeropivot (still need function interfaces)</li>
</ul>
<h4>MAT (Matrices):</h4>
<h4>DA (Distributed Arrays):</h4>
Added DAGetArray() and DARestoreArray() that give workspace appropriate
for a local function. These may be used in routines that diverentiated
with ADIC:-)
<h4>VEC (Vectors):</h4>
<ul>
<li>
Added the utility routines which do special cases of vecscatters
VecConvertMPIToSeqAll(),VecConvertMPIToMPIZero()
</li>
</ul>
<h4>IS (Index Sets):</h4>
<h4>PF:</h4>
<h4>Draw (Graphics):</h4>
<ul>
<li>added DrawEllipse()</li>
</ul>
<h4>Viewers:</h4>
<ul>
<li>added PetscViewerASCIISetMode()</li>
</ul>
<h4>System:</h4>
<h4>Error Handling:</h4>
<h4>Event Logging:</h4>
<h4>Fortran Interface:</h4>
</div>
</body>
</html>
|
