DACreate1d
Creates an object that will manage the communication of one-dimensional regular array data that is distributed across some processors.
Synopsis
#include "petscda.h"
int DACreate1d(MPI_Comm comm,DAPeriodicType wrap,int M,int dof,int s,int *lc,DA *inra)
Collective on MPI_Comm
Input Parameters
| comm | - MPI communicator
|
| wrap | - type of periodicity should the array have, if any. Use
either DA_NONPERIODIC or DA_XPERIODIC
|
| M | - global dimension of the array
|
| dof | - number of degrees of freedom per node
|
| lc | - array containing number of nodes in the X direction on each processor,
or PETSC_NULL. If non-null, must be of length as m.
|
| s | - stencil width
|
Output Parameter
inra -the resulting distributed array object
Options Database Key
| -da_view | - Calls DAView() at the conclusion of DACreate1d()
|
| -da_noao | - do not compute natural to PETSc ordering object
|
Notes
The array data itself is NOT stored in the DA, it is stored in Vec objects;
The appropriate vector objects can be obtained with calls to DACreateGlobalVector()
and DACreateLocalVector() and calls to VecDuplicate() if more are needed.
Keywords
distributed array, create, one-dimensional
See Also
DADestroy(), DAView(), DACreate2d(), DACreate3d(), DAGlobalToLocalBegin(),
DAGlobalToLocalEnd(), DALocalToGlobal(), DALocalToLocalBegin(), DALocalToLocalEnd(),
DAGetInfo(), DACreateGlobalVector(), DACreateLocalVector(), DACreateNaturalVector(), DALoad(), DAView()
Level:beginner
Location:src/dm/da/src/da1.c
Index of all DA routines
Table of Contents for all manual pages
Index of all manual pages
Examples
src/snes/examples/tutorials/ex3.c
src/ts/examples/tutorials/ex2.c
src/ts/examples/tutorials/ex4.c
src/ts/examples/tutorials/ex2f.F