34.25 OdbStep object

An output database contains the same steps of the model database that originated it.

Access
import odbAccess
session.odbs[name].steps[name]


34.25.1 Step(...)

This method creates an OdbStep object.

Path
session.odbs[name].Step

Required arguments

name

A String specifying the repository key.

description

A String specifying the step description.

domain

A SymbolicConstant specifying the domain of the step. Possible values are TIME, FREQUENCY, ARC_LENGTH, and MODAL.

The type of OdbFrame object that can be created for this step is based on the value of the domain argument.

Optional arguments

timePeriod

A Float specifying the time period of the step. timePeriod is required if domain=TIME; otherwise, this argument is not applicable. The default value is 0.0.

previousStepName

A String specifying the preceding step. If previousStepName is the empty string, the last step in the repository is used. If previousStepName is not the last step, this will result in a change to the previousStepName member of the step that was in that position. A special value 'Initial' refers to the internal initial model step and may be used exclusively for inserting a new step at the first position before any other existing steps. The default value is an empty string.

procedure

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

totalTime

A Float specifying the analysis time spend in all the steps previous to this step. The default value is –1.0.

Return value

An OdbStep object.

Exceptions

If previousStepName is invalid:

ValueError: previousStepName is invalid


34.25.2 getFrame(...)

This method retrieves an OdbFrame object associated with a given frame value.

Required argument

frameValue

A Double specifying the value at which the frame is required. frameValue can be the step time or frequency.

Optional argument

match

A SymbolicConstant specifying which frame to return if there is no frame at the exact frame value. Possible values are CLOSEST, BEFORE, AFTER, and EXACT. The default value is CLOSEST.

When match=CLOSEST, Abaqus returns the closest frame. If the frame value requested is exactly halfway between two frames, Abaqus returns the frame after the value.

When match=EXACT, Abaqus raises an exception if the exact frame value does not exist.

Return value

An OdbFrame object.

Exceptions

If the OdbFrame object is not found:

OdbError: Frame not found.


34.25.3 getFrame(...)

This method retrieves an OdbFrame object associated with a given load case.

Required argument

loadCase

An OdbLoadCase object specifying a load case in the step.

Optional arguments

None.

Return value

An OdbFrame object.

Exceptions

If the OdbFrame object is not found:

OdbError: Frame not found.


34.25.4 getFrame(...)

This method retrieves an OdbFrame object associated with a given load case and frame value.

Required arguments

loadCase

An OdbLoadCase object specifying a load case in the step.

frameValue

A Double specifying the value at which the frame is required. frameValue can be the step time or frequency.

Optional argument

match

A SymbolicConstant specifying which frame to return if there is no frame at the exact frame value. Possible values are CLOSEST, BEFORE, AFTER, and EXACT. The default value is CLOSEST.

When match=CLOSEST, Abaqus returns the closest frame. If the frame value requested is exactly halfway between two frames, Abaqus returns the frame after the value.

When match=EXACT, Abaqus raises an exception if the exact frame value does not exist.

Return value

An OdbFrame object.

Exceptions

If the OdbFrame object is not found:

OdbError: Frame not found.


34.25.5 getHistoryRegion(...)

This method retrieves a HistoryRegion object associated with a HistoryPoint in the model.

Required argument

point

A HistoryPoint object specifying the point in the model.

Optional argument

loadCase

An OdbLoadCase object specifying a load case in the step.

Return value

A HistoryRegion object.

Exceptions

If a HistoryRegion object is not found:

OdbError: HistoryRegion not found.


34.25.6 setDefaultDeformedField(...)

This method sets the default deformed field variable in a step.

Required argument

field

A FieldOutput object specifying the default deformed field variable for visualization.

Optional arguments

None.

Return value

None

Exceptions

None.


34.25.7 setDefaultField(...)

This method sets the default field variable in a step.

Required argument

field

A FieldOutput object specifying the default field variable for visualization.

Optional arguments

None.

Return value

None

Exceptions

None.


34.25.8  Members

The OdbStep object has members with the same names and descriptions as the arguments to the Step method.

In addition, the OdbStep object can have the following members:

number

An Int specifying the step number.

nlgeom

A Boolean specifying whether geometric nonlinearity can occur in this step.

mass

A Float specifying the current value of the mass of the model. This does not include the mass of the acoustic media if any present.

acousticMass

A Float specifying the current value of the mass of the acoustic media of the model.

frames

An OdbFrameArray object.

historyRegions

A repository of HistoryRegion objects.

loadCases

A repository of OdbLoadCase objects.

massCenter

A tuple of Floats specifying the coordinates of the center of mass.

inertiaAboutCenter

A tuple of Floats specifying the moments and products of inertia about the center of mass. For 3-D models inertia quantities are written in the following order: I(XX), I(YY), I(ZZ), I(XY), I(XZ), and I(YZ). For 2-D models only I(ZZ) and I(XY) are outputted.

inertiaAboutOrigin

A tuple of Floats specifying the moments and products of inertia about the origin of the global coordinate system. For 3-D models inertia quantities are written in the following order: I(XX), I(YY), I(ZZ), I(XY), I(XZ), and I(YZ). For 2-D models only I(ZZ) and I(XY) are outputted.

acousticMassCenter

A tuple of Floats specifying the coordinates of the center of mass of the acoustic media.