Run Control

3.6. Run Control#

Run control allows you to configure stopping criteria that automatically terminate a simulation when monitored output fields reach specified tolerance thresholds. Stopping criteria provide additional convergence control based on user-defined metrics of interest (such as force coefficients, probe values, or surface probe data), working in conjunction with solver tolerances—both must be satisfied for the simulation to stop.

Important

Stopping criteria monitor outputs that must be configured in the Output Configuration section. Ensure your desired outputs (force outputs, probe outputs, or surface probe outputs) are set up before configuring stopping criteria.

How Stopping Criteria Work#

When you configure one or more stopping criteria:

  1. Field Computation: The specified output field is computed from the selected output type. For Force Outputs, this includes force and moment coefficients (such as lift, drag, and pitching moment). For Probe Outputs, this includes flow variables at point locations (such as pressure, Mach number, or velocity). For Surface Probe Outputs, this includes flow variables projected onto surfaces (such as pressure coefficient or skin friction). All these outputs are processed using the moving statistics object configured in the output, and this processed data is ultimately fed to assess the stopping criterion. See Python API Outputs for the complete definition of these settings.

  2. Combined Criteria Evaluation: Stopping criteria provide additional convergence control based on user-defined metrics. The simulation stops when both:

    • All user-defined stopping criteria are satisfied (for each criterion, the monitored field change becomes lower than the specified tolerance), and

    • The solver tolerances are met (Navier-Stokes solver, turbulence solver, and transition model solver residuals are within their specified tolerances).

  3. Simulation Stop: The simulation stops when all configured criteria are satisfied simultaneously. However, the maximum number of steps (set in time stepping configuration) has the highest authority and will stop the simulation regardless of other conditions.

Important

There is an AND relation between user-defined stopping criteria and solver tolerances—both must be satisfied for the simulation to stop. If user-defined stopping criteria are met but the solver tolerances are not satisfied, the simulation continues until the solver tolerances are met. Conversely, if the solver tolerances are met first, the simulation continues until all user-defined stopping criteria are satisfied. However, the maximum number of steps (set in time stepping configuration) overrides all other stopping conditions and will terminate the simulation when reached.

See Also#

Contents