MatCreateSum

Creates a matrix as the implicit sum of zero or more matrices. This class is an adoption of MATCOMPOSITE type in PETSc.

Synopsis

PetscErrorCode  MatCreateSum(MPI_Comm comm,PetscInt nmat,const Mat *mats,Mat *mat)
Collective on MPI_Comm

Input Parameters

comm - MPI communicator
nmat - number of matrices to put in
mats - the matrices

Output Parameter

A -the matrix

Notes

Alternative construction
      MatCreate(comm,&mat);
      MatSetType(mat,MATSUM);
      MatCompositeAddMat(mat,mats[0]);
      ....
      MatCompositeAddMat(mat,mats[nmat-1]);
      MatAssemblyBegin(mat,MAT_FINAL_ASSEMBLY);
      MatAssemblyEnd(mat,MAT_FINAL_ASSEMBLY);

See Also

MatDestroy(), MatMult(), MatCompositeAddMat(), MatCompositeMerge(), MatCompositeSetType(), MatCompositeType

Level:advanced
Location:
src/mat/impls/composite/matsum.c
Index of all Mat routines
Table of Contents for all manual pages
Index of all manual pages