7.2.2 Commonly used control parameters

**Products: **ABAQUS/Standard ABAQUS/CAE

Solution control parameters can be used to control:

nonlinear equation solution accuracy and

time increment adjustment.

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 “Convergence and time integration criteria: overview,” Section 7.2.1).

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,” Section 7.2.3.

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 7.2.2–1. The default tolerances can be reset if the analysis does not require high accuracy in the convergence criteria.

**Table 7.2.2–1** Selecting the field equation.

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 |

Input File Usage: | *CONTROLS, PARAMETERS=FIELD, FIELD= |

ABAQUS/CAE Usage: | Step module: Specify: Field Equations: Apply to all applicable fields or Specify individual fields: field |

is the convergence criterion for the ratio of the largest residual to the corresponding average flux norm, , for convergence. is defined in “Convergence criteria for nonlinear problems,” Section 7.2.3. The default value is = 5 × 10^{–3}, 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.

is the convergence criterion for the ratio of the largest solution correction to the largest corresponding incremental solution value. The default value is = 10^{–2}. 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.

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,” Section 7.2.3. You may, however, define a constant value, , for the average flux, in which case 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, , and the ratio . To avoid testing the magnitude of the solution correction, you can set to 1.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^{–2} if this is Step 1. Redefining 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 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 should be given as a typical flux magnitude that will occur when field first becomes active.

The initial value of is retained until an iteration is completed for which , at which time we redefine . The criterion for zero flux compared to is (see “Convergence criteria for nonlinear problems,” Section 7.2.3).

If you specify the average flux, , directly, the value given for is ignored.

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:

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 *** 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 and 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 “Procedures: overview,” Section 6.1.1).

Input File Usage: | *CONTROLS, PARAMETERS=TIME INCREMENTATION |

ABAQUS/CAE Usage: | Step module: Specify: Time Incrementation |

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 . If the initial convergence is nonmonotonic, it may be necessary to increase this value.

is the number of equilibrium iterations after which the logarithmic rate of convergence check begins. The default value is . 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.

Sometimes it is useful to increase both and . For example, in a difficult analysis involving both friction and the concrete material model, it may be helpful to set and 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.

You can automatically set the parameters described above to the values and . In this case any values that you specify for and are overridden.

Input File Usage: | *CONTROLS, ANALYSIS=DISCONTINUOUS |

ABAQUS/CAE Usage: | Step module: Specify: Time Incrementation: Discontinuous analysis |

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.

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 =7 and =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” in “Convergence criteria for nonlinear problems,” Section 7.2.3) 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” in “Convergence criteria for nonlinear problems,” Section 7.2.3) 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, , 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 |

ABAQUS/CAE Usage: | Step module: Specify: Line Search Control: |

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,” Section 7.2.3, 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 , , , , |

ABAQUS/CAE Usage: | Direct cyclic analysis is not supported in ABAQUS/CAE. |

You can specify the iteration number at which the periodicity condition is first imposed, . The default value is = 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.

You can specify the stabilized state detection criteria, and . is the maximum allowable ratio of the largest residual coefficient on any terms in the Fourier series to the corresponding average flux norm, and 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 = 5 × 10^{–3} and = 5 × 10^{–3}. 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, and . 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 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 = 5 × 10^{–3} and = 5 × 10^{–3}. 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 and , 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 and , respectively.

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:

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