MatCreateSELLHIP#
Creates a sparse matrix in SELL format. This matrix will be ultimately pushed down to GPUs.
Synopsis#
Collective
Input Parameters#
comm - MPI communicator, set to
PETSC_COMM_SELF
m - number of local rows (or
PETSC_DECIDE
to have calculated ifM
is given) This value should be the same as the local size used in creating the y vector for the matrix-vector product \( y = Ax \).n - This value should be the same as the local size used in creating the x vector for the matrix-vector product \( y = Ax \). (or
PETSC_DECIDE
to have calculated ifN
is given) For square matricesn
is almost alwaysm
.M - number of global rows (or
PETSC_DETERMINE
to have calculated ifm
is given)N - number of global columns (or
PETSC_DETERMINE
to have calculated ifn
is given)d_nz - number of nonzeros per row in DIAGONAL portion of local submatrix (same value is used for all local rows)
d_nnz - array containing the number of nonzeros in the various rows of the DIAGONAL portion of the local submatrix (possibly different for each row) or
NULL
, ifd_nz
is used to specify the nonzero structure. The size of this array is equal to the number of local rows, i.em
. For matrices you plan to factor you must leave room for the diagonal entry and put in the entry even if it is zero.o_nz - number of nonzeros per row in the OFF-DIAGONAL portion of local submatrix (same value is used for all local rows).
o_nnz - array containing the number of nonzeros in the various rows of the OFF-DIAGONAL portion of the local submatrix (possibly different for each row) or
NULL
, ifo_nz
is used to specify the nonzero structure. The size of this array is equal to the number of local rows, i.em
.
Output Parameter#
A - the matrix
Notes#
If nnz
is given then nz
is ignored
Specify the preallocated storage with either nz
or nnz
(not both).
Set nz
= PETSC_DEFAULT
and nnz
= NULL
for PETSc to control dynamic memory
allocation.
See Also#
Matrices, Mat
, MatCreate()
, MatCreateSELL()
, MatSetValues()
, MATMPISELLHIP
, MATSELLHIP
Level#
intermediate
Location#
src/mat/impls/sell/mpi/mpihip/mpisellhip.hip.cpp
Index of all Mat routines
Table of Contents for all manual pages
Index of all manual pages