Skip to main content
`Ctrl`+`K`

# 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