# 7.7. Rebalance Settings

This section is referenced in the following other sections

- Simulation Setup: Rebalance

## 7.7.1. Combine Rebalance Groups

Syntax

  Combine Rebalance Groups {=} CombinedRebalanceGroups…

Summary

  Specifies a list of rebalance groups to combine into the DEFAULT rebalance group for the equation system. By default, each equation system will be split into the following four rebalance groups: DEFAULT, ASSEMBLY, LINEAR_SOLVE, and CHEMEQ_UTIL. Only the ASSEMBLY and CHEMEQ_UTIL rebalance groups can be combined into the DEFAULT rebalance group. The LINEAR_SOLVE rebalance group uses a non-time based measure of the work load and so can not be combined into the DEFAULT rebalance group. Note that combining rebalance groups may hide load imbalances in the equation system.

Parameter | Value | Default
--- | --- | ---
{=} | {= | are | is} | –
CombinedRebalanceGroups | string… | –

## 7.7.2. Enable Rebalance

Syntax

  Enable Rebalance [ With Threshold {=} Threshold ]

Summary

  Activate rebalance, optionally specifying the rebalance threshold.

  Threshold is in terms of the ratio of the maximum (over all processors) cpu time per timestep divided by the average cpu time per timestep. If the observed value of this ratio meets or exceeds the given value, rebalance will be performed.

  The default threshold value is 1.25.

## 7.7.3. Maximum Number Of Nodal Rebalance Iterations

Syntax

  Maximum Number Of Nodal Rebalance Iterations {=} Count

Summary

  Specify the maximum number of nodal rebalance iterations to be performed after a dynamic rebalance.

Parameter | Value | Default
--- | --- | ---
{=} | {= | are | is} | –
Count | integer | –

## 7.7.4. Maximum Number Of Rebalances

Syntax

  Maximum Number Of Rebalances {=} Count

Summary

  Specify the maximum number of times to perform a mesh rebalance.

Parameter | Value | Default
--- | --- | ---
{=} | {= | are | is} | –
Count | integer | –

## 7.7.5. Rebalance After Adaptivity

Syntax

  Rebalance After Adaptivity

Summary

  Command to automatically execute a rebalance after each solution control adaptivity step

## 7.7.6. Rebalance Load Measure Type

Syntax

  Rebalance Load Measure Type {=} MeasureType

Summary

  Specify the measure used to evaluate the load for rebalancing.

Parameter | Value | Default
--- | --- | ---
{=} | {= | are | is} | –
MeasureType | string | –

## 7.7.7. Rebalance Time Step Frequency

Syntax

  Rebalance Time Step Frequency {=} Frequency

Summary

  Time step frequency for running rebalance.

Parameter | Value | Default
--- | --- | ---
{=} | {= | are | is} | –
Frequency | integer | –