Region#

Region commands are used to create part and assembly sets or surfaces from elements, nodes, and geometry. For more information, see Specifying a region. Part and assembly objects have the following member, a repository of Set objects:

  • sets

In turn, a Set object can contain any one of the following types:

  • elements

  • nodes

  • geometry

A Set object can contain a number of entities of a single type (nodes, elements, or geometry) or a combination of node and element types. However, except for nodes and elements, a Set object cannot contain a combination of types.

The following are members of the Set object:

  • nodes

  • elements

  • cells

  • faces

  • edges

  • vertices

  • referencePoints

Region commands are also used to create surfaces on the assembly. Surfaces are sets with additional sidedness information.

Part sets contain regions of a part. You can assign section definitions to a set created by selecting a region of a part. The part sets can be accessed from the instance; however, the section definition you assigned to a region is copied automatically to all instances of that part in the assembly.

Assembly sets contain regions of an assembly and are used by many commands that operate on the assembly. For example, you can apply a load or boundary condition to a set created by selecting a region of the assembly. Sets can include regions from multiple part instances.

Create regions for Part#

RegionPart.Surface(side1Faces: tuple[Face] | None = None, side2Faces: tuple[Face] | None = None, side12Faces: tuple[Face] | None = None, end1Edges: tuple[Face] | None = None, end2Edges: tuple[Face] | None = None, circumEdges: tuple[Face] | None = None, side1Edges: tuple[Face] | None = None, side2Edges: tuple[Face] | None = None, face1Elements: tuple[Face] | None = None, face2Elements: tuple[Face] | None = None, face3Elements: tuple[Face] | None = None, face4Elements: tuple[Face] | None = None, face5Elements: tuple[Face] | None = None, face6Elements: tuple[Face] | None = None, side1Elements: tuple[Face] | None = None, side2Elements: tuple[Face] | None = None, side12Elements: tuple[Face] | None = None, end1Elements: tuple[Face] | None = None, end2Elements: tuple[Face] | None = None, circumElements: tuple[Face] | None = None, name: str = '', **kwargs) Surface[source]#

This method creates a surface from a sequence of objects in a model database. The surface will apply to the sides specified by the arguments.For example

surface=mdb.models['Model-1'].parts['Part-1'].Surface(side1Faces=side1Faces, name='Surf-1')
Parameters:
side1Faces
side2Faces
side12Faces
end1Edges
end2Edges
circumEdges
side1Edges
side2Edges
face1Elements
face2Elements
face3Elements
face4Elements
face5Elements
face6Elements
side1Elements
side2Elements
side12Elements
end1Elements
end2Elements
circumElements
name

A String specifying the repository key. The default value is an empty string.

Returns:
surf: Surface

A Surface object

Required key-value arguments#

On three-dimensional solid faces, you can use the following arguments:

  • side1Faces

  • side2Faces

On three-dimensional shell faces, you can use the following arguments:

  • side1Faces

  • side2Faces

  • side12Faces

On three-dimensional wire edges, you can use the following arguments:

  • end1Edges

  • end2Edges

  • circumEdges

On three-dimensional or two-dimensional or axisymmetric edges, you can use the following arguments:

  • side1Edges

  • side2Edges

On two-dimensional or axisymmetric shell elements, you can use the following arguments:

  • face1Elements

  • face2Elements

  • face3Elements

  • face4Elements

On solid elements, you can use the following arguments:

  • face1Elements

  • face2Elements

  • face3Elements

  • face4Elements

  • face5Elements

  • face6Elements

On three-dimensional shell elements, you can use the following arguments:

  • side1Elements

  • side2Elements

  • side12Elements

On three-dimensional wire elements, you can use the following arguments:

  • end1Elements

  • end2Elements

  • circumElements

On two-dimensional or axisymmetric wire elements, you can use the following arguments:

  • side1Elements

  • side2Elements

RegionPart.Set(name: str, nodes: tuple[MeshNode] = None, elements: tuple[MeshElement] = None, region: Region = None, vertices: tuple[Vertex] = None, edges: tuple[Edge] = None, faces: tuple[Face] = None, cells: tuple[Cell] = None, xVertices: tuple[Vertex] = None, xEdges: tuple[Edge] = None, xFaces: tuple[Face] = None, referencePoints: tuple[ReferencePoint] = (), skinFaces: tuple = (), skinEdges: tuple = (), stringerEdges: tuple = ()) Set[source]#
RegionPart.Set(name: str, objectToCopy: Set) Set

This method creates a set from a sequence of objects in a model database.

Parameters:
name
Returns:
set: Set

A Set object

Notes

This function can be accessed by:

mdb.models[name].parts[*name*].Set
mdb.models[name].rootAssembly.Set
RegionPart.Skin(name: str, faces: tuple[Face] = (), edges: tuple[Edge] = (), elementFaces: tuple[MeshFace] = (), elementEdges: tuple[MeshEdge] = ()) Skin[source]#

This method creates a skin from a sequence of objects in a model database. At least one of the optional arguments needs to be specified.

Parameters:
name

A String specifying the repository key. The default value is an empty string.

faces

A sequence of Face objects specifying the faces on which skins should be created. Applicable to three and two-dimensional parts.

edges

A sequence of Edge objects specifying the edges on which skins should be created. Applicable to axisymmetric parts.

elementFaces

A sequence of MeshFace objects specifying the mesh faces on which skins should be created. Applicable to three and two-dimensional parts.

elementEdges

A sequence of MeshEdge objects specifying the mesh edges on which skins should be created. Applicable to axisymmetric parts.

Returns:
skin: Skin

A Skin object

Notes

This function can be accessed by:

mdb.models[name].parts[*name*].Skin
RegionPart.EditSkin(name: str = '', faces: tuple[Face] = (), edges: tuple[Edge] = (), elementFaces: tuple[MeshFace] = (), elementEdges: tuple[MeshEdge] = ()) Skin[source]#

This method modifies underlying entities of the selected skin. At least one of the optional arguments needs to be specified.

Parameters:
name

A String specifying the repository key. The default value is an empty string.

faces

A sequence of Face objects specifying the faces on which skins should be created. Applicable to three and two-dimensional parts.

edges

A sequence of Edge objects specifying the edges on which skins should be created. Applicable to axisymmetric parts.

elementFaces

A sequence of MeshFace objects specifying the mesh faces on which skins should be created. Applicable to three and two-dimensional parts.

elementEdges

A sequence of MeshEdge objects specifying the mesh edges on which skins should be created. Applicable to axisymmetric parts.

Returns:
skin: Skin

A Skin object

Notes

This function can be accessed by:

mdb.models[name].parts[*name*].EditSkin
RegionPart.Stringer(name: str, edges: tuple[Edge] = (), elementEdges: tuple[MeshEdge] = ()) Stringer[source]#

This method creates a stringer from a sequence of objects in a model database. At least one of the optional arguments needs to be specified.

Parameters:
name

A String specifying the repository key. The default value is an empty string.

edges

A sequence of Edge objects specifying the edges on which stringers should be created. Applicable to three and two-dimensional parts.

elementEdges

A sequence of MeshEdge objects specifying the mesh edges on which stringers should be created. Applicable to three and two-dimensional parts.

Returns:
stringer: Stringer

A Stringer object

Notes

This function can be accessed by:

mdb.models[name].parts[*name*].Stringer

Create regions for Assembly#

RegionAssembly.Surface(side1Faces: tuple[Face] | None = None, side2Faces: tuple[Face] | None = None, side12Faces: tuple[Face] | None = None, end1Edges: tuple[Face] | None = None, end2Edges: tuple[Face] | None = None, circumEdges: tuple[Face] | None = None, side1Edges: tuple[Face] | None = None, side2Edges: tuple[Face] | None = None, face1Elements: tuple[Face] | None = None, face2Elements: tuple[Face] | None = None, face3Elements: tuple[Face] | None = None, face4Elements: tuple[Face] | None = None, face5Elements: tuple[Face] | None = None, face6Elements: tuple[Face] | None = None, side1Elements: tuple[Face] | None = None, side2Elements: tuple[Face] | None = None, side12Elements: tuple[Face] | None = None, end1Elements: tuple[Face] | None = None, end2Elements: tuple[Face] | None = None, circumElements: tuple[Face] | None = None, name: str = '')[source]#

This method creates a surface from a sequence of objects in a model database. The surface will apply to the sides specified by the arguments.For example surface=mdb.models[‘Model-1’].parts[‘Part-1’].Surface(side1Faces=side1Faces, name=’Surf-1’)

Parameters:
name

A String specifying the repository key. The default value is an empty string.

Returns:
A Surface object.

Notes

This function can be accessed by:

mdb.models[name].parts[*name*].Surface
mdb.models[name].rootAssembly.Surface
side1Faces
side2Faces
side12Faces
On three-dimensional wire edges, you can use the following arguments:

end1Edges end2Edges circumEdges

On three-dimensional or two-dimensional or axisymmetric edges, you can use the following arguments:

side1Edges side2Edges

On two-dimensional or axisymmetric shell elements, you can use the following arguments:

face1Elements face2Elements face3Elements face4Elements face5Elements face6Elements

On three-dimensional shell elements, you can use the following arguments:

side1Elements side2Elements side12Elements

On three-dimensional wire elements, you can use the following arguments:

end1Elements end2Elements circumElements

On two-dimensional or axisymmetric wire elements, you can use the following arguments:

RegionAssembly.Set(name: str, nodes: tuple[MeshNode] = None, elements: tuple[MeshElement] = None, region: Region = None, vertices: tuple[Vertex] = None, edges: tuple[Edge] = None, faces: tuple[Face] = None, cells: tuple[Cell] = None, xVertices: tuple[Vertex] = None, xEdges: tuple[Edge] = None, xFaces: tuple[Face] = None, referencePoints: tuple[ReferencePoint] = (), skinFaces: tuple = (), skinEdges: tuple = (), stringerEdges: tuple = ())[source]#
RegionAssembly.Set(name: str, objectToCopy: Set)

Object features#

Region features for Part#

class RegionPartBase(name: str, dimensionality: SymbolicConstantType, type: SymbolicConstantType, twist: BooleanType = OFF)[source]#
class RegionPartBase(name: str, objectToCopy: str, scale: float = 1, mirrorPlane: SymbolicConstantType = NONE, compressFeatureList: BooleanType = OFF, separate: BooleanType = OFF)

The following commands operate on Part objects. For more information about the Part object, see Part object.

Notes

This object can be accessed by:

import regionToolset

Methods

clashSets(arg1, arg2)

This command prints a message describing the relationship between the contents of two sets. Possible outcomes are: - Both sets are the same. - Set 2 is a subset of set 1. - Set 2 is a superset of set 1. - Set 2 intersects set 1. - Set 2 touches set 1 (their boundaries intersect). - Set 2 and set 1 are disjoint. This command accepts only positional arguments and has no keywords.

deleteSets(setNames)

This command deletes the given sets from the part.

deleteSurfaces(surfaceNames)

This command deletes the given surfaces from the part.

isSetInternal(setName)

This command returns a flag indicating whether the Set is Internal.

isSurfaceInternal(surfaceName)

This command returns a flag indicating whether the Surface is Internal.

markSetInternal(setName, internalSet)

This command marks the given Set as internal or external.

markSurfaceInternal(setName, internalSurface)

This command marks the given Surface as internal or external.

clashSets(arg1: str, arg2: str)[source]#

This command prints a message describing the relationship between the contents of two sets. Possible outcomes are:

  • Both sets are the same.

  • Set 2 is a subset of set 1.

  • Set 2 is a superset of set 1.

  • Set 2 intersects set 1.

  • Set 2 touches set 1 (their boundaries intersect).

  • Set 2 and set 1 are disjoint.

This command accepts only positional arguments and has no keywords.

Parameters:
arg1

A Set or Surface object specifying set 1.

arg2

A Set or Surface object specifying set 2.

deleteSets(setNames: tuple)[source]#

This command deletes the given sets from the part.

Parameters:
setNames

A sequence of Strings specifying the set names that will be deleted from the part.

deleteSurfaces(surfaceNames: tuple)[source]#

This command deletes the given surfaces from the part.

Parameters:
surfaceNames

A sequence of Strings specifying the surface names that will be deleted from the part.

isSetInternal(setName: str)[source]#

This command returns a flag indicating whether the Set is Internal.

Parameters:
setName

A string specifying the Set name.

isSurfaceInternal(surfaceName: str)[source]#

This command returns a flag indicating whether the Surface is Internal.

Parameters:
surfaceName

A string specifying the Surface name.

markSetInternal(setName: str, internalSet: BooleanType)[source]#

This command marks the given Set as internal or external.

Parameters:
setName

A string specifying the Set name.

internalSet

A Boolean specifying whether the Set should be marked as internal.

markSurfaceInternal(setName: str, internalSurface: BooleanType)[source]#

This command marks the given Surface as internal or external.

Parameters:
setName

A string specifying the Surface name.

internalSurface

A Boolean specifying whether the Surface should be marked as internal.

Region features for Assembly#

class RegionAssemblyBase[source]#

The following commands operate on Assembly objects. For more information about the Assembly object, see Assembly object.

Notes

This object can be accessed by:

import regionToolset

Methods

clashSets(arg1, arg2)

This command prints a message describing the relationship between the contents of two sets. Possible outcomes are: - Both sets are the same. - Set 2 is a subset of set 1. - Set 2 is a superset of set 1. - Set 2 intersects set 1. - Set 2 touches set 1 (their boundaries intersect). - Set 2 and set 1 are disjoint. This command accepts only positional arguments and has no keywords.

deleteSets(setNames)

This command deletes the given sets from the assembly.

deleteSurfaces(surfaceNames)

This command deletes the given surfaces from the assembly.

isSetInternal(setName)

This command returns a flag indicating whether the Set is Internal.

isSurfaceInternal(surfaceName)

This command returns a flag indicating whether the Surface is Internal.

markSetInternal(setName, internalSet)

This command marks the given Set as internal or external.

markSurfaceInternal(setName, internalSurface)

This command marks the given Surface as internal or external.

clashSets(arg1: str, arg2: str)[source]#

This command prints a message describing the relationship between the contents of two sets. Possible outcomes are:

  • Both sets are the same.

  • Set 2 is a subset of set 1.

  • Set 2 is a superset of set 1.

  • Set 2 intersects set 1.

  • Set 2 touches set 1 (their boundaries intersect).

  • Set 2 and set 1 are disjoint.

This command accepts only positional arguments and has no keywords.

Parameters:
arg1

A Set or Surface object specifying set 1.

arg2

A Set or Surface object specifying set 2.

deleteSets(setNames: tuple)[source]#

This command deletes the given sets from the assembly.

Parameters:
setNames

A sequence of Strings specifying the set names that will be deleted from the assembly.

deleteSurfaces(surfaceNames: tuple)[source]#

This command deletes the given surfaces from the assembly.

Parameters:
surfaceNames

A sequence of Strings specifying the surface names that will be deleted from the assembly.

isSetInternal(setName: str)[source]#

This command returns a flag indicating whether the Set is Internal.

Parameters:
setName

A string specifying the Set name.

isSurfaceInternal(surfaceName: str)[source]#

This command returns a flag indicating whether the Surface is Internal.

Parameters:
surfaceName

A string specifying the Surface name.

markSetInternal(setName: str, internalSet: BooleanType)[source]#

This command marks the given Set as internal or external.

Parameters:
setName

A string specifying the Set name.

internalSet

A Boolean specifying whether the Set should be marked as internal.

markSurfaceInternal(setName: str, internalSurface: BooleanType)[source]#

This command marks the given Surface as internal or external.

Parameters:
setName

A string specifying the Surface name.

internalSurface

A Boolean specifying whether the Surface should be marked as internal.

Region#

class Region(elements: tuple[MeshElement] = None, nodes: tuple[MeshNode] = None, vertices: tuple[Vertex] = None, edges: tuple[Edge] = None, faces: tuple[Face] = None, cells: tuple[Cell] = None, referencePoints: tuple[ReferencePoint] = (), xVertices: tuple[Vertex] = None, xEdges: tuple[Vertex] = None, xFaces: tuple[Vertex] = None, skinFaces: tuple = (), skinEdges: tuple = (), stringerEdges: tuple = ())[source]#
class Region(side1Faces: tuple[Face] = None, side2Faces: tuple[Face] = None, side12Faces: tuple[Face] = None, side1Edges: tuple[Edge] = None, side2Edges: tuple[Edge] = None, end1Edges: tuple[Edge] = None, end2Edges: tuple[Edge] = None, circumEdges: tuple[Edge] = None, face1Elements: tuple[MeshElement] = None, face2Elements: tuple[MeshElement] = None, face3Elements: tuple[MeshElement] = None, face4Elements: tuple[MeshElement] = None, face5Elements: tuple[MeshElement] = None, face6Elements: tuple[MeshElement] = None, side1Elements: tuple[MeshElement] = None, side2Elements: tuple[MeshElement] = None, side12Elements: tuple[MeshElement] = None, end1Elements: tuple[MeshElement] = None, end2Elements: tuple[MeshElement] = None, circumElements: tuple[MeshElement] = None)

The purpose of the Region object is to provide a link between an attribute and the geometric or discrete entities to which the attribute is applied. An attribute (Load, BC, IC, etc.) is applied to one or more Region objects; each Region object in turn is associated with a picked Set or Surface or with a named Set or Surface. The Region object provides a unified interface (or “façade”) to data and functionality located at the Set or Surface. A script that applies an attribute to a picked Set or Surface requires the explicit creation of a Region object and will implicitly create a matching internal Set or Surface. Conversely, a script that applies an attribute to a named Set or Surface requires the explicit creation of that Set or Surface (see 39.4) and will implicitly create a region object. The reference between Region and Set/Surface is by name (user-provided or internal.) If the Set/Surface is suppressed, deleted, or renamed, the Region object will not be able to find the associated Set/Surface, and will communicate that to the attribute, but will not be affected otherwise. If a Set/Surface with the same name becomes available (only possible with user-provided names) the Region object will re-establish the connection. Another way of correcting this problem is to re-apply the attribute. Wherever a particular Load, BC, IC, etc. command accepts a named set or a named surface, that command will also accept a Region object. For example myRegion = regionToolset.Region(edges=edges1) mdb.models[‘Model-1’].DisplacementBC(name=’BC-1’

createStepName=’Initial’, region=myRegion, u1=SET u2=SET)

myRegion = regionToolset.Region(elements=e[1:100]) p = mdb.models[‘mirror’].parts[‘COLLAR_MIRROR-1’] p.SectionAssignment(region=myRegion, sectionName=’Section-1’) Abaqus does not provide a regions repository; as an alternative, you should assign a variable to a Region object and refer to the variable. The lifecycle of a Region object is similar to the lifecycle of a Leaf object used by display groups; as a result, you should use a Region object immediately after you create it. The contents of a Region object are not intended to survive regeneration. If you use an out-of-date Region object, the script is unlikely to function correctly. Querying an attribute’s Region will return a Region tuple. The contents of the tuple are the set name followed by the owners of the set and three flags expressed as integers. The flags indicate the region space, the type of region and the whether the region is an internal set.

Notes

This object can be accessed by:

import regionToolset

RegionArray#

class RegionArray(iterable=(), /)[source]#

Methods

findAt

Set#

class Set(name: str, nodes: tuple[MeshNode] = None, elements: tuple[MeshElement] = None, region: Region = None, vertices: tuple[Vertex] = None, edges: tuple[Edge] = None, faces: tuple[Face] = None, cells: tuple[Cell] = None, xVertices: tuple[Vertex] = None, xEdges: tuple[Edge] = None, xFaces: tuple[Face] = None, referencePoints: tuple[ReferencePoint] = (), skinFaces: tuple = (), skinEdges: tuple = (), stringerEdges: tuple = ())[source]#
class Set(name: str, objectToCopy: Set)

If a set spans more than one part instance, the members vertices, edges, faces, cells, elements, or nodes return a sequence of all the queried vertices/edges/faces/cells/elements/nodes respectively for each part instance contained in the set. For example: assembly=mdb.models[‘Transmission’].rootAssembly clutchElements=assembly.instances[‘Clutch’].elements clutchSet=clutchElements[16:18]+clutchElements[78:80] housingElements=assembly.instances[‘Housing’].elements housingSet=housingElements[45:48] transmissionSet=assembly.Set(name=’TransmissionSet’, elements=(clutchSet, housingSet)) len(transmissionSet.elements)=7

transmissionSet.elements[0]=mdb.models[‘Transmission’].rootAssembly.instances[‘Clutch-1’].elements[16]

transmissionSet.elements[6]=mdb.models[‘Transmission’].rootAssembly.instances[‘housing-‘].elements[47]

Notes

This object can be accessed by:

import part
mdb.models[name].parts[name].allInternalSets[name]
mdb.models[name].parts[name].allSets[name]
mdb.models[name].parts[name].sets[name]
import assembly
mdb.models[name].rootAssembly.allInstances[name].sets[name]
mdb.models[name].rootAssembly.allInternalSets[name]
mdb.models[name].rootAssembly.allSets[name]
mdb.models[name].rootAssembly.instances[name].sets[name]
mdb.models[name].rootAssembly.modelInstances[i].sets[name]
mdb.models[name].rootAssembly.sets[name]
Attributes:
elements: MeshElementArray

A MeshElementArray object.

nodes: MeshNodeArray

A MeshNodeArray object.

vertices: VertexArray

A VertexArray object.

edges: EdgeArray

An EdgeArray object.

faces: FaceArray

A FaceArray object.

cells: CellArray

A CellArray object.

xVertices: VertexArray

A VertexArray object.

xEdges: EdgeArray

An EdgeArray object.

xFaces: FaceArray

A FaceArray object.

referencePoints: ReferencePointArray

A ReferencePointArray object.

Methods

MapSetsFromOdb(odbPath, odbSets[, partSets, ...])

This method creates sets based on mapping sets from element centroid locations in an Odb.

SetByBoolean(name, sets[, operation])

This method creates a set by performing a boolean operation on two or more input sets.

SetFromColor(name, color)

This method creates a set containing faces of the part marked with a specified color attribute.

SetFromElementLabels(name, elementLabels)

This method creates a set from a sequence of element labels in a model database.

SetFromNodeLabels(name, nodeLabels[, unsorted])

This method creates a set from a sequence of node labels in a model database.

MapSetsFromOdb(odbPath: str, odbSets: str, partSets: str = '', method: str = 'OVERWRITE')[source]#

This method creates sets based on mapping sets from element centroid locations in an Odb.

Parameters:
odbPath

A String specifying the path to the ODB containing the source sets.

odbSets

A list of names of sets on the ODB to map.

partSets

A list of names of sets to construct or use corresponding to the ODB sets.

method

An enum to specify OVERWRITE, APPEND, INTERSECT, or REMOVE. The default is OVERWRITE.

Returns:
A Set object or a python:tuple of Set objects.

Notes

This function can be accessed by:

mdb.models[name].parts[*name*].Set
mdb.models[name].rootAssembly.Set
SetByBoolean(name: str, sets: tuple['Set'], operation: SymbolicConstantType = 'UNION')[source]#

This method creates a set by performing a boolean operation on two or more input sets.

Parameters:
name

A String specifying the repository key.

sets

A sequence of Set objects.

operation

A SymbolicConstant specifying the boolean operation to perform. Possible values are UNION, INTERSECTION, and DIFFERENCE. The default value is UNION. Note that if DIFFERENCE is specified, the order of the given input sets is important; All sets specified after the first one are subtracted from the first one.

Returns:
A Set object.

Notes

This function can be accessed by:

mdb.models[name].parts[*name*].Set
mdb.models[name].rootAssembly.Set
SetFromColor(name: str, color: tuple)[source]#

This method creates a set containing faces of the part marked with a specified color attribute. Third-party applications can assign color attributes to faces, and the color attribute can be imported into Abaqus from an ACIS file. You can use this method to create sets only on parts; however, you can access the sets from instances of the parts in the assembly.

Parameters:
name

A String specifying the repository key.

color

A sequence of three Ints specifying the RGB color. Values can range from 0 to 255. The first integer is for red, the second for green, and the third for blue. For example, a face colored in yellow is identified by:color=(255,255,0)

Returns:
A Set object.

Notes

This function can be accessed by:

mdb.models[name].parts[*name*].Set
mdb.models[name].rootAssembly.Set
SetFromElementLabels(name: str, elementLabels: tuple)[source]#

This method creates a set from a sequence of element labels in a model database.

Parameters:
name

A String specifying the repository key.

elementLabels

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:
A Set object.

Notes

This function can be accessed by:

mdb.models[name].parts[*name*].Set
mdb.models[name].rootAssembly.Set
SetFromNodeLabels(name: str, nodeLabels: tuple, unsorted: BooleanType = False)[source]#

This method creates a set from a sequence of node labels in a model database.

Parameters:
name

A String specifying the repository key.

nodeLabels

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

unsorted

A Boolean specifying whether the created set is unsorted. The default value is False.

Returns:
A Set object.

Notes

This function can be accessed by:

mdb.models[name].parts[*name*].Set
mdb.models[name].rootAssembly.Set

Skin#

class Skin(name: str, faces: tuple[Face] = (), edges: tuple[Edge] = (), elementFaces: tuple[MeshFace] = (), elementEdges: tuple[MeshEdge] = ())[source]#

The Skin object stores information on skin reinforcements created on entities.

Notes

This object can be accessed by:

import part
mdb.models[name].parts[name].skins[name]
import assembly
mdb.models[name].rootAssembly.allInstances[name].skins[name]
mdb.models[name].rootAssembly.instances[name].skins[name]
mdb.models[name].rootAssembly.skins[name]
Attributes:
elements: MeshElementArray

A MeshElementArray object.

edges: EdgeArray

An EdgeArray object.

faces: FaceArray

A FaceArray object.

Methods

EditSkin([name, faces, edges, elementFaces, ...])

This method modifies underlying entities of the selected skin.

EditSkin(name: str = '', faces: tuple[Face] = (), edges: tuple[Edge] = (), elementFaces: tuple[MeshFace] = (), elementEdges: tuple[MeshEdge] = ())[source]#

This method modifies underlying entities of the selected skin. At least one of the optional arguments needs to be specified.

Parameters:
name

A String specifying the repository key. The default value is an empty string.

faces

A sequence of Face objects specifying the faces on which skins should be created. Applicable to three and two dimensional parts.

edges

A sequence of Edge objects specifying the edges on which skins should be created. Applicable to axisymmetric parts.

elementFaces

A sequence of MeshFace objects specifying the mesh faces on which skins should be created. Applicable to three and two dimensional parts.

elementEdges

A sequence of MeshEdge objects specifying the mesh edges on which skins should be created. Applicable to axisymmetric parts.

Returns:
A Skin object.

Notes

This function can be accessed by:

mdb.models[name].parts[*name*].Skin

Stringer#

class Stringer(name: str, edges: tuple[Edge] = (), elementEdges: tuple[MeshEdge] = ())[source]#

The Stringer object stores information on stringer reinforcements created on entities.

Notes

This object can be accessed by:

import part
mdb.models[name].parts[name].stringers[name]
import assembly
mdb.models[name].rootAssembly.allInstances[name].stringers[name]
mdb.models[name].rootAssembly.instances[name].stringers[name]
mdb.models[name].rootAssembly.stringers[name]
Attributes:
elements: MeshElementArray

A MeshElementArray object.

edges: EdgeArray

An EdgeArray object.

Methods

EditStringer(name[, edges, elementEdges])

This method modifies underlying entities of the selected stringer.

EditStringer(name: str, edges: tuple[Edge] = (), elementEdges: tuple[MeshEdge] = ())[source]#

This method modifies underlying entities of the selected stringer. At least one of the optional arguments needs to be specified.

Parameters:
name

A String specifying the repository key. The default value is an empty string.

edges

A sequence of Edge objects specifying the edges on which stringers should be created. Applicable to three and two dimensional parts.

elementEdges

A sequence of MeshEdge objects specifying the mesh edges on which stringers should be created. Applicable to three and two dimensional parts.

Returns:
A Stringer object.

Notes

This function can be accessed by:

mdb.models[name].parts[*name*].Stringer

Surface#

class Surface(side1Faces: tuple[Face] = None, side2Faces: tuple[Face] = None, side12Faces: tuple[Face] = None, end1Edges: tuple[Face] = None, end2Edges: tuple[Face] = None, circumEdges: tuple[Face] = None, side1Edges: tuple[Face] = None, side2Edges: tuple[Face] = None, face1Elements: tuple[Face] = None, face2Elements: tuple[Face] = None, face3Elements: tuple[Face] = None, face4Elements: tuple[Face] = None, face5Elements: tuple[Face] = None, face6Elements: tuple[Face] = None, side1Elements: tuple[Face] = None, side2Elements: tuple[Face] = None, side12Elements: tuple[Face] = None, end1Elements: tuple[Face] = None, end2Elements: tuple[Face] = None, circumElements: tuple[Face] = None, name: str = '', **kwargs)[source]#
class Surface(name: str, objectToCopy: Surface)

The Surface object stores surfaces selected from the assembly. A surface is comprised of geometric or discrete entities but not both. An instance of a Surface object is available from the surface member of the Assembly object.

Notes

This object can be accessed by:

import part
mdb.models[name].parts[name].allInternalSurfaces[name]
mdb.models[name].parts[name].allSurfaces[name]
mdb.models[name].parts[name].surfaces[name]
import assembly
mdb.models[name].rootAssembly.allInstances[name].surfaces[name]
mdb.models[name].rootAssembly.allInternalSurfaces[name]
mdb.models[name].rootAssembly.allSurfaces[name]
mdb.models[name].rootAssembly.instances[name].surfaces[name]
mdb.models[name].rootAssembly.modelInstances[i].surfaces[name]
mdb.models[name].rootAssembly.surfaces[name]
Attributes:
edges: EdgeArray

An EdgeArray object.

faces: FaceArray

A FaceArray object.

elements: MeshElementArray

A MeshElementArray object.

nodes: MeshNodeArray

A MeshNodeArray object.

sides: SymbolicConstant

A tuple of SymbolicConstants specifying the sides; for example, (SIDE1, SIDE2).

instances: int

A tuple of Ints specifying the instances. This member is not applicable for a Surface object on an output database.

Methods

SurfaceByBoolean(name, surfaces[, operation])

This method creates a surface by performing a boolean operation on two or more input surfaces.

SurfaceFromElsets(name, elementSetSeq)

This method creates a surface from a sequence of element sets in a model database.

SurfaceByBoolean(name: str, surfaces: tuple['Surface'], operation: SymbolicConstantType = 'UNION')[source]#

This method creates a surface by performing a boolean operation on two or more input surfaces.

Parameters:
name

A String specifying the repository key.

surfaces

A sequence of Surface objects.

operation

A SymbolicConstant specifying the boolean operation to perform. Possible values are UNION, INTERSECTION, andDIFFERENCE. The default value is UNION. Note that if DIFFERENCE is specified, the order of the given input surfaces is important; All surfaces specified after the first one are subtracted from the first one.

Returns:
A Surface object.

Notes

This function can be accessed by:

mdb.models[name].parts[*name*].Surface
mdb.models[name].rootAssembly.Surface
SurfaceFromElsets(name: str, elementSetSeq: tuple)[source]#

This method creates a surface from a sequence of element sets in a model database.

Parameters:
name

A String specifying the repository key.

elementSetSeq

A sequence of element sets. For example,`elementSetSeq=((elset1, S1),(elset2, S2))`where elset1=mdb.models[name].rootAssembly.sets[‘Clutch’] and S1 and S2 indicate the side of the element set.

Returns:
A Surface object.

Notes

This function can be accessed by:

mdb.models[name].parts[*name*].Surface
mdb.models[name].rootAssembly.Surface