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
|
<html>
<body BGCOLOR="FFFFFF">
<h1> Docs: Changes: 2.3.0</h1>
<p align="center"><font color="#ff0000" size="5"><a name="CHANGES">CHANGES</a>
in PETSc 2.3.0 </font></p>
<p><u><b>General:</b></u></p>
<ul>
<li>BOPT cocept is removed. Currently the functionality is
replaced with configure options. i.e:<br>
c++
->
--with-clanguage=cxx
[default: c]<br>
complex ->
--with-scalar-type=complex [default: real]<br>
O
->
--with-debugging=0
[default: 1]<br>
The equivalent of building BOPT=g, BOPT=O versions for
PETSC_ARCH=linux-gnu is now:<br>
config/configure.py [options] -PETSC_ARCH=linux-gnu<br>
config/configure.py [options] --with-debugging=0
-PETSC_ARCH=linux-gnu-opt<br>
<br>
</li>
<li>Python bindings added to PETSc. <br>
To use, configure with: --with-python=1 ---with-shared=1<br>
To build, use: 'make python' after building PETSc libraries.<br>
Example in src/snes/examples/tutorials/ex1.py<br>
</li>
<li>Options database keys -trmalloc[_xxx] are changed to
-malloc[_xxx] </li>
<li>-get_resident_set_size and -trinfo are changed to
-memory_info </li>
<li>PetscTrValid() -> PetscMallocValidate(), PetscTrDebug()
-> PetscMallocDebug() </li>
<li>-trdebug -> -malloc_debug </li>
<li>PetscGetResidentSetSize() ->
PetscMemoryGetCurrentUsage(), added PetscMemoryGetMaximumUsage() and
PetscMemorySetGetMaximumUsage() </li>
<li>PetscTrSpace() -> PetscMallocGetCurrentUsage() and
PetscMallocGetMaximumUsage() </li>
<li>added PetscOptionsEnum() and PetscOptionsGetEnum() </li>
<li>added PetscBag object for managing user created structs
including initializing them and serializing them. </li>
<li>removed PetscSetCommWorld(). Now you can directly assign to PETSC_COMM_WORLD before PetscInitialize().</li>
</ul>
<p></p>
<p><u><b>Vec:</b></u></p>
<ul>
<li>Faster generation of VecScatter for many processes when
indices are mostly sorted</li>
<li>Changed BLAS-type interfaces to PETSc-style:
<ul>
<li>VecShift</li>
<li>VecScale</li>
<li>VecSet</li>
<li>VecSetRandom</li>
<li>VecAXPY</li>
<li>VecAXPBY</li>
<li>VecAYPX</li>
<li>VecMAXPY</li>
<li>VecWAXPY</li>
</ul>
</li>
<li>Changed order of arguments in pointwise routines:
<ul>
<li>VecPointwiseMult</li>
<li>VecPointwiseMax</li>
<li>VecPointwiseMin</li>
<li>VecPointwiseMaxAbs</li>
<li>VecPointwiseDivide</li>
</ul>
</li>
</ul>
<p></p>
<p><u><b>Mat:</b></u></p>
<ul>
<li>Changed MatConvert to require a reuse parameter to denote
inplace converstion</li>
<li>Added Cholesky and ICC support to SeqBAIJ</li>
<li>Added the argument MatFactorInfo to MatLUFactorNumeric()
and MatCholeskyFactorNumeric()</li>
<li>Faster MatSetValues()</li>
<li>Faster parallel-matrix vector products</li>
<li>Changed MatCreate() to take only a communicator</li>
<li>Added MatSetSize() to specify matrix sizes</li>
<li>Changed BLAS-type interfaces to PETSc-style:
<ul>
<li>MatAXPY</li>
<li>MatAYPX</li>
<li>MatScale</li>
<li>MatShift</li>
</ul>
</li>
<li>Change MatZeroRows() and MatZeroRowsLocal() to use arrays,
and added IS versions</li>
</ul>
<p></p>
<p><u><b>PC:</b></u> </p>
<ul>
<li>Added PCILUReorderForNonzeroDiagonal() and
PCLUReorderForNonzeroDiagonal()</li>
<li>Replace PCLUSetDamping(), PCILUSetDamping(),
PCCholeskySetDamping() and PCICCSetDamping() by
PCFactorSetShiftNonzero(). Change the option database keys
-pc_lu_damping, -pc_ilu_damping, -pc_cholesky_damping and
-pc_icc_damping to -pc_factor_shift_nonzero</li>
<li>Replace PCLUSetShift(), PCILUSetShift(),
PCCholeskySetShift() and PCICCSetShift() by PCFactorSetShiftPd().
Change the option database keys -pc_lu_shift, -pc_ilu_shift,
-pc_cholesky_shift and -pc_icc_shift to
-pc_factor_shfit_positive_definite</li>
<li>PCMG: will automatically using the outer pmat operator to
define the finest level operator if not user supplied</li>
<li>PCMG: added MGUseGalerkin(), -pc_mg_galerkin option to have
coarser grid matrices computed from the finest grid matrix</li>
<li>PCMG: now does referencing counting on set vectors and
restriction/interpolation matrices so user need not keep reference to
free later</li>
<li>PCMG: if user does not provide restriction the
interpolation is used and vis versa</li>
<li>PCMG: if user does not provide Vecs for each level, will
automatically provide them</li>
<li> All routines that began with MG now begin with PCMG</li>
<li>Added PCShellSet/GetContext() and removed the context
passed into PCSetApply() and PCSetApplyRichardson()</li>
</ul>
<p></p>
<p><u><b>KSP:</b></u></p>
<ul>
<li>-ksp_cg_Hermitian and -ksp_cg_symmetric have been changed
to -ksp_cg_type Hermitian or symmetric</li>
<li>Changed options for -ksp_gmres_cgs_refinement_type from
never or ifneeded or always to REFINE_NEVER or REFINE_IFNEEDED or
REFINE_ALWAYS </li>
<li><br>
</li>
</ul>
<p></p>
<p><u><b>config/configure.py:</b></u></p>
<ul>
</ul>
<p></p>
<p><u><b>SNES:</b></u></p>
<ul>
<li>Changed the name and calling sequence for
SNESSetLineSearchCheck() to SNESLineSearchSetPostCheck() and added a
SNESLineSearchSetPreCheck()</li>
<li>Changed the names of all SNESxxxxLineSearchyyyy() to
SNESLineSearchxxxxyyyy() per PETSc naming standard. </li>
<li>Now allow a constant vector to be specified in SNESSolve()</li>
<li>Removed the Vec argument from SNESSetUp()</li>
<li>Corrected the order of function and context arguments in:
<ul>
<li>SNESGetFunction()</li>
<li>SNESGetJacobian()</li>
</ul>
</li>
</ul>
<p></p>
<p> <u><b>TS:<br>
</b></u> </p>
<ul>
</ul>
<p></p>
<p><span style="font-weight: bold; text-decoration: underline;">DA:</span><br>
</p>
<ul>
<li>Added DAVecGet/RestoreArrayDOF() allowing indexing in the
dimension of degrees of freedom at each point on the lattice. </li>
<li>Faster DAGlobalToLocal() etc for dof > 1. </li>
</ul>
<p></p>
<p><span style="font-weight: bold; text-decoration: underline;">DMMG:</span><br>
</p>
<ul>
<li>Consolidated DMMG functionality into the new header file
"petscdmmg.h".</li>
</ul>
<p></p>
<p><span style="font-weight: bold; text-decoration: underline;">SYS:<br>
</span></p>
<ul>
<li>PetscSetCommWorld() removed. [one can directly do
PETSC_COMM_WORLD = comm - before PetscInitialize()]<br>
</li>
</ul>
<ul>
</ul>
<p></p>
<p><span style="font-weight: bold; text-decoration: underline;">Fortran:</span><br>
</p>
<ul>
</ul>
<p></p>
<p><span style="font-weight: bold; text-decoration: underline;">ExternalPackages:</span><br>
</p>
<li>ML support added.</li>
<p></p>
</td>
</tr>
<tr>
<td colspan="2" width="100%">
<hr color="#ff5b5b" size="4"> </td>
</tr>
</tbody>
</table>
</body>
</html>
</body>
</html>
|