Commonly used control parameters

Solution control parameters can be used to control:

nonlinear equation solution accuracy and
time increment adjustment.

These solution control parameters need not be changed for most analyses. In difficult cases, however, the solution procedure may not converge with the default controls or may use an excessive number of increments and iterations. After it has been established that such problems are not due to modeling errors, it may be useful to change certain control parameters.

This section presents a brief synopsis of the more important solution control parameters, together with a description of the circumstances in which they can be used effectively.

Values given for the solution control parameters remain in effect for the remainder of the analysis or until they are reset. You can restore all solution control parameters to their default values (see About convergence and time integration criteria).

The following topics are discussed:

Terminology
Defining tolerances for field equations
Controlling the time incrementation scheme
Activating the “line search” algorithm
Defining tolerances for constraint equations
Controlling the solution accuracy in direct cyclic analysis

Terminology

In this section the word “flux” means the variable whose discretized equilibrium is being sought and for which the equilibrium equations may be nonlinear: force, moment, heat flux, concentration volumetric flux, or pore liquid volumetric flux. The word “field” refers to the basic variables of the system, such as the components of the displacement in a continuum stress analysis or temperature in a heat transfer analysis. The superscript $α$ refers to one such type of equation. The fields and corresponding fluxes available in Abaqus/Standard are listed in Convergence criteria for nonlinear problems.

Defining tolerances for field equations

Solution control parameters can be used to define tolerances for field equations. You can select the type of equation for which the solution control parameters are being defined, as shown in Table 1. The default tolerances can be reset if the analysis does not require high accuracy in the convergence criteria.

Table 1. Selecting the field equation. The input file parameters are followed by the corresponding Abaqus/CAE conditions in parentheses.
Equilibrium equation	Input file (Abaqus/CAE)	DOF
All active fields	FIELD=GLOBAL(Apply to all applicable fields)	all
Force and bimoment	FIELD=DISPLACEMENT(Displacement)	1, 2, 3, 7
Moment	FIELD=ROTATION(Rotation)	4, 5, 6
Heat transfer	FIELD=TEMPERATURE(Temperature)	11, 12, 13, ...
Hydrostatic fluid	FIELD=HYDROSTATIC FLUID PRESSURE(Hydrostatic Fluid Pressure)	8
Pore fluid pressure	FIELD=PORE FLUID PRESSURE(Pore Fluid Pressure)	8
Mass diffusion	FIELD=CONCENTRATION(Concentration)	11
Electrical conduction	FIELD=ELECTRICAL POTENTIAL(Electrical Potential)	9
Mechanism analysis (connector elements with material flow degree of freedom)	FIELD=MATERIAL FLOW(Unsupported)	10
Analysis containing C3D4H elements (all materials, except compressible hyperelastic elastomers and elastomeric foams).	FIELD=PRESSURE LAGRANGE MULTIPLIER(Unsupported)	N/A
Analysis containing C3D4H elements with compressible hyperelastic or hyperfoam materials.	FIELD=VOLUMETRIC LAGRANGE MULTIPLIER(Unsupported)	N/A

The most significant solution control parameters for field equation tolerances— $R_{n}^{α}$ , $C_{n}^{α}$ , ${\tilde{q}}_{0}^{α}$ , and ${\tilde{q}}_{u}^{α}$ —may have to be modified in cases where the residuals are large relative to the fluxes or in cases where the incremental solution is essentially zero.

Input File Usage

CONTROLS, PARAMETERS=FIELD, FIELD=field

Abaqus/CAE Usage

Step module: OtherGeneral Solution ControlsEdit: toggle on Specify: Field Equations: Apply to all applicable fields or Specify individual fields: field

Modifying the residual control

$R_{n}^{α}$ is the convergence criterion for the ratio of the largest residual to the corresponding average flux norm, ${\tilde{q}}^{α}$ , for convergence. ${\tilde{q}}^{α}$ is defined in Convergence criteria for nonlinear problems. The default value is $R_{n}^{α}$ = 5 × 10⁻³, which is rather strict by engineering standards but in all but exceptional cases will guarantee an accurate solution to complex nonlinear problems. The value for this ratio can be increased to a larger number if some accuracy can be sacrificed for computational speed.

Modifying the solution correction control

$C_{n}^{α}$ is the convergence criterion for the ratio of the largest solution correction to the largest corresponding incremental solution value. The default value is $C_{n}^{α}$ = 10⁻². In addition to sufficiently small residuals, Abaqus/Standard requires that the largest correction to the solution value be small in comparison to the largest corresponding incremental solution value. Some analyses may not require such accuracy, thus permitting this ratio to be increased. To avoid testing the magnitude of the solution correction, you can set $C_{n}^{α}$ to 1.0.

Specifying the average flux

${\tilde{q}}^{α}$ is the value of average flux used by Abaqus/Standard for checking residuals. The default value is the time average flux calculated by Abaqus/Standard, as defined in Convergence criteria for nonlinear problems. You may, however, define a constant value, ${\tilde{q}}_{u}^{α}$ , for the average flux, in which case ${\tilde{q}}^{α} = {\tilde{q}}_{u}^{α}$ throughout the step.

You may wish to use absolute tolerances for your residual checks. The absolute tolerance value is then equal to the product of the average flux, ${\tilde{q}}_{u}^{α}$ , and the ratio $R_{n}^{α}$ .

Modifying the initial time average flux

${\tilde{q}}_{0}^{α}$ is the initial value of the time average flux for the current step. The default value is the time average flux from the previous step or 10⁻² if this is Step 1. Redefining ${\tilde{q}}_{0}^{α}$ is sometimes helpful when a coupled problem is analyzed and some of the fields in the problem are not active in the first step; for example, if a static step is carried out before a fully coupled thermal-stress step.

Redefinition of ${\tilde{q}}_{0}^{α}$ can also be useful if the first step is essentially a null step; for example, in a contact problem before any contact occurs, the initial fluxes (forces) generated are zero. In such cases ${\tilde{q}}_{0}^{α}$ should be given as a typical flux magnitude that will occur when field $α$ first becomes active.

The initial value of ${\tilde{q}}^{α}$ is retained until an iteration is completed for which ${\bar{q}}^{α} > ϵ^{α} {\tilde{q}}^{α}$ , at which time we redefine ${\tilde{q}}^{α} = {\bar{q}}^{α}$ . This new ${\tilde{q}}^{α}$ can become less than ${\tilde{q}}_{0}^{α}$ . The criterion for zero flux compared to ${\tilde{q}}^{α}$ is ${\bar{q}}^{α} \leq \tilde{q} {}^{α}\cdot ϵ^{α}$ (see Convergence criteria for nonlinear problems).

If you specify the average flux, ${\tilde{q}}_{u}^{α}$ , directly, the value given for ${\tilde{q}}_{0}^{α}$ is ignored.

Abaqus/Standard output

The controls in effect for an analysis are listed in the data (.dat) and message (.msg) files. Nondefault controls are marked by ***. For example, specifying the following controls:

Field Equation	$R_{n}^{α}$	$C_{n}^{α}$	${\tilde{q}}_{0}^{α}$	${\tilde{q}}_{u}^{α}$	$R_{P}^{α}$	$ϵ^{α}$
Displacement	0.01	1.0	10.0	–	–	1.E−4
Rotation	0.02	2.0	20.0	2.E3	–	–

would result in the following output:

CONVERGENCE TOLERANCE PARAMETERS FOR FORCE
*** CRIT. FOR RESIDUAL FORCE FOR A NONLINEAR PROBLEM       1.000E-02
*** CRITERION FOR DISP. CORRECTION IN A NONLINEAR PROBLEM       1.00
*** INITIAL VALUE OF TIME AVERAGE FORCE                         10.0
    AVERAGE FORCE IS TIME AVERAGE FORCE
    ALT. CRIT. FOR RESIDUAL FORCE FOR A NONLINEAR PROBLEM  2.000E-02
*** CRIT. FOR ZERO FORCE RELATIVE TO TIME AVRG. FORCE      1.000E-04
    CRIT. FOR DISP. CORRECTION WHEN THERE IS ZERO FLUX     1.000E-03
    CRIT. FOR RESIDUAL FORCE WHEN THERE IS ZERO FLUX       1.000E-08
    FIELD CONVERSION RATIO                                      1.00
CONVERGENCE TOLERANCE PARAMETERS FOR MOMENT
 *** CRIT. FOR RESIDUAL MOMENT FOR A NONLINEAR PROBLEM     2.000E-02
 *** CRIT. FOR ROTATION CORRECTION IN A NONLINEAR PROBLEM       2.00
 *** INITIAL VALUE OF TIME AVERAGE MOMENT                       20.0
 *** USER DEFINED VALUE OF AVERAGE MOMENT NORM             2.000E+03
     ALT. CRIT. FOR RESID. MOMENT FOR A NONLINEAR PROBLEM  2.000E-02
     CRIT. FOR ZERO MOMENT RELATIVE TO TIME AVRG. MOMENT   1.000E-05
     CRIT. FOR ROTATION CORRECTION WHEN ZERO FLUX          1.000E-03
     CRIT. FOR RESIDUAL MOMENT WHEN ZERO FLUX              1.000E-08
     FIELD CONVERSION RATIO                                     1.00

Controlling the time incrementation scheme

Solution control parameters can be used to alter both the convergence control algorithm and the time incrementation scheme. The time incrementation parameters $I_{0}$ and $I_{R}$ are the most significant since they have a direct effect on convergence. They may have to be modified if convergence is (initially) nonmonotonic or if convergence is nonquadratic.

Nonmonotonic convergence may occur if various nonlinearities interact; for example, the combination of friction, nonlinear material behavior, and geometric nonlinearity may lead to nonmonotonically decreasing residuals.

Nonquadratic convergence will occur if the Jacobian is not exact, which may occur for complex material models. It may also occur if the Jacobian is nonsymmetric but the symmetric equation solver is used. In that case the unsymmetric equation solver should be specified for the step (see Defining an analysis).

Input File Usage

CONTROLS, PARAMETERS=TIME INCREMENTATION

Abaqus/CAE Usage

Step module: OtherGeneral Solution ControlsEdit: toggle on Specify: Time Incrementation

Specifying the equilibrium iteration for a residual check

$I_{0}$ is the number of equilibrium iterations after which the check is made that the residuals are not increasing in two consecutive iterations. The default value is $I_{0} = 4$ . If the initial convergence is nonmonotonic, it may be necessary to increase this value.

Specifying the equilibrium iteration for a logarithmic rate of convergence check

$I_{R}$ is the number of equilibrium iterations after which the logarithmic rate of convergence check begins. The default value is $I_{R} = 8$ . In cases where convergence is nonquadratic and this cannot be corrected by using the unsymmetric equation solver for the step, the logarithmic convergence check should be eliminated by setting this parameter to a high value.

Avoiding premature cutbacks in difficult analyses

Sometimes it is useful to increase both $I_{0}$ and $I_{R}$ . For example, in a difficult analysis involving both friction and the concrete material model, it may be helpful to set $I_{0} = 8$ and $I_{R} = 10$ to avoid premature cutbacks of the time increment. These two parameters can be raised to more appropriate values for severely discontinuous problems by increasing them individually.

Automatically setting the time incrementation parameters

You can automatically set the parameters described above to the values $I_{0} = 8$ and $I_{R} = 10$ . In this case any values that you specified previously for $I_{0}$ and $I_{R}$ are overridden. However, if $I_{0}$ and $I_{R}$ are specified multiple times in a step with different solution control settings, the last definition will be used.

Input File Usage

CONTROLS, ANALYSIS=DISCONTINUOUS

Abaqus/CAE Usage

Step module: OtherGeneral Solution ControlsEdit: toggle on Specify: Time Incrementation: Discontinuous analysis

Improving solution efficiency in a problem that involves a high coefficient of friction

The solution efficiency can sometimes be improved in an analysis that involves a high coefficient of friction by automatically setting the time incrementation parameters and using the unsymmetric equation solver.

Abaqus/Standard output

The controls in effect for an analysis are listed in the data (.dat) and message (.msg) files. Nondefault controls are marked by **. For example, specifying the time incrementation parameters $I_{0}$ =7 and $I_{R}$ =10 would result in the following output:

TIME INCREMENTATION CONTROL PARAMETERS:
 *** FIRST EQUIL. ITERATION FOR CONSECUTIVE DIVERGENCE CHECK       7
 *** EQUIL. ITER. AT WHICH LOG. CONVERGENCE RATE CHECK BEGINS     10
     EQUIL. ITER. AFTER WHICH ALTERNATE RESIDUAL IS USED           9
     MAXIMUM EQUILIBRIUM ITERATIONS ALLOWED                       16
     EQUIL. ITERATION COUNT FOR CUT-BACK IN NEXT INCREMENT        10
     MAX EQUIL. ITERS IN TWO INCREMENTS FOR TIME INC. INCREASE     4
     MAXIMUM ITERATIONS FOR SEVERE DISCONTINUITIES                12
     MAXIMUM CUT-BACKS ALLOWED IN AN INCREMENT                     5
     MAX DISCON. ITERS IN TWO INCS FOR TIME INC. INCREASE          6
     CUT-BACK FACTOR AFTER DIVERGENCE                          0.250
     CUT-BACK FACTOR FOR TOO SLOW CONVERGENCE                  0.500
     CUT-BACK FACTOR AFTER TOO MANY EQUILIBRIUM ITERATIONS     0.750

Activating the “line search” algorithm

In strongly nonlinear problems the Newton algorithms used in Abaqus/Standard may sometimes diverge during equilibrium iteration. The line search algorithm (discussed in Improving the efficiency of the solution by using the line search algorithm) detects these situations automatically and applies a scale factor to the computed solution correction, which helps to prevent divergence. The line search algorithm is particularly useful when the quasi-Newton method (see Solution method) is used.

By default, the line search algorithm is enabled only during steps where the quasi-Newton method is used. Set the maximum number of line search iterations, $N^{l s}$ , to a reasonable value (such as 5) to activate the line search procedure or to zero to forcibly deactivate the line search.

Input File Usage

CONTROLS, PARAMETERS=LINE SEARCH
 $N^{l s}$

Abaqus/CAE Usage

Step module: OtherGeneral Solution ControlsEdit: toggle on Specify: Line Search Control:  $N^{l s}$

Defining tolerances for constraint equations

Solution control parameters can be used to set tolerances for constraint equations. You can set strain compatibility tolerances for hybrid elements, displacement and rotation compatibility tolerances for distributing coupling constraints (specified as surface-based constraints or using DCOUP2D/DCOUP3D elements), and compatibility tolerances for softened contact. See Convergence criteria for nonlinear problems for details.

Controlling the solution accuracy in direct cyclic analysis

Solution control parameters can be used in direct cyclic analysis to specify when to impose the periodicity conditions and to set tolerances for stabilized state and plastic ratchetting detections.

Input File Usage

CONTROLS, TYPE=DIRECT CYCLIC 
 $I_{P I}$ ,  $C R_{n}^{α}$ ,   $C U_{n}^{α}$ ,  $C R_{0}^{α}$ ,   $C U_{0}^{α}$

Abaqus/CAE Usage

Step module: OtherGeneral Solution ControlsEdit: toggle on Specify: Direct Cyclic:   $I_{P I}$ ,  $C R_{n}^{α}$ ,   $C U_{n}^{α}$ ,  $C R_{0}^{α}$ ,   $C U_{0}^{α}$

Imposing the periodicity condition

You can specify the iteration number at which the periodicity condition is first imposed, $I_{P I}$ . The default value is $I_{P I}$ = 1, in which case the periodicity condition is imposed for all iterations from the beginning of an analysis. This solution control parameter rarely needs to be reset from its default value.

Defining tolerances for stabilized state and plastic ratchetting detections

You can specify the stabilized state detection criteria, $C R_{n}^{α}$ and $C U_{n}^{α}$ . $C R_{n}^{α}$ is the maximum allowable ratio of the largest residual coefficient on any terms in the Fourier series to the corresponding average flux norm, and $C U_{n}^{α}$ is the maximum allowable ratio of the largest correction to the displacement coefficient on any terms in the Fourier series to the largest displacement coefficient. The default values are $C R_{n}^{α}$ = 5 × 10⁻³ and $C U_{n}^{α}$ = 5 × 10⁻³. The solution converges to a stabilized state if both these criteria are satisfied.

If plastic ratchetting occurs, the shape of the stress-strain curves remains unchanged but the mean value of the plastic strain over a cycle continues to shift from one iteration to the next. In that case it is desirable to use separate tolerances for the constant term in the Fourier series to detect the plastic ratchetting.

You can also specify the plastic ratchetting detection criteria, $C R_{0}^{α}$ and $C U_{0}^{α}$ . $C R_{0}^{α}$ is the maximum allowable ratio of the largest residual coefficient on the constant term in the Fourier series to the corresponding average flux norm, and $C U_{0}^{α}$ is the maximum allowable ratio of the largest correction to the displacement coefficient on the constant term in the Fourier series to the largest displacement coefficient. The default values are $C R_{0}^{α}$ = 5 × 10⁻³ and $C U_{0}^{α}$ = 5 × 10⁻³. Plastic ratchetting is expected if the residual coefficients and the corrections to the displacement coefficients on any of the periodic terms are within the tolerances set by $C R_{n}^{α}$ and $C U_{n}^{α}$ , respectively, but the maximum residual coefficient on the constant term and the maximum correction to the displacement coefficient on the constant term exceed the tolerances set by $C R_{0}^{α}$ and $C U_{0}^{α}$ , respectively.

Abaqus/Standard output

The controls in effect for an analysis are listed in the data (.dat) and message (.msg) files. Nondefault controls are marked by **. For example, specifying the following controls:

$I_{P I}$	$C R_{n}^{α}$	$C U_{n}^{α}$	$C R_{0}^{α}$	$C U_{0}^{α}$
5	1.0E−4	1.0E−4	1.0E−4	1.E−4

would result in the following output:

STABILIZED STATE AND PLASTIC RATCHETTING DETECTION
PARAMETERS FOR FORCE 
** CRIT. FOR RESI. COEFF. ON ANY FOURIER TERMS            1.0E-04
** CRIT. FOR CORR. TO DISP. COEFF. ON ANY FOURIER TERMS   1.0E-04
** CRIT. FOR RESI. COEFF. ON CONSTANT FOURIER TERM        1.0E-04
** CRIT. FOR CORR. TO DISP. COEFF. ON CONST. FOURIER TERM 1.0E-04

PERIODICITY CONDITION CONTROL PARAMETER:
** ITERATION NUMBER AT WHICH PERIODICITY CONDITION
** STARTS TO IMPOSE                                             5