DMForestSetCellWeightFactor#

During the pre-setup phase, set the factor by which the level of refinement changes the cell weight (see DMForestSetCellWeights()) when calculating partitions.

Synopsis#

#include "petscdmforest.h" 
#include "petscdm.h" 
#include "petscdmlabel.h" 
PetscErrorCode DMForestSetCellWeightFactor(DM dm, PetscReal weightsFactor)

Logically Collective

Input Parameters#

  • dm - the forest

  • weightsFactor - default 1.

Note#

The final weight of a cell will be (cellWeight) * (weightFactor^refinementLevel). A factor of 1 indicates that the weight of a cell does not depend on its level; a factor of 2, for example, might be appropriate for sub-cycling time-stepping methods, when the computation associated with a cell is multiplied by a factor of 2 for each additional level of refinement.

See Also#

DM, DMFOREST, DMForestGetCellWeightFactor(), DMForestSetCellWeights()

Level#

advanced

Location#

src/dm/impls/forest/forest.c


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