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.

Create steps¶

class StepModel(

name,

description='',

stefanBoltzmann=None,

absoluteZero=None,

waveFormulation=NOT_SET,

modelType=STANDARD_EXPLICIT,

universalGas=None,

copyConstraints=1,

copyConnectors=1,

copyInteractions=1,

)[source]¶

Bases: ModelBase

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

Note

This object can be accessed by:

mdb.models[name]

Note

Check StepModel on help.3ds.com/2023.

Public Data Attributes:

Inherited from ModelBase

name	A String specifying the repository key.
stefanBoltzmann	None or a Float specifying the Stefan-Boltzmann constant.
absoluteZero	None or a Float specifying the absolute zero constant.
waveFormulation	A SymbolicConstant specifying the type of incident wave formulation to be used in acoustic problems.
universalGas	None or a Float specifying the universal gas constant.
noPartsInputFile	A Boolean specifying whether an input file should be written without parts and assemblies.
endRestartStep	A Boolean specifying that the step specified by restartStep should be terminated at the increment specified by restartIncrement.
shellToSolid	A Boolean specifying that a shell global model drives a solid submodel.
lastChangedCount	A Float specifying the time stamp that indicates when the model was last changed.
description	A String specifying the purpose and contents of the Model object.
restartJob	A String specifying the name of the job that generated the restart data.
restartStep	A String specifying the name of the step where the restart analysis will start.
globalJob	A String specifying the name of the job that generated the results for the global model.
copyConstraints	A boolean specifying the status of constraints created in a model, in the model which instances this model.
copyConnectors	A boolean specifying the status of connectors created in a model, in the model which instances this model.
copyInteractions	A boolean specifying the status of interactions created in a model, in the model which instances this model.
keywordBlock	A KeywordBlock object.
amplitudes	A repository of Amplitude objects.
profiles	A repository of Profile objects.
boundaryConditions	A repository of BoundaryCondition objects.
constraints	A repository of ConstrainedSketchConstraint objects.
analyticalFields	A repository of AnalyticalField objects.
discreteFields	A repository of DiscreteField objects.
predefinedFields	A repository of PredefinedField objects.
interactions	A repository of Interaction objects.
interactionProperties	A repository of InteractionProperty objects.
contactControls	A repository of ContactControl objects.
contactInitializations	A repository of ContactInitialization objects.
contactStabilizations	A repository of ContactStabilization objects.
linkedInstances	A tuple of tuples of Strings specifying the linked child PartInstance name in the current model to the corresponding parent PartInstance name in a different model.
linkedParts	A tuple of tuples of Strings specifying the linked child Part name in the current model to the corresponding parent Part name in a different model.
loads	A repository of Load objects.
materials	A repository of Material objects.
calibrations	A repository of Calibration objects.
sections	A repository of Section objects.
remeshingRules	A repository of RemeshingRule objects.
sketches	A repository of ConstrainedSketch objects.
parts	A repository of Part objects.
steps	A repository of Step objects.
featureOptions	A FeatureOptions object.
adaptiveMeshConstraints	A repository of AdaptiveMeshConstraint objects.
adaptiveMeshControls	A repository of AdaptiveMeshControl objects.
timePoints	A repository of TimePoint objects.
filters	A repository of Filter objects.
integratedOutputSections	A repository of IntegratedOutputSection objects.
fieldOutputRequests	A repository of FieldOutputRequest objects.
historyOutputRequests	A repository of HistoryOutputRequest objects.
optimizationTasks	A repository of OptimizationTask objects.
tableCollections	A repository of TableCollection objects.
eventSeriesTypes	A repository of EventSeriesType objects.
eventSeriesDatas	A repository of EventSeriesData objects.
restartIncrement	An Int specifying the increment, interval, iteration or cycle where the restart analysis will start.
rootAssembly	An Assembly object.

Public 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.
CoupledThermalElectricalStructuralStep(name, ...)	This method creates a CoupledThermalElectricalStructuralStep object.
CoupledThermalElectricStep(name, previous[, ...])	This method creates a CoupledThermalElectricStep 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.

Inherited from ModelBase

__init__(name[, description, ...])	This method creates a Model object.
ModelFromInputFile(name, inputFileName)	This method creates a Model object by reading the keywords in an input file and creating the corresponding Abaqus/CAE objects.
ModelFromOdbFile(name, odbFileName)	This method creates a Model object by reading an output database and creating any corresponding Abaqus/CAE objects.
ModelFromNastranFile(modelName, inputFileName)	This method creates a Model object by reading the keywords in a Nastran bulk data file or Nastran input file and creating any corresponding Abaqus/CAE objects.
setValues([description, noPartsInputFile, ...])	This method modifies the Model object.

---

Member Details:

AnnealStep(

name,

previous,

description='',

refTemp=None,

maintainAttributes=False,

)[source]¶

This method creates an AnnealStep object.

Note

This function can be accessed by:

mdb.models[name].AnnealStep

Note

Check AnnealStep on help.3ds.com/2023.

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=None¶

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=False¶

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

Returns:¶

step – An AnnealStep object.

Return type:¶

AnnealStep

BuckleStep(

name,

previous,

numEigen,

description='',

eigensolver=SUBSPACE,

minEigen=None,

maxEigen=None,

vectors=None,

maxIterations=30,

blockSize=DEFAULT,

maxBlocks=DEFAULT,

matrixStorage=SOLVER_DEFAULT,

maintainAttributes=False,

)[source]¶

This method creates a BuckleStep object.

Note

This function can be accessed by:

mdb.models[name].BuckleStep

Note

Check BuckleStep on help.3ds.com/2023.

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=SUBSPACE¶

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

minEigen=None¶

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

maxEigen=None¶

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

vectors=None¶

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=30¶

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

blockSize=DEFAULT¶

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

maxBlocks=DEFAULT¶

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=SOLVER_DEFAULT¶

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

maintainAttributes=False¶

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

Returns:¶

step – A BuckleStep object.

Return type:¶

BuckleStep

ComplexFrequencyStep(

name,

previous,

numEigen=ALL,

description='',

shift=None,

frictionDamping=0,

matrixStorage=SOLVER_DEFAULT,

maintainAttributes=False,

minEigen=None,

maxEigen=None,

propertyEvaluationFrequency=None,

)[source]¶

This method creates a ComplexFrequencyStep object.

Note

This function can be accessed by:

mdb.models[name].ComplexFrequencyStep

Note

Check ComplexFrequencyStep on help.3ds.com/2023.

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=ALL¶

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¶

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

frictionDamping=0¶

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

matrixStorage=SOLVER_DEFAULT¶

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

maintainAttributes=False¶

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

minEigen=None¶

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

maxEigen=None¶

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

propertyEvaluationFrequency=None¶

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 – A ComplexFrequencyStep object.

Return type:¶

ComplexFrequencyStep

CoupledTempDisplacementStep(

name,

previous,

description='',

response=TRANSIENT,

timePeriod=1,

nlgeom=0,

stabilizationMethod=NONE,

stabilizationMagnitude=None,

timeIncrementationMethod=AUTOMATIC,

maxNumInc=100,

initialInc=None,

minInc=None,

maxInc=None,

deltmx=0,

cetol=0,

creepIntegration=IMPLICIT,

solutionTechnique=FULL_NEWTON,

matrixStorage=SOLVER_DEFAULT,

amplitude=STEP,

extrapolation=LINEAR,

maintainAttributes=False,

convertSDI=PROPAGATED,

adaptiveDampingRatio=0,

continueDampingFactors=0,

)[source]¶

This method creates a CoupledTempDisplacementStep object.

Note

This function can be accessed by:

mdb.models[name].CoupledTempDisplacementStep

Note

Check CoupledTempDisplacementStep on help.3ds.com/2023.

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=TRANSIENT¶

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

timePeriod=1¶

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

nlgeom=0¶

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

stabilizationMethod=NONE¶

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

stabilizationMagnitude=None¶

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 2x10⁻⁴.

timeIncrementationMethod=AUTOMATIC¶

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

maxNumInc=100¶

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

initialInc=None¶

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

minInc=None¶

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=None¶

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

deltmx=0¶

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

cetol=0¶

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=IMPLICIT¶

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=FULL_NEWTON¶

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

matrixStorage=SOLVER_DEFAULT¶

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

amplitude=STEP¶

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

extrapolation=LINEAR¶

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=False¶

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

convertSDI=PROPAGATED¶

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=0¶

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=0¶

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 – A CoupledTempDisplacementStep object.

Return type:¶

CoupledTempDisplacementStep

CoupledThermalElectricStep(

name,

previous,

description='',

response=TRANSIENT,

timePeriod=1,

timeIncrementationMethod=AUTOMATIC,

maxNumInc=100,

initialInc=None,

minInc=None,

maxInc=None,

end=PERIOD,

deltmx=0,

mxdem=0,

solutionTechnique=FULL_NEWTON,

matrixStorage=SOLVER_DEFAULT,

amplitude=STEP,

extrapolation=LINEAR,

maintainAttributes=False,

convertSDI=PROPAGATED,

)[source]¶

This method creates a CoupledThermalElectricStep object.

Note

This function can be accessed by:

mdb.models[name].CoupledThermalElectricStep

Note

Check CoupledThermalElectricStep on help.3ds.com/2023.

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=TRANSIENT¶

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

timePeriod=1¶

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

timeIncrementationMethod=AUTOMATIC¶

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

maxNumInc=100¶

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

initialInc=None¶

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

minInc=None¶

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=None¶

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

end=PERIOD¶

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=0¶

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

mxdem=0¶

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

solutionTechnique=FULL_NEWTON¶

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

matrixStorage=SOLVER_DEFAULT¶

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

amplitude=STEP¶

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

extrapolation=LINEAR¶

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=False¶

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

convertSDI=PROPAGATED¶

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 – A CoupledThermalElectricStep object.

Return type:¶

CoupledThermalElectricStep

CoupledThermalElectricalStructuralStep(

name,

previous,

description='',

response=TRANSIENT,

timePeriod=1,

nlgeom=0,

stabilizationMethod=NONE,

stabilizationMagnitude=None,

timeIncrementationMethod=AUTOMATIC,

maxNumInc=100,

initialInc=None,

minInc=None,

maxInc=None,

deltmx=0,

cetol=0,

creepIntegration=IMPLICIT,

matrixStorage=SOLVER_DEFAULT,

amplitude=STEP,

extrapolation=LINEAR,

maintainAttributes=False,

convertSDI=PROPAGATED,

adaptiveDampingRatio=0,

continueDampingFactors=0,

)[source]¶

This method creates a CoupledThermalElectricalStructuralStep object.

Note

This function can be accessed by:

mdb.models[name].CoupledThermalElectricalStructuralStep

Note

Check CoupledThermalElectricalStructuralStep on help.3ds.com/2023.

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=TRANSIENT¶

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

timePeriod=1¶

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

nlgeom=0¶

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

stabilizationMethod=NONE¶

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

stabilizationMagnitude=None¶

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 2x10⁻⁴.

timeIncrementationMethod=AUTOMATIC¶

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

maxNumInc=100¶

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

initialInc=None¶

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

minInc=None¶

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=None¶

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

deltmx=0¶

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

cetol=0¶

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=IMPLICIT¶

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=SOLVER_DEFAULT¶

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

amplitude=STEP¶

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

extrapolation=LINEAR¶

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=False¶

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

convertSDI=PROPAGATED¶

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=0¶

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=0¶

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 – A CoupledThermalElectricalStructuralStep object.

Return type:¶

CoupledThermalElectricalStructuralStep

DirectCyclicStep(

name,

previous,

description='',

timePeriod=1,

timeIncrementationMethod=AUTOMATIC,

maxNumInc=100,

initialInc=None,

minInc=None,

maxInc=None,

maxNumIterations=200,

initialTerms=11,

maxTerms=25,

termsIncrement=5,

deltmx=0,

cetol=0,

timePoints=NONE,

fatigue=0,

continueAnalysis=0,

minCycleInc=100,

maxCycleInc=1000,

maxNumCycles=DEFAULT,

damageExtrapolationTolerance=1,

matrixStorage=SOLVER_DEFAULT,

extrapolation=LINEAR,

maintainAttributes=False,

convertSDI=PROPAGATED,

)[source]¶

This method creates a DirectCyclicStep object.

Note

This function can be accessed by:

mdb.models[name].DirectCyclicStep

Note

Check DirectCyclicStep on help.3ds.com/2023.

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=1¶

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

timeIncrementationMethod=AUTOMATIC¶

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

maxNumInc=100¶

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

initialInc=None¶

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

minInc=None¶

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=None¶

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

maxNumIterations=200¶

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

initialTerms=11¶

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

maxTerms=25¶

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

termsIncrement=5¶

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

deltmx=0¶

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

cetol=0¶

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¶

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=0¶

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

continueAnalysis=0¶

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=100¶

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

maxCycleInc=1000¶

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

maxNumCycles=DEFAULT¶

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=1¶

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

matrixStorage=SOLVER_DEFAULT¶

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

extrapolation=LINEAR¶

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=False¶

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

convertSDI=PROPAGATED¶

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 – A DirectCyclicStep object.

Return type:¶

DirectCyclicStep

EmagTimeHarmonicStep(

name,

previous,

frequencyRange,

description='',

factorization=COMPLEX,

)[source]¶

This method creates a EmagTimeHarmonicStep object.

Note

This function can be accessed by:

mdb.models[name].EmagTimeHarmonicStep

Note

Check EmagTimeHarmonicStep on help.3ds.com/2023.

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=COMPLEX¶

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 – An EmagTimeHarmonicStep object.

Return type:¶

EmagTimeHarmonicStep

ExplicitDynamicsStep(

name,

previous,

description='',

timePeriod=1,

nlgeom=1,

adiabatic=0,

timeIncrementationMethod=AUTOMATIC_GLOBAL,

maxIncrement=None,

scaleFactor=1,

massScaling=PREVIOUS_STEP,

linearBulkViscosity=0,

quadBulkViscosity=1,

userDefinedInc=None,

maintainAttributes=False,

improvedDtMethod=1,

)[source]¶

This method creates an ExplicitDynamicsStep object.

Note

This function can be accessed by:

mdb.models[name].ExplicitDynamicsStep

Note

Check ExplicitDynamicsStep on help.3ds.com/2023.

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=1¶

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

nlgeom=1¶

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

adiabatic=0¶

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

timeIncrementationMethod=AUTOMATIC_GLOBAL¶

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¶

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=1¶

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=PREVIOUS_STEP¶

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

linearBulkViscosity=0¶

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

quadBulkViscosity=1¶

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

userDefinedInc=None¶

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=False¶

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

improvedDtMethod=1¶

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.

Added in version 2018: The improvedDtMethod argument was added.

Returns:¶

step – An ExplicitDynamicsStep object.

Return type:¶

ExplicitDynamicsStep

FrequencyStep(

name,

previous,

eigensolver,

numEigen=ALL,

description='',

shift=0,

minEigen=None,

maxEigen=None,

vectors=None,

maxIterations=30,

blockSize=DEFAULT,

maxBlocks=DEFAULT,

normalization=DISPLACEMENT,

propertyEvaluationFrequency=None,

projectDamping=1,

acousticCoupling=AC_ON,

acousticRangeFactor=1,

frictionDamping=0,

matrixStorage=SOLVER_DEFAULT,

maintainAttributes=False,

simLinearDynamics=0,

residualModes=0,

substructureCutoffMultiplier=5,

firstCutoffMultiplier=1,

secondCutoffMultiplier=1,

residualModeRegion=None,

residualModeDof=None,

limitSavedEigenvectorRegion=None,

)[source]¶

This method creates a FrequencyStep object.

Note

This function can be accessed by:

mdb.models[name].FrequencyStep

Note

Check FrequencyStep on help.3ds.com/2023.

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=ALL¶

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=0¶

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

minEigen=None¶

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

maxEigen=None¶

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

vectors=None¶

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=30¶

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

blockSize=DEFAULT¶

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

maxBlocks=DEFAULT¶

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

normalization=DISPLACEMENT¶

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¶

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=1¶

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=AC_ON¶

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=1¶

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

frictionDamping=0¶

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

matrixStorage=SOLVER_DEFAULT¶

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

maintainAttributes=False¶

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

simLinearDynamics=0¶

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

residualModes=0¶

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

substructureCutoffMultiplier=5¶

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=1¶

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=1¶

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¶

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¶

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

limitSavedEigenvectorRegion=None¶

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 – A FrequencyStep object.

Return type:¶

FrequencyStep

GeostaticStep(

name,

previous,

description='',

nlgeom=0,

matrixSolver=DIRECT,

matrixStorage=SOLVER_DEFAULT,

maintainAttributes=False,

solutionTechnique=FULL_NEWTON,

reformKernel=8,

convertSDI=PROPAGATED,

utol=None,

timePeriod=1,

timeIncrementationMethod=AUTOMATIC,

maxNumInc=100,

initialInc=None,

minInc=None,

maxInc=None,

)[source]¶

This method creates a GeostaticStep object.

Note

This function can be accessed by:

mdb.models[name].GeostaticStep

Note

Check GeostaticStep on help.3ds.com/2023.

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=0¶

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

matrixSolver=DIRECT¶

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

matrixStorage=SOLVER_DEFAULT¶

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

maintainAttributes=False¶

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

solutionTechnique=FULL_NEWTON¶

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=8¶

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

convertSDI=PROPAGATED¶

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¶

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

timePeriod=1¶

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

timeIncrementationMethod=AUTOMATIC¶

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

maxNumInc=100¶

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

Added in version 2017: The maxNumInc attribute was added to the GeostaticStep class.

initialInc=None¶

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=None¶

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=None¶

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 – A GeostaticStep object.

Return type:¶

GeostaticStep

HeatTransferStep(

name,

previous,

description='',

response=TRANSIENT,

timePeriod=1,

timeIncrementationMethod=AUTOMATIC,

maxNumInc=100,

initialInc=None,

minInc=None,

maxInc=None,

end=None,

deltmx=0,

mxdem=0,

amplitude=STEP,

extrapolation=LINEAR,

matrixSolver=DIRECT,

matrixStorage=SOLVER_DEFAULT,

maintainAttributes=False,

solutionTechnique=FULL_NEWTON,

reformKernel=8,

convertSDI=PROPAGATED,

)[source]¶

This method creates a HeatTransferStep object.

Note

This function can be accessed by:

mdb.models[name].HeatTransferStep

Note

Check HeatTransferStep on help.3ds.com/2023.

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=TRANSIENT¶

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

timePeriod=1¶

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

timeIncrementationMethod=AUTOMATIC¶

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

maxNumInc=100¶

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

initialInc=None¶

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

minInc=None¶

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=None¶

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

end=None¶

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=0¶

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=0¶

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

amplitude=STEP¶

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

extrapolation=LINEAR¶

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=DIRECT¶

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

matrixStorage=SOLVER_DEFAULT¶

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

maintainAttributes=False¶

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

solutionTechnique=FULL_NEWTON¶

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=8¶

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

convertSDI=PROPAGATED¶

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 – A HeatTransferStep object.

Return type:¶

HeatTransferStep

ImplicitDynamicsStep(

name,

previous,

description='',

timePeriod=1,

nlgeom=0,

matrixStorage=SOLVER_DEFAULT,

application=ANALYSIS_PRODUCT_DEFAULT,

adiabatic=0,

timeIncrementationMethod=AUTOMATIC,

maxNumInc=100,

initialInc=None,

minInc=None,

maxInc=DEFAULT,

hafTolMethod=VALUE,

haftol=None,

halfIncScaleFactor=None,

nohaf=0,

amplitude=STEP,

alpha=DEFAULT,

initialConditions=DEFAULT,

extrapolation=ANALYSIS_PRODUCT_DEFAULT,

noStop=0,

maintainAttributes=False,

solutionTechnique=FULL_NEWTON,

reformKernel=8,

convertSDI=PROPAGATED,

)[source]¶

This method creates an ImplicitDynamicsStep object.

Note

This function can be accessed by:

mdb.models[name].ImplicitDynamicsStep

Note

Check ImplicitDynamicsStep on help.3ds.com/2023.

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=1¶

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

nlgeom=0¶

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

matrixStorage=SOLVER_DEFAULT¶

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

application=ANALYSIS_PRODUCT_DEFAULT¶

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=0¶

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

timeIncrementationMethod=AUTOMATIC¶

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

maxNumInc=100¶

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

initialInc=None¶

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

minInc=None¶

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=DEFAULT¶

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

hafTolMethod=VALUE¶

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¶

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¶

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=0¶

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

amplitude=STEP¶

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

alpha=DEFAULT¶

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=DEFAULT¶

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=ANALYSIS_PRODUCT_DEFAULT¶

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=0¶

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=False¶

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

solutionTechnique=FULL_NEWTON¶

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=8¶

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

convertSDI=PROPAGATED¶

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 – An ImplicitDynamicsStep object.

Return type:¶

ImplicitDynamicsStep

MassDiffusionStep(

name,

previous,

description='',

response=TRANSIENT,

timePeriod=1,

timeIncrementationMethod=AUTOMATIC,

maxNumInc=100,

initialInc=None,

minInc=None,

maxInc=None,

end=PERIOD,

dcmax=0,

amplitude=STEP,

extrapolation=LINEAR,

maintainAttributes=False,

convertSDI=PROPAGATED,

)[source]¶

This method creates a MassDiffusionStep object.

Note

This function can be accessed by:

mdb.models[name].MassDiffusionStep

Note

Check MassDiffusionStep on help.3ds.com/2023.

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=TRANSIENT¶

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

timePeriod=1¶

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

timeIncrementationMethod=AUTOMATIC¶

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

maxNumInc=100¶

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

initialInc=None¶

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

minInc=None¶

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=None¶

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

end=PERIOD¶

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=0¶

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

amplitude=STEP¶

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

extrapolation=LINEAR¶

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=False¶

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

convertSDI=PROPAGATED¶

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 – A MassDiffusionStep object.

Return type:¶

MassDiffusionStep

ModalDynamicsStep(

name,

previous,

description='',

continueAnalysis=0,

timePeriod=1,

incSize=1,

directDamping=None,

compositeDamping=None,

rayleighDamping=None,

amplitude=STEP,

maintainAttributes=False,

directDampingByFrequency=None,

rayleighDampingByFrequency=None,

)[source]¶

This method creates a ModalDynamicsStep object.

Note

This function can be accessed by:

mdb.models[name].ModalDynamicsStep

Note

Check ModalDynamicsStep on help.3ds.com/2023.

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=0¶

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

timePeriod=1¶

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

incSize=1¶

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

directDamping=None¶

A DirectDamping object.

compositeDamping=None¶

A CompositeDamping object.

rayleighDamping=None¶

A RayleighDamping object.

amplitude=STEP¶

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

maintainAttributes=False¶

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

directDampingByFrequency=None¶

A DirectDampingByFrequency object.

rayleighDampingByFrequency=None¶

A RayleighDampingByFrequency object.

Returns:¶

step – A ModalDynamicsStep object.

Return type:¶

ModalDynamicsStep

RandomResponseStep(

name,

previous,

freq,

description='',

scale=LOG,

directDamping=None,

compositeDamping=None,

rayleighDamping=None,

structuralDamping=None,

directDampingByFrequency=None,

rayleighDampingByFrequency=None,

structuralDampingByFrequency=None,

maintainAttributes=False,

)[source]¶

This method creates a RandomResponseStep object.

Note

This function can be accessed by:

mdb.models[name].RandomResponseStep

Note

Check RandomResponseStep on help.3ds.com/2023.

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=LOG¶

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

directDamping=None¶

A DirectDamping object.

compositeDamping=None¶

A CompositeDamping object.

rayleighDamping=None¶

A RayleighDamping object.

structuralDamping=None¶

A StructuralDamping object.

directDampingByFrequency=None¶

A DirectDampingByFrequency object.

rayleighDampingByFrequency=None¶

A RayleighDampingByFrequency object.

structuralDampingByFrequency=None¶

A StructuralDampingByFrequency object.

maintainAttributes=False¶

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

Returns:¶

step – A RandomResponseStep object.

Return type:¶

RandomResponseStep

ResponseSpectrumStep(

name,

previous,

components,

description='',

comp=SINGLE_DIRECTION,

sum=ABS,

directDamping=None,

compositeDamping=None,

rayleighDamping=None,

directDampingByFrequency=None,

rayleighDampingByFrequency=None,

maintainAttributes=False,

)[source]¶

This method creates a ResponseSpectrumStep object.

Note

This function can be accessed by:

mdb.models[name].ResponseSpectrumStep

Note

Check ResponseSpectrumStep on help.3ds.com/2023.

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=SINGLE_DIRECTION¶

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=ABS¶

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=None¶

A DirectDamping object.

compositeDamping=None¶

A CompositeDamping object.

rayleighDamping=None¶

A RayleighDamping object.

directDampingByFrequency=None¶

A DirectDampingByFrequency object.

rayleighDampingByFrequency=None¶

A RayleighDampingByFrequency object.

maintainAttributes=False¶

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

Returns:¶

step – A ResponseSpectrumStep object.

Return type:¶

ResponseSpectrumStep

SoilsStep(

name,

previous,

description='',

response=TRANSIENT,

timePeriod=1,

nlgeom=0,

stabilizationMethod=NONE,

stabilizationMagnitude=None,

creep=1,

timeIncrementationMethod=AUTOMATIC,

initialInc=None,

minInc=None,

maxInc=None,

maxNumInc=100,

end=PERIOD,

utol=None,

cetol=0,

amplitude=STEP,

extrapolation=LINEAR,

matrixSolver=DIRECT,

matrixStorage=SOLVER_DEFAULT,

maintainAttributes=False,

solutionTechnique=FULL_NEWTON,

reformKernel=8,

convertSDI=PROPAGATED,

adaptiveDampingRatio=0,

continueDampingFactors=0,

)[source]¶

This method creates a SoilsStep object.

Note

This function can be accessed by:

mdb.models[name].SoilsStep

Note

Check SoilsStep on help.3ds.com/2023.

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=TRANSIENT¶

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

timePeriod=1¶

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

nlgeom=0¶

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

stabilizationMethod=NONE¶

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

stabilizationMagnitude=None¶

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 2x10⁻⁴.

creep=1¶

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

timeIncrementationMethod=AUTOMATIC¶

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

initialInc=None¶

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

minInc=None¶

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=None¶

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

maxNumInc=100¶

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

end=PERIOD¶

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¶

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=0¶

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=STEP¶

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

extrapolation=LINEAR¶

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=DIRECT¶

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

matrixStorage=SOLVER_DEFAULT¶

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

maintainAttributes=False¶

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

solutionTechnique=FULL_NEWTON¶

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=8¶

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

convertSDI=PROPAGATED¶

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=0¶

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=0¶

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 – A SoilsStep object.

Return type:¶

SoilsStep

StaticLinearPerturbationStep(

name,

previous,

description='',

matrixSolver=DIRECT,

matrixStorage=SOLVER_DEFAULT,

maintainAttributes=False,

)[source]¶

This method creates a StaticLinearPerturbationStep object.

Note

This function can be accessed by:

mdb.models[name].StaticLinearPerturbationStep

Note

Check StaticLinearPerturbationStep on help.3ds.com/2023.

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=DIRECT¶

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

matrixStorage=SOLVER_DEFAULT¶

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

maintainAttributes=False¶

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

Returns:¶

step – A StaticLinearPerturbationStep object.

Return type:¶

StaticLinearPerturbationStep

StaticRiksStep(

name,

previous,

description='',

nlgeom=0,

adiabatic=0,

maxLPF=None,

nodeOn=0,

maximumDisplacement=0,

dof=0,

region=None,

timeIncrementationMethod=AUTOMATIC,

maxNumInc=100,

totalArcLength=1,

initialArcInc=None,

minArcInc=None,

maxArcInc=None,

matrixStorage=SOLVER_DEFAULT,

extrapolation=LINEAR,

fullyPlastic='',

noStop=0,

maintainAttributes=False,

useLongTermSolution=0,

convertSDI=PROPAGATED,

)[source]¶

This method creates a StaticRiksStep object.

Note

This function can be accessed by:

mdb.models[name].StaticRiksStep

Note

Check StaticRiksStep on help.3ds.com/2023.

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=0¶

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

adiabatic=0¶

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

maxLPF=None¶

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

nodeOn=0¶

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

maximumDisplacement=0¶

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=0¶

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

region=None¶

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

timeIncrementationMethod=AUTOMATIC¶

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

maxNumInc=100¶

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

totalArcLength=1¶

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

initialArcInc=None¶

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

minArcInc=None¶

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=None¶

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

matrixStorage=SOLVER_DEFAULT¶

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

extrapolation=LINEAR¶

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=0¶

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=False¶

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

useLongTermSolution=0¶

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=PROPAGATED¶

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 – A StaticRiksStep object.

Return type:¶

StaticRiksStep

StaticStep(

name,

previous,

description='',

timePeriod=1,

nlgeom=0,

stabilizationMethod=NONE,

stabilizationMagnitude=None,

adiabatic=0,

timeIncrementationMethod=AUTOMATIC,

maxNumInc=100,

initialInc=None,

minInc=None,

maxInc=None,

matrixSolver=DIRECT,

matrixStorage=SOLVER_DEFAULT,

amplitude=RAMP,

extrapolation=LINEAR,

fullyPlastic='',

noStop=0,

maintainAttributes=False,

useLongTermSolution=0,

solutionTechnique=FULL_NEWTON,

reformKernel=8,

convertSDI=PROPAGATED,

adaptiveDampingRatio=0,

continueDampingFactors=0,

)[source]¶

This method creates a StaticStep object.

Note

This function can be accessed by:

mdb.models[name].StaticStep

Note

Check StaticStep on help.3ds.com/2023.

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=1¶

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

nlgeom=0¶

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

stabilizationMethod=NONE¶

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

stabilizationMagnitude=None¶

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 2x10⁻⁴.

adiabatic=0¶

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

timeIncrementationMethod=AUTOMATIC¶

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

maxNumInc=100¶

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

initialInc=None¶

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

minInc=None¶

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

maxInc=None¶

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

matrixSolver=DIRECT¶

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

matrixStorage=SOLVER_DEFAULT¶

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

amplitude=RAMP¶

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

extrapolation=LINEAR¶

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=0¶

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=False¶

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

useLongTermSolution=0¶

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=FULL_NEWTON¶

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=8¶

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

convertSDI=PROPAGATED¶

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=0¶

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=0¶

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 – A StaticRiksStep object.

Return type:¶

StaticRiksStep

SteadyStateDirectStep(

name,

previous,

frequencyRange,

description='',

factorization=COMPLEX,

scale=LOGARITHMIC,

matrixStorage=SOLVER_DEFAULT,

maintainAttributes=False,

subdivideUsingEigenfrequencies=0,

frictionDamping=0,

)[source]¶

This method creates a SteadyStateDirectStep object.

Note

This function can be accessed by:

mdb.models[name].SteadyStateDirectStep

Note

Check SteadyStateDirectStep on help.3ds.com/2023.

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=COMPLEX¶

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=LOGARITHMIC¶

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=SOLVER_DEFAULT¶

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

maintainAttributes=False¶

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

subdivideUsingEigenfrequencies=0¶

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

frictionDamping=0¶

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

Returns:¶

step – A SteadyStateDirectStep object.

Return type:¶

SteadyStateDirectStep

SteadyStateModalStep(

name,

previous,

frequencyRange,

description='',

scale=LOGARITHMIC,

directDamping=None,

compositeDamping=None,

rayleighDamping=None,

structuralDamping=None,

directDampingByFrequency=None,

rayleighDampingByFrequency=None,

structuralDampingByFrequency=None,

maintainAttributes=False,

subdivideUsingEigenfrequencies=1,

)[source]¶

This method creates a SteadyStateModalStep object.

Note

This function can be accessed by:

mdb.models[name].SteadyStateModalStep

Note

Check SteadyStateModalStep on help.3ds.com/2023.

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=LOGARITHMIC¶

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=None¶

A DirectDamping object.

compositeDamping=None¶

A CompositeDamping object.

rayleighDamping=None¶

A RayleighDamping object.

structuralDamping=None¶

A StructuralDamping object.

directDampingByFrequency=None¶

A DirectDampingByFrequency object.

rayleighDampingByFrequency=None¶

A RayleighDampingByFrequency object.

structuralDampingByFrequency=None¶

A StructuralDampingByFrequency object.

maintainAttributes=False¶

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

subdivideUsingEigenfrequencies=1¶

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

Returns:¶

step – A SteadyStateModalStep object.

Return type:¶

SteadyStateModalStep

SteadyStateSubspaceStep(

name,

previous,

frequencyRange,

description='',

factorization=COMPLEX,

scale=LOGARITHMIC,

matrixStorage=SOLVER_DEFAULT,

maintainAttributes=False,

subdivideUsingEigenfrequencies=1,

projection=ALL_FREQUENCIES,

maxDampingChange=0,

maxStiffnessChange=0,

frictionDamping=0,

)[source]¶

This method creates a SteadyStateSubspaceStep object.

Note

This function can be accessed by:

mdb.models[name].SteadyStateSubspaceStep

Note

Check SteadyStateSubspaceStep on help.3ds.com/2023.

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=COMPLEX¶

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=LOGARITHMIC¶

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=SOLVER_DEFAULT¶

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

maintainAttributes=False¶

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

subdivideUsingEigenfrequencies=1¶

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

projection=ALL_FREQUENCIES¶

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=0¶

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=0¶

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=0¶

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

Returns:¶

step – A SteadyStateSubspaceStep object.

Return type:¶

SteadyStateSubspaceStep

SubspaceDynamicsStep(

name,

previous,

description='',

timePeriod=1,

vectors=ALL,

nlgeom=0,

maxNumInc=100,

incSize=0,

amplitude=STEP,

maintainAttributes=False,

)[source]¶

This method creates a SubspaceDynamicsStep object.

Note

This function can be accessed by:

mdb.models[name].SubspaceDynamicsStep

Note

Check SubspaceDynamicsStep on help.3ds.com/2023.

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=1¶

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

vectors=ALL¶

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=0¶

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

maxNumInc=100¶

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

incSize=0¶

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

amplitude=STEP¶

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

maintainAttributes=False¶

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

Returns:¶

step – A SubspaceDynamicsStep object.

Return type:¶

SubspaceDynamicsStep

SubstructureGenerateStep(

name,

previous,

substructureIdentifier,

description='',

recoveryMatrix=WHOLE_MODEL,

recoveryRegion=None,

computeGravityLoadVectors=False,

computeReducedMassMatrix=False,

computeReducedStructuralDampingMatrix=False,

computeReducedViscousDampingMatrix=False,

evaluateFrequencyDependentProperties=False,

frequency=0,

retainedEigenmodesMethod=NONE,

modeRange=None,

frequencyRange=None,

globalDampingField=NONE,

alphaDampingRatio=0,

betaDampingRatio=0,

structuralDampingRatio=0,

viscousDampingControl=NONE,

structuralDampingControl=NONE,

)[source]¶

This method creates a SubstructureGenerateStep object.

Note

This function can be accessed by:

mdb.models[name].SubstructureGenerateStep

Note

Check SubstructureGenerateStep on help.3ds.com/2023.

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=WHOLE_MODEL¶

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

recoveryRegion=None¶

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

computeGravityLoadVectors=False¶

A Boolean specifying whether to compute the gravity load vectors. The default value is False.

computeReducedMassMatrix=False¶

A Boolean specifying whether to compute the reduced mass matrix. The default value is False.

computeReducedStructuralDampingMatrix=False¶

A Boolean specifying whether to compute the reduced structural damping matrix. The default value is False.

computeReducedViscousDampingMatrix=False¶

A Boolean specifying whether to compute the reduced viscous damping matrix. The default value is False.

evaluateFrequencyDependentProperties=False¶

A Boolean specifying whether to evaluate the frequency dependent properties. The default value is False.

frequency=0¶

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

retainedEigenmodesMethod=NONE¶

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

modeRange=None¶

A SubstructureGenerateModesArray object.

frequencyRange=None¶

A SubstructureGenerateFrequencyArray object.

globalDampingField=NONE¶

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=0¶

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

betaDampingRatio=0¶

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

structuralDampingRatio=0¶

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

viscousDampingControl=NONE¶

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=NONE¶

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 – A SubstructureGenerateStep object.

Return type:¶

SubstructureGenerateStep

TempDisplacementDynamicsStep(

name,

previous,

description='',

timePeriod=1,

nlgeom=0,

timeIncrementationMethod=AUTOMATIC_GLOBAL,

maxIncrement=None,

scaleFactor=1,

userDefinedInc=None,

massScaling=PREVIOUS_STEP,

linearBulkViscosity=0,

quadBulkViscosity=1,

maintainAttributes=False,

improvedDtMethod=1,

)[source]¶

This method creates a TempDisplacementDynamicsStep object.

Note

This function can be accessed by:

mdb.models[name].TempDisplacementDynamicsStep

Note

Check TempDisplacementDynamicsStep on help.3ds.com/2023.

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=1¶

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

nlgeom=0¶

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

timeIncrementationMethod=AUTOMATIC_GLOBAL¶

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¶

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

scaleFactor=1¶

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¶

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

massScaling=PREVIOUS_STEP¶

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

linearBulkViscosity=0¶

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

quadBulkViscosity=1¶

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

maintainAttributes=False¶

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

improvedDtMethod=1¶

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.

Added in version 2018: The improvedDtMethod argument was added.

Returns:¶

step – A TempDisplacementDynamicsStep object.

Return type:¶

TempDisplacementDynamicsStep

ViscoStep(

name,

previous,

description='',

timePeriod=1,

nlgeom=0,

stabilizationMethod=NONE,

stabilizationMagnitude=None,

timeIncrementationMethod=AUTOMATIC,

matrixSolver=DIRECT,

matrixStorage=SOLVER_DEFAULT,

initialInc=None,

maxNumInc=100,

minInc=None,

maxInc=1,

integration=IMPLICIT_EXPLICIT,

cetol=0,

amplitude=STEP,

extrapolation=LINEAR,

maintainAttributes=False,

solutionTechnique=FULL_NEWTON,

reformKernel=8,

convertSDI=PROPAGATED,

adaptiveDampingRatio=0,

continueDampingFactors=0,

)[source]¶

This method creates a ViscoStep object.

Note

This function can be accessed by:

mdb.models[name].ViscoStep

Note

Check ViscoStep on help.3ds.com/2023.

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=1¶

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

nlgeom=0¶

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

stabilizationMethod=NONE¶

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

stabilizationMagnitude=None¶

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 2x10⁻⁴.

timeIncrementationMethod=AUTOMATIC¶

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

matrixSolver=DIRECT¶

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

matrixStorage=SOLVER_DEFAULT¶

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

initialInc=None¶

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

maxNumInc=100¶

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

minInc=None¶

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=1¶

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=IMPLICIT_EXPLICIT¶

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=0¶

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=STEP¶

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

extrapolation=LINEAR¶

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=False¶

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

solutionTechnique=FULL_NEWTON¶

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=8¶

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

convertSDI=PROPAGATED¶

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=0¶

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=0¶

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 – A ViscoStep object.

Return type:¶

ViscoStep