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
|
<!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/310.html" />
<meta http-equiv="content-type" content="text/html;charset=utf-8">
<title>Documentation: Changes: 3.10</title>
</head>
<body bgcolor="#ffffff">
<div id="version" align=right><b>petsc-3.10.3 2018-12-18</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.10.3 v3.10.3 docs/changes/310.html "><small>Report Typos and Errors</small></a></div>
<h1>Documentation: Changes: 3.10</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 in the PETSc 3.10 Version</a></h2>
</div>
<h4>General:</h4>
<ul>
<li>Removed <kbd>--with-errorchecking</kbd> configure option.</li>
<li>Added new command line option <kbd>-viewfromoptions</kbd> to disable <code>XXXViewFromOptions()</code> calls.</li>
</ul>
<h4>Configure/Build:</h4>
<ul>
<li>Removed <kbd>--with-viewfromoptions</kbd> configure option in favor of the new command line option <kbd>-viewfromoptions</kbd>.</li>
<li>Following options are renamed to have more consistant names:<pre>
--with-packages-dir -> --with-packages-download-dir
--with-external-packages-dir -> --with-packages-build-dir
--package-dirs -> --with-packages-search-path
--search-dirs -> --with-executables-search-path</pre></li>
</ul>
<h4>IS:</h4>
<h4>PetscDraw:</h4>
<h4>PF:</h4>
<h4>Vec:</h4>
<h4>VecScatter:</h4>
<h4>PetscSection:</h4>
<h4>Mat:</h4>
<ul>
<li>MatNullSpaceTest() now respects the options prefix of the
provided Mat.</li>
<li>Added MatMatTransposeSolve() to MUMPS interface.</li>
<li>Added -mat_mumps_use_omp_threads [m] option to better support OpenMP in MUMPS.</li>
<li>Added MatPartitioningViewFromOptions().</li>
<li>Added MatPartitioningApplyND() to compute a nested dissection ordering of a matrix.</li>
<li>Deprecated MatISGetMPIXAIJ() in favour of MatConvert().</li>
<li>Added new matrix types for limited-memory variable-metric (MATLMVM) approximations of Jacobians.</li>
<li>Added MATAIJSELL, a sub-type of AIJ that uses SELL format internally for SELL-optimized operations.</li>
</ul>
<h4>PC:</h4>
<ul>
<li> PCKSPGetKSP() now raises an error if called on a PC which is not of type PCKSP </li>
<li> Added PCKSPSetKSP() </li>
<li> Added new PC based on the new LMVM matrices.</li>
</ul>
<h4>KSP:</h4>
<ul>
<li>The KSP viewing options have changed. Now
<ul>
<li>-ksp_compute_eigenvalues becomes -ksp_view_eigenvalues ascii</li>
<li>-ksp_plot_eigenvalues becomes -ksp_view_eigenvalues draw</li>
<li>-ksp_plot_eigencontours becomes -ksp_view_eigenvalues draw::draw_contour</li>
<li>-ksp_compute_eigenvalues_explicitly becomes -ksp_view_eigenvalues_explicit ascii</li>
<li>-ksp_plot_eigenvalues_explicitly becomes -ksp_view_eigenvalues_explicit draw</li>
<li>-ksp_compute_singularvalues becomes -ksp_view_singularvalues ascii</li>
<li>-ksp_final_residual becomes -ksp_view_final_residual</li>
</ul>
</li>
<li><code>KSPLSQR</code>
<ul>
<li>Computes now an estimate of the operator's norm in the same way as Saunders and MATLAB, and uses it in the type-specific stopping criterion <code>KSPLSQRConvergedDefault()</code>; this now gives the same number of iterations as MATLAB's <code>lsqr()</code>.</li>
<li>Added <code>-ksp_lsqr_exact_mat_norm</code> and <code>KSPLSQRSetExactMatNorm()</code> to optionally compute and use the exact Frobenius norm instead of the estimate.</li>
<li><code>KSPLSQRMonitorDefault()</code> and <code>-ksp_lsqr_monitor</code> now additionally print the (estimate of) the operator's norm.</li>
<li>Allow setting <code>-ksp_convergence_test lsqr</code> (it's a default for <code>KSPLSQR</code>, though).</li>
<li><code>KSPLSQRSetStandardErrorVec()</code> is replaced by <code>KSPLSQRSetComputeStandardErrorVec()</code> which now specifies whether standard error vector should be computed instead of setting the vector;</li>
<li>likewise, option <code>-ksp_lsqr_set_standard_error</code> is replaced by <code>-ksp_lsqr_compute_standard_error</code>.</li>
<li>Renamed <code>KSPLSQRGetArnorm()</code> to <code>KSPLSQRGetNorms()</code> and removed its <code>rhs_norm</code> argument.</li>
<li>Renamed <code>KSPLSQRDefaultConverged()</code> to <code>KSPLSQRConvergedDefault()</code> merged with <code>KSPConvergedLSQR()</code>.</li>
</ul>
</li>
</ul>
<h4>SNES:</h4>
<ul>
<li>SNESSetTolerances() and -snes_max_funcs now accept -1 to indicate unlimited number of function evaluations.</li>
</ul>
<h4>SNESLineSearch:</h4>
<h4>TAO:</h4>
<ul>
<li>Added bound-constrained Newton-Krylov methods (BNLS, BNTR, BNTL).</li>
<li>All quasi-Newton methods updated to use the new LMVM Mat objects.</li>
<li>Added a bound-constrained quasi-Newton line search (BQNLS) method that re-uses BNLS infrastructure to replace BLMVM on next release.</li>
<li>Bound-constrained conjugate gradient method expanded with new CG update types and nonlinear preconditioning.</li>
<li>Removed <code>-tao_type test</code>.</li>
<li>Gradient testing can now be accessed with the options <code>-tao_test_gradient</code>, <code>-tao_test_gradient_view</code>, and Hessian testing can be done with <code>-tao_test_hessian</code>, <code>-tao_test_hessian_view</code> (also works for matrix-free Hessian).</li>
</ul>
<h4>TS:</h4>
<ul>
<li>Added symplectic time integrators for separable Hamiltonian systems (-ts_type basicsymplectic). </li>
</ul>
<h4>DM/DA:</h4>
<ul>
<li>Renamed <code>DMDAGetReducedDMDA()</code> to <code>DMDACreateCompatibleDMDA()</code>.</li>
<li>Added DMGetCompatibility() and implementation for DMDA</li>
</ul>
<h4>DMPlex:</h4>
<ul>
<li>Added an interface DM and boundary label to DMPlexCreateHybridMesh()</li>
<li>More refined control of <code>DMView()</code> when <code>PetscViewerType=PETSCVIEWERHDF5</code>. <code>PetscViewerFormat</code> can now be one of <code>{PETSC_VIEWER_HDF5_VIZ, PETSC_VIEWER_HDF5_XDMF, PETSC_VIEWER_HDF5_PETSC, PETSC_VIEWER_DEFAULT}</code>.</li>
<li>Parallel mesh load (i.e. mesh distributed right from beginning) with <code>DMLoad()</code>, <code>PetscViewerType=PETSCVIEWERHDF5</code> and <code>PetscViewerFormat=PETSC_VIEWER_HDF5_XDMF</code>, or <code>DMPlexCreateFromFile()</code> and <code>-dm_plex_create_from_hdf5_xdmf</code>.</li>
</ul>
<h4>PetscViewer:</h4>
<li> Added argument to <code>PetscViewerVTKAddField()</code> to allow skipping of DM check as fields are added</li>
<h4>SYS:</h4>
<h4>AO:</h4>
<h4>Sieve:</h4>
<h4>Fortran:</h4>
</div>
</body>
</html>
|
