A part instance is the usage of a part within an assembly.
odb.rootAssembly().instances()[name] odb.steps()[name].frames(i).fieldOutputs()[name].values(i).instance()
This method creates an OdbInstance object from an OdbPart object.
odb.rootAssembly().Instance
odb_Instance&
Instance(const odb_String& name,
const odb_Part& object,
const odb_SequenceSequenceFloat& localCoordSystem);Required arguments
An odb_String specifying the instance name.
An OdbPart object.
Optional argument
An odb_SequenceSequenceFloat specifying the rotation and translation of the part instance in the global Cartesian coordinate system. The first three sequences specify the new local coordinate system with its center at the origin.
The fourth sequence specifies the translation of the local coordinate system from the origin to its intended location.
The first sequence specifies a point on the 1-axis.
The second sequence specifies a point on the 2-axis.
The third sequence specifies a point on the 3-axis.
For example, the following sequence moves a part 10 units in the X-direction with no rotation:
localCoordSystem = ((1, 0, 0), (0, 1, 0), (0, 0, 1), (10, 0, 0))
Return value
An OdbInstance object.
Exceptions
InvalidNameError.
This method assigns a beam section orientation to a region of a part instance.
void
assignBeamOrientation(const odb_Set& region,
odb_Enum::odb_OrientationMethodEnum method,
const odb_SequenceFloat& vector);Required arguments
An OdbSet specifying a region on an instance.
An odb_Enum::odb_OrientationMethodEnum specifying the assignment method. Only a value of odb_Enum::N1_COSINES is currently supported.
An odb_SequenceFloat specifying the approximate local
-direction of the beam cross-section.
Optional arguments
Return value
Exceptions
This method assigns a material orientation to a region of a part instance.
void
assignMaterialOrientation(const odb_Set& region,
const odb_DatumCsys& localCsys,
odb_Enum::odb_AxisEnum axis,
float angle,
odb_Enum::odb_StackDirectionEnum stackDirection);Required arguments
An OdbSet specifying a region on an instance.
An OdbDatumCsys object specifying the local coordinate system or None, indicating the global coordinate system.
Optional arguments
An odb_Enum::odb_AxisEnum specifying the axis of a cylindrical or spherical datum coordinate system about which an additional rotation is applied. For shells this axis is also the shell normal. Possible values are odb_Enum::AXIS_1, odb_Enum::AXIS_2, and odb_Enum::AXIS_3. The default value is odb_Enum::AXIS_1.
A Float specifying the angle of the additional rotation. The default value is 0.0.
An odb_Enum::odb_StackDirectionEnum specifying the stack or thickness direction of the material. Possible values are odb_Enum::STACK_1, odb_Enum::STACK_2, odb_Enum::STACK_3, and odb_Enum::STACK_ORIENTATION. The default value is odb_Enum::STACK_3.
Return value
Exceptions
This method assigns a rebar reference orientation to a region of a part instance.
void
assignRebarOrientation(const odb_Set& region,
const odb_DatumCsys& localCsys,
odb_Enum::odb_AxisEnum axis,
float angle);Required arguments
An OdbSet specifying a region on an instance.
An OdbDatumCsys object specifying the local coordinate system or None, indicating the global coordinate system.
Optional arguments
An odb_Enum::odb_AxisEnum specifying the axis of a cylindrical or spherical datum coordinate system about which an additional rotation is applied. For shells this axis is also the shell normal. Possible values are odb_Enum::AXIS_1, odb_Enum::AXIS_2, and odb_Enum::AXIS_3. The default value is odb_Enum::AXIS_1.
A Float specifying the angle of the additional rotation. The default value is 0.0.
Return value
Exceptions
This method is used to retrieved an element with a specific label from an instance object.
odb_Element getElementFromLabel(int label);
Required argument
An Int specifying the element label.
Optional arguments
Return value
An OdbMeshElement object.
Exceptions
If no element with the specified label exists:
This method is used to retrieved a node with a specific label from an instance object.
odb_Node getNodeFromLabel(int label);
Required argument
An Int specifying the node label.
Optional arguments
Return value
AnOdbMeshNode object.
Exceptions
If no node with the specified label exists:
This method is used to assign a section to a region on an instance.
void
assignSection(const odb_Set& region,
const odb_section& section);Required arguments
An OdbSet specifying a region on an instance.
A Section object.
Optional arguments
Return value
Exceptions
If region is not an element set:
If the element set is not from the current instance:
This method is used to define a two-dimensional AnalyticSurface object on the instance.
void
AnalyticRigidSurf2DPlanar(const odb_String& name,
const odb_SequenceAnalyticSurfaceSegment& profile,
double filletRadius);Required arguments
The name of the analytic surface.
A sequence of AnalyticSurfaceSegment objects or an OdbSequenceAnalyticSurfaceSegment object.
Optional argument
A Double specifying the radius of curvature to smooth discontinuities between adjoining segments. The default value is 0.0.
Return value
Exceptions
If OdbPart associated with the part instance is of type THREE_D:
This method is used to define a three-dimensional cylindrical AnalyticSurface on the instance.
void
AnalyticRigidSurfExtrude(const odb_String& name,
const odb_SequenceAnalyticSurfaceSegment& profile,
double filletRadius,
const odb_SequenceSequenceFloat& localCoordData);Required arguments
The name of the analytic surface.
A sequence of AnalyticSurfaceSegment objects or an OdbSequenceAnalyticSurfaceSegment object.
Optional arguments
A Double specifying the radius of curvature to smooth discontinuities between adjoining segments. The default value is 0.0.
An odb_SequenceSequenceFloat specifying the global coordinates of points used to define the local coordinate system.
Return value
Exceptions
If OdbPart associated with the part instance is not of type THREE_D:
This method is used to define a three-dimensional AnalyticSurface of revolution on the instance.
void
AnalyticRigidSurfRevolve(const odb_String& name,
const odb_SequenceAnalyticSurfaceSegment& profile,
double filletRadius,
const odb_SequenceSequenceFloat& localCoordData);Required arguments
The name of the analytic surface.
A sequence of AnalyticSurfaceSegment objects or an OdbSequenceAnalyticSurfaceSegment object.
Optional arguments
A Double specifying the radius of curvature to smooth discontinuities between adjoining segments. The default value is 0.0.
An odb_SequenceSequenceFloat specifying the global coordinates of points used to define the local coordinate system.
Return value
Exceptions
If OdbPart associated with the part instance is not of type THREE_D:
This method defines an OdbRigidBody on the instance.
void
RigidBody(const odb_Set& referenceNode,
odb_Enum::odb_PositionEnum position,
bool isothermal,
const odb_Set& elset,
const odb_Set& pinNodes,
const odb_Set& tieNodes);Required argument
An OdbSet specifying the reference node assigned to the rigid body.
Optional arguments
A symbolic constant specify if the location of the reference node is to be defined by the user. Possible values are odb_Enum::INPUT, and odb_Enum::CENTER_OF_MASS. The default value is odb_Enum::INPUT.
A Boolean specifying an isothermal rigid body. The default value is false. This parameter is used only for a fully-coupled thermal stress analysis.
An OdbSet specifying an element set assigned to the rigid body.
An OdbSet specifying pin-type nodes assigned to the rigid body.
An OdbSet specifying tie-type nodes assigned to the rigid body.
Return value
Exceptions
If referenceNode is not a node set:
This method is used to retrieved a node with a specific label from an instance object.
odb_Node getNodeFromLabel(int label);
Required argument
An Int specifying the node label.
Optional arguments
Return value
An OdbMeshNode object.
Exceptions
If no node with the specified label exists:
This method is used to retrieved a node with a specific label from an instance object.
odb_Node getNodeFromLabel(int label);
Required argument
An Int specifying the node label.
Optional arguments
Return value
An OdbMeshNode object.
Exceptions
If no node with the specified label exists:
Given a sequence of integers defining an element connectivity, this method is used to retrieve the sequence of nodes attached to a specified face of the element based on element type.
odb_SequenceInt
nodesLabelsFromNodeTypeFace(const odb_SequenceInt& elementNodeLabels,
const odb_String& elementType,
odb_Enum::odb_ElementFaceEnumEnum elementFace);Required arguments
A sequence of Ints specifying the node labels defining the connectivity for the entire element.
A string specifying the type of element whose connectivity is provided.
A SymbolicConstant specifying the face of the element for which the node labels are desired.
Optional arguments
Return value
A sequence of Ints specifying the node labels corresponding to the desired element face.
Exceptions
If the specified face is invalid for the element type:
The OdbInstance object can have the following members:
odb_String name() const;
odb_Enum::odb_DimensionEnum embeddedSpace() const;
odb_Enum::odb_PartTypeEnum type() const;
odb_Node nodes(int i) const;
odb_SequenceNode& nodes() const;
odb_Element elements(int i) const;
odb_SequenceElement& elements() const;
odb_SetRepository& nodeSets() const;
odb_SetRepository& elementSets() const;
odb_SetRepository& surfaces() const;
odb_SequenceSectionAssignment sectionAssignments() const;
odb_SequenceBeamOrientation beamOrientations() const;
odb_SequenceMaterialOrientation materialOrientations() const;
odb_SequenceRebarOrientation rebarOrientations() const;
odb_SequenceRigidBody rigidBodies() const;
bool hasAnalyticSurface() const;
odb_AnalyticSurface analyticSurface() const;An odb_String specifying the instance name.
An odb_Enum::odb_PartTypeEnum specifying the type of the Part object. Only a value of odb_Enum::DEFORMABLE_BODY is currently supported.
An odb_Enum::odb_DimensionEnum specifying the dimensionality of the Part object. Possible values are odb_Enum::THREE_D, odb_Enum::TWO_D_PLANAR, odb_Enum::AXISYMMETRIC, and odb_Enum::UNKNOWN_DIMENSION.
An odb_Enum::odb_ResultStateEnum specifying the state of the Instance as modified by the analysis. This member is only present if the Instance is part of the RootAssemblyState tree. Possible values are:
The default value is odb_Enum::PROPAGATED.
odb_Enum::PROPAGATED, specifying that the value is the same as the previous frame or the original rootAssembly.
odb_Enum::MODIFIED, specifying that the geometry of the instance has been changed at this frame.
A sequence of OdbMeshNode objects.
A sequence of OdbMeshElement objects.
A repository of OdbSet objects specifying node sets.
A repository of OdbSet objects specifying element sets.
A repository of OdbSet objects specifying surfaces.
A sequence of SectionAssignment objects.
A sequence of OdbRigidBody objects.
A sequence of BeamOrientation objects.
A sequence of MaterialOrientation objects.
A sequence of RebarOrientation objects.
An AnalyticSurface object specifying analytic Surface defined on the instance.