MatGetOwnershipRange#

For matrices that own values by row, excludes MATELEMENTAL and MATSCALAPACK, returns the range of matrix rows owned by this MPI process.

Synopsis#

#include "petscmat.h" 
PetscErrorCode MatGetOwnershipRange(Mat mat, PetscInt *m, PetscInt *n)

Not Collective

Input Parameter#

  • mat - the matrix

Output Parameters#

  • m - the global index of the first local row, use NULL to not obtain this value

  • n - one more than the global index of the last local row, use NULL to not obtain this value

Note#

For all matrices it returns the range of matrix rows associated with rows of a vector that would contain the result of a matrix vector product with this matrix. See Matrix Layouts for details on matrix layouts.

See Also#

Matrices, Mat, MatGetOwnershipRanges(), MatGetOwnershipRangeColumn(), MatGetOwnershipRangesColumn(), PetscSplitOwnership(), PetscSplitOwnershipBlock(), PetscLayout

Level#

beginner

Location#

src/mat/interface/matrix.c

Examples#

src/ts/tutorials/ex21.c
src/tao/pde_constrained/tutorials/parabolic.c
src/snes/tutorials/ex70.c
src/snes/tutorials/ex48.c
src/ts/tutorials/ex41.c
src/ts/tutorials/ex44.c
src/tao/tutorials/ex4.c
src/tao/pde_constrained/tutorials/hyperbolic.c
src/ts/tutorials/ex17.c
src/tao/pde_constrained/tutorials/elliptic.c

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