petsc-3.8.4 2018-03-24
Report Typos and Errors

MatCreateBlockMat

Creates a new matrix in which each block contains a uniform-size sequential Mat object

Synopsis

#include "petscmat.h" 
PetscErrorCode  MatCreateBlockMat(MPI_Comm comm,PetscInt m,PetscInt n,PetscInt bs,PetscInt nz,PetscInt *nnz, Mat *A)
Collective on MPI_Comm

Input Parameters

comm - MPI communicator
m - number of rows
n - number of columns
bs - size of each submatrix
nz - expected maximum number of nonzero blocks in row (use PETSC_DEFAULT if not known)
nnz - expected number of nonzers per block row if known (use NULL otherwise)

Output Parameter

A -the matrix

Notes: Matrices of this type are nominally-sparse matrices in which each "entry" is a Mat object. Each Mat must have the same size and be sequential. The local and global sizes must be compatible with this decomposition.

For matrices containing parallel submatrices and variable block sizes, see MATNEST.

Keywords

matrix, bmat, create

See Also

MATBLOCKMAT, MatCreateNest()

Level:intermediate
Location:
src/mat/impls/blockmat/seq/blockmat.c
Index of all Mat routines
Table of Contents for all manual pages
Index of all manual pages