Output Request

Step output commands are used for configuring output requests, integrated output sections, diagnostic printing, monitoring, and restart.

Create output requests for Model

class OutputModel(
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]

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:

FieldOutputRequest(name, createStepName[, ...])

This method creates a FieldOutputRequest object.

HistoryOutputRequest(name, createStepName[, ...])

This method creates a HistoryOutputRequest object.

IntegratedOutputSection(name, surface[, ...])

This method creates an IntegratedOutputSection object.

TimePoint(name, points)

This method creates a TimePoint 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:

FieldOutputRequest(
name,
createStepName,
region=MODEL,
variables=PRESELECT,
frequency=1,
modes=ALL,
timeInterval=EVERY_TIME_INCREMENT,
numIntervals=20,
timeMarks=0,
boltLoad='',
sectionPoints=DEFAULT,
interactions=None,
rebar=EXCLUDE,
filter=None,
directions=1,
fasteners='',
assembledFastener='',
assembledFastenerSet='',
exteriorOnly=0,
layupNames='',
layupLocationMethod=SPECIFIED,
outputAtPlyTop=False,
outputAtPlyMid=True,
outputAtPlyBottom=False,
position=INTEGRATION_POINTS,
)[source]

This method creates a FieldOutputRequest object.

Note

This function can be accessed by:

mdb.models[name].FieldOutputRequest
Parameters:
name

A String specifying the repository key.

createStepName

A String specifying the name of the step in which the object is created.

region=MODEL

The SymbolicConstant MODEL or a Region object specifying the region from which output is requested. The SymbolicConstant MODEL represents the whole model. The default value is MODEL.

variables=PRESELECT

A sequence of Strings specifying output request variable or component names, or the SymbolicConstant PRESELECT or ALL. PRESELECT represents all default output variables for the given step. ALL represents all valid output variables. The default value is PRESELECT.

frequency=1

The SymbolicConstant LAST_INCREMENT or an Int specifying the output frequency in increments. The default value is 1.

modes=ALL

The SymbolicConstant ALL or a sequence of Ints specifying a list of eigenmodes for which output is desired. The default value is ALL.

timeInterval=EVERY_TIME_INCREMENT

The SymbolicConstant EVERY_TIME_INCREMENT or a Float specifying the time interval at which the output states are to be written. The default value is EVERY_TIME_INCREMENT.

numIntervals=20

An Int specifying the number of intervals during the step at which output database states are to be written. The default value is 20.

timeMarks=0

A Boolean specifying when to write results to the output database. OFF indicates that output is written immediately after the time dictated by the specified number of intervals. ON indicates that output is written at the exact times dictated by the specified number of intervals. The default value is OFF.

boltLoad=''

A String specifying a bolt load from which output is requested.

sectionPoints=DEFAULT

The SymbolicConstant DEFAULT or a sequence of Ints specifying the section points for which output requested. The default is DEFAULT.

interactions=None

None or a sequence of Strings specifying the interaction names. The default value is None.The sequence can contain only one String.

rebar=EXCLUDE

A SymbolicConstant specifying whether output is requested for rebar. Possible values are EXCLUDE, INCLUDE, and ONLY. The default value is EXCLUDE.

filter=None

The SymbolicConstant ANTIALIASING or a String specifying the name of an output filter object. The default value is None.

directions=1

A Boolean specifying whether to output directions of the local material coordinate system. The default value is ON.

fasteners=''

A String specifying the fastener name. The default value is an empty string.

assembledFastener=''

A String specifying the assembled fastener name. The default value is an empty string.

assembledFastenerSet=''

A String specifying the set name from the model referenced by the assembled fastener, assembledFastener. The default value is an empty string.

exteriorOnly=0

A Boolean specifying whether the output domain is restricted to the exterior of the model. This argument is only valid if region = MODEL. The default value is OFF.

layupNames=''

A List of Composite Layer Names.

layupLocationMethod=SPECIFIED

A Symbolic constant specifying the method used to indicate the output locations for composite layups. Possible values are ALL_LOCATIONS, SPECIFIED and TYPED_IN. The default value is SPECIFIED.

outputAtPlyTop=False

A Boolean specifying whether to output at the ply top section point. The default value is False.

outputAtPlyMid=True

A Boolean specifying whether to output at the ply mid section point. The default value is True.

outputAtPlyBottom=False

A Boolean specifying whether to output at the ply bottom section point. The default value is False.

position=INTEGRATION_POINTS

A SymbolicConstant specifying the position on an element where output needs to be written. Possible values are INTEGRATION_POINTS, AVERAGED_AT_NODES, CENTROIDAL, and NODES. The default value is INTEGRATION_POINTS.

Returns:

A FieldOutputRequest object.

Return type:

FieldOutputRequest

HistoryOutputRequest(
name,
createStepName,
region=MODEL,
variables=PRESELECT,
frequency=1,
modes=ALL,
timeInterval=EVERY_TIME_INCREMENT,
numIntervals=20,
boltLoad='',
sectionPoints=DEFAULT,
stepName='',
interactions=None,
contourIntegral=None,
numberOfContours=0,
stressInitializationStep=None,
contourType=J_INTEGRAL,
kFactorDirection=MTS,
rebar=EXCLUDE,
integratedOutputSection='',
springs=None,
filter=None,
fasteners='',
assembledFastener='',
assembledFastenerSet='',
sensor=0,
useGlobal=True,
)[source]

This method creates a HistoryOutputRequest object.

Note

This function can be accessed by:

mdb.models[name].HistoryOutputRequest
Parameters:
name

A String specifying the repository key.

createStepName

A String specifying the name of the step in which the object is created.

region=MODEL

The SymbolicConstant MODEL or a Region object specifying the region from which output is requested. The SymbolicConstant MODEL represents the whole model. The default value is MODEL. If the region is a surface region, the surface must lie within the general contact surface domain.

variables=PRESELECT

A sequence of Strings specifying output request variable or component names, or the SymbolicConstant PRESELECT or ALL. PRESELECT represents all default output variables for the given step. ALL represents all valid output variables. The default value is PRESELECT.

frequency=1

The SymbolicConstant LAST_INCREMENT or an Int specifying the output frequency in increments. The default value is 1.

modes=ALL

The SymbolicConstant ALL or a sequence of Ints specifying a list of eigenmodes for which output is desired. The default value is ALL.

timeInterval=EVERY_TIME_INCREMENT

The SymbolicConstant EVERY_TIME_INCREMENT or a Float specifying the time interval at which the output states are to be written. The default value is EVERY_TIME_INCREMENT.

numIntervals=20

An Int specifying the number of intervals during the step at which output database states are to be written. The default value is 20.

boltLoad=''

A String specifying a bolt load from which output is requested. The default value is an empty string.

sectionPoints=DEFAULT

The SymbolicConstant DEFAULT or a sequence of Ints specifying the section points for which output is requested. The default value is DEFAULT.

stepName=''

A String specifying the name of the step. The default value is an empty string.

interactions=None

None or a sequence of Strings specifying the interaction names. The default value is None.The sequence can contain only one String.

contourIntegral=None

A String specifying the contour integral name. The default value is None.

numberOfContours=0

An Int specifying the number of contour integrals to output for the contour integral object. The default value is 0.

stressInitializationStep=None

A String specifying the name of the stress initialization step. The default value is None.

contourType=J_INTEGRAL

A SymbolicConstant specifying the type of contour integral. Possible values are J_INTEGRAL, C_INTEGRAL, T_STRESS, and K_FACTORS. The default value is J_INTEGRAL.

kFactorDirection=MTS

A SymbolicConstant specifying the stress intensity factor direction. Possible values are MTS, MERR, and K110. The kFactorDirection argument is valid only if contourType = K_FACTORS. The default value is MTS.

rebar=EXCLUDE

A SymbolicConstant specifying whether output is requested for rebar. Possible values are EXCLUDE, INCLUDE, and ONLY. The default value is EXCLUDE.

integratedOutputSection=''

A String specifying the integrated output section. The default value is an empty string.

springs=None

A sequence of Strings specifying the springs/dashpots names. The default value is None. The sequence can contain only one String.

filter=None

The SymbolicConstant ANTIALIASING or a String specifying the name of an output filter object. The default value is None.

fasteners=''

A String specifying the fastener name. The default value is an empty string.

assembledFastener=''

A String specifying the assembled fastener name. The default value is an empty string.

assembledFastenerSet=''

A String specifying the set name from the model referenced by the assembled fastener, assembledFastener. The default value is an empty string.

sensor=0

A Boolean specifying whether to associate the output request with a sensor definition. The default value is OFF.

useGlobal=True

A Boolean specifying whether to output vector-valued nodal variables in the global directions. The default value is True.

Returns:

A HistoryOutputRequest object.

Return type:

HistoryOutputRequest

IntegratedOutputSection(
name,
surface,
refPoint=None,
refPointAtCenter=0,
refPointMotion=INDEPENDENT,
localCsys=None,
projectOrientation=0,
)[source]

This method creates an IntegratedOutputSection object.

Note

This function can be accessed by:

mdb.models[name].IntegratedOutputSection
Parameters:
name

A String specifying the repository key.

surface

A Region object specifying the surface over which the output is based.

refPoint=None

None or a Region object specifying the anchor point about which the integrated moment over the output region is computed or the SymbolicConstant None representing the global origin. The default value is None.

refPointAtCenter=0

A Boolean specifying that the refPoint be adjusted so that it coincides with the center of the output region in the initial configuration. This argument is valid only when you include the refPoint argument. The default value is OFF.

refPointMotion=INDEPENDENT

A SymbolicConstant specifying how to relate the motion of refPoint to the average motion of the output region. A value of INDEPENDENT will allow the refPoint to move independent of the output region. A value of AVERAGE_TRANSLATION will set the displacement of the refPoint equal to the average translation of the output region. A value of AVERAGE will set the displacement and rotation of the refPoint equal to the average translation of the output region. The default value is INDEPENDENT.This argument is valid only when you include the refPoint argument.

localCsys=None

None or a DatumCsys object specifying the local coordinate system used to express vector output. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

projectOrientation=0

A Boolean specifying that the coordinate system be projected onto the surface such that the 1-axis is normal to the surface. Projection onto a planar surface is such that the 1-axis is normal to the surface, and a projection onto a nonplanar surface is such that a least-squares fit surface will be used. The default value is OFF.

Returns:

An IntegratedOutputSection object.

Return type:

IntegratedOutputSection

TimePoint(name, points)[source]

This method creates a TimePoint object.

Note

This function can be accessed by:

mdb.models[name].TimePoint
Parameters:
name

A String specifying the repository key.

points

A sequence of sequences of Floats specifying time points at which data are written to the output database or restart files.

Returns:

A TimePoint object.

Return type:

TimePoint

Raises:
  • InvalidNameError

  • RangeError

Create DiagnosticPrint, Monitor and Restart information for Step

class OutputStep[source]

Bases: StepBase

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

Note

This object can be accessed by:

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

Public Data Attributes:

Inherited from StepBase

name

A String specifying the repository key.

perturbation

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

nonmechanical

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

suppressed

A Boolean specifying whether the step is suppressed or not.

fieldOutputRequestState

A repository of FieldOutputRequestState objects.

historyOutputRequestState

A repository of HistoryOutputRequestState objects.

diagnosticPrint

A DiagnosticPrint object.

monitor

A Monitor object.

restart

A Restart object.

adaptiveMeshConstraintStates

A repository of AdaptiveMeshConstraintState objects.

adaptiveMeshDomains

A repository of AdaptiveMeshDomain objects.

control

A Control object.

solverControl

A SolverControl object.

boundaryConditionStates

A repository of BoundaryConditionState objects.

interactionStates

A repository of InteractionState objects.

loadStates

A repository of LoadState objects.

loadCases

A repository of LoadCase objects.

predefinedFieldStates

A repository of PredefinedFieldState objects.

activateElements

A repository of ActivateElements objects.

explicit

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

procedureType

A SymbolicConstant specifying the Abaqus procedure.

Public Methods:

DiagnosticPrint([allke, criticalElement, ...])

This method creates a DiagnosticPrint object.

Monitor(node, dof, frequency)

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

Restart([numberIntervals, timeMarks, ...])

This method creates a restart request.

Inherited from StepBase

resume()

This method resumes the step that was previously suppressed.

suppress()

This method suppresses the step.


Member Details:

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

This method creates a DiagnosticPrint object.

Note

This function can be accessed by:

mdb.models[name].steps[name].DiagnosticPrint
Parameters:
allke=1

A Boolean specifying a request for a column containing the total kinetic energy. This argument is valid only for an Abaqus/Explicit analysis. The default value is ON.

criticalElement=1

A Boolean specifying a request for a column containing the element that has the smallest stable time increment and a column listing the value. This argument is valid only for an Abaqus/Explicit analysis. The default value is ON.

dmass=0

A Boolean specifying a request for a column containing the percent change in total mass of the model as a result of mass scaling. This argument is valid only for an Abaqus/Explicit analysis. The default value is OFF unless mass scaling is present in the model.

etotal=0

A Boolean specifying a request for a column containing the energy balance of the model. This argument is valid only for an Abaqus/Explicit analysis. The default value is OFF.

contact=1

A Boolean specifying a request for detailed output of points that are contacting or separating in interface and gap problems. This argument is valid only for an Abaqus/Standard analysis. The default value is ON.

modelChange=0

A Boolean specifying a request for detailed output of which elements are being removed or reactivated in the step. This argument is valid only for an Abaqus/Standard analysis. The default value is OFF.

plasticity=0

A Boolean specifying a request for detailed output of element and integration point numbers for which the plasticity algorithms have failed to converge in the material routines. This argument is valid only for an Abaqus/Standard analysis. The default value is OFF.

residual=1

A Boolean specifying a request for output of equilibrium residuals during the equilibrium iterations. This argument is valid only for an Abaqus/Standard analysis. The default value is ON.

frequency=1

An Int specifying the frequency of output, in increments. The default value is 1.

solve=1

A Boolean specifying a request for information regarding the actual number of equations and the wavefront in each iteration. This argument is valid only for an Abaqus/Standard analysis. The default value is ON.

mass=0

A Boolean specifying a request for a column containing the total mass of the model as a result of mass scaling. This argument is valid only for an Abaqus/Explicit analysis. The default value is OFF.

Returns:

diagnosticPrint – A DiagnosticPrint object

Return type:

DiagnosticPrint

Monitor(node, dof, frequency)[source]

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

Note

This function can be accessed by:

mdb.models[name].steps[name].Monitor
Parameters:
node

A String specifying the name of the region to be monitored.

dof

A SymbolicConstant specifying the degree of freedom to be monitored at the node. Possible values are:

  • U1

  • U2

  • U3

  • UR1

  • UR2

  • UR3

  • WARP

  • FLUID_PRESSURE

  • ELECTRICAL_POTENTIAL

  • NT11

  • NT30

  • NN11

  • NN30

The NT identifiers are not available for mass diffusion. The NN identifiers are available only for mass diffusion.

frequency

An Int specifying the output frequency in increments. This argument is valid only for an Abaqus/Standard analysis.

Returns:

monitor – A Monitor object

Return type:

Monitor

Restart(numberIntervals=0, timeMarks=0, overlay=0, frequency=0)[source]

This method creates a restart request.

Note

This function can be accessed by:

mdb.models[name].steps[name].Restart
Parameters:
numberIntervals=0

An Int specifying the number of intervals during the step at which restart information will be written. The default value is 0. The default value is 1.

timeMarks=0

A Boolean specifying whether to use exact time marks for writing during an analysis. The default value is OFF. The default value is OFF.

overlay=0

A Boolean specifying that only one increment per step should be retained on the restart file, thus minimizing the size of the restart file. The default value is OFF. The default value is ON.

frequency=0

An Int specifying the increments at which restart information will be written. The default value is 0. The default value is 0.This argument applies only to Abaqus/Standard analyses.

Returns:

restart – A Restart object

Return type:

Restart

Raises:

RangeError

Other Classes

class DiagnosticPrint(
allke=1,
criticalElement=1,
dmass=0,
etotal=0,
contact=1,
modelChange=0,
plasticity=0,
residual=1,
frequency=1,
solve=1,
mass=0,
)[source]

Bases: object

The DiagnosticPrint object is used to request detailed diagnostic output or to disable specific diagnostic checks.

Note

This object can be accessed by:

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

The corresponding analysis keywords are:

  • DIAGNOSTICS

Member Details:

allke : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 1[source]

A Boolean specifying a request for a column containing the total kinetic energy. This argument is valid only for an Abaqus/Explicit analysis. The default value is ON.

contact : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 1[source]

A Boolean specifying a request for detailed output of points that are contacting or separating in interface and gap problems. This argument is valid only for an Abaqus/Standard analysis. The default value is ON.

criticalElement : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 1[source]

A Boolean specifying a request for a column containing the element that has the smallest stable time increment and a column listing the value. This argument is valid only for an Abaqus/Explicit analysis. The default value is ON.

dmass : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]

A Boolean specifying a request for a column containing the percent change in total mass of the model as a result of mass scaling. This argument is valid only for an Abaqus/Explicit analysis. The default value is OFF unless mass scaling is present in the model.

etotal : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]

A Boolean specifying a request for a column containing the energy balance of the model. This argument is valid only for an Abaqus/Explicit analysis. The default value is OFF.

frequency : --is-rst--:py:class:`int` = 1[source]

An Int specifying the frequency of output, in increments. The default value is 1.

mass : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]

A Boolean specifying a request for a column containing the total mass of the model as a result of mass scaling. This argument is valid only for an Abaqus/Explicit analysis. The default value is OFF.

modelChange : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]

A Boolean specifying a request for detailed output of which elements are being removed or reactivated in the step. This argument is valid only for an Abaqus/Standard analysis. The default value is OFF.

plasticity : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]

A Boolean specifying a request for detailed output of element and integration point numbers for which the plasticity algorithms have failed to converge in the material routines. This argument is valid only for an Abaqus/Standard analysis. The default value is OFF.

residual : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 1[source]

A Boolean specifying a request for output of equilibrium residuals during the equilibrium iterations. This argument is valid only for an Abaqus/Standard analysis. The default value is ON.

setValues(*args, **kwargs)[source]

This method modifies the DiagnosticPrint object.

class FieldOutputRequest(
name,
createStepName,
region=MODEL,
variables=PRESELECT,
frequency=1,
modes=ALL,
timeInterval=EVERY_TIME_INCREMENT,
numIntervals=20,
timeMarks=0,
boltLoad='',
sectionPoints=DEFAULT,
interactions=None,
rebar=EXCLUDE,
filter=None,
directions=1,
fasteners='',
assembledFastener='',
assembledFastenerSet='',
exteriorOnly=0,
layupNames='',
layupLocationMethod=SPECIFIED,
outputAtPlyTop=False,
outputAtPlyMid=True,
outputAtPlyBottom=False,
position=INTEGRATION_POINTS,
)[source]

Bases: object

The FieldOutputRequest object defines a field output request.

Note

This object can be accessed by:

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

The corresponding analysis keywords are:

  • CONTACT OUTPUT

  • ELEMENT OUTPUT

  • ENERGY OUTPUT

  • CONTACT OUTPUT

  • ELEMENT OUTPUT

  • ENERGY OUTPUT

  • MODAL OUTPUT

  • CONTACT OUTPUT

  • ELEMENT OUTPUT

  • OUTPUT

  • RADIATION OUTPUT

Member Details:

boltLoad : --is-rst--:py:class:`str` = ''[source]

A String specifying a bolt load from which output is requested.

deactivate(stepName)[source]

This method deactivates the field output request in the specified step and all its subsequent steps.

Parameters:
stepName

A String specifying the name of the step in which the field output request is deactivated.

interactions : --is-rst--:py:class:`tuple` | :py:obj:`None` = None[source]

None or a tuple of Strings specifying the interaction names. The default value is None.The sequence can contain only one String.

move(fromStepName, toStepName)[source]

This method moves the field output request state object from one step to a different step.

Parameters:
fromStepName

A String specifying the name of the step from which the field output request state is moved.

toStepName

A String specifying the name of the step to which the field output request state is moved.

region : --is-rst--:py:data:`~typing.Union`\ \[:py:data:`~typing.Literal`\ \[``MODEL``], :py:class:`~abaqus.Region.Region.Region`] = 'MODEL'[source]

The SymbolicConstant MODEL or a Region object specifying the region from which output is requested. The SymbolicConstant MODEL represents the whole model. The default value is MODEL.

reset(stepName)[source]

This method resets the field output request state of the specified step to the state of the previous step.

Parameters:
stepName

A String specifying the name of the step in which the field output request state is reset.

resume()[source]

This method resumes the field output request that was previously suppressed.

setValues(
region=MODEL,
variables=PRESELECT,
frequency=1,
modes=ALL,
timeInterval=EVERY_TIME_INCREMENT,
numIntervals=20,
timeMarks=0,
boltLoad='',
sectionPoints=DEFAULT,
interactions=None,
rebar=EXCLUDE,
filter=None,
directions=1,
fasteners='',
assembledFastener='',
assembledFastenerSet='',
exteriorOnly=0,
layupNames='',
layupLocationMethod=SPECIFIED,
outputAtPlyTop=False,
outputAtPlyMid=True,
outputAtPlyBottom=False,
position=INTEGRATION_POINTS,
)[source]

This method modifies the data for an existing FieldOutputRequest object in the step where it is created.

Parameters:
region=MODEL

The SymbolicConstant MODEL or a Region object specifying the region from which output is requested. The SymbolicConstant MODEL represents the whole model. The default value is MODEL.

variables=PRESELECT

A sequence of Strings specifying output request variable or component names, or the SymbolicConstant PRESELECT or ALL. PRESELECT represents all default output variables for the given step. ALL represents all valid output variables. The default value is PRESELECT.

frequency=1

The SymbolicConstant LAST_INCREMENT or an Int specifying the output frequency in increments. The default value is 1.

modes=ALL

The SymbolicConstant ALL or a sequence of Ints specifying a list of eigenmodes for which output is desired. The default value is ALL.

timeInterval=EVERY_TIME_INCREMENT

The SymbolicConstant EVERY_TIME_INCREMENT or a Float specifying the time interval at which the output states are to be written. The default value is EVERY_TIME_INCREMENT.

numIntervals=20

An Int specifying the number of intervals during the step at which output database states are to be written. The default value is 20.

timeMarks=0

A Boolean specifying when to write results to the output database. OFF indicates that output is written immediately after the time dictated by the specified number of intervals. ON indicates that output is written at the exact times dictated by the specified number of intervals. The default value is OFF.

boltLoad=''

A String specifying a bolt load from which output is requested.

sectionPoints=DEFAULT

The SymbolicConstant DEFAULT or a sequence of Ints specifying the section points for which output requested. The default is DEFAULT.

interactions=None

None or a sequence of Strings specifying the interaction names. The default value is None.The sequence can contain only one String.

rebar=EXCLUDE

A SymbolicConstant specifying whether output is requested for rebar. Possible values are EXCLUDE, INCLUDE, and ONLY. The default value is EXCLUDE.

filter=None

The SymbolicConstant ANTIALIASING or a String specifying the name of an output filter object. The default value is None.

directions=1

A Boolean specifying whether to output directions of the local material coordinate system. The default value is ON.

fasteners=''

A String specifying the fastener name. The default value is an empty string.

assembledFastener=''

A String specifying the assembled fastener name. The default value is an empty string.

assembledFastenerSet=''

A String specifying the set name from the model referenced by the assembled fastener, assembledFastener. The default value is an empty string.

exteriorOnly=0

A Boolean specifying whether the output domain is restricted to the exterior of the model. This argument is only valid if region = MODEL. The default value is OFF.

layupNames=''

A List of Composite Layer Names.

layupLocationMethod=SPECIFIED

A Symbolic constant specifying the method used to indicate the output locations for composite layups. Possible values are ALL_LOCATIONS, SPECIFIED and TYPED_IN. The default value is SPECIFIED.

outputAtPlyTop=False

A Boolean specifying whether to output at the ply top section point. The default value is False.

outputAtPlyMid=True

A Boolean specifying whether to output at the ply mid section point. The default value is True.

outputAtPlyBottom=False

A Boolean specifying whether to output at the ply bottom section point. The default value is False.

position=INTEGRATION_POINTS

A SymbolicConstant specifying the position on an element where output needs to be written. Possible values are INTEGRATION_POINTS, AVERAGED_AT_NODES, CENTROIDAL, and NODES. The default value is INTEGRATION_POINTS.

setValuesInStep(
stepName,
variables=None,
frequency=1,
modes=ALL,
timeInterval=EVERY_TIME_INCREMENT,
numIntervals=20,
timePoints=None,
timeMarks=0,
)[source]

This method modifies the propagating data for an existing FieldOutputRequest object in the specified step.

Parameters:
stepName

A String specifying the name of the step in which the field output request is modified.

variables=None

A sequence of Strings specifying output request variable or component names, or the SymbolicConstant PRESELECT or ALL. PRESELECT represents all default output variables for the given step. ALL represents all valid output variables.

frequency=1

The SymbolicConstant LAST_INCREMENT or an Int specifying the output frequency in increments. The default value is 1.

modes=ALL

The SymbolicConstant ALL or a sequence of Ints specifying a list of eigenmodes for which output is desired. The default value is ALL.

timeInterval=EVERY_TIME_INCREMENT

The SymbolicConstant EVERY_TIME_INCREMENT or a Float specifying the time interval at which the output states are to be written. The default value is EVERY_TIME_INCREMENT.

numIntervals=20

An Int equal to the number of intervals during the step at which output database states are to be written. The default value is 20.

timePoints=None

A String specifying the name of a time point object. The default value is equal to the number of intervals during the step at which output database states are to be written. The default value is None.

timeMarks=0

A Boolean specifying when to write results to the output database. The default value is OFF.

suppress()[source]

This method suppresses the field output request.

class FieldOutputRequestState[source]

Bases: object

The FieldOutputRequestState object stores the propagating data of a field output request current in a step. One instance of this object is created internally by the FieldOutputRequest object for each step. The instance is also deleted internally by the FieldOutputRequest object. The FieldOutputRequestState object has no constructor or methods.

Note

This object can be accessed by:

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

Member Details:

frequency : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` | :py:class:`int` = 1[source]

The SymbolicConstant LAST_INCREMENT or an Int specifying the output frequency in increments. The default value is 1.

frequencyState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the field output request frequency. Possible values are UNSET, SET, and UNCHANGED.

frequencyType : --is-rst--:py:class:`str` = ''[source]

A String specifying a read-only SymbolicConstant describing which type of frequency of output is used. Possible values areFREQUENCY, NUMBER_INTERVALS, TIME_INTERVAL, TIME_POINT and MODES. The default value depends on the procedure. The default value is an empty string.

modes : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'ALL'[source]

The SymbolicConstant ALL or a tuple of Ints specifying a list of eigenmodes for which output is desired. The default value is ALL.

modesState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the field output request modes. Possible values are UNSET, SET, and UNCHANGED.

numIntervals : --is-rst--:py:class:`int` = 20[source]

An Int specifying the number of intervals during the step at which output database states are to be written. The default value is 20.

numIntervalsState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the field output request. Possible values are UNSET, SET, and UNCHANGED.

status : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the FieldOutputRequestState object. Possible values are NOT_YET_ACTIVE, CREATED, PROPAGATED, MODIFIED, DEACTIVATED, NO_LONGER_ACTIVE, TYPE_NOT_APPLICABLE, and INSTANCE_NOT_APPLICABLE.

timeInterval : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`, :py:class:`float`] = 'EVERY_TIME_INCREMENT'[source]

The SymbolicConstant EVERY_TIME_INCREMENT or a Float specifying the time interval at which the output states are to be written. The default value is EVERY_TIME_INCREMENT.

timeIntervalState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the field output request time interval. Possible values are UNSET, SET, and UNCHANGED.

timeMarks : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]

A Boolean specifying when to write results to the output database. The default value is OFF.

timeMarksState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the field output request. Possible values are UNSET, SET, and UNCHANGED.

timePoint : --is-rst--:py:class:`str` = ''[source]

A String specifying the name of a time point object used to determine which output database states are to be written. The default value is an empty string.

timePointState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the field output request. Possible values are UNSET, SET, and UNCHANGED.

variables : --is-rst--:py:class:`tuple`\ \[:py:class:`str`, :py:data:`...<Ellipsis>`] | :py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = ()[source]

A tuple of Strings specifying output request variable or component names, or the SymbolicConstant PRESELECT or ALL. PRESELECT represents all default output variables for the given step. ALL represents all valid output variables.

variablesState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the field output request variables. Possible values are UNSET, SET, and UNCHANGED.

class HistoryOutputRequest(
name,
createStepName,
region=MODEL,
variables=PRESELECT,
frequency=1,
modes=ALL,
timeInterval=EVERY_TIME_INCREMENT,
numIntervals=20,
boltLoad='',
sectionPoints=DEFAULT,
stepName='',
interactions=None,
contourIntegral=None,
numberOfContours=0,
stressInitializationStep=None,
contourType=J_INTEGRAL,
kFactorDirection=MTS,
rebar=EXCLUDE,
integratedOutputSection='',
springs=None,
filter=None,
fasteners='',
assembledFastener='',
assembledFastenerSet='',
sensor=0,
useGlobal=True,
)[source]

Bases: object

The HistoryOutputRequest object defines a history output request.

Note

This object can be accessed by:

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

The corresponding analysis keywords are:

  • CONTACT OUTPUT

  • ELEMENT OUTPUT

  • ENERGY OUTPUT

  • CONTACT OUTPUT

  • ELEMENT OUTPUT

  • ENERGY OUTPUT

  • MODAL OUTPUT

  • CONTACT OUTPUT

  • ELEMENT OUTPUT

  • OUTPUT

  • RADIATION OUTPUT

Member Details:

boltLoad : --is-rst--:py:class:`str` = ''[source]

A String specifying a bolt load from which output is requested. The default value is an empty string.

deactivate(stepName)[source]

This method deactivates the history output request in the specified step and all subsequent steps.

Parameters:
stepName

A String specifying the name of the step in which the history output request is deactivated.

interactions : --is-rst--:py:class:`tuple` | :py:obj:`None` = None[source]

None or a tuple of Strings specifying the interaction names. The default value is None.The sequence can contain only one String.

move(fromStepName, toStepName)[source]

This method moves the history output request state object from one step to a different step.

Parameters:
fromStepName

A String specifying the name of the step from which the history output request state is moved.

toStepName

A String specifying the name of the step to which the history output request state is moved.

region : --is-rst--:py:data:`~typing.Union`\ \[:py:data:`~typing.Literal`\ \[``MODEL``], :py:class:`~abaqus.Region.Region.Region`] = 'MODEL'[source]

The SymbolicConstant MODEL or a Region object specifying the region from which output is requested. The SymbolicConstant MODEL represents the whole model. The default value is MODEL.If the region is a surface region, the surface must lie within the general contact surface domain.

reset(stepName)[source]

This method resets the history output request state of the specified step to the state of the previous step.

Parameters:
stepName

A String specifying the name of the step in which the history output request state is reset.

resume()[source]

This method resumes the history output request that was previously suppressed.

sectionPoints : --is-rst--:py:data:`~typing.Union`\ \[:py:data:`~typing.Literal`\ \[``DEFAULT``], :py:class:`~typing.Sequence`\ \[:py:class:`int`]] = 'DEFAULT'[source]

The SymbolicConstant DEFAULT or a tuple of Ints specifying the section points for which output is requested. The default value is DEFAULT.

setValues(
region=MODEL,
variables=PRESELECT,
frequency=1,
modes=ALL,
timeInterval=EVERY_TIME_INCREMENT,
numIntervals=20,
boltLoad='',
sectionPoints=DEFAULT,
stepName='',
interactions=None,
contourIntegral=None,
numberOfContours=0,
stressInitializationStep=None,
contourType=J_INTEGRAL,
kFactorDirection=MTS,
rebar=EXCLUDE,
integratedOutputSection='',
springs=None,
filter=None,
fasteners='',
assembledFastener='',
assembledFastenerSet='',
sensor=0,
useGlobal=True,
)[source]

This method modifies the data for an existing HistoryOutputRequest object in the step where it is created.

Parameters:
region=MODEL

The SymbolicConstant MODEL or a Region object specifying the region from which output is requested. The SymbolicConstant MODEL represents the whole model. The default value is MODEL.If the region is a surface region, the surface must lie within the general contact surface domain.

variables=PRESELECT

A sequence of Strings specifying output request variable or component names, or the SymbolicConstant PRESELECT or ALL. PRESELECT represents all default output variables for the given step. ALL represents all valid output variables. The default value is PRESELECT.

frequency=1

The SymbolicConstant LAST_INCREMENT or an Int specifying the output frequency in increments. The default value is 1.

modes=ALL

The SymbolicConstant ALL or a sequence of Ints specifying a list of eigenmodes for which output is desired. The default value is ALL.

timeInterval=EVERY_TIME_INCREMENT

The SymbolicConstant EVERY_TIME_INCREMENT or a Float specifying the time interval at which the output states are to be written. The default value is EVERY_TIME_INCREMENT.

numIntervals=20

An Int specifying the number of intervals during the step at which output database states are to be written. The default value is 20.

boltLoad=''

A String specifying a bolt load from which output is requested. The default value is an empty string.

sectionPoints=DEFAULT

The SymbolicConstant DEFAULT or a sequence of Ints specifying the section points for which output is requested. The default value is DEFAULT.

stepName=''

A String specifying the name of the step. The default value is an empty string.

interactions=None

None or a sequence of Strings specifying the interaction names. The default value is None.The sequence can contain only one String.

contourIntegral=None

A String specifying the contour integral name. The default value is None.

numberOfContours=0

An Int specifying the number of contour integrals to output for the contour integral object. The default value is 0.

stressInitializationStep=None

A String specifying the name of the stress initialization step. The default value is None.

contourType=J_INTEGRAL

A SymbolicConstant specifying the type of contour integral. Possible values are J_INTEGRAL, C_INTEGRAL, T_STRESS, and K_FACTORS. The default value is J_INTEGRAL.

kFactorDirection=MTS

A SymbolicConstant specifying the stress intensity factor direction. Possible values are MTS, MERR, and K110. The kFactorDirection argument is valid only if contourType = K_FACTORS. The default value is MTS.

rebar=EXCLUDE

A SymbolicConstant specifying whether output is requested for rebar. Possible values are EXCLUDE, INCLUDE, and ONLY. The default value is EXCLUDE.

integratedOutputSection=''

A String specifying the integrated output section. The default value is an empty string.

springs=None

A sequence of Strings specifying the springs/dashpots names. The default value is None. The sequence can contain only one String.

filter=None

The SymbolicConstant ANTIALIASING or a String specifying the name of an output filter object. The default value is None.

fasteners=''

A String specifying the fastener name. The default value is an empty string.

assembledFastener=''

A String specifying the assembled fastener name. The default value is an empty string.

assembledFastenerSet=''

A String specifying the set name from the model referenced by the assembled fastener, assembledFastener. The default value is an empty string.

sensor=0

A Boolean specifying whether to associate the output request with a sensor definition. The default value is OFF.

useGlobal=True

A Boolean specifying whether to output vector-valued nodal variables in the global directions. The default value is True.

setValuesInStep(
stepName,
variables=Ellipsis,
frequency=1,
modes=ALL,
timeInterval=EVERY_TIME_INCREMENT,
numIntervals=20,
timePoints=None,
)[source]

This method modifies the propagating data for an existing HistoryOutputRequest object in the specified step.

Parameters:
stepName

A String specifying the name of the step in which the history output request is modified.

variables=Ellipsis

A sequence of Strings specifying output request variable or component names or the SymbolicConstant PRESELECT or ALL. PRESELECT represents all default output variables for the given step. ALL represents all valid output variables.

frequency=1

The SymbolicConstant LAST_INCREMENT or an Int specifying the output frequency in increments. The default value is 1.

modes=ALL

The SymbolicConstant ALL or a sequence of Ints specifying a list of eigenmodes for which output is desired. The default value is ALL.

timeInterval=EVERY_TIME_INCREMENT

The SymbolicConstant EVERY_TIME_INCREMENT or a Float specifying the time interval at which the output states are to be written. The default value is EVERY_TIME_INCREMENT.

numIntervals=20

An Int specifying the number of intervals during the step at which output database states are to be written. The default value is 20.

timePoints=None

A String specifying the name of a time point object. The default value is equal to the number of intervals during the step at which output database states are to be written. The default value is None.

suppress()[source]

This method suppresses the history output request.

class HistoryOutputRequestState[source]

Bases: object

The HistoryOutputRequestState object stores the propagating data of a History output request current in a step. One instance of this object is created internally by the HistoryOutputRequest object for each step. The instance is also deleted internally by the HistoryOutputRequest object. The HistoryOutputRequestState object has no constructor or methods.

Note

This object can be accessed by:

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

Member Details:

frequency : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` | :py:class:`int` = 1[source]

The SymbolicConstant LAST_INCREMENT or an Int specifying the output frequency in increments. The default value is 1.

frequencyState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the history output request frequency. Possible values are UNSET, SET, and UNCHANGED.

frequencyType : --is-rst--:py:class:`str` = ''[source]

A String specifying a read-only SymbolicConstant describing which type of frequency of output is used. Possible values areFREQUENCY, NUMBER_INTERVALS, TIME_INTERVAL, TIME_POINT and MODES. The default value depends on the procedure. The default value is an empty string.

modes : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'ALL'[source]

The SymbolicConstant ALL or a tuple of Ints specifying a list of eigenmodes for which output is desired. The default value is ALL.

modesState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the history output request modes. Possible values are UNSET, SET, and UNCHANGED.

numIntervals : --is-rst--:py:class:`int` = 20[source]

An Int specifying the number of intervals during the step at which output database states are to be written. The default value is 20.

numIntervalsState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the history output request. Possible values are UNSET, SET, and UNCHANGED.

status : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the HistoryOutputRequestState object. Possible values are NOT_YET_ACTIVE, CREATED, PROPAGATED, MODIFIED, DEACTIVATED, NO_LONGER_ACTIVE, TYPE_NOT_APPLICABLE, and INSTANCE_NOT_APPLICABLE.

timeInterval : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`, :py:class:`float`] = 'EVERY_TIME_INCREMENT'[source]

The SymbolicConstant EVERY_TIME_INCREMENT or a Float specifying the time interval at which the output states are to be written. The default value is EVERY_TIME_INCREMENT.

timeIntervalState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the history output request time interval. Possible values are UNSET, SET, and UNCHANGED.

timePoint : --is-rst--:py:class:`str` = ''[source]

A String specifying the name of a time point object used to determine at which points in the time period data is written to the output database. The default value is an empty string.

timePointState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the history output request. Possible values are UNSET, SET, and UNCHANGED.

variables : --is-rst--:py:class:`tuple`\ \[:py:class:`str`, :py:data:`...<Ellipsis>`] | :py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = ()[source]

A tuple of Strings specifying output request variable or component names, or the SymbolicConstant PRESELECT or ALL. PRESELECT represents all default output variables for the given step. ALL represents all valid output variables.

variablesState : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the propagation state of the history output request variables. Possible values are UNSET, SET, and UNCHANGED.

class IntegratedOutputSection(
name,
surface,
refPoint=None,
refPointAtCenter=0,
refPointMotion=INDEPENDENT,
localCsys=None,
projectOrientation=0,
)[source]

Bases: object

The IntegratedOutputSection object specifies parameters used for integrated output.

Note

This object can be accessed by:

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

Member Details:

localCsys : --is-rst--:py:class:`str` | :py:obj:`None` = None[source]

None or a DatumCsys object specifying the local coordinate system used to express vector output. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

name : --is-rst--:py:class:`str`[source]

A String specifying the repository key.

projectOrientation : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]

A Boolean specifying that the coordinate system be projected onto the surface such that the 1-axis is normal to the surface. Projection onto a planar surface is such that the 1-axis is normal to the surface, and a projection onto a nonplanar surface is such that a least-squares fit surface will be used. The default value is OFF.

refPoint : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

None or a Region object specifying the anchor point about which the integrated moment over the output region is computed or the SymbolicConstant None representing the global origin. The default value is None.

refPointAtCenter : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]

A Boolean specifying that the refPoint be adjusted so that it coincides with the center of the output region in the initial configuration. This argument is valid only when you include the refPoint argument. The default value is OFF.

refPointMotion : --is-rst--:py:data:`~typing.Literal`\ \[``AVERAGE_TRANSLATION``, ``AVERAGE``, ``INDEPENDENT``] = 'INDEPENDENT'[source]

A SymbolicConstant specifying how to relate the motion of refPoint to the average motion of the output region. A value of INDEPENDENT will allow the refPoint to move independent of the output region. A value of AVERAGE_TRANSLATION will set the displacement of the refPoint equal to the average translation of the output region. A value of AVERAGE will set the displacement and rotation of the refPoint equal to the average translation of the output region. The default value is INDEPENDENT.This argument is valid only when you include the refPoint argument.

setValues(
surface,
refPoint=None,
refPointAtCenter=0,
refPointMotion=INDEPENDENT,
localCsys=None,
projectOrientation=0,
)[source]

This method modifies the IntegratedOutputSection object.

Parameters:
surface

A Region object specifying the surface over which the output is based.

refPoint=None

None or a Region object specifying the anchor point about which the integrated moment over the output region is computed or the SymbolicConstant None representing the global origin. The default value is None.

refPointAtCenter=0

A Boolean specifying that the refPoint be adjusted so that it coincides with the center of the output region in the initial configuration. This argument is valid only when you include the refPoint argument. The default value is OFF.

refPointMotion=INDEPENDENT

A SymbolicConstant specifying how to relate the motion of refPoint to the average motion of the output region. A value of INDEPENDENT will allow the refPoint to move independent of the output region. A value of AVERAGE_TRANSLATION will set the displacement of the refPoint equal to the average translation of the output region. A value of AVERAGE will set the displacement and rotation of the refPoint equal to the average translation of the output region. The default value is INDEPENDENT.This argument is valid only when you include the refPoint argument.

localCsys=None

None or a DatumCsys object specifying the local coordinate system used to express vector output. If localCsys = None, the degrees of freedom are defined in the global coordinate system. The default value is None.

projectOrientation=0

A Boolean specifying that the coordinate system be projected onto the surface such that the 1-axis is normal to the surface. Projection onto a planar surface is such that the 1-axis is normal to the surface, and a projection onto a nonplanar surface is such that a least-squares fit surface will be used. The default value is OFF.

surface : --is-rst--:py:class:`~abaqus.Region.Region.Region`[source]

A Region object specifying the surface over which the output is based.

class Monitor(node, dof, frequency)[source]

Bases: object

The Monitor object defines a degree of freedom to monitor.

Note

This object can be accessed by:

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

The corresponding analysis keywords are:

  • MONITOR

Member Details:

dof : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]

A SymbolicConstant specifying the degree of freedom to be monitored at the node. Possible values are:

  • U1

  • U2

  • U3

  • UR1

  • UR2

  • UR3

  • WARP

  • FLUID_PRESSURE

  • ELECTRICAL_POTENTIAL

  • NT11

  • NT30

  • NN11

  • NN30

The NT identifiers are not available for mass diffusion. The NN identifiers are available only for mass diffusion.

frequency : --is-rst--:py:class:`int`[source]

An Int specifying the output frequency in increments. This argument is valid only for an Abaqus/Standard analysis.

node : --is-rst--:py:class:`str`[source]

A String specifying the name of the region to be monitored.

setValues(*args, **kwargs)[source]

This method modifies the Monitor object.

Raises:

RangeError

class TimePoint(name, points)[source]

Bases: object

The TimePoint object defines time points at which data are written to the output database or restart files.

Note

This object can be accessed by:

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

The corresponding analysis keywords are:

  • TIME POINTS

Member Details:

name : --is-rst--:py:class:`str`[source]

A String specifying the repository key.

points : --is-rst--:py:class:`tuple`\ \[:py:class:`tuple`\ \[:py:class:`float`, :py:data:`...<Ellipsis>`], :py:data:`...<Ellipsis>`] = ()[source]

A sequence of sequences of Floats specifying time points at which data are written to the output database or restart files.

setValues(*args, **kwargs)[source]

This method modifies the TimePoint object.

Raises:

RangeError

class Restart(numberIntervals=0, timeMarks=0, overlay=0, frequency=0)[source]

Bases: object

The Restart object defines a restart request.

Note

This object can be accessed by:

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

The corresponding analysis keywords are:

  • RESTART

Member Details:

frequency : --is-rst--:py:class:`int` = 0[source]

An Int specifying the increments at which restart information will be written. The default value is 0. The default value is 0.This argument applies only to Abaqus/Standard analyses.

numberIntervals : --is-rst--:py:class:`int` = 0[source]

An Int specifying the number of intervals during the step at which restart information will be written. The default value is 0. The default value is 1.

overlay : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]

A Boolean specifying that only one increment per step should be retained on the restart file, thus minimizing the size of the restart file. The default value is OFF. The default value is ON.

setValues(*args, **kwargs)[source]

This method modifies the Restart object.

Raises:

RangeError

timeMarks : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]

A Boolean specifying whether to use exact time marks for writing during an analysis. The default value is OFF. The default value is OFF.