from abaqusConstants import *
from .AnalyticSurface import AnalyticSurface
from .AnalyticSurfaceSegment import AnalyticSurfaceSegment
from .BeamOrientationArray import BeamOrientationArray
from .OdbDatumCsys import OdbDatumCsys
from .OdbMeshElementArray import OdbMeshElementArray
from .OdbMeshNodeArray import OdbMeshNodeArray
from .OdbPart import OdbPart
from .OdbRigidBodyArray import OdbRigidBodyArray
from .OdbSet import OdbSet
from .RebarOrientationArray import RebarOrientationArray
from ..Property.MaterialOrientationArray import MaterialOrientationArray
from ..Property.SectionAssignmentArray import SectionAssignmentArray
from ..Section.Section import Section
[docs]class OdbInstanceBase:
"""A part instance is the usage of a part within an assembly.
Attributes
----------
name: str
A String specifying the instance name.
type: SymbolicConstant
A SymbolicConstant specifying the type of the :py:class:`~abaqus.Part.Part.Part` object. Only a value of
DEFORMABLE_BODY is currently supported.
embeddedSpace: SymbolicConstant
A SymbolicConstant specifying the dimensionality of the :py:class:`~abaqus.Part.Part.Part` object. Possible values are
THREE_D, TWO_D_PLANAR, AXISYMMETRIC, and UNKNOWN_DIMENSION.
resultState: SymbolicConstant
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: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.The default value is PROPAGATED.
nodes: OdbMeshNodeArray
An :py:class:`~abaqus.Odb.OdbMeshNodeArray.OdbMeshNodeArray` object.
elements: OdbMeshElementArray
An :py:class:`~abaqus.Odb.OdbMeshElementArray.OdbMeshElementArray` object.
nodeSets: dict[str, OdbSet]
A repository of :py:class:`~abaqus.Odb.OdbSet.OdbSet` objects specifying node sets.
elementSets: dict[str, OdbSet]
A repository of :py:class:`~abaqus.Odb.OdbSet.OdbSet` objects specifying element sets.
surfaces: dict[str, OdbSet]
A repository of :py:class:`~abaqus.Odb.OdbSet.OdbSet` objects specifying surfaces.
sectionAssignments: SectionAssignmentArray
A :py:class:`~abaqus.Property.SectionAssignmentArray.SectionAssignmentArray` object.
rigidBodies: OdbRigidBodyArray
An :py:class:`~abaqus.Odb.OdbRigidBodyArray.OdbRigidBodyArray` object.
beamOrientations: BeamOrientationArray
A :py:class:`~abaqus.Odb.BeamOrientationArray.BeamOrientationArray` object.
materialOrientations: MaterialOrientationArray
A :py:class:`~abaqus.Property.MaterialOrientationArray.MaterialOrientationArray` object.
rebarOrientations: RebarOrientationArray
A :py:class:`~abaqus.Odb.RebarOrientationArray.RebarOrientationArray` object.
analyticSurface: AnalyticSurface
An :py:class:`~abaqus.Odb.AnalyticSurface.AnalyticSurface` object specifying analytic Surface defined on the instance.
Notes
-----
This object can be accessed by:
.. code-block:: python
import odbAccess
session.odbs[name].rootAssembly.instances[name]
session.odbs[name].steps[name].frames[i].fieldOutputs[name].values[i].instance
"""
# A String specifying the instance name.
name: str = ''
# A SymbolicConstant specifying the type of the Part object. Only a value of
# DEFORMABLE_BODY is currently supported.
type: SymbolicConstant = None
# A SymbolicConstant specifying the dimensionality of the Part object. Possible values are
# THREE_D, TWO_D_PLANAR, AXISYMMETRIC, and UNKNOWN_DIMENSION.
embeddedSpace: SymbolicConstant = None
# 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: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.The default value is PROPAGATED.
resultState: SymbolicConstant = PROPAGATED
# An OdbMeshNodeArray object.
nodes: OdbMeshNodeArray = OdbMeshNodeArray()
# An OdbMeshElementArray object.
elements: OdbMeshElementArray = OdbMeshElementArray()
# A repository of OdbSet objects specifying node sets.
nodeSets: dict[str, OdbSet] = dict[str, OdbSet]()
# A repository of OdbSet objects specifying element sets.
elementSets: dict[str, OdbSet] = dict[str, OdbSet]()
# A repository of OdbSet objects specifying surfaces.
surfaces: dict[str, OdbSet] = dict[str, OdbSet]()
# A SectionAssignmentArray object.
sectionAssignments: SectionAssignmentArray = SectionAssignmentArray()
# An OdbRigidBodyArray object.
rigidBodies: OdbRigidBodyArray = OdbRigidBodyArray()
# A BeamOrientationArray object.
beamOrientations: BeamOrientationArray = BeamOrientationArray()
# A MaterialOrientationArray object.
materialOrientations: MaterialOrientationArray = MaterialOrientationArray()
# A RebarOrientationArray object.
rebarOrientations: RebarOrientationArray = RebarOrientationArray()
# An AnalyticSurface object specifying analytic Surface defined on the instance.
analyticSurface: AnalyticSurface = AnalyticSurface()
def __init__(self, name: str, object: OdbPart, localCoordSystem: tuple = ()):
"""This method creates an OdbInstance object from an OdbPart object.
Notes
-----
This function can be accessed by:
.. code-block:: python
session.odbs[*name*].rootAssembly.Instance
Parameters
----------
name
A String specifying the instance name.
object
An OdbPart object.
localCoordSystem
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 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.The fourth sequence specifies the
translation of the local coordinate system from the origin to its intended location.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 points `Pt1= (1,0,0) Pt2= (2,0,0)` to `Pt1 = (0, 6, 0) Pt2 = (0, 7, 0)`
Returns
-------
An OdbInstance object.
"""
pass
[docs] def assignBeamOrientation(self, region: str, method: SymbolicConstant, vector: tuple):
"""This method assigns a beam section orientation to a region of a part instance.
Parameters
----------
region
An OdbSet specifying a region on an instance.
method
A SymbolicConstant specifying the assignment method. Only a value of N1_COSINES is
currently supported.
vector
A sequence of three Floats specifying the approximate local n1n1-direction of the beam
cross-section.
"""
pass
[docs] def assignMaterialOrientation(self, region: str, localCsys: OdbDatumCsys, axis: SymbolicConstant = AXIS_1,
angle: float = 0,
stackDirection: SymbolicConstant = STACK_3):
"""This method assigns a material orientation to a region of a part instance.
Parameters
----------
region
An OdbSet specifying a region on an instance.
localCsys
An OdbDatumCsys object specifying the local coordinate system or None, indicating the
global coordinate system.
axis
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.
angle
A Float specifying the angle of the additional rotation. The default value is 0.0.
stackDirection
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.
"""
pass
[docs] def assignRebarOrientation(self, region: str, localCsys: OdbDatumCsys, axis: SymbolicConstant = AXIS_1,
angle: float = 0):
"""This method assigns a rebar reference orientation to a region of a part instance.
Parameters
----------
region
An OdbSet specifying a region on an instance.
localCsys
An OdbDatumCsys object specifying the local coordinate system or None, indicating the
global coordinate system.
axis
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.
angle
A Float specifying the angle of the additional rotation. The default value is 0.0.
"""
pass
[docs] def getElementFromLabel(self, label: int):
"""This method is used to retrieved an element with a specific label from an instance
object.
Parameters
----------
label
An Int specifying the element label.
Returns
-------
An OdbMeshElement object.
Raises
------
- If no element with the specified label exists:
OdbError: Invalid element label
"""
pass
[docs] def getNodeFromLabel(self, label: int):
"""This method is used to retrieved a node with a specific label from an instance object.
Parameters
----------
label
An Int specifying the node label.
Returns
-------
AnOdbMeshNode object.
Raises
------
- If no node with the specified label exists:
OdbError: Invalid node label
"""
pass
[docs] def assignSection(self, region: str, section: Section):
"""This method is used to assign a section to a region on an instance.
Parameters
----------
region
An OdbSet specifying a region on an instance.
section
A Section object.
Raises
------
- If *region* is not an element set:
OdbError: Section assignment requires element set.
- If the element set is not from the current instance:
OdbError: Section assignment requires element set from this part instance.
"""
pass
[docs] def AnalyticRigidSurf2DPlanar(self, name: str, profile: tuple[AnalyticSurfaceSegment], filletRadius: str = 0):
"""This method is used to define a two-dimensional AnalyticSurface object on the instance.
Parameters
----------
name
The name of the analytic surface.
profile
A sequence of AnalyticSurfaceSegment objects or an OdbSequenceAnalyticSurfaceSegment
object.
filletRadius
A Double specifying the radius of curvature to smooth discontinuities between adjoining
segments. The default value is 0.0.
Raises
------
- If OdbPart associated with the part instance is of type THREE_D:
OdbError: 2D-Planar Analytic Rigid Surface can be defined only if the instance is of
type TWO_D_PLANAR or AXISYMMETRIC.
"""
pass
[docs] def AnalyticRigidSurfExtrude(self, name: str, profile: tuple[AnalyticSurfaceSegment], filletRadius: str = 0,
localCoordData: tuple = ()):
"""This method is used to define a three-dimensional cylindrical AnalyticSurface on the
instance.
Parameters
----------
name
The name of the analytic surface.
profile
A sequence of AnalyticSurfaceSegment objects or an OdbSequenceAnalyticSurfaceSegment
object.
filletRadius
A Double specifying the radius of curvature to smooth discontinuities between adjoining
segments. The default value is 0.0.
localCoordData
A sequence of sequences of Floats specifying the global coordinates of points used to
define the local coordinate system.
Raises
------
- If OdbPart associated with the part instance is not of type THREE_D:
OdbError: Analytic Rigid Surface of type CYLINDER can be defined only if the instance
is of type THREE_D.
"""
pass
[docs] def AnalyticRigidSurfRevolve(self, name: str, profile: tuple[AnalyticSurfaceSegment], filletRadius: str = 0,
localCoordData: tuple = ()):
"""This method is used to define a three-dimensional AnalyticSurface of revolution on the
instance.
Parameters
----------
name
The name of the analytic surface.
profile
A sequence of AnalyticSurfaceSegment objects or an OdbSequenceAnalyticSurfaceSegment
object.
filletRadius
A Double specifying the radius of curvature to smooth discontinuities between adjoining
segments. The default value is 0.0.
localCoordData
A sequence of sequences of Floats specifying the global coordinates of points used to
define the local coordinate system.
Raises
------
- If OdbPart associated with the part instance is not of type THREE_D:
OdbError: Analytic Rigid Surface of type REVOLUTION can be defined only if the
instance is of type THREE_D.
"""
pass
[docs] def RigidBody(self, referenceNode: str, position: str = INPUT, isothermal: Boolean = OFF, elset: str = '',
pinNodes: str = '', tieNodes: str = '', analyticSurface: str = ''):
"""This method defines an OdbRigidBody on the instance.
Parameters
----------
referenceNode
An OdbSet specifying the reference node assigned to the rigid body.
position
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.
isothermal
A Boolean specifying an isothermal rigid body. The default value is OFF. This parameter
is used only for a fully-coupled thermal stress analysis.
elset
An OdbSet specifying an element set assigned to the rigid body.
pinNodes
An OdbSet specifying pin-type nodes assigned to the rigid body.
tieNodes
An OdbSet specifying tie-type nodes assigned to the rigid body.
analyticSurface
An AnalyticSurface specifying the Analytic Rigid Surface assigned to the rigid body.
Raises
------
- If *referenceNode* is not a node set:
OdbError: Rigid body definition requires a node set.
"""
pass