1Solves a linear system in parallel with KSP. 2Input parameters include: 3 -view_exact_sol : write exact solution vector to stdout 4 -m <mesh_x> : number of mesh points in x-direction 5 -n <mesh_y> : number of mesh points in y-direction 6 7---------------------------------------- 8 The PETSc Team 9 petsc-maint@mcs.anl.gov 10 https://petsc.org/ 11See https://petsc.org/release/changes for recent updates. 12See https://petsc.org/release/faq for problems. 13See https://petsc.org/release/manualpages for help. 14---------------------------------------- 15Options for all PETSc programs: 16 -version: prints PETSc version 17 -help intro: prints example description and PETSc version, and exits 18 -help: prints example description, PETSc version, and available options for used routines 19 -on_error_abort: cause an abort when an error is detected. Useful 20 only when run in the debugger 21 -on_error_attach_debugger [gdb,dbx,xxgdb,ups,noxterm] 22 start the debugger in new xterm 23 unless noxterm is given 24 -start_in_debugger [gdb,dbx,xxgdb,ups,noxterm] 25 start all processes in the debugger 26 -on_error_emacs <machinename> 27 emacs jumps to error file 28 -debugger_ranks [n1,n2,..] Ranks to start in debugger 29 -debugger_pause [m] : delay (in seconds) to attach debugger 30 -stop_for_debugger : prints message on how to attach debugger manually 31 waits the delay for you to attach 32 -display display: Location where X window graphics and debuggers are displayed 33 -no_signal_handler: do not trap error signals 34 -mpi_return_on_error: MPI returns error code, rather than abort on internal error 35 -fp_trap: stop on floating point exceptions 36 note on IBM RS6000 this slows run greatly 37 -malloc_dump <optional filename>: dump list of unfreed memory at conclusion 38 -on_error_malloc_dump <optional filename>: dump list of unfreed memory on memory error 39 -malloc_view <optional filename>: keeps log of all memory allocations, displays in PetscFinalize() 40 -malloc_debug <true or false>: enables or disables extended checking for memory corruption 41 -options_view: dump list of options inputted 42 -options_left: dump list of unused options 43 -options_left no: don't dump list of unused options 44 -tmp tmpdir: alternative /tmp directory 45 -shared_tmp: tmp directory is shared by all processors 46 -not_shared_tmp: each processor has separate tmp directory 47 -memory_view: print memory usage at end of run 48 -get_total_flops: total flops over all processors 49 -log_view [:filename:[format]]: logging objects and events 50 -log_trace [filename]: prints trace of all PETSc calls 51 -log_exclude <list,of,classnames>: exclude given classes from logging 52 -info [filename][:[~]<list,of,classnames>[:[~]self]]: print verbose information 53 -options_file <file>: reads options from file 54 -options_monitor: monitor options to standard output, including that set previously e.g. in option files 55 -options_monitor_cancel: cancels all hardwired option monitors 56 -petsc_sleep n: sleeps n seconds before running program 57---------------------------------------- 58PetscDevice Options: 59 -device_enable: <now lazy : formerly lazy> How (or whether) to initialize PetscDevices (choose one of) none lazy eager (PetscDeviceInitialize()) 60 -default_device_type: <now host : formerly host> Set the PetscDeviceType returned by PETSC_DEVICE_DEFAULT() (choose one of) host cuda hip sycl (PetscDeviceSetDefaultDeviceType()) 61 -device_select: <now -1 : formerly -1>: Which device to use. Pass (-1) to have PETSc decide or (given they exist) [0-128) for a specific device (PetscDeviceCreate()) 62 -device_view: <now FALSE : formerly FALSE> Display device information and assignments (forces eager initialization) (PetscDeviceView()) 63---------------------------------------- 64PetscDevice host Options: 65 -device_view_host: <now FALSE : formerly FALSE> Display device information and assignments (forces eager initialization) (PetscDeviceView()) 66---------------------------------------- 67Root PetscDeviceContext Options: 68 -root_device_context_device_type: <now host : formerly host> Underlying PetscDevice (choose one of) host cuda hip sycl (PetscDeviceContextSetDevice) 69 -root_device_context_stream_type: <now global_blocking : formerly global_blocking> PetscDeviceContext PetscStreamType (choose one of) global_blocking default_blocking global_nonblocking (PetscDeviceContextSetStreamType) 70---------------------------------------- 71Matrix (Mat) options: 72 -mat_block_size: <now -1 : formerly -1>: Set the blocksize used to store the matrix (MatSetBlockSize) 73 -mat_type <now aij : formerly aij>: Matrix type (one of) mpiaijcrl mpiadj seqaij mpibaij composite preallocator mpiaijperm seqsbaij seqmaij seqkaij mffd seqaijsell nest constantdiagonal mpimaij mpiaij mpikaij lrc seqdense dummy is mpisbaij mpiaijsell shell seqsell seqaijperm blockmat maij diagonal kaij mpisell mpidense seqaijcrl scatter seqbaij (MatSetType) 74---------------------------------------- 75Options for SEQAIJ matrix: 76 -mat_no_unroll: <now FALSE : formerly FALSE> Do not optimize for inodes (slower) (None) 77 -mat_no_inode: <now FALSE : formerly FALSE> Do not optimize for inodes -slower- (None) 78 -mat_inode_limit: <now 5 : formerly 5>: Do not use inodes larger then this value (None) 79 -mat_is_symmetric: Checks if mat is symmetric on MatAssemblyEnd() (MatIsSymmetric) 80 -mat_is_symmetric: <now 0. : formerly 0.>: Checks if mat is symmetric on MatAssemblyEnd() (MatIsSymmetric) 81 -mat_null_space_test: <now FALSE : formerly FALSE> Checks if provided null space is correct in MatAssemblyEnd() (MatSetNullSpaceTest) 82 -mat_error_if_failure: <now FALSE : formerly FALSE> Generate an error if an error occurs when factoring the matrix (MatSetErrorIfFailure) 83 -mat_new_nonzero_location_err: <now FALSE : formerly FALSE> Generate an error if new nonzeros are created in the matrix structure (useful to test preallocation) (MatSetOption) 84 -mat_new_nonzero_allocation_err: <now FALSE : formerly FALSE> Generate an error if new nonzeros are allocated in the matrix structure (useful to test preallocation) (MatSetOption) 85 -mat_ignore_zero_entries: <now FALSE : formerly FALSE> For AIJ/IS matrices this will stop zero values from creating a zero location in the matrix (MatSetOption) 86 -mat_form_explicit_transpose: <now FALSE : formerly FALSE> Hint to form an explicit transpose for operations like MatMultTranspose (MatSetOption) 87 -mat_bind_below: <now 0 : formerly 0>: Set the size threshold (in local rows) below which the Mat is bound to the CPU (MatBindToCPU) 88---------------------------------------- 89Viewer (-mat_view) options: 90 -mat_view ascii[:[filename][:[format][:append]]]: Prints object to stdout or ASCII file (PetscOptionsGetViewer) 91 -mat_view binary[:[filename][:[format][:append]]]: Saves object to a binary file (PetscOptionsGetViewer) 92 -mat_view draw[:[drawtype][:filename|format]] Draws object (PetscOptionsGetViewer) 93 -mat_view socket[:port]: Pushes object to a Unix socket (PetscOptionsGetViewer) 94 -mat_view saws[:communicatorname]: Publishes object to SAWs (PetscOptionsGetViewer) 95---------------------------------------- 96Vector (Vec) options: 97 -vec_type <now seq : formerly seq>: Vector type (one of) shared standard mpi seq (VecSetType) 98 -vec_bind_below: <now 0 : formerly 0>: Set the size threshold (in local entries) below which the Vec is bound to the CPU (VecBindToCPU) 99---------------------------------------- 100Preconditioner (PC) options: 101 -pc_type <now icc : formerly icc>: Preconditioner (one of) nn tfs hmg bddc composite ksp lu icc patch bjacobi eisenstat deflation vpbjacobi redistribute sor mg pbjacobi cholesky mat qr svd fieldsplit mpi kaczmarz jacobi telescope redundant cp shell galerkin ilu exotic gasm gamg none lmvm asm lsc (PCSetType) 102 -pc_use_amat: <now FALSE : formerly FALSE> use Amat (instead of Pmat) to define preconditioner in nested inner solves (PCSetUseAmat) 103 ICC Options 104 -pc_factor_in_place: <now FALSE : formerly FALSE> Form factored matrix in the same memory as the matrix (PCFactorSetUseInPlace) 105 -pc_factor_fill: <now 1. : formerly 1.>: Expected non-zeros in factored matrix (PCFactorSetFill) 106 -pc_factor_shift_type: <now POSITIVE_DEFINITE : formerly POSITIVE_DEFINITE> Type of shift to add to diagonal (choose one of) NONE NONZERO POSITIVE_DEFINITE INBLOCKS (PCFactorSetShiftType) 107 -pc_factor_shift_amount: <now 2.22045e-14 : formerly 2.22045e-14>: Shift added to diagonal (PCFactorSetShiftAmount) 108 -pc_factor_zeropivot: <now 2.22045e-14 : formerly 2.22045e-14>: Pivot is considered zero if less than (PCFactorSetZeroPivot) 109 -pc_factor_column_pivot: <now -2. : formerly -2.>: Column pivot tolerance (used only for some factorization) (PCFactorSetColumnPivot) 110 -pc_factor_pivot_in_blocks: <now TRUE : formerly TRUE> Pivot inside matrix dense blocks for BAIJ and SBAIJ (PCFactorSetPivotInBlocks) 111 -pc_factor_reuse_fill: <now FALSE : formerly FALSE> Use fill from previous factorization (PCFactorSetReuseFill) 112 -pc_factor_reuse_ordering: <now FALSE : formerly FALSE> Reuse ordering from previous factorization (PCFactorSetReuseOrdering) 113 -pc_factor_mat_solver_type: <now (null) : formerly (null)>: Specific direct solver to use (MatGetFactor) 114---------------------------------------- 115Options for SEQSBAIJ matrix: 116 -mat_no_unroll: <now FALSE : formerly FALSE> Do not optimize for inodes (slower) (None) 117 -mat_no_inode: <now FALSE : formerly FALSE> Do not optimize for inodes (slower) (None) 118 -mat_inode_limit: <now 5 : formerly 5>: Do not use inodes larger then this value (None) 119 -pc_factor_mat_ordering_type <now natural : formerly natural>: Reordering to reduce nonzeros in factored matrix (one of) rowlength spectral nd qmd natural rcm 1wd (PCFactorSetMatOrderingType) 120 -pc_factor_levels: <now 0. : formerly 0.>: levels of fill (PCFactorSetLevels) 121---------------------------------------- 122Krylov Method (KSP) options: 123 -ksp_type <now gmres : formerly gmres>: Krylov method (one of) fetidp pipefgmres stcg tsirm tcqmr groppcg nash fcg symmlq lcd minres cgs preonly lgmres pipecgrr fbcgs pipeprcg pipecg ibcgs fgmres qcg gcr cgne pipefcg pipecr pipebcgs bcgsl pipecg2 pipelcg gltr cg tfqmr pgmres lsqr pipegcr bicg cgls bcgs cr dgmres none qmrcgs gmres richardson chebyshev fbcgsr (KSPSetType) 124 -ksp_monitor_cancel: <now FALSE : formerly FALSE> Remove any hardwired monitor routines (KSPMonitorCancel) 125---------------------------------------- 126Viewer (-ksp_monitor) options: 127 -ksp_monitor ascii[:[filename][:[format][:append]]]: Prints object to stdout or ASCII file (PetscOptionsGetViewer) 128 -ksp_monitor binary[:[filename][:[format][:append]]]: Saves object to a binary file (PetscOptionsGetViewer) 129 -ksp_monitor draw[:[drawtype][:filename|format]] Draws object (PetscOptionsGetViewer) 130 -ksp_monitor socket[:port]: Pushes object to a Unix socket (PetscOptionsGetViewer) 131 -ksp_monitor saws[:communicatorname]: Publishes object to SAWs (PetscOptionsGetViewer) 132---------------------------------------- 133Viewer (-ksp_monitor_short) options: 134 -ksp_monitor_short ascii[:[filename][:[format][:append]]]: Prints object to stdout or ASCII file (PetscOptionsGetViewer) 135 -ksp_monitor_short binary[:[filename][:[format][:append]]]: Saves object to a binary file (PetscOptionsGetViewer) 136 -ksp_monitor_short draw[:[drawtype][:filename|format]] Draws object (PetscOptionsGetViewer) 137 -ksp_monitor_short socket[:port]: Pushes object to a Unix socket (PetscOptionsGetViewer) 138 -ksp_monitor_short saws[:communicatorname]: Publishes object to SAWs (PetscOptionsGetViewer) 139---------------------------------------- 140Viewer (-all_ksp_monitor) options: 141 -all_ksp_monitor ascii[:[filename][:[format][:append]]]: Prints object to stdout or ASCII file (PetscOptionsGetViewer) 142 -all_ksp_monitor binary[:[filename][:[format][:append]]]: Saves object to a binary file (PetscOptionsGetViewer) 143 -all_ksp_monitor draw[:[drawtype][:filename|format]] Draws object (PetscOptionsGetViewer) 144 -all_ksp_monitor socket[:port]: Pushes object to a Unix socket (PetscOptionsGetViewer) 145 -all_ksp_monitor saws[:communicatorname]: Publishes object to SAWs (PetscOptionsGetViewer) 146---------------------------------------- 147Viewer (-ksp_monitor_range) options: 148 -ksp_monitor_range ascii[:[filename][:[format][:append]]]: Prints object to stdout or ASCII file (PetscOptionsGetViewer) 149 -ksp_monitor_range binary[:[filename][:[format][:append]]]: Saves object to a binary file (PetscOptionsGetViewer) 150 -ksp_monitor_range draw[:[drawtype][:filename|format]] Draws object (PetscOptionsGetViewer) 151 -ksp_monitor_range socket[:port]: Pushes object to a Unix socket (PetscOptionsGetViewer) 152 -ksp_monitor_range saws[:communicatorname]: Publishes object to SAWs (PetscOptionsGetViewer) 153---------------------------------------- 154Viewer (-ksp_monitor_true_residual) options: 155 -ksp_monitor_true_residual ascii[:[filename][:[format][:append]]]: Prints object to stdout or ASCII file (PetscOptionsGetViewer) 156 -ksp_monitor_true_residual binary[:[filename][:[format][:append]]]: Saves object to a binary file (PetscOptionsGetViewer) 157 -ksp_monitor_true_residual draw[:[drawtype][:filename|format]] Draws object (PetscOptionsGetViewer) 158 -ksp_monitor_true_residual socket[:port]: Pushes object to a Unix socket (PetscOptionsGetViewer) 159 -ksp_monitor_true_residual saws[:communicatorname]: Publishes object to SAWs (PetscOptionsGetViewer) 160---------------------------------------- 161Viewer (-ksp_monitor_max) options: 162 -ksp_monitor_max ascii[:[filename][:[format][:append]]]: Prints object to stdout or ASCII file (PetscOptionsGetViewer) 163 -ksp_monitor_max binary[:[filename][:[format][:append]]]: Saves object to a binary file (PetscOptionsGetViewer) 164 -ksp_monitor_max draw[:[drawtype][:filename|format]] Draws object (PetscOptionsGetViewer) 165 -ksp_monitor_max socket[:port]: Pushes object to a Unix socket (PetscOptionsGetViewer) 166 -ksp_monitor_max saws[:communicatorname]: Publishes object to SAWs (PetscOptionsGetViewer) 167---------------------------------------- 168Viewer (-ksp_monitor_solution) options: 169 -ksp_monitor_solution ascii[:[filename][:[format][:append]]]: Prints object to stdout or ASCII file (PetscOptionsGetViewer) 170 -ksp_monitor_solution binary[:[filename][:[format][:append]]]: Saves object to a binary file (PetscOptionsGetViewer) 171 -ksp_monitor_solution draw[:[drawtype][:filename|format]] Draws object (PetscOptionsGetViewer) 172 -ksp_monitor_solution socket[:port]: Pushes object to a Unix socket (PetscOptionsGetViewer) 173 -ksp_monitor_solution saws[:communicatorname]: Publishes object to SAWs (PetscOptionsGetViewer) 174---------------------------------------- 175Viewer (-ksp_monitor_singular_value) options: 176 -ksp_monitor_singular_value ascii[:[filename][:[format][:append]]]: Prints object to stdout or ASCII file (PetscOptionsGetViewer) 177 -ksp_monitor_singular_value binary[:[filename][:[format][:append]]]: Saves object to a binary file (PetscOptionsGetViewer) 178 -ksp_monitor_singular_value draw[:[drawtype][:filename|format]] Draws object (PetscOptionsGetViewer) 179 -ksp_monitor_singular_value socket[:port]: Pushes object to a Unix socket (PetscOptionsGetViewer) 180 -ksp_monitor_singular_value saws[:communicatorname]: Publishes object to SAWs (PetscOptionsGetViewer) 181---------------------------------------- 182Viewer (-ksp_monitor_error) options: 183 -ksp_monitor_error ascii[:[filename][:[format][:append]]]: Prints object to stdout or ASCII file (PetscOptionsGetViewer) 184 -ksp_monitor_error binary[:[filename][:[format][:append]]]: Saves object to a binary file (PetscOptionsGetViewer) 185 -ksp_monitor_error draw[:[drawtype][:filename|format]] Draws object (PetscOptionsGetViewer) 186 -ksp_monitor_error socket[:port]: Pushes object to a Unix socket (PetscOptionsGetViewer) 187 -ksp_monitor_error saws[:communicatorname]: Publishes object to SAWs (PetscOptionsGetViewer) 188 -ksp_monitor_pause_final: <now FALSE : formerly FALSE> Pauses all draw monitors at the final iterate (KSPMonitorPauseFinal_Internal) 189 -ksp_initial_guess_nonzero: <now FALSE : formerly FALSE> Use the contents of the solution vector for initial guess (KSPSetInitialNonzero) 190 -ksp_max_it: <now 10000 : formerly 10000>: Maximum number of iterations (KSPSetTolerances) 191 -ksp_min_it: <now 0 : formerly 0>: Minimum number of iterations (KSPSetMinimumIterations) 192 -ksp_rtol: <now 0.000138889 : formerly 0.000138889>: Relative decrease in residual norm (KSPSetTolerances) 193 -ksp_atol: <now 1e-50 : formerly 1e-50>: Absolute value of residual norm (KSPSetTolerances) 194 -ksp_divtol: <now 10000. : formerly 10000.>: Residual norm increase cause divergence (KSPSetTolerances) 195 -ksp_converged_use_initial_residual_norm: <now FALSE : formerly FALSE> Use initial residual norm for computing relative convergence (KSPConvergedDefaultSetUIRNorm) 196 -ksp_converged_use_min_initial_residual_norm: <now FALSE : formerly FALSE> Use minimum of initial residual norm and b for computing relative convergence (KSPConvergedDefaultSetUMIRNorm) 197 -ksp_converged_maxits: <now FALSE : formerly FALSE> Declare convergence if the maximum number of iterations is reached (KSPConvergedDefaultSetConvergedMaxits) 198 -ksp_converged_neg_curve: <now FALSE : formerly FALSE> Declare convergence if negative curvature is detected (KSPConvergedNegativeCurvature) 199 -ksp_reuse_preconditioner: <now FALSE : formerly FALSE> Use initial preconditioner and don't ever compute a new one (KSPReusePreconditioner) 200 -ksp_knoll: <now FALSE : formerly FALSE> Use preconditioner applied to b for initial guess (KSPSetInitialGuessKnoll) 201 -ksp_error_if_not_converged: <now FALSE : formerly FALSE> Generate error if solver does not converge (KSPSetErrorIfNotConverged) 202 -ksp_guess_type <now (null) : formerly (null)>: Initial guess in Krylov method (one of) pod fischer ((null)) 203 -ksp_fischer_guess: <0>: Use Paul Fischer's algorithm or its variants for initial guess (KSPSetUseFischerGuess) 204 -ksp_convergence_test: <now default : formerly default> Convergence test (choose one of) default skip lsqr (KSPSetConvergenceTest) 205 -ksp_norm_type: <now PRECONDITIONED : formerly PRECONDITIONED> KSP Norm type (choose one of) NONE PRECONDITIONED UNPRECONDITIONED NATURAL (KSPSetNormType) 206 -ksp_check_norm_iteration: <now -1 : formerly -1>: First iteration to compute residual norm (KSPSetCheckNormIteration) 207 -ksp_lag_norm: <now FALSE : formerly FALSE> Lag the calculation of the residual norm (KSPSetLagNorm) 208 -ksp_diagonal_scale: <now FALSE : formerly FALSE> Diagonal scale matrix before building preconditioner (KSPSetDiagonalScale) 209 -ksp_diagonal_scale_fix: <now FALSE : formerly FALSE> Fix diagonally scaled matrix after solve (KSPSetDiagonalScaleFix) 210 -ksp_constant_null_space: <now FALSE : formerly FALSE> Add constant null space to Krylov solver matrix (MatSetNullSpace) 211 -ksp_monitor_python: <now (null) : formerly (null)>: Use Python function (KSPMonitorSet) 212 -ksp_monitor_lg_range: <now FALSE : formerly FALSE> Monitor graphically range of preconditioned residual norm (KSPMonitorSet) 213---------------------------------------- 214Viewer (-ksp_view) options: 215 -ksp_view ascii[:[filename][:[format][:append]]]: Prints object to stdout or ASCII file (PetscOptionsGetViewer) 216 -ksp_view binary[:[filename][:[format][:append]]]: Saves object to a binary file (PetscOptionsGetViewer) 217 -ksp_view draw[:[drawtype][:filename|format]] Draws object (PetscOptionsGetViewer) 218 -ksp_view socket[:port]: Pushes object to a Unix socket (PetscOptionsGetViewer) 219 -ksp_view saws[:communicatorname]: Publishes object to SAWs (PetscOptionsGetViewer) 220---------------------------------------- 221Viewer (-ksp_view_pre) options: 222 -ksp_view_pre ascii[:[filename][:[format][:append]]]: Prints object to stdout or ASCII file (PetscOptionsGetViewer) 223 -ksp_view_pre binary[:[filename][:[format][:append]]]: Saves object to a binary file (PetscOptionsGetViewer) 224 -ksp_view_pre draw[:[drawtype][:filename|format]] Draws object (PetscOptionsGetViewer) 225 -ksp_view_pre socket[:port]: Pushes object to a Unix socket (PetscOptionsGetViewer) 226 -ksp_view_pre saws[:communicatorname]: Publishes object to SAWs (PetscOptionsGetViewer) 227 -ksp_converged_reason_view_cancel: <now FALSE : formerly FALSE> Cancel all the converged reason view functions set using KSPConvergedReasonViewSet (KSPConvergedReasonViewCancel) 228---------------------------------------- 229Viewer (-ksp_converged_rate) options: 230 -ksp_converged_rate ascii[:[filename][:[format][:append]]]: Prints object to stdout or ASCII file (PetscOptionsGetViewer) 231 -ksp_converged_rate binary[:[filename][:[format][:append]]]: Saves object to a binary file (PetscOptionsGetViewer) 232 -ksp_converged_rate draw[:[drawtype][:filename|format]] Draws object (PetscOptionsGetViewer) 233 -ksp_converged_rate socket[:port]: Pushes object to a Unix socket (PetscOptionsGetViewer) 234 -ksp_converged_rate saws[:communicatorname]: Publishes object to SAWs (PetscOptionsGetViewer) 235---------------------------------------- 236Viewer (-ksp_view_mat) options: 237 -ksp_view_mat ascii[:[filename][:[format][:append]]]: Prints object to stdout or ASCII file (PetscOptionsGetViewer) 238 -ksp_view_mat binary[:[filename][:[format][:append]]]: Saves object to a binary file (PetscOptionsGetViewer) 239 -ksp_view_mat draw[:[drawtype][:filename|format]] Draws object (PetscOptionsGetViewer) 240 -ksp_view_mat socket[:port]: Pushes object to a Unix socket (PetscOptionsGetViewer) 241 -ksp_view_mat saws[:communicatorname]: Publishes object to SAWs (PetscOptionsGetViewer) 242---------------------------------------- 243Viewer (-ksp_view_pmat) options: 244 -ksp_view_pmat ascii[:[filename][:[format][:append]]]: Prints object to stdout or ASCII file (PetscOptionsGetViewer) 245 -ksp_view_pmat binary[:[filename][:[format][:append]]]: Saves object to a binary file (PetscOptionsGetViewer) 246 -ksp_view_pmat draw[:[drawtype][:filename|format]] Draws object (PetscOptionsGetViewer) 247 -ksp_view_pmat socket[:port]: Pushes object to a Unix socket (PetscOptionsGetViewer) 248 -ksp_view_pmat saws[:communicatorname]: Publishes object to SAWs (PetscOptionsGetViewer) 249---------------------------------------- 250Viewer (-ksp_view_rhs) options: 251 -ksp_view_rhs ascii[:[filename][:[format][:append]]]: Prints object to stdout or ASCII file (PetscOptionsGetViewer) 252 -ksp_view_rhs binary[:[filename][:[format][:append]]]: Saves object to a binary file (PetscOptionsGetViewer) 253 -ksp_view_rhs draw[:[drawtype][:filename|format]] Draws object (PetscOptionsGetViewer) 254 -ksp_view_rhs socket[:port]: Pushes object to a Unix socket (PetscOptionsGetViewer) 255 -ksp_view_rhs saws[:communicatorname]: Publishes object to SAWs (PetscOptionsGetViewer) 256---------------------------------------- 257Viewer (-ksp_view_solution) options: 258 -ksp_view_solution ascii[:[filename][:[format][:append]]]: Prints object to stdout or ASCII file (PetscOptionsGetViewer) 259 -ksp_view_solution binary[:[filename][:[format][:append]]]: Saves object to a binary file (PetscOptionsGetViewer) 260 -ksp_view_solution draw[:[drawtype][:filename|format]] Draws object (PetscOptionsGetViewer) 261 -ksp_view_solution socket[:port]: Pushes object to a Unix socket (PetscOptionsGetViewer) 262 -ksp_view_solution saws[:communicatorname]: Publishes object to SAWs (PetscOptionsGetViewer) 263---------------------------------------- 264Viewer (-ksp_view_mat_explicit) options: 265 -ksp_view_mat_explicit ascii[:[filename][:[format][:append]]]: Prints object to stdout or ASCII file (PetscOptionsGetViewer) 266 -ksp_view_mat_explicit binary[:[filename][:[format][:append]]]: Saves object to a binary file (PetscOptionsGetViewer) 267 -ksp_view_mat_explicit draw[:[drawtype][:filename|format]] Draws object (PetscOptionsGetViewer) 268 -ksp_view_mat_explicit socket[:port]: Pushes object to a Unix socket (PetscOptionsGetViewer) 269 -ksp_view_mat_explicit saws[:communicatorname]: Publishes object to SAWs (PetscOptionsGetViewer) 270---------------------------------------- 271Viewer (-ksp_view_eigenvalues) options: 272 -ksp_view_eigenvalues ascii[:[filename][:[format][:append]]]: Prints object to stdout or ASCII file (PetscOptionsGetViewer) 273 -ksp_view_eigenvalues binary[:[filename][:[format][:append]]]: Saves object to a binary file (PetscOptionsGetViewer) 274 -ksp_view_eigenvalues draw[:[drawtype][:filename|format]] Draws object (PetscOptionsGetViewer) 275 -ksp_view_eigenvalues socket[:port]: Pushes object to a Unix socket (PetscOptionsGetViewer) 276 -ksp_view_eigenvalues saws[:communicatorname]: Publishes object to SAWs (PetscOptionsGetViewer) 277---------------------------------------- 278Viewer (-ksp_view_singularvalues) options: 279 -ksp_view_singularvalues ascii[:[filename][:[format][:append]]]: Prints object to stdout or ASCII file (PetscOptionsGetViewer) 280 -ksp_view_singularvalues binary[:[filename][:[format][:append]]]: Saves object to a binary file (PetscOptionsGetViewer) 281 -ksp_view_singularvalues draw[:[drawtype][:filename|format]] Draws object (PetscOptionsGetViewer) 282 -ksp_view_singularvalues socket[:port]: Pushes object to a Unix socket (PetscOptionsGetViewer) 283 -ksp_view_singularvalues saws[:communicatorname]: Publishes object to SAWs (PetscOptionsGetViewer) 284---------------------------------------- 285Viewer (-ksp_view_eigenvalues_explicit) options: 286 -ksp_view_eigenvalues_explicit ascii[:[filename][:[format][:append]]]: Prints object to stdout or ASCII file (PetscOptionsGetViewer) 287 -ksp_view_eigenvalues_explicit binary[:[filename][:[format][:append]]]: Saves object to a binary file (PetscOptionsGetViewer) 288 -ksp_view_eigenvalues_explicit draw[:[drawtype][:filename|format]] Draws object (PetscOptionsGetViewer) 289 -ksp_view_eigenvalues_explicit socket[:port]: Pushes object to a Unix socket (PetscOptionsGetViewer) 290 -ksp_view_eigenvalues_explicit saws[:communicatorname]: Publishes object to SAWs (PetscOptionsGetViewer) 291---------------------------------------- 292Viewer (-ksp_view_final_residual) options: 293 -ksp_view_final_residual ascii[:[filename][:[format][:append]]]: Prints object to stdout or ASCII file (PetscOptionsGetViewer) 294 -ksp_view_final_residual binary[:[filename][:[format][:append]]]: Saves object to a binary file (PetscOptionsGetViewer) 295 -ksp_view_final_residual draw[:[drawtype][:filename|format]] Draws object (PetscOptionsGetViewer) 296 -ksp_view_final_residual socket[:port]: Pushes object to a Unix socket (PetscOptionsGetViewer) 297 -ksp_view_final_residual saws[:communicatorname]: Publishes object to SAWs (PetscOptionsGetViewer) 298---------------------------------------- 299Viewer (-ksp_view_preconditioned_operator_explicit) options: 300 -ksp_view_preconditioned_operator_explicit ascii[:[filename][:[format][:append]]]: Prints object to stdout or ASCII file (PetscOptionsGetViewer) 301 -ksp_view_preconditioned_operator_explicit binary[:[filename][:[format][:append]]]: Saves object to a binary file (PetscOptionsGetViewer) 302 -ksp_view_preconditioned_operator_explicit draw[:[drawtype][:filename|format]] Draws object (PetscOptionsGetViewer) 303 -ksp_view_preconditioned_operator_explicit socket[:port]: Pushes object to a Unix socket (PetscOptionsGetViewer) 304 -ksp_view_preconditioned_operator_explicit saws[:communicatorname]: Publishes object to SAWs (PetscOptionsGetViewer) 305---------------------------------------- 306Viewer (-ksp_view_diagonal_scale) options: 307 -ksp_view_diagonal_scale ascii[:[filename][:[format][:append]]]: Prints object to stdout or ASCII file (PetscOptionsGetViewer) 308 -ksp_view_diagonal_scale binary[:[filename][:[format][:append]]]: Saves object to a binary file (PetscOptionsGetViewer) 309 -ksp_view_diagonal_scale draw[:[drawtype][:filename|format]] Draws object (PetscOptionsGetViewer) 310 -ksp_view_diagonal_scale socket[:port]: Pushes object to a Unix socket (PetscOptionsGetViewer) 311 -ksp_view_diagonal_scale saws[:communicatorname]: Publishes object to SAWs (PetscOptionsGetViewer) 312 -ksp_plot_eigenvalues: [deprecated since PETSc 3.9; use -ksp_view_eigenvalues draw] (KSPView) 313 -ksp_plot_eigencontours: [deprecated since PETSc 3.9; use -ksp_view_eigenvalues draw::draw_contour] (KSPView) 314 -ksp_plot_eigenvalues_explicitly: [deprecated since PETSc 3.9; use -ksp_view_eigenvalues_explicit draw] (KSPView) 315 -ksp_pc_side: <now LEFT : formerly LEFT> KSP preconditioner side (choose one of) LEFT RIGHT SYMMETRIC (KSPSetPCSide) 316 -ksp_matsolve_batch_size: <now -1 : formerly -1>: Maximum number of columns treated simultaneously (KSPSetMatSolveBatchSize) 317 -ksp_use_explicittranspose: <now FALSE : formerly FALSE> Explicitly transpose the system in KSPSolveTranspose (KSPSetUseExplicitTranspose) 318 KSP GMRES Options 319 -ksp_gmres_restart: <now 30 : formerly 30>: Number of Krylov search directions (KSPGMRESSetRestart) 320 -ksp_gmres_haptol: <now 1e-30 : formerly 1e-30>: Tolerance for exact convergence (happy ending) (KSPGMRESSetHapTol) 321 -ksp_gmres_breakdown_tolerance: <now 0.1 : formerly 0.1>: Divergence breakdown tolerance during GMRES restart (KSPGMRESSetBreakdownTolerance) 322 -ksp_gmres_preallocate: <now FALSE : formerly FALSE> Preallocate Krylov vectors (KSPGMRESSetPreAllocateVectors) 323 Pick at most one of ------------- 324 -ksp_gmres_classicalgramschmidt: Classical (unmodified) Gram-Schmidt (fast) (KSPGMRESSetOrthogonalization) 325 -ksp_gmres_modifiedgramschmidt: Modified Gram-Schmidt (slow,more stable) (KSPGMRESSetOrthogonalization) 326 -ksp_gmres_cgs_refinement_type: <now REFINE_NEVER : formerly REFINE_NEVER> Type of iterative refinement for classical (unmodified) Gram-Schmidt (choose one of) REFINE_NEVER REFINE_IFNEEDED REFINE_ALWAYS (KSPGMRESSetCGSRefinementType) 327 -ksp_gmres_krylov_monitor: <now FALSE : formerly FALSE> Plot the Krylov directions (KSPMonitorSet) 328---------------------------------------- 329Viewer (-is_view) options: 330 -is_view ascii[:[filename][:[format][:append]]]: Prints object to stdout or ASCII file (PetscOptionsGetViewer) 331 -is_view binary[:[filename][:[format][:append]]]: Saves object to a binary file (PetscOptionsGetViewer) 332 -is_view draw[:[drawtype][:filename|format]] Draws object (PetscOptionsGetViewer) 333 -is_view socket[:port]: Pushes object to a Unix socket (PetscOptionsGetViewer) 334 -is_view saws[:communicatorname]: Publishes object to SAWs (PetscOptionsGetViewer) 335---------------------------------------- 336Viewer (-mat_factor_view) options: 337 -mat_factor_view ascii[:[filename][:[format][:append]]]: Prints object to stdout or ASCII file (PetscOptionsGetViewer) 338 -mat_factor_view binary[:[filename][:[format][:append]]]: Saves object to a binary file (PetscOptionsGetViewer) 339 -mat_factor_view draw[:[drawtype][:filename|format]] Draws object (PetscOptionsGetViewer) 340 -mat_factor_view socket[:port]: Pushes object to a Unix socket (PetscOptionsGetViewer) 341 -mat_factor_view saws[:communicatorname]: Publishes object to SAWs (PetscOptionsGetViewer) 342 0 KSP Residual norm 3.811398540713e+00 343 1 KSP Residual norm 1.444731352039e+00 344 2 KSP Residual norm 4.712840878823e-01 345 3 KSP Residual norm 6.943414362981e-02 346 4 KSP Residual norm 9.502667693381e-03 347 5 KSP Residual norm 7.905767061099e-04 348 6 KSP Residual norm 1.108383257088e-04 349---------------------------------------- 350Viewer (-ksp_converged_reason) options: 351 -ksp_converged_reason ascii[:[filename][:[format][:append]]]: Prints object to stdout or ASCII file (PetscOptionsGetViewer) 352 -ksp_converged_reason binary[:[filename][:[format][:append]]]: Saves object to a binary file (PetscOptionsGetViewer) 353 -ksp_converged_reason draw[:[drawtype][:filename|format]] Draws object (PetscOptionsGetViewer) 354 -ksp_converged_reason socket[:port]: Pushes object to a Unix socket (PetscOptionsGetViewer) 355 -ksp_converged_reason saws[:communicatorname]: Publishes object to SAWs (PetscOptionsGetViewer) 356Norm of error 0.000156044 iterations 6 357