A part instance is the usage of a part within an assembly.
import odbAccess session.odbs[name].rootAssembly.instances[name] session.odbs[name].steps[name].frames[i].fieldOutputs[name].values[i]\ .instance
This method creates an OdbInstance object from an OdbPart object.
session.odbs[name].rootAssembly.Instance
Required arguments
A String specifying the instance name.
An OdbPart object.
Optional argument
A sequence of sequences of three Floats 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))The following sequence moves a part 5 units in the X-direction with rotation:
localCoordSystem = ((0, 1, 0), (1, 0, 0), (0, 0, 1), (5, 0, 0))transforms a part containing the two pointsPt1= (1,0,0) Pt2= (2,0,0)toPt1 = (0, 6, 0) Pt2 = (0, 7, 0)
Return value
An OdbInstance object.
Exceptions
InvalidNameError.
This method assigns a beam section orientation to a region of a part instance.
Required arguments
An OdbSet specifying a region on an instance.
A SymbolicConstant specifying the assignment method. Only a value of N1_COSINES is currently supported.
A sequence of three Floats 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.
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
A SymbolicConstant 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 AXIS_1, AXIS_2, and AXIS_3. The default value is AXIS_1.
A Float specifying the angle of the additional rotation. The default value is 0.0.
A SymbolicConstant specifying the stack or thickness direction of the material. Possible values are STACK_1, STACK_2, STACK_3, and STACK_ORIENTATION. The default value is STACK_3.
Return value
Exceptions
This method assigns a rebar reference orientation to a region of a part instance.
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
A SymbolicConstant 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 AXIS_1, AXIS_2, and AXIS_3. The default value is 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.
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.
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.
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.
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.
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.
A sequence of sequences of Floats 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.
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.
A sequence of sequences of Floats 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.
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 INPUT, and CENTER_OF_MASS. The default value is INPUT.
A Boolean specifying an isothermal rigid body. The default value is OFF. 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.
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.
Required argument
An Int specifying the node label.
Optional arguments
Return value
An OdbMeshNode object.
Exceptions
If no node with the specified label exists:
The OdbInstance object can have the following members:
A String specifying the instance name.
A SymbolicConstant specifying the type of the Part object. Only a value of DEFORMABLE_BODY is currently supported.
A SymbolicConstant specifying the dimensionality of the Part object. Possible values are THREE_D, TWO_D_PLANAR, AXISYMMETRIC, and UNKNOWN_DIMENSION.
A SymbolicConstant 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 PROPAGATED.
PROPAGATED, specifying that the value is the same as the previous frame or the original rootAssembly.
MODIFIED, specifying that the geometry of the instance has been changed at this frame.
An OdbMeshNodeArray object.
An OdbMeshElementArray object.
A repository of OdbSet objects specifying node sets.
A repository of OdbSet objects specifying element sets.
A repository of OdbSet objects specifying surfaces.
A SectionAssignmentArray object.
An OdbRigidBodyArray object.
A BeamOrientationArray object.
A MaterialOrientationArray object.
A RebarOrientationArray object.
An AnalyticSurface object specifying analytic Surface defined on the instance.