Step#

The Step commands described in this chapter are used to create and configure analysis steps. Step commands (output) describes the commands used to create and configure output requests and integrated output sections and the commands to configure diagnostic printing, monitoring, and restart. Step commands (miscellaneous) describes the commands used to configure controls, damping, and frequency tables.

Objects in Step

Step Miscellaneous

Create steps#

class StepModel(name: str, description: str = '', stefanBoltzmann: float | None = None, absoluteZero: float | None = None, waveFormulation: SymbolicConstantType = 'NOT_SET', modelType: SymbolicConstantType = 'STANDARD_EXPLICIT', universalGas: float | None = None, copyConstraints: BooleanType = 1, copyConnectors: BooleanType = 1, copyInteractions: BooleanType = 1)[source]#

Abaqus creates a Model object named Model-1 when a session is started.

Notes

This object can be accessed by:

mdb.models[name]

Methods

`AnnealStep`(name, previous[, description, ...])	This method creates an AnnealStep object.
`BuckleStep`(name, previous, numEigen[, ...])	This method creates a BuckleStep object.
`ComplexFrequencyStep`(name, previous[, ...])	This method creates a ComplexFrequencyStep object.
`CoupledTempDisplacementStep`(name, previous)	This method creates a CoupledTempDisplacementStep object.
`CoupledThermalElectricStep`(name, previous[, ...])	This method creates a CoupledThermalElectricStep object.
`CoupledThermalElectricalStructuralStep`(name, ...)	This method creates a CoupledThermalElectricalStructuralStep object.
`DirectCyclicStep`(name, previous[, ...])	This method creates a DirectCyclicStep object.
`EmagTimeHarmonicStep`(name, previous, ...[, ...])	This method creates a EmagTimeHarmonicStep object.
`ExplicitDynamicsStep`(name, previous[, ...])	This method creates an ExplicitDynamicsStep object.
`FrequencyStep`(name, previous, eigensolver[, ...])	This method creates a FrequencyStep object.
`GeostaticStep`(name, previous[, description, ...])	This method creates a GeostaticStep object.
`HeatTransferStep`(name, previous[, ...])	This method creates a HeatTransferStep object.
`ImplicitDynamicsStep`(name, previous[, ...])	This method creates an ImplicitDynamicsStep object.
`MassDiffusionStep`(name, previous[, ...])	This method creates a MassDiffusionStep object.
`ModalDynamicsStep`(name, previous[, ...])	This method creates a ModalDynamicsStep object.
`RandomResponseStep`(name, previous, freq[, ...])	This method creates a RandomResponseStep object.
`ResponseSpectrumStep`(name, previous, components)	This method creates a ResponseSpectrumStep object.
`SoilsStep`(name, previous[, description, ...])	This method creates a SoilsStep object.
`StaticLinearPerturbationStep`(name, previous)	This method creates a StaticLinearPerturbationStep object.
`StaticRiksStep`(name, previous[, ...])	This method creates a StaticRiksStep object.
`StaticStep`(name, previous[, description, ...])	This method creates a StaticStep object.
`SteadyStateDirectStep`(name, previous, ...[, ...])	This method creates a SteadyStateDirectStep object.
`SteadyStateModalStep`(name, previous, ...[, ...])	This method creates a SteadyStateModalStep object.
`SteadyStateSubspaceStep`(name, previous, ...)	This method creates a SteadyStateSubspaceStep object.
`SubspaceDynamicsStep`(name, previous[, ...])	This method creates a SubspaceDynamicsStep object.
`SubstructureGenerateStep`(name, previous, ...)	This method creates a SubstructureGenerateStep object.
`TempDisplacementDynamicsStep`(name, previous)	This method creates a TempDisplacementDynamicsStep object.
`ViscoStep`(name, previous[, description, ...])	This method creates a ViscoStep object.

AnnealStep(name: str, previous: str, description: str = '', refTemp: float | None = None, maintainAttributes: BooleanType = False) → AnnealStep[source]#

This method creates an AnnealStep object.

Parameters:

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.
description: A String specifying a description of the new step. The default value is an empty string.
refTemp: A Float specifying the post-anneal reference temperature. The default value is the current temperature at all nodes in the model after the annealing has completed.
maintainAttributes: A Boolean specifying whether to retain attributes from an existing step with the same name. The default value is False.

Returns:

step: AnnealStep: An AnnealStep object.

Notes

This function can be accessed by:

mdb.models[name].AnnealStep

BuckleStep(name: str, previous: str, numEigen: int, description: str = '', eigensolver: SymbolicConstantType = 'SUBSPACE', minEigen: float | None = None, maxEigen: float | None = None, vectors: int | None = None, maxIterations: int = 30, blockSize: SymbolicConstantType = 'DEFAULT', maxBlocks: SymbolicConstantType = 'DEFAULT', matrixStorage: SymbolicConstantType = 'SOLVER_DEFAULT', maintainAttributes: BooleanType = False) → BuckleStep[source]#

This method creates a BuckleStep object.

Parameters:

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.
numEigen: An Int specifying the number of eigenvalues to be estimated.
description: A String specifying a description of the new step. The default value is an empty string.
eigensolver: A SymbolicConstant specifying the eigensolver. Possible values are SUBSPACE and LANCZOS. The default value is SUBSPACE.
minEigen: None or a Float specifying the minimum eigenvalue of interest. The default value is None.
maxEigen: None or a Float specifying the maximum eigenvalue of interest. The default value is None.
vectors: An Int specifying the number of vectors used in the iteration. The default value is the minimum of (2*n*, n + 8), where n is the number of eigenvalues requested.
maxIterations: An Int specifying the maximum number of iterations. The default value is 30.
blockSize: The SymbolicConstant DEFAULT or an Int specifying the size of the Lanczos block steps. The default value is DEFAULT.
maxBlocks: The SymbolicConstant DEFAULT or an Int specifying the maximum number of Lanczos block steps within each Lanczos run. The default value is DEFAULT.Note:minEigen, blockSize, and maxBlocks are ignored unless *eigensolver*=LANCZOS.
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.

Returns:

step: BuckleStep: A BuckleStep object.

Notes

This function can be accessed by:

mdb.models[name].BuckleStep

ComplexFrequencyStep(name: str, previous: str, numEigen: SymbolicConstantType = 'ALL', description: str = '', shift: float | None = None, frictionDamping: BooleanType = 0, matrixStorage: SymbolicConstantType = 'SOLVER_DEFAULT', maintainAttributes: BooleanType = False, minEigen: float | None = None, maxEigen: float | None = None, propertyEvaluationFrequency: float | None = None) → ComplexFrequencyStep[source]#

This method creates a ComplexFrequencyStep object.

Parameters:

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.
numEigen: The SymbolicConstant ALL or an Int specifying the number of complex eigenmodes to be calculated or a SymbolicConstant ALL. The default value is ALL.
description: A String specifying a description of the new step. The default value is an empty string.
shift: None or a Float specifying the shift point in cycles per time. The default value is None.
frictionDamping: A Boolean specifying whether to add to the damping matrix contributions due to friction effects. The default value is OFF.
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.
minEigen: None or a Float specifying the minimum frequency of interest in cycles per time. The default value is None.
maxEigen: None or a Float specifying the maximum frequency of interest in cycles per time. The default value is None.
propertyEvaluationFrequency: None or a Float specifying the frequency at which to evaluate frequency-dependent properties for viscoelasticity, springs, and dashpots during the eigenvalue extraction. If the value is None, the analysis product will evaluate the stiffness associated with frequency-dependent springs and dashpots at zero frequency and will not consider the stiffness contributions from frequency-domain viscoelasticity in the step. The default value is None.

Returns:

step: ComplexFrequencyStep: A ComplexFrequencyStep object.

Notes

This function can be accessed by:

mdb.models[name].ComplexFrequencyStep

CoupledTempDisplacementStep(name: str, previous: str, description: str = '', response: SymbolicConstantType = 'TRANSIENT', timePeriod: float = 1, nlgeom: BooleanType = 0, stabilizationMethod: SymbolicConstantType = 'NONE', stabilizationMagnitude: float | None = None, timeIncrementationMethod: SymbolicConstantType = 'AUTOMATIC', maxNumInc: int = 100, initialInc: float | None = None, minInc: float | None = None, maxInc: float | None = None, deltmx: float = 0, cetol: float = 0, creepIntegration: SymbolicConstantType = 'IMPLICIT', solutionTechnique: SymbolicConstantType = 'FULL_NEWTON', matrixStorage: SymbolicConstantType = 'SOLVER_DEFAULT', amplitude: SymbolicConstantType = 'STEP', extrapolation: SymbolicConstantType = 'LINEAR', maintainAttributes: BooleanType = False, convertSDI: SymbolicConstantType = 'PROPAGATED', adaptiveDampingRatio: float = 0, continueDampingFactors: BooleanType = 0) → CoupledTempDisplacementStep[source]#

This method creates a CoupledTempDisplacementStep object.

Parameters:

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.
description: A String specifying a description of the new step. The default value is an empty string.
response: A SymbolicConstant specifying the analysis type. Possible values are STEADY_STATE and TRANSIENT. The default value is TRANSIENT.
timePeriod: A Float specifying the total time period for the step. The default value is 1.0.
nlgeom: A Boolean specifying whether geometric nonlinearities should be accounted for during the step. The default value is OFF.
stabilizationMethod: A SymbolicConstant specifying the stabilization type. Possible values are NONE, DISSIPATED_ENERGY_FRACTION, and DAMPING_FACTOR. The default value is NONE.
stabilizationMagnitude: A Float specifying the damping intensity of the automatic damping algorithm if the problem is expected to be unstable and *stabilizationMethod*≠NONE. The default value is 2×10–4.
timeIncrementationMethod: A SymbolicConstant specifying the time incrementation method to be used. Possible values are FIXED and AUTOMATIC. The default value is AUTOMATIC.
maxNumInc: An Int specifying the maximum number of increments in a step. The default value is 100.
initialInc: A Float specifying the initial time increment. The default value is the total time period for the step.
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.
maxInc: A Float specifying the maximum time increment allowed. The default value is the total time period for the step.
deltmx: A Float specifying the maximum temperature change to be allowed in an increment in a transient analysis. The default value is 0.0.
cetol: A Float specifying the maximum difference in the creep strain increment calculated from the creep strain rates at the beginning and end of the increment. The default value is 0.0.
creepIntegration: A SymbolicConstant specifying the type of integration to be used for creep and swelling effects throughout the step. Possible values are IMPLICIT, EXPLICIT, and NONE. The default value is IMPLICIT.
solutionTechnique: A SymbolicConstant specifying the type of solution technique. Possible values are FULL_NEWTON and SEPARATED. The default value is FULL_NEWTON.
matrixStorage: A SymbolicConstant specifying the type of matrix storage. Possible values are SYMMETRIC, UNSYMMETRIC, and SOLVER_DEFAULT. The default value is SOLVER_DEFAULT.
amplitude: A SymbolicConstant specifying the amplitude variation for loading magnitudes during the step. The default value is STEP. Possible values are STEP and RAMP.
extrapolation: A SymbolicConstant specifying the type of extrapolation to use in determining the incremental solution for a nonlinear analysis. Possible values are NONE, LINEAR, and PARABOLIC. The default value is LINEAR.
maintainAttributes: A Boolean specifying whether to retain attributes from an existing step with the same name. The default value is False.
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.
adaptiveDampingRatio: A Float specifying the maximum allowable ratio of the stabilization energy to the total strain energy and can be used only if stabilizationMethod is not NONE. The default value is 0.05.
continueDampingFactors: A Boolean specifying whether this step will carry over the damping factors from the results of the preceding general step. This parameter must be used in conjunction with the adaptiveDampingRatio parameter. The default value is OFF.

Returns:

step: CoupledTempDisplacementStep: A CoupledTempDisplacementStep object.

Notes

This function can be accessed by:

mdb.models[name].CoupledTempDisplacementStep

CoupledThermalElectricStep(name: str, previous: str, description: str = '', response: SymbolicConstantType = 'TRANSIENT', timePeriod: float = 1, timeIncrementationMethod: SymbolicConstantType = 'AUTOMATIC', maxNumInc: int = 100, initialInc: float | None = None, minInc: float | None = None, maxInc: float | None = None, end: SymbolicConstantType = 'PERIOD', deltmx: float = 0, mxdem: float = 0, solutionTechnique: SymbolicConstantType = 'FULL_NEWTON', matrixStorage: SymbolicConstantType = 'SOLVER_DEFAULT', amplitude: SymbolicConstantType = 'STEP', extrapolation: SymbolicConstantType = 'LINEAR', maintainAttributes: BooleanType = False, convertSDI: SymbolicConstantType = 'PROPAGATED') → CoupledThermalElectricStep[source]#

This method creates a CoupledThermalElectricStep object.

Parameters:

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.
description: A String specifying a description of the new step. The default value is an empty string.
response: A SymbolicConstant specifying the analysis type. Possible values are STEADY_STATE and TRANSIENT. The default value is TRANSIENT.
timePeriod: A Float specifying the total time period for the step. The default value is 1.0.
timeIncrementationMethod: A SymbolicConstant specifying the time incrementation method to be used. Possible values are FIXED and AUTOMATIC. The default value is AUTOMATIC.
maxNumInc: An Int specifying the maximum number of increments in a step. The default value is 100.
initialInc: A Float specifying the initial time increment. The default value is the total time period for the step.
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.
maxInc: A Float specifying the maximum time increment allowed. The default value is the total time period for the step.
end: A SymbolicConstant specifying the time period to be analyzed in a transient analysis. Possible values are PERIOD and SS. The default value is PERIOD.
deltmx: A Float specifying the maximum temperature change to be allowed in an increment in a transient analysis. The default value is 0.0.
mxdem: A Float specifying the maximum allowable emissivity change with temperature and field variables during an increment. The default value is 0.1.
solutionTechnique: A SymbolicConstant specifying the type of solution technique. Possible values are FULL_NEWTON and SEPARATED. The default value is FULL_NEWTON.
matrixStorage: A SymbolicConstant specifying the type of matrix storage. Possible values are SYMMETRIC, UNSYMMETRIC, and SOLVER_DEFAULT. The default value is SOLVER_DEFAULT.
amplitude: A SymbolicConstant specifying the amplitude variation for loading magnitudes during the step. The default value is STEP. Possible values are STEP and RAMP.
extrapolation: A SymbolicConstant specifying the type of extrapolation to use in determining the incremental solution for a nonlinear analysis. Possible values are NONE, LINEAR, and PARABOLIC. The default value is LINEAR.
maintainAttributes: A Boolean specifying whether to retain attributes from an existing step with the same name. The default value is False.
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.

Returns:

step: CoupledThermalElectricStep: A CoupledThermalElectricStep object.

Notes

This function can be accessed by:

mdb.models[name].CoupledThermalElectricStep

CoupledThermalElectricalStructuralStep(name: str, previous: str, description: str = '', response: SymbolicConstantType = 'TRANSIENT', timePeriod: float = 1, nlgeom: BooleanType = 0, stabilizationMethod: SymbolicConstantType = 'NONE', stabilizationMagnitude: float | None = None, timeIncrementationMethod: SymbolicConstantType = 'AUTOMATIC', maxNumInc: int = 100, initialInc: float | None = None, minInc: float | None = None, maxInc: float | None = None, deltmx: float = 0, cetol: float = 0, creepIntegration: SymbolicConstantType = 'IMPLICIT', matrixStorage: SymbolicConstantType = 'SOLVER_DEFAULT', amplitude: SymbolicConstantType = 'STEP', extrapolation: SymbolicConstantType = 'LINEAR', maintainAttributes: BooleanType = False, convertSDI: SymbolicConstantType = 'PROPAGATED', adaptiveDampingRatio: float = 0, continueDampingFactors: BooleanType = 0) → CoupledThermalElectricalStructuralStep[source]#

This method creates a CoupledThermalElectricalStructuralStep object.

Parameters:

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.
description: A String specifying a description of the new step. The default value is an empty string.
response: A SymbolicConstant specifying the analysis type. Possible values are STEADY_STATE and TRANSIENT. The default value is TRANSIENT.
timePeriod: A Float specifying the total time period for the step. The default value is 1.0.
nlgeom: A Boolean specifying whether geometric nonlinearities should be accounted for during the step. The default value is OFF.
stabilizationMethod: A SymbolicConstant specifying the stabilization type. Possible values are NONE, DISSIPATED_ENERGY_FRACTION, and DAMPING_FACTOR. The default value is NONE.
stabilizationMagnitude: A Float specifying the damping intensity of the automatic damping algorithm if the problem is expected to be unstable and *stabilizationMethod*≠NONE. The default value is 2×10–4.
timeIncrementationMethod: A SymbolicConstant specifying the time incrementation method to be used. Possible values are FIXED and AUTOMATIC. The default value is AUTOMATIC.
maxNumInc: An Int specifying the maximum number of increments in a step. The default value is 100.
initialInc: A Float specifying the initial time increment. The default value is the total time period for the step.
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.
maxInc: A Float specifying the maximum time increment allowed. The default value is the total time period for the step.
deltmx: A Float specifying the maximum temperature change to be allowed in an increment in a transient analysis. The default value is 0.0.
cetol: A Float specifying the maximum difference in the creep strain increment calculated from the creep strain rates at the beginning and end of the increment. The default value is 0.0.
creepIntegration: A SymbolicConstant specifying the type of integration to be used for creep and swelling effects throughout the step. Possible values are IMPLICIT, EXPLICIT, and NONE. The default value is IMPLICIT.
matrixStorage: A SymbolicConstant specifying the type of matrix storage. Possible values are SYMMETRIC, UNSYMMETRIC, and SOLVER_DEFAULT. The default value is SOLVER_DEFAULT.
amplitude: A SymbolicConstant specifying the amplitude variation for loading magnitudes during the step. The default value is STEP. Possible values are STEP and RAMP.
extrapolation: A SymbolicConstant specifying the type of extrapolation to use in determining the incremental solution for a nonlinear analysis. Possible values are NONE, LINEAR, and PARABOLIC. The default value is LINEAR.
maintainAttributes: A Boolean specifying whether to retain attributes from an existing step with the same name. The default value is False.
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.
adaptiveDampingRatio: A Float specifying the maximum allowable ratio of the stabilization energy to the total strain energy and can be used only if stabilizationMethod is not NONE. The default value is 0.05.
continueDampingFactors: A Boolean specifying whether this step will carry over the damping factors from the results of the preceding general step. This parameter must be used in conjunction with the adaptiveDampingRatio parameter. The default value is OFF.

Returns:

step: CoupledThermalElectricalStructuralStep: A CoupledThermalElectricalStructuralStep object.

Notes

This function can be accessed by:

mdb.models[name].CoupledThermalElectricalStructuralStep

DirectCyclicStep(name: str, previous: str, description: str = '', timePeriod: float = 1, timeIncrementationMethod: SymbolicConstantType = 'AUTOMATIC', maxNumInc: int = 100, initialInc: float | None = None, minInc: float | None = None, maxInc: float | None = None, maxNumIterations: int = 200, initialTerms: int = 11, maxTerms: int = 25, termsIncrement: int = 5, deltmx: float = 0, cetol: float = 0, timePoints: str = 'NONE', fatigue: BooleanType = 0, continueAnalysis: BooleanType = 0, minCycleInc: int = 100, maxCycleInc: int = 1000, maxNumCycles: SymbolicConstantType = 'DEFAULT', damageExtrapolationTolerance: float = 1, matrixStorage: SymbolicConstantType = 'SOLVER_DEFAULT', extrapolation: SymbolicConstantType = 'LINEAR', maintainAttributes: BooleanType = False, convertSDI: SymbolicConstantType = 'PROPAGATED') → DirectCyclicStep[source]#

This method creates a DirectCyclicStep object.

Parameters:

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.
description: A String specifying a description of the new step. The default value is an empty string.
timePeriod: A Float specifying the time of single loading cycle. The default value is 1.0.
timeIncrementationMethod: A SymbolicConstant specifying the time incrementation method to be used. Possible values are FIXED and AUTOMATIC. The default value is AUTOMATIC.
maxNumInc: An Int specifying the maximum number of increments in a step. The default value is 100.
initialInc: A Float specifying the initial time increment. The default value is the total time period for the step.
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.
maxInc: A Float specifying the maximum time increment allowed. The default value is the total time period for the step.
maxNumIterations: An Int specifying the maximum number of iterations in a step. The default value is 200.
initialTerms: An Int specifying the initial number of terms in the Fourier series. The default value is 11.
maxTerms: An Int specifying the maximum number of terms in the Fourier series. The default value is 25.
termsIncrement: An Int specifying the increment in number of terms in the Fourier series. The default value is 5.
deltmx: A Float specifying the maximum temperature change to be allowed in an increment. The default value is 0.0.
cetol: A Float specifying the maximum difference in the creep strain increment calculated from the creep strain rates at the beginning and end of the increment. The default value is 0.0.
timePoints: None or a String specifying a String specifying the name of a time point object used to determine at which times the response of the structure will be evaluated. The default value is NONE.
fatigue: A Boolean specifying whether to include low-cycle fatigue analysis. The default value is OFF.
continueAnalysis: A Boolean specifying whether the displacement solution in the Fourier series obtained in the previous direct cyclic step is used as the starting values for the current step. The default value is OFF.
minCycleInc: An Int specifying the minimum number of cycles over which the damage is extrapolated forward. The default value is 100.
maxCycleInc: An Int specifying the maximum number of cycles over which the damage is extrapolated forward. The default value is 1000.
maxNumCycles: The SymbolicConstant DEFAULT or an Int specifying the maximum number of cycles allowed in a step or DEFAULT. A value of 1 plus half of the maximum number of cycles will be used if DEFAULT is specified. The default value is DEFAULT.
damageExtrapolationTolerance: A Float specifying the maximum extrapolated damage increment. The default value is 1.0.
matrixStorage: A SymbolicConstant specifying the type of matrix storage. Possible values are SYMMETRIC, UNSYMMETRIC, and SOLVER_DEFAULT. The default value is SOLVER_DEFAULT.
extrapolation: A SymbolicConstant specifying the type of extrapolation to use in determining the incremental solution for a nonlinear analysis. Possible values are NONE, LINEAR, and PARABOLIC. The default value is LINEAR.
maintainAttributes: A Boolean specifying whether to retain attributes from an existing step with the same name. The default value is False.
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.

Returns:

step: DirectCyclicStep: A DirectCyclicStep object.

Notes

This function can be accessed by:

mdb.models[name].DirectCyclicStep

EmagTimeHarmonicStep(name: str, previous: str, frequencyRange: EmagTimeHarmonicFrequencyArray, description: str = '', factorization: SymbolicConstantType = 'COMPLEX') → EmagTimeHarmonicStep[source]#

This method creates a EmagTimeHarmonicStep object.

Parameters:

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.
frequencyRange: An EmagTimeHarmonicFrequencyArray object.
description: A String specifying a description of the new step. The default value is an empty string.
factorization: A SymbolicConstant specifying whether damping terms are to be ignored so that a real, rather than a complex, system matrix is factored. Possible values are REAL_ONLY and COMPLEX. The default value is COMPLEX.

Returns:

step: EmagTimeHarmonicStep: An EmagTimeHarmonicStep object.

Notes

This function can be accessed by:

mdb.models[name].EmagTimeHarmonicStep

ExplicitDynamicsStep(name: str, previous: str, description: str = '', timePeriod: float = 1, nlgeom: BooleanType = 1, adiabatic: BooleanType = 0, timeIncrementationMethod: SymbolicConstantType = 'AUTOMATIC_GLOBAL', maxIncrement: float | None = None, scaleFactor: float = 1, massScaling: MassScalingArray = 'PREVIOUS_STEP', linearBulkViscosity: float = 0, quadBulkViscosity: float = 1, userDefinedInc: float | None = None, maintainAttributes: BooleanType = False, improvedDtMethod: BooleanType = 1) → ExplicitDynamicsStep[source]#

This method creates an ExplicitDynamicsStep object.

Parameters:

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.
description: A String specifying a description of the new step. The default value is an empty string.
timePeriod: A Float specifying the total time period for the step. The default value is 1.0.
nlgeom: A Boolean specifying whether geometric nonlinearities should be accounted for during the step. The default value is ON.
adiabatic: A Boolean specifying that an adiabatic stress analysis is to be performed. The default value is OFF.
timeIncrementationMethod: A SymbolicConstant specifying the time incrementation method to be used. Possible values are AUTOMATIC_GLOBAL, AUTOMATIC_EBE, FIXED_USER_DEFINED_INC, and FIXED_EBE. The default value is AUTOMATIC_GLOBAL.
maxIncrement: None or a Float specifying the maximum time increment. If there is no upper limit, *maxIncrement*=None. This argument is required only when *timeIncrementationMethod*=AUTOMATIC_GLOBAL or AUTOMATIC_EBE. The default value is None.
scaleFactor: A Float specifying the factor that is used to scale the time increment. This argument is required only when *timeIncrementationMethod*=AUTOMATIC_GLOBAL, AUTOMATIC_EBE, or FIXED_EBE. The default value is 1.0.
massScaling: A MassScalingArray object specifying mass scaling controls. The default value is PREVIOUS_STEP.
linearBulkViscosity: A Float specifying the linear bulk viscosity parameter, b1b1. The default value is 0.06.
quadBulkViscosity: A Float specifying the quadratic bulk viscosity parameter, b2b2. The default value is 1.2.
userDefinedInc: None or a Float specifying the user-defined time increment. This argument is required only when *timeIncrementationMethod*=FIXED_USER_DEFINED_INC. The default value is None.
maintainAttributes: A Boolean specifying whether to retain attributes from an existing step with the same name. The default value is False.
improvedDtMethod: A Boolean specifying whether to use the “improved” (*improvedDtMethod*=ON) or “conservative” (*improvedDtMethod*=OFF) method to estimate the element stable time increment for three-dimensional continuum elements and elements with plane stress formulations (shell, membrane, and two-dimensional plane stress elements). The default value is ON.

Returns:

step: ExplicitDynamicsStep: An ExplicitDynamicsStep object.

Notes

This function can be accessed by:

mdb.models[name].ExplicitDynamicsStep

FrequencyStep(name: str, previous: str, eigensolver: SymbolicConstantType, numEigen: SymbolicConstantType = 'ALL', description: str = '', shift: float = 0, minEigen: float | None = None, maxEigen: float | None = None, vectors: int | None = None, maxIterations: int = 30, blockSize: SymbolicConstantType = 'DEFAULT', maxBlocks: SymbolicConstantType = 'DEFAULT', normalization: SymbolicConstantType = 'DISPLACEMENT', propertyEvaluationFrequency: float | None = None, projectDamping: BooleanType = 1, acousticCoupling: SymbolicConstantType = 'AC_ON', acousticRangeFactor: float = 1, frictionDamping: BooleanType = 0, matrixStorage: SymbolicConstantType = 'SOLVER_DEFAULT', maintainAttributes: BooleanType = False, simLinearDynamics: BooleanType = 0, residualModes: BooleanType = 0, substructureCutoffMultiplier: float = 5, firstCutoffMultiplier: float = 1, secondCutoffMultiplier: float = 1, residualModeRegion: str | None = None, residualModeDof: str | None = None, limitSavedEigenvectorRegion: SymbolicConstantType | None = None) → FrequencyStep[source]#

This method creates a FrequencyStep object.

Parameters:

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.
eigensolver: A SymbolicConstant specifying the eigensolver. Possible values are LANCZOS, SUBSPACE, and AMS.The following optional arguments are ignored unless eigensolver*=LANCZOS: *blockSize, maxBlocks, normalization, propertyEvaluationFrequency.The following optional arguments are ignored unless eigensolver*=LANCZOS or AMS: *minEigen, maxEigen, and acousticCoupling.The following optional arguments are ignored unless eigensolver*=AMS: *projectDamping, acousticRangeFactor, substructureCutoffMultiplier, firstCutoffMultiplier, secondCutoffMultiplier, residualModeRegion, regionalModeDof, and limitSavedEigenvectorRegion.
numEigen: The SymbolicConstant ALL or an Int specifying the number of eigenvalues to be calculated or ALL. The default value is ALL.
description: A String specifying a description of the new step. The default value is an empty string.
shift: A Float specifying the shift point in cycles per time. The default value is 0.0.
minEigen: None or a Float specifying the minimum frequency of interest in cycles per time. The default value is None.
maxEigen: None or a Float specifying the maximum frequency of interest in cycles per time. The default value is None.
vectors: None or an Int specifying the number of vectors used in the iteration. The default is the minimum of (2*n*, n + 8), where n is the number of eigenvalues requested. The default value is None.
maxIterations: An Int specifying the maximum number of iterations. The default value is 30.
blockSize: A SymbolicConstant specifying the size of the Lanczos block steps. The default value is DEFAULT.
maxBlocks: A SymbolicConstant specifying the maximum number of Lanczos block steps within each Lanczos run. The default value is DEFAULT.
normalization: A SymbolicConstant specifying the method for normalizing eigenvectors. Possible values are DISPLACEMENT and MASS. The default value is DISPLACEMENT.A value of DISPLACEMENT indicates normalizing the eigenvectors so that the largest displacement entry in each vector is unity. A value of MASS indicates normalizing the eigenvectors with respect to the structure’s mass matrix, which results in scaling the eigenvectors so that the generalized mass for each vector is unity.
propertyEvaluationFrequency: None or a Float specifying the frequency at which to evaluate frequency-dependent properties for viscoelasticity, springs, and dashpots during the eigenvalue extraction. If the value is None, the analysis product will evaluate the stiffness associated with frequency-dependent springs and dashpots at zero frequency and will not consider the stiffness contributions from frequency-domain viscoelasticity in the step. The default value is None.
projectDamping: A Boolean specifying whether to include projection of viscous and structural damping operators during AMS eigenvalue extraction. Valid only when *eigenSolver*=AMS. The default value is ON.
acousticCoupling: A SymbolicConstant specifying the type of acoustic-structural coupling in models with acoustic and structural elements coupled using the TIE option or in models with ASI-type elements. Possible values are AC_ON, AC_OFF, and AC_PROJECTION. The default value is AC_ON.
acousticRangeFactor: A Float specifying the ratio of the maximum acoustic frequency to the maximum structural frequency. The default value is 1.0.
frictionDamping: A Boolean specifying whether to add to the damping matrix contributions due to friction effects. The default value is OFF.
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.
simLinearDynamics: A Boolean specifying whether to activate the SIM-based linear dynamics procedures. The default value is OFF.
residualModes: A Boolean specifying whether to include residual modes from an immediately preceding Static, Linear Perturbation step. The default value is OFF.
substructureCutoffMultiplier: A Float specifying the cutoff frequency for substructure eigenproblems, defined as a multiplier of the maximum frequency of interest. The default value is 5.0.
firstCutoffMultiplier: A Float specifying the first cutoff frequency for a reduced eigenproblem, defined as a multiplier of the maximum frequency of interest. The default value is 1.7.
secondCutoffMultiplier: A Float specifying the second cutoff frequency for a reduced eigenproblem defined as a multiplier of the maximum frequency of interest. The default value is 1.1.
residualModeRegion: None or a sequence of Strings specifying the name of a region for which residual modes are requested. The default value is None.
residualModeDof: None or a sequence of Ints specifying the degree of freedom for which residual modes are requested. The default value is None.
limitSavedEigenvectorRegion: None or a Region object specifying a region for which eigenvectors should be saved or the SymbolicConstant None representing the whole model. The default value is None.

Returns:

step: FrequencyStep: A FrequencyStep object.

Notes

This function can be accessed by:

mdb.models[name].FrequencyStep

GeostaticStep(name: str, previous: str, description: str = '', nlgeom: BooleanType = 0, matrixSolver: SymbolicConstantType = 'DIRECT', matrixStorage: SymbolicConstantType = 'SOLVER_DEFAULT', maintainAttributes: BooleanType = False, solutionTechnique: SymbolicConstantType = 'FULL_NEWTON', reformKernel: int = 8, convertSDI: SymbolicConstantType = 'PROPAGATED', utol: float | None = None, timePeriod: float = 1, timeIncrementationMethod: SymbolicConstantType = 'AUTOMATIC', maxNumInc: int = 100, initialInc: float | None = None, minInc: float | None = None, maxInc: float | None = None) → GeostaticStep[source]#

This method creates a GeostaticStep object.

Parameters:

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.
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.
maxNumInc: An Int specifying the maximum number of increments in a step. The default value is 100.
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.

Returns:

step: GeostaticStep: A GeostaticStep object.

Notes

This function can be accessed by:

mdb.models[name].GeostaticStep

HeatTransferStep(name: str, previous: str, description: str = '', response: SymbolicConstantType = 'TRANSIENT', timePeriod: float = 1, timeIncrementationMethod: SymbolicConstantType = 'AUTOMATIC', maxNumInc: int = 100, initialInc: float | None = None, minInc: float | None = None, maxInc: float | None = None, end: float | None = None, deltmx: float = 0, mxdem: float = 0, amplitude: SymbolicConstantType = 'STEP', extrapolation: SymbolicConstantType = 'LINEAR', matrixSolver: SymbolicConstantType = 'DIRECT', matrixStorage: SymbolicConstantType = 'SOLVER_DEFAULT', maintainAttributes: BooleanType = False, solutionTechnique: SymbolicConstantType = 'FULL_NEWTON', reformKernel: int = 8, convertSDI: SymbolicConstantType = 'PROPAGATED') → HeatTransferStep[source]#

This method creates a HeatTransferStep object.

Parameters:

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.
description: A String specifying a description of the new step. The default value is an empty string.
response: A SymbolicConstant specifying the analysis type. Possible values are STEADY_STATE and TRANSIENT. The default value is TRANSIENT.
timePeriod: A Float specifying the total time period. The default value is 1.0.
timeIncrementationMethod: A SymbolicConstant specifying the time incrementation method to be used. Possible values are FIXED and AUTOMATIC. The default value is AUTOMATIC.
maxNumInc: An Int specifying the maximum number of increments in a step. The default value is 100.
initialInc: A Float specifying the initial time increment. The default value is the total time period for the step.
minInc: A Float specifying the minimum time increment allowed. The default value is the smaller of 0.8 times the initial time increment or 10−5 times the total time period.
maxInc: A Float specifying the maximum time increment allowed. The default value is the total time period for the step.
end: None or a Float specifying the temperature change rate (temperature per time) used to define steady state. When all nodal temperatures are changing at less than this rate, the solution terminates. The default value is None.Note:This parameter is ignored unless *response*=STEADY_STATE.
deltmx: A Float specifying the maximum temperature change to be allowed in an increment during a transient heat transfer analysis. The default value is 0.0.
mxdem: A Float specifying the maximum allowable emissivity change with temperature and field variables during an increment. The default value is 0.1.
amplitude: A SymbolicConstant specifying the amplitude variation for loading magnitudes during the step. The default is STEP. Possible values are STEP and RAMP.
extrapolation: A SymbolicConstant specifying the type of extrapolation to use in determining the incremental solution for a nonlinear analysis. Possible values are NONE, LINEAR, and PARABOLIC. The default value is LINEAR.
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.

Returns:

step: HeatTransferStep: A HeatTransferStep object.

Notes

This function can be accessed by:

mdb.models[name].HeatTransferStep

ImplicitDynamicsStep(name: str, previous: str, description: str = '', timePeriod: float = 1, nlgeom: BooleanType = 0, matrixStorage: SymbolicConstantType = 'SOLVER_DEFAULT', application: SymbolicConstantType = 'ANALYSIS_PRODUCT_DEFAULT', adiabatic: BooleanType = 0, timeIncrementationMethod: SymbolicConstantType = 'AUTOMATIC', maxNumInc: int = 100, initialInc: float | None = None, minInc: float | None = None, maxInc: SymbolicConstantType | float = 'DEFAULT', hafTolMethod: SymbolicConstantType = 'VALUE', haftol: float | None = None, halfIncScaleFactor: float | None = None, nohaf: BooleanType = 0, amplitude: SymbolicConstantType = 'STEP', alpha: SymbolicConstantType | float = 'DEFAULT', initialConditions: SymbolicConstantType = 'DEFAULT', extrapolation: SymbolicConstantType = 'ANALYSIS_PRODUCT_DEFAULT', noStop: BooleanType = 0, maintainAttributes: BooleanType = False, solutionTechnique: SymbolicConstantType = 'FULL_NEWTON', reformKernel: int = 8, convertSDI: SymbolicConstantType = 'PROPAGATED') → ImplicitDynamicsStep[source]#

This method creates an ImplicitDynamicsStep object.

Parameters:

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.
description: A String specifying a description of the new step. The default value is an empty string.
timePeriod: A Float specifying the total time period of the step. The default value is 1.0.
nlgeom: A Boolean specifying whether geometric nonlinearities should be accounted for during the step. The default value is based on the previous step.
matrixStorage: A SymbolicConstant specifying the type of matrix storage. Possible values are SYMMETRIC, UNSYMMETRIC, and SOLVER_DEFAULT. The default value is SOLVER_DEFAULT.
application: A SymbolicConstant specifying the application type of the step. Possible values are ANALYSIS_PRODUCT_DEFAULT, TRANSIENT_FIDELITY, MODERATE_DISSIPATION, and QUASI_STATIC. The default value is ANALYSIS_PRODUCT_DEFAULT.
adiabatic: A Boolean specifying whether an adiabatic stress analysis is to be performed. The default value is OFF.
timeIncrementationMethod: A SymbolicConstant specifying the time incrementation method to be used. Possible values are FIXED and AUTOMATIC. The default value is AUTOMATIC.
maxNumInc: An Int specifying the maximum number of increments in a step. The default value is 100.
initialInc: A Float specifying the initial time increment. The default value is the total time period for the step.
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.
maxInc: The SymbolicConstant DEFAULT or a Float specifying the maximum time increment allowed.
hafTolMethod: A SymbolicConstant specifying the way of specifying half-increment residual tolerance with the automatic time incrementation scheme. Possible values are ANALYSIS_PRODUCT_DEFAULT, VALUE, and SCALE. The default value is VALUE.
haftol: None or a Float specifying the half-increment residual tolerance to be used with the automatic time incrementation scheme. The default value is None.
halfIncScaleFactor: None or a Float specifying the half-increment residual tolerance scale factor to be used with the automatic time incrementation scheme. The default value is None.
nohaf: A Boolean specifying whether to suppress calculation of the half-increment residual. The default value is OFF.
amplitude: A SymbolicConstant specifying the amplitude variation for loading magnitudes during the step. Possible values are STEP and RAMP. The default value is STEP.
alpha: The SymbolicConstant DEFAULT or a Float specifying the nondefault value of the numerical (artificial) damping control parameter, αα, in the implicit operator. Possible values are −.333 <α<<α< 0. The default value is DEFAULT.
initialConditions: A SymbolicConstant specifying whether accelerations should be calculated or recalculated at the beginning of the step. Possible values are DEFAULT, BYPASS, and ALLOW. The default value is DEFAULT.
extrapolation: A SymbolicConstant specifying the type of extrapolation to use in determining the incremental solution for a nonlinear analysis. Possible values are NONE, LINEAR, PARABOLIC, VELOCITY_PARABOLIC, and ANALYSIS_PRODUCT_DEFAULT. The default value is ANALYSIS_PRODUCT_DEFAULT.
noStop: A Boolean specifying whether to accept the solution to an increment after the maximum number of iterations allowed have been completed, even if the equilibrium tolerances are not satisfied. The default value is OFF.Warning:You should set *noStop*=OFF only in special cases when you have a thorough understanding of how to interpret the results.
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.

Returns:

step: ImplicitDynamicsStep: An ImplicitDynamicsStep object.

Notes

This function can be accessed by:

mdb.models[name].ImplicitDynamicsStep

MassDiffusionStep(name: str, previous: str, description: str = '', response: SymbolicConstantType = 'TRANSIENT', timePeriod: float = 1, timeIncrementationMethod: SymbolicConstantType = 'AUTOMATIC', maxNumInc: int = 100, initialInc: float | None = None, minInc: float | None = None, maxInc: float | None = None, end: SymbolicConstantType = 'PERIOD', dcmax: float = 0, amplitude: SymbolicConstantType = 'STEP', extrapolation: SymbolicConstantType = 'LINEAR', maintainAttributes: BooleanType = False, convertSDI: SymbolicConstantType = 'PROPAGATED') → MassDiffusionStep[source]#

This method creates a MassDiffusionStep object.

Parameters:

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.
description: A String specifying a description of the new step. The default value is an empty string.
response: A SymbolicConstant specifying the analysis type. Possible values are STEADY_STATE and TRANSIENT. The default value is TRANSIENT.
timePeriod: A Float specifying the total time period. The default value is 1.0.
timeIncrementationMethod: A SymbolicConstant specifying the time incrementation method to be used. Possible values are FIXED and AUTOMATIC. The default value is AUTOMATIC.
maxNumInc: An Int specifying the maximum number of increments in a step. The default value is 100.
initialInc: A Float specifying the initial time increment. The default value is the total time period for the step.
minInc: A Float specifying the minimum time increment allowed. The default value is the smaller of 0.8 times the initial time increment or 10−5 times the total time period.
maxInc: A Float specifying the maximum time increment allowed. The default value is the total time period for the step.
end: A SymbolicConstant specifying the time period to be analyzed in a transient analysis. Possible values are PERIOD and SS. The default value is PERIOD.
dcmax: A Float specifying the maximum normalized concentration change to be allowed in an increment. The default value is 0.0.
amplitude: A SymbolicConstant specifying the amplitude variation for loading magnitudes during the step. The default is STEP. Possible values are STEP and RAMP.
extrapolation: A SymbolicConstant specifying the type of extrapolation to use in determining the incremental solution for a nonlinear analysis. Possible values are NONE, LINEAR, and PARABOLIC. The default value is LINEAR.
maintainAttributes: A Boolean specifying whether to retain attributes from an existing step with the same name. The default value is False.
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.

Returns:

step: MassDiffusionStep: A MassDiffusionStep object.

Notes

This function can be accessed by:

mdb.models[name].MassDiffusionStep

ModalDynamicsStep(name: str, previous: str, description: str = '', continueAnalysis: ~abaqusConstants.BooleanType = 0, timePeriod: float = 1, incSize: float = 1, directDamping: ~abaqus.StepMiscellaneous.DirectDamping.DirectDamping = <abaqus.StepMiscellaneous.DirectDamping.DirectDamping object>, compositeDamping: ~abaqus.StepMiscellaneous.CompositeDamping.CompositeDamping = <abaqus.StepMiscellaneous.CompositeDamping.CompositeDamping object>, rayleighDamping: ~abaqus.StepMiscellaneous.RayleighDamping.RayleighDamping = <abaqus.StepMiscellaneous.RayleighDamping.RayleighDamping object>, amplitude: ~abaqusConstants.SymbolicConstantType = 'STEP', maintainAttributes: ~abaqusConstants.BooleanType = False, directDampingByFrequency: ~abaqus.StepMiscellaneous.DirectDampingByFrequency.DirectDampingByFrequency = <abaqus.StepMiscellaneous.DirectDampingByFrequency.DirectDampingByFrequency object>, rayleighDampingByFrequency: ~abaqus.StepMiscellaneous.RayleighDampingByFrequency.RayleighDampingByFrequency = <abaqus.StepMiscellaneous.RayleighDampingByFrequency.RayleighDampingByFrequency object>) → ModalDynamicsStep[source]#

This method creates a ModalDynamicsStep object.

Parameters:

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.
description: A String specifying a description of the new step. The default value is an empty string.
continueAnalysis: A Boolean specifying that the step starts with zero initial conditions. The default value is OFF.
timePeriod: A Float specifying the total time period. The default value is 1.0.
incSize: A Float specifying the time increment to be used. The default value is 1.0.
directDamping: A DirectDamping object.
compositeDamping: A CompositeDamping object.
rayleighDamping: A RayleighDamping object.
amplitude: A SymbolicConstant specifying the amplitude variation for loading magnitudes during the step. Possible values are STEP and RAMP. The default value is STEP.
maintainAttributes: A Boolean specifying whether to retain attributes from an existing step with the same name. The default value is False.
directDampingByFrequency: A DirectDampingByFrequency object.
rayleighDampingByFrequency: A RayleighDampingByFrequency object.

Returns:

step: ModalDynamicsStep: A ModalDynamicsStep object.

Notes

This function can be accessed by:

mdb.models[name].ModalDynamicsStep

RandomResponseStep(name: str, previous: str, freq: ~abaqus.StepMiscellaneous.RandomResponseFrequencyArray.RandomResponseFrequencyArray, description: str = '', scale: ~abaqusConstants.SymbolicConstantType = 'LOG', directDamping: ~abaqus.StepMiscellaneous.DirectDamping.DirectDamping = <abaqus.StepMiscellaneous.DirectDamping.DirectDamping object>, compositeDamping: ~abaqus.StepMiscellaneous.CompositeDamping.CompositeDamping = <abaqus.StepMiscellaneous.CompositeDamping.CompositeDamping object>, rayleighDamping: ~abaqus.StepMiscellaneous.RayleighDamping.RayleighDamping = <abaqus.StepMiscellaneous.RayleighDamping.RayleighDamping object>, structuralDamping: ~abaqus.StepMiscellaneous.StructuralDamping.StructuralDamping = <abaqus.StepMiscellaneous.StructuralDamping.StructuralDamping object>, directDampingByFrequency: ~abaqus.StepMiscellaneous.DirectDampingByFrequency.DirectDampingByFrequency = <abaqus.StepMiscellaneous.DirectDampingByFrequency.DirectDampingByFrequency object>, rayleighDampingByFrequency: ~abaqus.StepMiscellaneous.RayleighDampingByFrequency.RayleighDampingByFrequency = <abaqus.StepMiscellaneous.RayleighDampingByFrequency.RayleighDampingByFrequency object>, structuralDampingByFrequency: ~abaqus.StepMiscellaneous.StructuralDampingByFrequency.StructuralDampingByFrequency = <abaqus.StepMiscellaneous.StructuralDampingByFrequency.StructuralDampingByFrequency object>, maintainAttributes: ~abaqusConstants.BooleanType = False) → RandomResponseStep[source]#

This method creates a RandomResponseStep object.

Parameters:

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.
freq: A RandomResponseFrequencyArray object specifying frequencies over ranges of modes.
description: A String specifying a description of the new step. The default value is an empty string.
scale: A SymbolicConstant specifying the frequency scale. Possible values are LINEAR and LOG. The default value is LOG.
directDamping: A DirectDamping object.
compositeDamping: A CompositeDamping object.
rayleighDamping: A RayleighDamping object.
structuralDamping: A StructuralDamping object.
directDampingByFrequency: A DirectDampingByFrequency object.
rayleighDampingByFrequency: A RayleighDampingByFrequency object.
structuralDampingByFrequency: A StructuralDampingByFrequency object.
maintainAttributes: A Boolean specifying whether to retain attributes from an existing step with the same name. The default value is False.

Returns:

step: RandomResponseStep: A RandomResponseStep object.

Notes

This function can be accessed by:

mdb.models[name].RandomResponseStep

ResponseSpectrumStep(name: str, previous: str, components: ~abaqus.StepMiscellaneous.ResponseSpectrumComponentArray.ResponseSpectrumComponentArray, description: str = '', comp: ~abaqusConstants.SymbolicConstantType = 'SINGLE_DIRECTION', sum: ~abaqusConstants.SymbolicConstantType = 'ABS', directDamping: ~abaqus.StepMiscellaneous.DirectDamping.DirectDamping = <abaqus.StepMiscellaneous.DirectDamping.DirectDamping object>, compositeDamping: ~abaqus.StepMiscellaneous.CompositeDamping.CompositeDamping = <abaqus.StepMiscellaneous.CompositeDamping.CompositeDamping object>, rayleighDamping: ~abaqus.StepMiscellaneous.RayleighDamping.RayleighDamping = <abaqus.StepMiscellaneous.RayleighDamping.RayleighDamping object>, directDampingByFrequency: ~abaqus.StepMiscellaneous.DirectDampingByFrequency.DirectDampingByFrequency = <abaqus.StepMiscellaneous.DirectDampingByFrequency.DirectDampingByFrequency object>, rayleighDampingByFrequency: ~abaqus.StepMiscellaneous.RayleighDampingByFrequency.RayleighDampingByFrequency = <abaqus.StepMiscellaneous.RayleighDampingByFrequency.RayleighDampingByFrequency object>, maintainAttributes: ~abaqusConstants.BooleanType = False) → ResponseSpectrumStep[source]#

This method creates a ResponseSpectrumStep object.

Parameters:

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.
components: A ResponseSpectrumComponentArray object.
description: A String specifying a description of the new step. The default value is an empty string.
comp: A SymbolicConstant specifying the order and method used to sum the components. Possible values are SINGLE_DIRECTION, MULTIPLE_DIRECTION_ABSOLUTE_SUM, MULTIPLE_DIRECTION_SRSS_SUM, MULTIPLE_DIRECTION_THIRTY_PERCENT_RULE, and MULTIPLE_DIRECTION_FORTY_PERCENT_RULE. The default value is SINGLE_DIRECTION.
sum: A SymbolicConstant specifying the method used to sum the components. Possible values are ABS, CQC, NRL, SRSS, TENP, DSC, and GRP. The default value is ABS.
directDamping: A DirectDamping object.
compositeDamping: A CompositeDamping object.
rayleighDamping: A RayleighDamping object.
directDampingByFrequency: A DirectDampingByFrequency object.
rayleighDampingByFrequency: A RayleighDampingByFrequency object.
maintainAttributes: A Boolean specifying whether to retain attributes from an existing step with the same name. The default value is False.

Returns:

step: ResponseSpectrumStep: A ResponseSpectrumStep object.

Notes

This function can be accessed by:

mdb.models[name].ResponseSpectrumStep

SoilsStep(name: str, previous: str, description: str = '', response: SymbolicConstantType = 'TRANSIENT', timePeriod: float = 1, nlgeom: BooleanType = 0, stabilizationMethod: SymbolicConstantType = 'NONE', stabilizationMagnitude: float | None = None, creep: BooleanType = 1, timeIncrementationMethod: SymbolicConstantType = 'AUTOMATIC', initialInc: float | None = None, minInc: float | None = None, maxInc: float | None = None, maxNumInc: int = 100, end: SymbolicConstantType = 'PERIOD', utol: float | None = None, cetol: float = 0, amplitude: SymbolicConstantType = 'STEP', extrapolation: SymbolicConstantType = 'LINEAR', matrixSolver: SymbolicConstantType = 'DIRECT', matrixStorage: SymbolicConstantType = 'SOLVER_DEFAULT', maintainAttributes: BooleanType = False, solutionTechnique: SymbolicConstantType = 'FULL_NEWTON', reformKernel: int = 8, convertSDI: SymbolicConstantType = 'PROPAGATED', adaptiveDampingRatio: float = 0, continueDampingFactors: BooleanType = 0) → SoilsStep[source]#

This method creates a SoilsStep object.

Parameters:

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.
description: A String specifying a description of the new step. The default value is an empty string.
response: A SymbolicConstant specifying the analysis type. Possible values are STEADY_STATE and TRANSIENT. The default value is TRANSIENT.
timePeriod: A Float specifying the total time period. The default value is 1.0.
nlgeom: A Boolean specifying whether geometric nonlinearities should be accounted for during the step. The default value is OFF.
stabilizationMethod: A SymbolicConstant specifying the stabilization type. Possible values are NONE, DISSIPATED_ENERGY_FRACTION, and DAMPING_FACTOR. The default value is NONE.
stabilizationMagnitude: A Float specifying the damping intensity of the automatic damping algorithm if the problem is expected to be unstable, and stabilizationMethod is not NONE. The default value is 2×10–4.
creep: A Boolean specifying whether a creep response occurs during this step. The default value is ON.
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.
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.
maxInc: A Float specifying the maximum time increment allowed. The default value is the total time period for the step.
maxNumInc: An Int specifying the maximum number of increments in a step. The default value is 100.
end: A SymbolicConstant specifying the time period to be analyzed in a transient analysis. Possible values are PERIOD and SS. The default value is PERIOD.
utol: None or a Float specifying the maximum pore pressure change permitted in any increment (in pressure units) in a transient consolidation analysis. The default value is None.
cetol: A Float specifying the maximum allowable difference in the creep strain increment calculated from the creep strain rates at the beginning and end of the increment. The default value is 0.0.
amplitude: A SymbolicConstant specifying the amplitude variation for loading magnitudes during the step. The default value is STEP. Possible values are STEP and RAMP.
extrapolation: A SymbolicConstant specifying the type of extrapolation to use in determining the incremental solution for a nonlinear analysis. Possible values are NONE, LINEAR, and PARABOLIC. The default value is LINEAR.
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.
adaptiveDampingRatio: A Float specifying the maximum allowable ratio of the stabilization energy to the total strain energy and can be used only if stabilizationMethod is not NONE. The default value is 0.05.
continueDampingFactors: A Boolean specifying whether this step will carry over the damping factors from the results of the preceding general step. This parameter must be used in conjunction with the adaptiveDampingRatio parameter. The default value is OFF.

Returns:

step: SoilsStep: A SoilsStep object.

Notes

This function can be accessed by:

mdb.models[name].SoilsStep

StaticLinearPerturbationStep(name: str, previous: str, description: str = '', matrixSolver: SymbolicConstantType = 'DIRECT', matrixStorage: SymbolicConstantType = 'SOLVER_DEFAULT', maintainAttributes: BooleanType = False) → StaticLinearPerturbationStep[source]#

This method creates a StaticLinearPerturbationStep object.

Parameters:

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.
description: A String specifying a description of the new step. The default value is an empty string.
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.

Returns:

step: StaticLinearPerturbationStep: A StaticLinearPerturbationStep object.

Notes

This function can be accessed by:

mdb.models[name].StaticLinearPerturbationStep

StaticRiksStep(name: str, previous: str, description: str = '', nlgeom: ~abaqusConstants.BooleanType = 0, adiabatic: ~abaqusConstants.BooleanType = 0, maxLPF: float | None = None, nodeOn: ~abaqusConstants.BooleanType = 0, maximumDisplacement: float = 0, dof: int = 0, region: ~abaqus.Region.Region.Region = <abaqus.Region.Region.Region object>, timeIncrementationMethod: ~abaqusConstants.SymbolicConstantType = 'AUTOMATIC', maxNumInc: int = 100, totalArcLength: float = 1, initialArcInc: float | None = None, minArcInc: float | None = None, maxArcInc: float | None = None, matrixStorage: ~abaqusConstants.SymbolicConstantType = 'SOLVER_DEFAULT', extrapolation: ~abaqusConstants.SymbolicConstantType = 'LINEAR', fullyPlastic: str = '', noStop: ~abaqusConstants.BooleanType = 0, maintainAttributes: ~abaqusConstants.BooleanType = False, useLongTermSolution: ~abaqusConstants.BooleanType = 0, convertSDI: ~abaqusConstants.SymbolicConstantType = 'PROPAGATED') → StaticRiksStep[source]#

This method creates a StaticRiksStep object.

Parameters:

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.
description: A String specifying a description of the new step. The default value is an empty string.
nlgeom: A Boolean specifying whether to allow for geometric nonlinearity. The default value is OFF.
adiabatic: A Boolean specifying whether to perform an adiabatic stress analysis. The default value is OFF.
maxLPF: None or a Float specifying the maximum value of the load proportionality factor. The default value is None.
nodeOn: A Boolean specifying whether to monitor the finishing displacement value at a node. The default value is OFF.
maximumDisplacement: A Float specifying the value of the total displacement (or rotation) at the node and degree of freedom that, if crossed during an increment, ends the step at the current increment. This argument is required when *nodeOn*=ON. The default value is 0.0.
dof: An Int specifying the degree of freedom being monitored. This argument is required when *nodeOn*=ON. The default value is 0.
region: A Region object specifying the vertex at which the finishing displacement value is being monitored. This argument is required when *nodeOn*=ON.
timeIncrementationMethod: A SymbolicConstant specifying the time incrementation method to be used. Possible values are FIXED and AUTOMATIC. The default value is AUTOMATIC.
maxNumInc: An Int specifying the maximum number of increments in a step. The default value is 100.
totalArcLength: A Float specifying the total load proportionality factor associated with the load in this step. The default value is 1.0.
initialArcInc: A Float specifying the initial load proportionality factor. The default value is the total load proportionality factor for the step.
minArcInc: A Float specifying the minimum arc length increment allowed. The default value is the smaller of the suggested initial load proportionality factor or 10−5 times the total load proportionality factor for the step.
maxArcInc: A Float specifying the maximum arc length increment allowed. The default value is the total load proportionality factor for the step.
matrixStorage: A SymbolicConstant specifying the type of matrix storage. Possible values are SYMMETRIC, UNSYMMETRIC, and SOLVER_DEFAULT. The default value is SOLVER_DEFAULT.
extrapolation: A SymbolicConstant specifying the type of extrapolation to use in determining the incremental solution for a nonlinear analysis. Possible values are NONE, LINEAR, and PARABOLIC. The default value is LINEAR.
fullyPlastic: A String specifying the name of the region being monitored for fully Plastic behavior. The default value is an empty string.
noStop: A Boolean specifying whether to accept the solution to an increment after the maximum number of iterations allowed have been completed, even if the equilibrium tolerances are not satisfied. The default value is OFF.Warning:You should set *noStop*=ON only in special cases when you have a thorough understanding of how to interpret the results.
maintainAttributes: A Boolean specifying whether to retain attributes from an existing step with the same name. The default value is False.
useLongTermSolution: A Boolean specifying wether to obtain the fully relaxed long-term elastic solution with time-domain viscoelasticity or the long-term elastic-Plastic solution for two-layer viscoplasticity. The default value is OFF.
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.

Returns:

step: StaticRiksStep: A StaticRiksStep object.

Notes

This function can be accessed by:

mdb.models[name].StaticRiksStep

StaticStep(name: str, previous: str, description: str = '', timePeriod: float = 1, nlgeom: BooleanType = 0, stabilizationMethod: SymbolicConstantType = 'NONE', stabilizationMagnitude: float | None = None, adiabatic: BooleanType = 0, timeIncrementationMethod: SymbolicConstantType = 'AUTOMATIC', maxNumInc: int = 100, initialInc: float | None = None, minInc: float | None = None, maxInc: float | None = None, matrixSolver: SymbolicConstantType = 'DIRECT', matrixStorage: SymbolicConstantType = 'SOLVER_DEFAULT', amplitude: SymbolicConstantType = 'RAMP', extrapolation: SymbolicConstantType = 'LINEAR', fullyPlastic: str = '', noStop: BooleanType = 0, maintainAttributes: BooleanType = False, useLongTermSolution: BooleanType = 0, solutionTechnique: SymbolicConstantType = 'FULL_NEWTON', reformKernel: int = 8, convertSDI: SymbolicConstantType = 'PROPAGATED', adaptiveDampingRatio: float = 0, continueDampingFactors: BooleanType = 0) → StaticStep[source]#

This method creates a StaticStep object.

Parameters:

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.
description: A String specifying a description of the new step. The default value is an empty string.
timePeriod: A Float specifying the total time period. The default value is 1.0.
nlgeom: A Boolean specifying whether to allow for geometric nonlinearity. The default value is OFF.
stabilizationMethod: A SymbolicConstant specifying the stabilization type. Possible values are NONE, DISSIPATED_ENERGY_FRACTION, and DAMPING_FACTOR. The default value is NONE.
stabilizationMagnitude: A Float specifying the damping intensity of the automatic damping algorithm if the problem is expected to be unstable, and stabilizationMethod is not NONE. The default value is 2×10–4.
adiabatic: A Boolean specifying whether to perform an adiabatic stress analysis. The default value is OFF.
timeIncrementationMethod: A SymbolicConstant specifying the time incrementation method to be used. Possible values are FIXED and AUTOMATIC. The default value is AUTOMATIC.
maxNumInc: An Int specifying the maximum number of increments in a step. The default value is 100.
initialInc: A Float specifying the initial time increment. The default value is the total time period for the step.
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.
maxInc: A Float specifying the maximum time increment allowed. The default value is the total time period for the step.
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.
amplitude: A SymbolicConstant specifying the amplitude variation for loading magnitudes during the step. Possible values are STEP and RAMP. The default value is RAMP.
extrapolation: A SymbolicConstant specifying the type of extrapolation to use in determining the incremental solution for a nonlinear analysis. Possible values are NONE, LINEAR, and PARABOLIC. The default value is LINEAR.
fullyPlastic: A String specifying the region being monitored for fully Plastic behavior. The default value is an empty string.
noStop: A Boolean specifying whether to accept the solution to an increment after the maximum number of iterations allowed has been completed, even if the equilibrium tolerances are not satisfied. The default value is OFF.Warning:You should set *noStop*=ON only in special cases when you have a thorough understanding of how to interpret the results.
maintainAttributes: A Boolean specifying whether to retain attributes from an existing step with the same name. The default value is False.
useLongTermSolution: A Boolean specifying wether to obtain the fully relaxed long-term elastic solution with time-domain viscoelasticity or the long-term elastic-Plastic solution for two-layer viscoplasticity. The default value is OFF.
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.
adaptiveDampingRatio: A Float specifying the maximum allowable ratio of the stabilization energy to the total strain energy and can be used only if stabilizationMethod is not NONE. The default value is 0.05.
continueDampingFactors: A Boolean specifying whether this step will carry over the damping factors from the results of the preceding general step. This parameter must be used in conjunction with the adaptiveDampingRatio parameter. The default value is OFF.

Returns:

step: StaticRiksStep: A StaticRiksStep object.

Notes

This function can be accessed by:

mdb.models[name].StaticStep

SteadyStateDirectStep(name: str, previous: str, frequencyRange: SteadyStateDirectFrequencyArray, description: str = '', factorization: SymbolicConstantType = 'COMPLEX', scale: SymbolicConstantType = 'LOGARITHMIC', matrixStorage: SymbolicConstantType = 'SOLVER_DEFAULT', maintainAttributes: BooleanType = False, subdivideUsingEigenfrequencies: BooleanType = 0, frictionDamping: BooleanType = 0) → SteadyStateDirectStep[source]#

This method creates a SteadyStateDirectStep object.

Parameters:

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.
frequencyRange: A SteadyStateDirectFrequencyArray object.
description: A String specifying a description of the new step. The default value is an empty string.
factorization: A SymbolicConstant specifying whether damping terms are to be ignored so that a real, rather than a complex, system matrix is factored. Possible values are REAL_ONLY and COMPLEX. The default value is COMPLEX.
scale: A SymbolicConstant specifying whether a logarithmic or linear scale is used for output. Possible values are LOGARITHMIC and LINEAR. The default value is LOGARITHMIC.
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.
subdivideUsingEigenfrequencies: A Boolean specifying whether to subdivide each frequency range using the eigenfrequencies of the system. The default value is OFF.
frictionDamping: A Boolean specifying whether to add to the damping matrix contributions due to friction effects. The default value is OFF.

Returns:

step: SteadyStateDirectStep: A SteadyStateDirectStep object.

Notes

This function can be accessed by:

mdb.models[name].SteadyStateDirectStep

SteadyStateModalStep(name: str, previous: str, frequencyRange: ~abaqus.StepMiscellaneous.SteadyStateModalFrequencyArray.SteadyStateModalFrequencyArray, description: str = '', scale: ~abaqusConstants.SymbolicConstantType = 'LOGARITHMIC', directDamping: ~abaqus.StepMiscellaneous.DirectDamping.DirectDamping = <abaqus.StepMiscellaneous.DirectDamping.DirectDamping object>, compositeDamping: ~abaqus.StepMiscellaneous.CompositeDamping.CompositeDamping = <abaqus.StepMiscellaneous.CompositeDamping.CompositeDamping object>, rayleighDamping: ~abaqus.StepMiscellaneous.RayleighDamping.RayleighDamping = <abaqus.StepMiscellaneous.RayleighDamping.RayleighDamping object>, structuralDamping: ~abaqus.StepMiscellaneous.StructuralDamping.StructuralDamping = <abaqus.StepMiscellaneous.StructuralDamping.StructuralDamping object>, directDampingByFrequency: ~abaqus.StepMiscellaneous.DirectDampingByFrequency.DirectDampingByFrequency = <abaqus.StepMiscellaneous.DirectDampingByFrequency.DirectDampingByFrequency object>, rayleighDampingByFrequency: ~abaqus.StepMiscellaneous.RayleighDampingByFrequency.RayleighDampingByFrequency = <abaqus.StepMiscellaneous.RayleighDampingByFrequency.RayleighDampingByFrequency object>, structuralDampingByFrequency: ~abaqus.StepMiscellaneous.StructuralDampingByFrequency.StructuralDampingByFrequency = <abaqus.StepMiscellaneous.StructuralDampingByFrequency.StructuralDampingByFrequency object>, maintainAttributes: ~abaqusConstants.BooleanType = False, subdivideUsingEigenfrequencies: ~abaqusConstants.BooleanType = 1) → SteadyStateModalStep[source]#

This method creates a SteadyStateModalStep object.

Parameters:

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.
frequencyRange: A SteadyStateModalFrequencyArray object.
description: A String specifying a description of the new step. The default value is an empty string.
scale: A SymbolicConstant specifying whether a logarithmic or linear scale is used for output. Possible values are LOGARITHMIC and LINEAR. The default value is LOGARITHMIC.
directDamping: A DirectDamping object.
compositeDamping: A CompositeDamping object.
rayleighDamping: A RayleighDamping object.
structuralDamping: A StructuralDamping object.
directDampingByFrequency: A DirectDampingByFrequency object.
rayleighDampingByFrequency: A RayleighDampingByFrequency object.
structuralDampingByFrequency: A StructuralDampingByFrequency object.
maintainAttributes: A Boolean specifying whether to retain attributes from an existing step with the same name. The default value is False.
subdivideUsingEigenfrequencies: A Boolean specifying whether to subdivide each frequency range using the eigenfrequencies of the system. The default value is ON.

Returns:

step: SteadyStateModalStep: A SteadyStateModalStep object.

Notes

This function can be accessed by:

mdb.models[name].SteadyStateModalStep

SteadyStateSubspaceStep(name: str, previous: str, frequencyRange: SteadyStateSubspaceFrequencyArray, description: str = '', factorization: SymbolicConstantType = 'COMPLEX', scale: SymbolicConstantType = 'LOGARITHMIC', matrixStorage: SymbolicConstantType = 'SOLVER_DEFAULT', maintainAttributes: BooleanType = False, subdivideUsingEigenfrequencies: BooleanType = 1, projection: SymbolicConstantType = 'ALL_FREQUENCIES', maxDampingChange: float = 0, maxStiffnessChange: float = 0, frictionDamping: BooleanType = 0) → SteadyStateSubspaceStep[source]#

This method creates a SteadyStateSubspaceStep object.

Parameters:

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.
frequencyRange: A SteadyStateSubspaceFrequencyArray object.
description: A String specifying a description of the new step. The default value is an empty string.
factorization: A SymbolicConstant specifying whether damping terms are to be ignored so that a real, rather than a complex, system matrix is factored. Possible values are REAL_ONLY and COMPLEX. The default value is COMPLEX.
scale: A SymbolicConstant specifying whether a logarithmic or linear scale is used for output. Possible values are LOGARITHMIC and LINEAR. The default value is LOGARITHMIC.
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.
subdivideUsingEigenfrequencies: A Boolean specifying whether to subdivide each frequency range using the eigenfrequencies of the system. The default value is ON.
projection: A SymbolicConstant specifying how often to perform subspace projections onto the modal subspace. Possible values are ALL_FREQUENCIES, CONSTANT, EIGENFREQUENCY, PROPERTY_CHANGE, and RANGE. The default value is ALL_FREQUENCIES.
maxDampingChange: A Float specifying the maximum relative change in damping material properties before a new projection is to be performed. The default value is 0.1.
maxStiffnessChange: A Float specifying the maximum relative change in stiffness material properties before a new projection is to be performed. The default value is 0.1.
frictionDamping: A Boolean specifying whether to add to the damping matrix contributions due to friction effects. The default value is OFF.

Returns:

step: SteadyStateSubspaceStep: A SteadyStateSubspaceStep object.

Notes

This function can be accessed by:

mdb.models[name].SteadyStateSubspaceStep

SubspaceDynamicsStep(name: str, previous: str, description: str = '', timePeriod: float = 1, vectors: SymbolicConstantType = 'ALL', nlgeom: BooleanType = 0, maxNumInc: int = 100, incSize: float = 0, amplitude: SymbolicConstantType = 'STEP', maintainAttributes: BooleanType = False) → SubspaceDynamicsStep[source]#

This method creates a SubspaceDynamicsStep object.

Parameters:

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.
description: A String specifying a description of the new step. The default value is an empty string.
timePeriod: A Float specifying the total time period of the step. The default value is 1.0.
vectors: The SymbolicConstant ALL or an Int specifying the number of modes to be used for subspace projection. The possible value for the SymbolicConstant is ALL. The default value is ALL.
nlgeom: A Boolean specifying whether to allow for geometric nonlinearity. The default value is OFF.
maxNumInc: An Int specifying the maximum number of increments in a step. The default value is 100.
incSize: A Float specifying the suggested time increment. The default value is 0.0.
amplitude: A SymbolicConstant specifying the amplitude variation for loading magnitudes during the step. Possible values are STEP and RAMP. The default value is STEP.
maintainAttributes: A Boolean specifying whether to retain attributes from an existing step with the same name. The default value is False.

Returns:

step: SubspaceDynamicsStep: A SubspaceDynamicsStep object.

Notes

This function can be accessed by:

mdb.models[name].SubspaceDynamicsStep

SubstructureGenerateStep(name: str, previous: str, substructureIdentifier: int, description: str = '', recoveryMatrix: ~abaqusConstants.SymbolicConstantType = 'WHOLE_MODEL', recoveryRegion: ~abaqus.Region.Region.Region = <abaqus.Region.Region.Region object>, computeGravityLoadVectors: ~abaqusConstants.BooleanType = False, computeReducedMassMatrix: ~abaqusConstants.BooleanType = False, computeReducedStructuralDampingMatrix: ~abaqusConstants.BooleanType = False, computeReducedViscousDampingMatrix: ~abaqusConstants.BooleanType = False, evaluateFrequencyDependentProperties: ~abaqusConstants.BooleanType = False, frequency: float = 0, retainedEigenmodesMethod: ~abaqusConstants.SymbolicConstantType = 'NONE', modeRange: ~abaqus.StepMiscellaneous.SubstructureGenerateModesArray.SubstructureGenerateModesArray | None = None, frequencyRange: ~abaqus.StepMiscellaneous.SubstructureGenerateFrequencyArray.SubstructureGenerateFrequencyArray | None = None, globalDampingField: ~abaqusConstants.SymbolicConstantType = 'NONE', alphaDampingRatio: float = 0, betaDampingRatio: float = 0, structuralDampingRatio: float = 0, viscousDampingControl: ~abaqusConstants.SymbolicConstantType = 'NONE', structuralDampingControl: ~abaqusConstants.SymbolicConstantType = 'NONE') → SubstructureGenerateStep[source]#

This method creates a SubstructureGenerateStep object.

Parameters:

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.
substructureIdentifier: An Integer specifying a unique identifier for the substructure.
description: A String specifying a description of the new step. The default value is an empty string.
recoveryMatrix: A SymbolicConstant specifying the subtructure recovery to be computed. Possible values are WHOLE_MODEL, REGION, and NONE. The default value is WHOLE_MODEL.
recoveryRegion: A Region object specifying the region for substructure recovery. This argument is required when *recoveryMatrix*=REGION.
computeGravityLoadVectors: A Boolean specifying whether to compute the gravity load vectors. The default value is False.
computeReducedMassMatrix: A Boolean specifying whether to compute the reduced mass matrix. The default value is False.
computeReducedStructuralDampingMatrix: A Boolean specifying whether to compute the reduced structural damping matrix. The default value is False.
computeReducedViscousDampingMatrix: A Boolean specifying whether to compute the reduced viscous damping matrix. The default value is False.
evaluateFrequencyDependentProperties: A Boolean specifying whether to evaluate the frequency dependent properties. The default value is False.
frequency: A Float specifying the frequency at which to evaluate the frequency dependent properties. The default value is 0.0.
retainedEigenmodesMethod: A SymbolicConstant specifying the eigenmodes to be retained. Possible values are MODE_RANGE, FREQUENCY_RANGE, and NONE. The default value is NONE.
modeRange: A SubstructureGenerateModesArray object.
frequencyRange: A SubstructureGenerateFrequencyArray object.
globalDampingField: A SymbolicConstant specifying the field to which the global damping factors should be applied. Possible values are ALL, ACOUSTIC, MECHANICAL, and NONE. The default value is NONE.
alphaDampingRatio: A Float specifying the factor to create global Rayleigh mass proportional damping. The default value is 0.0.
betaDampingRatio: A Float specifying the factor to create global Rayleigh stiffness proportional damping. The default value is 0.0.
structuralDampingRatio: A Float specifying the factor to create frequency-independent stiffness proportional structural damping. The default value is 0.0.
viscousDampingControl: A SymbolicConstant specifying the damping control to include the viscous damping matrix. Possible values are ELEMENT, FACTOR, COMBINED, and NONE. The default value is NONE.
structuralDampingControl: A SymbolicConstant specifying the damping control to include the structural damping matrix. Possible values are ELEMENT, FACTOR, COMBINED, and NONE. The default value is NONE.

Returns:

step: SubstructureGenerateStep: A SubstructureGenerateStep object.

Notes

This function can be accessed by:

mdb.models[name].SubstructureGenerateStep

TempDisplacementDynamicsStep(name: str, previous: str, description: str = '', timePeriod: float = 1, nlgeom: BooleanType = 0, timeIncrementationMethod: SymbolicConstantType = 'AUTOMATIC_GLOBAL', maxIncrement: float | None = None, scaleFactor: float = 1, userDefinedInc: float | None = None, massScaling: MassScalingArray = 'PREVIOUS_STEP', linearBulkViscosity: float = 0, quadBulkViscosity: float = 1, maintainAttributes: BooleanType = False, improvedDtMethod: BooleanType = 1) → TempDisplacementDynamicsStep[source]#

This method creates a TempDisplacementDynamicsStep object.

Parameters:

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.
description: A String specifying a description of the new step. The default value is an empty string.
timePeriod: A Float specifying the time period of the step. The default value is 1.0.
nlgeom: A Boolean specifying whether geometric nonlinearities should be accounted for during the step. The default value is OFF.
timeIncrementationMethod: A SymbolicConstant specifying the time incrementation method to be used. Possible values are AUTOMATIC_GLOBAL, AUTOMATIC_EBE, FIXED_USER_DEFINED_INC, and FIXED_EBE. The default value is AUTOMATIC_GLOBAL.
maxIncrement: None or a Float specifying the maximum time increment allowed. If there is no upper limit, *maxIncrement*=None. The default value is None.
scaleFactor: A Float specifying the factor that is used to scale the time increment. This argument is required only when *timeIncrementationMethod*=AUTOMATIC_GLOBAL, AUTOMATIC_EBE, or FIXED_EBE. The default value is 1.0.
userDefinedInc: None or a Float specifying the user-defined time increment. The default value is None.
massScaling: A MassScalingArray object specifying mass scaling controls. The default value is PREVIOUS_STEP.
linearBulkViscosity: A Float specifying the linear bulk viscosity parameter, b1b1. The default value is 0.06.
quadBulkViscosity: A Float specifying the quadratic bulk viscosity parameter, b2b2. The default value is 1.2.
maintainAttributes: A Boolean specifying whether to retain attributes from an existing step with the same name. The default value is False.
improvedDtMethod: A Boolean specifying whether to use the “improved” (*improvedDtMethod*=ON) or “conservative” (*improvedDtMethod*=OFF) method to estimate the element stable time increment for three-dimensional continuum elements and elements with plane stress formulations (shell, membrane, and two-dimensional plane stress elements). The default value is ON.

Returns:

step: TempDisplacementDynamicsStep: A TempDisplacementDynamicsStep object.

Notes

This function can be accessed by:

mdb.models[name].TempDisplacementDynamicsStep

ViscoStep(name: str, previous: str, description: str = '', timePeriod: float = 1, nlgeom: BooleanType = 0, stabilizationMethod: SymbolicConstantType = 'NONE', stabilizationMagnitude: float | None = None, timeIncrementationMethod: SymbolicConstantType = 'AUTOMATIC', matrixSolver: SymbolicConstantType = 'DIRECT', matrixStorage: SymbolicConstantType = 'SOLVER_DEFAULT', initialInc: float | None = None, maxNumInc: int = 100, minInc: float | None = None, maxInc: float = 1, integration: SymbolicConstantType = 'IMPLICIT_EXPLICIT', cetol: float = 0, amplitude: SymbolicConstantType = 'STEP', extrapolation: SymbolicConstantType = 'LINEAR', maintainAttributes: BooleanType = False, solutionTechnique: SymbolicConstantType = 'FULL_NEWTON', reformKernel: int = 8, convertSDI: SymbolicConstantType = 'PROPAGATED', adaptiveDampingRatio: float = 0, continueDampingFactors: BooleanType = 0) → ViscoStep[source]#

This method creates a ViscoStep object.

Parameters:

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.
description: A String specifying a description of the new step. The default value is an empty string.
timePeriod: A Float specifying the total time period. The default value is 1.0.
nlgeom: A Boolean specifying whether to allow for geometric nonlinearity. The default value is OFF.
stabilizationMethod: A SymbolicConstant specifying the stabilization type. Possible values are NONE, DISSIPATED_ENERGY_FRACTION, and DAMPING_FACTOR. The default value is NONE.
stabilizationMagnitude: A Float specifying the damping intensity of the automatic damping algorithm if the problem is expected to be unstable, and stabilizationMethod is not NONE. The default value is 2×10–4.
timeIncrementationMethod: A SymbolicConstant specifying the time incrementation method to be used. Possible values are FIXED and AUTOMATIC. The default value is AUTOMATIC.
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.
initialInc: A Float specifying the initial time increment. The default value is the total time period for the step.
maxNumInc: An Int specifying the maximum number of increments in a step. The default value is 100.
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.
maxInc: A Float specifying the maximum time increment allowed. The default is the total time period for the step. The default value is 1.0.
integration: A SymbolicConstant specifying which type of integration to use throughout the step. Possible values are IMPLICIT_EXPLICIT and EXPLICIT_ONLY. The default value is IMPLICIT_EXPLICIT.
cetol: A Float specifying the maximum difference in the creep strain increment calculated from the creep strain rates at the beginning and end of the increment. The default value is 0.0.
amplitude: A SymbolicConstant specifying the amplitude variation for loading magnitudes during the step. Possible values are STEP and RAMP. The default value is STEP.
extrapolation: A SymbolicConstant specifying the type of extrapolation to use in determining the incremental solution for a nonlinear analysis. Possible values are NONE, LINEAR, and PARABOLIC. The default value is LINEAR.
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.
adaptiveDampingRatio: A Float specifying the maximum allowable ratio of the stabilization energy to the total strain energy and can be used only if stabilizationMethod is not NONE. The default value is 0.05.
continueDampingFactors: A Boolean specifying whether this step will carry over the damping factors from the results of the preceding general step. This parameter must be used in conjunction with the adaptiveDampingRatio parameter. The default value is OFF.

Returns:

step: ViscoStep: A ViscoStep object.

Notes

This function can be accessed by:

mdb.models[name].ViscoStep

Object features#

Step#

class Step[source]#

The Step object stores the parameters that determine the context of the step. The Step object is the abstract base type for other Step objects. The Step object has no explicit constructor. The methods and members of the Step object are common to all objects derived from the Step.

Notes

This object can be accessed by:

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

Attributes:

name: str

A String specifying the repository key.

explicit: SymbolicConstant

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

perturbation: Boolean

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

nonmechanical: Boolean

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

procedureType: SymbolicConstant

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
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: Boolean

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

fieldOutputRequestState: dict[str, FieldOutputRequestState]

A repository of FieldOutputRequestState objects.

historyOutputRequestState: dict[str, HistoryOutputRequestState]

A repository of HistoryOutputRequestState objects.

diagnosticPrint: DiagnosticPrint

A DiagnosticPrint object.

monitor: Monitor

A Monitor object.

restart: Restart

A Restart object.

adaptiveMeshConstraintStates: dict[str, AdaptiveMeshConstraintState]

A repository of AdaptiveMeshConstraintState objects.

adaptiveMeshDomains: dict[str, AdaptiveMeshDomain]

A repository of AdaptiveMeshDomain objects.

control: Control

A Control object.

solverControl: SolverControl

A SolverControl object.

boundaryConditionStates: dict[str, BoundaryConditionState]

A repository of BoundaryConditionState objects.

interactionStates: int

A repository of InteractionState objects.

loadStates: dict[str, LoadState]

A repository of LoadState objects.

loadCases: dict[str, LoadCase]

A repository of LoadCase objects.

predefinedFieldStates: dict[str, PredefinedFieldState]

A repository of PredefinedFieldState objects.

activateElements: dict[str, ActivateElements]

A repository of ActivateElements objects.

ActivateElements(tableCollection: str, activation: str, eigenTimeConst: str = '', expansionTimeConstant: str = '') → ActivateElements[source]#

This method creates an ActivateElements object.

Parameters:

tableCollection: A String specifying the name of the tableCollection object.
activation: A string specifying the name of progressive element activation.
eigenTimeConst: A Double specifying the time constant used to ramp up the eigenstrains at element activation.
expansionTimeConstant: A Double specifying the time constant used to ramp up the thermal strains at element activation.

Returns:

elements: ActivateElements: An ActivateElements object.

Notes

This function can be accessed by:

mdb.models[name].ActivateElements

AdaptiveMeshConstraintState(amplitudeState: SymbolicConstantType | None = None, status: SymbolicConstantType | None = None, amplitude: str = '') → AdaptiveMeshConstraintState[source]#

The AdaptiveMeshConstraintState object is the abstract base type for other Arbitrary Lagrangian Eularian (ALE) style AdaptiveMeshConstraintState objects. The AdaptiveMeshConstraintState object has no explicit constructor or methods. The members of the AdaptiveMeshConstraintState object are common to all objects derived from the AdaptiveMeshConstraintState object.

Parameters:

amplitudeState: A SymbolicConstant specifying the propagation state of the amplitude reference. Possible values are UNSET, SET, UNCHANGED, FREED, and MODIFIED.
status: A SymbolicConstant specifying the propagation state of the AdaptiveMeshConstraintState object. Possible values are: - NOT_YET_ACTIVE - CREATED - PROPAGATED - MODIFIED - DEACTIVATED - NO_LONGER_ACTIVE - TYPE_NOT_APPLICABLE - INSTANCE_NOT_APPLICABLE - PROPAGATED_FROM_BASE_STATE - MODIFIED_FROM_BASE_STATE - DEACTIVATED_FROM_BASE_STATE - BUILT_INTO_MODES
amplitude: A String specifying the name of the amplitude reference. The String is empty if the adaptive mesh constraint has no amplitude reference.

Notes

This function can be accessed by:

mdb.models[name].steps[name].AdaptiveMeshConstraintState

AdaptiveMeshDomain(region: Region, controls: str = '', frequency: int = 10, initialMeshSweeps: int = 5, meshSweeps: int = 1) → AdaptiveMeshDomain[source]#

The AdaptiveMeshDomain object defines the region and controls that govern an Arbitrary Lagrangian Eularian (ALE) style adaptive smoothing mesh domain.

This method creates an AdaptiveMeshDomain object.

Parameters:

region: A Region object specifying the region to which the adaptive mesh domain is applied.
controls: A String specifying the name of an AdaptiveMeshControl object.
frequency: An Int specifying the frequency in increments at which adaptive meshing will be performed. The default value is 10.
initialMeshSweeps: An Int specifying the number of mesh sweeps to be performed at the beginning of the first step in which this adaptive mesh definition is active. The default value is 5.
meshSweeps: An Int specifying the number of mesh sweeps to be performed in each adaptive mesh increment. The default value is 1.

Returns:

An AdaptiveMeshDomain object

Notes

This function can be accessed by:

mdb.models[name].steps[name].AdaptiveMeshDomain

DiagnosticPrint(allke: BooleanType = 1, criticalElement: BooleanType = 1, dmass: BooleanType = 0, etotal: BooleanType = 0, contact: BooleanType = 1, modelChange: BooleanType = 0, plasticity: BooleanType = 0, residual: BooleanType = 1, frequency: int = 1, solve: BooleanType = 1, mass: BooleanType = 0) → DiagnosticPrint[source]#

This method creates a DiagnosticPrint object.

Parameters:

allke: A Boolean specifying a request for a column containing the total kinetic energy. This argument is valid only for an Abaqus/Explicit analysis. The default value is ON.
criticalElement: A Boolean specifying a request for a column containing the element that has the smallest stable time increment and a column listing the value. This argument is valid only for an Abaqus/Explicit analysis. The default value is ON.
dmass: A Boolean specifying a request for a column containing the percent change in total mass of the model as a result of mass scaling. This argument is valid only for an Abaqus/Explicit analysis. The default value is OFF unless mass scaling is present in the model.
etotal: A Boolean specifying a request for a column containing the energy balance of the model. This argument is valid only for an Abaqus/Explicit analysis. The default value is OFF.
contact: A Boolean specifying a request for detailed output of points that are contacting or separating in interface and gap problems. This argument is valid only for an Abaqus/Standard analysis. The default value is ON.
modelChange: A Boolean specifying a request for detailed output of which elements are being removed or reactivated in the step. This argument is valid only for an Abaqus/Standard analysis. The default value is OFF.
plasticity: A Boolean specifying a request for detailed output of element and integration point numbers for which the plasticity algorithms have failed to converge in the material routines. This argument is valid only for an Abaqus/Standard analysis. The default value is OFF.
residual: A Boolean specifying a request for output of equilibrium residuals during the equilibrium iterations. This argument is valid only for an Abaqus/Standard analysis. The default value is ON.
frequency: An Int specifying the frequency of output, in increments. The default value is 1.
solve: A Boolean specifying a request for information regarding the actual number of equations and the wavefront in each iteration. This argument is valid only for an Abaqus/Standard analysis. The default value is ON.
mass: A Boolean specifying a request for a column containing the total mass of the model as a result of mass scaling. This argument is valid only for an Abaqus/Explicit analysis. The default value is OFF.

Returns:

diagnosticPrint: DiagnosticPrint: A DiagnosticPrint object

Notes

This function can be accessed by:

mdb.models[name].steps[name].DiagnosticPrint

DisplacementAdaptiveMeshConstraintState(u1: float | None = None, u2: float | None = None, u3: float | None = None, ur1: float | None = None, ur2: float | None = None, ur3: float | None = None, u1State: SymbolicConstantType | None = None, u2State: SymbolicConstantType | None = None, u3State: SymbolicConstantType | None = None, ur1State: SymbolicConstantType | None = None, ur2State: SymbolicConstantType | None = None, ur3State: SymbolicConstantType | None = None, amplitudeState: SymbolicConstantType | None = None, status: SymbolicConstantType | None = None, amplitude: str = '') → DisplacementAdaptiveMeshConstraintState[source]#

The DisplacementAdaptiveMeshConstraintState object stores the propagating data for an Arbitrary Lagrangian Eularian (ALE) style displacement/rotation adaptive mesh constraint in a step. One instance of this object is created internally by the DisplacementAdaptiveMeshConstraint object for each step. The instance is also deleted internally by the DisplacementAdaptiveMeshConstraint object. The DisplacementAdaptiveMeshConstraintState object has no constructor or methods. The DisplacementAdaptiveMeshConstraintState object is derived from the AdaptiveMeshConstraintState object.

Parameters:

u1: A Float or a Complex specifying the displacement component in the 1-direction.
u2: A Float or a Complex specifying the displacement component in the 2-direction.
u3: A Float or a Complex specifying the displacement component in the 3-direction.
ur1: A Float or a Complex specifying the rotational displacement component about the 1-direction.
ur2: A Float or a Complex specifying the rotational displacement component about the 2-direction.
ur3: A Float or a Complex specifying the rotational displacement component about the 3-direction.
u1State: A SymbolicConstant specifying the propagation state of the displacement component in the 1-direction. Possible values are UNSET, SET, UNCHANGED, FREED, and MODIFIED.
u2State: A SymbolicConstant specifying the propagation state of the displacement component in the 2-direction. Possible values are UNSET, SET, UNCHANGED, FREED, and MODIFIED.
u3State: A SymbolicConstant specifying the propagation state of the displacement component in the 3-direction. Possible values are UNSET, SET, UNCHANGED, FREED, and MODIFIED.
ur1State: A SymbolicConstant specifying the propagation state of the rotational displacement component about the 1-direction. Possible values are UNSET, SET, UNCHANGED, FREED, and MODIFIED.
ur2State: A SymbolicConstant specifying the propagation state of the rotational displacement component about the 2-direction. Possible values are UNSET, SET, UNCHANGED, FREED, and MODIFIED.
ur3State: A SymbolicConstant specifying the propagation state of the rotational displacement component about the 3-direction. Possible values are UNSET, SET, UNCHANGED, FREED, and MODIFIED.
amplitudeState: A SymbolicConstant specifying the propagation state of the amplitude reference. Possible values are UNSET, SET, UNCHANGED, FREED, and MODIFIED.
status: A SymbolicConstant specifying the propagation state of the AdaptiveMeshConstraintState object. Possible values are: - NOT_YET_ACTIVE - CREATED - PROPAGATED - MODIFIED - DEACTIVATED - NO_LONGER_ACTIVE - TYPE_NOT_APPLICABLE - INSTANCE_NOT_APPLICABLE - PROPAGATED_FROM_BASE_STATE - MODIFIED_FROM_BASE_STATE - DEACTIVATED_FROM_BASE_STATE - BUILT_INTO_MODES
amplitude: A String specifying the name of the amplitude reference. The String is empty if the adaptive mesh constraint has no amplitude reference.

Notes

This function can be accessed by:

mdb.models[name].steps[name].DisplacementAdaptiveMeshConstraintState

Monitor(node: str, dof: SymbolicConstantType, frequency: int) → Monitor[source]#

This method creates a request for a degree of freedom to be monitored in a general or modal procedure.

Parameters:

node: A String specifying the name of the region to be monitored.
dof: A SymbolicConstant specifying the degree of freedom to be monitored at the node. Possible values are: - U1 - U2 - U3 - UR1 - UR2 - UR3 - WARP - FLUID_PRESSURE - ELECTRICAL_POTENTIAL - NT11 - NT30 - NN11 - NN30 The NT identifiers are not available for mass diffusion. The NN identifiers are available only for mass diffusion.
frequency: An Int specifying the output frequency in increments. This argument is valid only for an Abaqus/Standard analysis.

Returns:

monitor: Monitor: A Monitor object

Notes

This function can be accessed by:

mdb.models[name].steps[name].Monitor

Restart(numberIntervals: int = 0, timeMarks: BooleanType = 0, overlay: BooleanType = 0, frequency: int = 0) → Restart[source]#

This method creates a restart request.

Parameters:

numberIntervals: An Int specifying the number of intervals during the step at which restart information will be written. The default value is 0. The default value is 1.
timeMarks: A Boolean specifying whether to use exact time marks for writing during an analysis. The default value is OFF. The default value is OFF.
overlay: A Boolean specifying that only one increment per step should be retained on the restart file, thus minimizing the size of the restart file. The default value is OFF. The default value is ON.
frequency: An Int specifying the increments at which restart information will be written. The default value is 0. The default value is 0.This argument applies only to Abaqus/Standard analyses.

Returns:

restart: Restart: A Restart object

Raises:

RangeError.

Notes

This function can be accessed by:

mdb.models[name].steps[name].Restart

VelocityAdaptiveMeshConstraintState(v1: float | None = None, v2: float | None = None, v3: float | None = None, vr1: float | None = None, vr2: float | None = None, vr3: float | None = None, v1State: SymbolicConstantType | None = None, v2State: SymbolicConstantType | None = None, v3State: SymbolicConstantType | None = None, vr1State: SymbolicConstantType | None = None, vr2State: SymbolicConstantType | None = None, vr3State: SymbolicConstantType | None = None, amplitudeState: SymbolicConstantType | None = None, status: SymbolicConstantType | None = None, amplitude: str = '') → VelocityAdaptiveMeshConstraintState[source]#

The VelocityAdaptiveMeshConstraintState object stores the propagating data for an Arbitrary Lagrangian Eularian (ALE) style velocity adaptive mesh constraint in a step. One instance of this object is created internally by the VelocityAdaptiveMeshConstraint object for each step. The instance is also deleted internally by the VelocityAdaptiveMeshConstraint object. The VelocityAdaptiveMeshConstraintState object has no constructor or methods. The VelocityAdaptiveMeshConstraintState object is derived from the AdaptiveMeshConstraintState object.

Parameters:

v1: A Float specifying the velocity component in the 1-direction.
v2: A Float specifying the velocity component in the 2-direction.
v3: A Float specifying the velocity component in the 3-direction.
vr1: A Float specifying the rotational velocity component about the 1-direction.
vr2: A Float specifying the rotational velocity component about the 2-direction.
vr3: A Float specifying the rotational velocity component about the 3-direction.
v1State: A SymbolicConstant specifying the propagation state of the velocity component in the 1-direction. Possible values are UNSET, SET, UNCHANGED, FREED, and MODIFIED.
v2State: A SymbolicConstant specifying the propagation state of the velocity component in the 2-direction. Possible values are UNSET, SET, UNCHANGED, FREED, and MODIFIED.
v3State: A SymbolicConstant specifying the propagation state of the velocity component in the 3-direction. Possible values are UNSET, SET, UNCHANGED, FREED, and MODIFIED.
vr1State: A SymbolicConstant specifying the propagation state of the rotational velocity component about the 1-direction. Possible values are UNSET, SET, UNCHANGED, FREED, and MODIFIED.
vr2State: A SymbolicConstant specifying the propagation state of the rotational velocity component about the 2-direction. Possible values are UNSET, SET, UNCHANGED, FREED, and MODIFIED.
vr3State: A SymbolicConstant specifying the propagation state of the rotational velocity component about the 3-direction. Possible values are UNSET, SET, UNCHANGED, FREED, and MODIFIED.
amplitudeState: A SymbolicConstant specifying the propagation state of the amplitude reference. Possible values are UNSET, SET, UNCHANGED, FREED, and MODIFIED.
status: A SymbolicConstant specifying the propagation state of the AdaptiveMeshConstraintState object. Possible values are: - NOT_YET_ACTIVE - CREATED - PROPAGATED - MODIFIED - DEACTIVATED - NO_LONGER_ACTIVE - TYPE_NOT_APPLICABLE - INSTANCE_NOT_APPLICABLE - PROPAGATED_FROM_BASE_STATE - MODIFIED_FROM_BASE_STATE - DEACTIVATED_FROM_BASE_STATE - BUILT_INTO_MODES
amplitude: A String specifying the name of the amplitude reference. The String is empty if the adaptive mesh constraint has no amplitude reference.

Notes

This function can be accessed by:

mdb.models[name].steps[name].VelocityAdaptiveMeshConstraintState

resume()[source]#: This method resumes the step that was previously suppressed.

suppress()[source]#: This method suppresses the step.

AnalysisStep#

class AnalysisStep[source]#

The AnalysisStep object is the abstract base type for other Step objects, except the InitialStep object. It has no explicit constructor, no methods, and has only inherited members. The AnalysisStep object is derived from the Step object.

Notes

This object can be accessed by:

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

Attributes:

name: str

A String specifying the repository key.

explicit: SymbolicConstant

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

perturbation: Boolean

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

nonmechanical: Boolean

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

procedureType: SymbolicConstant

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
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: Boolean

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

fieldOutputRequestState: dict[str, FieldOutputRequestState]

A repository of FieldOutputRequestState objects.

historyOutputRequestState: dict[str, HistoryOutputRequestState]

A repository of HistoryOutputRequestState objects.

diagnosticPrint: DiagnosticPrint

A DiagnosticPrint object.

monitor: Monitor

A Monitor object.

restart: Restart

A Restart object.

adaptiveMeshConstraintStates: dict[str, AdaptiveMeshConstraintState]

A repository of AdaptiveMeshConstraintState objects.

adaptiveMeshDomains: dict[str, AdaptiveMeshDomain]

A repository of AdaptiveMeshDomain objects.

control: Control

A Control object.

solverControl: SolverControl

A SolverControl object.

boundaryConditionStates: dict[str, BoundaryConditionState]

A repository of BoundaryConditionState objects.

interactionStates: int

A repository of InteractionState objects.

loadStates: dict[str, LoadState]

A repository of LoadState objects.

loadCases: dict[str, LoadCase]

A repository of LoadCase objects.

predefinedFieldStates: dict[str, PredefinedFieldState]

A repository of PredefinedFieldState objects.

AnnealStep#

class AnnealStep(name: str, previous: str, description: str = '', refTemp: float | None = None, maintainAttributes: BooleanType = False)[source]#

The AnnealStep object anneals a structure by setting the velocities and all appropriate state variables to zero. The AnnealStep object is derived from the AnalysisStep object.

Notes

This object can be accessed by:

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

The corresponding analysis keywords are:

ANNEAL
- STEP

Attributes:

name: str

A String specifying the repository key.

refTemp: float

A Float specifying the post-anneal reference temperature. The default value is the current temperature at all nodes in the model after the annealing has completed.

previous: str

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

description: str

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

explicit: SymbolicConstant

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

perturbation: Boolean

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

nonmechanical: Boolean

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

procedureType: SymbolicConstant

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
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: Boolean

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

fieldOutputRequestState: dict[str, FieldOutputRequestState]

A repository of FieldOutputRequestState objects.

historyOutputRequestState: dict[str, HistoryOutputRequestState]

A repository of HistoryOutputRequestState objects.

diagnosticPrint: DiagnosticPrint

A DiagnosticPrint object.

monitor: Monitor

A Monitor object.

restart: Restart

A Restart object.

adaptiveMeshConstraintStates: dict[str, AdaptiveMeshConstraintState]

A repository of AdaptiveMeshConstraintState objects.

adaptiveMeshDomains: dict[str, AdaptiveMeshDomain]

A repository of AdaptiveMeshDomain objects.

control: Control

A Control object.

solverControl: SolverControl

A SolverControl object.

boundaryConditionStates: dict[str, BoundaryConditionState]

A repository of BoundaryConditionState objects.

interactionStates: int

A repository of InteractionState objects.

loadStates: dict[str, LoadState]

A repository of LoadState objects.

loadCases: dict[str, LoadCase]

A repository of LoadCase objects.

predefinedFieldStates: dict[str, PredefinedFieldState]

A repository of PredefinedFieldState objects.

Methods

setValues([description, refTemp])

This method modifies the AnnealStep object.

setValues(description: str = '', refTemp: float | None = None)[source]#

This method modifies the AnnealStep object.

Parameters:

description: A String specifying a description of the new step. The default value is an empty string.
refTemp: A Float specifying the post-anneal reference temperature. The default value is the current temperature at all nodes in the model after the annealing has completed.

Raises:

RangeError

BuckleStep#

class BuckleStep(name: str, previous: str, numEigen: int, description: str = '', eigensolver: SymbolicConstantType = 'SUBSPACE', minEigen: float | None = None, maxEigen: float | None = None, vectors: int | None = None, maxIterations: int = 30, blockSize: SymbolicConstantType = 'DEFAULT', maxBlocks: SymbolicConstantType = 'DEFAULT', matrixStorage: SymbolicConstantType = 'SOLVER_DEFAULT', maintainAttributes: BooleanType = False)[source]#

The BuckleStep object controls eigenvalue buckling estimation. The BuckleStep object is derived from the AnalysisStep object.

Notes

This object can be accessed by:

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

The corresponding analysis keywords are:

BUCKLE
- STEP

Attributes:

name: str

A String specifying the repository key.

numEigen: int

An Int specifying the number of eigenvalues to be estimated.

eigensolver: SymbolicConstant

A SymbolicConstant specifying the eigensolver. Possible values are SUBSPACE and LANCZOS. The default value is SUBSPACE.

minEigen: float

None or a Float specifying the minimum eigenvalue of interest. The default value is None.

maxEigen: float

None or a Float specifying the maximum eigenvalue of interest. The default value is None.

vectors: int

An Int specifying the number of vectors used in the iteration. The default value is the minimum of (2**n**, n + 8), where n is the number of eigenvalues requested.

maxIterations: int

An Int specifying the maximum number of iterations. The default value is 30.

blockSize: SymbolicConstant

The SymbolicConstant DEFAULT or an Int specifying the size of the Lanczos block steps. The default value is DEFAULT.

maxBlocks: SymbolicConstant

The SymbolicConstant DEFAULT or an Int specifying the maximum number of Lanczos block steps within each Lanczos run. The default value is DEFAULT.Note:minEigen, blockSize, and maxBlocks are ignored unless eigensolver=LANCZOS.

matrixStorage: SymbolicConstant

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

previous: str

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

description: str

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

explicit: SymbolicConstant

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

perturbation: Boolean

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

nonmechanical: Boolean

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

procedureType: SymbolicConstant

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
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: Boolean

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

fieldOutputRequestState: dict[str, FieldOutputRequestState]

A repository of FieldOutputRequestState objects.

historyOutputRequestState: dict[str, HistoryOutputRequestState]

A repository of HistoryOutputRequestState objects.

diagnosticPrint: DiagnosticPrint

A DiagnosticPrint object.

monitor: Monitor

A Monitor object.

restart: Restart

A Restart object.

adaptiveMeshConstraintStates: dict[str, AdaptiveMeshConstraintState]

A repository of AdaptiveMeshConstraintState objects.

adaptiveMeshDomains: dict[str, AdaptiveMeshDomain]

A repository of AdaptiveMeshDomain objects.

control: Control

A Control object.

solverControl: SolverControl

A SolverControl object.

boundaryConditionStates: dict[str, BoundaryConditionState]

A repository of BoundaryConditionState objects.

interactionStates: int

A repository of InteractionState objects.

loadStates: dict[str, LoadState]

A repository of LoadState objects.

loadCases: dict[str, LoadCase]

A repository of LoadCase objects.

predefinedFieldStates: dict[str, PredefinedFieldState]

A repository of PredefinedFieldState objects.

Methods

setValues([description, eigensolver, ...])

This method modifies the BuckleStep object.

setValues(description: str = '', eigensolver: SymbolicConstantType = 'SUBSPACE', minEigen: float | None = None, maxEigen: float | None = None, vectors: int | None = None, maxIterations: int = 30, blockSize: SymbolicConstantType = 'DEFAULT', maxBlocks: SymbolicConstantType = 'DEFAULT', matrixStorage: SymbolicConstantType = 'SOLVER_DEFAULT')[source]#

This method modifies the BuckleStep object.

Parameters:

description: A String specifying a description of the new step. The default value is an empty string.
eigensolver: A SymbolicConstant specifying the eigensolver. Possible values are SUBSPACE and LANCZOS. The default value is SUBSPACE.
minEigen: None or a Float specifying the minimum eigenvalue of interest. The default value is None.
maxEigen: None or a Float specifying the maximum eigenvalue of interest. The default value is None.
vectors: An Int specifying the number of vectors used in the iteration. The default value is the minimum of (2*n*, n + 8), where n is the number of eigenvalues requested.
maxIterations: An Int specifying the maximum number of iterations. The default value is 30.
blockSize: The SymbolicConstant DEFAULT or an Int specifying the size of the Lanczos block steps. The default value is DEFAULT.
maxBlocks: The SymbolicConstant DEFAULT or an Int specifying the maximum number of Lanczos block steps within each Lanczos run. The default value is DEFAULT.Note:minEigen, blockSize, and maxBlocks are ignored unless *eigensolver*=LANCZOS.
matrixStorage: A SymbolicConstant specifying the type of matrix storage. Possible values are SYMMETRIC, UNSYMMETRIC, and SOLVER_DEFAULT. The default value is SOLVER_DEFAULT.

Raises:

RangeError

ComplexFrequencyStep#

class ComplexFrequencyStep(name: str, previous: str, numEigen: SymbolicConstantType = 'ALL', description: str = '', shift: float | None = None, frictionDamping: BooleanType = 0, matrixStorage: SymbolicConstantType = 'SOLVER_DEFAULT', maintainAttributes: BooleanType = False, minEigen: float | None = None, maxEigen: float | None = None, propertyEvaluationFrequency: float | None = None)[source]#

The ComplexFrequencyStep object is used to perform eigenvalue extraction to calculate the complex eigenvalues and corresponding complex mode shapes of a system. The ComplexFrequencyStep object is derived from the AnalysisStep object.

Notes

This object can be accessed by:

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

The corresponding analysis keywords are:

COMPLEX FREQUENCY
- STEP

Attributes:

name: str

A String specifying the repository key.

numEigen: SymbolicConstant

The SymbolicConstant ALL or an Int specifying the number of complex eigenmodes to be calculated or a SymbolicConstant ALL. The default value is ALL.

shift: float

None or a Float specifying the shift point in cycles per time. The default value is None.

frictionDamping: Boolean

A Boolean specifying whether to add to the damping matrix contributions due to friction effects. The default value is OFF.

matrixStorage: SymbolicConstant

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

minEigen: float

None or a Float specifying the minimum frequency of interest in cycles per time. The default value is None.

maxEigen: float

None or a Float specifying the maximum frequency of interest in cycles per time. The default value is None.

propertyEvaluationFrequency: float

None or a Float specifying the frequency at which to evaluate frequency-dependent properties for viscoelasticity, springs, and dashpots during the eigenvalue extraction. If the value is None, the analysis product will evaluate the stiffness associated with frequency-dependent springs and dashpots at zero frequency and will not consider the stiffness contributions from frequency-domain viscoelasticity in the step. The default value is None.

previous: str

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

description: str

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

explicit: SymbolicConstant

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

perturbation: Boolean

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

nonmechanical: Boolean

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

procedureType: SymbolicConstant

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
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: Boolean

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

fieldOutputRequestState: dict[str, FieldOutputRequestState]

A repository of FieldOutputRequestState objects.

historyOutputRequestState: dict[str, HistoryOutputRequestState]

A repository of HistoryOutputRequestState objects.

diagnosticPrint: DiagnosticPrint

A DiagnosticPrint object.

monitor: Monitor

A Monitor object.

restart: Restart

A Restart object.

adaptiveMeshConstraintStates: dict[str, AdaptiveMeshConstraintState]

A repository of AdaptiveMeshConstraintState objects.

adaptiveMeshDomains: dict[str, AdaptiveMeshDomain]

A repository of AdaptiveMeshDomain objects.

control: Control

A Control object.

solverControl: SolverControl

A SolverControl object.

boundaryConditionStates: dict[str, BoundaryConditionState]

A repository of BoundaryConditionState objects.

interactionStates: int

A repository of InteractionState objects.

loadStates: dict[str, LoadState]

A repository of LoadState objects.

loadCases: dict[str, LoadCase]

A repository of LoadCase objects.

predefinedFieldStates: dict[str, PredefinedFieldState]

A repository of PredefinedFieldState objects.

Methods

setValues([numEigen, description, shift, ...])

This method modifies the ComplexFrequencyStep object.

setValues(numEigen: SymbolicConstantType = 'ALL', description: str = '', shift: float | None = None, frictionDamping: BooleanType = 0, matrixStorage: SymbolicConstantType = 'SOLVER_DEFAULT', minEigen: float | None = None, maxEigen: float | None = None, propertyEvaluationFrequency: float | None = None)[source]#

This method modifies the ComplexFrequencyStep object.

Parameters:

numEigen: The SymbolicConstant ALL or an Int specifying the number of complex eigenmodes to be calculated or a SymbolicConstant ALL. The default value is ALL.
description: A String specifying a description of the new step. The default value is an empty string.
shift: None or a Float specifying the shift point in cycles per time. The default value is None.
frictionDamping: A Boolean specifying whether to add to the damping matrix contributions due to friction effects. The default value is OFF.
matrixStorage: A SymbolicConstant specifying the type of matrix storage. Possible values are SYMMETRIC, UNSYMMETRIC, and SOLVER_DEFAULT. The default value is SOLVER_DEFAULT.
minEigen: None or a Float specifying the minimum frequency of interest in cycles per time. The default value is None.
maxEigen: None or a Float specifying the maximum frequency of interest in cycles per time. The default value is None.
propertyEvaluationFrequency: None or a Float specifying the frequency at which to evaluate frequency-dependent properties for viscoelasticity, springs, and dashpots during the eigenvalue extraction. If the value is None, the analysis product will evaluate the stiffness associated with frequency-dependent springs and dashpots at zero frequency and will not consider the stiffness contributions from frequency-domain viscoelasticity in the step. The default value is None.

Raises:

RangeError

CoupledTempDisplacementStep#

class CoupledTempDisplacementStep(name: str, previous: str, description: str = '', response: SymbolicConstantType = 'TRANSIENT', timePeriod: float = 1, nlgeom: BooleanType = 0, stabilizationMethod: SymbolicConstantType = 'NONE', stabilizationMagnitude: float | None = None, timeIncrementationMethod: SymbolicConstantType = 'AUTOMATIC', maxNumInc: int = 100, initialInc: float | None = None, minInc: float | None = None, maxInc: float | None = None, deltmx: float = 0, cetol: float = 0, creepIntegration: SymbolicConstantType = 'IMPLICIT', solutionTechnique: SymbolicConstantType = 'FULL_NEWTON', matrixStorage: SymbolicConstantType = 'SOLVER_DEFAULT', amplitude: SymbolicConstantType = 'STEP', extrapolation: SymbolicConstantType = 'LINEAR', maintainAttributes: BooleanType = False, convertSDI: SymbolicConstantType = 'PROPAGATED', adaptiveDampingRatio: float = 0, continueDampingFactors: BooleanType = 0)[source]#

The CoupledTempDisplacementStep object is used to analyze problems where the simultaneous solution of the temperature and stress/displacement fields is necessary. The CoupledTempDisplacementStep object is derived from the AnalysisStep object.

Notes

This object can be accessed by:

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

The corresponding analysis keywords are:

COUPLED TEMPERATURE-DISPLACEMENT
- SOLUTION TECHNIQUE
- STEP

Attributes:

name: str

A String specifying the repository key.

response: SymbolicConstant

A SymbolicConstant specifying the analysis type. Possible values are STEADY_STATE and TRANSIENT. The default value is TRANSIENT.

timePeriod: float

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

nlgeom: Boolean

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

stabilizationMethod: SymbolicConstant

A SymbolicConstant specifying the stabilization type. Possible values are NONE, DISSIPATED_ENERGY_FRACTION, and DAMPING_FACTOR. The default value is NONE.

stabilizationMagnitude: float

A Float specifying the damping intensity of the automatic damping algorithm if the problem is expected to be unstable and **stabilizationMethod**≠NONE. The default value is 2×10–4.

timeIncrementationMethod: SymbolicConstant

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

maxNumInc: int

An Int specifying the maximum number of increments in a step. The default value is 100.

initialInc: float

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

minInc: float

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.

maxInc: float

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

deltmx: float

A Float specifying the maximum temperature change to be allowed in an increment in a transient analysis. The default value is 0.0.

cetol: float

A Float specifying the maximum difference in the creep strain increment calculated from the creep strain rates at the beginning and end of the increment. The default value is 0.0.

creepIntegration: SymbolicConstant

A SymbolicConstant specifying the type of integration to be used for creep and swelling effects throughout the step. Possible values are IMPLICIT, EXPLICIT, and NONE. The default value is IMPLICIT.

solutionTechnique: SymbolicConstant

A SymbolicConstant specifying the type of solution technique. Possible values are FULL_NEWTON and SEPARATED. The default value is FULL_NEWTON.

matrixStorage: SymbolicConstant

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

amplitude: SymbolicConstant

A SymbolicConstant specifying the amplitude variation for loading magnitudes during the step. The default value is STEP. Possible values are STEP and RAMP.

extrapolation: SymbolicConstant

A SymbolicConstant specifying the type of extrapolation to use in determining the incremental solution for a nonlinear analysis. Possible values are NONE, LINEAR, and PARABOLIC. The default value is LINEAR.

convertSDI: SymbolicConstant

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.

adaptiveDampingRatio: float

A Float specifying the maximum allowable ratio of the stabilization energy to the total strain energy and can be used only if stabilizationMethod is not NONE. The default value is 0.05.

continueDampingFactors: Boolean

A Boolean specifying whether this step will carry over the damping factors from the results of the preceding general step. This parameter must be used in conjunction with the adaptiveDampingRatio parameter. The default value is OFF.

previous: str

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

description: str

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

explicit: SymbolicConstant

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

perturbation: Boolean

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

nonmechanical: Boolean

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

procedureType: SymbolicConstant

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
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: Boolean

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

fieldOutputRequestState: dict[str, FieldOutputRequestState]

A repository of FieldOutputRequestState objects.

historyOutputRequestState: dict[str, HistoryOutputRequestState]

A repository of HistoryOutputRequestState objects.

diagnosticPrint: DiagnosticPrint

A DiagnosticPrint object.

monitor: Monitor

A Monitor object.

restart: Restart

A Restart object.

adaptiveMeshConstraintStates: dict[str, AdaptiveMeshConstraintState]

A repository of AdaptiveMeshConstraintState objects.

adaptiveMeshDomains: dict[str, AdaptiveMeshDomain]

A repository of AdaptiveMeshDomain objects.

control: Control

A Control object.

solverControl: SolverControl

A SolverControl object.

boundaryConditionStates: dict[str, BoundaryConditionState]

A repository of BoundaryConditionState objects.

interactionStates: int

A repository of InteractionState objects.

loadStates: dict[str, LoadState]

A repository of LoadState objects.

loadCases: dict[str, LoadCase]

A repository of LoadCase objects.

predefinedFieldStates: dict[str, PredefinedFieldState]

A repository of PredefinedFieldState objects.

Methods

setValues([description, response, ...])

This method modifies the CoupledTempDisplacementStep object.

setValues(description: str = '', response: SymbolicConstantType = 'TRANSIENT', timePeriod: float = 1, nlgeom: BooleanType = 0, stabilizationMethod: SymbolicConstantType = 'NONE', stabilizationMagnitude: float | None = None, timeIncrementationMethod: SymbolicConstantType = 'AUTOMATIC', maxNumInc: int = 100, initialInc: float | None = None, minInc: float | None = None, maxInc: float | None = None, deltmx: float = 0, cetol: float = 0, creepIntegration: SymbolicConstantType = 'IMPLICIT', solutionTechnique: SymbolicConstantType = 'FULL_NEWTON', matrixStorage: SymbolicConstantType = 'SOLVER_DEFAULT', amplitude: SymbolicConstantType = 'STEP', extrapolation: SymbolicConstantType = 'LINEAR', convertSDI: SymbolicConstantType = 'PROPAGATED', adaptiveDampingRatio: float = 0, continueDampingFactors: BooleanType = 0)[source]#

This method modifies the CoupledTempDisplacementStep object.

Parameters:

description: A String specifying a description of the new step. The default value is an empty string.
response: A SymbolicConstant specifying the analysis type. Possible values are STEADY_STATE and TRANSIENT. The default value is TRANSIENT.
timePeriod: A Float specifying the total time period for the step. The default value is 1.0.
nlgeom: A Boolean specifying whether geometric nonlinearities should be accounted for during the step. The default value is OFF.
stabilizationMethod: A SymbolicConstant specifying the stabilization type. Possible values are NONE, DISSIPATED_ENERGY_FRACTION, and DAMPING_FACTOR. The default value is NONE.
stabilizationMagnitude: A Float specifying the damping intensity of the automatic damping algorithm if the problem is expected to be unstable and *stabilizationMethod*≠NONE. The default value is 2×10–4.
timeIncrementationMethod: A SymbolicConstant specifying the time incrementation method to be used. Possible values are FIXED and AUTOMATIC. The default value is AUTOMATIC.
maxNumInc: An Int specifying the maximum number of increments in a step. The default value is 100.
initialInc: A Float specifying the initial time increment. The default value is the total time period for the step.
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.
maxInc: A Float specifying the maximum time increment allowed. The default value is the total time period for the step.
deltmx: A Float specifying the maximum temperature change to be allowed in an increment in a transient analysis. The default value is 0.0.
cetol: A Float specifying the maximum difference in the creep strain increment calculated from the creep strain rates at the beginning and end of the increment. The default value is 0.0.
creepIntegration: A SymbolicConstant specifying the type of integration to be used for creep and swelling effects throughout the step. Possible values are IMPLICIT, EXPLICIT, and NONE. The default value is IMPLICIT.
solutionTechnique: A SymbolicConstant specifying the type of solution technique. Possible values are FULL_NEWTON and SEPARATED. The default value is FULL_NEWTON.
matrixStorage: A SymbolicConstant specifying the type of matrix storage. Possible values are SYMMETRIC, UNSYMMETRIC, and SOLVER_DEFAULT. The default value is SOLVER_DEFAULT.
amplitude: A SymbolicConstant specifying the amplitude variation for loading magnitudes during the step. The default value is STEP. Possible values are STEP and RAMP.
extrapolation: A SymbolicConstant specifying the type of extrapolation to use in determining the incremental solution for a nonlinear analysis. Possible values are NONE, LINEAR, and PARABOLIC. The default value is LINEAR.
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.
adaptiveDampingRatio: A Float specifying the maximum allowable ratio of the stabilization energy to the total strain energy and can be used only if stabilizationMethod is not NONE. The default value is 0.05.
continueDampingFactors: A Boolean specifying whether this step will carry over the damping factors from the results of the preceding general step. This parameter must be used in conjunction with the adaptiveDampingRatio parameter. The default value is OFF.

Raises:

RangeError

CoupledThermalElectricalStructuralStep#

class CoupledThermalElectricalStructuralStep(name: str, previous: str, description: str = '', response: SymbolicConstantType = 'TRANSIENT', timePeriod: float = 1, nlgeom: BooleanType = 0, stabilizationMethod: SymbolicConstantType = 'NONE', stabilizationMagnitude: float | None = None, timeIncrementationMethod: SymbolicConstantType = 'AUTOMATIC', maxNumInc: int = 100, initialInc: float | None = None, minInc: float | None = None, maxInc: float | None = None, deltmx: float = 0, cetol: float = 0, creepIntegration: SymbolicConstantType = 'IMPLICIT', matrixStorage: SymbolicConstantType = 'SOLVER_DEFAULT', amplitude: SymbolicConstantType = 'STEP', extrapolation: SymbolicConstantType = 'LINEAR', maintainAttributes: BooleanType = False, convertSDI: SymbolicConstantType = 'PROPAGATED', adaptiveDampingRatio: float = 0, continueDampingFactors: BooleanType = 0)[source]#

The CoupledThermalElectricalStructuralStep object is used to analyze problems where the simultaneous solution of the temperature, stress/displacement and electrical fields is necessary. The CoupledThermalElectricalStructuralStep object is derived from the AnalysisStep object.

Notes

This object can be accessed by:

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

The corresponding analysis keywords are:

COUPLED TEMPERATURE-DISPLACEMENT
- SOLUTION TECHNIQUE
- STEP

Attributes:

name: str

A String specifying the repository key.

response: SymbolicConstant

A SymbolicConstant specifying the analysis type. Possible values are STEADY_STATE and TRANSIENT. The default value is TRANSIENT.

timePeriod: float

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

nlgeom: Boolean

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

stabilizationMethod: SymbolicConstant

A SymbolicConstant specifying the stabilization type. Possible values are NONE, DISSIPATED_ENERGY_FRACTION, and DAMPING_FACTOR. The default value is NONE.

stabilizationMagnitude: float

A Float specifying the damping intensity of the automatic damping algorithm if the problem is expected to be unstable and **stabilizationMethod**≠NONE. The default value is 2×10–4.

timeIncrementationMethod: SymbolicConstant

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

maxNumInc: int

An Int specifying the maximum number of increments in a step. The default value is 100.

initialInc: float

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

minInc: float

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.

maxInc: float

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

deltmx: float

A Float specifying the maximum temperature change to be allowed in an increment in a transient analysis. The default value is 0.0.

cetol: float

A Float specifying the maximum difference in the creep strain increment calculated from the creep strain rates at the beginning and end of the increment. The default value is 0.0.

creepIntegration: SymbolicConstant

A SymbolicConstant specifying the type of integration to be used for creep and swelling effects throughout the step. Possible values are IMPLICIT, EXPLICIT, and NONE. The default value is IMPLICIT.

matrixStorage: SymbolicConstant

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

amplitude: SymbolicConstant

A SymbolicConstant specifying the amplitude variation for loading magnitudes during the step. The default value is STEP. Possible values are STEP and RAMP.

extrapolation: SymbolicConstant

convertSDI: SymbolicConstant

adaptiveDampingRatio: float

A Float specifying the maximum allowable ratio of the stabilization energy to the total strain energy and can be used only if stabilizationMethod is not NONE. The default value is 0.05.

continueDampingFactors: Boolean

previous: str

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

description: str

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

explicit: SymbolicConstant

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

perturbation: Boolean

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

nonmechanical: Boolean

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

procedureType: SymbolicConstant

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
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: Boolean

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

fieldOutputRequestState: dict[str, FieldOutputRequestState]

A repository of FieldOutputRequestState objects.

historyOutputRequestState: dict[str, HistoryOutputRequestState]

A repository of HistoryOutputRequestState objects.

diagnosticPrint: DiagnosticPrint

A DiagnosticPrint object.

monitor: Monitor

A Monitor object.

restart: Restart

A Restart object.

adaptiveMeshConstraintStates: dict[str, AdaptiveMeshConstraintState]

A repository of AdaptiveMeshConstraintState objects.

adaptiveMeshDomains: dict[str, AdaptiveMeshDomain]

A repository of AdaptiveMeshDomain objects.

control: Control

A Control object.

solverControl: SolverControl

A SolverControl object.

boundaryConditionStates: dict[str, BoundaryConditionState]

A repository of BoundaryConditionState objects.

interactionStates: int

A repository of InteractionState objects.

loadStates: dict[str, LoadState]

A repository of LoadState objects.

loadCases: dict[str, LoadCase]

A repository of LoadCase objects.

predefinedFieldStates: dict[str, PredefinedFieldState]

A repository of PredefinedFieldState objects.

Methods

setValues([description, response, ...])

This method modifies the CoupledThermalElectricalStructuralStep object.

setValues(description: str = '', response: SymbolicConstantType = 'TRANSIENT', timePeriod: float = 1, nlgeom: BooleanType = 0, stabilizationMethod: SymbolicConstantType = 'NONE', stabilizationMagnitude: float | None = None, timeIncrementationMethod: SymbolicConstantType = 'AUTOMATIC', maxNumInc: int = 100, initialInc: float | None = None, minInc: float | None = None, maxInc: float | None = None, deltmx: float = 0, cetol: float = 0, creepIntegration: SymbolicConstantType = 'IMPLICIT', matrixStorage: SymbolicConstantType = 'SOLVER_DEFAULT', amplitude: SymbolicConstantType = 'STEP', extrapolation: SymbolicConstantType = 'LINEAR', convertSDI: SymbolicConstantType = 'PROPAGATED', adaptiveDampingRatio: float = 0, continueDampingFactors: BooleanType = 0)[source]#

This method modifies the CoupledThermalElectricalStructuralStep object.

Parameters:

description: A String specifying a description of the new step. The default value is an empty string.
response: A SymbolicConstant specifying the analysis type. Possible values are STEADY_STATE and TRANSIENT. The default value is TRANSIENT.
timePeriod: A Float specifying the total time period for the step. The default value is 1.0.
nlgeom: A Boolean specifying whether geometric nonlinearities should be accounted for during the step. The default value is OFF.
stabilizationMethod: A SymbolicConstant specifying the stabilization type. Possible values are NONE, DISSIPATED_ENERGY_FRACTION, and DAMPING_FACTOR. The default value is NONE.
stabilizationMagnitude: A Float specifying the damping intensity of the automatic damping algorithm if the problem is expected to be unstable and *stabilizationMethod*≠NONE. The default value is 2×10–4.
timeIncrementationMethod: A SymbolicConstant specifying the time incrementation method to be used. Possible values are FIXED and AUTOMATIC. The default value is AUTOMATIC.
maxNumInc: An Int specifying the maximum number of increments in a step. The default value is 100.
initialInc: A Float specifying the initial time increment. The default value is the total time period for the step.
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.
maxInc: A Float specifying the maximum time increment allowed. The default value is the total time period for the step.
deltmx: A Float specifying the maximum temperature change to be allowed in an increment in a transient analysis. The default value is 0.0.
cetol: A Float specifying the maximum difference in the creep strain increment calculated from the creep strain rates at the beginning and end of the increment. The default value is 0.0.
creepIntegration: A SymbolicConstant specifying the type of integration to be used for creep and swelling effects throughout the step. Possible values are IMPLICIT, EXPLICIT, and NONE. The default value is IMPLICIT.
matrixStorage: A SymbolicConstant specifying the type of matrix storage. Possible values are SYMMETRIC, UNSYMMETRIC, and SOLVER_DEFAULT. The default value is SOLVER_DEFAULT.
amplitude: A SymbolicConstant specifying the amplitude variation for loading magnitudes during the step. The default value is STEP. Possible values are STEP and RAMP.
extrapolation: A SymbolicConstant specifying the type of extrapolation to use in determining the incremental solution for a nonlinear analysis. Possible values are NONE, LINEAR, and PARABOLIC. The default value is LINEAR.
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.
adaptiveDampingRatio: A Float specifying the maximum allowable ratio of the stabilization energy to the total strain energy and can be used only if stabilizationMethod is not NONE. The default value is 0.05.
continueDampingFactors: A Boolean specifying whether this step will carry over the damping factors from the results of the preceding general step. This parameter must be used in conjunction with the adaptiveDampingRatio parameter. The default value is OFF.

Raises:

RangeError

CoupledThermalElectricStep#

class CoupledThermalElectricStep(name: str, previous: str, description: str = '', response: SymbolicConstantType = 'TRANSIENT', timePeriod: float = 1, timeIncrementationMethod: SymbolicConstantType = 'AUTOMATIC', maxNumInc: int = 100, initialInc: float | None = None, minInc: float | None = None, maxInc: float | None = None, end: SymbolicConstantType = 'PERIOD', deltmx: float = 0, mxdem: float = 0, solutionTechnique: SymbolicConstantType = 'FULL_NEWTON', matrixStorage: SymbolicConstantType = 'SOLVER_DEFAULT', amplitude: SymbolicConstantType = 'STEP', extrapolation: SymbolicConstantType = 'LINEAR', maintainAttributes: BooleanType = False, convertSDI: SymbolicConstantType = 'PROPAGATED')[source]#

The CoupledThermalElectricStep object is used to analyze problems where the electrical potential and temperature fields must be solved simultaneously. The CoupledThermalElectricStep object is derived from the AnalysisStep object.

Notes

This object can be accessed by:

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

The corresponding analysis keywords are:

COUPLED THERMAL-ELECTRICAL
- SOLUTION TECHNIQUE
- STEP

Attributes:

name: str

A String specifying the repository key.

response: SymbolicConstant

A SymbolicConstant specifying the analysis type. Possible values are STEADY_STATE and TRANSIENT. The default value is TRANSIENT.

timePeriod: float

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

timeIncrementationMethod: SymbolicConstant

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

maxNumInc: int

An Int specifying the maximum number of increments in a step. The default value is 100.

initialInc: float

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

minInc: float

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.

maxInc: float

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

end: SymbolicConstant

A SymbolicConstant specifying the time period to be analyzed in a transient analysis. Possible values are PERIOD and SS. The default value is PERIOD.

deltmx: float

A Float specifying the maximum temperature change to be allowed in an increment in a transient analysis. The default value is 0.0.

mxdem: float

A Float specifying the maximum allowable emissivity change with temperature and field variables during an increment. The default value is 0.1.

solutionTechnique: SymbolicConstant

A SymbolicConstant specifying the type of solution technique. Possible values are FULL_NEWTON and SEPARATED. The default value is FULL_NEWTON.

matrixStorage: SymbolicConstant

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

amplitude: SymbolicConstant

A SymbolicConstant specifying the amplitude variation for loading magnitudes during the step. The default value is STEP. Possible values are STEP and RAMP.

extrapolation: SymbolicConstant

convertSDI: SymbolicConstant

previous: str

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

description: str

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

explicit: SymbolicConstant

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

perturbation: Boolean

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

nonmechanical: Boolean

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

procedureType: SymbolicConstant

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
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: Boolean

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

fieldOutputRequestState: dict[str, FieldOutputRequestState]

A repository of FieldOutputRequestState objects.

historyOutputRequestState: dict[str, HistoryOutputRequestState]

A repository of HistoryOutputRequestState objects.

diagnosticPrint: DiagnosticPrint

A DiagnosticPrint object.

monitor: Monitor

A Monitor object.

restart: Restart

A Restart object.

adaptiveMeshConstraintStates: dict[str, AdaptiveMeshConstraintState]

A repository of AdaptiveMeshConstraintState objects.

adaptiveMeshDomains: dict[str, AdaptiveMeshDomain]

A repository of AdaptiveMeshDomain objects.

control: Control

A Control object.

solverControl: SolverControl

A SolverControl object.

boundaryConditionStates: dict[str, BoundaryConditionState]

A repository of BoundaryConditionState objects.

interactionStates: int

A repository of InteractionState objects.

loadStates: dict[str, LoadState]

A repository of LoadState objects.

loadCases: dict[str, LoadCase]

A repository of LoadCase objects.

predefinedFieldStates: dict[str, PredefinedFieldState]

A repository of PredefinedFieldState objects.

Methods

setValues([description, response, ...])

This method modifies the CoupledThermalElectricStep object.

setValues(description: str = '', response: SymbolicConstantType = 'TRANSIENT', timePeriod: float = 1, timeIncrementationMethod: SymbolicConstantType = 'AUTOMATIC', maxNumInc: int = 100, initialInc: float | None = None, minInc: float | None = None, maxInc: float | None = None, end: SymbolicConstantType = 'PERIOD', deltmx: float = 0, mxdem: float = 0, solutionTechnique: SymbolicConstantType = 'FULL_NEWTON', matrixStorage: SymbolicConstantType = 'SOLVER_DEFAULT', amplitude: SymbolicConstantType = 'STEP', extrapolation: SymbolicConstantType = 'LINEAR', convertSDI: SymbolicConstantType = 'PROPAGATED')[source]#

This method modifies the CoupledThermalElectricStep object.

Parameters:

description: A String specifying a description of the new step. The default value is an empty string.
response: A SymbolicConstant specifying the analysis type. Possible values are STEADY_STATE and TRANSIENT. The default value is TRANSIENT.
timePeriod: A Float specifying the total time period for the step. The default value is 1.0.
timeIncrementationMethod: A SymbolicConstant specifying the time incrementation method to be used. Possible values are FIXED and AUTOMATIC. The default value is AUTOMATIC.
maxNumInc: An Int specifying the maximum number of increments in a step. The default value is 100.
initialInc: A Float specifying the initial time increment. The default value is the total time period for the step.
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.
maxInc: A Float specifying the maximum time increment allowed. The default value is the total time period for the step.
end: A SymbolicConstant specifying the time period to be analyzed in a transient analysis. Possible values are PERIOD and SS. The default value is PERIOD.
deltmx: A Float specifying the maximum temperature change to be allowed in an increment in a transient analysis. The default value is 0.0.
mxdem: A Float specifying the maximum allowable emissivity change with temperature and field variables during an increment. The default value is 0.1.
solutionTechnique: A SymbolicConstant specifying the type of solution technique. Possible values are FULL_NEWTON and SEPARATED. The default value is FULL_NEWTON.
matrixStorage: A SymbolicConstant specifying the type of matrix storage. Possible values are SYMMETRIC, UNSYMMETRIC, and SOLVER_DEFAULT. The default value is SOLVER_DEFAULT.
amplitude: A SymbolicConstant specifying the amplitude variation for loading magnitudes during the step. The default value is STEP. Possible values are STEP and RAMP.
extrapolation: A SymbolicConstant specifying the type of extrapolation to use in determining the incremental solution for a nonlinear analysis. Possible values are NONE, LINEAR, and PARABOLIC. The default value is LINEAR.
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.

Raises:

RangeError

DirectCyclicStep#

class DirectCyclicStep(name: str, previous: str, description: str = '', timePeriod: float = 1, timeIncrementationMethod: SymbolicConstantType = 'AUTOMATIC', maxNumInc: int = 100, initialInc: float | None = None, minInc: float | None = None, maxInc: float | None = None, maxNumIterations: int = 200, initialTerms: int = 11, maxTerms: int = 25, termsIncrement: int = 5, deltmx: float = 0, cetol: float = 0, timePoints: str = 'NONE', fatigue: BooleanType = 0, continueAnalysis: BooleanType = 0, minCycleInc: int = 100, maxCycleInc: int = 1000, maxNumCycles: SymbolicConstantType = 'DEFAULT', damageExtrapolationTolerance: float = 1, matrixStorage: SymbolicConstantType = 'SOLVER_DEFAULT', extrapolation: SymbolicConstantType = 'LINEAR', maintainAttributes: BooleanType = False, convertSDI: SymbolicConstantType = 'PROPAGATED')[source]#

The DirectCyclicStep object is used to provide a direct cyclic procedure for nonlinear, non-isothermal quasi-static analysis. It can also be used to predict progressive damage and failure for ductile bulk materials and/or to predict delamination/debonding growth at the interfaces in laminated composites in a low-cycle fatigue analysis. The DirectCyclicStep object is derived from the AnalysisStep object.

Notes

This object can be accessed by:

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

The corresponding analysis keywords are:

DIRECT CYCLIC
- STEP

Attributes:

name: str

A String specifying the repository key.

timePeriod: float

A Float specifying the time of single loading cycle. The default value is 1.0.

timeIncrementationMethod: SymbolicConstant

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

maxNumInc: int

An Int specifying the maximum number of increments in a step. The default value is 100.

initialInc: float

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

minInc: float

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.

maxInc: float

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

maxNumIterations: int

An Int specifying the maximum number of iterations in a step. The default value is 200.

initialTerms: int

An Int specifying the initial number of terms in the Fourier series. The default value is 11.

maxTerms: int

An Int specifying the maximum number of terms in the Fourier series. The default value is 25.

termsIncrement: int

An Int specifying the increment in number of terms in the Fourier series. The default value is 5.

deltmx: float

A Float specifying the maximum temperature change to be allowed in an increment. The default value is 0.0.

cetol: float

A Float specifying the maximum difference in the creep strain increment calculated from the creep strain rates at the beginning and end of the increment. The default value is 0.0.

fatigue: Boolean

A Boolean specifying whether to include low-cycle fatigue analysis. The default value is OFF.

continueAnalysis: Boolean

A Boolean specifying whether the displacement solution in the Fourier series obtained in the previous direct cyclic step is used as the starting values for the current step. The default value is OFF.

minCycleInc: int

An Int specifying the minimum number of cycles over which the damage is extrapolated forward. The default value is 100.

maxCycleInc: int

An Int specifying the maximum number of cycles over which the damage is extrapolated forward. The default value is 1000.

maxNumCycles: SymbolicConstant

The SymbolicConstant DEFAULT or an Int specifying the maximum number of cycles allowed in a step or DEFAULT. A value of 1 plus half of the maximum number of cycles will be used if DEFAULT is specified. The default value is DEFAULT.

damageExtrapolationTolerance: float

A Float specifying the maximum extrapolated damage increment. The default value is 1.0.

matrixStorage: SymbolicConstant

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

extrapolation: SymbolicConstant

convertSDI: SymbolicConstant

previous: str

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

description: str

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

timePoints: str

None or a String specifying a String specifying the name of a time point object used to determine at which times the response of the structure will be evaluated. The default value is NONE.

explicit: SymbolicConstant

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

perturbation: Boolean

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

nonmechanical: Boolean

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

procedureType: SymbolicConstant

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
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: Boolean

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

fieldOutputRequestState: dict[str, FieldOutputRequestState]

A repository of FieldOutputRequestState objects.

historyOutputRequestState: dict[str, HistoryOutputRequestState]

A repository of HistoryOutputRequestState objects.

diagnosticPrint: DiagnosticPrint

A DiagnosticPrint object.

monitor: Monitor

A Monitor object.

restart: Restart

A Restart object.

adaptiveMeshConstraintStates: dict[str, AdaptiveMeshConstraintState]

A repository of AdaptiveMeshConstraintState objects.

adaptiveMeshDomains: dict[str, AdaptiveMeshDomain]

A repository of AdaptiveMeshDomain objects.

control: Control

A Control object.

solverControl: SolverControl

A SolverControl object.

boundaryConditionStates: dict[str, BoundaryConditionState]

A repository of BoundaryConditionState objects.

interactionStates: int

A repository of InteractionState objects.

loadStates: dict[str, LoadState]

A repository of LoadState objects.

loadCases: dict[str, LoadCase]

A repository of LoadCase objects.

predefinedFieldStates: dict[str, PredefinedFieldState]

A repository of PredefinedFieldState objects.

Methods

setValues([description, timePeriod, ...])

This method modifies the DirectCyclicStep object.

setValues(description: str = '', timePeriod: float = 1, timeIncrementationMethod: SymbolicConstantType = 'AUTOMATIC', maxNumInc: int = 100, initialInc: float | None = None, minInc: float | None = None, maxInc: float | None = None, maxNumIterations: int = 200, initialTerms: int = 11, maxTerms: int = 25, termsIncrement: int = 5, deltmx: float = 0, cetol: float = 0, timePoints: str = 'NONE', fatigue: BooleanType = 0, continueAnalysis: BooleanType = 0, minCycleInc: int = 100, maxCycleInc: int = 1000, maxNumCycles: SymbolicConstantType = 'DEFAULT', damageExtrapolationTolerance: float = 1, matrixStorage: SymbolicConstantType = 'SOLVER_DEFAULT', extrapolation: SymbolicConstantType = 'LINEAR', convertSDI: SymbolicConstantType = 'PROPAGATED')[source]#

This method modifies the DirectCyclicStep object.

Parameters:

description: A String specifying a description of the new step. The default value is an empty string.
timePeriod: A Float specifying the time of single loading cycle. The default value is 1.0.
timeIncrementationMethod: A SymbolicConstant specifying the time incrementation method to be used. Possible values are FIXED and AUTOMATIC. The default value is AUTOMATIC.
maxNumInc: An Int specifying the maximum number of increments in a step. The default value is 100.
initialInc: A Float specifying the initial time increment. The default value is the total time period for the step.
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.
maxInc: A Float specifying the maximum time increment allowed. The default value is the total time period for the step.
maxNumIterations: An Int specifying the maximum number of iterations in a step. The default value is 200.
initialTerms: An Int specifying the initial number of terms in the Fourier series. The default value is 11.
maxTerms: An Int specifying the maximum number of terms in the Fourier series. The default value is 25.
termsIncrement: An Int specifying the increment in number of terms in the Fourier series. The default value is 5.
deltmx: A Float specifying the maximum temperature change to be allowed in an increment. The default value is 0.0.
cetol: A Float specifying the maximum difference in the creep strain increment calculated from the creep strain rates at the beginning and end of the increment. The default value is 0.0.
timePoints: None or a String specifying a String specifying the name of a time point object used to determine at which times the response of the structure will be evaluated. The default value is NONE.
fatigue: A Boolean specifying whether to include low-cycle fatigue analysis. The default value is OFF.
continueAnalysis: A Boolean specifying whether the displacement solution in the Fourier series obtained in the previous direct cyclic step is used as the starting values for the current step. The default value is OFF.
minCycleInc: An Int specifying the minimum number of cycles over which the damage is extrapolated forward. The default value is 100.
maxCycleInc: An Int specifying the maximum number of cycles over which the damage is extrapolated forward. The default value is 1000.
maxNumCycles: The SymbolicConstant DEFAULT or an Int specifying the maximum number of cycles allowed in a step or DEFAULT. A value of 1 plus half of the maximum number of cycles will be used if DEFAULT is specified. The default value is DEFAULT.
damageExtrapolationTolerance: A Float specifying the maximum extrapolated damage increment. The default value is 1.0.
matrixStorage: A SymbolicConstant specifying the type of matrix storage. Possible values are SYMMETRIC, UNSYMMETRIC, and SOLVER_DEFAULT. The default value is SOLVER_DEFAULT.
extrapolation: A SymbolicConstant specifying the type of extrapolation to use in determining the incremental solution for a nonlinear analysis. Possible values are NONE, LINEAR, and PARABOLIC. The default value is LINEAR.
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.

Raises:

RangeError

EmagTimeHarmonicStep#

class EmagTimeHarmonicStep(name: str, previous: str, frequencyRange: EmagTimeHarmonicFrequencyArray, description: str = '', factorization: SymbolicConstantType = 'COMPLEX')[source]#

The EmagTimeHarmonicStep object is used to calculate the electromagnetic response of the system to harmonic excitation of the model. The EmagTimeHarmonicStep object is derived from the AnalysisStep object.

Notes

This object can be accessed by:

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

The corresponding analysis keywords are:

ELECTROMAGNETIC TIME HARMONIC
- STEP

Attributes:

matrixStorage: SymbolicConstant

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

subdivideUsingEigenfrequencies: Boolean

A Boolean specifying whether to subdivide each frequency range using the eigenfrequencies of the system. The default value is OFF.

explicit: SymbolicConstant

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

perturbation: Boolean

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

nonmechanical: Boolean

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

procedureType: SymbolicConstant

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
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: Boolean

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

fieldOutputRequestState: dict[str, FieldOutputRequestState]

A repository of FieldOutputRequestState objects.

historyOutputRequestState: dict[str, HistoryOutputRequestState]

A repository of HistoryOutputRequestState objects.

diagnosticPrint: DiagnosticPrint

A DiagnosticPrint object.

monitor: Monitor

A Monitor object.

restart: Restart

A Restart object.

adaptiveMeshConstraintStates: dict[str, AdaptiveMeshConstraintState]

A repository of AdaptiveMeshConstraintState objects.

adaptiveMeshDomains: dict[str, AdaptiveMeshDomain]

A repository of AdaptiveMeshDomain objects.

control: Control

A Control object.

solverControl: SolverControl

A SolverControl object.

boundaryConditionStates: dict[str, BoundaryConditionState]

A repository of BoundaryConditionState objects.

interactionStates: int

A repository of InteractionState objects.

loadStates: dict[str, LoadState]

A repository of LoadState objects.

loadCases: dict[str, LoadCase]

A repository of LoadCase objects.

predefinedFieldStates: dict[str, PredefinedFieldState]

A repository of PredefinedFieldState objects.

Methods

setValues([description, factorization])

This method modifies the EmagTimeHarmonicStep object.

setValues(description: str = '', factorization: SymbolicConstantType = 'COMPLEX')[source]#

This method modifies the EmagTimeHarmonicStep object.

Parameters:

description: A String specifying a description of the new step. The default value is an empty string.
factorization: A SymbolicConstant specifying whether damping terms are to be ignored so that a real, rather than a complex, system matrix is factored. Possible values are REAL_ONLY and COMPLEX. The default value is COMPLEX.

Raises:

RangeError

ExplicitDynamicsStep#

class ExplicitDynamicsStep(name: str, previous: str, description: str = '', timePeriod: float = 1, nlgeom: BooleanType = 1, adiabatic: BooleanType = 0, timeIncrementationMethod: SymbolicConstantType = 'AUTOMATIC_GLOBAL', maxIncrement: float | None = None, scaleFactor: float = 1, massScaling: MassScalingArray = 'PREVIOUS_STEP', linearBulkViscosity: float = 0, quadBulkViscosity: float = 1, userDefinedInc: float | None = None, maintainAttributes: BooleanType = False, improvedDtMethod: BooleanType = 1)[source]#

The ExplicitDynamicsStep object is used to perform a dynamic stress/displacement analysis using explicit integration in Abaqus/Explicit. The ExplicitDynamicsStep object is derived from the AnalysisStep object.

Notes

This object can be accessed by:

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

The corresponding analysis keywords are:

BULK VISCOSITY
- DYNAMIC
- FIXED MASS SCALING
- STEP
- VARIABLE MASS SCALING

Attributes:

name: str

A String specifying the repository key.

timePeriod: float

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

nlgeom: Boolean

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

adiabatic: Boolean

A Boolean specifying that an adiabatic stress analysis is to be performed. The default value is OFF.

timeIncrementationMethod: SymbolicConstant

A SymbolicConstant specifying the time incrementation method to be used. Possible values are AUTOMATIC_GLOBAL, AUTOMATIC_EBE, FIXED_USER_DEFINED_INC, and FIXED_EBE. The default value is AUTOMATIC_GLOBAL.

maxIncrement: float

None or a Float specifying the maximum time increment. If there is no upper limit, maxIncrement=None. This argument is required only when timeIncrementationMethod=AUTOMATIC_GLOBAL or AUTOMATIC_EBE. The default value is None.

scaleFactor: float

A Float specifying the factor that is used to scale the time increment. This argument is required only when timeIncrementationMethod=AUTOMATIC_GLOBAL, AUTOMATIC_EBE, or FIXED_EBE. The default value is 1.0.

linearBulkViscosity: float

A Float specifying the linear bulk viscosity parameter, b1b1. The default value is 0.06.

quadBulkViscosity: float

A Float specifying the quadratic bulk viscosity parameter, b2b2. The default value is 1.2.

userDefinedInc: float

None or a Float specifying the user-defined time increment. This argument is required only when timeIncrementationMethod=FIXED_USER_DEFINED_INC. The default value is None.

improvedDtMethod: Boolean

A Boolean specifying whether to use the “improved” (improvedDtMethod=ON) or “conservative” (improvedDtMethod=OFF) method to estimate the element stable time increment for three-dimensional continuum elements and elements with plane stress formulations (shell, membrane, and two-dimensional plane stress elements). The default value is ON.

previous: str

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

description: str

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

massScaling: MassScalingArray

A MassScalingArray object specifying mass scaling controls. The default value is PREVIOUS_STEP.

explicit: SymbolicConstant

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

perturbation: Boolean

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

nonmechanical: Boolean

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

procedureType: SymbolicConstant

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
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: Boolean

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

fieldOutputRequestState: dict[str, FieldOutputRequestState]

A repository of FieldOutputRequestState objects.

historyOutputRequestState: dict[str, HistoryOutputRequestState]

A repository of HistoryOutputRequestState objects.

diagnosticPrint: DiagnosticPrint

A DiagnosticPrint object.

monitor: Monitor

A Monitor object.

restart: Restart

A Restart object.

adaptiveMeshConstraintStates: dict[str, AdaptiveMeshConstraintState]

A repository of AdaptiveMeshConstraintState objects.

adaptiveMeshDomains: dict[str, AdaptiveMeshDomain]

A repository of AdaptiveMeshDomain objects.

control: Control

A Control object.

solverControl: SolverControl

A SolverControl object.

boundaryConditionStates: dict[str, BoundaryConditionState]

A repository of BoundaryConditionState objects.

interactionStates: int

A repository of InteractionState objects.

loadStates: dict[str, LoadState]

A repository of LoadState objects.

loadCases: dict[str, LoadCase]

A repository of LoadCase objects.

predefinedFieldStates: dict[str, PredefinedFieldState]

A repository of PredefinedFieldState objects.

Methods

setValues([description, timePeriod, nlgeom, ...])

This method modifies the ExplicitDynamicsStep object.

setValues(description: str = '', timePeriod: float = 1, nlgeom: BooleanType = 1, adiabatic: BooleanType = 0, timeIncrementationMethod: SymbolicConstantType = 'AUTOMATIC_GLOBAL', maxIncrement: float | None = None, scaleFactor: float = 1, massScaling: MassScalingArray = 'PREVIOUS_STEP', linearBulkViscosity: float = 0, quadBulkViscosity: float = 1, userDefinedInc: float | None = None, improvedDtMethod: BooleanType = 1)[source]#

This method modifies the ExplicitDynamicsStep object.

Parameters:

description: A String specifying a description of the new step. The default value is an empty string.
timePeriod: A Float specifying the total time period for the step. The default value is 1.0.
nlgeom: A Boolean specifying whether geometric nonlinearities should be accounted for during the step. The default value is ON.
adiabatic: A Boolean specifying that an adiabatic stress analysis is to be performed. The default value is OFF.
timeIncrementationMethod: A SymbolicConstant specifying the time incrementation method to be used. Possible values are AUTOMATIC_GLOBAL, AUTOMATIC_EBE, FIXED_USER_DEFINED_INC, and FIXED_EBE. The default value is AUTOMATIC_GLOBAL.
maxIncrement: None or a Float specifying the maximum time increment. If there is no upper limit, *maxIncrement*=None. This argument is required only when *timeIncrementationMethod*=AUTOMATIC_GLOBAL or AUTOMATIC_EBE. The default value is None.
scaleFactor: A Float specifying the factor that is used to scale the time increment. This argument is required only when *timeIncrementationMethod*=AUTOMATIC_GLOBAL, AUTOMATIC_EBE, or FIXED_EBE. The default value is 1.0.
massScaling: A MassScalingArray object specifying mass scaling controls. The default value is PREVIOUS_STEP.
linearBulkViscosity: A Float specifying the linear bulk viscosity parameter, b1b1. The default value is 0.06.
quadBulkViscosity: A Float specifying the quadratic bulk viscosity parameter, b2b2. The default value is 1.2.
userDefinedInc: None or a Float specifying the user-defined time increment. This argument is required only when *timeIncrementationMethod*=FIXED_USER_DEFINED_INC. The default value is None.
improvedDtMethod: A Boolean specifying whether to use the “improved” (*improvedDtMethod*=ON) or “conservative” (*improvedDtMethod*=OFF) method to estimate the element stable time increment for three-dimensional continuum elements and elements with plane stress formulations (shell, membrane, and two-dimensional plane stress elements). The default value is ON.

Raises:

RangeError

FrequencyStep#

class FrequencyStep(name: str, previous: str, eigensolver: SymbolicConstantType, numEigen: SymbolicConstantType = 'ALL', description: str = '', shift: float = 0, minEigen: float | None = None, maxEigen: float | None = None, vectors: int | None = None, maxIterations: int = 30, blockSize: SymbolicConstantType = 'DEFAULT', maxBlocks: SymbolicConstantType = 'DEFAULT', normalization: SymbolicConstantType = 'DISPLACEMENT', propertyEvaluationFrequency: float | None = None, projectDamping: BooleanType = 1, acousticCoupling: SymbolicConstantType = 'AC_ON', acousticRangeFactor: float = 1, frictionDamping: BooleanType = 0, matrixStorage: SymbolicConstantType = 'SOLVER_DEFAULT', maintainAttributes: BooleanType = False, simLinearDynamics: BooleanType = 0, residualModes: BooleanType = 0, substructureCutoffMultiplier: float = 5, firstCutoffMultiplier: float = 1, secondCutoffMultiplier: float = 1, residualModeRegion: str | None = None, residualModeDof: str | None = None, limitSavedEigenvectorRegion: SymbolicConstantType | None = None)[source]#

The FrequencyStep object is used to perform eigenvalue extraction to calculate the natural frequencies and corresponding mode shapes of a system. The FrequencyStep object is derived from the AnalysisStep object.

Notes

This object can be accessed by:

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

The corresponding analysis keywords are:

FREQUENCY
- STEP

Attributes:

name: str

A String specifying the repository key.

eigensolver: SymbolicConstant

A SymbolicConstant specifying the eigensolver. Possible values are LANCZOS, SUBSPACE, and AMS.The following optional arguments are ignored unless eigensolver=LANCZOS: blockSize, maxBlocks, normalization, propertyEvaluationFrequency.The following optional arguments are ignored unless eigensolver=LANCZOS or AMS: minEigen, maxEigen, and acousticCoupling.The following optional arguments are ignored unless eigensolver=AMS: projectDamping, acousticRangeFactor, substructureCutoffMultiplier, firstCutoffMultiplier, secondCutoffMultiplier, residualModeRegion, regionalModeDof, and limitSavedEigenvectorRegion.

numEigen: SymbolicConstant

The SymbolicConstant ALL or an Int specifying the number of eigenvalues to be calculated or ALL. The default value is ALL.

shift: float

A Float specifying the shift point in cycles per time. The default value is 0.0.

minEigen: float

None or a Float specifying the minimum frequency of interest in cycles per time. The default value is None.

maxEigen: float

None or a Float specifying the maximum frequency of interest in cycles per time. The default value is None.

vectors: int

None or an Int specifying the number of vectors used in the iteration. The default is the minimum of (2**n**, n + 8), where n is the number of eigenvalues requested. The default value is None.

maxIterations: int

An Int specifying the maximum number of iterations. The default value is 30.

blockSize: SymbolicConstant

A SymbolicConstant specifying the size of the Lanczos block steps. The default value is DEFAULT.

maxBlocks: SymbolicConstant

A SymbolicConstant specifying the maximum number of Lanczos block steps within each Lanczos run. The default value is DEFAULT.

normalization: SymbolicConstant

A SymbolicConstant specifying the method for normalizing eigenvectors. Possible values are DISPLACEMENT and MASS. The default value is DISPLACEMENT.A value of DISPLACEMENT indicates normalizing the eigenvectors so that the largest displacement entry in each vector is unity. A value of MASS indicates normalizing the eigenvectors with respect to the structure’s mass matrix, which results in scaling the eigenvectors so that the generalized mass for each vector is unity.

propertyEvaluationFrequency: float

projectDamping: Boolean

A Boolean specifying whether to include projection of viscous and structural damping operators during AMS eigenvalue extraction. Valid only when eigenSolver=AMS. The default value is ON.

acousticCoupling: SymbolicConstant

A SymbolicConstant specifying the type of acoustic-structural coupling in models with acoustic and structural elements coupled using the TIE option or in models with ASI-type elements. Possible values are AC_ON, AC_OFF, and AC_PROJECTION. The default value is AC_ON.

acousticRangeFactor: float

A Float specifying the ratio of the maximum acoustic frequency to the maximum structural frequency. The default value is 1.0.

frictionDamping: Boolean

A Boolean specifying whether to add to the damping matrix contributions due to friction effects. The default value is OFF.

matrixStorage: SymbolicConstant

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

simLinearDynamics: Boolean

A Boolean specifying whether to activate the SIM-based linear dynamics procedures. The default value is OFF.

residualModes: Boolean

A Boolean specifying whether to include residual modes from an immediately preceding Static, Linear Perturbation step. The default value is OFF.

substructureCutoffMultiplier: float

A Float specifying the cutoff frequency for substructure eigenproblems, defined as a multiplier of the maximum frequency of interest. The default value is 5.0.

firstCutoffMultiplier: float

A Float specifying the first cutoff frequency for a reduced eigenproblem, defined as a multiplier of the maximum frequency of interest. The default value is 1.7.

secondCutoffMultiplier: float

A Float specifying the second cutoff frequency for a reduced eigenproblem defined as a multiplier of the maximum frequency of interest. The default value is 1.1.

previous: str

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

description: str

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

residualModeRegion: tuple

None or a tuple of Strings specifying the name of a region for which residual modes are requested. The default value is None.

residualModeDof: int

None or a tuple of Ints specifying the degree of freedom for which residual modes are requested. The default value is None.

limitSavedEigenvectorRegion: SymbolicConstant

None or a Region object specifying a region for which eigenvectors should be saved or the SymbolicConstant None representing the whole model. The default value is None.

explicit: SymbolicConstant

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

perturbation: Boolean

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

nonmechanical: Boolean

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

procedureType: SymbolicConstant

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
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: Boolean

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

fieldOutputRequestState: dict[str, FieldOutputRequestState]

A repository of FieldOutputRequestState objects.

historyOutputRequestState: dict[str, HistoryOutputRequestState]

A repository of HistoryOutputRequestState objects.

diagnosticPrint: DiagnosticPrint

A DiagnosticPrint object.

monitor: Monitor

A Monitor object.

restart: Restart

A Restart object.

adaptiveMeshConstraintStates: dict[str, AdaptiveMeshConstraintState]

A repository of AdaptiveMeshConstraintState objects.

adaptiveMeshDomains: dict[str, AdaptiveMeshDomain]

A repository of AdaptiveMeshDomain objects.

control: Control

A Control object.

solverControl: SolverControl

A SolverControl object.

boundaryConditionStates: dict[str, BoundaryConditionState]

A repository of BoundaryConditionState objects.

interactionStates: int

A repository of InteractionState objects.

loadStates: dict[str, LoadState]

A repository of LoadState objects.

loadCases: dict[str, LoadCase]

A repository of LoadCase objects.

predefinedFieldStates: dict[str, PredefinedFieldState]

A repository of PredefinedFieldState objects.

Methods

setValues([numEigen, description, shift, ...])

This method modifies the FrequencyStep object.

setValues(numEigen: SymbolicConstantType = 'ALL', description: str = '', shift: float = 0, minEigen: float | None = None, maxEigen: float | None = None, vectors: int | None = None, maxIterations: int = 30, blockSize: SymbolicConstantType = 'DEFAULT', maxBlocks: SymbolicConstantType = 'DEFAULT', normalization: SymbolicConstantType = 'DISPLACEMENT', propertyEvaluationFrequency: float | None = None, projectDamping: BooleanType = 1, acousticCoupling: SymbolicConstantType = 'AC_ON', acousticRangeFactor: float = 1, frictionDamping: BooleanType = 0, matrixStorage: SymbolicConstantType = 'SOLVER_DEFAULT', simLinearDynamics: BooleanType = 0, residualModes: BooleanType = 0, substructureCutoffMultiplier: float = 5, firstCutoffMultiplier: float = 1, secondCutoffMultiplier: float = 1, residualModeRegion: str | None = None, residualModeDof: str | None = None, limitSavedEigenvectorRegion: SymbolicConstantType | None = None)[source]#

This method modifies the FrequencyStep object.

Parameters:

numEigen: The SymbolicConstant ALL or an Int specifying the number of eigenvalues to be calculated or ALL. The default value is ALL.
description: A String specifying a description of the new step. The default value is an empty string.
shift: A Float specifying the shift point in cycles per time. The default value is 0.0.
minEigen: None or a Float specifying the minimum frequency of interest in cycles per time. The default value is None.
maxEigen: None or a Float specifying the maximum frequency of interest in cycles per time. The default value is None.
vectors: None or an Int specifying the number of vectors used in the iteration. The default is the minimum of (2*n*, n + 8), where n is the number of eigenvalues requested. The default value is None.
maxIterations: An Int specifying the maximum number of iterations. The default value is 30.
blockSize: A SymbolicConstant specifying the size of the Lanczos block steps. The default value is DEFAULT.
maxBlocks: A SymbolicConstant specifying the maximum number of Lanczos block steps within each Lanczos run. The default value is DEFAULT.
normalization: A SymbolicConstant specifying the method for normalizing eigenvectors. Possible values are DISPLACEMENT and MASS. The default value is DISPLACEMENT.A value of DISPLACEMENT indicates normalizing the eigenvectors so that the largest displacement entry in each vector is unity. A value of MASS indicates normalizing the eigenvectors with respect to the structure’s mass matrix, which results in scaling the eigenvectors so that the generalized mass for each vector is unity.
propertyEvaluationFrequency: None or a Float specifying the frequency at which to evaluate frequency-dependent properties for viscoelasticity, springs, and dashpots during the eigenvalue extraction. If the value is None, the analysis product will evaluate the stiffness associated with frequency-dependent springs and dashpots at zero frequency and will not consider the stiffness contributions from frequency-domain viscoelasticity in the step. The default value is None.
projectDamping: A Boolean specifying whether to include projection of viscous and structural damping operators during AMS eigenvalue extraction. Valid only when *eigenSolver*=AMS. The default value is ON.
acousticCoupling: A SymbolicConstant specifying the type of acoustic-structural coupling in models with acoustic and structural elements coupled using the TIE option or in models with ASI-type elements. Possible values are AC_ON, AC_OFF, and AC_PROJECTION. The default value is AC_ON.
acousticRangeFactor: A Float specifying the ratio of the maximum acoustic frequency to the maximum structural frequency. The default value is 1.0.
frictionDamping: A Boolean specifying whether to add to the damping matrix contributions due to friction effects. The default value is OFF.
matrixStorage: A SymbolicConstant specifying the type of matrix storage. Possible values are SYMMETRIC, UNSYMMETRIC, and SOLVER_DEFAULT. The default value is SOLVER_DEFAULT.
simLinearDynamics: A Boolean specifying whether to activate the SIM-based linear dynamics procedures. The default value is OFF.
residualModes: A Boolean specifying whether to include residual modes from an immediately preceding Static, Linear Perturbation step. The default value is OFF.
substructureCutoffMultiplier: A Float specifying the cutoff frequency for substructure eigenproblems, defined as a multiplier of the maximum frequency of interest. The default value is 5.0.
firstCutoffMultiplier: A Float specifying the first cutoff frequency for a reduced eigenproblem, defined as a multiplier of the maximum frequency of interest. The default value is 1.7.
secondCutoffMultiplier: A Float specifying the second cutoff frequency for a reduced eigenproblem defined as a multiplier of the maximum frequency of interest. The default value is 1.1.
residualModeRegion: None or a sequence of Strings specifying the name of a region for which residual modes are requested. The default value is None.
residualModeDof: None or a sequence of Ints specifying the degree of freedom for which residual modes are requested. The default value is None.
limitSavedEigenvectorRegion: None or a Region object specifying a region for which eigenvectors should be saved or the SymbolicConstant None representing the whole model. The default value is None.

Raises:

RangeError

GeostaticStep#

class GeostaticStep(name: str, previous: str, description: str = '', nlgeom: BooleanType = 0, matrixSolver: SymbolicConstantType = 'DIRECT', matrixStorage: SymbolicConstantType = 'SOLVER_DEFAULT', maintainAttributes: BooleanType = False, solutionTechnique: SymbolicConstantType = 'FULL_NEWTON', reformKernel: int = 8, convertSDI: SymbolicConstantType = 'PROPAGATED', utol: float | None = None, timePeriod: float = 1, timeIncrementationMethod: SymbolicConstantType = 'AUTOMATIC', maxNumInc: int = 100, initialInc: float | None = None, minInc: float | None = None, maxInc: float | None = None)[source]#

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.

Notes

This object can be accessed by:

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

The corresponding analysis keywords are:

GEOSTATIC
- STEP

Attributes:

name: str

A String specifying the repository key.

nlgeom: Boolean

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

matrixSolver: SymbolicConstant

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

matrixStorage: SymbolicConstant

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

solutionTechnique: SymbolicConstant

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: int

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

convertSDI: SymbolicConstant

utol: float

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

timePeriod: float

A Float specifying the total time period. The default value is 1.0.Note:This parameter is ignored unless timeIncrementationMethod=AUTOMATIC.

timeIncrementationMethod: SymbolicConstant

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

maxNumInc: int

An Int specifying the maximum number of increments in a step. The default value is 100.

initialInc: float

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: float

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: float

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: str

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

description: str

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

explicit: SymbolicConstant

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

perturbation: Boolean

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

nonmechanical: Boolean

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

procedureType: SymbolicConstant

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
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: Boolean

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

fieldOutputRequestState: dict[str, FieldOutputRequestState]

A repository of FieldOutputRequestState objects.

historyOutputRequestState: dict[str, HistoryOutputRequestState]

A repository of HistoryOutputRequestState objects.

diagnosticPrint: DiagnosticPrint

A DiagnosticPrint object.

monitor: Monitor

A Monitor object.

restart: Restart

A Restart object.

adaptiveMeshConstraintStates: dict[str, AdaptiveMeshConstraintState]

A repository of AdaptiveMeshConstraintState objects.

adaptiveMeshDomains: dict[str, AdaptiveMeshDomain]

A repository of AdaptiveMeshDomain objects.

control: Control

A Control object.

solverControl: SolverControl

A SolverControl object.

boundaryConditionStates: dict[str, BoundaryConditionState]

A repository of BoundaryConditionState objects.

interactionStates: int

A repository of InteractionState objects.

loadStates: dict[str, LoadState]

A repository of LoadState objects.

loadCases: dict[str, LoadCase]

A repository of LoadCase objects.

predefinedFieldStates: dict[str, PredefinedFieldState]

A repository of PredefinedFieldState objects.

Methods

setValues([description, nlgeom, ...])

This method modifies the GeostaticStep object.

setValues(description: str = '', nlgeom: BooleanType = 0, matrixSolver: SymbolicConstantType = 'DIRECT', matrixStorage: SymbolicConstantType = 'SOLVER_DEFAULT', solutionTechnique: SymbolicConstantType = 'FULL_NEWTON', reformKernel: int = 8, convertSDI: SymbolicConstantType = 'PROPAGATED', utol: float | None = None, timePeriod: float = 1, timeIncrementationMethod: SymbolicConstantType = 'AUTOMATIC', maxNumInc: int = 100, initialInc: float | None = None, minInc: float | None = None, maxInc: float | None = None)[source]#

This method modifies the GeostaticStep object.

Parameters:

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.
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.
maxNumInc: An Int specifying the maximum number of increments in a step. The default value is 100.
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.

Raises:

RangeError

HeatTransferStep#

class HeatTransferStep(name: str, previous: str, description: str = '', response: SymbolicConstantType = 'TRANSIENT', timePeriod: float = 1, timeIncrementationMethod: SymbolicConstantType = 'AUTOMATIC', maxNumInc: int = 100, initialInc: float | None = None, minInc: float | None = None, maxInc: float | None = None, end: float | None = None, deltmx: float = 0, mxdem: float = 0, amplitude: SymbolicConstantType = 'STEP', extrapolation: SymbolicConstantType = 'LINEAR', matrixSolver: SymbolicConstantType = 'DIRECT', matrixStorage: SymbolicConstantType = 'SOLVER_DEFAULT', maintainAttributes: BooleanType = False, solutionTechnique: SymbolicConstantType = 'FULL_NEWTON', reformKernel: int = 8, convertSDI: SymbolicConstantType = 'PROPAGATED')[source]#

The HeatTransferStep object is used to control uncoupled heat transfer for either transient or steady-state response. The HeatTransferStep object is derived from the AnalysisStep object.

Notes

This object can be accessed by:

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

The corresponding analysis keywords are:

HEAT TRANSFER
- STEP

Attributes:

name: str

A String specifying the repository key.

response: SymbolicConstant

A SymbolicConstant specifying the analysis type. Possible values are STEADY_STATE and TRANSIENT. The default value is TRANSIENT.

timePeriod: float

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

timeIncrementationMethod: SymbolicConstant

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

maxNumInc: int

An Int specifying the maximum number of increments in a step. The default value is 100.

initialInc: float

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

minInc: float

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

maxInc: float

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

end: float

None or a Float specifying the temperature change rate (temperature per time) used to define steady state. When all nodal temperatures are changing at less than this rate, the solution terminates. The default value is None.Note:This parameter is ignored unless response=STEADY_STATE.

deltmx: float

A Float specifying the maximum temperature change to be allowed in an increment during a transient heat transfer analysis. The default value is 0.0.

mxdem: float

A Float specifying the maximum allowable emissivity change with temperature and field variables during an increment. The default value is 0.1.

amplitude: SymbolicConstant

A SymbolicConstant specifying the amplitude variation for loading magnitudes during the step. The default is STEP. Possible values are STEP and RAMP.

extrapolation: SymbolicConstant

matrixSolver: SymbolicConstant

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

matrixStorage: SymbolicConstant

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

solutionTechnique: SymbolicConstant

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: int

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

convertSDI: SymbolicConstant

previous: str

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

description: str

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

explicit: SymbolicConstant

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

perturbation: Boolean

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

nonmechanical: Boolean

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

procedureType: str

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
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: Boolean

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

fieldOutputRequestState: dict[str, FieldOutputRequestState]

A repository of FieldOutputRequestState objects.

historyOutputRequestState: dict[str, HistoryOutputRequestState]

A repository of HistoryOutputRequestState objects.

diagnosticPrint: DiagnosticPrint

A DiagnosticPrint object.

monitor: Monitor

A Monitor object.

restart: Restart

A Restart object.

adaptiveMeshConstraintStates: dict[str, AdaptiveMeshConstraintState]

A repository of AdaptiveMeshConstraintState objects.

adaptiveMeshDomains: dict[str, AdaptiveMeshDomain]

A repository of AdaptiveMeshDomain objects.

control: Control

A Control object.

solverControl: SolverControl

A SolverControl object.

boundaryConditionStates: dict[str, BoundaryConditionState]

A repository of BoundaryConditionState objects.

interactionStates: int

A repository of InteractionState objects.

loadStates: dict[str, LoadState]

A repository of LoadState objects.

loadCases: dict[str, LoadCase]

A repository of LoadCase objects.

predefinedFieldStates: dict[str, PredefinedFieldState]

A repository of PredefinedFieldState objects.

Methods

setValues([description, response, ...])

This method modifies the HeatTransferStep object.

setValues(description: str = '', response: SymbolicConstantType = 'TRANSIENT', timePeriod: float = 1, timeIncrementationMethod: SymbolicConstantType = 'AUTOMATIC', maxNumInc: int = 100, initialInc: float | None = None, minInc: float | None = None, maxInc: float | None = None, end: float | None = None, deltmx: float = 0, mxdem: float = 0, amplitude: SymbolicConstantType = 'STEP', extrapolation: SymbolicConstantType = 'LINEAR', matrixSolver: SymbolicConstantType = 'DIRECT', matrixStorage: SymbolicConstantType = 'SOLVER_DEFAULT', solutionTechnique: SymbolicConstantType = 'FULL_NEWTON', reformKernel: int = 8, convertSDI: SymbolicConstantType = 'PROPAGATED')[source]#

This method modifies the HeatTransferStep object.

Parameters:

description: A String specifying a description of the new step. The default value is an empty string.
response: A SymbolicConstant specifying the analysis type. Possible values are STEADY_STATE and TRANSIENT. The default value is TRANSIENT.
timePeriod: A Float specifying the total time period. The default value is 1.0.
timeIncrementationMethod: A SymbolicConstant specifying the time incrementation method to be used. Possible values are FIXED and AUTOMATIC. The default value is AUTOMATIC.
maxNumInc: An Int specifying the maximum number of increments in a step. The default value is 100.
initialInc: A Float specifying the initial time increment. The default value is the total time period for the step.
minInc: A Float specifying the minimum time increment allowed. The default value is the smaller of 0.8 times the initial time increment or 10−5 times the total time period.
maxInc: A Float specifying the maximum time increment allowed. The default value is the total time period for the step.
end: None or a Float specifying the temperature change rate (temperature per time) used to define steady state. When all nodal temperatures are changing at less than this rate, the solution terminates. The default value is None.Note:This parameter is ignored unless *response*=STEADY_STATE.
deltmx: A Float specifying the maximum temperature change to be allowed in an increment during a transient heat transfer analysis. The default value is 0.0.
mxdem: A Float specifying the maximum allowable emissivity change with temperature and field variables during an increment. The default value is 0.1.
amplitude: A SymbolicConstant specifying the amplitude variation for loading magnitudes during the step. The default is STEP. Possible values are STEP and RAMP.
extrapolation: A SymbolicConstant specifying the type of extrapolation to use in determining the incremental solution for a nonlinear analysis. Possible values are NONE, LINEAR, and PARABOLIC. The default value is LINEAR.
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.

Raises:

RangeError

ImplicitDynamicsStep#

class ImplicitDynamicsStep(name: str, previous: str, description: str = '', timePeriod: float = 1, nlgeom: BooleanType = 0, matrixStorage: SymbolicConstantType = 'SOLVER_DEFAULT', application: SymbolicConstantType = 'ANALYSIS_PRODUCT_DEFAULT', adiabatic: BooleanType = 0, timeIncrementationMethod: SymbolicConstantType = 'AUTOMATIC', maxNumInc: int = 100, initialInc: float | None = None, minInc: float | None = None, maxInc: SymbolicConstantType | float = 'DEFAULT', hafTolMethod: SymbolicConstantType = 'VALUE', haftol: float | None = None, halfIncScaleFactor: float | None = None, nohaf: BooleanType = 0, amplitude: SymbolicConstantType = 'STEP', alpha: SymbolicConstantType | float = 'DEFAULT', initialConditions: SymbolicConstantType = 'DEFAULT', extrapolation: SymbolicConstantType = 'ANALYSIS_PRODUCT_DEFAULT', noStop: BooleanType = 0, maintainAttributes: BooleanType = False, solutionTechnique: SymbolicConstantType = 'FULL_NEWTON', reformKernel: int = 8, convertSDI: SymbolicConstantType = 'PROPAGATED')[source]#

The ImplicitDynamicsStep object is used to provide direct integration of a dynamic stress/displacement response in Abaqus/Standard analyses and is generally used for nonlinear cases. The ImplicitDynamicsStep object is derived from the AnalysisStep object.

Notes

This object can be accessed by:

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

The corresponding analysis keywords are:

DYNAMIC
- STEP

Attributes:

name: str

A String specifying the repository key.

timePeriod: float

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

nlgeom: Boolean

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

matrixStorage: SymbolicConstant

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

application: SymbolicConstant

A SymbolicConstant specifying the application type of the step. Possible values are ANALYSIS_PRODUCT_DEFAULT, TRANSIENT_FIDELITY, MODERATE_DISSIPATION, and QUASI_STATIC. The default value is ANALYSIS_PRODUCT_DEFAULT.

adiabatic: Boolean

A Boolean specifying whether an adiabatic stress analysis is to be performed. The default value is OFF.

timeIncrementationMethod: SymbolicConstant

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

maxNumInc: int

An Int specifying the maximum number of increments in a step. The default value is 100.

initialInc: float

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

minInc: float

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.

maxInc: typing.Union[SymbolicConstant, float]

The SymbolicConstant DEFAULT or a Float specifying the maximum time increment allowed.

hafTolMethod: SymbolicConstant

A SymbolicConstant specifying the way of specifying half-increment residual tolerance with the automatic time incrementation scheme. Possible values are ANALYSIS_PRODUCT_DEFAULT, VALUE, and SCALE. The default value is VALUE.

haftol: float

None or a Float specifying the half-increment residual tolerance to be used with the automatic time incrementation scheme. The default value is None.

halfIncScaleFactor: float

None or a Float specifying the half-increment residual tolerance scale factor to be used with the automatic time incrementation scheme. The default value is None.

nohaf: Boolean

A Boolean specifying whether to suppress calculation of the half-increment residual. The default value is OFF.

amplitude: SymbolicConstant

A SymbolicConstant specifying the amplitude variation for loading magnitudes during the step. Possible values are STEP and RAMP. The default value is STEP.

alpha: typing.Union[SymbolicConstant, float]

The SymbolicConstant DEFAULT or a Float specifying the nondefault value of the numerical (artificial) damping control parameter, αα, in the implicit operator. Possible values are −.333 <α<<α< 0. The default value is DEFAULT.

initialConditions: SymbolicConstant

A SymbolicConstant specifying whether accelerations should be calculated or recalculated at the beginning of the step. Possible values are DEFAULT, BYPASS, and ALLOW. The default value is DEFAULT.

extrapolation: SymbolicConstant

A SymbolicConstant specifying the type of extrapolation to use in determining the incremental solution for a nonlinear analysis. Possible values are NONE, LINEAR, PARABOLIC, VELOCITY_PARABOLIC, and ANALYSIS_PRODUCT_DEFAULT. The default value is ANALYSIS_PRODUCT_DEFAULT.

noStop: Boolean

A Boolean specifying whether to accept the solution to an increment after the maximum number of iterations allowed have been completed, even if the equilibrium tolerances are not satisfied. The default value is OFF.Warning:You should set noStop=OFF only in special cases when you have a thorough understanding of how to interpret the results.

solutionTechnique: SymbolicConstant

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: int

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

convertSDI: SymbolicConstant

previous: str

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

description: str

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

explicit: SymbolicConstant

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

perturbation: Boolean

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

nonmechanical: Boolean

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

procedureType: SymbolicConstant

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
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: Boolean

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

fieldOutputRequestState: dict[str, FieldOutputRequestState]

A repository of FieldOutputRequestState objects.

historyOutputRequestState: dict[str, HistoryOutputRequestState]

A repository of HistoryOutputRequestState objects.

diagnosticPrint: DiagnosticPrint

A DiagnosticPrint object.

monitor: Monitor

A Monitor object.

restart: Restart

A Restart object.

adaptiveMeshConstraintStates: dict[str, AdaptiveMeshConstraintState]

A repository of AdaptiveMeshConstraintState objects.

adaptiveMeshDomains: dict[str, AdaptiveMeshDomain]

A repository of AdaptiveMeshDomain objects.

control: Control

A Control object.

solverControl: SolverControl

A SolverControl object.

boundaryConditionStates: dict[str, BoundaryConditionState]

A repository of BoundaryConditionState objects.

interactionStates: int

A repository of InteractionState objects.

loadStates: dict[str, LoadState]

A repository of LoadState objects.

loadCases: dict[str, LoadCase]

A repository of LoadCase objects.

predefinedFieldStates: dict[str, PredefinedFieldState]

A repository of PredefinedFieldState objects.

Methods

setValues([description, timePeriod, nlgeom, ...])

This method modifies the ImplicitDynamicsStep object.

setValues(description: str = '', timePeriod: float = 1, nlgeom: BooleanType = 0, matrixStorage: SymbolicConstantType = 'SOLVER_DEFAULT', application: SymbolicConstantType = 'ANALYSIS_PRODUCT_DEFAULT', adiabatic: BooleanType = 0, timeIncrementationMethod: SymbolicConstantType = 'AUTOMATIC', maxNumInc: int = 100, initialInc: float | None = None, minInc: float | None = None, maxInc: SymbolicConstantType | float = 'DEFAULT', hafTolMethod: SymbolicConstantType = 'VALUE', haftol: float | None = None, halfIncScaleFactor: float | None = None, nohaf: BooleanType = 0, amplitude: SymbolicConstantType = 'STEP', alpha: SymbolicConstantType | float = 'DEFAULT', initialConditions: SymbolicConstantType = 'DEFAULT', extrapolation: SymbolicConstantType = 'ANALYSIS_PRODUCT_DEFAULT', noStop: BooleanType = 0, solutionTechnique: SymbolicConstantType = 'FULL_NEWTON', reformKernel: int = 8, convertSDI: SymbolicConstantType = 'PROPAGATED')[source]#

This method modifies the ImplicitDynamicsStep object.

Parameters:

description: A String specifying a description of the new step. The default value is an empty string.
timePeriod: A Float specifying the total time period of the step. The default value is 1.0.
nlgeom: A Boolean specifying whether geometric nonlinearities should be accounted for during the step. The default value is based on the previous step.
matrixStorage: A SymbolicConstant specifying the type of matrix storage. Possible values are SYMMETRIC, UNSYMMETRIC, and SOLVER_DEFAULT. The default value is SOLVER_DEFAULT.
application: A SymbolicConstant specifying the application type of the step. Possible values are ANALYSIS_PRODUCT_DEFAULT, TRANSIENT_FIDELITY, MODERATE_DISSIPATION, and QUASI_STATIC. The default value is ANALYSIS_PRODUCT_DEFAULT.
adiabatic: A Boolean specifying whether an adiabatic stress analysis is to be performed. The default value is OFF.
timeIncrementationMethod: A SymbolicConstant specifying the time incrementation method to be used. Possible values are FIXED and AUTOMATIC. The default value is AUTOMATIC.
maxNumInc: An Int specifying the maximum number of increments in a step. The default value is 100.
initialInc: A Float specifying the initial time increment. The default value is the total time period for the step.
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.
maxInc: The SymbolicConstant DEFAULT or a Float specifying the maximum time increment allowed.
hafTolMethod: A SymbolicConstant specifying the way of specifying half-increment residual tolerance with the automatic time incrementation scheme. Possible values are ANALYSIS_PRODUCT_DEFAULT, VALUE, and SCALE. The default value is VALUE.
haftol: None or a Float specifying the half-increment residual tolerance to be used with the automatic time incrementation scheme. The default value is None.
halfIncScaleFactor: None or a Float specifying the half-increment residual tolerance scale factor to be used with the automatic time incrementation scheme. The default value is None.
nohaf: A Boolean specifying whether to suppress calculation of the half-increment residual. The default value is OFF.
amplitude: A SymbolicConstant specifying the amplitude variation for loading magnitudes during the step. Possible values are STEP and RAMP. The default value is STEP.
alpha: The SymbolicConstant DEFAULT or a Float specifying the nondefault value of the numerical (artificial) damping control parameter, αα, in the implicit operator. Possible values are −.333 <α<<α< 0. The default value is DEFAULT.
initialConditions: A SymbolicConstant specifying whether accelerations should be calculated or recalculated at the beginning of the step. Possible values are DEFAULT, BYPASS, and ALLOW. The default value is DEFAULT.
extrapolation: A SymbolicConstant specifying the type of extrapolation to use in determining the incremental solution for a nonlinear analysis. Possible values are NONE, LINEAR, PARABOLIC, VELOCITY_PARABOLIC, and ANALYSIS_PRODUCT_DEFAULT. The default value is ANALYSIS_PRODUCT_DEFAULT.
noStop: A Boolean specifying whether to accept the solution to an increment after the maximum number of iterations allowed have been completed, even if the equilibrium tolerances are not satisfied. The default value is OFF.Warning:You should set *noStop*=OFF only in special cases when you have a thorough understanding of how to interpret the results.
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.

Raises:

RangeError

InitialStep#

class InitialStep[source]#

The InitialStep object is a placeholder that you cannot create, delete, or modify. The InitialStep object exists in every model by default and is used to allow the preexisting boundary conditions and interactions to be defined in the model. The InitialStep object is derived from the AnalysisStep object.

Notes

This object can be accessed by:

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

Attributes:

name: str

A String specifying the repository key.

explicit: SymbolicConstant

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

perturbation: Boolean

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

nonmechanical: Boolean

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

procedureType: SymbolicConstant

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
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: Boolean

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

fieldOutputRequestState: dict[str, FieldOutputRequestState]

A repository of FieldOutputRequestState objects.

historyOutputRequestState: dict[str, HistoryOutputRequestState]

A repository of HistoryOutputRequestState objects.

diagnosticPrint: DiagnosticPrint

A DiagnosticPrint object.

monitor: Monitor

A Monitor object.

restart: Restart

A Restart object.

adaptiveMeshConstraintStates: dict[str, AdaptiveMeshConstraintState]

A repository of AdaptiveMeshConstraintState objects.

adaptiveMeshDomains: dict[str, AdaptiveMeshDomain]

A repository of AdaptiveMeshDomain objects.

control: Control

A Control object.

solverControl: SolverControl

A SolverControl object.

boundaryConditionStates: dict[str, BoundaryConditionState]

A repository of BoundaryConditionState objects.

interactionStates: int

A repository of InteractionState objects.

loadStates: dict[str, LoadState]

A repository of LoadState objects.

loadCases: dict[str, LoadCase]

A repository of LoadCase objects.

predefinedFieldStates: dict[str, PredefinedFieldState]

A repository of PredefinedFieldState objects.

MassDiffusionStep#

class MassDiffusionStep(name: str, previous: str, description: str = '', response: SymbolicConstantType = 'TRANSIENT', timePeriod: float = 1, timeIncrementationMethod: SymbolicConstantType = 'AUTOMATIC', maxNumInc: int = 100, initialInc: float | None = None, minInc: float | None = None, maxInc: float | None = None, end: SymbolicConstantType = 'PERIOD', dcmax: float = 0, amplitude: SymbolicConstantType = 'STEP', extrapolation: SymbolicConstantType = 'LINEAR', maintainAttributes: BooleanType = False, convertSDI: SymbolicConstantType = 'PROPAGATED')[source]#

The MassDiffusionStep object is used to control uncoupled transient or steady-state mass diffusion analysis. The MassDiffusionStep object is derived from the AnalysisStep object.

Notes

This object can be accessed by:

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

The corresponding analysis keywords are:

MASS DIFFUSION
- STEP

Attributes:

name: str

A String specifying the repository key.

response: SymbolicConstant

A SymbolicConstant specifying the analysis type. Possible values are STEADY_STATE and TRANSIENT. The default value is TRANSIENT.

timePeriod: float

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

timeIncrementationMethod: SymbolicConstant

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

maxNumInc: int

An Int specifying the maximum number of increments in a step. The default value is 100.

initialInc: float

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

minInc: float

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

maxInc: float

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

end: SymbolicConstant

A SymbolicConstant specifying the time period to be analyzed in a transient analysis. Possible values are PERIOD and SS. The default value is PERIOD.

dcmax: float

A Float specifying the maximum normalized concentration change to be allowed in an increment. The default value is 0.0.

amplitude: SymbolicConstant

A SymbolicConstant specifying the amplitude variation for loading magnitudes during the step. The default is STEP. Possible values are STEP and RAMP.

extrapolation: SymbolicConstant

convertSDI: SymbolicConstant

previous: str

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

description: str

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

explicit: SymbolicConstant

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

perturbation: Boolean

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

nonmechanical: Boolean

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

procedureType: SymbolicConstant

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
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: Boolean

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

fieldOutputRequestState: dict[str, FieldOutputRequestState]

A repository of FieldOutputRequestState objects.

historyOutputRequestState: dict[str, HistoryOutputRequestState]

A repository of HistoryOutputRequestState objects.

diagnosticPrint: DiagnosticPrint

A DiagnosticPrint object.

monitor: Monitor

A Monitor object.

restart: Restart

A Restart object.

adaptiveMeshConstraintStates: dict[str, AdaptiveMeshConstraintState]

A repository of AdaptiveMeshConstraintState objects.

adaptiveMeshDomains: dict[str, AdaptiveMeshDomain]

A repository of AdaptiveMeshDomain objects.

control: Control

A Control object.

solverControl: SolverControl

A SolverControl object.

boundaryConditionStates: dict[str, BoundaryConditionState]

A repository of BoundaryConditionState objects.

interactionStates: int

A repository of InteractionState objects.

loadStates: dict[str, LoadState]

A repository of LoadState objects.

loadCases: dict[str, LoadCase]

A repository of LoadCase objects.

predefinedFieldStates: dict[str, PredefinedFieldState]

A repository of PredefinedFieldState objects.

Methods

setValues([description, response, ...])

This method modifies the MassDiffusionStep object.

setValues(description: str = '', response: SymbolicConstantType = 'TRANSIENT', timePeriod: float = 1, timeIncrementationMethod: SymbolicConstantType = 'AUTOMATIC', maxNumInc: int = 100, initialInc: float | None = None, minInc: float | None = None, maxInc: float | None = None, end: SymbolicConstantType = 'PERIOD', dcmax: float = 0, amplitude: SymbolicConstantType = 'STEP', extrapolation: SymbolicConstantType = 'LINEAR', convertSDI: SymbolicConstantType = 'PROPAGATED')[source]#

This method modifies the MassDiffusionStep object.

Parameters:

description: A String specifying a description of the new step. The default value is an empty string.
response: A SymbolicConstant specifying the analysis type. Possible values are STEADY_STATE and TRANSIENT. The default value is TRANSIENT.
timePeriod: A Float specifying the total time period. The default value is 1.0.
timeIncrementationMethod: A SymbolicConstant specifying the time incrementation method to be used. Possible values are FIXED and AUTOMATIC. The default value is AUTOMATIC.
maxNumInc: An Int specifying the maximum number of increments in a step. The default value is 100.
initialInc: A Float specifying the initial time increment. The default value is the total time period for the step.
minInc: A Float specifying the minimum time increment allowed. The default value is the smaller of 0.8 times the initial time increment or 10−5 times the total time period.
maxInc: A Float specifying the maximum time increment allowed. The default value is the total time period for the step.
end: A SymbolicConstant specifying the time period to be analyzed in a transient analysis. Possible values are PERIOD and SS. The default value is PERIOD.
dcmax: A Float specifying the maximum normalized concentration change to be allowed in an increment. The default value is 0.0.
amplitude: A SymbolicConstant specifying the amplitude variation for loading magnitudes during the step. The default is STEP. Possible values are STEP and RAMP.
extrapolation: A SymbolicConstant specifying the type of extrapolation to use in determining the incremental solution for a nonlinear analysis. Possible values are NONE, LINEAR, and PARABOLIC. The default value is LINEAR.
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.

Raises:

RangeError

ModalDynamicsStep#

class ModalDynamicsStep(name: str, previous: str, description: str = '', continueAnalysis: ~abaqusConstants.BooleanType = 0, timePeriod: float = 1, incSize: float = 1, directDamping: ~abaqus.StepMiscellaneous.DirectDamping.DirectDamping = <abaqus.StepMiscellaneous.DirectDamping.DirectDamping object>, compositeDamping: ~abaqus.StepMiscellaneous.CompositeDamping.CompositeDamping = <abaqus.StepMiscellaneous.CompositeDamping.CompositeDamping object>, rayleighDamping: ~abaqus.StepMiscellaneous.RayleighDamping.RayleighDamping = <abaqus.StepMiscellaneous.RayleighDamping.RayleighDamping object>, amplitude: ~abaqusConstants.SymbolicConstantType = 'STEP', maintainAttributes: ~abaqusConstants.BooleanType = False, directDampingByFrequency: ~abaqus.StepMiscellaneous.DirectDampingByFrequency.DirectDampingByFrequency = <abaqus.StepMiscellaneous.DirectDampingByFrequency.DirectDampingByFrequency object>, rayleighDampingByFrequency: ~abaqus.StepMiscellaneous.RayleighDampingByFrequency.RayleighDampingByFrequency = <abaqus.StepMiscellaneous.RayleighDampingByFrequency.RayleighDampingByFrequency object>)[source]#

The ModalDynamicsStep object is used to provide dynamic time history response as a linear perturbation procedure using modal superposition. The ModalDynamicsStep object is derived from the AnalysisStep object.

Notes

This object can be accessed by:

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

The corresponding analysis keywords are:

DAMPING
- MODAL DAMPING
- MODAL DYNAMIC
- STEP

Attributes:

name: str

A String specifying the repository key.

continueAnalysis: Boolean

A Boolean specifying that the step starts with zero initial conditions. The default value is OFF.

timePeriod: float

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

incSize: float

A Float specifying the time increment to be used. The default value is 1.0.

amplitude: SymbolicConstant

A SymbolicConstant specifying the amplitude variation for loading magnitudes during the step. Possible values are STEP and RAMP. The default value is STEP.

previous: str

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

description: str

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

directDamping: DirectDamping

A DirectDamping object.

compositeDamping: CompositeDamping

A CompositeDamping object.

rayleighDamping: RayleighDamping

A RayleighDamping object.

directDampingByFrequency: DirectDampingByFrequency

A DirectDampingByFrequency object.

rayleighDampingByFrequency: RayleighDampingByFrequency

A RayleighDampingByFrequency object.

explicit: SymbolicConstant

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

perturbation: Boolean

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

nonmechanical: Boolean

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

procedureType: SymbolicConstant

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
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: Boolean

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

fieldOutputRequestState: dict[str, FieldOutputRequestState]

A repository of FieldOutputRequestState objects.

historyOutputRequestState: dict[str, HistoryOutputRequestState]

A repository of HistoryOutputRequestState objects.

diagnosticPrint: DiagnosticPrint

A DiagnosticPrint object.

monitor: Monitor

A Monitor object.

restart: Restart

A Restart object.

adaptiveMeshConstraintStates: dict[str, AdaptiveMeshConstraintState]

A repository of AdaptiveMeshConstraintState objects.

adaptiveMeshDomains: dict[str, AdaptiveMeshDomain]

A repository of AdaptiveMeshDomain objects.

control: Control

A Control object.

solverControl: SolverControl

A SolverControl object.

boundaryConditionStates: dict[str, BoundaryConditionState]

A repository of BoundaryConditionState objects.

interactionStates: int

A repository of InteractionState objects.

loadStates: dict[str, LoadState]

A repository of LoadState objects.

loadCases: dict[str, LoadCase]

A repository of LoadCase objects.

predefinedFieldStates: dict[str, PredefinedFieldState]

A repository of PredefinedFieldState objects.

Methods

setValues([description, continueAnalysis, ...])

This method modifies the ModalDynamicsStep object.

setValues(description: str = '', continueAnalysis: ~abaqusConstants.BooleanType = 0, timePeriod: float = 1, incSize: float = 1, directDamping: ~abaqus.StepMiscellaneous.DirectDamping.DirectDamping = <abaqus.StepMiscellaneous.DirectDamping.DirectDamping object>, compositeDamping: ~abaqus.StepMiscellaneous.CompositeDamping.CompositeDamping = <abaqus.StepMiscellaneous.CompositeDamping.CompositeDamping object>, rayleighDamping: ~abaqus.StepMiscellaneous.RayleighDamping.RayleighDamping = <abaqus.StepMiscellaneous.RayleighDamping.RayleighDamping object>, amplitude: ~abaqusConstants.SymbolicConstantType = 'STEP', directDampingByFrequency: ~abaqus.StepMiscellaneous.DirectDampingByFrequency.DirectDampingByFrequency = <abaqus.StepMiscellaneous.DirectDampingByFrequency.DirectDampingByFrequency object>, rayleighDampingByFrequency: ~abaqus.StepMiscellaneous.RayleighDampingByFrequency.RayleighDampingByFrequency = <abaqus.StepMiscellaneous.RayleighDampingByFrequency.RayleighDampingByFrequency object>)[source]#

This method modifies the ModalDynamicsStep object.

Parameters:

description: A String specifying a description of the new step. The default value is an empty string.
continueAnalysis: A Boolean specifying that the step starts with zero initial conditions. The default value is OFF.
timePeriod: A Float specifying the total time period. The default value is 1.0.
incSize: A Float specifying the time increment to be used. The default value is 1.0.
directDamping: A DirectDamping object.
compositeDamping: A CompositeDamping object.
rayleighDamping: A RayleighDamping object.
amplitude: A SymbolicConstant specifying the amplitude variation for loading magnitudes during the step. Possible values are STEP and RAMP. The default value is STEP.
directDampingByFrequency: A DirectDampingByFrequency object.
rayleighDampingByFrequency: A RayleighDampingByFrequency object.

Raises:

RangeError

RandomResponseStep#

class RandomResponseStep(name: str, previous: str, freq: ~abaqus.StepMiscellaneous.RandomResponseFrequencyArray.RandomResponseFrequencyArray, description: str = '', scale: ~abaqusConstants.SymbolicConstantType = 'LOG', directDamping: ~abaqus.StepMiscellaneous.DirectDamping.DirectDamping = <abaqus.StepMiscellaneous.DirectDamping.DirectDamping object>, compositeDamping: ~abaqus.StepMiscellaneous.CompositeDamping.CompositeDamping = <abaqus.StepMiscellaneous.CompositeDamping.CompositeDamping object>, rayleighDamping: ~abaqus.StepMiscellaneous.RayleighDamping.RayleighDamping = <abaqus.StepMiscellaneous.RayleighDamping.RayleighDamping object>, structuralDamping: ~abaqus.StepMiscellaneous.StructuralDamping.StructuralDamping = <abaqus.StepMiscellaneous.StructuralDamping.StructuralDamping object>, directDampingByFrequency: ~abaqus.StepMiscellaneous.DirectDampingByFrequency.DirectDampingByFrequency = <abaqus.StepMiscellaneous.DirectDampingByFrequency.DirectDampingByFrequency object>, rayleighDampingByFrequency: ~abaqus.StepMiscellaneous.RayleighDampingByFrequency.RayleighDampingByFrequency = <abaqus.StepMiscellaneous.RayleighDampingByFrequency.RayleighDampingByFrequency object>, structuralDampingByFrequency: ~abaqus.StepMiscellaneous.StructuralDampingByFrequency.StructuralDampingByFrequency = <abaqus.StepMiscellaneous.StructuralDampingByFrequency.StructuralDampingByFrequency object>, maintainAttributes: ~abaqusConstants.BooleanType = False)[source]#

The RandomResponseStep object is used to give the linearized response of a model to random excitation. The RandomResponseStep object is derived from the AnalysisStep object.

Notes

This object can be accessed by:

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

The corresponding analysis keywords are:

DAMPING
- MODAL DAMPING
- RANDOM RESPONSE
- STEP

Attributes:

name: str

A String specifying the repository key.

scale: SymbolicConstant

A SymbolicConstant specifying the frequency scale. Possible values are LINEAR and LOG. The default value is LOG.

previous: str

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

description: str

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

freq: RandomResponseFrequencyArray

A RandomResponseFrequencyArray object specifying frequencies over ranges of modes.

directDamping: DirectDamping

A DirectDamping object.

compositeDamping: CompositeDamping

A CompositeDamping object.

rayleighDamping: RayleighDamping

A RayleighDamping object.

structuralDamping: StructuralDamping

A StructuralDamping object.

directDampingByFrequency: DirectDampingByFrequency

A DirectDampingByFrequency object.

rayleighDampingByFrequency: RayleighDampingByFrequency

A RayleighDampingByFrequency object.

structuralDampingByFrequency: StructuralDampingByFrequency

A StructuralDampingByFrequency object.

explicit: SymbolicConstant

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

perturbation: Boolean

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

nonmechanical: Boolean

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

procedureType: SymbolicConstant

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
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: Boolean

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

fieldOutputRequestState: dict[str, FieldOutputRequestState]

A repository of FieldOutputRequestState objects.

historyOutputRequestState: dict[str, HistoryOutputRequestState]

A repository of HistoryOutputRequestState objects.

diagnosticPrint: DiagnosticPrint

A DiagnosticPrint object.

monitor: Monitor

A Monitor object.

restart: Restart

A Restart object.

adaptiveMeshConstraintStates: dict[str, AdaptiveMeshConstraintState]

A repository of AdaptiveMeshConstraintState objects.

adaptiveMeshDomains: dict[str, AdaptiveMeshDomain]

A repository of AdaptiveMeshDomain objects.

control: Control

A Control object.

solverControl: SolverControl

A SolverControl object.

boundaryConditionStates: dict[str, BoundaryConditionState]

A repository of BoundaryConditionState objects.

interactionStates: int

A repository of InteractionState objects.

loadStates: dict[str, LoadState]

A repository of LoadState objects.

loadCases: dict[str, LoadCase]

A repository of LoadCase objects.

predefinedFieldStates: dict[str, PredefinedFieldState]

A repository of PredefinedFieldState objects.

Methods

setValues([description, scale, ...])

This method modifies the RandomResponseStep object.

setValues(description: str = '', scale: ~abaqusConstants.SymbolicConstantType = 'LOG', directDamping: ~abaqus.StepMiscellaneous.DirectDamping.DirectDamping = <abaqus.StepMiscellaneous.DirectDamping.DirectDamping object>, compositeDamping: ~abaqus.StepMiscellaneous.CompositeDamping.CompositeDamping = <abaqus.StepMiscellaneous.CompositeDamping.CompositeDamping object>, rayleighDamping: ~abaqus.StepMiscellaneous.RayleighDamping.RayleighDamping = <abaqus.StepMiscellaneous.RayleighDamping.RayleighDamping object>, structuralDamping: ~abaqus.StepMiscellaneous.StructuralDamping.StructuralDamping = <abaqus.StepMiscellaneous.StructuralDamping.StructuralDamping object>, directDampingByFrequency: ~abaqus.StepMiscellaneous.DirectDampingByFrequency.DirectDampingByFrequency = <abaqus.StepMiscellaneous.DirectDampingByFrequency.DirectDampingByFrequency object>, rayleighDampingByFrequency: ~abaqus.StepMiscellaneous.RayleighDampingByFrequency.RayleighDampingByFrequency = <abaqus.StepMiscellaneous.RayleighDampingByFrequency.RayleighDampingByFrequency object>, structuralDampingByFrequency: ~abaqus.StepMiscellaneous.StructuralDampingByFrequency.StructuralDampingByFrequency = <abaqus.StepMiscellaneous.StructuralDampingByFrequency.StructuralDampingByFrequency object>)[source]#

This method modifies the RandomResponseStep object.

Parameters:

description: A String specifying a description of the new step. The default value is an empty string.
scale: A SymbolicConstant specifying the frequency scale. Possible values are LINEAR and LOG. The default value is LOG.
directDamping: A DirectDamping object.
compositeDamping: A CompositeDamping object.
rayleighDamping: A RayleighDamping object.
structuralDamping: A StructuralDamping object.
directDampingByFrequency: A DirectDampingByFrequency object.
rayleighDampingByFrequency: A RayleighDampingByFrequency object.
structuralDampingByFrequency: A StructuralDampingByFrequency object.

Raises:

RangeError

ResponseSpectrumStep#

class ResponseSpectrumStep(name: str, previous: str, components: ~abaqus.StepMiscellaneous.ResponseSpectrumComponentArray.ResponseSpectrumComponentArray, description: str = '', comp: ~abaqusConstants.SymbolicConstantType = 'SINGLE_DIRECTION', sum: ~abaqusConstants.SymbolicConstantType = 'ABS', directDamping: ~abaqus.StepMiscellaneous.DirectDamping.DirectDamping = <abaqus.StepMiscellaneous.DirectDamping.DirectDamping object>, compositeDamping: ~abaqus.StepMiscellaneous.CompositeDamping.CompositeDamping = <abaqus.StepMiscellaneous.CompositeDamping.CompositeDamping object>, rayleighDamping: ~abaqus.StepMiscellaneous.RayleighDamping.RayleighDamping = <abaqus.StepMiscellaneous.RayleighDamping.RayleighDamping object>, directDampingByFrequency: ~abaqus.StepMiscellaneous.DirectDampingByFrequency.DirectDampingByFrequency = <abaqus.StepMiscellaneous.DirectDampingByFrequency.DirectDampingByFrequency object>, rayleighDampingByFrequency: ~abaqus.StepMiscellaneous.RayleighDampingByFrequency.RayleighDampingByFrequency = <abaqus.StepMiscellaneous.RayleighDampingByFrequency.RayleighDampingByFrequency object>, maintainAttributes: ~abaqusConstants.BooleanType = False)[source]#

The ResponseSpectrumStep object is used to calculate estimates of peak values of displacements and stresses based on user-supplied response spectra and on the natural modes of the system. The ResponseSpectrumStep object is derived from the AnalysisStep object.

Notes

This object can be accessed by:

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

The corresponding analysis keywords are:

RESPONSE SPECTRUM
- STEP

Attributes:

name: str

A String specifying the repository key.

comp: SymbolicConstant

A SymbolicConstant specifying the order and method used to sum the components. Possible values are SINGLE_DIRECTION, MULTIPLE_DIRECTION_ABSOLUTE_SUM, MULTIPLE_DIRECTION_SRSS_SUM, MULTIPLE_DIRECTION_THIRTY_PERCENT_RULE, and MULTIPLE_DIRECTION_FORTY_PERCENT_RULE. The default value is SINGLE_DIRECTION.

sum: SymbolicConstant

A SymbolicConstant specifying the method used to sum the components. Possible values are ABS, CQC, NRL, SRSS, TENP, DSC, and GRP. The default value is ABS.

previous: str

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

description: str

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

components: ResponseSpectrumComponentArray

A ResponseSpectrumComponentArray object.

directDamping: DirectDamping

A DirectDamping object.

compositeDamping: CompositeDamping

A CompositeDamping object.

rayleighDamping: RayleighDamping

A RayleighDamping object.

directDampingByFrequency: DirectDampingByFrequency

A DirectDampingByFrequency object.

rayleighDampingByFrequency: RayleighDampingByFrequency

A RayleighDampingByFrequency object.

structuralDamping: StructuralDamping

A StructuralDamping object.

structuralDampingByFrequency: StructuralDampingByFrequency

A StructuralDampingByFrequency object.

explicit: SymbolicConstant

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

perturbation: Boolean

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

nonmechanical: Boolean

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

procedureType: SymbolicConstant

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
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: Boolean

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

fieldOutputRequestState: dict[str, FieldOutputRequestState]

A repository of FieldOutputRequestState objects.

historyOutputRequestState: dict[str, HistoryOutputRequestState]

A repository of HistoryOutputRequestState objects.

diagnosticPrint: DiagnosticPrint

A DiagnosticPrint object.

monitor: Monitor

A Monitor object.

restart: Restart

A Restart object.

adaptiveMeshConstraintStates: dict[str, AdaptiveMeshConstraintState]

A repository of AdaptiveMeshConstraintState objects.

adaptiveMeshDomains: dict[str, AdaptiveMeshDomain]

A repository of AdaptiveMeshDomain objects.

control: Control

A Control object.

solverControl: SolverControl

A SolverControl object.

boundaryConditionStates: dict[str, BoundaryConditionState]

A repository of BoundaryConditionState objects.

interactionStates: int

A repository of InteractionState objects.

loadStates: dict[str, LoadState]

A repository of LoadState objects.

loadCases: dict[str, LoadCase]

A repository of LoadCase objects.

predefinedFieldStates: dict[str, PredefinedFieldState]

A repository of PredefinedFieldState objects.

Methods

setValues([description, comp, sum, ...])

This method modifies the ResponseSpectrumStep object.

setValues(description: str = '', comp: ~abaqusConstants.SymbolicConstantType = 'SINGLE_DIRECTION', sum: ~abaqusConstants.SymbolicConstantType = 'ABS', directDamping: ~abaqus.StepMiscellaneous.DirectDamping.DirectDamping = <abaqus.StepMiscellaneous.DirectDamping.DirectDamping object>, compositeDamping: ~abaqus.StepMiscellaneous.CompositeDamping.CompositeDamping = <abaqus.StepMiscellaneous.CompositeDamping.CompositeDamping object>, rayleighDamping: ~abaqus.StepMiscellaneous.RayleighDamping.RayleighDamping = <abaqus.StepMiscellaneous.RayleighDamping.RayleighDamping object>, directDampingByFrequency: ~abaqus.StepMiscellaneous.DirectDampingByFrequency.DirectDampingByFrequency = <abaqus.StepMiscellaneous.DirectDampingByFrequency.DirectDampingByFrequency object>, rayleighDampingByFrequency: ~abaqus.StepMiscellaneous.RayleighDampingByFrequency.RayleighDampingByFrequency = <abaqus.StepMiscellaneous.RayleighDampingByFrequency.RayleighDampingByFrequency object>)[source]#

This method modifies the ResponseSpectrumStep object.

Parameters:

description: A String specifying a description of the new step. The default value is an empty string.
comp: A SymbolicConstant specifying the order and method used to sum the components. Possible values are SINGLE_DIRECTION, MULTIPLE_DIRECTION_ABSOLUTE_SUM, MULTIPLE_DIRECTION_SRSS_SUM, MULTIPLE_DIRECTION_THIRTY_PERCENT_RULE, and MULTIPLE_DIRECTION_FORTY_PERCENT_RULE. The default value is SINGLE_DIRECTION.
sum: A SymbolicConstant specifying the method used to sum the components. Possible values are ABS, CQC, NRL, SRSS, TENP, DSC, and GRP. The default value is ABS.
directDamping: A DirectDamping object.
compositeDamping: A CompositeDamping object.
rayleighDamping: A RayleighDamping object.
directDampingByFrequency: A DirectDampingByFrequency object.
rayleighDampingByFrequency: A RayleighDampingByFrequency object.

Raises:

RangeError

SoilsStep#

class SoilsStep(name: str, previous: str, description: str = '', response: SymbolicConstantType = 'TRANSIENT', timePeriod: float = 1, nlgeom: BooleanType = 0, stabilizationMethod: SymbolicConstantType = 'NONE', stabilizationMagnitude: float | None = None, creep: BooleanType = 1, timeIncrementationMethod: SymbolicConstantType = 'AUTOMATIC', initialInc: float | None = None, minInc: float | None = None, maxInc: float | None = None, maxNumInc: int = 100, end: SymbolicConstantType = 'PERIOD', utol: float | None = None, cetol: float = 0, amplitude: SymbolicConstantType = 'STEP', extrapolation: SymbolicConstantType = 'LINEAR', matrixSolver: SymbolicConstantType = 'DIRECT', matrixStorage: SymbolicConstantType = 'SOLVER_DEFAULT', maintainAttributes: BooleanType = False, solutionTechnique: SymbolicConstantType = 'FULL_NEWTON', reformKernel: int = 8, convertSDI: SymbolicConstantType = 'PROPAGATED', adaptiveDampingRatio: float = 0, continueDampingFactors: BooleanType = 0)[source]#

The SoilsStep object is used to specify transient (consolidation) or steady-state response analysis of partially or fully saturated fluid-filled porous media. The SoilsStep object is derived from the AnalysisStep object.

Notes

This object can be accessed by:

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

The corresponding analysis keywords are:

SOILS
- STEP

Attributes:

name: str

A String specifying the repository key.

response: SymbolicConstant

A SymbolicConstant specifying the analysis type. Possible values are STEADY_STATE and TRANSIENT. The default value is TRANSIENT.

timePeriod: float

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

nlgeom: Boolean

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

stabilizationMethod: SymbolicConstant

A SymbolicConstant specifying the stabilization type. Possible values are NONE, DISSIPATED_ENERGY_FRACTION, and DAMPING_FACTOR. The default value is NONE.

stabilizationMagnitude: float

A Float specifying the damping intensity of the automatic damping algorithm if the problem is expected to be unstable, and stabilizationMethod is not NONE. The default value is 2×10–4.

creep: Boolean

A Boolean specifying whether a creep response occurs during this step. The default value is ON.

timeIncrementationMethod: SymbolicConstant

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

initialInc: float

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

minInc: float

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.

maxInc: float

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

maxNumInc: int

An Int specifying the maximum number of increments in a step. The default value is 100.

end: SymbolicConstant

A SymbolicConstant specifying the time period to be analyzed in a transient analysis. Possible values are PERIOD and SS. The default value is PERIOD.

utol: float

None or a Float specifying the maximum pore pressure change permitted in any increment (in pressure units) in a transient consolidation analysis. The default value is None.

cetol: float

A Float specifying the maximum allowable difference in the creep strain increment calculated from the creep strain rates at the beginning and end of the increment. The default value is 0.0.

amplitude: SymbolicConstant

A SymbolicConstant specifying the amplitude variation for loading magnitudes during the step. The default value is STEP. Possible values are STEP and RAMP.

extrapolation: SymbolicConstant

matrixSolver: SymbolicConstant

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

matrixStorage: SymbolicConstant

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

solutionTechnique: SymbolicConstant

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: int

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

convertSDI: SymbolicConstant

adaptiveDampingRatio: float

A Float specifying the maximum allowable ratio of the stabilization energy to the total strain energy and can be used only if stabilizationMethod is not NONE. The default value is 0.05.

continueDampingFactors: Boolean

previous: str

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

description: str

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

explicit: SymbolicConstant

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

perturbation: Boolean

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

nonmechanical: Boolean

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

procedureType: SymbolicConstant

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
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: Boolean

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

fieldOutputRequestState: dict[str, FieldOutputRequestState]

A repository of FieldOutputRequestState objects.

historyOutputRequestState: dict[str, HistoryOutputRequestState]

A repository of HistoryOutputRequestState objects.

diagnosticPrint: DiagnosticPrint

A DiagnosticPrint object.

monitor: Monitor

A Monitor object.

restart: Restart

A Restart object.

adaptiveMeshConstraintStates: dict[str, AdaptiveMeshConstraintState]

A repository of AdaptiveMeshConstraintState objects.

adaptiveMeshDomains: dict[str, AdaptiveMeshDomain]

A repository of AdaptiveMeshDomain objects.

control: Control

A Control object.

solverControl: SolverControl

A SolverControl object.

boundaryConditionStates: dict[str, BoundaryConditionState]

A repository of BoundaryConditionState objects.

interactionStates: int

A repository of InteractionState objects.

loadStates: dict[str, LoadState]

A repository of LoadState objects.

loadCases: dict[str, LoadCase]

A repository of LoadCase objects.

predefinedFieldStates: dict[str, PredefinedFieldState]

A repository of PredefinedFieldState objects.

Methods

setValues([description, response, ...])

This method modifies the SoilsStep object.

setValues(description: str = '', response: SymbolicConstantType = 'TRANSIENT', timePeriod: float = 1, nlgeom: BooleanType = 0, stabilizationMethod: SymbolicConstantType = 'NONE', stabilizationMagnitude: float | None = None, creep: BooleanType = 1, timeIncrementationMethod: SymbolicConstantType = 'AUTOMATIC', initialInc: float | None = None, minInc: float | None = None, maxInc: float | None = None, maxNumInc: int = 100, end: SymbolicConstantType = 'PERIOD', utol: float | None = None, cetol: float = 0, amplitude: SymbolicConstantType = 'STEP', extrapolation: SymbolicConstantType = 'LINEAR', matrixSolver: SymbolicConstantType = 'DIRECT', matrixStorage: SymbolicConstantType = 'SOLVER_DEFAULT', solutionTechnique: SymbolicConstantType = 'FULL_NEWTON', reformKernel: int = 8, convertSDI: SymbolicConstantType = 'PROPAGATED', adaptiveDampingRatio: float = 0, continueDampingFactors: BooleanType = 0)[source]#

This method modifies the SoilsStep object.

Parameters:

description: A String specifying a description of the new step. The default value is an empty string.
response: A SymbolicConstant specifying the analysis type. Possible values are STEADY_STATE and TRANSIENT. The default value is TRANSIENT.
timePeriod: A Float specifying the total time period. The default value is 1.0.
nlgeom: A Boolean specifying whether geometric nonlinearities should be accounted for during the step. The default value is OFF.
stabilizationMethod: A SymbolicConstant specifying the stabilization type. Possible values are NONE, DISSIPATED_ENERGY_FRACTION, and DAMPING_FACTOR. The default value is NONE.
stabilizationMagnitude: A Float specifying the damping intensity of the automatic damping algorithm if the problem is expected to be unstable, and stabilizationMethod is not NONE. The default value is 2×10–4.
creep: A Boolean specifying whether a creep response occurs during this step. The default value is ON.
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.
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.
maxInc: A Float specifying the maximum time increment allowed. The default value is the total time period for the step.
maxNumInc: An Int specifying the maximum number of increments in a step. The default value is 100.
end: A SymbolicConstant specifying the time period to be analyzed in a transient analysis. Possible values are PERIOD and SS. The default value is PERIOD.
utol: None or a Float specifying the maximum pore pressure change permitted in any increment (in pressure units) in a transient consolidation analysis. The default value is None.
cetol: A Float specifying the maximum allowable difference in the creep strain increment calculated from the creep strain rates at the beginning and end of the increment. The default value is 0.0.
amplitude: A SymbolicConstant specifying the amplitude variation for loading magnitudes during the step. The default value is STEP. Possible values are STEP and RAMP.
extrapolation: A SymbolicConstant specifying the type of extrapolation to use in determining the incremental solution for a nonlinear analysis. Possible values are NONE, LINEAR, and PARABOLIC. The default value is LINEAR.
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.
adaptiveDampingRatio: A Float specifying the maximum allowable ratio of the stabilization energy to the total strain energy and can be used only if stabilizationMethod is not NONE. The default value is 0.05.
continueDampingFactors: A Boolean specifying whether this step will carry over the damping factors from the results of the preceding general step. This parameter must be used in conjunction with the adaptiveDampingRatio parameter. The default value is OFF.

Raises:

RangeError

StaticLinearPerturbationStep#

class StaticLinearPerturbationStep(name: str, previous: str, description: str = '', matrixSolver: SymbolicConstantType = 'DIRECT', matrixStorage: SymbolicConstantType = 'SOLVER_DEFAULT', maintainAttributes: BooleanType = False)[source]#

The StaticLinearPerturbationStep object is used to indicate that the static step should be analyzed as a linear perturbation load step. The StaticLinearPerturbationStep object is derived from the AnalysisStep object.

Notes

This object can be accessed by:

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

The corresponding analysis keywords are:

STATIC
- STEP

Attributes:

name: str

A String specifying the repository key.

matrixSolver: SymbolicConstant

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

matrixStorage: SymbolicConstant

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

previous: str

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

description: str

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

explicit: SymbolicConstant

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

perturbation: Boolean

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

nonmechanical: Boolean

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

procedureType: SymbolicConstant

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
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: Boolean

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

fieldOutputRequestState: dict[str, FieldOutputRequestState]

A repository of FieldOutputRequestState objects.

historyOutputRequestState: dict[str, HistoryOutputRequestState]

A repository of HistoryOutputRequestState objects.

diagnosticPrint: DiagnosticPrint

A DiagnosticPrint object.

monitor: Monitor

A Monitor object.

restart: Restart

A Restart object.

adaptiveMeshConstraintStates: dict[str, AdaptiveMeshConstraintState]

A repository of AdaptiveMeshConstraintState objects.

adaptiveMeshDomains: dict[str, AdaptiveMeshDomain]

A repository of AdaptiveMeshDomain objects.

control: Control

A Control object.

solverControl: SolverControl

A SolverControl object.

boundaryConditionStates: dict[str, BoundaryConditionState]

A repository of BoundaryConditionState objects.

interactionStates: int

A repository of InteractionState objects.

loadStates: dict[str, LoadState]

A repository of LoadState objects.

loadCases: dict[str, LoadCase]

A repository of LoadCase objects.

predefinedFieldStates: dict[str, PredefinedFieldState]

A repository of PredefinedFieldState objects.

Methods

setValues([description, matrixSolver, ...])

This method modifies the StaticLinearPerturbationStep object.

setValues(description: str = '', matrixSolver: SymbolicConstantType = 'DIRECT', matrixStorage: SymbolicConstantType = 'SOLVER_DEFAULT')[source]#

This method modifies the StaticLinearPerturbationStep object.

Parameters:

description: A String specifying a description of the new step. The default value is an empty string.
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.

Raises:

RangeError

StaticRiksStep#

class StaticRiksStep(name: str, previous: str, description: str = '', nlgeom: ~abaqusConstants.BooleanType = 0, adiabatic: ~abaqusConstants.BooleanType = 0, maxLPF: float | None = None, nodeOn: ~abaqusConstants.BooleanType = 0, maximumDisplacement: float = 0, dof: int = 0, region: ~abaqus.Region.Region.Region = <abaqus.Region.Region.Region object>, timeIncrementationMethod: ~abaqusConstants.SymbolicConstantType = 'AUTOMATIC', maxNumInc: int = 100, totalArcLength: float = 1, initialArcInc: float | None = None, minArcInc: float | None = None, maxArcInc: float | None = None, matrixStorage: ~abaqusConstants.SymbolicConstantType = 'SOLVER_DEFAULT', extrapolation: ~abaqusConstants.SymbolicConstantType = 'LINEAR', fullyPlastic: str = '', noStop: ~abaqusConstants.BooleanType = 0, maintainAttributes: ~abaqusConstants.BooleanType = False, useLongTermSolution: ~abaqusConstants.BooleanType = 0, convertSDI: ~abaqusConstants.SymbolicConstantType = 'PROPAGATED')[source]#

The StaticRiksStep object is used to indicate that the step should be analyzed as a static load step using the modified Riks method for proportional loading cases. The StaticRiksStep object is derived from the AnalysisStep object.

Notes

This object can be accessed by:

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

The corresponding analysis keywords are:

STATIC
- STEP

Attributes:

name: str

A String specifying the repository key.

nlgeom: Boolean

A Boolean specifying whether to allow for geometric nonlinearity. The default value is OFF.

adiabatic: Boolean

A Boolean specifying whether to perform an adiabatic stress analysis. The default value is OFF.

maxLPF: float

None or a Float specifying the maximum value of the load proportionality factor. The default value is None.

nodeOn: Boolean

A Boolean specifying whether to monitor the finishing displacement value at a node. The default value is OFF.

maximumDisplacement: float

A Float specifying the value of the total displacement (or rotation) at the node and degree of freedom that, if crossed during an increment, ends the step at the current increment. This argument is required when nodeOn=ON. The default value is 0.0.

dof: int

An Int specifying the degree of freedom being monitored. This argument is required when nodeOn=ON. The default value is 0.

timeIncrementationMethod: SymbolicConstant

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

maxNumInc: int

An Int specifying the maximum number of increments in a step. The default value is 100.

totalArcLength: float

A Float specifying the total load proportionality factor associated with the load in this step. The default value is 1.0.

initialArcInc: float

A Float specifying the initial load proportionality factor. The default value is the total load proportionality factor for the step.

minArcInc: float

A Float specifying the minimum arc length increment allowed. The default value is the smaller of the suggested initial load proportionality factor or 10−5 times the total load proportionality factor for the step.

maxArcInc: float

A Float specifying the maximum arc length increment allowed. The default value is the total load proportionality factor for the step.

matrixStorage: SymbolicConstant

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

extrapolation: SymbolicConstant

noStop: Boolean

A Boolean specifying whether to accept the solution to an increment after the maximum number of iterations allowed have been completed, even if the equilibrium tolerances are not satisfied. The default value is OFF.Warning:You should set noStop=ON only in special cases when you have a thorough understanding of how to interpret the results.

useLongTermSolution: Boolean

A Boolean specifying wether to obtain the fully relaxed long-term elastic solution with time-domain viscoelasticity or the long-term elastic-Plastic solution for two-layer viscoplasticity. The default value is OFF.

convertSDI: SymbolicConstant

previous: str

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

description: str

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

fullyPlastic: str

A String specifying the name of the region being monitored for fully Plastic behavior. The default value is an empty string.

region: Region

A Region object specifying the vertex at which the finishing displacement value is being monitored. This argument is required when nodeOn=ON.

explicit: SymbolicConstant

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

perturbation: Boolean

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

nonmechanical: Boolean

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

procedureType: SymbolicConstant

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
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: Boolean

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

fieldOutputRequestState: dict[str, FieldOutputRequestState]

A repository of FieldOutputRequestState objects.

historyOutputRequestState: dict[str, HistoryOutputRequestState]

A repository of HistoryOutputRequestState objects.

diagnosticPrint: DiagnosticPrint

A DiagnosticPrint object.

monitor: Monitor

A Monitor object.

restart: Restart

A Restart object.

adaptiveMeshConstraintStates: dict[str, AdaptiveMeshConstraintState]

A repository of AdaptiveMeshConstraintState objects.

adaptiveMeshDomains: dict[str, AdaptiveMeshDomain]

A repository of AdaptiveMeshDomain objects.

control: Control

A Control object.

solverControl: SolverControl

A SolverControl object.

boundaryConditionStates: dict[str, BoundaryConditionState]

A repository of BoundaryConditionState objects.

interactionStates: int

A repository of InteractionState objects.

loadStates: dict[str, LoadState]

A repository of LoadState objects.

loadCases: dict[str, LoadCase]

A repository of LoadCase objects.

predefinedFieldStates: dict[str, PredefinedFieldState]

A repository of PredefinedFieldState objects.

Methods

setValues([description, nlgeom, adiabatic, ...])

This method modifies the StaticRiksStep object.

setValues(description: str = '', nlgeom: ~abaqusConstants.BooleanType = 0, adiabatic: ~abaqusConstants.BooleanType = 0, maxLPF: float | None = None, nodeOn: ~abaqusConstants.BooleanType = 0, maximumDisplacement: float = 0, dof: int = 0, region: ~abaqus.Region.Region.Region = <abaqus.Region.Region.Region object>, timeIncrementationMethod: ~abaqusConstants.SymbolicConstantType = 'AUTOMATIC', maxNumInc: int = 100, totalArcLength: float = 1, initialArcInc: float | None = None, minArcInc: float | None = None, maxArcInc: float | None = None, matrixStorage: ~abaqusConstants.SymbolicConstantType = 'SOLVER_DEFAULT', extrapolation: ~abaqusConstants.SymbolicConstantType = 'LINEAR', fullyPlastic: str = '', noStop: ~abaqusConstants.BooleanType = 0, useLongTermSolution: ~abaqusConstants.BooleanType = 0, convertSDI: ~abaqusConstants.SymbolicConstantType = 'PROPAGATED')[source]#

This method modifies the StaticRiksStep object.

Parameters:

description: A String specifying a description of the new step. The default value is an empty string.
nlgeom: A Boolean specifying whether to allow for geometric nonlinearity. The default value is OFF.
adiabatic: A Boolean specifying whether to perform an adiabatic stress analysis. The default value is OFF.
maxLPF: None or a Float specifying the maximum value of the load proportionality factor. The default value is None.
nodeOn: A Boolean specifying whether to monitor the finishing displacement value at a node. The default value is OFF.
maximumDisplacement: A Float specifying the value of the total displacement (or rotation) at the node and degree of freedom that, if crossed during an increment, ends the step at the current increment. This argument is required when *nodeOn*=ON. The default value is 0.0.
dof: An Int specifying the degree of freedom being monitored. This argument is required when *nodeOn*=ON. The default value is 0.
region: A Region object specifying the vertex at which the finishing displacement value is being monitored. This argument is required when *nodeOn*=ON.
timeIncrementationMethod: A SymbolicConstant specifying the time incrementation method to be used. Possible values are FIXED and AUTOMATIC. The default value is AUTOMATIC.
maxNumInc: An Int specifying the maximum number of increments in a step. The default value is 100.
totalArcLength: A Float specifying the total load proportionality factor associated with the load in this step. The default value is 1.0.
initialArcInc: A Float specifying the initial load proportionality factor. The default value is the total load proportionality factor for the step.
minArcInc: A Float specifying the minimum arc length increment allowed. The default value is the smaller of the suggested initial load proportionality factor or 10−5 times the total load proportionality factor for the step.
maxArcInc: A Float specifying the maximum arc length increment allowed. The default value is the total load proportionality factor for the step.
matrixStorage: A SymbolicConstant specifying the type of matrix storage. Possible values are SYMMETRIC, UNSYMMETRIC, and SOLVER_DEFAULT. The default value is SOLVER_DEFAULT.
extrapolation: A SymbolicConstant specifying the type of extrapolation to use in determining the incremental solution for a nonlinear analysis. Possible values are NONE, LINEAR, and PARABOLIC. The default value is LINEAR.
fullyPlastic: A String specifying the name of the region being monitored for fully Plastic behavior. The default value is an empty string.
noStop: A Boolean specifying whether to accept the solution to an increment after the maximum number of iterations allowed have been completed, even if the equilibrium tolerances are not satisfied. The default value is OFF.Warning:You should set *noStop*=ON only in special cases when you have a thorough understanding of how to interpret the results.
useLongTermSolution: A Boolean specifying wether to obtain the fully relaxed long-term elastic solution with time-domain viscoelasticity or the long-term elastic-Plastic solution for two-layer viscoplasticity. The default value is OFF.
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.

Raises:

RangeError

StaticStep#

class StaticStep(name: str, previous: str, description: str = '', timePeriod: float = 1, nlgeom: BooleanType = 0, stabilizationMethod: SymbolicConstantType = 'NONE', stabilizationMagnitude: float | None = None, adiabatic: BooleanType = 0, timeIncrementationMethod: SymbolicConstantType = 'AUTOMATIC', maxNumInc: int = 100, initialInc: float | None = None, minInc: float | None = None, maxInc: float | None = None, matrixSolver: SymbolicConstantType = 'DIRECT', matrixStorage: SymbolicConstantType = 'SOLVER_DEFAULT', amplitude: SymbolicConstantType = 'RAMP', extrapolation: SymbolicConstantType = 'LINEAR', fullyPlastic: str = '', noStop: BooleanType = 0, maintainAttributes: BooleanType = False, useLongTermSolution: BooleanType = 0, solutionTechnique: SymbolicConstantType = 'FULL_NEWTON', reformKernel: int = 8, convertSDI: SymbolicConstantType = 'PROPAGATED', adaptiveDampingRatio: float = 0, continueDampingFactors: BooleanType = 0)[source]#

The StaticStep object is used to indicate that the step should be analyzed as a static load step. The StaticStep object is derived from the AnalysisStep object.

Notes

This object can be accessed by:

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

The corresponding analysis keywords are:

STATIC
- STEP

Attributes:

name: str

A String specifying the repository key.

timePeriod: float

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

nlgeom: Boolean

A Boolean specifying whether to allow for geometric nonlinearity. The default value is OFF.

stabilizationMethod: SymbolicConstant

A SymbolicConstant specifying the stabilization type. Possible values are NONE, DISSIPATED_ENERGY_FRACTION, and DAMPING_FACTOR. The default value is NONE.

stabilizationMagnitude: float

A Float specifying the damping intensity of the automatic damping algorithm if the problem is expected to be unstable, and stabilizationMethod is not NONE. The default value is 2×10–4.

adiabatic: Boolean

A Boolean specifying whether to perform an adiabatic stress analysis. The default value is OFF.

timeIncrementationMethod: SymbolicConstant

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

maxNumInc: int

An Int specifying the maximum number of increments in a step. The default value is 100.

initialInc: float

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

minInc: float

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.

maxInc: float

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

matrixSolver: SymbolicConstant

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

matrixStorage: SymbolicConstant

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

amplitude: SymbolicConstant

A SymbolicConstant specifying the amplitude variation for loading magnitudes during the step. Possible values are STEP and RAMP. The default value is RAMP.

extrapolation: SymbolicConstant

noStop: Boolean

A Boolean specifying whether to accept the solution to an increment after the maximum number of iterations allowed has been completed, even if the equilibrium tolerances are not satisfied. The default value is OFF.Warning:You should set noStop=ON only in special cases when you have a thorough understanding of how to interpret the results.

useLongTermSolution: Boolean

solutionTechnique: SymbolicConstant

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: int

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

convertSDI: SymbolicConstant

adaptiveDampingRatio: float

A Float specifying the maximum allowable ratio of the stabilization energy to the total strain energy and can be used only if stabilizationMethod is not NONE. The default value is 0.05.

continueDampingFactors: Boolean

previous: str

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

description: str

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

fullyPlastic: str

A String specifying the region being monitored for fully Plastic behavior. The default value is an empty string.

explicit: SymbolicConstant

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

perturbation: Boolean

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

nonmechanical: Boolean

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

procedureType: SymbolicConstant

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
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: Boolean

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

fieldOutputRequestState: dict[str, FieldOutputRequestState]

A repository of FieldOutputRequestState objects.

historyOutputRequestState: dict[str, HistoryOutputRequestState]

A repository of HistoryOutputRequestState objects.

diagnosticPrint: DiagnosticPrint

A DiagnosticPrint object.

monitor: Monitor

A Monitor object.

restart: Restart

A Restart object.

adaptiveMeshConstraintStates: dict[str, AdaptiveMeshConstraintState]

A repository of AdaptiveMeshConstraintState objects.

adaptiveMeshDomains: dict[str, AdaptiveMeshDomain]

A repository of AdaptiveMeshDomain objects.

control: Control

A Control object.

solverControl: SolverControl

A SolverControl object.

boundaryConditionStates: dict[str, BoundaryConditionState]

A repository of BoundaryConditionState objects.

interactionStates: int

A repository of InteractionState objects.

loadStates: dict[str, LoadState]

A repository of LoadState objects.

loadCases: dict[str, LoadCase]

A repository of LoadCase objects.

predefinedFieldStates: dict[str, PredefinedFieldState]

A repository of PredefinedFieldState objects.

Methods

setValues([description, timePeriod, nlgeom, ...])

This method modifies the StaticStep object.

setValues(description: str = '', timePeriod: float = 1, nlgeom: BooleanType = 0, stabilizationMethod: SymbolicConstantType = 'NONE', stabilizationMagnitude: float | None = None, adiabatic: BooleanType = 0, timeIncrementationMethod: SymbolicConstantType = 'AUTOMATIC', maxNumInc: int = 100, initialInc: float | None = None, minInc: float | None = None, maxInc: float | None = None, matrixSolver: SymbolicConstantType = 'DIRECT', matrixStorage: SymbolicConstantType = 'SOLVER_DEFAULT', amplitude: SymbolicConstantType = 'RAMP', extrapolation: SymbolicConstantType = 'LINEAR', fullyPlastic: str = '', noStop: BooleanType = 0, useLongTermSolution: BooleanType = 0, solutionTechnique: SymbolicConstantType = 'FULL_NEWTON', reformKernel: int = 8, convertSDI: SymbolicConstantType = 'PROPAGATED', adaptiveDampingRatio: float = 0, continueDampingFactors: BooleanType = 0)[source]#

This method modifies the StaticStep object.

Parameters:

description: A String specifying a description of the new step. The default value is an empty string.
timePeriod: A Float specifying the total time period. The default value is 1.0.
nlgeom: A Boolean specifying whether to allow for geometric nonlinearity. The default value is OFF.
stabilizationMethod: A SymbolicConstant specifying the stabilization type. Possible values are NONE, DISSIPATED_ENERGY_FRACTION, and DAMPING_FACTOR. The default value is NONE.
stabilizationMagnitude: A Float specifying the damping intensity of the automatic damping algorithm if the problem is expected to be unstable, and stabilizationMethod is not NONE. The default value is 2×10–4.
adiabatic: A Boolean specifying whether to perform an adiabatic stress analysis. The default value is OFF.
timeIncrementationMethod: A SymbolicConstant specifying the time incrementation method to be used. Possible values are FIXED and AUTOMATIC. The default value is AUTOMATIC.
maxNumInc: An Int specifying the maximum number of increments in a step. The default value is 100.
initialInc: A Float specifying the initial time increment. The default value is the total time period for the step.
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.
maxInc: A Float specifying the maximum time increment allowed. The default value is the total time period for the step.
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.
amplitude: A SymbolicConstant specifying the amplitude variation for loading magnitudes during the step. Possible values are STEP and RAMP. The default value is RAMP.
extrapolation: A SymbolicConstant specifying the type of extrapolation to use in determining the incremental solution for a nonlinear analysis. Possible values are NONE, LINEAR, and PARABOLIC. The default value is LINEAR.
fullyPlastic: A String specifying the region being monitored for fully Plastic behavior. The default value is an empty string.
noStop: A Boolean specifying whether to accept the solution to an increment after the maximum number of iterations allowed has been completed, even if the equilibrium tolerances are not satisfied. The default value is OFF.Warning:You should set *noStop*=ON only in special cases when you have a thorough understanding of how to interpret the results.
useLongTermSolution: A Boolean specifying wether to obtain the fully relaxed long-term elastic solution with time-domain viscoelasticity or the long-term elastic-Plastic solution for two-layer viscoplasticity. The default value is OFF.
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.
adaptiveDampingRatio: A Float specifying the maximum allowable ratio of the stabilization energy to the total strain energy and can be used only if stabilizationMethod is not NONE. The default value is 0.05.
continueDampingFactors: A Boolean specifying whether this step will carry over the damping factors from the results of the preceding general step. This parameter must be used in conjunction with the adaptiveDampingRatio parameter. The default value is OFF.

Raises:

RangeError

SteadyStateDirectStep#

class SteadyStateDirectStep(name: str, previous: str, frequencyRange: SteadyStateDirectFrequencyArray, description: str = '', factorization: SymbolicConstantType = 'COMPLEX', scale: SymbolicConstantType = 'LOGARITHMIC', matrixStorage: SymbolicConstantType = 'SOLVER_DEFAULT', maintainAttributes: BooleanType = False, subdivideUsingEigenfrequencies: BooleanType = 0, frictionDamping: BooleanType = 0)[source]#

The SteadyStateDirectStep object is used to calculate the linearized steady-state response of the system to harmonic excitation in terms of the physical degrees of freedom of the model. The SteadyStateDirectStep object is derived from the AnalysisStep object.

Notes

This object can be accessed by:

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

The corresponding analysis keywords are:

STEADY STATE DYNAMICS
- STEP

Attributes:

name: str

A String specifying the repository key.

factorization: SymbolicConstant

A SymbolicConstant specifying whether damping terms are to be ignored so that a real, rather than a complex, system matrix is factored. Possible values are REAL_ONLY and COMPLEX. The default value is COMPLEX.

scale: SymbolicConstant

A SymbolicConstant specifying whether a logarithmic or linear scale is used for output. Possible values are LOGARITHMIC and LINEAR. The default value is LOGARITHMIC.

matrixStorage: SymbolicConstant

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

subdivideUsingEigenfrequencies: Boolean

A Boolean specifying whether to subdivide each frequency range using the eigenfrequencies of the system. The default value is OFF.

frictionDamping: Boolean

A Boolean specifying whether to add to the damping matrix contributions due to friction effects. The default value is OFF.

previous: str

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

description: str

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

frequencyRange: SteadyStateDirectFrequencyArray

A SteadyStateDirectFrequencyArray object.

explicit: SymbolicConstant

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

perturbation: Boolean

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

nonmechanical: Boolean

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

procedureType: SymbolicConstant

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
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: Boolean

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

fieldOutputRequestState: dict[str, FieldOutputRequestState]

A repository of FieldOutputRequestState objects.

historyOutputRequestState: dict[str, HistoryOutputRequestState]

A repository of HistoryOutputRequestState objects.

diagnosticPrint: DiagnosticPrint

A DiagnosticPrint object.

monitor: Monitor

A Monitor object.

restart: Restart

A Restart object.

adaptiveMeshConstraintStates: dict[str, AdaptiveMeshConstraintState]

A repository of AdaptiveMeshConstraintState objects.

adaptiveMeshDomains: dict[str, AdaptiveMeshDomain]

A repository of AdaptiveMeshDomain objects.

control: Control

A Control object.

solverControl: SolverControl

A SolverControl object.

boundaryConditionStates: dict[str, BoundaryConditionState]

A repository of BoundaryConditionState objects.

interactionStates: int

A repository of InteractionState objects.

loadStates: dict[str, LoadState]

A repository of LoadState objects.

loadCases: dict[str, LoadCase]

A repository of LoadCase objects.

predefinedFieldStates: dict[str, PredefinedFieldState]

A repository of PredefinedFieldState objects.

Methods

setValues([description, factorization, ...])

This method modifies the SteadyStateDirectStep object.

setValues(description: str = '', factorization: SymbolicConstantType = 'COMPLEX', scale: SymbolicConstantType = 'LOGARITHMIC', matrixStorage: SymbolicConstantType = 'SOLVER_DEFAULT', subdivideUsingEigenfrequencies: BooleanType = 0, frictionDamping: BooleanType = 0)[source]#

This method modifies the SteadyStateDirectStep object.

Parameters:

description: A String specifying a description of the new step. The default value is an empty string.
factorization: A SymbolicConstant specifying whether damping terms are to be ignored so that a real, rather than a complex, system matrix is factored. Possible values are REAL_ONLY and COMPLEX. The default value is COMPLEX.
scale: A SymbolicConstant specifying whether a logarithmic or linear scale is used for output. Possible values are LOGARITHMIC and LINEAR. The default value is LOGARITHMIC.
matrixStorage: A SymbolicConstant specifying the type of matrix storage. Possible values are SYMMETRIC, UNSYMMETRIC, and SOLVER_DEFAULT. The default value is SOLVER_DEFAULT.
subdivideUsingEigenfrequencies: A Boolean specifying whether to subdivide each frequency range using the eigenfrequencies of the system. The default value is OFF.
frictionDamping: A Boolean specifying whether to add to the damping matrix contributions due to friction effects. The default value is OFF.

Raises:

RangeError

SteadyStateModalStep#

class SteadyStateModalStep(name: str, previous: str, frequencyRange: ~abaqus.StepMiscellaneous.SteadyStateModalFrequencyArray.SteadyStateModalFrequencyArray, description: str = '', scale: ~abaqusConstants.SymbolicConstantType = 'LOGARITHMIC', directDamping: ~abaqus.StepMiscellaneous.DirectDamping.DirectDamping = <abaqus.StepMiscellaneous.DirectDamping.DirectDamping object>, compositeDamping: ~abaqus.StepMiscellaneous.CompositeDamping.CompositeDamping = <abaqus.StepMiscellaneous.CompositeDamping.CompositeDamping object>, rayleighDamping: ~abaqus.StepMiscellaneous.RayleighDamping.RayleighDamping = <abaqus.StepMiscellaneous.RayleighDamping.RayleighDamping object>, structuralDamping: ~abaqus.StepMiscellaneous.StructuralDamping.StructuralDamping = <abaqus.StepMiscellaneous.StructuralDamping.StructuralDamping object>, directDampingByFrequency: ~abaqus.StepMiscellaneous.DirectDampingByFrequency.DirectDampingByFrequency = <abaqus.StepMiscellaneous.DirectDampingByFrequency.DirectDampingByFrequency object>, rayleighDampingByFrequency: ~abaqus.StepMiscellaneous.RayleighDampingByFrequency.RayleighDampingByFrequency = <abaqus.StepMiscellaneous.RayleighDampingByFrequency.RayleighDampingByFrequency object>, structuralDampingByFrequency: ~abaqus.StepMiscellaneous.StructuralDampingByFrequency.StructuralDampingByFrequency = <abaqus.StepMiscellaneous.StructuralDampingByFrequency.StructuralDampingByFrequency object>, maintainAttributes: ~abaqusConstants.BooleanType = False, subdivideUsingEigenfrequencies: ~abaqusConstants.BooleanType = 1)[source]#

he SteadyStateModalStep object is used to calculate the linearized steady-state response of the system to harmonic excitation. The SteadyStateModalStep object is derived from the AnalysisStep object.

Notes

This object can be accessed by:

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

The corresponding analysis keywords are:

DAMPING
- MODAL DAMPING
- STEADY STATE DYNAMICS
- STEP

Attributes:

name: str

A String specifying the repository key.

scale: SymbolicConstant

A SymbolicConstant specifying whether a logarithmic or linear scale is used for output. Possible values are LOGARITHMIC and LINEAR. The default value is LOGARITHMIC.

subdivideUsingEigenfrequencies: Boolean

A Boolean specifying whether to subdivide each frequency range using the eigenfrequencies of the system. The default value is ON.

previous: str

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

description: str

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

frequencyRange: SteadyStateModalFrequencyArray

A SteadyStateModalFrequencyArray object.

directDamping: DirectDamping

A DirectDamping object.

compositeDamping: CompositeDamping

A CompositeDamping object.

rayleighDamping: RayleighDamping

A RayleighDamping object.

structuralDamping: StructuralDamping

A StructuralDamping object.

directDampingByFrequency: DirectDampingByFrequency

A DirectDampingByFrequency object.

rayleighDampingByFrequency: RayleighDampingByFrequency

A RayleighDampingByFrequency object.

structuralDampingByFrequency: StructuralDampingByFrequency

A StructuralDampingByFrequency object.

explicit: SymbolicConstant

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

perturbation: Boolean

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

nonmechanical: Boolean

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

procedureType: SymbolicConstant

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
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: Boolean

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

fieldOutputRequestState: dict[str, FieldOutputRequestState]

A repository of FieldOutputRequestState objects.

historyOutputRequestState: dict[str, HistoryOutputRequestState]

A repository of HistoryOutputRequestState objects.

diagnosticPrint: DiagnosticPrint

A DiagnosticPrint object.

monitor: Monitor

A Monitor object.

restart: Restart

A Restart object.

adaptiveMeshConstraintStates: dict[str, AdaptiveMeshConstraintState]

A repository of AdaptiveMeshConstraintState objects.

adaptiveMeshDomains: dict[str, AdaptiveMeshDomain]

A repository of AdaptiveMeshDomain objects.

control: Control

A Control object.

solverControl: SolverControl

A SolverControl object.

boundaryConditionStates: dict[str, BoundaryConditionState]

A repository of BoundaryConditionState objects.

interactionStates: int

A repository of InteractionState objects.

loadStates: dict[str, LoadState]

A repository of LoadState objects.

loadCases: dict[str, LoadCase]

A repository of LoadCase objects.

predefinedFieldStates: dict[str, PredefinedFieldState]

A repository of PredefinedFieldState objects.

Methods

setValues([description, scale, ...])

This method modifies the SteadyStateModalStep object.

setValues(description: str = '', scale: ~abaqusConstants.SymbolicConstantType = 'LOGARITHMIC', directDamping: ~abaqus.StepMiscellaneous.DirectDamping.DirectDamping = <abaqus.StepMiscellaneous.DirectDamping.DirectDamping object>, compositeDamping: ~abaqus.StepMiscellaneous.CompositeDamping.CompositeDamping = <abaqus.StepMiscellaneous.CompositeDamping.CompositeDamping object>, rayleighDamping: ~abaqus.StepMiscellaneous.RayleighDamping.RayleighDamping = <abaqus.StepMiscellaneous.RayleighDamping.RayleighDamping object>, structuralDamping: ~abaqus.StepMiscellaneous.StructuralDamping.StructuralDamping = <abaqus.StepMiscellaneous.StructuralDamping.StructuralDamping object>, directDampingByFrequency: ~abaqus.StepMiscellaneous.DirectDampingByFrequency.DirectDampingByFrequency = <abaqus.StepMiscellaneous.DirectDampingByFrequency.DirectDampingByFrequency object>, rayleighDampingByFrequency: ~abaqus.StepMiscellaneous.RayleighDampingByFrequency.RayleighDampingByFrequency = <abaqus.StepMiscellaneous.RayleighDampingByFrequency.RayleighDampingByFrequency object>, structuralDampingByFrequency: ~abaqus.StepMiscellaneous.StructuralDampingByFrequency.StructuralDampingByFrequency = <abaqus.StepMiscellaneous.StructuralDampingByFrequency.StructuralDampingByFrequency object>, subdivideUsingEigenfrequencies: ~abaqusConstants.BooleanType = 1)[source]#

This method modifies the SteadyStateModalStep object.

Parameters:

description: A String specifying a description of the new step. The default value is an empty string.
scale: A SymbolicConstant specifying whether a logarithmic or linear scale is used for output. Possible values are LOGARITHMIC and LINEAR. The default value is LOGARITHMIC.
directDamping: A DirectDamping object.
compositeDamping: A CompositeDamping object.
rayleighDamping: A RayleighDamping object.
structuralDamping: A StructuralDamping object.
directDampingByFrequency: A DirectDampingByFrequency object.
rayleighDampingByFrequency: A RayleighDampingByFrequency object.
structuralDampingByFrequency: A StructuralDampingByFrequency object.
subdivideUsingEigenfrequencies: A Boolean specifying whether to subdivide each frequency range using the eigenfrequencies of the system. The default value is ON.

Raises:

RangeError

SteadyStateSubspaceStep#

class SteadyStateSubspaceStep(name: str, previous: str, frequencyRange: SteadyStateSubspaceFrequencyArray, description: str = '', factorization: SymbolicConstantType = 'COMPLEX', scale: SymbolicConstantType = 'LOGARITHMIC', matrixStorage: SymbolicConstantType = 'SOLVER_DEFAULT', maintainAttributes: BooleanType = False, subdivideUsingEigenfrequencies: BooleanType = 1, projection: SymbolicConstantType = 'ALL_FREQUENCIES', maxDampingChange: float = 0, maxStiffnessChange: float = 0, frictionDamping: BooleanType = 0)[source]#

The SteadyStateSubspaceStep object is used to calculate the linearized steady-state response of the system to harmonic excitation on the basis of the subspace projection method. The SteadyStateSubspaceStep object is derived from the AnalysisStep object.

Notes

This object can be accessed by:

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

The corresponding analysis keywords are:

STEADY STATE DYNAMICS
- STEP

Attributes:

name: str

A String specifying the repository key.

factorization: SymbolicConstant

scale: SymbolicConstant

A SymbolicConstant specifying whether a logarithmic or linear scale is used for output. Possible values are LOGARITHMIC and LINEAR. The default value is LOGARITHMIC.

matrixStorage: SymbolicConstant

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

subdivideUsingEigenfrequencies: Boolean

A Boolean specifying whether to subdivide each frequency range using the eigenfrequencies of the system. The default value is ON.

projection: SymbolicConstant

A SymbolicConstant specifying how often to perform subspace projections onto the modal subspace. Possible values are ALL_FREQUENCIES, CONSTANT, EIGENFREQUENCY, PROPERTY_CHANGE, and RANGE. The default value is ALL_FREQUENCIES.

maxDampingChange: float

A Float specifying the maximum relative change in damping material properties before a new projection is to be performed. The default value is 0.1.

maxStiffnessChange: float

A Float specifying the maximum relative change in stiffness material properties before a new projection is to be performed. The default value is 0.1.

frictionDamping: Boolean

A Boolean specifying whether to add to the damping matrix contributions due to friction effects. The default value is OFF.

previous: str

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

description: str

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

frequencyRange: SteadyStateSubspaceFrequencyArray

A SteadyStateSubspaceFrequencyArray object.

explicit: SymbolicConstant

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

perturbation: Boolean

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

nonmechanical: Boolean

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

procedureType: SymbolicConstant

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
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: Boolean

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

fieldOutputRequestState: dict[str, FieldOutputRequestState]

A repository of FieldOutputRequestState objects.

historyOutputRequestState: dict[str, HistoryOutputRequestState]

A repository of HistoryOutputRequestState objects.

diagnosticPrint: DiagnosticPrint

A DiagnosticPrint object.

monitor: Monitor

A Monitor object.

restart: Restart

A Restart object.

adaptiveMeshConstraintStates: dict[str, AdaptiveMeshConstraintState]

A repository of AdaptiveMeshConstraintState objects.

adaptiveMeshDomains: dict[str, AdaptiveMeshDomain]

A repository of AdaptiveMeshDomain objects.

control: Control

A Control object.

solverControl: SolverControl

A SolverControl object.

boundaryConditionStates: dict[str, BoundaryConditionState]

A repository of BoundaryConditionState objects.

interactionStates: int

A repository of InteractionState objects.

loadStates: dict[str, LoadState]

A repository of LoadState objects.

loadCases: dict[str, LoadCase]

A repository of LoadCase objects.

predefinedFieldStates: dict[str, PredefinedFieldState]

A repository of PredefinedFieldState objects.

Methods

setValues([description, factorization, ...])

This method modifies the SteadyStateSubspaceStep object.

Parameters:

description: A String specifying a description of the new step. The default value is an empty string.
factorization: A SymbolicConstant specifying whether damping terms are to be ignored so that a real, rather than a complex, system matrix is factored. Possible values are REAL_ONLY and COMPLEX. The default value is COMPLEX.
scale: A SymbolicConstant specifying whether a logarithmic or linear scale is used for output. Possible values are LOGARITHMIC and LINEAR. The default value is LOGARITHMIC.
matrixStorage: A SymbolicConstant specifying the type of matrix storage. Possible values are SYMMETRIC, UNSYMMETRIC, and SOLVER_DEFAULT. The default value is SOLVER_DEFAULT.
subdivideUsingEigenfrequencies: A Boolean specifying whether to subdivide each frequency range using the eigenfrequencies of the system. The default value is ON.
projection: A SymbolicConstant specifying how often to perform subspace projections onto the modal subspace. Possible values are ALL_FREQUENCIES, CONSTANT, EIGENFREQUENCY, PROPERTY_CHANGE, and RANGE. The default value is ALL_FREQUENCIES.
maxDampingChange: A Float specifying the maximum relative change in damping material properties before a new projection is to be performed. The default value is 0.1.
maxStiffnessChange: A Float specifying the maximum relative change in stiffness material properties before a new projection is to be performed. The default value is 0.1.
frictionDamping: A Boolean specifying whether to add to the damping matrix contributions due to friction effects. The default value is OFF.

Raises:

RangeError

SubspaceDynamicsStep#

class SubspaceDynamicsStep(name: str, previous: str, description: str = '', timePeriod: float = 1, vectors: SymbolicConstantType = 'ALL', nlgeom: BooleanType = 0, maxNumInc: int = 100, incSize: float = 0, amplitude: SymbolicConstantType = 'STEP', maintainAttributes: BooleanType = False)[source]#

The SubspaceDynamicsStep object is used to calculate the linearized steady-state response of the system to harmonic excitation on the basis of the subspace projection method. The SubspaceDynamicsStep object is derived from the AnalysisStep object.

Notes

This object can be accessed by:

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

The corresponding analysis keywords are:

DYNAMIC
- STEP

Attributes:

name: str

A String specifying the repository key.

timePeriod: float

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

vectors: SymbolicConstant

The SymbolicConstant ALL or an Int specifying the number of modes to be used for subspace projection. The possible value for the SymbolicConstant is ALL. The default value is ALL.

nlgeom: Boolean

A Boolean specifying whether to allow for geometric nonlinearity. The default value is OFF.

maxNumInc: int

An Int specifying the maximum number of increments in a step. The default value is 100.

incSize: float

A Float specifying the suggested time increment. The default value is 0.0.

amplitude: SymbolicConstant

A SymbolicConstant specifying the amplitude variation for loading magnitudes during the step. Possible values are STEP and RAMP. The default value is STEP.

previous: str

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

description: str

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

explicit: SymbolicConstant

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

perturbation: Boolean

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

nonmechanical: Boolean

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

procedureType: SymbolicConstant

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
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: Boolean

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

fieldOutputRequestState: dict[str, FieldOutputRequestState]

A repository of FieldOutputRequestState objects.

historyOutputRequestState: dict[str, HistoryOutputRequestState]

A repository of HistoryOutputRequestState objects.

diagnosticPrint: DiagnosticPrint

A DiagnosticPrint object.

monitor: Monitor

A Monitor object.

restart: Restart

A Restart object.

adaptiveMeshConstraintStates: dict[str, AdaptiveMeshConstraintState]

A repository of AdaptiveMeshConstraintState objects.

adaptiveMeshDomains: dict[str, AdaptiveMeshDomain]

A repository of AdaptiveMeshDomain objects.

control: Control

A Control object.

solverControl: SolverControl

A SolverControl object.

boundaryConditionStates: dict[str, BoundaryConditionState]

A repository of BoundaryConditionState objects.

interactionStates: int

A repository of InteractionState objects.

loadStates: dict[str, LoadState]

A repository of LoadState objects.

loadCases: dict[str, LoadCase]

A repository of LoadCase objects.

predefinedFieldStates: dict[str, PredefinedFieldState]

A repository of PredefinedFieldState objects.

Methods

setValues([description, timePeriod, ...])

This method modifies the SubspaceDynamicsStep object.

setValues(description: str = '', timePeriod: float = 1, vectors: SymbolicConstantType = 'ALL', nlgeom: BooleanType = 0, maxNumInc: int = 100, incSize: float = 0, amplitude: SymbolicConstantType = 'STEP')[source]#

This method modifies the SubspaceDynamicsStep object.

Parameters:

description: A String specifying a description of the new step. The default value is an empty string.
timePeriod: A Float specifying the total time period of the step. The default value is 1.0.
vectors: The SymbolicConstant ALL or an Int specifying the number of modes to be used for subspace projection. The possible value for the SymbolicConstant is ALL. The default value is ALL.
nlgeom: A Boolean specifying whether to allow for geometric nonlinearity. The default value is OFF.
maxNumInc: An Int specifying the maximum number of increments in a step. The default value is 100.
incSize: A Float specifying the suggested time increment. The default value is 0.0.
amplitude: A SymbolicConstant specifying the amplitude variation for loading magnitudes during the step. Possible values are STEP and RAMP. The default value is STEP.

Raises:

RangeError

SubstructureGenerateStep#

class SubstructureGenerateStep(name: str, previous: str, substructureIdentifier: int, description: str = '', recoveryMatrix: ~abaqusConstants.SymbolicConstantType = 'WHOLE_MODEL', recoveryRegion: ~abaqus.Region.Region.Region = <abaqus.Region.Region.Region object>, computeGravityLoadVectors: ~abaqusConstants.BooleanType = False, computeReducedMassMatrix: ~abaqusConstants.BooleanType = False, computeReducedStructuralDampingMatrix: ~abaqusConstants.BooleanType = False, computeReducedViscousDampingMatrix: ~abaqusConstants.BooleanType = False, evaluateFrequencyDependentProperties: ~abaqusConstants.BooleanType = False, frequency: float = 0, retainedEigenmodesMethod: ~abaqusConstants.SymbolicConstantType = 'NONE', modeRange: ~abaqus.StepMiscellaneous.SubstructureGenerateModesArray.SubstructureGenerateModesArray | None = None, frequencyRange: ~abaqus.StepMiscellaneous.SubstructureGenerateFrequencyArray.SubstructureGenerateFrequencyArray | None = None, globalDampingField: ~abaqusConstants.SymbolicConstantType = 'NONE', alphaDampingRatio: float = 0, betaDampingRatio: float = 0, structuralDampingRatio: float = 0, viscousDampingControl: ~abaqusConstants.SymbolicConstantType = 'NONE', structuralDampingControl: ~abaqusConstants.SymbolicConstantType = 'NONE')[source]#

TheSubstructureGenerateStep object is used to generate a substructure. The SubstructureGenerateStep object is derived from the AnalysisStep object.

Notes

This object can be accessed by:

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

The corresponding analysis keywords are:

SUBSTRUCTURE GENERATE
- STEP

Attributes:

name: str

A String specifying the repository key.

recoveryMatrix: SymbolicConstant

A SymbolicConstant specifying the subtructure recovery to be computed. Possible values are WHOLE_MODEL, REGION, and NONE. The default value is WHOLE_MODEL.

frequency: float

A Float specifying the frequency at which to evaluate the frequency dependent properties. The default value is 0.0.

retainedEigenmodesMethod: SymbolicConstant

A SymbolicConstant specifying the eigenmodes to be retained. Possible values are MODE_RANGE, FREQUENCY_RANGE, and NONE. The default value is NONE.

globalDampingField: SymbolicConstant

A SymbolicConstant specifying the field to which the global damping factors should be applied. Possible values are ALL, ACOUSTIC, MECHANICAL, and NONE. The default value is NONE.

alphaDampingRatio: float

A Float specifying the factor to create global Rayleigh mass proportional damping. The default value is 0.0.

betaDampingRatio: float

A Float specifying the factor to create global Rayleigh stiffness proportional damping. The default value is 0.0.

structuralDampingRatio: float

A Float specifying the factor to create frequency-independent stiffness proportional structural damping. The default value is 0.0.

viscousDampingControl: SymbolicConstant

A SymbolicConstant specifying the damping control to include the viscous damping matrix. Possible values are ELEMENT, FACTOR, COMBINED, and NONE. The default value is NONE.

structuralDampingControl: SymbolicConstant

A SymbolicConstant specifying the damping control to include the structural damping matrix. Possible values are ELEMENT, FACTOR, COMBINED, and NONE. The default value is NONE.

previous: str

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

description: str

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

substructureIdentifier: str

A String specifying a unique identifier for the substructure. The default value is an empty string.

recoveryRegion: Region

A Region object specifying the region for substructure recovery. This argument is required when recoveryMatrix=REGION.

frequencyRange: SubstructureGenerateFrequencyArray

A SubstructureGenerateFrequencyArray object.

modeRange: SubstructureGenerateModesArray

A SubstructureGenerateModesArray object.

explicit: SymbolicConstant

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

perturbation: Boolean

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

nonmechanical: Boolean

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

procedureType: SymbolicConstant

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
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: Boolean

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

fieldOutputRequestState: dict[str, FieldOutputRequestState]

A repository of FieldOutputRequestState objects.

historyOutputRequestState: dict[str, HistoryOutputRequestState]

A repository of HistoryOutputRequestState objects.

diagnosticPrint: DiagnosticPrint

A DiagnosticPrint object.

monitor: Monitor

A Monitor object.

restart: Restart

A Restart object.

adaptiveMeshConstraintStates: dict[str, AdaptiveMeshConstraintState]

A repository of AdaptiveMeshConstraintState objects.

adaptiveMeshDomains: dict[str, AdaptiveMeshDomain]

A repository of AdaptiveMeshDomain objects.

control: Control

A Control object.

solverControl: SolverControl

A SolverControl object.

boundaryConditionStates: dict[str, BoundaryConditionState]

A repository of BoundaryConditionState objects.

interactionStates: int

A repository of InteractionState objects.

loadStates: dict[str, LoadState]

A repository of LoadState objects.

loadCases: dict[str, LoadCase]

A repository of LoadCase objects.

predefinedFieldStates: dict[str, PredefinedFieldState]

A repository of PredefinedFieldState objects.

Methods

setValues([description, recoveryMatrix, ...])

This method modifies the SubstructureGenerateStep object.

setValues(description: str = '', recoveryMatrix: ~abaqusConstants.SymbolicConstantType = 'WHOLE_MODEL', recoveryRegion: ~abaqus.Region.Region.Region = <abaqus.Region.Region.Region object>, computeGravityLoadVectors: ~abaqusConstants.BooleanType = False, computeReducedMassMatrix: ~abaqusConstants.BooleanType = False, computeReducedStructuralDampingMatrix: ~abaqusConstants.BooleanType = False, computeReducedViscousDampingMatrix: ~abaqusConstants.BooleanType = False, evaluateFrequencyDependentProperties: ~abaqusConstants.BooleanType = False, frequency: float = 0, retainedEigenmodesMethod: ~abaqusConstants.SymbolicConstantType = 'NONE', modeRange: ~abaqus.StepMiscellaneous.SubstructureGenerateModesArray.SubstructureGenerateModesArray | None = None, frequencyRange: ~abaqus.StepMiscellaneous.SubstructureGenerateFrequencyArray.SubstructureGenerateFrequencyArray | None = None, globalDampingField: ~abaqusConstants.SymbolicConstantType = 'NONE', alphaDampingRatio: float = 0, betaDampingRatio: float = 0, structuralDampingRatio: float = 0, viscousDampingControl: ~abaqusConstants.SymbolicConstantType = 'NONE', structuralDampingControl: ~abaqusConstants.SymbolicConstantType = 'NONE')[source]#

This method modifies the SubstructureGenerateStep object.

Parameters:

description: A String specifying a description of the new step. The default value is an empty string.
recoveryMatrix: A SymbolicConstant specifying the subtructure recovery to be computed. Possible values are WHOLE_MODEL, REGION, and NONE. The default value is WHOLE_MODEL.
recoveryRegion: A Region object specifying the region for substructure recovery. This argument is required when *recoveryMatrix*=REGION.
computeGravityLoadVectors: A Boolean specifying whether to compute the gravity load vectors. The default value is False.
computeReducedMassMatrix: A Boolean specifying whether to compute the reduced mass matrix. The default value is False.
computeReducedStructuralDampingMatrix: A Boolean specifying whether to compute the reduced structural damping matrix. The default value is False.
computeReducedViscousDampingMatrix: A Boolean specifying whether to compute the reduced viscous damping matrix. The default value is False.
evaluateFrequencyDependentProperties: A Boolean specifying whether to evaluate the frequency dependent properties. The default value is False.
frequency: A Float specifying the frequency at which to evaluate the frequency dependent properties. The default value is 0.0.
retainedEigenmodesMethod: A SymbolicConstant specifying the eigenmodes to be retained. Possible values are MODE_RANGE, FREQUENCY_RANGE, and NONE. The default value is NONE.
modeRange: A SubstructureGenerateModesArray object.
frequencyRange: A SubstructureGenerateFrequencyArray object.
globalDampingField: A SymbolicConstant specifying the field to which the global damping factors should be applied. Possible values are ALL, ACOUSTIC, MECHANICAL, and NONE. The default value is NONE.
alphaDampingRatio: A Float specifying the factor to create global Rayleigh mass proportional damping. The default value is 0.0.
betaDampingRatio: A Float specifying the factor to create global Rayleigh stiffness proportional damping. The default value is 0.0.
structuralDampingRatio: A Float specifying the factor to create frequency-independent stiffness proportional structural damping. The default value is 0.0.
viscousDampingControl: A SymbolicConstant specifying the damping control to include the viscous damping matrix. Possible values are ELEMENT, FACTOR, COMBINED, and NONE. The default value is NONE.
structuralDampingControl: A SymbolicConstant specifying the damping control to include the structural damping matrix. Possible values are ELEMENT, FACTOR, COMBINED, and NONE. The default value is NONE.

Raises:

RangeError

TempDisplacementDynamicsStep#

class TempDisplacementDynamicsStep(name: str, previous: str, description: str = '', timePeriod: float = 1, nlgeom: BooleanType = 0, timeIncrementationMethod: SymbolicConstantType = 'AUTOMATIC_GLOBAL', maxIncrement: float | None = None, scaleFactor: float = 1, userDefinedInc: float | None = None, massScaling: MassScalingArray = 'PREVIOUS_STEP', linearBulkViscosity: float = 0, quadBulkViscosity: float = 1, maintainAttributes: BooleanType = False, improvedDtMethod: BooleanType = 1)[source]#

The TempDisplacementDynamicsStep object is used to perform a dynamic coupled thermal-stress analysis using explicit integration. The TempDisplacementDynamicsStep object is derived from the AnalysisStep object.

Notes

This object can be accessed by:

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

The corresponding analysis keywords are:

BULK VISCOSITY
- DYNAMIC
- FIXED MASS SCALING
- STEP
- VARIABLE MASS SCALING

Attributes:

name: str

A String specifying the repository key.

timePeriod: float

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

nlgeom: Boolean

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

timeIncrementationMethod: SymbolicConstant

maxIncrement: float

None or a Float specifying the maximum time increment allowed. If there is no upper limit, maxIncrement=None. The default value is None.

scaleFactor: float

userDefinedInc: float

None or a Float specifying the user-defined time increment. The default value is None.

linearBulkViscosity: float

A Float specifying the linear bulk viscosity parameter, b1b1. The default value is 0.06.

quadBulkViscosity: float

A Float specifying the quadratic bulk viscosity parameter, b2b2. The default value is 1.2.

improvedDtMethod: Boolean

previous: str

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

description: str

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

massScaling: MassScalingArray

A MassScalingArray object specifying mass scaling controls. The default value is PREVIOUS_STEP.

explicit: SymbolicConstant

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

perturbation: Boolean

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

nonmechanical: Boolean

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

procedureType: SymbolicConstant

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
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: Boolean

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

fieldOutputRequestState: dict[str, FieldOutputRequestState]

A repository of FieldOutputRequestState objects.

historyOutputRequestState: dict[str, HistoryOutputRequestState]

A repository of HistoryOutputRequestState objects.

diagnosticPrint: DiagnosticPrint

A DiagnosticPrint object.

monitor: Monitor

A Monitor object.

restart: Restart

A Restart object.

adaptiveMeshConstraintStates: dict[str, AdaptiveMeshConstraintState]

A repository of AdaptiveMeshConstraintState objects.

adaptiveMeshDomains: dict[str, AdaptiveMeshDomain]

A repository of AdaptiveMeshDomain objects.

control: Control

A Control object.

solverControl: SolverControl

A SolverControl object.

boundaryConditionStates: dict[str, BoundaryConditionState]

A repository of BoundaryConditionState objects.

interactionStates: int

A repository of InteractionState objects.

loadStates: dict[str, LoadState]

A repository of LoadState objects.

loadCases: dict[str, LoadCase]

A repository of LoadCase objects.

predefinedFieldStates: dict[str, PredefinedFieldState]

A repository of PredefinedFieldState objects.

Methods

setValues([description, timePeriod, nlgeom, ...])

This method modifies the TempDisplacementDynamicsStep object.

setValues(description: str = '', timePeriod: float = 1, nlgeom: BooleanType = 0, timeIncrementationMethod: SymbolicConstantType = 'AUTOMATIC_GLOBAL', maxIncrement: float | None = None, scaleFactor: float = 1, userDefinedInc: float | None = None, massScaling: MassScalingArray = 'PREVIOUS_STEP', linearBulkViscosity: float = 0, quadBulkViscosity: float = 1, improvedDtMethod: BooleanType = 1)[source]#

This method modifies the TempDisplacementDynamicsStep object.

Parameters:

description: A String specifying a description of the new step. The default value is an empty string.
timePeriod: A Float specifying the time period of the step. The default value is 1.0.
nlgeom: A Boolean specifying whether geometric nonlinearities should be accounted for during the step. The default value is OFF.
timeIncrementationMethod: A SymbolicConstant specifying the time incrementation method to be used. Possible values are AUTOMATIC_GLOBAL, AUTOMATIC_EBE, FIXED_USER_DEFINED_INC, and FIXED_EBE. The default value is AUTOMATIC_GLOBAL.
maxIncrement: None or a Float specifying the maximum time increment allowed. If there is no upper limit, *maxIncrement*=None. The default value is None.
scaleFactor: A Float specifying the factor that is used to scale the time increment. This argument is required only when *timeIncrementationMethod*=AUTOMATIC_GLOBAL, AUTOMATIC_EBE, or FIXED_EBE. The default value is 1.0.
userDefinedInc: None or a Float specifying the user-defined time increment. The default value is None.
massScaling: A MassScalingArray object specifying mass scaling controls. The default value is PREVIOUS_STEP.
linearBulkViscosity: A Float specifying the linear bulk viscosity parameter, b1b1. The default value is 0.06.
quadBulkViscosity: A Float specifying the quadratic bulk viscosity parameter, b2b2. The default value is 1.2.
improvedDtMethod: A Boolean specifying whether to use the “improved” (*improvedDtMethod*=ON) or “conservative” (*improvedDtMethod*=OFF) method to estimate the element stable time increment for three-dimensional continuum elements and elements with plane stress formulations (shell, membrane, and two-dimensional plane stress elements). The default value is ON.

Raises:

RangeError

ViscoStep#

class ViscoStep(name: str, previous: str, description: str = '', timePeriod: float = 1, nlgeom: BooleanType = 0, stabilizationMethod: SymbolicConstantType = 'NONE', stabilizationMagnitude: float | None = None, timeIncrementationMethod: SymbolicConstantType = 'AUTOMATIC', matrixSolver: SymbolicConstantType = 'DIRECT', matrixStorage: SymbolicConstantType = 'SOLVER_DEFAULT', initialInc: float | None = None, maxNumInc: int = 100, minInc: float | None = None, maxInc: float = 1, integration: SymbolicConstantType = 'IMPLICIT_EXPLICIT', cetol: float = 0, amplitude: SymbolicConstantType = 'STEP', extrapolation: SymbolicConstantType = 'LINEAR', maintainAttributes: BooleanType = False, solutionTechnique: SymbolicConstantType = 'FULL_NEWTON', reformKernel: int = 8, convertSDI: SymbolicConstantType = 'PROPAGATED', adaptiveDampingRatio: float = 0, continueDampingFactors: BooleanType = 0)[source]#

The ViscoStep object is used to obtain a transient static response in an analysis with time-dependent material behavior (creep, swelling, and viscoelasticity). The ViscoStep object is derived from the AnalysisStep object.

Notes

This object can be accessed by:

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

The corresponding analysis keywords are:

VISCO
- STEP

Attributes:

name: str

A String specifying the repository key.

timePeriod: float

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

nlgeom: Boolean

A Boolean specifying whether to allow for geometric nonlinearity. The default value is OFF.

stabilizationMethod: SymbolicConstant

A SymbolicConstant specifying the stabilization type. Possible values are NONE, DISSIPATED_ENERGY_FRACTION, and DAMPING_FACTOR. The default value is NONE.

stabilizationMagnitude: float

A Float specifying the damping intensity of the automatic damping algorithm if the problem is expected to be unstable, and stabilizationMethod is not NONE. The default value is 2×10–4.

timeIncrementationMethod: SymbolicConstant

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

matrixSolver: SymbolicConstant

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

matrixStorage: SymbolicConstant

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

initialInc: float

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

maxNumInc: int

An Int specifying the maximum number of increments in a step. The default value is 100.

minInc: float

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.

maxInc: float

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

integration: SymbolicConstant

A SymbolicConstant specifying which type of integration to use throughout the step. Possible values are IMPLICIT_EXPLICIT and EXPLICIT_ONLY. The default value is IMPLICIT_EXPLICIT.

cetol: float

A Float specifying the maximum difference in the creep strain increment calculated from the creep strain rates at the beginning and end of the increment. The default value is 0.0.

amplitude: SymbolicConstant

A SymbolicConstant specifying the amplitude variation for loading magnitudes during the step. Possible values are STEP and RAMP. The default value is STEP.

extrapolation: SymbolicConstant

solutionTechnique: SymbolicConstant

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: int

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

convertSDI: SymbolicConstant

adaptiveDampingRatio: float

A Float specifying the maximum allowable ratio of the stabilization energy to the total strain energy and can be used only if stabilizationMethod is not NONE. The default value is 0.05.

continueDampingFactors: Boolean

previous: str

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

description: str

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

explicit: SymbolicConstant

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

perturbation: Boolean

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

nonmechanical: Boolean

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

procedureType: SymbolicConstant

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
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: Boolean

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

fieldOutputRequestState: dict[str, FieldOutputRequestState]

A repository of FieldOutputRequestState objects.

historyOutputRequestState: dict[str, HistoryOutputRequestState]

A repository of HistoryOutputRequestState objects.

diagnosticPrint: DiagnosticPrint

A DiagnosticPrint object.

monitor: Monitor

A Monitor object.

restart: Restart

A Restart object.

adaptiveMeshConstraintStates: dict[str, AdaptiveMeshConstraintState]

A repository of AdaptiveMeshConstraintState objects.

adaptiveMeshDomains: dict[str, AdaptiveMeshDomain]

A repository of AdaptiveMeshDomain objects.

control: Control

A Control object.

solverControl: SolverControl

A SolverControl object.

boundaryConditionStates: dict[str, BoundaryConditionState]

A repository of BoundaryConditionState objects.

interactionStates: int

A repository of InteractionState objects.

loadStates: dict[str, LoadState]

A repository of LoadState objects.

loadCases: dict[str, LoadCase]

A repository of LoadCase objects.

predefinedFieldStates: dict[str, PredefinedFieldState]

A repository of PredefinedFieldState objects.

Methods

setValues([description, timePeriod, nlgeom, ...])

This method modifies the ViscoStep object.

setValues(description: str = '', timePeriod: float = 1, nlgeom: BooleanType = 0, stabilizationMethod: SymbolicConstantType = 'NONE', stabilizationMagnitude: float | None = None, timeIncrementationMethod: SymbolicConstantType = 'AUTOMATIC', matrixSolver: SymbolicConstantType = 'DIRECT', matrixStorage: SymbolicConstantType = 'SOLVER_DEFAULT', initialInc: float | None = None, maxNumInc: int = 100, minInc: float | None = None, maxInc: float = 1, integration: SymbolicConstantType = 'IMPLICIT_EXPLICIT', cetol: float = 0, amplitude: SymbolicConstantType = 'STEP', extrapolation: SymbolicConstantType = 'LINEAR', solutionTechnique: SymbolicConstantType = 'FULL_NEWTON', reformKernel: int = 8, convertSDI: SymbolicConstantType = 'PROPAGATED', adaptiveDampingRatio: float = 0, continueDampingFactors: BooleanType = 0)[source]#

This method modifies the ViscoStep object.

Parameters:

description: A String specifying a description of the new step. The default value is an empty string.
timePeriod: A Float specifying the total time period. The default value is 1.0.
nlgeom: A Boolean specifying whether to allow for geometric nonlinearity. The default value is OFF.
stabilizationMethod: A SymbolicConstant specifying the stabilization type. Possible values are NONE, DISSIPATED_ENERGY_FRACTION, and DAMPING_FACTOR. The default value is NONE.
stabilizationMagnitude: A Float specifying the damping intensity of the automatic damping algorithm if the problem is expected to be unstable, and stabilizationMethod is not NONE. The default value is 2×10–4.
timeIncrementationMethod: A SymbolicConstant specifying the time incrementation method to be used. Possible values are FIXED and AUTOMATIC. The default value is AUTOMATIC.
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.
initialInc: A Float specifying the initial time increment. The default value is the total time period for the step.
maxNumInc: An Int specifying the maximum number of increments in a step. The default value is 100.
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.
maxInc: A Float specifying the maximum time increment allowed. The default is the total time period for the step. The default value is 1.0.
integration: A SymbolicConstant specifying which type of integration to use throughout the step. Possible values are IMPLICIT_EXPLICIT and EXPLICIT_ONLY. The default value is IMPLICIT_EXPLICIT.
cetol: A Float specifying the maximum difference in the creep strain increment calculated from the creep strain rates at the beginning and end of the increment. The default value is 0.0.
amplitude: A SymbolicConstant specifying the amplitude variation for loading magnitudes during the step. Possible values are STEP and RAMP. The default value is STEP.
extrapolation: A SymbolicConstant specifying the type of extrapolation to use in determining the incremental solution for a nonlinear analysis. Possible values are NONE, LINEAR, and PARABOLIC. The default value is LINEAR.
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.
adaptiveDampingRatio: A Float specifying the maximum allowable ratio of the stabilization energy to the total strain energy and can be used only if stabilizationMethod is not NONE. The default value is 0.05.
continueDampingFactors: A Boolean specifying whether this step will carry over the damping factors from the results of the preceding general step. This parameter must be used in conjunction with the adaptiveDampingRatio parameter. The default value is OFF.

Raises:

RangeError