OdbPart object

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

The following topics are discussed:

Access

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

Part(...)

This method creates an OdbPart object. Nodes and elements are added to this object at a later stage.

Path

session.odbs[name].Part

Required arguments

name

A String specifying the part name.

embeddedSpace

A SymbolicConstant specifying the dimensionality of the Part object. Possible values are THREE_D, TWO_D_PLANAR, and AXISYMMETRIC.

type

A SymbolicConstant specifying the type of the Part object. Possible values are DEFORMABLE_BODY and ANALYTIC_RIGID_SURFACE.

Optional arguments

None.

Return value

An OdbPart object.

Exceptions

None.

addElements(...)

This method adds elements to an OdbPart object using element labels and nodal connectivity.

Warning:

Adding elements not in ascending order of their labels may cause Abaqus/Viewer to plot contours incorrectly.

Required arguments

labels

A sequence of Ints specifying the element labels.

connectivity

A sequence of sequences of Ints specifying the nodal connectivity.

type

A String specifying the element type.

Optional arguments

elementSetName

A String specifying a name for this element set. The default value is the empty string.

sectionCategory

A SectionCategory object for this element set.

Return value

None.

Exceptions

None.

addElements(...)

This method adds elements to an OdbPart object using a sequence of element labels and nodal connectivity.

Warning:

Adding elements not in ascending order of their labels may cause Abaqus/Viewer to plot contours incorrectly.

Required arguments

elementData

A sequence of sequences of Ints specifying the element labels and nodal connectivity, in the form ((label, c1, c2, c3, c4), (label, c1, c2, c3, c4), ...).

type

A String specifying the element type. The value can be user defined.

Optional arguments

elementSetName

A String specifying a name for this element set. The default value is None.

sectionCategory

A SectionCategory object for this element set.

Return value

None.

Exceptions

None.

addNodes(...)

This method adds nodes to an OdbPart object using node labels and coordinates.

Warning:

Adding nodes not in ascending order of their labels may cause Abaqus/Viewer to plot contours incorrectly.

Required arguments

labels

A sequence of Ints specifying the node labels.

coordinates

A sequence of sequences of Floats specifying the nodal coordinates.

Optional arguments

nodeSetName

A String specifying a name for this node set. The default value is None.

Return value

None.

Exceptions

None.

addNodes(...)

This method adds nodes to an OdbPart object using a sequence of node labels and coordinates.

Warning:

Adding nodes not in ascending order of their labels may cause Abaqus/Viewer to plot contours incorrectly.

Required arguments

nodeData

A sequence of tuples specifying the node labels and coordinates, in the form ((label, x, y, z), (label, x, y, z), ...).

Optional arguments

nodeSetName

A String specifying a name for this node set. The default value is None.

Return value

None.

Exceptions

None.

assignBeamOrientation(...)

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

Required arguments

region

An OdbSet specifying a region on an instance.

method

A SymbolicConstant specifying the assignment method. Only a value of N1_COSINES is currently supported.

vector

A sequence of three Floats specifying the approximate local  n1 -direction of the beam cross-section.

Optional arguments

None.

Return value

None.

Exceptions

None.

assignMaterialOrientation(...)

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

Required arguments

region

An OdbSet specifying a region on an instance.

localCSys

An OdbDatumCsys object specifying the local coordinate system or None, indicating the global coordinate system.

Optional arguments

axis

A SymbolicConstant specifying the axis of a cylindrical or spherical datum coordinate system about which an additional rotation is applied. For shells this axis is also the shell normal. Possible values are AXIS_1, AXIS_2, and AXIS_3. The default value is AXIS_1.

angle

A Float specifying the angle of the additional rotation. The default value is 0.0.

stackDirection

A SymbolicConstant specifying the stack or thickness direction of the material. Possible values are STACK_1, STACK_2, STACK_3, and STACK_ORIENTATION. The default value is STACK_3.

Return value

None.

Exceptions

None.

assignRebarOrientation(...)

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

Required arguments

region

An OdbSet specifying a region on an instance.

localCsys

An OdbDatumCsys object specifying the local coordinate system or None, indicating the global coordinate system.

Optional arguments

axis

A SymbolicConstant specifying the axis of a cylindrical or spherical datum coordinate system about which an additional rotation is applied. For shells this axis is also the shell normal. Possible values are AXIS_1, AXIS_2, and AXIS_3. The default value is AXIS_1.

angle

A Float specifying the angle of the additional rotation. The default value is 0.0.

Return value

None.

Exceptions

None.

getElementFromLabel(...)

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

Required arguments

label

An Int specifying the element label.

Optional arguments

None.

Return value

An OdbMeshElement object.

Exceptions

If no element with the specified label exists:

OdbError: Invalid element label

getNodeFromLabel(...)

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

Required arguments

label

An Int specifying the node label.

Optional arguments

None.

Return value

An OdbMeshNode object.

Exceptions

If no node with the specified label exists:

OdbError: Invalid node label

AnalyticRigidSurf2DPlanar(...)

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

Required arguments

name

The name of the analytic surface.

profile

A sequence of AnalyticSurfaceSegment objects or an OdbSequenceAnalyticSurfaceSegment object.

Optional arguments

filletRadius

A Double specifying the radius of curvature to smooth discontinuities between adjoining segments. The default value is 0.0.

Return value

None.

Exceptions

If OdbPart is of type THREE_D:

OdbError: 2D-Planar Analytic Rigid Surface can be defined only if the part is of type TWO_D_PLANAR or AXISYMMETRIC.

AnalyticRigidSurfExtrude(...)

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

Required arguments

name

The name of the analytic surface.

profile

A sequence of AnalyticSurfaceSegment objects or an OdbSequenceAnalyticSurfaceSegment object.

Optional arguments

filletRadius

A Double specifying the radius of curvature to smooth discontinuities between adjoining segments. The default value is 0.0.

Return value

None.

Exceptions

If OdbPart is not of type THREE_D:

OdbError: Analytic Rigid Surface of type CYLINDER can be defined only if the part is of type THREE_D.

AnalyticRigidSurfRevolve(...)

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

Required arguments

name

The name of the analytic surface.

profile

A sequence of AnalyticSurfaceSegment objects or an OdbSequenceAnalyticSurfaceSegment object.

Optional arguments

filletRadius

A Double specifying the radius of curvature to smooth discontinuities between adjoining segments. The default value is 0.0.

Return value

None.

Exceptions

If OdbPart is not of type THREE_D:

OdbError: Analytic Rigid Surface of type REVOLUTION can be defined only if the part is of type THREE_D.

RigidBody(...)

This method defines an OdbRigidBody on the part object.

Required arguments

referenceNode

An OdbSet specifying the reference node assigned to the rigid body.

Optional arguments

position

A symbolic constant specify if the location of the reference node is to be defined by the user. Possible values are INPUT and CENTER_OF_MASS. The default value is INPUT.

isothermal

A Boolean specifying an isothermal rigid body. The default value is OFF. This parameter is used only for a fully-coupled thermal stress analysis.

elset

An OdbSet specifying an element set assigned to the rigid body.

pinNodes

An OdbSet specifying pin-type nodes assigned to the rigid body.

tieNodes

An OdbSet specifying tie-type nodes assigned to the rigid body.

Return value

None.

Exceptions

If referenceNode is not a node set:

OdbError: Rigid body definition requires a node set.

Members

The OdbPart object has members with the same names and descriptions as the arguments to the Part method.

In addition, the OdbPart object can have the following members:

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.