49.14 GeostaticStep object

The GeostaticStep object is used to verify that the geostatic stress field is in equilibrium with the applied loads and boundary conditions on the model and to iterate, if needed, to obtain equilibrium.

The GeostaticStep object is derived from the AnalysisStep object.

Access
import step
mdb.models[name].steps[name]


49.14.1 GeostaticStep(...)

This method creates a GeostaticStep object.

Path
mdb.models[name].GeostaticStep

Required arguments

name

A String specifying the repository key.

previous

A String specifying the name of the previous step. The new step appears after this step in the list of analysis steps.

Optional arguments

description

A String specifying a description of the new step. The default value is an empty string.

nlgeom

A Boolean specifying whether geometric nonlinearities should be accounted for during the step. The default value is OFF.

matrixSolver

A SymbolicConstant specifying the type of solver. Possible values are DIRECT and ITERATIVE. The default value is DIRECT.

matrixStorage

A SymbolicConstant specifying the type of matrix storage. Possible values are SYMMETRIC, UNSYMMETRIC, and SOLVER_DEFAULT. The default value is SOLVER_DEFAULT.

maintainAttributes

A Boolean specifying whether to retain attributes from an existing step with the same name. The default value is False.

solutionTechnique

A SymbolicConstant specifying the technique used to for solving nonlinear equations. Possible values are FULL_NEWTON and QUASI_NEWTON. The default value is FULL_NEWTON.

reformKernel

An Int specifying the number of quasi-Newton iterations allowed before the kernel matrix is reformed.. The default value is 8.

convertSDI

A SymbolicConstant specifying whether to force a new iteration if severe discontinuities occur during an iteration. Possible values are PROPAGATED, CONVERT_SDI_OFF, and CONVERT_SDI_ON. The default value is PROPAGATED.

utol

None or a Float specifying the tolerance for maximum change of displacements. The default value is None.

timePeriod

A Float specifying the total time period. The default value is 1.0.

Note:  This parameter is ignored unless timeIncrementationMethod=AUTOMATIC.

timeIncrementationMethod

A SymbolicConstant specifying the time incrementation method to be used. Possible values are FIXED and AUTOMATIC. The default value is AUTOMATIC.

initialInc

A Float specifying the initial time increment. The default value is the total time period for the step.

Note:  This parameter is ignored unless timeIncrementationMethod=AUTOMATIC.

minInc

A Float specifying the minimum time increment allowed. The default value is the smaller of the suggested initial time increment or 10–5 times the total time period.

Note:  This parameter is ignored unless timeIncrementationMethod=AUTOMATIC.

maxInc

A Float specifying the maximum time increment allowed. The default value is the total time period for the step.

Note:  This parameter is ignored unless timeIncrementationMethod=AUTOMATIC.

Return value

A GeostaticStep object.

Exceptions

RangeError.


49.14.2 setValues(...)

This method modifies the GeostaticStep object.

Required arguments

None.

Optional arguments

The optional arguments to setValues are the same as the arguments to the GeostaticStep method, except for the name, previous, and maintainAttributes arguments.

Return value

None

Exceptions

RangeError.


49.14.3  Members

The GeostaticStep object can have the following members:

name

A String specifying the repository key.

nlgeom

A Boolean specifying whether geometric nonlinearities should be accounted for during the step. The default value is OFF.

matrixSolver

A SymbolicConstant specifying the type of solver. Possible values are DIRECT and ITERATIVE. The default value is DIRECT.

matrixStorage

A SymbolicConstant specifying the type of matrix storage. Possible values are SYMMETRIC, UNSYMMETRIC, and SOLVER_DEFAULT. The default value is SOLVER_DEFAULT.

solutionTechnique

A SymbolicConstant specifying the technique used to for solving nonlinear equations. Possible values are FULL_NEWTON and QUASI_NEWTON. The default value is FULL_NEWTON.

reformKernel

An Int specifying the number of quasi-Newton iterations allowed before the kernel matrix is reformed.. The default value is 8.

convertSDI

A SymbolicConstant specifying whether to force a new iteration if severe discontinuities occur during an iteration. Possible values are PROPAGATED, CONVERT_SDI_OFF, and CONVERT_SDI_ON. The default value is PROPAGATED.

utol

None or a Float specifying the tolerance for maximum change of displacements. The default value is None.

timePeriod

A Float specifying the total time period. The default value is 1.0.

Note:  This parameter is ignored unless timeIncrementationMethod=AUTOMATIC.

timeIncrementationMethod

A SymbolicConstant specifying the time incrementation method to be used. Possible values are FIXED and AUTOMATIC. The default value is AUTOMATIC.

initialInc

A Float specifying the initial time increment. The default value is the total time period for the step.

Note:  This parameter is ignored unless timeIncrementationMethod=AUTOMATIC.

minInc

A Float specifying the minimum time increment allowed. The default value is the smaller of the suggested initial time increment or 10–5 times the total time period.

Note:  This parameter is ignored unless timeIncrementationMethod=AUTOMATIC.

maxInc

A Float specifying the maximum time increment allowed. The default value is the total time period for the step.

Note:  This parameter is ignored unless timeIncrementationMethod=AUTOMATIC.

previous

A String specifying the name of the previous step. The new step appears after this step in the list of analysis steps.

description

A String specifying a description of the new step. The default value is an empty string.

explicit

A SymbolicConstant specifying whether the step has an explicit procedure type (procedureType=ANNEAL, DYNAMIC_EXPLICIT, or DYNAMIC_TEMP_DISPLACEMENT).

perturbation

A Boolean specifying whether the step has a perturbation procedure type.

nonmechanical

A Boolean specifying whether the step has a mechanical procedure type.

procedureType

A SymbolicConstant specifying the Abaqus procedure. Possible values are:

  • ANNEAL

  • BUCKLE

  • COMPLEX_FREQUENCY

  • COUPLED_TEMP_DISPLACEMENT

  • COUPLED_THERMAL_ELECTRIC

  • DIRECT_CYCLIC

  • DYNAMIC_IMPLICIT

  • DYNAMIC_EXPLICIT

  • DYNAMIC_SUBSPACE

  • DYNAMIC_TEMP_DISPLACEMENT

  • COUPLED_THERMAL_ELECTRICAL_STRUCTURAL

  • FLOW

  • FREQUENCY

  • GEOSTATIC

  • HEAT_TRANSFER

  • MASS_DIFFUSION

  • MODAL_DYNAMICS

  • RANDOM_RESPONSE

  • RESPONSE_SPECTRUM

  • SOILS

  • STATIC_GENERAL

  • STATIC_LINEAR_PERTURBATION

  • STATIC_RIKS

  • STEADY_STATE_DIRECT

  • STEADY_STATE_MODAL

  • STEADY_STATE_SUBSPACE

  • VISCO

suppressed

A Boolean specifying whether the step is suppressed or not. The default value is OFF.

fieldOutputRequestState

A repository of FieldOutputRequestState objects.

historyOutputRequestState

A repository of HistoryOutputRequestState objects.

diagnosticPrint

A DiagnosticPrint object.

monitor

A Monitor object.

restart

A Restart object.

adaptiveMeshConstraintStates

A repository of AdaptiveMeshConstraintState objects.

adaptiveMeshDomains

A repository of AdaptiveMeshDomain objects.

control

A Control object.

solverControl

A SolverControl object.

boundaryConditionStates

A repository of BoundaryConditionState objects.

interactionStates

A repository of InteractionState objects.

loadStates

A repository of LoadState objects.

loadCases

A repository of LoadCase objects.

predefinedFieldStates

A repository of PredefinedFieldState objects.


49.14.4  Corresponding analysis keywords

*GEOSTATIC
*STEP