petsc-3.14.6 2021-03-30

MatNestGetSubMats

Returns the entire two dimensional array of matrices defining a nest matrix.

#include "petscmat.h"   
PetscErrorCode  MatNestGetSubMats(Mat A,PetscInt *M,PetscInt *N,Mat ***mat)

Not collective

- nest matrix

	M	- number of rows in the nest matrix
	N	- number of cols in the nest matrix
	mat	- 2d array of matrices

The user should not free the array mat.

In Fortran, this routine has a calling sequence

  call MatNestGetSubMats(A, M, N, mat, ierr)

where the space allocated for the optional argument mat is assumed large enough (if provided).

developer