OdbSet object

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

This page discusses:

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]

NodeSet(...)

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

Path

odb.parts()[name].NodeSet

odb.rootAssembly().instances()[name].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]

Optional arguments

None.

Return value

An OdbSet object.

Exceptions

InvalidNameError.

ElementSet(...)

This method creates an element set from an array of OdbMeshElement objects (for part instance-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]

Optional arguments

None.

Return value

An OdbSet object.

Exceptions

InvalidNameError.

NodeSet(...)

This method creates a node set.

Path

odb.parts()[name].NodeSet

odb.rootAssembly().instances()[name].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.

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. The string could be an empty string to denote the nodeLabels at the assembly level.

nodeLabels

An odb_SequenceSequenceInt specifying the node labels.

Optional arguments

None.

Return value

An OdbSet object.

Exceptions

None.

ElementSet(...)

This method creates an element set.

Path

odb.parts()[name].ElementSet

odb.rootAssembly().instances()[name].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.

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. The string could be an empty string to denote the elementLabels at the assembly level.

elementLabels

An odb_SequenceSequenceInt specifying the element labels.

Optional arguments

None.

Return value

An OdbSet object.

Exceptions

None.

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 type Face enumerations
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

Optional arguments

None.

Return value

An OdbSet object.

Exceptions

None.

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.

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. The string could be an empty string to denote the elementLabels at the assembly level.

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.

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); // For an assembly level set
               odb_Element elements(int index);
               const odb_SequenceElement& elements();
               const odb_SequenceElement& elements(const odb_String& \
                   instanceName); // For an assembly level set
               odb_Enum::odb_ElementFaceEnum faces(int index);
               const odb_SequenceElementFace& faces() ;
               const odb_SequenceElementFace& faces(const odb_String& \
                    instanceName); // For an assembly level set
               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 constituting the set.

nodes

A sequence of OdbMeshNode objects.

elements

A sequence of OdbMeshElement objects.

faces

An odb_SequenceElementFace specifying the element face.