GlobalStabilization (singleton)

Configure global (analysis-level) stabilization settings.

For more information, see Quasi-Newton Stabilization Algorithm in the System Coupling User's Guide.


Tip:  Shown in the GUI as the Analysis Control | Global Stabilization branch.


*Option (setting)

Controls whether solution stabilization is applied globally to the coupled analysis.

Possible values:

  • None (default value)

    Global stabilization is not applied to the coupled analysis.

  • Quasi-Newton

    Global stabilization is applied to the coupled analysis.


    Note:  This setting is ignored when the data model is optimized for one-way workflows and the data transfers are one-way.



Tip:  Shown in the GUI as the Analysis Control | Global Stabilization | Option setting.


*InitialRelaxationFactor (setting)

Available when the GlobalStabilization.Option is set to Quasi-Newton.

Under-relaxation factor applied during the startup iteration (that is, before the Quasi-Newton algorithm starts modifying the data transfers) to ensure divergence does not occur during startup.

For System Coupling's GUI or CLI, accepts real values 0.0 ≤ x ≤ 1.0. Default value is 0.01.

For System Coupling in Workbench, only the default value of 0.01 is available.

The default relaxation factor is quite heavy. If the risk of immediate divergence is low, then you can sometimes achieve faster convergence by increasing this value.

For more detailed information, see Quasi-Newton Stabilization Algorithm in the System Coupling User's Guide.


Tip:  Shown in the GUI as the Analysis Control | Global Stabilization | Initial Relaxation Factor setting.


*MaximumRetainedTimeSteps (setting)

Available for transient analyses when GlobalStabilization.Option is set to Quasi-Newton and if all participants can iterate.

Maximum number of previous time steps to be retained in the Quasi-Newton history.

For System Coupling's GUI or CLI, accepts integer values greater than or equal to than 1. Default value is 1.

For System Coupling in Workbench, only the default value of 1 is available.

The optimal value is problem-dependent. Some cases may achieve faster convergence by increasing the value (for example, to 5).

For more detailed information, see Quasi-Newton Stabilization Algorithm in the System Coupling User's Guide.


Tip:  Shown in the GUI as the Analysis Control | Global Stabilization | Maximum Retained Time Steps setting.


*MaximumRetainedIterations (setting)

Available when the GlobalStabilization.Option is set to Quasi-Newton.

Maximum amount of data that can be stored and used by the Quasi-Newton algorithm. Larger values can improve convergence, but can also increase the computational cost and data storage overhead of System Coupling.

For System Coupling's GUI or CLI, accepts integer values greater than or equal to than 1. Default value is 20.


Tip:  Shown in the GUI as the Analysis Control | Global Stabilization | Maximum Retained Iterations setting.