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#
Index of all DMForest routines
Table of Contents for all manual pages
Index of all manual pages