DMForestTemplate#

Create a new DM that will be adapted from a source DM. 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()).

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 DM object
comm - the communicator for the new DM (this communicator is currently ignored, but is present so that DMForestTemplate() can be used within DMCoarsen())