petsc-3.12.5 2020-03-29

MatPreallocateSetLocal

Indicates the locations (rows and columns) in the matrix where nonzeros will be inserted using a local number of the rows and columns

Synopsis

#include <petscmat.h>
PetscErrorCode MatPreallocateSetLocal(ISLocalToGlobalMappping map,PetscInt nrows, PetscInt *rows,PetscInt ncols, PetscInt *cols,PetscInt *dnz, PetscInt *onz)

Not Collective

Input Parameters

	map	- the row mapping from local numbering to global numbering
	nrows	- the number of rows indicated
	rows	- the indices of the rows
	cmap	- the column mapping from local to global numbering
	ncols	- the number of columns in the matrix
	cols	- the columns indicated
	dnz	- the array that will be passed to the matrix preallocation routines
	onz	- the other array passed to the matrix preallocation routines

Notes

See Users-Manual: Chapter 14 Hints for Performance Tuning for more details.

Do not malloc or free dnz and onz, that is handled internally by these routines

Level

intermediate

Location