60.25 OdbSet object

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

Access
odb.parts()[name].elementSets()[name]
odb.parts()[name].nodeSets()[name]
odb.parts()[name].surfaces()[name]
odb.rootAssembly().elementSets()[name]
odb.rootAssembly().instances()[name].elementSets()[name]
odb.rootAssembly().instances()[name].nodeSets()[name]
odb.rootAssembly().instances()[name].surfaces()[name]
odb.rootAssembly().nodeSets()[name]
odb.rootAssembly().surfaces()[name]
odb.steps()[name].frames(i).fieldOutputs()[name].values(i).instance()\
.elementSets()[name]
odb.steps()[name].frames(i).fieldOutputs()[name].values(i).instance()\
.nodeSets()[name]
odb.steps()[name].frames(i).fieldOutputs()[name].values(i).instance()\
.surfaces()[name]


60.25.1 NodeSet(...)

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).

Path
odb.parts()[name].NodeSet
odb.rootAssembly().instances()[name].NodeSet
odb.rootAssembly().NodeSet
Prototype
odb_Set&
NodeSet(const odb_String& name,
        const odb_SequenceNode& nodes);

Required arguments

name

An odb_String specifying the name of the set and the repository key.

nodes

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])

Optional arguments

None.

Return value

An OdbSet object.

Exceptions

InvalidNameError.


60.25.2 ElementSet(...)

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).

Path
odb.parts()[name].ElementSet
odb.rootAssembly().instances()[name].ElementSet
Prototype
odb_Set&
ElementSet(const odb_String& name,
           const odb_SequenceElement& elements);

Required arguments

name

An odb_String specifying the name of the set and the repository key.

elements

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])

Optional arguments

None.

Return value

An OdbSet object.

Exceptions

InvalidNameError.


60.25.3 NodeSet(...)

This method creates a node set.

Path
odb.parts()[name].NodeSet                   
odb.rootAssembly().instances()[name].NodeSet                   
odb.rootAssembly().NodeSet
Prototype
odb_Set&
NodeSet(const odb_String& name,
        const odb_SequenceInt& nodeLabels);

Required arguments

name

An odb_String specifying the name of the set and the repository key.

nodeLabels

An odb_SequenceInt specifying the node labels.

Optional arguments

None.

Return value

An OdbSet object.

Exceptions

None.


60.25.4 NodeSet(...)

This method creates a node set.

Path
odb.rootAssembly().NodeSet
Prototype
odb_Set&
NodeSet(const odb_String& name,
        const odb_SequenceString& instanceNames,
        const odb_SequenceSequenceInt& nodeLabels);

Required arguments

name

An odb_String specifying the name of the set and the repository key.

instanceNames

An odb_SequenceString specifying the namespaces for nodeLabels.

nodeLabels

An odb_SequenceSequenceInt specifying the node labels.

Optional arguments

None.

Return value

An OdbSet object.

Exceptions

None.


60.25.5 ElementSet(...)

This method creates an element set.

Path
odb.parts()[name].ElementSet                   
odb.rootAssembly().instances()[name].ElementSet                   
odb.rootAssembly().ElementSet
Prototype
odb_Set&
ElementSet(const odb_String& name,
           const odb_SequenceInt& elementLabels);

Required arguments

name

An odb_String specifying the name of the set and the repository key.

elementLabels

An odb_SequenceInt specifying the element labels.

Optional arguments

None.

Return value

An OdbSet object.

Exceptions

None.


60.25.6 ElementSet(...)

This method creates an element set.

Path
odb.rootAssembly().ElementSet
Prototype
odb_Set&
ElementSet(const odb_String& name,
           const odb_SequenceString& instanceNames,
           const odb_SequenceSequenceInt& elementLabels);

Required arguments

name

An odb_String specifying the name of the set and the repository key.

instanceNames

An odb_SequenceString specifying the namespaces for elementLabels.

elementLabels

An odb_SequenceSequenceInt specifying the element labels.

Optional arguments

None.

Return value

An OdbSet object.

Exceptions

None.


60.25.7 Surface(...)

This method creates a surface set.

Path
odb.parts()[name].Surface                   
odb.rootAssembly().instances()[name].Surface                   
Prototype
odb_Set&
Surface(const odb_String& name,
        const odb_SequenceElement& elements,
        const odb_SequenceElementFace& faces);

Required arguments

name

An odb_String specifying the name of the set and the repository key.

elements

An odb_SequenceElement specifying the elements in the surface.

faces

An odb_SequenceElementFace specifying the element faces.

The possible face enumerations depend on the type of element, as described in the following table:

Element typeFace enumerations
Solid elementsFACE1, FACE2, FACE3, FACE4, FACE5, FACE6
Three-dimensional shell elementsSIDE1, SIDE2
Two-dimensional elementsFACE1, FACE2, FACE3, FACE4
Wire elementsEND, END2

Optional arguments

None.

Return value

An OdbSet object.

Exceptions

None.


60.25.8 Surface(...)

This method creates a surface set.

Path
odb.parts()[name].Surface                   
odb.rootAssembly().instances()[name].Surface                   
Prototype
odb_Set&
Surface(const odb_String& name,
        const odb_SequenceInt& elementLabels,
        const odb_SequenceElementFace& faces);

Required arguments

name

An odb_String specifying the name of the set and the repository key.

elementLabels

An odb_SequenceInt specifying the element labels.

faces

An odb_SequenceElementFace specifying the element faces. An odb_SequenceSequenceElementFace is required for an assembly set.

Optional arguments

None.

Return value

An OdbSet object.

Exceptions

None.


60.25.9 Surface(...)

This method creates a surface set.

Path
odb.rootAssembly().Surface
Prototype
odb_Set&
Surface(const odb_String& name,
        const odb_SequenceString& instanceNames,
        const odb_SequenceSequenceInt& elementLabels,
        const odb_SequenceSequenceElementFace& faces);

Required arguments

name

An odb_String specifying the name of the set and the repository key.

instanceNames

An odb_SequenceString specifying the namespaces for elementLabels. This member is only valid for assembly sets.

elementLabels

An odb_SequenceSequenceInt specifying the element labels.

faces

An odb_SequenceSequenceElementFace specifying the element faces.

Optional arguments

None.

Return value

An OdbSet object.

Exceptions

None.


60.25.10  Members

The OdbSet object can have the following members:

Prototype
odb_String name() const;
               odb_SequenceString instanceNames();
               odb_Node nodes(int index);
               const odb_SequenceNode& nodes();
               const odb_SequenceNode& nodes(const odb_String& instanceName);
               odb_Element elements(int index);
               const odb_SequenceElement& elements();
               const odb_SequenceElement& elements(const odb_String& instanceName);
               odb_Enum::odb_ElementFaceEnum faces(int index);
               const odb_SequenceElementFace& faces() ;
               const odb_SequenceElementFace& faces(const odb_String& instanceName);
               odb_Enum::odb_SetTypeEnum type() const;
name

An odb_String specifying the name of the set and the repository key.

instanceNames

An odb_SequenceString specifying the namespaces for the nodes, elements, and faces; None if the set is on a Part or an OdbInstance object.

nodes

A sequence of OdbMeshNode objects specifying if a set spans more than one part instance, this member is a sequence of sequences for each part instance.

elements

A sequence of OdbMeshElement objects specifying if a set spans more than one part instance, this member is a sequence of sequences for each part instance.

faces

An odb_SequenceElementFace specifying the element face. If a set spans more than one part instance, this member is a sequence of sequences for each part instance.