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_grid_x <nx> - number of grid points in x direction; can set if M < 0

Notes

If you are having problems with running out of memory than run with the option -da_noao

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/sles/examples/tutorials/ex25.c.html
src/snes/examples/tutorials/ex3.c.html
src/snes/examples/tutorials/ex21.c.html
src/snes/examples/tutorials/ex22.c.html
src/snes/examples/tutorials/ex23.c.html
src/snes/examples/tutorials/ex24.c.html
src/snes/examples/tutorials/ex26.c.html
src/ts/examples/tutorials/ex2.c.html
src/ts/examples/tutorials/ex4.c.html
src/ts/examples/tutorials/ex2f.F.html