MatCreateDense#
Creates a matrix in MATDENSE format.
Synopsis#
#include "petscmat.h"
PetscErrorCode MatCreateDense(MPI_Comm comm, PetscInt m, PetscInt n, PetscInt M, PetscInt N, PetscScalar *data, Mat *A)
Collective
Input Parameters#
comm - MPI communicator
m - number of local rows (or
PETSC_DECIDEto have calculated ifMis given)n - number of local columns (or
PETSC_DECIDEto have calculated ifNis given)M - number of global rows (or
PETSC_DECIDEto have calculated ifmis given)N - number of global columns (or
PETSC_DECIDEto have calculated ifnis given)data - optional location of matrix data. Set data to
NULL(PETSC_NULL_SCALARfor Fortran users) for PETSc to control all matrix memory allocation.
Output Parameter#
A - the matrix
Notes#
The dense format is fully compatible with standard Fortran storage by columns.
Although local portions of the matrix are stored in column-major order, the matrix is partitioned across MPI ranks by row.
The data input variable is intended primarily for Fortran programmers
who wish to allocate their own matrix memory space. Most users should
set data to NULL (PETSC_NULL_SCALAR for Fortran users).
The user MUST specify either the local or global matrix dimensions (possibly both).
See Also#
Matrices, Mat, MATDENSE, MatCreate(), MatCreateSeqDense(), MatSetValues()
Level#
intermediate
Location#
Examples#
src/ksp/ksp/tutorials/ex21.c
src/ksp/ksp/tutorials/ex76.c
src/ksp/ksp/tutorials/ex76f.F90
src/ksp/ksp/tutorials/ex77.c
src/ksp/ksp/tutorials/ex77f.F90
src/ksp/ksp/tutorials/ex79.c
src/ksp/ksp/tutorials/ex81.c
src/ksp/ksp/tutorials/ex82.c
src/tao/pde_constrained/tutorials/elliptic.c
src/ts/tutorials/ex16fwd.c
src/ts/tutorials/ex20fwd.c
Index of all Mat routines
Table of Contents for all manual pages
Index of all manual pages