DMForestTemplate#
Create a new DM that will be adapted from a source DM.
Synopsis#
#include "petscdmforest.h" 
#include "petscdm.h" 
#include "petscdmlabel.h" 
PetscErrorCode DMForestTemplate(DM dm, MPI_Comm comm, DM *tdm)
Collective
Input Parameters#
- dm - the source - DMobject
- comm - the communicator for the new - DM(this communicator is currently ignored, but is present so that- DMForestTemplate()can be used within- DMCoarsen())
Output Parameter#
- tdm - the new - DMobject
Notes#
The new DM reproduces the configuration of the source, but is not yet setup, so that the
user can then define only the ways that the new DM should differ (by, e.g., refinement or
repartitioning).  The source DM is also set as the adaptivity source DM of the new DM
(see DMForestSetAdaptivityForest()).
See Also#
Level#
intermediate
Location#
Implementations#
DMForestTemplate_pforest() in src/dm/impls/forest/p4est/pforest.h
Index of all DMForest routines
Table of Contents for all manual pages
Index of all manual pages