MATSOLVERCUDSS#

“cudss” - A solver package providing LU and Cholesky factorization for sequential sparse matrices via the NVIDIA cuDSS GPU-accelerated sparse direct solver library.

Options Database Keys#

  • -mat_cudss_reorder_alg (default|btf_colamd|colamd|amd|nested_dissection|none) - reordering algorithm

  • -mat_cudss_pivot_type (auto|none|col|row|diagonal|local_block|bunch_kaufman) - pivoting type

  • -mat_cudss_pivot_threshold threshold - Pivot threshold, default is 1.0

  • -mat_cudss_pivot_epsilon epsilon - Pivot epsilon, default is 0.0

  • -mat_cudss_use_matching (true|false) - Enable bipartite matching for heavy-diagonal scaling and permutation, default is false

  • -mat_cudss_ir_n_steps nsteps - Number of iterative refinement steps, default is 0

  • -mat_cudss_deterministic (true|false) - Enable bitwise-reproducible factorization and solve, default is false

  • -mat_cudss_mempool (true|false) - Use a stream-ordered cudaMemPool_t for cuDSS device workspace allocations, default is true

Notes#

Registered for both MATSEQAIJ (host) and MATSEQAIJCUSPARSE (device) matrix types. When the input matrix is MATSEQAIJ, the matrix data is transparently copied to the GPU. MatSolveTranspose() is not supported. The bunch_kaufman value of -mat_cudss_pivot_type applies to symmetric or Hermitian indefinite matrices.

By default cuDSS performs its own internal reordering (MATORDERINGEXTERNAL) during the symbolic phase, selectable via -mat_cudss_reorder_alg default. A PETSc ordering can be selected with -pc_factor_mat_ordering_type or PCFactorSetMatOrderingType(), or by passing a non-NULL IS to MatLUFactorSymbolic() or MatCholeskyFactorSymbolic().

MatSolve() and MatMatSolve() operate on the GPU. Host right-hand-side and solution objects (VECSEQ vectors, MATSEQDENSE matrices) are accepted and transparently copied to and from the device, but this incurs extra copies; for best performance supply device vectors (e.g., VECCUDA or VECKOKKOS) and MATSEQDENSECUDA matrices.

See Also#

Matrices, Mat, PCLU, PCCHOLESKY, PCFactorSetMatSolverType(), PCFactorSetMatOrderingType(), MatSolverType, MatLUFactorSymbolic(), MatCholeskyFactorSymbolic()

Level#

intermediate

Location#

src/mat/impls/aij/seq/cudss/cudss.cu

Examples#

src/mat/tests/ex125.c


Index of all Mat routines
Table of Contents for all manual pages
Index of all manual pages