Assembly#

Features in Abaqus/CAE include Parts, Datums, Partitions, and Assembly operations. Assembly commands create Feature objects on only the rootAssembly object. The commands that create Feature objects on only the Part object are described in Part commands. The commands that create Feature objects on both the Part and the rootAssembly objects are described in Feature commands.

Create instances#

class AssemblyModel[source]#

Abaqus creates a Model object named Model-1 when a session is started.

Notes

This object can be accessed by:

mdb.models[name]

Methods

`Instance`(name, objectToCopy)	This method copies a PartInstance object from the specified model and creates a new PartInstance object.
`convertAllSketches`([regenerate, ...])	This method converts all sketches from Abaqus 6.5 or earlier to the equivalent ConstrainedSketch objects.
`linkInstances`(instancesMap)	This method links the selected PartInstance objects to the corresponding PartInstance objects from the specified models.

Instance(name: str, objectToCopy: PartInstance)[source]#

This method copies a PartInstance object from the specified model and creates a new PartInstance object.

Parameters:

name: A String specifying the repository key.
objectToCopy: A PartInstance object to be copied.

Returns:

A Model object.

Notes

This function can be accessed by:

mdb.models[name].Instance

convertAllSketches(regenerate: BooleanType = True, convertReversedSketches: BooleanType = True)[source]#

This method converts all sketches from Abaqus 6.5 or earlier to the equivalent ConstrainedSketch objects.

Parameters:

regenerate: A Boolean specifying if all the features in assembly as well as in all the parts in the model should be regenerated after the conversion. The default value is True.
convertReversedSketches: A Boolean specifying whether sketches in analytic rigid parts should be converted even if they cause the orientation of surfaces defined on them to be flipped. The default value is True.

Returns:

A python:list of strings describing any warnings or errors encountered during the conversion
process.

linkInstances(instancesMap: tuple)[source]#

This method links the selected PartInstance objects to the corresponding PartInstance objects from the specified models. If all instances of a Part are selected for linking, the Part will be linked as well. If not, a new linked child Part object will be created and added to the repository.

Parameters:

instancesMap: A tuple of tuples containing the instance name to be linked and the corresponding PartInstance object to which it will be linked.

Returns:

A python:list of strings describing any warnings or errors encountered during the conversion
process.

Object features#

Assembly#

ConnectorOrientation#

class ConnectorOrientation(region: ~abaqus.Region.Set.Set, localCsys1: ~abaqus.Datum.DatumCsys.DatumCsys = <abaqus.Datum.DatumCsys.DatumCsys object>, axis1: ~abaqusConstants.SymbolicConstantType = 'AXIS_1', angle1: float = 0, orient2sameAs1: ~abaqusConstants.BooleanType = 1, localCsys2: ~abaqus.Datum.DatumCsys.DatumCsys = <abaqus.Datum.DatumCsys.DatumCsys object>, axis2: ~abaqusConstants.SymbolicConstantType = 'AXIS_1', angle2: float = 0)[source]#

The ConnectorOrientation object is used to assign a connector orientation to a connector.

Notes

This object can be accessed by:

import assembly
mdb.models[name].rootAssembly.connectorOrientations[i]
import odbAccess
session.odbs[name].rootAssembly.connectorOrientations[i]

Methods

setValues()

This method modifies the ConnectorOrientation object.

setValues()[source]#: This method modifies the ConnectorOrientation object.

ConnectorOrientationArray#

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

Methods

findAt

Feature#

class Feature[source]#

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

Notes

This object can be accessed by:

import assembly

Methods

`AttachmentLines`(name, points, sourceFaces, ...)	This method creates a Feature object by creating attachment lines between the given set of source and target faces.
`Coaxial`(movableAxis, fixedAxis, flip)	This method moves an instance so that its selected face is coaxial with the selected face of a fixed instance.
`CoincidentPoint`(movablePoint, fixedPoint)	This method moves an instance so that a specified point is coincident with a specified point of a fixed instance.
`EdgeToEdge`(movableAxis, fixedAxis, flip, ...)	This method moves an instance so that its edge is parallel to an edge of a fixed instance.
`FaceToFace`(movablePlane, fixedPlane, flip, ...)	This method moves an instance so that its face is coincident with a face of a fixed instance.
`ParallelCsys`(movableCsys, fixedCsys)	This method moves an instance so that its Datum coordinate system is parallel to a Datum coordinate system of a fixed instance.
`ParallelEdge`(movableAxis, fixedAxis, flip)	This method moves an instance so that its edge is parallel to an edge of a fixed instance.
`ParallelFace`(movablePlane, fixedPlane, flip)	This method moves an instance so that its face is parallel to a face of a fixed instance.

static AttachmentLines(name: str, points: int, sourceFaces: tuple[Face], sourceElementFaces: tuple[MeshFace], targetFaces: tuple[Face], targetElementFaces: tuple[MeshFace], projectionMethod: SymbolicConstantType = 'PROJECT_BY_PROXIMITY', projectionDirStartPt: float | None = None, projectionDirEndPt: float | None = None, sourceToTargetProjMethod: SymbolicConstantType = 'PROJECT_BY_NUMBER', numProjections: str = '', projectionDistance: str = '', flipSourceToTargetDirection: BooleanType = 0, setName: str = '') → Feature[source]#

This method creates a Feature object by creating attachment lines between the given set of source and target faces. The given points are first projected onto the source faces using the specified projection method. The points are then projected normal to the source faces onto the target faces. The user can specify the number of projections or the length of projection vector for projection onto the target faces. The lines are then created between the source face and the closest target face. Subsequent lines are created between the target faces.

Parameters:

name: A String specifying a unique Feature name.
points: A tuple of points. Each point can be a ConstrainedSketchVertex, Datum point, Reference point, an Attachment point, orphan mesh Node, or an Interesting point object.
sourceFaces: A sequence of Face objects specifying the geometry faces onto which the points are to be projected.
sourceElementFaces: A sequence of MeshFace objects specifying the orphan mesh element faces onto which the points are to be projected.
targetFaces: A sequence of Face objects specifying the geometry faces on which the attachment lines will terminate.
targetElementFaces: A sequence of MeshFace objects specifying the orphan mesh element faces on which the attachment lines will terminate.
projectionMethod: A SymbolicConstant specifying the method to be used to project onto source faces. Possible values are PROJECT_BY_PROXIMITY and PROJECT_BY_DIRECTION. The default value is PROJECT_BY_PROXIMITY.
projectionDirStartPt: A point specifying the start point of the projection direction to project onto source faces. The point can be a ConstrainedSketchVertex, Datum point, Reference point, Attachment point, orphan mesh Node, Interesting Point object, or a tuple of Floats representing the coordinates of a point.
projectionDirEndPt: A point specifying the end point of the projection direction to project onto source faces. The point can be a ConstrainedSketchVertex, Datum point, Reference point, Attachment point, orphan mesh Node, Interesting point object, or a tuple of Floats representing the coordinates of a point.
sourceToTargetProjMethod: A SymbolicConstant specifying the method to be used to project onto target faces. Possible values are PROJECT_BY_NUMBER and PROJECT_BY_DISTANCE. The default value is PROJECT_BY_NUMBER.
numProjections: An integer specifying the maximum number of layers each point should be projected onto when the source to target projection method is PROJECT_BY_NUMBER.
projectionDistance: A float specifying the maximum distance of the projection vector when the source to target projection method is PROJECT_BY_DISTANCE.
flipSourceToTargetDirection: A Boolean specifying whether the computed projection direction from the source to the target faces should be flipped.
setName: A String specifying a unique set name.

Returns:

A Feature object.

Notes

This function can be accessed by:

mdb.models[name].rootAssembly.AttachmentLines

static Coaxial(movableAxis: str, fixedAxis: str, flip: BooleanType) → Feature[source]#

This method moves an instance so that its selected face is coaxial with the selected face of a fixed instance.

Parameters:

movableAxis: A cylindrical or conical Face on the part instance to be moved.
fixedAxis: A cylindrical or conical Face on the part instance that remains fixed.
flip: A Boolean specifying whether the axes are forward aligned (OFF) or reverse aligned (ON).

Returns:

A Feature object.

Raises:

AbaqusException.

Notes

This function can be accessed by:

mdb.models[name].rootAssembly.AttachmentLines

static CoincidentPoint(movablePoint: str, fixedPoint: str) → Feature[source]#

This method moves an instance so that a specified point is coincident with a specified point of a fixed instance.

Parameters:

movablePoint: A ConstrainedSketchVertex, a Datum point, or a ReferencePoint or a mesh node from an orphan mesh on the part instance to be moved.
fixedPoint: A ConstrainedSketchVertex, a Datum point, or a ReferencePoint or a mesh node from an orphan mesh on the part instance to remain fixed.

Returns:

feature: Feature: A Feature object

Notes

This function can be accessed by:

mdb.models[name].rootAssembly.AttachmentLines

static EdgeToEdge(movableAxis: str, fixedAxis: str, flip: BooleanType, clearance: float) → Feature[source]#

This method moves an instance so that its edge is parallel to an edge of a fixed instance.

Parameters:

movableAxis: A straight Edge, a Datum axis, or an element edge from an orphan mesh on the part instance to be moved.
fixedAxis: A straight Edge, a Datum axis, or an element edge from an orphan mesh on the part instance to remain fixed.
flip: A Boolean specifying whether the edges are forward aligned (OFF) or reverse aligned (ON).
clearance: A Float specifying the distance between the two edges (for two-dimensional and axisymmetric instances only).

Returns:

A Feature Object.

Raises:

AbaqusException.

Notes

This function can be accessed by:

mdb.models[name].rootAssembly.AttachmentLines

static FaceToFace(movablePlane: str, fixedPlane: str, flip: BooleanType, clearance: float) → Feature[source]#

This method moves an instance so that its face is coincident with a face of a fixed instance.

Parameters:

movablePlane: A planar face, a Datum plane, or a face from an orphan mesh on the part instance to be moved.
fixedPlane: A planar face, a Datum plane, or a face from an orphan mesh on the part instance to remain fixed.
flip: A Boolean specifying whether the normals to the faces are forward aligned (OFF) or reverse aligned (ON).
clearance: A Float specifying the distance between the two faces.

Returns:

A Feature Object.

Raises:

AbaqusException.

Notes

This function can be accessed by:

mdb.models[name].rootAssembly.AttachmentLines

static ParallelCsys(movableCsys: str, fixedCsys: str) → Feature[source]#

This method moves an instance so that its Datum coordinate system is parallel to a Datum coordinate system of a fixed instance.

Parameters:

movableCsys: A Datum coordinate system on the part instance to be moved.
fixedCsys: A Datum coordinate system on the part instance to remain fixed.

Returns:

A Feature object.

Raises:

AbaqusException.

Notes

This function can be accessed by:

mdb.models[name].rootAssembly.AttachmentLines

static ParallelEdge(movableAxis: str, fixedAxis: str, flip: BooleanType) → Feature[source]#

This method moves an instance so that its edge is parallel to an edge of a fixed instance.

Parameters:

movableAxis: A straight Edge, a Datum axis, or an element edge from an orphan mesh on the part instance to be moved.
fixedAxis: A straight Edge, a Datum axis, or an element edge from an orphan mesh on the part instance to remain fixed.
flip: A Boolean specifying whether the edges are forward aligned (OFF) or reverse aligned (ON).

Returns:

A Feature object.

Raises:

AbaqusException.

Notes

This function can be accessed by:

mdb.models[name].rootAssembly.AttachmentLines

static ParallelFace(movablePlane: str, fixedPlane: str, flip: BooleanType) → Feature[source]#

This method moves an instance so that its face is parallel to a face of a fixed instance.

Parameters:

movablePlane: A planar face, a Datum plane, or a face from an orphan mesh on the part instance to be moved.
fixedPlane: A planar face, a Datum plane, or a face from an orphan mesh on the part instance to remain fixed.
flip: A Boolean specifying whether the normals to the faces are forward aligned (OFF) or reverse aligned (ON).

Returns:

A Feature object.

Raises:

AbaqusException.

Notes

This function can be accessed by:

mdb.models[name].rootAssembly.AttachmentLines

ModelInstance#

PartInstance#

class PartInstance(name: str, part: Part, autoOffset: BooleanType = 0, dependent: BooleanType = 0)[source]#

A PartInstance object is an instance of a Part object.

Notes

This object can be accessed by:

import assembly
mdb.models[name].rootAssembly.allInstances[name]
mdb.models[name].rootAssembly.instances[name]

Attributes:

name: str: A String specifying the repository key. The name must be a valid Abaqus object name.
dependent: Boolean: A Boolean specifying whether the part instance is dependent or independent. If dependent=OFF, the part instance is independent. The default value is OFF.
excludedFromSimulation: Boolean: A Boolean specifying whether the part instance is excluded from the simulation. If excludedFromSimulation=ON, the part instance is excluded from the simulation. The default value is OFF.
geometryValidity: Boolean: A Boolean specifying the validity of the geometry of the instance. The value is computed, but it can be set to ON to perform feature and mesh operations on an invalid instance. There is no guarantee that such operations will work if the instance was originally invalid.
analysisType: SymbolicConstant: A SymbolicConstant specifying the part type. Possible values are DEFORMABLE_BODY, EULERIAN, DISCRETE_RIGID_SURFACE, and ANALYTIC_RIGID_SURFACE.
referenceNode: int: An Int specifying the reference node number. This member is valid only if analysisType=DISCRETE_RIGID_SURFACE or ANALYTIC_RIGID_SURFACE.
part: Part: A Part object specifying the instanced part.
sets: dict[str, Set]: A repository of Set objects specifying the sets created on the part. For more information, see [Region commands](https://help.3ds.com/2022/english/DSSIMULIA_Established/SIMACAEKERRefMap/simaker-m-RegPyc-sb.htm?ContextScope=all).
surfaces: dict[str, Surface]: A repository of Surface objects specifying the surfaces created on the part. For more information, see [Region commands](https://help.3ds.com/2022/english/DSSIMULIA_Established/SIMACAEKERRefMap/simaker-m-RegPyc-sb.htm?ContextScope=all).
skins: dict[str, Skin]: A repository of Skin objects specifying the skins created on the part. For more information, see [Region commands](https://help.3ds.com/2022/english/DSSIMULIA_Established/SIMACAEKERRefMap/simaker-m-RegPyc-sb.htm?ContextScope=all).
stringers: dict[str, Stringer]: A repository of Stringer objects specifying the stringers created on the part. For more information, see [Region commands](https://help.3ds.com/2022/english/DSSIMULIA_Established/SIMACAEKERRefMap/simaker-m-RegPyc-sb.htm?ContextScope=all).
vertices: VertexArray: A VertexArray object.
ignoredVertices: IgnoredVertexArray: An IgnoredVertexArray object.
edges: EdgeArray: An EdgeArray object.
ignoredEdges: IgnoredEdgeArray: An IgnoredEdgeArray object.
faces: FaceArray: A FaceArray object.
cells: CellArray: A CellArray object.
datums: list[Datum]: A repository of Datum objects.
elements: MeshElementArray: A MeshElementArray object.
nodes: MeshNodeArray: A MeshNodeArray object.
elemFaces: dict[str, MeshFace]: A repository of MeshFace.:py:class:~abaqus.Mesh.MeshFace.MeshFace` objects specifying all the element faces in the part instance. For a given element and a given face index within that element, the corresponding MeshFace.:py:class:~abaqus.Mesh.MeshFace.MeshFace` object can be retrieved from the repository by using the key calculated as (i*8 + j), where i and j are zero-based element and face indices, respectively.
elementFaces: MeshFaceArray: A MeshFaceArray object.
elemEdges: dict[str, MeshEdge]: A repository of MeshEdge.:py:class:~abaqus.Mesh.MeshEdge.MeshEdge` objects specifying all the element edges in the part instance. For a given element and a given edge index on a given face within that element, the corresponding MeshEdge.:py:class:~abaqus.Mesh.MeshEdge.MeshEdge` object can be retrieved from the repository by using the key calculated as (i*32 + j*4 + k), where i, j, and k are zero-based element, face, and edge indices, respectively.
elementEdges: MeshEdgeArray: A MeshEdgeArray object.
referencePoints: dict[str, ReferencePoint]: A repository of ReferencePoint objects.
partName: str: A String specifying the name of the part from which the instance was created.

Methods

`Contact`(movableList, fixedList, direction, ...)	This method translates an instance along the specified direction until it is in contact with a fixed instance.
`ConvertConstraints`()	This method converts the position constraints of an instance to absolute positions.
`InstanceFromBooleanCut`(name, ...[, ...])	This method creates a PartInstance in the instances repository after subtracting or cutting the geometries of a group of part instances from that of a base part instance.
`InstanceFromBooleanMerge`(name, instances[, ...])	This method creates a PartInstance in the instances repository after merging two or more part instances.
`LinearInstancePattern`(instanceList, number1, ...)	This method creates multiple PartInstance objects in a linear pattern and puts them into the instances repository.
`RadialInstancePattern`(instanceList, number, ...)	This method creates multiple PartInstance objects in a radial pattern and puts them into the instances repository.
`checkGeometry`([detailed, level])	This method checks the validity of the geometry of the part instance and prints a count of all topological entities on the part instance (faces, edges, vertices, etc.).
`getPosition`()	This method prints the sum of the translations and rotations applied to the PartInstance object.
`getRotation`()	This method returns a tuple including the point of rotation, axis of rotation, and rotation angle (in degrees).
`getTranslation`()	This method returns a tuple of three Floats representing translation in the X-, Y-, and Z-directions.
`replace`(instanceOf[, applyConstraints])	This method replaces one instance with an instance of another part.
`rotateAboutAxis`(axisPoint, axisDirection, angle)	This method translates an instance by the specified amount.
`translate`(vector)	This method translates an instance by the specified amount.
`translateTo`(movableList, fixedList, ...[, ...])	This method translates an instance along the specified direction until it is in contact with a fixed instance.

Contact(movableList: tuple, fixedList: tuple, direction: tuple, clearance: float, isFaceEdges: BooleanType = 0)[source]#

This method translates an instance along the specified direction until it is in contact with a fixed instance.

Parameters:

movableList: A sequence of Face or Edge objects on the part instance to be moved.
fixedList: A sequence of Face or Edge objects on the part instance to remain fixed.
direction: A sequence of three Floats specifying the direction of contact.
clearance: A Float specifying the distance between the two faces along the direction of contact.
isFaceEdges: A Boolean specifying how Abaqus calculates the contact. If isFaceEdges is OFF, contact is computed from the movable face to the fixed face. If isFaceEdges is ON, contact is computed using only the edges of the movable face and not its interior. The default value is OFF.

Returns:

feature: Feature: A Feature object

ConvertConstraints()[source]#: This method converts the position constraints of an instance to absolute positions. The method deletes the constraint features on the instance but preserves the position in space.

InstanceFromBooleanCut(name: str, instanceToBeCut: str, cuttingInstances: tuple['PartInstance'], originalInstances: SymbolicConstantType = 'SUPPRESS')[source]#

This method creates a PartInstance in the instances repository after subtracting or cutting the geometries of a group of part instances from that of a base part instance.

Parameters:

name: A String specifying the repository key. The name must be a valid Abaqus object name.
instanceToBeCut: A PartInstance specifying the base instance from which to cut other instances.
cuttingInstances: A sequence of PartInstance objects specifying the instances with which to cut the base instance.
originalInstances: A SymbolicConstant specifying whether the original instances should be suppressed or deleted after the merge operation. Possible values are SUPPRESS or DELETE. The default value is SUPPRESS.

Returns:

A PartInstance object.

Notes

This function can be accessed by:

mdb.models[name].rootAssembly.Instance

InstanceFromBooleanMerge(name: str, instances: tuple['PartInstance'], keepIntersections: BooleanType = False, originalInstances: SymbolicConstantType = 'SUPPRESS', domain: SymbolicConstantType = 'GEOMETRY', mergeNodes: SymbolicConstantType = 'BOUNDARY_ONLY', nodeMergingTolerance: float | None = None, removeDuplicateElements: BooleanType = True)[source]#

This method creates a PartInstance in the instances repository after merging two or more part instances.

Parameters:

name: A String specifying the repository key. The name must be a valid Abaqus object name.
instances: A sequence of PartInstance objects specifying the part instances to merge.
keepIntersections: A Boolean specifying whether the boundary intersections of Abaqus native part instances should be retained after the merge operation. The default value is False.
originalInstances: A SymbolicConstant specifying whether the original instances should be suppressed or deleted after the merge operation. Possible values are SUPPRESS or DELETE. The default value is SUPPRESS.
domain: A SymbolicConstant specifying whether geometry or mesh of the specified part instances is to be merged. Possible values are GEOMETRY, MESH or BOTH. The default value is GEOMETRY.
mergeNodes: A SymbolicConstant specifying which nodes of the specified part instances should be considered for merging. This argument is only applicable if domain is MESH. Possible values are BOUNDARY_ONLY, ALL, or NONE. The default value is BOUNDARY_ONLY.
nodeMergingTolerance: A Float specifying the maximum distance between nodes of the specified part instances that will be merged and replaced with a single node in the new part. The location of the new node is the average position of the deleted nodes. This argument is only applicable if domain is MESH. The default value is 10–6.
removeDuplicateElements: A Boolean specifying whether elements with the same connectivity in the new part will be merged into a single element. This argument is only applicable if domain is MESH. The default value is True.

Returns:

A PartInstance object.

Notes

This function can be accessed by:

mdb.models[name].rootAssembly.Instance

LinearInstancePattern(instanceList: tuple, number1: int, spacing1: float, number2: int, spacing2: float, direction1: tuple = (), direction2: tuple = ())[source]#

This method creates multiple PartInstance objects in a linear pattern and puts them into the instances repository.

Parameters:

instanceList: A sequence of Strings specifying the names of instances to pattern.
number1: An Int specifying the total number of instances, including the original instances, that appear along the first direction in the pattern.
spacing1: A Float specifying the spacing between instances along the first direction in the pattern.
number2: An Int specifying the total number of instances, including the original instances, that appear along the second direction in the pattern.
spacing2: A Float specifying the spacing between instances along the second direction in the pattern.
direction1: A sequence of three Floats specifying a vector along the first direction. The default value is (1.0, 0.0, 0.0).
direction2: A sequence of three Floats specifying a vector along the second direction. The default value is (0.0, 1.0, 0.0).

Returns:

A python:sequence of PartInstance objects.

Notes

This function can be accessed by:

mdb.models[name].rootAssembly.Instance

RadialInstancePattern(instanceList: tuple, number: int, totalAngle: float, point: tuple = (), axis: tuple = ())[source]#

This method creates multiple PartInstance objects in a radial pattern and puts them into the instances repository.

Parameters:

instanceList: A sequence of Strings specifying the names of instances to pattern.
number: An Int specifying the total number of instances, including the original instances, that appear in the radial pattern.
totalAngle: A Float specifying the total angle in degrees between the first and last instance in the pattern. A positive angle corresponds to a counter-clockwise direction. The values 360° and −360° represent a special case where the pattern makes a full circle. In this case, because the copy would overlay the original, the copy is not placed at the last position. Possible values are −360.0 ≤≤ totalAngle ≤≤ 360.0.
point: A sequence of three Floats specifying the center of the radial pattern. The default value is (0.0, 0.0, 0.0).
axis: A sequence of three Floats specifying the central axis of the radial pattern. The default value is (0.0, 0.0, 1.0).

Returns:

A python:sequence of PartInstance objects.

Notes

This function can be accessed by:

mdb.models[name].rootAssembly.Instance

checkGeometry(detailed: BooleanType = 0, level: int | None = None)[source]#

This method checks the validity of the geometry of the part instance and prints a count of all topological entities on the part instance (faces, edges, vertices, etc.).

Parameters:

detailed: A Boolean specifying whether detailed output will be printed to the replay file. The default value is OFF.
level: An Int specifying which level of checking is performed. Values can range from 20 to 70, with higher values reporting less and less important errors. The default value is 20, which reports all critical errors. When the default value is used, the stored validity status is updated to agree with the result of this check.

Raises:

An exception is thrown if this is a dependent part instance and level was either not

specified or was set to 20, because the validity status cannot be updated for a
dependent part instance. In this case, this command should be called on the Part
instead.: The geometry of dependent part instances cannot be changed.

getPosition()[source]#: This method prints the sum of the translations and rotations applied to the PartInstance object.

getRotation()[source]#

This method returns a tuple including the point of rotation, axis of rotation, and rotation angle (in degrees).

Returns:

A python:tuple including the point of rotation, axis of rotation, and rotation angle (in
degrees).

getTranslation()[source]#

This method returns a tuple of three Floats representing translation in the X-, Y-, and Z-directions.

Returns:

A python:tuple of three Floats representing the translation.

replace(instanceOf: Part, applyConstraints: BooleanType = True)[source]#

This method replaces one instance with an instance of another part.

Parameters:

instanceOf: A Part object specifying which Part will be instanced in place of the original Part.
applyConstraints: A Boolean specifying whether to apply existing constraints on the new instance or to position the new instance in the same place as the original instance. The default value is True. A value of False indicates that constraints applies to the instance are deleted will be deleted from the feature list.

rotateAboutAxis(axisPoint: tuple, axisDirection: tuple, angle: float)[source]#

This method translates an instance by the specified amount.

Parameters:

axisPoint: A sequence of three Floats specifying the X-, Y-, and Z-coordinates of a point on the axis.
axisDirection: A sequence of three Floats specifying the direction vector of the axis.
angle: A Float specifying the rotation angle in degrees. Use the right-hand rule to determine the direction.

translate(vector: tuple)[source]#

This method translates an instance by the specified amount.

Parameters:

vector: A sequence of three Floats specifying a translation vector.

translateTo(movableList: tuple, fixedList: tuple, direction: tuple, clearance: float, vector: tuple = ())[source]#

This method translates an instance along the specified direction until it is in contact with a fixed instance.

Parameters:

movableList: A sequence of Face or Edge objects on the part instance to be moved.
fixedList: A sequence of Face or Edge objects on the part instances to remain fixed.
direction: A sequence of three Floats specifying the direction of contact.
clearance: A Float specifying the distance between the two faces along the direction of contact.
vector: A sequence of three Floats specifying a translation vector. If this argument is specified, the movable instance will be translated by the specified amount without solving for the actual contact.

Returns:

feature: Feature: A Feature object

PartInstanceArray#

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

Methods

findAt