An output database contains the same steps of the model database that originated it.
odb.steps()[name]
This method creates an OdbStep object.
odb.Step
odb_Step& Step(const odb_String& name, const odb_String& description, odb_Enum::odb_DomainEnum domain, double timePeriod, const odb_String& previousStepName, const odb_String& procedure, double totalTime);
Required arguments
An odb_String specifying the repository key.
An odb_String specifying the step description.
An odb_Enum::odb_DomainEnum specifying the domain of the step. Possible values are odb_Enum::TIME, odb_Enum::FREQUENCY, odb_Enum::ARC_LENGTH, and odb_Enum::MODAL.
The type of OdbFrame object that can be created for this step is based on the value of the domain argument.
Optional arguments
A Double specifying the time period of the step. timePeriod is required if domain=odb_Enum::TIME; otherwise, this argument is not applicable. The default value is 0.0.
An odb_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.
An odb_String specifying the step procedure. The default value is an empty string.
A Double 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:
This method retrieves an OdbFrame object associated with a given frame value.
odb_Frame getFrame(double frameValue, odb_Enum::odb_MatchEnum match);
Required argument
A Double specifying the value at which the frame is required. frameValue can be the step time or frequency.
Optional argument
An odb_Enum::odb_MatchEnum specifying which frame to return if there is no frame at the exact frame value. Possible values are odb_Enum::CLOSEST, odb_Enum::BEFORE, odb_Enum::AFTER, and odb_Enum::EXACT. The default value is odb_Enum::CLOSEST.
When match=odb_Enum::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=odb_Enum::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:
This method retrieves an OdbFrame object associated with a given load case.
odb_Frame getFrame(const odb_LoadCase& loadCase);
Required argument
An OdbLoadCase object specifying a load case in the step.
Optional arguments
Return value
An OdbFrame object.
Exceptions
If the OdbFrame object is not found:
This method retrieves an OdbFrame object associated with a given load case and frame value.
odb_Frame getFrame(const odb_LoadCase& loadCase, double frameValue, odb_Enum::odb_MatchEnum match);
Required arguments
An OdbLoadCase object specifying a load case in the step.
A Double specifying the value at which the frame is required. frameValue can be the step time or frequency.
Optional argument
An odb_Enum::odb_MatchEnum specifying which frame to return if there is no frame at the exact frame value. Possible values are odb_Enum::CLOSEST, odb_Enum::BEFORE, odb_Enum::AFTER, and odb_Enum::EXACT. The default value is odb_Enum::CLOSEST.
When match=odb_Enum::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=odb_Enum::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:
This method retrieves a HistoryRegion object associated with a HistoryPoint in the model.
odb_HistoryRegion getHistoryRegion(const odb_HistoryPoint& point, const odb_LoadCase& loadCase);
Required argument
A HistoryPoint object specifying the point in the model.
Optional argument
An OdbLoadCase object specifying a load case in the step.
Return value
A HistoryRegion object.
Exceptions
If a HistoryRegion object is not found:
This method sets the default deformed field variable in a step.
void setDefaultDeformedField(const odb_FieldOutput& field);
Required argument
A FieldOutput object specifying the default deformed field variable for visualization.
Optional arguments
Return value
Exceptions
This method sets the default field variable in a step.
void setDefaultField(const odb_FieldOutput& field);
Required argument
A FieldOutput object specifying the default field variable for visualization.
Optional arguments
Return value
Exceptions
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:
odb_String name() const; odb_String description() const; odb_Enum::odb_DomainEnum domain() const; const odb_LoadCaseRepository& loadCases(); float timePeriod() const; float totalTime() const; odb_String previousStepName() const; odb_String procedure() const; int number() const; bool nlgeom() const; odb_Frame frames(int frameNo); odb_SequenceFrame& frames(); odb_HistoryRegionRepository& historyRegions(); double mass() const; odb_SequenceDouble massCenter() const; odb_SequenceDouble inertiaAboutCenter() const; odb_SequenceDouble inertiaAboutOrigin() const; double acousticMass() const; odb_SequenceDouble acousticMassCenter() const; odb_SequenceInt retainedEigenModes() const; odb_SequenceNodalDofs retainedNodalDofs() const; odb_SequenceNodalDofs eliminatedNodalDofs() const;
An Int specifying the step number.
A Boolean specifying whether geometric nonlinearity can occur in this step.
A Double specifying the current value of the mass of the model. This does not include the mass of the acoustic media if any present.
A Double specifying the current value of the mass of the acoustic media of the model.
A sequence of OdbFrame objects.
A repository of HistoryRegion objects.
A repository of OdbLoadCase objects.
An odb_SequenceDouble specifying the coordinates of the center of mass.
An odb_SequenceDouble 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.
An odb_SequenceDouble 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.
An odb_SequenceDouble specifying the coordinates of the center of mass of the acoustic media.
An odb_SequenceInt specifying the retained eigenmodes in a substructure generation analysis.
A sequence of NodalDofs objects specifying the retained degrees of freedom in a substructure generation analysis.
A sequence of NodalDofs objects specifying the eliminated degrees of freedom in a substructure generation analysis.