MatSetBlockSizes — PETSc 3.21.4 documentation

Skip to main content
`Ctrl`+`K`

# MatSetBlockSizes

Sets the matrix block row and column sizes.

## Synopsis

    #include "petscmat.h"
    PetscErrorCode MatSetBlockSizes(Mat mat, PetscInt rbs, PetscInt cbs)

Logically Collective

## Input Parameters

- mat - the matrix

- rbs - row block size

- cbs - column block size

## Notes

Block row formats are `MATBAIJ` and `MATSBAIJ`. These formats ALWAYS have square block storage in the matrix. If you pass a different block size for the columns than the rows, the row block size determines the square block storage. This must be called before `MatSetUp()` or MatXXXSetPreallocation() (or will default to 1) and the block size cannot be changed later.

For `MATAIJ` matrix this function can be called at a later stage, provided that the specified block sizes are compatible with the matrix local sizes.

The row and column block size determine the blocksize of the “row” and “column” vectors returned by `MatCreateVecs()`.

## See Also

Matrices, `Mat`, `MatCreateSeqBAIJ()`, `MatCreateBAIJ()`, `MatGetBlockSize()`, `MatSetBlockSize()`, `MatGetBlockSizes()`

## Level

intermediate

## Location

src/mat/interface/matrix.c

## Implementations

MatSetBlockSizes_MPIAIJ() in src/mat/impls/aij/mpi/mpiaij.c
MatSetBlockSizes_IS() in src/mat/impls/is/matis.c

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