DMPRODUCT

“product” - a DM representing a local Cartesian product of other DM

Notes

The DM is usually used for managing coordinates of other DM via DMGetCoordinateDM() and DMSetCoordinateDM()

For each of dim dimensions, the DMPRODUCT contains a DM and a dimension index. The dimensional index, set with DMProductSetDimensionIndex() specifies which dimension of the sub-DM coordinates corresponds to a particular dimension of the DMPRODUCT. For example,

  DM da1, da2;
  DM dm
  DMCreate(PETSC_COMM_WORLD,&dm);
  DMSetType(dm,DMPRODUCT);
  DMSetDimension(dm,3);
  DMProductSetDM(dm,0,da1);
  DMProductSetDimensionIndex(dm,0,0);
  DMProductSetDM(dm,1,da2);
  DMProductSetDimensionIndex(dm,1,0);
  DMProductSetDM(dm,2,da1);
  DMProductSetDimensionIndex(dm,2,1);

results in a three-dimensional DM whose x coordinate values are obtained from the x coordinate values of da1, whose y coordinate values are obtained from the ‘x’ coordinate values of da2 and whose z coordinate values are obtained from the y coordinate values of da1.

See Also

DM, DMSTAG, DMProductGetDM(), DMProductSetDimensionIndex(), DMProductSetDM(), DMStagSetUniformCoordinatesProduct(), DMStagGetProductCoordinateArrays(), DMStagGetProductCoordinateArraysRead(), DMGetCoordinateDM(), DMSetCoordinateDM()

Level

advanced

Location

src/dm/impls/product/product.c

---

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