MatGetOwnershipIS#
Get row and column ownership of a matrices’ values as index sets.
Synopsis#
#include "petscmat.h"
PetscErrorCode MatGetOwnershipIS(Mat A, IS *rows, IS *cols)
Not Collective
Input Parameter#
A - matrix
Output Parameters#
rows - rows in which this process owns elements, , use
NULL
to not obtain this valuecols - columns in which this process owns elements, use
NULL
to not obtain this value
Note#
You should call ISDestroy()
on the returned IS
For most matrices, excluding MATELEMENTAL
and MATSCALAPACK
, this corresponds to values
returned by MatGetOwnershipRange()
, MatGetOwnershipRangeColumn()
. For MATELEMENTAL
and
MATSCALAPACK
the ownership is more complicated. See Matrix Layouts for
details on matrix layouts.
See Also#
Matrices, IS
, Mat
, MatGetOwnershipRanges()
, MatSetValues()
, MATELEMENTAL
, MATSCALAPACK
Level#
intermediate
Location#
Examples#
Implementations#
MatGetOwnershipIS_Elemental() in src/mat/impls/elemental/matelem.cxx
MatGetOwnershipIS_ScaLAPACK() in src/mat/impls/scalapack/matscalapack.c
Index of all Mat routines
Table of Contents for all manual pages
Index of all manual pages