DMForestSetAdaptivityForest#
During the pre-setup phase, set the forest from which the current forest will be adapted (e.g., the current forest will be refined/coarsened/repartitioned from it) in DMSetUp().
Synopsis#
#include "petscdmforest.h"
#include "petscdm.h"
#include "petscdmlabel.h"
PetscErrorCode DMForestSetAdaptivityForest(DM dm, DM adapt)
Logically Collective
Input Parameters#
dm - the new forest, which will be constructed from adapt
adapt - the old forest
Note#
Usually not needed by users directly, DMForestTemplate() constructs a new forest to be
adapted from an old forest and calls this routine.
This can be called after setup with adapt = NULL, which will clear all internal data
related to the adaptivity forest from dm. This way, repeatedly adapting does not leave
stale DM objects in memory.
See Also#
DM, DMFOREST, DMForestGetAdaptivityForest(), DMForestSetAdaptivityPurpose()
Level#
intermediate
Location#
Examples#
src/ts/tutorials/ex11.c
src/ts/tutorials/ex30.c
Index of all DMForest routines
Table of Contents for all manual pages
Index of all manual pages