petsc-3.5.4 2015-05-23

MatGetRedundantMatrix

Create redundant matrices and put them into processors of subcommunicators.

#include "petscmat.h" 
PetscErrorCode  MatGetRedundantMatrix(Mat mat,PetscInt nsubcomm,MPI_Comm subcomm,MatReuse reuse,Mat *matredundant)

Collective on Mat

	mat	- the matrix
	nsubcomm	- the number of subcommunicators (= number of redundant parallel or sequential matrices)
	subcomm	- MPI communicator split from the communicator where mat resides in (or MPI_COMM_NULL if nsubcomm is used)
	reuse	- either MAT_INITIAL_MATRIX or MAT_REUSE_MATRIX

matredundant -redundant matrix

MAT_REUSE_MATRIX can only be used when the nonzero structure of the original matrix has not changed from that last call to MatGetRedundantMatrix().

This routine creates the duplicated matrices in subcommunicators; you should NOT create them before calling it.

Only MPIAIJ matrix is supported.