Abaqus Output Database<a class="headerlink" href="#abaqus-output-database" title="Permalink to this heading">#

Parameters:

referenceNode (OdbSet) – An OdbSet object specifying the reference node set associated with the rigid body.
position (SymbolicConstant, default: INPUT) – A SymbolicConstant specifying the specific location of the OdbRigidBody reference node relative to the rest of the rigid body. Possible values are INPUT and CENTER_OF_MASS. The default value is INPUT.
isothermal (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying specify whether the OdbRigidBody can have temperature gradients or be isothermal. This is used only for fully coupled thermal-stress analysis The default value is ON.
elements (OdbSet, default: <abaqus.Odb.OdbSet.OdbSet object at 0x7f350e0fd4e0>) – An OdbSet object specifying the element set whose motion is governed by the motion of rigid body reference node.
tieNodes (OdbSet, default: <abaqus.Odb.OdbSet.OdbSet object at 0x7f350e0fd870>) – An OdbSet object specifying the node set which have both translational and rotational degrees of freedom associated with the rigid body.
pinNodes (OdbSet, default: <abaqus.Odb.OdbSet.OdbSet object at 0x7f350e0fd3f0>) – An OdbSet object specifying the node set which have only translational degrees of freedom associated with the rigid body.
analyticSurface (Optional[AnalyticSurface], default: None) – An AnalyticSurface object specifying the analytic surface whose motion is governed by the motion of rigid body reference node.

Returns:

An OdbRigidBody object.

Return type:

OdbRigidBody

SectionAssignment(region, section)[source]#

This method is used to assign a section on an assembly or part. Section assignment on the assembly is limited to the connector elements only.

Note

Check SectionAssignment on help.3ds.com/0.1..

Parameters:

region (str) – An OdbSet specifying a region.
section (Section) – A Section object.

Raises:

OdbError – If region is not an element set.

addElements(labels, connectivity, instanceNames, type, elementSetName='', sectionCategory=None)[source]#

This method is used to define elements using nodes defined at the OdbAssembly and/or OdbInstance level. For connector elements connected to ground, specify the lone node in the connectivity. The position of the ground node cannot be specified. This is a limitation. Warning:Adding elements not in ascending order of their labels may cause Abaqus/Viewer to plot contours incorrectly.

Note

Check OdbAssemblyBase.addElements on help.3ds.com/0.1..

Parameters:

labels (tuple) – A sequence of Ints specifying the element labels.
connectivity (tuple) – A sequence of sequences of Ints specifying the nodal connectivity.
instanceNames (tuple) – A sequence of Strings specifying the instanceNames of each node in the nodal connectivity array. If the node is defined at the assembly level, the instance name should be an empty string
type (str) – A String specifying the element type.
elementSetName (str, default: '') – A String specifying a name for this element set. The default value is the empty string.
sectionCategory (Optional[SectionCategory], default: None) – A SectionCategory object for this element set.

Raises:

OdbError – Only certain element types are permitted at the assembly level. e.g., connector elements.
OdbError – If length of label array does not match connectivity data length.

addNodes(labels, coordinates, nodeSetName=None)[source]#

This method adds nodes to the OdbAssembly object using node labels and coordinates. Warning:Adding nodes not in ascending order of their labels may cause Abaqus/Viewer to plot contours incorrectly.

Note

Check OdbAssemblyBase.addNodes on help.3ds.com/0.1..

Parameters:

labels (tuple) – A sequence of Ints specifying the node labels.
coordinates (tuple) – A sequence of sequences of Floats specifying the nodal coordinates.
nodeSetName (Optional[str], default: None) – A String specifying a name for this node set. The default value is None.

Raises:

OdbError – If length of labels does not match length of coordinates.
OdbError – If width of coordinate array does not match assembly dimension.

connectorOrientations: ConnectorOrientationArray = [][source]#: A ConnectorOrientationArray object.

datumCsyses: Dict[str, OdbDatumCsys] = {}[source]#: A repository of OdbDatumCsys objects.

elementSets: Dict[str, OdbSet] = {}[source]#: A repository of OdbSet objects specifying element sets.

elements: OdbMeshElementArray = [][source]#: An OdbMeshElementArray object.

instances: Dict[str, OdbInstance] = {}[source]#: A repository of OdbInstance objects.

nodeSets: Dict[str, OdbSet] = {}[source]#: A repository of OdbSet objects specifying node sets.

nodes: OdbMeshNodeArray = [][source]#: An OdbMeshNodeArray object.

pretensionSections: OdbPretensionSectionArray = [][source]#: An OdbPretensionSectionArray object.

rigidBodies: OdbRigidBodyArray = [][source]#: An OdbRigidBodyArray object.

sectionAssignments: SectionAssignmentArray = [][source]#: A SectionAssignmentArray object.

surfaces: Dict[str, OdbSet] = {}[source]#: A repository of OdbSet objects specifying surfaces.

OdbAssemblyBase#

class OdbAssemblyBase[source]#

The OdbAssembly object has no constructor; it is created automatically when an Odb object is created. Abaqus creates the rootAssembly member when an Odb object is created.

Note

This object can be accessed by:

import odbAccess
session.odbs[name].rootAssembly

Note

Check OdbAssemblyBase on help.3ds.com/0.1..

Public Data Attributes:

`instances`	A repository of OdbInstance objects.
`nodeSets`	A repository of OdbSet objects specifying node sets.
`elementSets`	A repository of OdbSet objects specifying element sets.
`surfaces`	A repository of OdbSet objects specifying surfaces.
`nodes`	An `OdbMeshNodeArray` object.
`elements`	An `OdbMeshElementArray` object.
`datumCsyses`	A repository of OdbDatumCsys objects.
`sectionAssignments`	A `SectionAssignmentArray` object.
`rigidBodies`	An `OdbRigidBodyArray` object.
`pretensionSections`	An `OdbPretensionSectionArray` object.
`connectorOrientations`	A `ConnectorOrientationArray` object.

Public Methods:

`ConnectorOrientation`(region[, localCsys1, ...])	This method assigns a connector orientation to a connector region.
`SectionAssignment`(region, section)	This method is used to assign a section on an assembly or part.
`addElements`(labels, connectivity, ...[, ...])	This method is used to define elements using nodes defined at the OdbAssembly and/or OdbInstance level.
`addNodes`(labels, coordinates[, nodeSetName])	This method adds nodes to the OdbAssembly object using node labels and coordinates.
`RigidBody`(referenceNode[, position, ...])	This method defines an OdbRigidBody on the assembly.

ConnectorOrientation(region, localCsys1=None, axis1=abaqusConstants.AXIS_1, angle1=0, orient2sameAs1=OFF, localCsys2=None, axis2=abaqusConstants.AXIS_1, angle2=0)[source]#

This method assigns a connector orientation to a connector region.

Note

Check ConnectorOrientation on help.3ds.com/0.1..

Parameters:

region (str) – An OdbSet specifying a region.
localCsys1 (Optional[OdbDatumCsys], default: None) – An OdbDatumCsys object specifying the first connector node local coordinate system or None, indicating the global coordinate system.
axis1 (SymbolicConstant, default: AXIS_1) – A SymbolicConstant specifying the axis of a cylindrical or spherical datum coordinate system about which an additional rotation of the first connector node is applied. Possible values are AXIS_1, AXIS_2, and AXIS_3. The default value is AXIS_1.
angle1 (float, default: 0) – A Float specifying the angle of the additional rotation about the first connector node axis. The default value is 0.0.
orient2sameAs1 (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the same orientation settings should be used for the second node of the connector. The default value is OFF.
localCsys2 (Optional[OdbDatumCsys], default: None) – An OdbDatumCsys object specifying the second connector node local coordinate system or None, indicating the global coordinate system.
axis2 (SymbolicConstant, default: AXIS_1) – A SymbolicConstant specifying the axis of a cylindrical or spherical datum coordinate system about which an additional rotation of the second connector node is applied. Possible values are AXIS_1, AXIS_2, and AXIS_3. The default value is AXIS_1.
angle2 (float, default: 0) – A Float specifying the angle of the additional rotation about the second connector node axis. The default value is 0.0.

Raises:

OdbError – If region is not an element set.

RigidBody(referenceNode, position=abaqusConstants.INPUT, isothermal=OFF, elset='', pinNodes='', tieNodes='', analyticSurface='')[source]#

This method defines an OdbRigidBody on the assembly.

Note

Parameters:

referenceNode (str) – An OdbSet specifying the reference node assigned to the rigid body.
position (str, default: INPUT) – 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 (Union[AbaqusBoolean, bool], default: OFF) – 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 (str, default: '') – An OdbSet specifying an element set assigned to the rigid body.
pinNodes (str, default: '') – An OdbSet specifying pin-type nodes assigned to the rigid body.
tieNodes (str, default: '') – An OdbSet specifying tie-type nodes assigned to the rigid body.
analyticSurface (str, default: '') – An AnalyticSurface specifying the Analytic Rigid Surface assigned to the rigid body.

Raises:

OdbError – If referenceNode is not a node set

SectionAssignment(region, section)[source]#

This method is used to assign a section on an assembly or part. Section assignment on the assembly is limited to the connector elements only.

Note

Check SectionAssignment on help.3ds.com/0.1..

Parameters:

region (str) – An OdbSet specifying a region.
section (Section) – A Section object.

Raises:

OdbError – If region is not an element set.

addElements(labels, connectivity, instanceNames, type, elementSetName='', sectionCategory=None)[source]#

This method is used to define elements using nodes defined at the OdbAssembly and/or OdbInstance level. For connector elements connected to ground, specify the lone node in the connectivity. The position of the ground node cannot be specified. This is a limitation. Warning:Adding elements not in ascending order of their labels may cause Abaqus/Viewer to plot contours incorrectly.

Note

Check OdbAssemblyBase.addElements on help.3ds.com/0.1..

Parameters:

labels (tuple) – A sequence of Ints specifying the element labels.
connectivity (tuple) – A sequence of sequences of Ints specifying the nodal connectivity.
instanceNames (tuple) – A sequence of Strings specifying the instanceNames of each node in the nodal connectivity array. If the node is defined at the assembly level, the instance name should be an empty string
type (str) – A String specifying the element type.
elementSetName (str, default: '') – A String specifying a name for this element set. The default value is the empty string.
sectionCategory (Optional[SectionCategory], default: None) – A SectionCategory object for this element set.

Raises:

OdbError – Only certain element types are permitted at the assembly level. e.g., connector elements.
OdbError – If length of label array does not match connectivity data length.

addNodes(labels, coordinates, nodeSetName=None)[source]#

This method adds nodes to the OdbAssembly object using node labels and coordinates. Warning:Adding nodes not in ascending order of their labels may cause Abaqus/Viewer to plot contours incorrectly.

Note

Check OdbAssemblyBase.addNodes on help.3ds.com/0.1..

Parameters:

labels (tuple) – A sequence of Ints specifying the node labels.
coordinates (tuple) – A sequence of sequences of Floats specifying the nodal coordinates.
nodeSetName (Optional[str], default: None) – A String specifying a name for this node set. The default value is None.

Raises:

OdbError – If length of labels does not match length of coordinates.
OdbError – If width of coordinate array does not match assembly dimension.

connectorOrientations: List[ConnectorOrientation] = [][source]#: A ConnectorOrientationArray object.

datumCsyses: Dict[str, OdbDatumCsys] = {}[source]#: A repository of OdbDatumCsys objects.

elementSets: Dict[str, OdbSet] = {}[source]#: A repository of OdbSet objects specifying element sets.

elements: List[OdbMeshElement] = [][source]#: An OdbMeshElementArray object.

instances: Dict[str, OdbInstance] = {}[source]#: A repository of OdbInstance objects.

nodeSets: Dict[str, OdbSet] = {}[source]#: A repository of OdbSet objects specifying node sets.

nodes: List[OdbMeshNode] = [][source]#: An OdbMeshNodeArray object.

pretensionSections: List[OdbPretensionSection] = [][source]#: An OdbPretensionSectionArray object.

rigidBodies: List[OdbRigidBody] = [][source]#: An OdbRigidBodyArray object.

sectionAssignments: List[SectionAssignment] = [][source]#: A SectionAssignmentArray object.

surfaces: Dict[str, OdbSet] = {}[source]#: A repository of OdbSet objects specifying surfaces.

OdbCommands#

AnalyticSurfaceProfile()[source]#

This method creates a OdbSequenceAnalyticSurfaceSegment object.

Path:

odbAccess.AnalyticSurfaceProfile()

Returns:: An OdbSequenceAnalyticSurfaceSegment object.
Return type:: OdbSequenceAnalyticSurfaceSegment

isUpgradeRequiredForOdb(upgradeRequiredOdbPath)[source]#

This method determines if an output database file needs to be upgraded to the current release. You can access this method using either of the following techniques:

From a script running outside Abaqus/CAE. For example:

import odbAccess
needsUpgrade = odbAccess.isUpgradeRequiredForOdb(
    upgradeRequiredOdbPath='myOdb.odb')

From the Visualization module in Abaqus/CAE. For example:

import visualization
needsUpgrade = session.isUpgradeRequiredForOdb(upgradeRequiredOdbPath='myOdb.odb')

Note

Check OdbCommands.isUpgradeRequiredForOdb on help.3ds.com/0.1..

Parameters:: upgradeRequiredOdbPath (str) – An String specifying the path to an output database file to test. The test determines if the output database needs to be upgraded to the current release.
Returns:: A Boolean indicating the result of the test. A value of True indicates that the output database needs to be upgraded to the current release.
Return type:: Boolean

maxEnvelop()[source]#

Retrieve the maximum value of an output variable over a number of fields.

Returns:

A sequence of two fieldOutput objects. The first fieldOutput object contains the maximum value. The second fieldOutput object contains the index of the field containing the maximum value. The index follows the order in which fields are positioned in the list of fieldOutput objects provided as the argument to the function.

Return type:

Tuple[FieldOutput, FieldOutput]

Raises:

OdbError –
TypeError – This function takes no keyword arguments.

minEnvelop()[source]#

Retrieve the minimum value of an output variable over a number of fields.

Returns:

A sequence of two fieldOutput objects. The first fieldOutput object contains the minimum value. The second fieldOutput object contains the index of the field containing the minimum value. The index follows the order in which fields are positioned in the list of fieldOutput objects provided as the argument to the function.

Return type:

Tuple[FieldOutput, FieldOutput]

Raises:

OdbError –
TypeError – This function takes no keyword arguments.

openOdb(path, readOnly=OFF, readInternalSets=OFF)[source]#

This method opens an existing output database (.odb) file and creates a new Odb object. You typically execute this method outside of Abaqus/CAE when, in most cases, only one output database is open at any time. For example:

import odbAccess
shockLoadOdb = odbAccess.openOdb(path='myOdb.odb')

Note

Check OdbCommands.openOdb on help.3ds.com/0.1..

Parameters:

path (str) – A String specifying the path to an existing output database (.odb) file.
readOnly (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the file will permit only read access or both read and write access. The initial value is False, indicating that both read and write access will be permitted.
readInternalSets (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the file will permit access to sets specified as Internal on the database. The initial value is False, indicating that internal sets will not be read.

Returns:

An Odb object.

Return type:

Odb

Raises:

OdbError – If the output database was generated by a previous release of Abaqus and needs upgrading. Run abaqus upgrade -job <newFilename> -odb <oldFileName> to upgrade it.
OdbError –
opened. – If the output database was generated by a newer release of Abaqus, and the installation of Abaqus needs upgrading.

upgradeOdb(existingOdbPath, upgradedOdbPath)[source]#

This method upgrades an existing Odb object to the current release and writes the upgraded version of the Odb object to a file. In addition, Abaqus/CAE writes information about the status of the upgrade to a log (.log) file. You can access this method using either of the following techniques:

From a script running outside Abaqus/CAE. For example:

import odbAccess
odbAccess.upgradeOdb(existingOdbPath='oldOdb', upgradedOdbPath='upgradedOdb')

From the session object in Abaqus/CAE. For example:

import visualization
session.upgradeOdb(existingOdbPath='oldOdb', upgradedOdbPath='upgradedOdb')

Note

Check OdbCommands.upgradeOdb on help.3ds.com/0.1..

Parameters:

existingOdbPath (str) – An String specifying the path to the file containing the output database to be upgraded.
upgradedOdbPath (str) – An String specifying the path to the file that will contain the upgraded output database.

Raises:

OdbError – If the output database upgrade fails.

OdbDatumCsys#

class OdbDatumCsys[source]#

The OdbDatumCsys object contains a coordinate system that can be stored in an output database. You can create the datum coordinate system in the Visualization module during an Abaqus/CAE session and save the datum coordinate system to the output database before you exit Abaqus/CAE. Alternatively, the analysis code can write the datum coordinate system to the output database.

Note

This object can be accessed by:

import odbAccess
session.odbs[name].rootAssembly.datumCsyses[name]

Note

Check OdbDatumCsys on help.3ds.com/0.1..

Public Data Attributes:

`name`	A String specifying the repository key.
`coordSysType`	A SymbolicConstant specifying the type of coordinate system.
`origin`	A tuple of Floats specifying the coordinates of the origin of the datum coordinate system.
`xAxis`	A tuple of Floats specifying a point on the X-axis.
`yAxis`	A tuple of Floats specifying a point on the Y-axis.
`zAxis`	A tuple of Floats specifying a point on the Z-axis.

Public Methods:

`DatumCsysByThreePoints`(name, coordSysType, ...)	This method creates an OdbDatumCsys object using three points.
`DatumCsysByThreeNodes`(name, coordSysType, ...)	This method creates an OdbDatumCsys object using the coordinates of three OdbMeshNode objects.
`DatumCsysByThreeCircNodes`(name, ...)	This method is convenient to use where there are no nodes along the axis of a hollow cylinder or at the center of a hollow sphere.
`DatumCsysBy6dofNode`(name, coordSysType, origin)	A datum coordinate system created with this method results in a system that follows the position of a node.
`DatumCsys`(name, datumCsys)	This method copies oneOdbDatumCsys object to a new OdbDatumCsys object.
`globalToLocal`(coordinates)	This method transforms specified coordinates in the global coordinate system into this local coordinate system.
`localToGlobal`(coordinates)	This method transforms specified coordinates in this local coordinate system into the global coordinate system.

DatumCsys(name, datumCsys)[source]#

This method copies oneOdbDatumCsys object to a new OdbDatumCsys object.

Note

This function can be accessed by:

session.odbs[name].rootAssembly.DatumCsysByThreePoints

Note

Check DatumCsys on help.3ds.com/0.1..

Parameters:

name (str) – A String specifying the repository key.
datumCsys (OdbDatumCsys) – An OdbDatumCsys object specifying the object to be copied.

Returns:

An OdbDatumCsys object.

Return type:

DatumCsysBy6dofNode(name, coordSysType, origin)[source]#

A datum coordinate system created with this method results in a system that follows the position of a node. The node location defines the origin of the datum coordinate system. The rotational displacement (UR1, UR2, UR3) of the node defines the orientation of the coordinate system axes. Results, such as those for displacement, are resolved into the orientation of the datum coordinate system without regard to the position of its origin. The last argument is given in the form of an OdbMeshNode object.

Note

This function can be accessed by:

session.odbs[name].rootAssembly.DatumCsysByThreePoints

Note

Check DatumCsysBy6dofNode on help.3ds.com/0.1..

Parameters:

name (str) – A String specifying the repository key.
coordSysType (SymbolicConstant) – A SymbolicConstant specifying the type of coordinate system. Possible values are CARTESIAN, CYLINDRICAL, and SPHERICAL.
origin (OdbMeshNode) – An OdbMeshNode object specifying the origin of the datum coordinate system.

Returns:

An OdbDatumCsys object.

Return type:

DatumCsysByThreeCircNodes(name, coordSysType, node1Arc, node2Arc, node3Arc)[source]#

This method is convenient to use where there are no nodes along the axis of a hollow cylinder or at the center of a hollow sphere. The three nodes that you provide as arguments determine a circle in space. The center of the circle is the origin of the datum coordinate system. The normal to the circle is parallel to the zz-axis of a cylindrical coordinate system or to the ϕϕ-axis of a spherical coordinate system. The line from the origin to the first node defines the rr-axis.

Note

This function can be accessed by:

session.odbs[name].rootAssembly.DatumCsysByThreePoints

Note

Check DatumCsysByThreeCircNodes on help.3ds.com/0.1..

Parameters:

name (str) – A String specifying the repository key.
coordSysType (SymbolicConstant) – A SymbolicConstant specifying the type of coordinate system. Possible values are CARTESIAN, CYLINDRICAL, and SPHERICAL.
node1Arc (OdbMeshNode) – An OdbMeshNode object that lies on the circular arc.
node2Arc (OdbMeshNode) – An OdbMeshNode object that lies on the circular arc.
node3Arc (OdbMeshNode) – An OdbMeshNode object that lies on the circular arc.

Returns:

An OdbDatumCsys object.

Return type:

DatumCsysByThreeNodes(name, coordSysType, origin, point1, point2)[source]#

This method creates an OdbDatumCsys object using the coordinates of three OdbMeshNode objects. A datum coordinate system created with this method results in a system that follows the position of the three nodes. Results, such as those for displacement, are resolved into the orientation of the datum coordinate system without regard to the position of its origin. The last three arguments are given in the form of an OdbMeshNode object.

Note

This function can be accessed by:

session.odbs[name].rootAssembly.DatumCsysByThreePoints

Note

Check DatumCsysByThreeNodes on help.3ds.com/0.1..

Parameters:

name (str) – A String specifying the repository key.
coordSysType (SymbolicConstant) – A SymbolicConstant specifying the type of coordinate system. Possible values are CARTESIAN, CYLINDRICAL, and SPHERICAL.
origin (OdbMeshNode) – An OdbMeshNode object specifying a node at the origin of the datum coordinate system.
point1 (OdbMeshNode) – An OdbMeshNode object specifying a node on the local 1- or rr-axis.
point2 (OdbMeshNode) – An OdbMeshNode object specifying a node in the 1-2 or rr-θθ plane.

Returns:

An OdbDatumCsys object.

Return type:

DatumCsysByThreePoints(name, coordSysType, origin, point1, point2)[source]#

This method creates an OdbDatumCsys object using three points. A datum coordinate system created with this method results in a fixed system.

Note

This function can be accessed by:

session.odbs[name].rootAssembly.DatumCsysByThreePoints

Note

Check DatumCsysByThreePoints on help.3ds.com/0.1..

Parameters:

name (str) – A String specifying the repository key.
coordSysType (SymbolicConstant) – A SymbolicConstant specifying the type of coordinate system. Possible values are CARTESIAN, CYLINDRICAL, and SPHERICAL.
origin (tuple) – A sequence of Floats specifying the coordinates of the origin of the datum coordinate system.
point1 (tuple) – A sequence of Floats specifying the coordinates of a point on the local 1- or rr-axis.
point2 (tuple) – A sequence of Floats specifying the coordinates of a point in the 1-2 or rr-θθ plane.

Returns:

An OdbDatumCsys object.

Return type:

coordSysType: Optional[SymbolicConstant] = None[source]#: A SymbolicConstant specifying the type of coordinate system. Possible values are CARTESIAN, CYLINDRICAL, and SPHERICAL.

globalToLocal(coordinates)[source]#

This method transforms specified coordinates in the global coordinate system into this local coordinate system.

New in version 2022: The globalToLocal method was added.

Note

Check OdbDatumCsys.globalToLocal on help.3ds.com/0.1..

Parameters:: coordinates (Tuple[float, float, float]) – A tuple of three Floats representing the coordinates in the global coordinate system.
Returns:: A tuple of three Floats representing the coordinates in this local coordinate system.
Return type:: Tuple[float, float, float]

localToGlobal(coordinates)[source]#

This method transforms specified coordinates in this local coordinate system into the global coordinate system.

New in version 2022: The localToGlobal method was added.

Note

Check OdbDatumCsys.localToGlobal on help.3ds.com/0.1..

Parameters:: coordinates (Tuple[float, float, float]) – A tuple of three Floats representing the coordinates in the local coordinate system.
Returns:: A tuple of three Floats representing the coordinates in this global coordinate system.
Return type:: Tuple[float, float, float]

name: str = ''[source]#: A String specifying the repository key.

origin: Optional[float] = None[source]#: A tuple of Floats specifying the coordinates of the origin of the datum coordinate system.

xAxis: Optional[float] = None[source]#: A tuple of Floats specifying a point on the X-axis.

yAxis: Optional[float] = None[source]#: A tuple of Floats specifying a point on the Y-axis.

zAxis: Optional[float] = None[source]#: A tuple of Floats specifying a point on the Z-axis.

OdbFrame#

class OdbFrame(incrementNumber: int, frameValue: float, description: str = '')[source]#

class OdbFrame(mode: int, frequency: float, description: str = '')

class OdbFrame(loadCase: OdbLoadCase, description: str = '', frequency: float = 0)

The domain of the OdbFrame object is taken from the parent step.

Note

This object can be accessed by:

import odbAccess
session.odbs[name].steps[name].frames[i]

Note

Check OdbFrame on help.3ds.com/0.1..

Public Data Attributes:

`cyclicModeNumber`	An Int specifying the cyclic mode number associated with the data stored on this frame.
`domain`	A SymbolicConstant specifying the domain of the step of which the frame is a member.
`frequency`	A Float specifying the frequency.
`mode`	An Int specifying the eigenmode.
`associatedFrame`	An `OdbFrame` object specifying the real or imaginary portion of the data corresponding to this cyclic symmetry mode.
`fieldOutputs`	A repository of FieldOutput objects specifying the key to the fieldOutputs repository is a String representing an output variable.
`loadCase`	An `OdbLoadCase` object specifying the load case for the frame.
`description`	A String specifying the contents of the frame.

Public Methods:

`__init__`(**kwds)	Helper for @overload to raise when called.
`Frame`(args, *kwargs)
`FieldOutput`([validInvariants, ...])

FieldOutput(name: str, description: str, type: SymbolicConstant, componentLabels: tuple = (), validInvariants: Optional[SymbolicConstant] = None, isEngineeringTensor: Union[AbaqusBoolean, bool] = OFF)[source]#
FieldOutput(field: FieldOutput, name: str = '', description: str = '')

Frame(*args, **kwargs)[source]#

associatedFrame: Optional[OdbFrame] = None[source]#: An OdbFrame object specifying the real or imaginary portion of the data corresponding to this cyclic symmetry mode.

cyclicModeNumber: Optional[int] = None[source]#: An Int specifying the cyclic mode number associated with the data stored on this frame. Only frequency analyses of cyclic symmetry models possess cyclic mode numbers.

description: str = ''[source]#: A String specifying the contents of the frame. The default value is an empty string.

domain: Optional[SymbolicConstant] = None[source]#: A SymbolicConstant specifying the domain of the step of which the frame is a member. Possible values are TIME, FREQUENCY, and MODAL.

fieldOutputs: Dict[str, FieldOutput] = {}[source]#: A repository of FieldOutput objects specifying the key to the fieldOutputs repository is a String representing an output variable.

frameValue: float[source]#: A Float specifying the value in units determined by the domain member of the Step object. The equivalent in the time domain is stepTime; in the frequency domain the equivalent is frequency; and in the modal domain the equivalent is mode.

frequency: float = 0[source]#: A Float specifying the frequency. This member is valid only if domain = FREQUENCY or if the procedureType member of the Step object=FREQUENCY. The default value is 0.0.

incrementNumber: int[source]#: An Int specifying the frame increment number within the step. The base frame has normally increment number 0, and the results run from 1. In case of multiple load cases, the same increment number is duplicated for each loadcase.

loadCase: OdbLoadCase = <abaqus.Odb.OdbLoadCase.OdbLoadCase object>[source]#: An OdbLoadCase object specifying the load case for the frame.

mode: Optional[int] = None[source]#: An Int specifying the eigenmode. This member is valid only if domain = MODAL.

OdbFrameArray#

OdbFrameArray[source]#: alias of List[OdbFrame]

OdbInstance#

class OdbInstance(name, object, localCoordSystem=())[source]#

Public Data Attributes:

Inherited from OdbInstanceBase

`name`	A String specifying the instance name.
`type`	A SymbolicConstant specifying the type of the Part object.
`embeddedSpace`	A SymbolicConstant specifying the dimensionality of the Part object.
`resultState`	A SymbolicConstant specifying the state of the Instance as modified by the analysis.
`nodes`	An `OdbMeshNodeArray` object.
`elements`	An `OdbMeshElementArray` object.
`nodeSets`	A repository of OdbSet objects specifying node sets.
`elementSets`	A repository of OdbSet objects specifying element sets.
`surfaces`	A repository of OdbSet objects specifying surfaces.
`sectionAssignments`	A `SectionAssignmentArray` object.
`rigidBodies`	An `OdbRigidBodyArray` object.
`beamOrientations`	A `BeamOrientationArray` object.
`materialOrientations`	A `MaterialOrientationArray` object.
`rebarOrientations`	A `RebarOrientationArray` object.
`analyticSurface`	An `AnalyticSurface` object specifying analytic Surface defined on the instance.

Public Methods:

NodeSet(name, nodes)

This method creates a node set from an array of OdbMeshNode objects (for part instance-level sets) or from a sequence of arrays of OdbMeshNode objects (for assembly-level sets).

Inherited from OdbInstanceBase

`__init__`(name, object[, localCoordSystem])	This method creates an OdbInstance object from an OdbPart object.
`assignBeamOrientation`(region, method, vector)	This method assigns a beam section orientation to a region of a part instance.
`assignMaterialOrientation`(region, localCsys)	This method assigns a material orientation to a region of a part instance.
`assignRebarOrientation`(region, localCsys[, ...])	This method assigns a rebar reference orientation to a region of a part instance.
`getElementFromLabel`(label)	This method is used to retrieved an element with a specific label from an instance object.
`getNodeFromLabel`(label)	This method is used to retrieved a node with a specific label from an instance object.
`assignSection`(region, section)	This method is used to assign a section to a region on an instance.
`AnalyticRigidSurf2DPlanar`(name, profile[, ...])	This method is used to define a two-dimensional AnalyticSurface object on the instance.
`AnalyticRigidSurfExtrude`(name, profile[, ...])	This method is used to define a three-dimensional cylindrical AnalyticSurface on the instance.
`AnalyticRigidSurfRevolve`(name, profile[, ...])	This method is used to define a three-dimensional AnalyticSurface of revolution on the instance.
`RigidBody`(referenceNode[, position, ...])	This method defines an OdbRigidBody on the instance.

AnalyticRigidSurf2DPlanar(name, profile, filletRadius=0)[source]#

This method is used to define a two-dimensional AnalyticSurface object on the instance.

Note

Check AnalyticRigidSurf2DPlanar on help.3ds.com/0.1..

Parameters:

name (str) – The name of the analytic surface.
profile (Tuple[AnalyticSurfaceSegment, ...]) – A sequence of AnalyticSurfaceSegment objects or an OdbSequenceAnalyticSurfaceSegment object.
filletRadius (str, default: 0) – A Double specifying the radius of curvature to smooth discontinuities between adjoining segments. The default value is 0.0.

Raises:

OdbError –

:raises type TWO_D_PLANAR` or :class:`AXISYMMETRIC.: If OdbPart associated with the part instance is of type THREE_D.

AnalyticRigidSurfExtrude(name, profile, filletRadius=0, localCoordData=())[source]#

This method is used to define a three-dimensional cylindrical AnalyticSurface on the instance.

Note

Check AnalyticRigidSurfExtrude on help.3ds.com/0.1..

Parameters:

name (str) – The name of the analytic surface.
profile (Tuple[AnalyticSurfaceSegment, ...]) – A sequence of AnalyticSurfaceSegment objects or an OdbSequenceAnalyticSurfaceSegment object.
filletRadius (str, default: 0) – A Double specifying the radius of curvature to smooth discontinuities between adjoining segments. The default value is 0.0.
localCoordData (tuple, default: ()) – A sequence of sequences of Floats specifying the global coordinates of points used to define the local coordinate system.

Raises:

OdbError –
of type THREE_D – If OdbPart associated with the part instance is not of type THREE_D.

AnalyticRigidSurfRevolve(name, profile, filletRadius=0, localCoordData=())[source]#

This method is used to define a three-dimensional AnalyticSurface of revolution on the instance.

Note

Check AnalyticRigidSurfRevolve on help.3ds.com/0.1..

Parameters:

name (str) – The name of the analytic surface.
profile (Tuple[AnalyticSurfaceSegment, ...]) – A sequence of AnalyticSurfaceSegment objects or an OdbSequenceAnalyticSurfaceSegment object.
filletRadius (str, default: 0) – A Double specifying the radius of curvature to smooth discontinuities between adjoining segments. The default value is 0.0.
localCoordData (tuple, default: ()) – A sequence of sequences of Floats specifying the global coordinates of points used to define the local coordinate system.

Raises:

OdbError –

:raises instance is` of :class:`type THREE_D: If OdbPart associated with the part instance is not of type THREE_D.

NodeSet(name, nodes)[source]#

This method creates a node set from an array of OdbMeshNode objects (for part instance-level sets) or from a sequence of arrays of OdbMeshNode objects (for assembly-level sets).

Note

This function can be accessed by:

session.odbs[name].parts[name].NodeSet
session.odbs[name].rootAssembly.instances[name].NodeSet
session.odbs[name].rootAssembly.NodeSet

Note

Check NodeSet on help.3ds.com/0.1..

Parameters:

name (str) – A String specifying the name of the set and the repository key.
nodes (Tuple[OdbMeshNode, ...]) – A sequence of OdbMeshNode objects. For example, for a part:nodes=part1.nodes[1:5]`For an assembly:`nodes=(instance1.nodes[6:7], instance2.nodes[1:5])

Returns:

An OdbSet object.

Return type:

OdbSet

RigidBody(referenceNode, position=abaqusConstants.INPUT, isothermal=OFF, elset='', pinNodes='', tieNodes='', analyticSurface='')[source]#

This method defines an OdbRigidBody on the instance.

Note

Parameters:

referenceNode (str) – An OdbSet specifying the reference node assigned to the rigid body.
position (str, default: INPUT) – 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 (Union[AbaqusBoolean, bool], default: OFF) – 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 (str, default: '') – An OdbSet specifying an element set assigned to the rigid body.
pinNodes (str, default: '') – An OdbSet specifying pin-type nodes assigned to the rigid body.
tieNodes (str, default: '') – An OdbSet specifying tie-type nodes assigned to the rigid body.
analyticSurface (str, default: '') – An AnalyticSurface specifying the Analytic Rigid Surface assigned to the rigid body.

Raises:

OdbError – If referenceNode is not a node set.

analyticSurface: AnalyticSurface = <abaqus.Odb.AnalyticSurface.AnalyticSurface object>[source]#: An AnalyticSurface object specifying analytic Surface defined on the instance.

assignBeamOrientation(region, method, vector)[source]#

This method assigns a beam section orientation to a region of a part instance.

Note

Check OdbInstanceBase.assignBeamOrientation on help.3ds.com/0.1..

Parameters:

region (str) – An OdbSet specifying a region on an instance.
method (SymbolicConstant) – A SymbolicConstant specifying the assignment method. Only a value of N1_COSINES is currently supported.
vector (tuple) – A sequence of three Floats specifying the approximate local n1n1-direction of the beam cross-section.

assignMaterialOrientation(region, localCsys, axis=abaqusConstants.AXIS_1, angle=0, stackDirection=abaqusConstants.STACK_3)[source]#

This method assigns a material orientation to a region of a part instance.

Note

Check OdbInstanceBase.assignMaterialOrientation on help.3ds.com/0.1..

Parameters:

region (str) – An OdbSet specifying a region on an instance.
localCsys (OdbDatumCsys) – An OdbDatumCsys object specifying the local coordinate system or None, indicating the global coordinate system.
axis (SymbolicConstant, default: AXIS_1) – 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 (float, default: 0) – A Float specifying the angle of the additional rotation. The default value is 0.0.
stackDirection (SymbolicConstant, default: STACK_3) – 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.

assignRebarOrientation(region, localCsys, axis=abaqusConstants.AXIS_1, angle=0)[source]#

This method assigns a rebar reference orientation to a region of a part instance.

Note

Check OdbInstanceBase.assignRebarOrientation on help.3ds.com/0.1..

Parameters:

region (str) – An OdbSet specifying a region on an instance.
localCsys (OdbDatumCsys) – An OdbDatumCsys object specifying the local coordinate system or None, indicating the global coordinate system.
axis (SymbolicConstant, default: AXIS_1) – 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 (float, default: 0) – A Float specifying the angle of the additional rotation. The default value is 0.0.

assignSection(region, section)[source]#

This method is used to assign a section to a region on an instance.

Note

Check OdbInstanceBase.assignSection on help.3ds.com/0.1..

Parameters:

region (str) – An OdbSet specifying a region on an instance.
section (Section) – A Section object.

Raises:

OdbError – If region is not an element set.
OdbError – If the element set is not from the current instance.

beamOrientations: BeamOrientationArray = [][source]#: A BeamOrientationArray object.

elementSets: Dict[str, OdbSet] = {}[source]#: A repository of OdbSet objects specifying element sets.

elements: OdbMeshElementArray = [][source]#: An OdbMeshElementArray object.

embeddedSpace: Optional[SymbolicConstant] = None[source]#: A SymbolicConstant specifying the dimensionality of the Part object. Possible values are THREE_D, TWO_D_PLANAR, AXISYMMETRIC, and UNKNOWN_DIMENSION.

getElementFromLabel(label)[source]#

This method is used to retrieved an element with a specific label from an instance object.

Note

Check OdbInstanceBase.getElementFromLabel on help.3ds.com/0.1..

Parameters:: label (int) – An Int specifying the element label.
Returns:: An OdbMeshElement object.
Return type:: OdbMeshElement
Raises:: OdbError – If no element with the specified label exists.

getNodeFromLabel(label)[source]#

This method is used to retrieved a node with a specific label from an instance object.

Note

Check OdbInstanceBase.getNodeFromLabel on help.3ds.com/0.1..

Parameters:: label (int) – An Int specifying the node label.
Returns:: An OdbMeshNode object.
Return type:: OdbMeshNode
Raises:: OdbError – If no node with the specified label exists.

materialOrientations: MaterialOrientationArray = [][source]#: A MaterialOrientationArray object.

name: str = ''[source]#: A String specifying the instance name.

nodeSets: Dict[str, OdbSet] = {}[source]#: A repository of OdbSet objects specifying node sets.

nodes: OdbMeshNodeArray = [][source]#: An OdbMeshNodeArray object.

rebarOrientations: RebarOrientationArray = [][source]#: A RebarOrientationArray object.

resultState: SymbolicConstant = PROPAGATED[source]#: 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.

rigidBodies: OdbRigidBodyArray = [][source]#: An OdbRigidBodyArray object.

sectionAssignments: SectionAssignmentArray = [][source]#: A SectionAssignmentArray object.

surfaces: Dict[str, OdbSet] = {}[source]#: A repository of OdbSet objects specifying surfaces.

type: Optional[SymbolicConstant] = None[source]#: A SymbolicConstant specifying the type of the Part object. Only a value of DEFORMABLE_BODY is currently supported.

OdbInstanceBase#

class OdbInstanceBase(name, object, localCoordSystem=())[source]#

A part instance is the usage of a part within an assembly.

Note

This object can be accessed by:

import odbAccess
session.odbs[name].rootAssembly.instances[name]
session.odbs[name].steps[name].frames[i].fieldOutputs[name].values[i].instance

Note

Check OdbInstanceBase on help.3ds.com/0.1..

Public Data Attributes:

`name`	A String specifying the instance name.
`type`	A SymbolicConstant specifying the type of the Part object.
`embeddedSpace`	A SymbolicConstant specifying the dimensionality of the Part object.
`resultState`	A SymbolicConstant specifying the state of the Instance as modified by the analysis.
`nodes`	An `OdbMeshNodeArray` object.
`elements`	An `OdbMeshElementArray` object.
`nodeSets`	A repository of OdbSet objects specifying node sets.
`elementSets`	A repository of OdbSet objects specifying element sets.
`surfaces`	A repository of OdbSet objects specifying surfaces.
`sectionAssignments`	A `SectionAssignmentArray` object.
`rigidBodies`	An `OdbRigidBodyArray` object.
`beamOrientations`	A `BeamOrientationArray` object.
`materialOrientations`	A `MaterialOrientationArray` object.
`rebarOrientations`	A `RebarOrientationArray` object.
`analyticSurface`	An `AnalyticSurface` object specifying analytic Surface defined on the instance.

Public Methods:

`__init__`(name, object[, localCoordSystem])	This method creates an OdbInstance object from an OdbPart object.
`assignBeamOrientation`(region, method, vector)	This method assigns a beam section orientation to a region of a part instance.
`assignMaterialOrientation`(region, localCsys)	This method assigns a material orientation to a region of a part instance.
`assignRebarOrientation`(region, localCsys[, ...])	This method assigns a rebar reference orientation to a region of a part instance.
`getElementFromLabel`(label)	This method is used to retrieved an element with a specific label from an instance object.
`getNodeFromLabel`(label)	This method is used to retrieved a node with a specific label from an instance object.
`assignSection`(region, section)	This method is used to assign a section to a region on an instance.
`AnalyticRigidSurf2DPlanar`(name, profile[, ...])	This method is used to define a two-dimensional AnalyticSurface object on the instance.
`AnalyticRigidSurfExtrude`(name, profile[, ...])	This method is used to define a three-dimensional cylindrical AnalyticSurface on the instance.
`AnalyticRigidSurfRevolve`(name, profile[, ...])	This method is used to define a three-dimensional AnalyticSurface of revolution on the instance.
`RigidBody`(referenceNode[, position, ...])	This method defines an OdbRigidBody on the instance.

AnalyticRigidSurf2DPlanar(name, profile, filletRadius=0)[source]#

This method is used to define a two-dimensional AnalyticSurface object on the instance.

Note

Check AnalyticRigidSurf2DPlanar on help.3ds.com/0.1..

Parameters:

name (str) – The name of the analytic surface.
profile (Tuple[AnalyticSurfaceSegment, ...]) – A sequence of AnalyticSurfaceSegment objects or an OdbSequenceAnalyticSurfaceSegment object.
filletRadius (str, default: 0) – A Double specifying the radius of curvature to smooth discontinuities between adjoining segments. The default value is 0.0.

Raises:

OdbError –

:raises type TWO_D_PLANAR` or :class:`AXISYMMETRIC.: If OdbPart associated with the part instance is of type THREE_D.

AnalyticRigidSurfExtrude(name, profile, filletRadius=0, localCoordData=())[source]#

This method is used to define a three-dimensional cylindrical AnalyticSurface on the instance.

Note

Check AnalyticRigidSurfExtrude on help.3ds.com/0.1..

Parameters:

name (str) – The name of the analytic surface.
profile (Tuple[AnalyticSurfaceSegment, ...]) – A sequence of AnalyticSurfaceSegment objects or an OdbSequenceAnalyticSurfaceSegment object.
filletRadius (str, default: 0) – A Double specifying the radius of curvature to smooth discontinuities between adjoining segments. The default value is 0.0.
localCoordData (tuple, default: ()) – A sequence of sequences of Floats specifying the global coordinates of points used to define the local coordinate system.

Raises:

OdbError –
of type THREE_D – If OdbPart associated with the part instance is not of type THREE_D.

AnalyticRigidSurfRevolve(name, profile, filletRadius=0, localCoordData=())[source]#

This method is used to define a three-dimensional AnalyticSurface of revolution on the instance.

Note

Check AnalyticRigidSurfRevolve on help.3ds.com/0.1..

Parameters:

name (str) – The name of the analytic surface.
profile (Tuple[AnalyticSurfaceSegment, ...]) – A sequence of AnalyticSurfaceSegment objects or an OdbSequenceAnalyticSurfaceSegment object.
filletRadius (str, default: 0) – A Double specifying the radius of curvature to smooth discontinuities between adjoining segments. The default value is 0.0.
localCoordData (tuple, default: ()) – A sequence of sequences of Floats specifying the global coordinates of points used to define the local coordinate system.

Raises:

OdbError –

:raises instance is` of :class:`type THREE_D: If OdbPart associated with the part instance is not of type THREE_D.

RigidBody(referenceNode, position=abaqusConstants.INPUT, isothermal=OFF, elset='', pinNodes='', tieNodes='', analyticSurface='')[source]#

This method defines an OdbRigidBody on the instance.

Note

Parameters:

referenceNode (str) – An OdbSet specifying the reference node assigned to the rigid body.
position (str, default: INPUT) – 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 (Union[AbaqusBoolean, bool], default: OFF) – 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 (str, default: '') – An OdbSet specifying an element set assigned to the rigid body.
pinNodes (str, default: '') – An OdbSet specifying pin-type nodes assigned to the rigid body.
tieNodes (str, default: '') – An OdbSet specifying tie-type nodes assigned to the rigid body.
analyticSurface (str, default: '') – An AnalyticSurface specifying the Analytic Rigid Surface assigned to the rigid body.

Raises:

OdbError – If referenceNode is not a node set.

analyticSurface: AnalyticSurface = <abaqus.Odb.AnalyticSurface.AnalyticSurface object>[source]#: An AnalyticSurface object specifying analytic Surface defined on the instance.

assignBeamOrientation(region, method, vector)[source]#

This method assigns a beam section orientation to a region of a part instance.

Note

Check OdbInstanceBase.assignBeamOrientation on help.3ds.com/0.1..

Parameters:

region (str) – An OdbSet specifying a region on an instance.
method (SymbolicConstant) – A SymbolicConstant specifying the assignment method. Only a value of N1_COSINES is currently supported.
vector (tuple) – A sequence of three Floats specifying the approximate local n1n1-direction of the beam cross-section.

assignMaterialOrientation(region, localCsys, axis=abaqusConstants.AXIS_1, angle=0, stackDirection=abaqusConstants.STACK_3)[source]#

This method assigns a material orientation to a region of a part instance.

Note

Check OdbInstanceBase.assignMaterialOrientation on help.3ds.com/0.1..

Parameters:

region (str) – An OdbSet specifying a region on an instance.
localCsys (OdbDatumCsys) – An OdbDatumCsys object specifying the local coordinate system or None, indicating the global coordinate system.
axis (SymbolicConstant, default: AXIS_1) – 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 (float, default: 0) – A Float specifying the angle of the additional rotation. The default value is 0.0.
stackDirection (SymbolicConstant, default: STACK_3) – 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.

assignRebarOrientation(region, localCsys, axis=abaqusConstants.AXIS_1, angle=0)[source]#

This method assigns a rebar reference orientation to a region of a part instance.

Note

Check OdbInstanceBase.assignRebarOrientation on help.3ds.com/0.1..

Parameters:

region (str) – An OdbSet specifying a region on an instance.
localCsys (OdbDatumCsys) – An OdbDatumCsys object specifying the local coordinate system or None, indicating the global coordinate system.
axis (SymbolicConstant, default: AXIS_1) – 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 (float, default: 0) – A Float specifying the angle of the additional rotation. The default value is 0.0.

assignSection(region, section)[source]#

This method is used to assign a section to a region on an instance.

Note

Check OdbInstanceBase.assignSection on help.3ds.com/0.1..

Parameters:

region (str) – An OdbSet specifying a region on an instance.
section (Section) – A Section object.

Raises:

OdbError – If region is not an element set.
OdbError – If the element set is not from the current instance.

beamOrientations: List[BeamOrientation] = [][source]#: A BeamOrientationArray object.

elementSets: Dict[str, OdbSet] = {}[source]#: A repository of OdbSet objects specifying element sets.

elements: List[OdbMeshElement] = [][source]#: An OdbMeshElementArray object.

embeddedSpace: Optional[SymbolicConstant] = None[source]#: A SymbolicConstant specifying the dimensionality of the Part object. Possible values are THREE_D, TWO_D_PLANAR, AXISYMMETRIC, and UNKNOWN_DIMENSION.

getElementFromLabel(label)[source]#

This method is used to retrieved an element with a specific label from an instance object.

Note

Check OdbInstanceBase.getElementFromLabel on help.3ds.com/0.1..

Parameters:: label (int) – An Int specifying the element label.
Returns:: An OdbMeshElement object.
Return type:: OdbMeshElement
Raises:: OdbError – If no element with the specified label exists.

getNodeFromLabel(label)[source]#

This method is used to retrieved a node with a specific label from an instance object.

Note

Check OdbInstanceBase.getNodeFromLabel on help.3ds.com/0.1..

Parameters:: label (int) – An Int specifying the node label.
Returns:: An OdbMeshNode object.
Return type:: OdbMeshNode
Raises:: OdbError – If no node with the specified label exists.

materialOrientations: List[MaterialOrientation] = [][source]#: A MaterialOrientationArray object.

name: str = ''[source]#: A String specifying the instance name.

nodeSets: Dict[str, OdbSet] = {}[source]#: A repository of OdbSet objects specifying node sets.

nodes: List[OdbMeshNode] = [][source]#: An OdbMeshNodeArray object.

rebarOrientations: List[RebarOrientation] = [][source]#: A RebarOrientationArray object.

resultState: SymbolicConstant = PROPAGATED[source]#: 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.

rigidBodies: List[OdbRigidBody] = [][source]#: An OdbRigidBodyArray object.

sectionAssignments: List[SectionAssignment] = [][source]#: A SectionAssignmentArray object.

surfaces: Dict[str, OdbSet] = {}[source]#: A repository of OdbSet objects specifying surfaces.

type: Optional[SymbolicConstant] = None[source]#: A SymbolicConstant specifying the type of the Part object. Only a value of DEFORMABLE_BODY is currently supported.

OdbLoadCase#

class OdbLoadCase(name)[source]#

The OdbLoadCase object describes a load case.

Note

This object can be accessed by:

import odbAccess
session.odbs[name].steps[name].frames[i].loadCase
session.odbs[name].steps[name].historyRegions[name].loadCase
session.odbs[name].steps[name].loadCases[name]

Note

Check OdbLoadCase on help.3ds.com/0.1..

Public Methods:

__init__(name)

This method creates an OdbLoadCase object.

name: str[source]#: A String specifying the name of the OdbLoadCase object.

OdbMeshElement#

class OdbMeshElement[source]#

OdbMeshElement objects are created with the part.addElements or rootAssembly.addElements methods.

Note

This object can be accessed by:

import odbAccess
session.odbs[name].parts[name].elements[i]
session.odbs[name].parts[name].elementSets[name].elements[i]
session.odbs[name].parts[name].nodeSets[name].elements[i]
session.odbs[name].parts[name].surfaces[name].elements[i]
session.odbs[name].rootAssembly.elements[i]
session.odbs[name].rootAssembly.elementSets[name].elements[i]
session.odbs[name].rootAssembly.instances[name].elements[i]
session.odbs[name].rootAssembly.instances[name].elementSets[name].elements[i]
session.odbs[name].rootAssembly.instances[name].nodeSets[name].elements[i]
session.odbs[name].rootAssembly.instances[name].surfaces[name].elements[i]
session.odbs[name].rootAssembly.nodeSets[name].elements[i]
session.odbs[name].rootAssembly.surfaces[name].elements[i]
session.odbs[name].steps[name].frames[i].fieldOutputs[name].values[i].instance.elements[i]
session.odbs[name].steps[name].frames[i].fieldOutputs[name].values[i].instance.elementSets[name].elements[i]
session.odbs[name].steps[name].frames[i].fieldOutputs[name].values[i].instance.nodeSets[name].elements[i]
session.odbs[name].steps[name].frames[i].fieldOutputs[name].values[i].instance.surfaces[name].elements[i]

Note

Check OdbMeshElement on help.3ds.com/0.1..

Public Data Attributes:

`label`	An Int specifying the element label.
`type`	A String specifying the element type.
`sectionCategory`	A `SectionCategory` object specifying the element section properties.
`connectivity`	A tuple of Ints specifying the element connectivity.
`instanceNames`	A tuple of Strings specifying the instance names for nodes in the element connectivity.
`instanceName`	A String specifying the instance name.

Public Methods:

getNormal(faceIndex[, stepName, frameValue, ...])

This method returns the normal direction for the element face.

connectivity: Optional[int] = None[source]#: A tuple of Ints specifying the element connectivity. For connector elements connected to ground, the other node is repeated in the connectivity data. The position of the ground node cannot be ascertained. This is a limitation. It is important to note the difference with MeshElement object of MDB where the connectivity is node indices instead of node labels.

getNormal(faceIndex, stepName='', frameValue='', match=abaqusConstants.CLOSEST)[source]#

This method returns the normal direction for the element face.

New in version 2017: The getNormal method was added.

Note

Check OdbMeshElement.getNormal on help.3ds.com/0.1..

Parameters:

faceIndex (str) – The value of faceIndex is 0 for a shell element and can range from 0 to 5 for a solid element.
stepName (str, default: '') – Name of the step.
frameValue (str, default: '') – A Double specifying the value at which the frame is required. frameValue can be the total fime or frequency.
match (SymbolicConstant, default: CLOSEST) – 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.

Returns:

A tuple of 3 floats representing the unit normal vector. If the element face is
collapsed such that a normal cannot be computed, a zero-length vector is returned.

Raises:

OdbError – If the exact frame is not found.
OdbError – If the step name is not found.
OdbError – If frameValue is not provided and stepName is empty.

instanceName: str = ''[source]#: A String specifying the instance name.

instanceNames: tuple = ()[source]#: A tuple of Strings specifying the instance names for nodes in the element connectivity.

label: Optional[int] = None[source]#: An Int specifying the element label.

sectionCategory: Optional[SectionCategory] = None[source]#: A SectionCategory object specifying the element section properties.

type: str = ''[source]#: A String specifying the element type.

OdbMeshElementArray#

OdbMeshElementArray[source]#: alias of List[OdbMeshElement]

OdbMeshNode#

class OdbMeshNode[source]#

OdbMeshNode objects are created with the part.addNodes method.

Note

This object can be accessed by:

import odbAccess
session.odbs[name].parts[name].nodes[i]
session.odbs[name].parts[name].nodeSets[name].nodes[i]
session.odbs[name].parts[name].surfaces[name].nodes[i]
session.odbs[name].rootAssembly.instances[name].nodes[i]
session.odbs[name].rootAssembly.instances[name].nodeSets[name].nodes[i]
session.odbs[name].rootAssembly.instances[name].surfaces[name].nodes[i]
session.odbs[name].rootAssembly.nodes[i]
session.odbs[name].rootAssembly.nodeSets[name].nodes[i]
session.odbs[name].rootAssembly.surfaces[name].nodes[i]
session.odbs[name].steps[name].frames[i].fieldOutputs[name].values[i].instance.nodes[i]
session.odbs[name].steps[name].frames[i].fieldOutputs[name].values[i].instance.nodeSets[name].nodes[i]
session.odbs[name].steps[name].frames[i].fieldOutputs[name].values[i].instance.surfaces[name].nodes[i]

Note

Check OdbMeshNode on help.3ds.com/0.1..

Public Data Attributes:

`label`	An Int specifying the node label.
`coordinates`	A tuple of Floats specifying the nodal coordinates in the global Cartesian coordinate system.

coordinates: Optional[float] = None[source]#: A tuple of Floats specifying the nodal coordinates in the global Cartesian coordinate system.

label: Optional[int] = None[source]#: An Int specifying the node label.

OdbMeshNodeArray#

OdbMeshNodeArray[source]#: alias of List[OdbMeshNode]

OdbPart#

class OdbPart(name, embeddedSpace, type)[source]#

Public Data Attributes:

Inherited from OdbPartBase

`nodes`	An `OdbMeshNodeArray` object.
`elements`	An `OdbMeshElementArray` object.
`nodeSets`	A repository of OdbSet objects specifying node sets.
`elementSets`	A repository of OdbSet objects specifying element sets.
`surfaces`	A repository of OdbSet objects specifying surfaces.
`sectionAssignments`	A `SectionAssignmentArray` object.
`beamOrientations`	A `BeamOrientationArray` object.
`materialOrientations`	A `MaterialOrientationArray` object.
`rebarOrientations`	A `RebarOrientationArray` object.
`rigidBodies`	An `OdbRigidBodyArray` object.
`analyticSurface`	An `AnalyticSurface` object specifying analytic Surface defined on the instance.

Public Methods:

`RigidBody`(referenceNode[, position, ...])	This method defines an OdbRigidBody on the part object.
`NodeSet`(name, nodes)	This method creates a node set from an array of OdbMeshNode objects (for part instance-level sets) or from a sequence of arrays of OdbMeshNode objects (for assembly-level sets).

Inherited from OdbPartBase

`__init__`(name, embeddedSpace, type)	This method creates an OdbPart object.
`addElements`(args, *kwargs)
`addNodes`(args, *kwargs)
`assignBeamOrientation`(region, method, vector)	This method assigns a beam section orientation to a region of a part instance.
`assignMaterialOrientation`(region, localCSys)	This method assigns a material orientation to a region of a part instance.
`assignRebarOrientation`(region, localCsys[, ...])	This method assigns a rebar reference orientation to a region of a part instance.
`getElementFromLabel`(label)	This method is used to retrieved an element with a specific label from a part object.
`getNodeFromLabel`(label)	This method is used to retrieved a node with a specific label from a part object.
`AnalyticRigidSurf2DPlanar`(name, profile[, ...])	This method is used to define a two-dimensional AnalyticSurface object on the part object.
`AnalyticRigidSurfExtrude`(name, profile[, ...])	This method is used to define a three-dimensional cylindrical AnalyticSurface on the part object.
`AnalyticRigidSurfRevolve`(name, profile[, ...])	This method is used to define a three-dimensional AnalyticSurface of revolution on the part object.

AnalyticRigidSurf2DPlanar(name, profile, filletRadius=0)[source]#

This method is used to define a two-dimensional AnalyticSurface object on the part object.

Note

Check AnalyticRigidSurf2DPlanar on help.3ds.com/0.1..

Parameters:

name (str) – The name of the analytic surface.
profile (Tuple[AnalyticSurfaceSegment, ...]) – A sequence of AnalyticSurfaceSegment objects or an OdbSequenceAnalyticSurfaceSegment object.
filletRadius (str, default: 0) – A Double specifying the radius of curvature to smooth discontinuities between adjoining segments. The default value is 0.0.

Raises:

OdbError –
TWO_D_PLANAR – If OdbPart is of type THREE_D.

AnalyticRigidSurfExtrude(name, profile, filletRadius=0)[source]#

This method is used to define a three-dimensional cylindrical AnalyticSurface on the part object.

Note

Check AnalyticRigidSurfExtrude on help.3ds.com/0.1..

Parameters:

name (str) – The name of the analytic surface.
profile (Tuple[AnalyticSurfaceSegment, ...]) – A sequence of AnalyticSurfaceSegment objects or an OdbSequenceAnalyticSurfaceSegment object.
filletRadius (str, default: 0) – A Double specifying the radius of curvature to smooth discontinuities between adjoining segments. The default value is 0.0.

Raises:

OdbError –
of type THREE_D – If OdbPart is not of type THREE_D.

AnalyticRigidSurfRevolve(name, profile, filletRadius=0)[source]#

This method is used to define a three-dimensional AnalyticSurface of revolution on the part object.

Note

Check AnalyticRigidSurfRevolve on help.3ds.com/0.1..

Parameters:

name (str) – The name of the analytic surface.
profile (Tuple[AnalyticSurfaceSegment, ...]) – A sequence of AnalyticSurfaceSegment objects or an OdbSequenceAnalyticSurfaceSegment object.
filletRadius (str, default: 0) – A Double specifying the radius of curvature to smooth discontinuities between adjoining segments. The default value is 0.0.

Raises:

OdbError –
of type THREE_D – If OdbPart is not of type THREE_D.

NodeSet(name, nodes)[source]#

This method creates a node set from an array of OdbMeshNode objects (for part instance-level sets) or from a sequence of arrays of OdbMeshNode objects (for assembly-level sets).

Note

This function can be accessed by:

session.odbs[name].parts[name].NodeSet
session.odbs[name].rootAssembly.instances[name].NodeSet
session.odbs[name].rootAssembly.NodeSet

Note

Check NodeSet on help.3ds.com/0.1..

Parameters:

name (str) – A String specifying the name of the set and the repository key.
nodes (Tuple[OdbMeshNode, ...]) – A sequence of OdbMeshNode objects. For example, for a part:nodes=part1.nodes[1:5]`For an assembly:`nodes=(instance1.nodes[6:7], instance2.nodes[1:5])

Returns:

An OdbSet object.

Return type:

OdbSet

RigidBody(referenceNode, position=abaqusConstants.INPUT, isothermal=OFF, elset='', pinNodes='', tieNodes='', analyticSurface='')[source]#

This method defines an OdbRigidBody on the part object.

Note

Parameters:

referenceNode (str) – An OdbSet specifying the reference node assigned to the rigid body.
position (str, default: INPUT) – 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 (Union[AbaqusBoolean, bool], default: OFF) – 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 (str, default: '') – An OdbSet specifying an element set assigned to the rigid body.
pinNodes (str, default: '') – An OdbSet specifying pin-type nodes assigned to the rigid body.
tieNodes (str, default: '') – An OdbSet specifying tie-type nodes assigned to the rigid body.
analyticSurface (str, default: '') – An AnalyticSurface specifying the Analytic Rigid Surface assigned to the rigid body.

Return type:

None.

Raises:

OdbError – If referenceNode is not a node set.

addElements(*args, **kwargs)[source]#

addNodes(*args, **kwargs)[source]#

analyticSurface: AnalyticSurface = <abaqus.Odb.AnalyticSurface.AnalyticSurface object>[source]#: An AnalyticSurface object specifying analytic Surface defined on the instance.

assignBeamOrientation(region, method, vector)[source]#

This method assigns a beam section orientation to a region of a part instance.

Parameters:

region (str) – An OdbSet specifying a region on an instance.
method (SymbolicConstant) – A SymbolicConstant specifying the assignment method. Only a value of N1_COSINES is currently supported.
vector (tuple) – A sequence of three Floats specifying the approximate local n1n1 -direction of the beam cross-section.

assignMaterialOrientation(region, localCSys, axis=abaqusConstants.AXIS_1, angle=0, stackDirection=abaqusConstants.STACK_3)[source]#

This method assigns a material orientation to a region of a part instance.

Note

Check OdbPartBase.assignMaterialOrientation on help.3ds.com/0.1..

Parameters:

region (str) – An OdbSet specifying a region on an instance.
localCSys (OdbDatumCsys) – An OdbDatumCsys object specifying the local coordinate system or None, indicating the global coordinate system.
axis (SymbolicConstant, default: AXIS_1) – 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 (float, default: 0) – A Float specifying the angle of the additional rotation. The default value is 0.0.
stackDirection (SymbolicConstant, default: STACK_3) – 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.

assignRebarOrientation(region, localCsys, axis=abaqusConstants.AXIS_1, angle=0)[source]#

This method assigns a rebar reference orientation to a region of a part instance.

Note

Check OdbPartBase.assignRebarOrientation on help.3ds.com/0.1..

Parameters:

region (str) – An OdbSet specifying a region on an instance.
localCsys (OdbDatumCsys) – An OdbDatumCsys object specifying the local coordinate system or None, indicating the global coordinate system.
axis (SymbolicConstant, default: AXIS_1) – 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 (float, default: 0) – A Float specifying the angle of the additional rotation. The default value is 0.0.

beamOrientations: BeamOrientationArray = [][source]#: A BeamOrientationArray object.

elementSets: Dict[str, OdbSet] = {}[source]#: A repository of OdbSet objects specifying element sets.

elements: OdbMeshElementArray = [][source]#: An OdbMeshElementArray object.

getElementFromLabel(label)[source]#

This method is used to retrieved an element with a specific label from a part object.

Note

Check OdbPartBase.getElementFromLabel on help.3ds.com/0.1..

Parameters:: label (int) – An Int specifying the element label.
Returns:: An OdbMeshElement object.
Return type:: OdbMeshElement
Raises:: OdbError – If no element with the specified label exists.

getNodeFromLabel(label)[source]#

This method is used to retrieved a node with a specific label from a part object.

Note

Check OdbPartBase.getNodeFromLabel on help.3ds.com/0.1..

Parameters:: label (int) – An Int specifying the node label.
Returns:: An OdbMeshNode object.
Return type:: OdbMeshNode
Raises:: OdbError – If no node with the specified label exists.

materialOrientations: MaterialOrientationArray = [][source]#: A MaterialOrientationArray object.

nodeSets: Dict[str, OdbSet] = {}[source]#: A repository of OdbSet objects specifying node sets.

nodes: OdbMeshNodeArray = [][source]#: An OdbMeshNodeArray object.

rebarOrientations: RebarOrientationArray = [][source]#: A RebarOrientationArray object.

rigidBodies: OdbRigidBodyArray = [][source]#: An OdbRigidBodyArray object.

sectionAssignments: SectionAssignmentArray = [][source]#: A SectionAssignmentArray object.

surfaces: Dict[str, OdbSet] = {}[source]#: A repository of OdbSet objects specifying surfaces.

OdbPartBase#

class OdbPartBase(name, embeddedSpace, type)[source]#

The OdbPart object is similar to the kernel Part object and contains nodes and elements, but not geometry.

Note

This object can be accessed by:

import odbAccess
session.odbs[name].parts[name]

Note

Check OdbPartBase on help.3ds.com/0.1..

Public Data Attributes:

`nodes`	An `OdbMeshNodeArray` object.
`elements`	An `OdbMeshElementArray` object.
`nodeSets`	A repository of OdbSet objects specifying node sets.
`elementSets`	A repository of OdbSet objects specifying element sets.
`surfaces`	A repository of OdbSet objects specifying surfaces.
`sectionAssignments`	A `SectionAssignmentArray` object.
`beamOrientations`	A `BeamOrientationArray` object.
`materialOrientations`	A `MaterialOrientationArray` object.
`rebarOrientations`	A `RebarOrientationArray` object.
`rigidBodies`	An `OdbRigidBodyArray` object.
`analyticSurface`	An `AnalyticSurface` object specifying analytic Surface defined on the instance.

Public Methods:

`__init__`(name, embeddedSpace, type)	This method creates an OdbPart object.
`addElements`()
`addNodes`()
`assignBeamOrientation`(region, method, vector)	This method assigns a beam section orientation to a region of a part instance.
`assignMaterialOrientation`(region, localCSys)	This method assigns a material orientation to a region of a part instance.
`assignRebarOrientation`(region, localCsys[, ...])	This method assigns a rebar reference orientation to a region of a part instance.
`getElementFromLabel`(label)	This method is used to retrieved an element with a specific label from a part object.
`getNodeFromLabel`(label)	This method is used to retrieved a node with a specific label from a part object.
`AnalyticRigidSurf2DPlanar`(name, profile[, ...])	This method is used to define a two-dimensional AnalyticSurface object on the part object.
`AnalyticRigidSurfExtrude`(name, profile[, ...])	This method is used to define a three-dimensional cylindrical AnalyticSurface on the part object.
`AnalyticRigidSurfRevolve`(name, profile[, ...])	This method is used to define a three-dimensional AnalyticSurface of revolution on the part object.

AnalyticRigidSurf2DPlanar(name, profile, filletRadius=0)[source]#

This method is used to define a two-dimensional AnalyticSurface object on the part object.

Note

Check AnalyticRigidSurf2DPlanar on help.3ds.com/0.1..

Parameters:

name (str) – The name of the analytic surface.
profile (Tuple[AnalyticSurfaceSegment, ...]) – A sequence of AnalyticSurfaceSegment objects or an OdbSequenceAnalyticSurfaceSegment object.
filletRadius (str, default: 0) – A Double specifying the radius of curvature to smooth discontinuities between adjoining segments. The default value is 0.0.

Raises:

OdbError –
TWO_D_PLANAR – If OdbPart is of type THREE_D.

AnalyticRigidSurfExtrude(name, profile, filletRadius=0)[source]#

This method is used to define a three-dimensional cylindrical AnalyticSurface on the part object.

Note

Check AnalyticRigidSurfExtrude on help.3ds.com/0.1..

Parameters:

name (str) – The name of the analytic surface.
profile (Tuple[AnalyticSurfaceSegment, ...]) – A sequence of AnalyticSurfaceSegment objects or an OdbSequenceAnalyticSurfaceSegment object.
filletRadius (str, default: 0) – A Double specifying the radius of curvature to smooth discontinuities between adjoining segments. The default value is 0.0.

Raises:

OdbError –
of type THREE_D – If OdbPart is not of type THREE_D.

AnalyticRigidSurfRevolve(name, profile, filletRadius=0)[source]#

This method is used to define a three-dimensional AnalyticSurface of revolution on the part object.

Note

Check AnalyticRigidSurfRevolve on help.3ds.com/0.1..

Parameters:

name (str) – The name of the analytic surface.
profile (Tuple[AnalyticSurfaceSegment, ...]) – A sequence of AnalyticSurfaceSegment objects or an OdbSequenceAnalyticSurfaceSegment object.
filletRadius (str, default: 0) – A Double specifying the radius of curvature to smooth discontinuities between adjoining segments. The default value is 0.0.

Raises:

OdbError –
of type THREE_D – If OdbPart is not of type THREE_D.

addElements(labels: tuple, connectivity: tuple, type: str, elementSetName: str = '', sectionCategory: Optional[SectionCategory] = None)[source]#
addElements(elementData: tuple, type: str, elementSetName: Optional[str] = None, sectionCategory: Optional[SectionCategory] = None)

addNodes(labels: tuple, coordinates: tuple, nodeSetName: Optional[str] = None)[source]#
addNodes(nodeData: tuple, nodeSetName: Optional[str] = None)

analyticSurface: AnalyticSurface = <abaqus.Odb.AnalyticSurface.AnalyticSurface object>[source]#: An AnalyticSurface object specifying analytic Surface defined on the instance.

assignBeamOrientation(region, method, vector)[source]#

This method assigns a beam section orientation to a region of a part instance.

Parameters:

region (str) – An OdbSet specifying a region on an instance.
method (SymbolicConstant) – A SymbolicConstant specifying the assignment method. Only a value of N1_COSINES is currently supported.
vector (tuple) – A sequence of three Floats specifying the approximate local n1n1 -direction of the beam cross-section.

assignMaterialOrientation(region, localCSys, axis=abaqusConstants.AXIS_1, angle=0, stackDirection=abaqusConstants.STACK_3)[source]#

This method assigns a material orientation to a region of a part instance.

Note

Check OdbPartBase.assignMaterialOrientation on help.3ds.com/0.1..

Parameters:

region (str) – An OdbSet specifying a region on an instance.
localCSys (OdbDatumCsys) – An OdbDatumCsys object specifying the local coordinate system or None, indicating the global coordinate system.
axis (SymbolicConstant, default: AXIS_1) – 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 (float, default: 0) – A Float specifying the angle of the additional rotation. The default value is 0.0.
stackDirection (SymbolicConstant, default: STACK_3) – 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.

assignRebarOrientation(region, localCsys, axis=abaqusConstants.AXIS_1, angle=0)[source]#

This method assigns a rebar reference orientation to a region of a part instance.

Note

Check OdbPartBase.assignRebarOrientation on help.3ds.com/0.1..

Parameters:

region (str) – An OdbSet specifying a region on an instance.
localCsys (OdbDatumCsys) – An OdbDatumCsys object specifying the local coordinate system or None, indicating the global coordinate system.
axis (SymbolicConstant, default: AXIS_1) – 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 (float, default: 0) – A Float specifying the angle of the additional rotation. The default value is 0.0.

beamOrientations: List[BeamOrientation] = [][source]#: A BeamOrientationArray object.

elementSets: Dict[str, OdbSet] = {}[source]#: A repository of OdbSet objects specifying element sets.

elements: List[OdbMeshElement] = [][source]#: An OdbMeshElementArray object.

getElementFromLabel(label)[source]#

This method is used to retrieved an element with a specific label from a part object.

Note

Check OdbPartBase.getElementFromLabel on help.3ds.com/0.1..

Parameters:: label (int) – An Int specifying the element label.
Returns:: An OdbMeshElement object.
Return type:: OdbMeshElement
Raises:: OdbError – If no element with the specified label exists.

getNodeFromLabel(label)[source]#

This method is used to retrieved a node with a specific label from a part object.

Note

Check OdbPartBase.getNodeFromLabel on help.3ds.com/0.1..

Parameters:: label (int) – An Int specifying the node label.
Returns:: An OdbMeshNode object.
Return type:: OdbMeshNode
Raises:: OdbError – If no node with the specified label exists.

materialOrientations: List[MaterialOrientation] = [][source]#: A MaterialOrientationArray object.

nodeSets: Dict[str, OdbSet] = {}[source]#: A repository of OdbSet objects specifying node sets.

nodes: List[OdbMeshNode] = [][source]#: An OdbMeshNodeArray object.

rebarOrientations: List[RebarOrientation] = [][source]#: A RebarOrientationArray object.

rigidBodies: List[OdbRigidBody] = [][source]#: An OdbRigidBodyArray object.

sectionAssignments: List[SectionAssignment] = [][source]#: A SectionAssignmentArray object.

surfaces: Dict[str, OdbSet] = {}[source]#: A repository of OdbSet objects specifying surfaces.

OdbPretensionSection#

class OdbPretensionSection[source]#

The pretension section object is used to define an assembly load. It associates a pretension node with a pretension section.

Note

This object can be accessed by:

import odbAccess
session.odbs[name].rootAssembly.pretensionSections[i]

Note

Check OdbPretensionSection on help.3ds.com/0.1..

Public Data Attributes:

`node`	An `OdbSet` object specifying the node set containing the pretension node.
`element`	An `OdbSet` object specifying the element set that defines the pretension section.
`surface`	An `OdbSet` object specifying the surface set that defines the pretension section.
`normal`	A tuple of Floats specifying the components of the normal to the pretension section.

element: OdbSet = <abaqus.Odb.OdbSet.OdbSet object>[source]#: An OdbSet object specifying the element set that defines the pretension section.

node: OdbSet = <abaqus.Odb.OdbSet.OdbSet object>[source]#: An OdbSet object specifying the node set containing the pretension node.

normal: Optional[float] = None[source]#: A tuple of Floats specifying the components of the normal to the pretension section.

surface: OdbSet = <abaqus.Odb.OdbSet.OdbSet object>[source]#: An OdbSet object specifying the surface set that defines the pretension section.

OdbPretensionSectionArray#

OdbPretensionSectionArray[source]#: alias of List[OdbPretensionSection]

OdbRigidBody#

class OdbRigidBody(referenceNode, position=abaqusConstants.INPUT, isothermal=ON, elements=<abaqus.Odb.OdbSet.OdbSet object>, tieNodes=<abaqus.Odb.OdbSet.OdbSet object>, pinNodes=<abaqus.Odb.OdbSet.OdbSet object>, analyticSurface=None)[source]#

The Rigid body object is used to bind a set of elements and/or a set of nodes and/or an analytical surface with a reference node.

Note

This object can be accessed by:

import odbAccess
session.odbs[name].parts[name].rigidBodies[i]
session.odbs[name].rootAssembly.instances[name].rigidBodies[i]
session.odbs[name].rootAssembly.rigidBodies[i]
session.odbs[name].steps[name].frames[i].fieldOutputs[name].values[i].instance.rigidBodies[i]

Note

Check OdbRigidBody on help.3ds.com/0.1..

Public Data Attributes:

`position`	A SymbolicConstant specifying the specific location of the OdbRigidBody reference node relative to the rest of the rigid body.
`isothermal`	A Boolean specifying specify whether the OdbRigidBody can have temperature gradients or be isothermal.
`elements`	An `OdbSet` object specifying the element set whose motion is governed by the motion of rigid body reference node.
`tieNodes`	An `OdbSet` object specifying the node set which have both translational and rotational degrees of freedom associated with the rigid body.
`pinNodes`	An `OdbSet` object specifying the node set which have only translational degrees of freedom associated with the rigid body.
`analyticSurface`	An `AnalyticSurface` object specifying the analytic surface whose motion is governed by the motion of rigid body reference node.

Public Methods:

__init__(referenceNode[, position, ...])

This method creates a OdbRigidBody object.

analyticSurface: Optional[AnalyticSurface] = None[source]#: An AnalyticSurface object specifying the analytic surface whose motion is governed by the motion of rigid body reference node.

elements: OdbSet = <abaqus.Odb.OdbSet.OdbSet object>[source]#: An OdbSet object specifying the element set whose motion is governed by the motion of rigid body reference node.

isothermal: Union[AbaqusBoolean, bool] = ON[source]#: A Boolean specifying specify whether the OdbRigidBody can have temperature gradients or be isothermal. This is used only for fully coupled thermal-stress analysis The default value is ON.

pinNodes: OdbSet = <abaqus.Odb.OdbSet.OdbSet object>[source]#: An OdbSet object specifying the node set which have only translational degrees of freedom associated with the rigid body.

position: SymbolicConstant = INPUT[source]#: A SymbolicConstant specifying the specific location of the OdbRigidBody reference node relative to the rest of the rigid body. Possible values are INPUT and CENTER_OF_MASS. The default value is INPUT.

referenceNode: OdbSet[source]#: An OdbSet object specifying the reference node set associated with the rigid body.

tieNodes: OdbSet = <abaqus.Odb.OdbSet.OdbSet object>[source]#: An OdbSet object specifying the node set which have both translational and rotational degrees of freedom associated with the rigid body.

OdbRigidBodyArray#

OdbRigidBodyArray[source]#: alias of List[OdbRigidBody]

OdbSequenceAnalyticSurfaceSegment#

class OdbSequenceAnalyticSurfaceSegment[source]#

A sequence of AnalyticSurfaceSegment describing an analytic surface profile.

Note

This object can be accessed by:

import odbAccess
session.odbs[name].parts[name].analyticSurface.segments
session.odbs[name].rootAssembly.instances[name].analyticSurface.segments
session.odbs[name].steps[name].frames[i].fieldOutputs[name].values[i].instance.analyticSurface.segments

Note

Check OdbSequenceAnalyticSurfaceSegment on help.3ds.com/0.1..

Public Methods:

`__init__`()	This method creates a OdbSequenceAnalyticSurfaceSegment object.
`Start`(origin)	This method adds a AnalyticSurfaceSegment describing the first segment of the surface profile.
`Line`(endPoint)	This method adds a AnalyticSurfaceSegment describing the line segment of the surface profile.
`Circle`(center, endPoint)	This method adds a AnalyticSurfaceSegment describing a circular segment of the surface profile.
`Parabola`(middlePoint, endPoint)	This method adds a AnalyticSurfaceSegment describing a parabolic segment of the surface profile.

Circle(center, endPoint)[source]#

This method adds a AnalyticSurfaceSegment describing a circular segment of the surface profile.

Note

Check Circle on help.3ds.com/0.1..

Parameters:

center (tuple) – A sequence of Floats specifying the coordinates of center of the circular segment.
endPoint (tuple) – A sequence of Floats specifying the coordinates of end point of the circular segment.

Line(endPoint)[source]#

This method adds a AnalyticSurfaceSegment describing the line segment of the surface profile.

Note

Check Line on help.3ds.com/0.1..

Parameters:: endPoint (tuple) – A sequence of Floats specifying the coordinates of end point.

Parabola(middlePoint, endPoint)[source]#

This method adds a AnalyticSurfaceSegment describing a parabolic segment of the surface profile.

Note

Check Parabola on help.3ds.com/0.1..

Parameters:

middlePoint (tuple) – A sequence of Floats specifying the coordinates of middle point of the parabolic segment.
endPoint (tuple) – A sequence of Floats specifying the coordinates of end point of the parabolic segment.

Start(origin)[source]#

This method adds a AnalyticSurfaceSegment describing the first segment of the surface profile.

Note

Check Start on help.3ds.com/0.1..

Parameters:: origin (tuple) – A sequence of Floats specifying the coordinates of start point.

OdbSession#

class OdbSession[source]#

Public Data Attributes:

Inherited from SessionBase

`attachedToGui`	A Boolean specifying whether an Abaqus interactive session is running.
`replayInProgress`	A Boolean specifying whether Abaqus is executing a replay file.
`kernelMemoryFootprint`	A Float specifying the memory usage value for the Abaqus/CAE kernel process in megabytes.
`kernelMemoryMaxFootprint`	A Float specifying the maximum value for the memory usage for the Abaqus/CAE kernel process in megabytes.
`kernelMemoryLimit`	A Float specifying the limit for the memory use for the Abaqus/CAE kernel process in megabytes.
`colors`	A repository of Color objects.
`journalOptions`	A `JournalOptions` object specifying how to record selection of geometry in the journal and replay files.
`memoryReductionOptions`	A `MemoryReductionOptions` object specifying options for running in reduced memory mode.
`nodeQuery`	A `NodeQuery` object specifying nodes and their coordinates in a path.
`sketcherOptions`	A `ConstrainedSketcherOptions` object specifying common options for all sketches.
`viewerOptions`	A `ViewerOptions` object.
`animationOptions`	An `AnimationOptions` object.
`aviOptions`	An `AVIOptions` object.
`imageAnimationOptions`	An `ImageAnimationOptions` object.
`imageAnimation`	An `ImageAnimation` object.
`quickTimeOptions`	A `QuickTimeOptions` object.
`viewports`	A repository of Viewport objects.
`customData`	A `RepositorySupport` object.
`defaultFieldReportOptions`	A `FieldReportOptions` object.
`defaultFreeBodyReportOptions`	A `FreeBodyReportOptions` object.
`fieldReportOptions`	A `FieldReportOptions` object.
`freeBodyReportOptions`	A `FreeBodyReportOptions` object.
`odbs`	A repository of Odb objects.
`scratchOdbs`	A repository of ScratchOdb objects.
`defaultOdbDisplay`	A `DefaultOdbDisplay` object.
`defaultPlot`	A `DefaultPlot` object.
`defaultChartOptions`	A `DefaultChartOptions` object.
`odbData`	A repository of OdbData objects.
`mdbData`	A repository of MdbData objects.
`paths`	A repository of Path objects.
`freeBodies`	A repository of FreeBody objects.
`streams`	A repository of Stream objects.
`spectrums`	A repository of Spectrum objects.
`currentProbeValues`	A `CurrentProbeValues` object.
`defaultProbeOptions`	A `ProbeOptions` object.
`probeOptions`	A `ProbeOptions` object.
`probeReport`	A `ProbeReport` object.
`defaultProbeReport`	A `ProbeReport` object.
`selectedProbeValues`	A `SelectedProbeValues` object.
`printOptions`	A `PrintOptions` object.
`epsOptions`	An `EpsOptions` object.
`pageSetupOptions`	A `PageSetupOptions` object.
`pngOptions`	A `PngOptions` object.
`psOptions`	A `PsOptions` object.
`svgOptions`	A `SvgOptions` object.
`tiffOptions`	A `TiffOptions` object.
`autoColors`	An `AutoColors` object specifying the color palette to be used for color coding.
`xyColors`	An `AutoColors` object specifying the color palette to be used forXYCurve objects.
`xyDataObjects`	A repository of XYData objects.
`curves`	A repository of XYCurve objects.
`xyPlots`	A repository of XYPlot objects.
`charts`	A repository of Chart objects.
`defaultXYReportOptions`	An `XYReportOptions` object.
`xyReportOptions`	An `XYReportOptions` object.
`views`	A repository of View objects.
`networkDatabaseConnectors`	A repository of NetworkDatabaseConnector objects.
`displayGroups`	A repository of DisplayGroup objects.
`graphicsInfo`	A `GraphicsInfo` object.
`defaultGraphicsOptions`	A `GraphicsOptions` object.
`graphicsOptions`	A `GraphicsOptions` object.
`defaultViewportAnnotationOptions`	A `ViewportAnnotationOptions` object.
`queues`	A repository of Queue objects.
`currentViewportName`	A String specifying the name of the current viewport.
`sessionState`	A Dictionary object specifying the viewports and their associated models.
`images`	A repository of Image objects.
`movies`	A repository of Movie objects.
`defaultLightOptions`	A `LightOptions` object.
`drawingArea`	A `DrawingArea` object.
`defaultMesherOptions`	A `MesherOptions` object specifying how to control default settings in the Mesh module.
`drawings`	A repository of Drawing objects.

Public Methods:

ScratchOdb(odb)

This method creates a new ScratchOdb object.

Inherited from SessionBase

`setValues`([kernelMemoryLimit])	This method modifies the Session object.
`enableCADConnection`(CADName[, portNum])	This method enables the Abaqus/CAE listening port for the specified CAD system.
`isCADConnectionEnabled`()	This method checks the status of CAD Connection.
`disableCADConnection`(CADName)	This method disables an associative import CAD connection that was enabled.
`enableParameterUpdate`(CADName, CADVersion[, ...])	This method enables parameter updates for ProE and NX by establishing a connection with the listening port previously setup by the CAD application.
`setCADPortNumber`(CADName, Port)	This method enables parameter updates for CATIA V5 and CATIA V6 by establishing a connection with the listening port previously setup by the CAD application.
`updateCADParameters`(modelName, CADName, ...)	This method updates the parameters for the specified model using the specified parameter file.
`disableParameterUpdate`(CADName)	This method disables an associative CAD connection using parameters.
`printToFile`(fileName[, format, ...])	This method prints canvas objects to a file using the attributes stored in the PrintOptions object and the appropriate format options object.
`printToPrinter`([printCommand, numCopies, ...])	This method prints canvas objects to a Windows printer or to a PostScript printer.
`saveOptions`(directory)	This method saves your customized display settings.
`writeVrmlFile`(fileName[, format, canvasObjects])	This method exports the current viewport objects to a file.
`write3DXMLFile`(fileName[, format, canvasObjects])	This method exports the current viewport objects to a file.
`writeOBJFile`(fileName[, canvasObjects])	This method exports the current viewport objects to a file.
`openOdb`(name[, path, readOnly])	This method opens an existing output database (.odb) file and creates a new Odb object. This method is accessed only via the session object inside Abaqus/CAE and adds the new Odb object to the session.odbs repository. This method allows you to open multiple output databases at the same time and to use the repository key to specify a particular output database. For example::.

ScratchOdb(odb)[source]#

This method creates a new ScratchOdb object.

Note

This function can be accessed by:

session.ScratchOdb

Note

Check ScratchOdb on help.3ds.com/0.1..

Parameters:: odb (Odb) – An Odb object specifying the output database with which to associate.
Returns:: A ScratchOdb object.
Return type:: ScratchOdb

OdbSet#

class OdbSet(name, nodes)[source]#

The set objects are used to identify regions of a model.

Note

This object can be accessed by:

import odbAccess
session.odbs[name].parts[name].elementSets[name]
session.odbs[name].parts[name].nodeSets[name]
session.odbs[name].parts[name].surfaces[name]
session.odbs[name].rootAssembly.elementSets[name]
session.odbs[name].rootAssembly.instances[name].elementSets[name]
session.odbs[name].rootAssembly.instances[name].nodeSets[name]
session.odbs[name].rootAssembly.instances[name].surfaces[name]
session.odbs[name].rootAssembly.nodeSets[name]
session.odbs[name].rootAssembly.surfaces[name]
session.odbs[name].steps[name].frames[i].fieldOutputs[name].values[i].instance.elementSets[name]
session.odbs[name].steps[name].frames[i].fieldOutputs[name].values[i].instance.nodeSets[name]
session.odbs[name].steps[name].frames[i].fieldOutputs[name].values[i].instance.surfaces[name]

Note

Check OdbSet on help.3ds.com/0.1..

Public Data Attributes:

`name`	A String specifying the name of the set and the repository key.
`instanceNames`	A tuple of Strings specifying the namespaces for the nodes, elements, and faces; None if the set is on a Part or an OdbInstance object.
`nodes`	An `OdbMeshNodeArray` object specifying the nodes of an OdbSet.
`elements`	An `OdbMeshElementArray` object specifying the elements of an OdbSet.
`faces`	A tuple of SymbolicConstants specifying the element face.
`instances`	A repository of an OdbInstance object.
`isInternal`	A Boolean specifying whether the set is internal.

Public Methods:

`__init__`(name, nodes)	This method creates a node set from an array of OdbMeshNode objects (for part instance-level sets) or from a sequence of arrays of OdbMeshNode objects (for assembly-level sets).
`NodeSetFromNodeLabels`(name, nodeLabels)	This method creates a node set from a sequence of node labels.
`ElementSet`(name, elements)	This method creates an element set from an array of OdbMeshElement objects (for part instance-level sets) or from a sequence of arrays of OdbMeshElement objects (for assembly-level sets).
`ElementSetFromElementLabels`(name, elementLabels)	This method creates an element set from a sequence of element labels.
`MeshSurface`(name, meshSurfaces)	This method creates a surface from the element and side identifiers for the assembly.
`MeshSurfaceFromElsets`(name, elementSetSeq)	This method creates a mesh surface from a sequence of element sets.
`MeshSurfaceFromLabels`(name, surfaceLabels)	This method creates a mesh surface from a sequence of surface labels.

ElementSet(name, elements)[source]#

This method creates an element set from an array of OdbMeshElement objects (for part instance-level sets) or from a sequence of arrays of OdbMeshElement objects (for assembly-level sets).

Note

This function can be accessed by:

session.odbs[name].parts[name].NodeSet
session.odbs[name].rootAssembly.instances[name].NodeSet
session.odbs[name].rootAssembly.NodeSet

Note

Check ElementSet on help.3ds.com/0.1..

Parameters:

name (str) – A String specifying the name of the set and the repository key.
elements (Tuple[OdbMeshElement, ...]) – A sequence of OdbMeshElement objects. For example, for a part:elements=instance1.elements[1:5]`For an assembly:`elements=(instance1.elements[1:5], instance2.elements[1:5])

Returns:

An OdbSet object.

Return type:

ElementSetFromElementLabels(name, elementLabels)[source]#

This method creates an element set from a sequence of element labels.

Note

This function can be accessed by:

session.odbs[name].parts[name].NodeSet
session.odbs[name].rootAssembly.instances[name].NodeSet
session.odbs[name].rootAssembly.NodeSet

Note

Check ElementSetFromElementLabels on help.3ds.com/0.1..

Parameters:

name (str) – A String specifying the name of the set and the repository key.
elementLabels (tuple) – A sequence of element labels. An element label is a sequence of Int element identifiers. For example, for a part:elementLabels=(2,3,5,7)`For an assembly:`elementLabels=((‘Instance-1’, (2,3,5,7)), (‘Instance-2’, (1,2,3)))

Returns:

An OdbSet object.

Return type:

MeshSurface(name, meshSurfaces)[source]#

This method creates a surface from the element and side identifiers for the assembly.

Note

This function can be accessed by:

session.odbs[name].parts[name].NodeSet
session.odbs[name].rootAssembly.instances[name].NodeSet
session.odbs[name].rootAssembly.NodeSet

Note

Check MeshSurface on help.3ds.com/0.1..

Parameters:

name (str) – A String specifying the name of the set and the repository key.
meshSurfaces (tuple) –
A sequence of sequences. Each sequence consists of an element sequence and a side identifier. The possible side identifiers depend on the type of element, as described in the following table:

Sequence of elements | Side identifiers |

——————————– | —————————————- |

Solid elements | FACE1, FACE2, FACE3, FACE4, FACE5, FACE6 |

Three-dimensional shell elements | SIDE1, SIDE2 |

Two-dimensional elements | FACE1, FACE2, FACE3, FACE4 |

Wire elements | END, END2 |

For example:
```
side1Elements=instance1.elements[217:218]
side2Elements=instance2.elements[100:105]
assembly.MeshSurface(
    name='Surf-1',
    meshSurfaces=((side1Elems,SIDE1), (side2Elems,SIDE2))
)
```

Returns:

An OdbSet object.

Return type:

MeshSurfaceFromElsets(name, elementSetSeq)[source]#

This method creates a mesh surface from a sequence of element sets.

Note

This function can be accessed by:

session.odbs[name].parts[name].NodeSet
session.odbs[name].rootAssembly.instances[name].NodeSet
session.odbs[name].rootAssembly.NodeSet

Note

Check MeshSurfaceFromElsets on help.3ds.com/0.1..

Parameters:

name (str) – A String specifying the name of the set and the repository key.
elementSetSeq (tuple) – A sequence of element sets. For example,`elementSetSeq=((elset1,SIDE1),(elset2,SIDE2))`where elset1=session.odbs[name].rootAssembly.elementSets[‘Clutch’] `and `SIDE1 and SIDE2 indicate the side of the element set.

Returns:

An OdbSet object.

Return type:

MeshSurfaceFromLabels(name, surfaceLabels)[source]#

This method creates a mesh surface from a sequence of surface labels.

Note

This function can be accessed by:

session.odbs[name].parts[name].NodeSet
session.odbs[name].rootAssembly.instances[name].NodeSet
session.odbs[name].rootAssembly.NodeSet

Note

Check MeshSurfaceFromLabels on help.3ds.com/0.1..

Parameters:

name (str) – A String specifying the name of the set and the repository key.
surfaceLabels (tuple) – A sequence of surface labels. For example,`surfaceLabels=((‘Instance-1’, ((10, FACE1), (11, FACE2))), (‘Instance-2’, ((10, FACE3), (12, FACE4))))`where 10 is an element number and FACE1 indicates the side of the element.

Returns:

An OdbSet object.

Return type:

NodeSetFromNodeLabels(name, nodeLabels)[source]#

This method creates a node set from a sequence of node labels.

Note

This function can be accessed by:

session.odbs[name].parts[name].NodeSet
session.odbs[name].rootAssembly.instances[name].NodeSet
session.odbs[name].rootAssembly.NodeSet

Note

Check NodeSetFromNodeLabels on help.3ds.com/0.1..

Parameters:

name (str) – A String specifying the name of the set and the repository key.
nodeLabels (tuple) – A sequence of node labels. A node label is a sequence of Int node identifiers. For example, for a part:nodeLabels=(2,3,5,7)`For an assembly:`nodeLabels=((‘Instance-1’, (2,3,5,7)), (‘Instance-2’, (1,2,3)))

Returns:

An OdbSet object.

Return type: