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.

Note

This object can be accessed by:

mdb.models[name]

Note

Check AssemblyModel on help.3ds.com/0.1..

Public 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, objectToCopy)[source]#

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

Note

This function can be accessed by:

mdb.models[name].Instance

Note

Check Instance on help.3ds.com/0.1..

Parameters:

name (str) – A String specifying the repository key.
objectToCopy (PartInstance) – A PartInstance object to be copied.

Returns:

A Model object.

Return type:

Model

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

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

Note

Check AssemblyModel.convertAllSketches on help.3ds.com/0.1..

Parameters:

regenerate (Union[AbaqusBoolean, bool], default: True) – 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 (Union[AbaqusBoolean, bool], default: True) – 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 list of strings describing any warnings or errors encountered during the conversion process.

Return type:

List[str]

linkInstances(instancesMap)[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.

Note

Check AssemblyModel.linkInstances on help.3ds.com/0.1..

Parameters:: instancesMap (tuple) – A tuple of tuples containing the instance name to be linked and the corresponding PartInstance object to which it will be linked.
Returns:: A list of strings describing any warnings or errors encountered during the conversion process.
Return type:: List[str]

Object features#

Assembly#

class Assembly[source]#

An Assembly object is a container for instances of parts. The Assembly object has no constructor command. Abaqus creates the rootAssembly member when a Model object is created.

Note

This object can be accessed by:

import assembly
mdb.models[name].rootAssembly

Note

Check Assembly on help.3ds.com/0.1..

Public Data Attributes:

Inherited from AssemblyBase

`isOutOfDate`	An Int specifying that feature parameters have been modified but that the assembly has not been regenerated.
`timeStamp`	A Float specifying which gives an indication when the assembly was last modified.
`isLocked`	An Int specifying whether the assembly is locked or not.
`regenerateConstraintsTogether`	A Boolean specifying whether the positioning constraints in the assembly should be regenerated together before regenerating other assembly features.
`vertices`	A `VertexArray` object specifying all the vertices existing at the assembly level.
`edges`	An `EdgeArray` object specifying all the edges existing at the assembly level.
`elements`	A `MeshElementArray` object specifying all the elements existing at the assembly level.
`nodes`	A `MeshNodeArray` object specifying all the nodes existing at the assembly level.
`instances`	A repository of PartInstance objects.
`datums`	A repository of Datum objects specifying all Datum objects in the assembly.
`features`	A repository of Feature objects specifying all Feature objects in the assembly.
`featuresById`	A repository of Feature objects specifying all Feature objects in the assembly.The Feature objects in the featuresById repository are the same as the Feature objects in the features repository.
`surfaces`	A repository of Surface objects specifying for more information, see [Region commands](https://help.3ds.com/2022/english/DSSIMULIA_Established/SIMACAEKERRefMap/simaker-m-RegPyc-sb.htm?ContextScope=all).
`allSurfaces`	A repository of Surface objects specifying for more information, see [Region commands](https://help.3ds.com/2022/english/DSSIMULIA_Established/SIMACAEKERRefMap/simaker-m-RegPyc-sb.htm?ContextScope=all).
`allInternalSurfaces`	A repository of Surface objects specifying picked regions.
`sets`	A repository of Set objects.
`allSets`	A repository of Set objects specifying for more information, see [Region commands](https://help.3ds.com/2022/english/DSSIMULIA_Established/SIMACAEKERRefMap/simaker-m-RegPyc-sb.htm?ContextScope=all).
`allInternalSets`	A repository of Set objects specifying picked regions.
`skins`	A repository of Skin objects specifying the skins created on the assembly.
`stringers`	A repository of Stringer objects specifying the stringers created on the assembly.
`referencePoints`	A repository of ReferencePoint objects.
`modelInstances`	A repository of ModelInstance objects.
`allInstances`	A `PartInstance` object specifying the PartInstances and A `ModelInstance` object specifying the ModelInstances.
`engineeringFeatures`	An `EngineeringFeature` object.
`modelName`	A String specifying the name of the model to which the assembly belongs.
`connectorOrientations`	A `ConnectorOrientationArray` object.
`sectionAssignments`	A `SectionAssignmentArray` object.

Inherited from Feature

`name`	A String specifying the repository key.
`id`	An Int specifying the ID of the feature.

Public Methods:

ConnectorOrientation(region[, localCsys1, ...])

This method creates a ConnectorOrientation object.

Inherited from MeshEditAssembly

`collapseMeshEdge`(edge, collapseMethod)	This method collapses an edge of a quadrilateral or triangular element of a part instance.
`combineElement`(elements)	This method combines two triangular elements of a part instance.
`deleteElement`(elements[, ...])	This method deletes the given elements from a part instance.
`projectNode`(nodes, projectionReference)	This method projects the given nodes of a part instance onto a mesh entity, geometric entity, or a datum object.
`editNode`(nodes[, coordinate1, coordinate2, ...])	This method changes the coordinates of the given nodes on a part instance.
`mergeNodes`(args, *kwargs)
`splitElement`(elements)	This method splits quadrilateral elements into triangular elements.
`splitMeshEdge`(edge[, parameter])	This method splits an edge of a quadrilateral or triangular element of a part instance.
`swapMeshEdge`(edge)	This method swaps the diagonal of two adjacent triangular elements of a part instance.
`generateMeshByOffset`(region, meshType, ...)	This method generates a solid or shell mesh from an orphan mesh surface by generating layers of elements that propagate out normal to the surface boundary.
`redoMeshEdit`()	This method executes the edit mesh or the bottom-up meshing operation most recently undone by the undoMeshEdit method on an assembly.
`undoMeshEdit`()	This method undoes the most recent edit mesh or the bottom-up meshing operation on an assembly and restores the mesh on the affected part instance to its previous state.

Inherited from MeshAssembly

`assignStackDirection`(cells, referenceRegion)	This method assigns a stack direction to geometric cells.
`associateMeshWithGeometry`(geometricEntity[, ...])	This method associates a geometric entity with mesh entities that are either orphan elements, bounds orphan elements, or were created using the bottom-up meshing technique.
`createVirtualTopology`(regions[, ...])	This method creates a virtual topology feature by automatically merging faces and edges based on a set of geometric parameters.
`deleteBoundaryLayerControls`(regions)	This method deletes the control parameters for boundary layer mesh for all the specified regions.
`deleteMesh`(regions)	This method deletes a subset of the mesh that contains the native elements from the given part instances or regions.
`deleteMeshAssociationWithGeometry`(...[, ...])	This method deletes the association of geometric entities with mesh entities.
`deletePreviewMesh`()	This method deletes all boundary meshes in the assembly.
`deleteSeeds`(regions)	This method deletes the global edge seeds from the given part instances or deletes the local edge seeds from the given edges.
`generateBottomUpExtrudedMesh`(cell, ...[, ...])	This method generates solid elements by extruding a 2D mesh along a vector, either on an orphan mesh or within a cell region using a bottom-up technique.
`generateBottomUpSweptMesh`(cell[, ...])	This method generates solid elements by sweeping a 2D mesh, either on an orphan mesh or within a cell region using a bottom-up technique.
`generateBottomUpRevolvedMesh`(cell, ...[, ...])	This method generates solid elements by revolving a 2D mesh around an axis, either on an orphan mesh or within a cell region using a bottom-up technique.
`generateMesh`([regions, ...])	This method generates a mesh in the given part instances or regions.
`getEdgeSeeds`(edge, attribute)	This method returns an edge seed parameter for a specified edge of an assembly.
`getElementType`(region, elemShape)	This method returns the ElemType object of a given element shape assigned to a region of the assembly.
`getIncompatibleMeshInterfaces`([cells])	This method returns a sequence of face objects that are meshed with incompatible elements.
`getMeshControl`(region, attribute)	This method returns a mesh control parameter for the specified region of the assembly.
`getMeshStats`(regions)	This method returns the mesh statistics for the given part instances or regions.
`getPartSeeds`(region, attribute)	This method returns a part seed parameter for the specified instance.
`getUnmeshedRegions`()	This method returns all geometric regions in the assembly that require a mesh for submitting an analysis but are either unmeshed or are meshed incompletely.
`ignoreEntity`(entities)	This method creates a virtual topology feature.
`restoreIgnoredEntity`(entities)	This method restores vertices and edges that have been merged using a virtual topology feature.
`seedEdgeByBias`(biasMethod, end1Edges, ...[, ...])	This method seeds the given edges nonuniformly using the specified number of elements and bias ratio or the specified minimum and maximum element sizes.
`seedEdgeByNumber`(edges, number[, constraint])	This method seeds the given edges uniformly based on the number of elements along the edges.
`seedEdgeBySize`(edges, size[, ...])	This method seeds the given edges either uniformly or following edge curvature distribution, based on the desired element size.
`seedPartInstance`(regions, size[, ...])	This method assigns global edge seeds to the given part instances.
`setBoundaryLayerControls`(regions, ...[, ...])	This method sets the control parameters for boundary layer mesh for the specified regions.
`setElementType`(regions, elemTypes)	This method assigns element types to the specified regions.
`setLogicalCorners`(region, corners)	This method sets the logical corners for a mappable face region.
`setMeshControls`(regions[, elemShape, ...])	This method sets the mesh control parameters for the specified regions.
`setSweepPath`(region, edge, sense)	This method sets the sweep path for a sweepable region or the revolve path for a revolvable region.
`verifyMeshQuality`(criterion[, threshold, ...])	This method tests the quality of part instance meshes and returns poor-quality elements.

Inherited from PropertyAssembly

SectionAssignment(region, sectionName[, ...])

This method creates a SectionAssignment object.

Inherited from RegionAssembly

`Surface`([side1Faces, side2Faces, ...])	This method creates a surface from a sequence of objects in a model database.
`Set`(name, args, *kwargs)

Inherited from RegionAssemblyBase

`clashSets`(arg1, arg2)	This command prints a message describing the relationship between the contents of two sets.
`deleteSets`(setNames)	This command deletes the given sets from the assembly.
`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.
`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.
`deleteSurfaces`(surfaceNames)	This command deletes the given surfaces from the assembly.

Inherited from AssemblyBase

`Instance`(name, args, *kwargs)	This method creates a PartInstance object and puts it into the instances repository.
`backup`()	This method makes a backup copy of the features in the assembly.
`clearGeometryCache`()	This method deletes the geometry cache.
`deleteAllFeatures`()	This method deletes all the features in the assembly.
`deleteFeatures`(featureNames)	This method deletes specified features from the assembly.
`excludeFromSimulation`(instances, exclude)	This method excludes the specified part instances from the analysis.
`featurelistInfo`()	This method prints the name and status of all the features in the feature lists.
`getMassProperties`([regions, ...])	This method returns the mass properties of the assembly, or instances or regions.
`getAngle`(plane1, plane2, line1, line2[, ...])	This method returns the angle between the specified entities.
`getCoordinates`(entity)	This method returns the coordinates of a specified point.
`getDistance`(entity1, entity2[, ...])	Depending on the arguments provided, this method returns one of the following:
`getFacesAndVerticesOfAttachmentLines`(edges)	Given an array of edge objects, this method returns a tuple of dictionary objects.
`getSurfaceSections`(surface)	This method returns a list of the sections assigned to the regions encompassed by the specified surface.
`importEafFile`(filename[, ids])	This method imports an assembly from an EAF file into the root assembly.
`importParasolidFile`(filename[, ids])	This method imports an assembly from the Parasolid file into the root assembly.
`importCatiaV5File`(filename[, ids])	This method imports an assembly from a CATIA V5 Elysium Neutral file into the root assembly.
`importEnfFile`(filename[, ids])	This method imports an assembly from an Elysium Neutral file created by Pro/ENGINEER, I-DEAS, or CATIA V5 into the root assembly.
`importIdeasFile`(filename[, ids])	This method imports an assembly from an I-DEAS Elysium Neutral file into the root assembly.
`importProEFile`(filename[, ids])	This method imports an assembly from a Pro/ENGINEER Elysium Neutral file into the root assembly.
`makeDependent`(instances)	This method converts the specified part instances from independent to dependent part instances.
`makeIndependent`(instances)	This method converts the specified part instances from dependent to independent part instances.
`printAssignedSections`()	This method prints a summary of assigned connector sections.
`printConnectorOrientations`()	This method prints a summary of connector orientations.
`projectReferencesOntoSketch`(sketch[, ...])	This method projects the specified edges, vertices, and datum points from the assembly onto the specified ConstrainedSketch object.
`queryCachedStates`()	This method displays the position of geometric states relative to the sequence of features in the assembly cache.
`regenerate`()	This method regenerates the assembly and brings it up to date with the latest values of the assembly parameters.
`regenerationWarnings`()	This method prints any regeneration warnings associated with the features.
`restore`()	This method restores the parameters of all features in the assembly to the value they had before a failed regeneration.
`resumeAllFeatures`()	This method resumes all the suppressed features in the part or assembly.
`resumeFeatures`(featureNames)	This method resumes the specified suppressed features in the assembly.
`resumeLastSetFeatures`()	This method resumes the last set of features to be suppressed in the assembly.
`rotate`(instanceList, axisPoint, ...)	This method rotates given instances by the specified amount.
`translate`(instanceList, vector)	This method translates given instances by the specified amount.
`saveGeometryCache`()	This method caches the current geometry, which improves regeneration performance.
`setValues`(regenerateConstraintsTogether)	This method modifies the behavior associated with the specified assembly.
`suppressFeatures`(featureNames)	This method suppresses specified features.
`unlinkInstances`(instances)	This method converts the specified PartInstance objects from linked child instances to regular instances.
`writeAcisFile`(fileName[, version])	This method exports the assembly to a named file in ACIS part (SAT) or assembly (ASAT) format.
`writeCADParameters`(paramFile[, ...])	This method writes the parameters that were imported from the CAD system to a parameter file.
`lock`()	This method locks the assembly.
`unlock`()	This method unlocks the assembly.
`setMeshNumberingControl`(instances[, ...])	This method changes the start node and/or element labels on the specified independent part instances before or after Abaqus/CAE generates the meshes.
`copyMeshPattern`([elements, faces, ...])	This method copies a mesh pattern from a source region consisting of a set of shell elements or element faces onto a target face, mapping nodes and elements in a one-one correspondence between source and target.
`smoothNodes`([nodes])	This method smooths the given nodes of a native mesh, moving them locally to a more optimal location that improves the quality of the mesh

Inherited from AssemblyFeature

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

Inherited from Feature

`AttachmentPoints`(name, points[, ...])	This method creates an attachment points Feature.
`AttachmentPointsAlongDirection`(name, ...[, ...])	This method creates a Feature object by creating attachment points along a direction or between two points.
`AttachmentPointsOffsetFromEdges`(name, edges)	This method creates a Feature object by creating attachment points along or offset from one or more connected edges.
`DatumAxisByCylFace`(face)	This method creates a Feature object and a DatumAxis object along the axis of a cylinder or cone.
`DatumAxisByNormalToPlane`(plane, point)	This method creates a Feature object and a DatumAxis object normal to the specified plane and passing through the specified point.
`DatumAxisByParToEdge`(edge, point)	This method creates a Feature object and a DatumAxis object parallel to the specified edge and passing through the specified point.
`DatumAxisByPrincipalAxis`(principalAxis)	This method creates a Feature object and a DatumAxis object along one of the three principal axes.
`DatumAxisByRotation`(args, *kwargs)
`DatumAxisByThreePoint`(point1, point2, point3)	This method creates a Feature object and a DatumAxis object normal to the circle described by three points and through its center.
`DatumAxisByThruEdge`(edge)	This method creates a Feature object and a DatumAxis object along the specified edge.
`DatumAxisByTwoPlane`(plane1, plane2)	This method creates a Feature object and a DatumAxis object at the intersection of two planes.
`DatumAxisByTwoPoint`(point1, point2)	This method creates a Feature object and a DatumAxis object along the line joining two points.
`DatumCsysByDefault`(coordSysType[, name])	This method creates a Feature object and a DatumCsys object from the specified default coordinate system at the origin.
`DatumCsysByOffset`(coordSysType, ...[, name])	This method creates a Feature object and a DatumCsys object by offsetting the origin of an existing datum coordinate system to a specified point.
`DatumCsysByThreePoints`(coordSysType, origin, ...)	This method creates a Feature object and a DatumCsys object from three points.
`DatumCsysByTwoLines`(coordSysType, line1, line2)	This method creates a Feature object and a DatumCsys object from two orthogonal lines.
`DatumPlaneByPrincipalPlane`(principalPlane, ...)	This method creates a Feature object and a DatumPlane object through the origin along one of the three principal planes.
`DatumPlaneByOffset`(args, *kwargs)
`DatumPlaneByRotation`(plane, axis, angle)	This method creates a Feature object and a DatumPlane object by rotating a plane about the specified axis through the specified angle.
`DatumPlaneByThreePoints`(point1, point2, point3)	This method creates a Feature object and a DatumPlane object defined by passing through three points.
`DatumPlaneByLinePoint`(line, point)	This method creates a Feature object and a DatumPlane object that pass through the specified line and through the specified point that does not lie on the line.
`DatumPlaneByPointNormal`(point, normal)	This method creates a Feature object and a DatumPlane object normal to the specified line and running through the specified point.
`DatumPlaneByTwoPoint`(point1, point2)	This method creates a Feature object and a DatumPlane object midway between two points and normal to the line connecting the points.
`DatumPointByCoordinate`(coords)	This method creates a Feature object and a DatumPoint object at the point defined by the specified coordinates.
`DatumPointByOffset`(point, vector)	This method creates a Feature object and a DatumPoint object offset from an existing point by a vector.
`DatumPointByMidPoint`(point1, point2)	This method creates a Feature object and a DatumPoint object midway between two points.
`DatumPointByOnFace`(face, edge1, offset1, ...)	This method creates a Feature object and a DatumPoint object on the specified face, offset from two edges.
`DatumPointByEdgeParam`(edge, parameter)	This method creates a Feature object and a DatumPoint object along an edge at a selected distance from one end of the edge.
`DatumPointByProjOnEdge`(point, edge)	This method creates a Feature object and a DatumPoint object along an edge by projecting an existing point along the normal to the edge.
`DatumPointByProjOnFace`(point, face)	This method creates a Feature object and a DatumPoint object on a specified face by projecting an existing point onto the face.
`MakeSketchTransform`(sketchPlane[, origin, ...])	This method creates a Transform object.
`PartitionCellByDatumPlane`(cells, datumPlane)	This method partitions one or more cells using the given datum plane.
`PartitionCellByExtendFace`(cells, extendFace)	This method partitions one or more cells by extending the underlying geometry of a given face to partition the target cells.
`PartitionCellByExtrudeEdge`(cells, edges, ...)	This method partitions one or more cells by extruding selected edges in the given direction.
`PartitionCellByPatchNCorners`(cell, cornerPoints)	This method partitions a cell using an N-sided cutting patch defined by the given corner points.
`PartitionCellByPatchNEdges`(cell, edges)	This method partitions a cell using an N-sided cutting patch defined by the given edges.
`PartitionCellByPlaneNormalToEdge`(cells, ...)	This method partitions one or more cells using a plane normal to an edge at the given edge point.
`PartitionCellByPlanePointNormal`(cells, ...)	This method partitions one or more cells using a plane defined by a point and a normal direction.
`PartitionCellByPlaneThreePoints`(cells, ...)	This method partitions one or more cells using a plane defined by three points.
`PartitionCellBySweepEdge`(cells, edges, sweepPath)	This method partitions one or more cells by sweeping selected edges along the given sweep path.
`PartitionEdgeByDatumPlane`(edges, datumPlane)	This method partitions an edge where it intersects with a datum plane.
`PartitionEdgeByParam`(edges, parameter)	This method partitions one or more edges at the given normalized edge parameter.
`PartitionEdgeByPoint`(edge, point)	This method partitions an edge at the given point.
`PartitionFaceByAuto`(face)	This method automatically partitions a target face into simple regions that can be meshed using a structured meshing technique.
`PartitionFaceByCurvedPathEdgeParams`(face, ...)	This method partitions a face normal to two edges, using a curved path between the two given edge points defined by the normalized edge parameters.
`PartitionFaceByCurvedPathEdgePoints`(face, ...)	This method partitions a face normal to two edges, using a curved path between the two given edge points.
`PartitionFaceByDatumPlane`(faces, datumPlane)	This method partitions one or more faces using the given datum plane.
`PartitionFaceByExtendFace`(faces, extendFace)	This method partitions one or more faces by extending the underlying geometry of another given face to partition the target faces.
`PartitionFaceByIntersectFace`(faces, cuttingFaces)	This method partitions one or more faces using the given cutting faces to partition the target faces.
`PartitionFaceByProjectingEdges`(faces, edges)	This method partitions one or more faces by projecting the given edges on the target faces.
`PartitionFaceByShortestPath`(faces, point1, ...)	This method partitions one or more faces using a minimum distance path between the two given points.
`PartitionFaceBySketch`(faces, sketch[, ...])	This method partitions one or more planar faces by sketching on them.
`PartitionFaceBySketchDistance`(faces, ...[, ...])	This method partitions one or more faces by sketching on a sketch plane and then projecting the sketch toward the target faces through the given distance.
`PartitionFaceBySketchRefPoint`(faces, ...[, ...])	This method partitions one or more faces by sketching on a sketch plane and then projecting the sketch toward the target faces through a distance governed by the reference point.
`PartitionFaceBySketchThruAll`(faces, ...[, ...])	This method partitions one or more faces by sketching on a sketch plane and then projecting toward the target faces through an infinite distance.
`ReferencePoint`(point[, instanceName])	This method creates a Feature object and a ReferencePoint object at the specified location.
`RemoveWireEdges`(wireEdgeList)	This method removes wire edges.
`WirePolyLine`(points[, mergeType, meshable])	This method creates an additional Feature object by creating a series of wires joining points in pairs.
`isSuppressed`()	This method queries the suppressed state of the feature.
`restore`()	This method restores the parameters of all features in the assembly to the value they had before a failed regeneration.
`resume`()	This method resumes suppressed features.
`setValues`(regenerateConstraintsTogether)	This method modifies the behavior associated with the specified assembly.
`suppress`()	This method suppresses features.

static AttachmentLines(name, points, sourceFaces, sourceElementFaces, targetFaces, targetElementFaces, projectionMethod=abaqusConstants.PROJECT_BY_PROXIMITY, projectionDirStartPt=None, projectionDirEndPt=None, sourceToTargetProjMethod=abaqusConstants.PROJECT_BY_NUMBER, numProjections='', projectionDistance='', flipSourceToTargetDirection=OFF, setName='')[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.

Note

This function can be accessed by:

mdb.models[name].rootAssembly.AttachmentLines

Note

Check AttachmentLines on help.3ds.com/0.1..

Parameters:

name (str) – A String specifying a unique Feature name.
points (int) – 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 (Tuple[Face, ...]) – A sequence of Face objects specifying the geometry faces onto which the points are to be projected.
sourceElementFaces (Tuple[MeshFace, ...]) – A sequence of MeshFace objects specifying the orphan mesh element faces onto which the points are to be projected.
targetFaces (Tuple[Face, ...]) – A sequence of Face objects specifying the geometry faces on which the attachment lines will terminate.
targetElementFaces (Tuple[MeshFace, ...]) – A sequence of MeshFace objects specifying the orphan mesh element faces on which the attachment lines will terminate.
projectionMethod (SymbolicConstant, default: PROJECT_BY_PROXIMITY) – 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 (Optional[float], default: None) – 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 (Optional[float], default: None) – 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 (SymbolicConstant, default: PROJECT_BY_NUMBER) – 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 (str, default: '') – 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 (str, default: '') – A float specifying the maximum distance of the projection vector when the source to target projection method is PROJECT_BY_DISTANCE.
flipSourceToTargetDirection (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the computed projection direction from the source to the target faces should be flipped.
setName (str, default: '') – A String specifying a unique set name.

Returns:

A Feature object.

Return type:

AssemblyFeature

AttachmentPoints(name, points, projectionMethod=abaqusConstants.PROJECT_BY_PROXIMITY, projectOnFaces=(), projectOnElementFaces=(), projectionDirStartPt=None, projectionDirEndPt=None, setName='')[source]#

This method creates an attachment points Feature. Attachment points may be created using datum points, vertices, reference points, attachment points, interesting points, orphan mesh nodes or coordinates. Optionally, the attachment points can be projected on geometric faces or element faces.

Note

This function can be accessed by:

mdb.models[name].parts[name].AttachmentPoints
mdb.models[name].rootAssembly.AttachmentPoints

Note

Check AttachmentPoints on help.3ds.com/0.1..

Parameters:

name (str) – A String specifying a unique Feature name.
points (float) – A tuple of points. Each 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.
projectionMethod (Literal[PROJECT_BY_PROXIMITY, PROJECT_BY_DIRECTION], default: PROJECT_BY_PROXIMITY) – A SymbolicConstant specifying the projection method. Possible values are PROJECT_BY_PROXIMITY and PROJECT_BY_DIRECTION. The default value is PROJECT_BY_PROXIMITY.
projectOnFaces (Tuple[Face, ...], default: ()) – A sequence of Face objects specifying the geometry faces onto which the points are to be projected.
projectOnElementFaces (Tuple[MeshFace, ...], default: ()) – A sequence of MeshFace objects specifying the orphan mesh element faces onto which the points are to be projected.
projectionDirStartPt (Optional[float], default: None) – A point specifying the start point of the projection direction. 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 (Optional[float], default: None) – A point specifying the end point of the projection direction. 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.
setName (str, default: '') – A String specifying a unique set name.

Returns:

feature – A Feature object

Return type:

Feature

AttachmentPointsAlongDirection(name, startPoint, pointCreationMethod, endPoint=None, direction='', spacing='', numPtsAlongDir='', numPtsBetweenPts='', createPtAtStartPt=True, createPtAtEndPt=True, projectionMethod=abaqusConstants.PROJECT_BY_PROXIMITY, projectOnFaces=(), projectOnElementFaces=(), projectionDirStartPt=None, projectionDirEndPt=None, flipDirection=OFF, setName='')[source]#

This method creates a Feature object by creating attachment points along a direction or between two points. A Datum point, a ConstrainedSketchVertex, a Reference point, an Attachment point, an Interesting point, or an orphan mesh Node can be specified as the start or end point. The direction can be specified using a straight edge or a datum axis.

Note

This function can be accessed by:

mdb.models[name].parts[name].AttachmentPoints
mdb.models[name].rootAssembly.AttachmentPoints

Note

Check AttachmentPointsAlongDirection on help.3ds.com/0.1..

Parameters:

name (str) – A String specifying a unique Feature name.
startPoint (float) – A point specifying the start point of the direction along which to create points. 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.
pointCreationMethod (Literal[AUTO_FIT, NUM_PTS_ALONG_DIR, NUM_PTS_BETWEEN_PTS]) – A SymbolicConstant specifying the point creation method. Possible values are AUTO_FIT, NUM_PTS_ALONG_DIR, and NUM_PTS_BETWEEN_PTS.
endPoint (Optional[float], default: None) – A point specifying the end point if creating points between two points. 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.
direction (str, default: '') – The direction can be specified by a straight edge or a datum axis.
spacing (str, default: '') – A float specifying the spacing to be used between two points.
numPtsAlongDir (str, default: '') – An integer specifying the number of points to be created along the specified direction.
numPtsBetweenPts (str, default: '') – An integer specifying the number of points to be created between the start and end points.
createPtAtStartPt (Union[AbaqusBoolean, bool], default: True) – A Boolean specifying whether to create an attachment point at the start point. The default value is True.
createPtAtEndPt (Union[AbaqusBoolean, bool], default: True) – A Boolean specifying whether to create an attachment point at the end point. The default value is True.
projectionMethod (Literal[PROJECT_BY_PROXIMITY, PROJECT_BY_DIRECTION], default: PROJECT_BY_PROXIMITY) – A SymbolicConstant specifying the projection method. Possible values are PROJECT_BY_PROXIMITY and PROJECT_BY_DIRECTION. The default value is PROJECT_BY_PROXIMITY.
projectOnFaces (Tuple[Face, ...], default: ()) – A sequence of Face objects specifying the geometry faces onto which the points are to be projected.
projectOnElementFaces (Tuple[MeshFace, ...], default: ()) – A sequence of MeshFace objects specifying the orphan mesh element faces onto which the points are to be projected.
projectionDirStartPt (Optional[float], default: None) – A point specifying the start point of the projection direction. 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 (Optional[float], default: None) – A point specifying the end point of the projection direction. 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.
flipDirection (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying if the direction along which the attachment points are created should be reversed. This argument is valid only when pointCreationMethod = NUM_PTS_ALONG_DIR.
setName (str, default: '') – A String specifying a unique set name.

Returns:

feature – A Feature object

Return type:

Feature

AttachmentPointsOffsetFromEdges(name, edges, startPoint='', flipDirection='', pointCreationMethod=Ellipsis, numberOfPoints='', spacingBetweenPoints='', offsetFromStartPoint=0, offsetFromEndPoint=0, spacingMethod=abaqusConstants.AUTO_FIT_PTS, patterningMethod=Ellipsis, referenceFace='', startPointForPatternDirection=Ellipsis, endPointForPatternDirection=Ellipsis, offsetFromEdges='', numberOfRows=1, spacingBetweenRows='', projectionMethod=abaqusConstants.PROJECT_BY_PROXIMITY, projectOnFaces=(), projectOnElementFaces=(), projectionDirStartPt=Ellipsis, projectionDirEndPt=Ellipsis, setName='')[source]#

This method creates a Feature object by creating attachment points along or offset from one or more connected edges.

Note

This function can be accessed by:

mdb.models[name].parts[name].AttachmentPoints
mdb.models[name].rootAssembly.AttachmentPoints

Note

Check AttachmentPointsOffsetFromEdges on help.3ds.com/0.1..

Parameters:

name (str) – A String specifying a unique Feature name.
edges (tuple) – A sequence of connected Edge objects specifying the geometry edges from which to offset the points.
startPoint (str, default: '') – A ConstrainedSketchVertex of the selected edges that specifies the point from which to create points. This point can be one of the two end vertices of the connected edges. In case of edges forming a closed loop and having multiple vertices, this point can be any one of the vertices on the edges.
flipDirection (str, default: '') – This parameter is required to indicate the direction in which to create the points. This parameter is required only in case of edges forming a closed loop.
pointCreationMethod (Literal[BY_NUMBER, BY_SPACING], default: Ellipsis) – A SymbolicConstant specifying the point creation method. Possible values are BY_NUMBER or BY_SPACING.
numberOfPoints (str, default: '') – An integer specifying the number of points to be created along the selected edges.
spacingBetweenPoints (str, default: '') – A float specifying the spacing to be used between two points while creating the points between the start and end points of the edges.
offsetFromStartPoint (float, default: 0) – A float specifying the distance by which to offset the first point from the start vertex of the edge chain. The default value is 0.0.
offsetFromEndPoint (float, default: 0) – A float specifying the distance by which to offset the last point from the end vertex of the edge chain. This parameter should be specified only if the point creation method is BY_NUMBER. The default value is 0.0.
spacingMethod (Literal[AUTO_FIT_PTS, SPECIFY_NUM_PTS], default: AUTO_FIT_PTS) – A SymbolicConstant specifying the spacing method. Possible values are AUTO_FIT_PTS or SPECIFY_NUM_PTS. The default value is AUTO_FIT_PTS.
patterningMethod (Literal[PATTERN_ORTHOGONALLY, PATTERN_ALONG_DIRECTION], default: Ellipsis) – A SymbolicConstant specifying the method to pattern of points. Possible values are PATTERN_ORTHOGONALLY or PATTERN_ALONG_DIRECTION.
referenceFace (str, default: '') – A geometry Face object adjacent to one of the edges from which to offset the points to create a pattern of points when the PATTERN_ORTHOGONALLY method is chosen for patterning. The face is used to identify the patterning direction. If the number of rows is one and the initial offset is zero, the reference face may not be specified.
startPointForPatternDirection (Tuple[float, ...], default: Ellipsis) – A point specifying the start point of the direction along which to create a pattern of points when the PATTERN_ALONG_DIRECTION method is chosen for patterning. 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.
endPointForPatternDirection (Tuple[float, ...], default: Ellipsis) – A point specifying the end point of the direction along which to create a pattern of points when the PATTERN_ALONG_DIRECTION method is chosen for patterning. 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.
offsetFromEdges (str, default: '') – A float specifying the distance by which to offset the first row of points from the edges.
numberOfRows (int, default: 1) – An integer specifying the number of rows of points to be created for the pattern. The default value is 1.
spacingBetweenRows (str, default: '') – A float specifying the spacing to be used between two rows while creating a pattern of points.
projectionMethod (Literal[PROJECT_BY_PROXIMITY, PROJECT_BY_DIRECTION], default: PROJECT_BY_PROXIMITY) – A SymbolicConstant specifying the projection method. Possible values are PROJECT_BY_PROXIMITY and PROJECT_BY_DIRECTION. The default value is PROJECT_BY_PROXIMITY.
projectOnFaces (Tuple[Face, ...], default: ()) – A sequence of Face objects specifying the geometry faces onto which the points are to be projected.
projectOnElementFaces (Tuple[MeshFace, ...], default: ()) – A sequence of MeshFace objects specifying the orphan mesh element faces onto which the points are to be projected.
projectionDirStartPt (Tuple[float, ...], default: Ellipsis) – A point specifying the start point of the projection direction. 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 (Tuple[float, ...], default: Ellipsis) – A point specifying the end point of the projection direction. 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.
setName (str, default: '') – A String specifying a unique set name.

Returns:

feature – A Feature object

Return type:

Feature

static Coaxial(movableAxis, fixedAxis, flip)[source]#

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

Note

This function can be accessed by:

mdb.models[name].rootAssembly.AttachmentLines

Note

Check Coaxial on help.3ds.com/0.1..

Parameters:

movableAxis (str) – A cylindrical or conical Face on the part instance to be moved.
fixedAxis (str) – A cylindrical or conical Face on the part instance that remains fixed.
flip (Union[AbaqusBoolean, bool]) – A Boolean specifying whether the axes are forward aligned (OFF) or reverse aligned (ON).

Returns:

A Feature object.

Return type:

AssemblyFeature

Raises:

AbaqusException –

static CoincidentPoint(movablePoint, fixedPoint)[source]#

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

Note

This function can be accessed by:

mdb.models[name].rootAssembly.AttachmentLines

Note

Check CoincidentPoint on help.3ds.com/0.1..

Parameters:

movablePoint (str) – A ConstrainedSketchVertex, a Datum point, or a ReferencePoint or a mesh node from an orphan mesh on the part instance to be moved.
fixedPoint (str) – 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 – A Feature object

Return type:

AssemblyFeature

ConnectorOrientation(region, localCsys1=None, axis1=abaqusConstants.AXIS_1, angle1=0, orient2sameAs1=ON, localCsys2=None, axis2=abaqusConstants.AXIS_1, angle2=0)[source]#

This method creates a ConnectorOrientation object.

Note

This function can be accessed by:

mdb.models[name].rootAssembly.ConnectorOrientation
session.odbs[name].rootAssembly.ConnectorOrientation

Note

Check ConnectorOrientation on help.3ds.com/0.1..

Parameters:

region (Set) – A Set object specifying the region to which the orientation is assigned.
localCsys1 (Optional[DatumCsys], default: None) – A DatumCsys object specifying the local coordinate system of the first connector point. This value may be None, indicating the global coordinate system.
axis1 (SymbolicConstant, default: AXIS_1) – A SymbolicConstant specifying the axis of a datum coordinate system about which an additional rotation is applied. Possible values are AXIS_1, AXIS_2, and AXIS_3. The default value is AXIS_1.
angle1 (float, default: 0) – A Float specifying the angle of the additional rotation. The default value is 0.0.
orient2sameAs1 (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether or not the second connector point is to use the same local coordinate system, axis, and angle as the first point. The default value is ON.
localCsys2 (Optional[DatumCsys], default: None) – A DatumCsys object specifying the local coordinate system of the second connector point. This value may be None, indicating the global coordinate system.
axis2 (SymbolicConstant, default: AXIS_1) – A SymbolicConstant specifying the axis of a datum coordinate system about which an additional rotation is applied. Possible values are AXIS_1, AXIS_2, and AXIS_3. The default value is AXIS_1.
angle2 (float, default: 0) – A Float specifying the angle of the additional rotation. The default value is 0.0.

Returns:

A ConnectorOrientation object.

Return type:

ConnectorOrientation

DatumAxisByCylFace(face)[source]#

This method creates a Feature object and a DatumAxis object along the axis of a cylinder or cone.

Note

This function can be accessed by:

mdb.models[name].parts[name].AttachmentPoints
mdb.models[name].rootAssembly.AttachmentPoints

Note

Check DatumAxisByCylFace on help.3ds.com/0.1..

Parameters:: face (str) – A cylindrical or conical Face object.
Returns:: A Feature object.
Return type:: Feature
Raises:: AbaqusException –

DatumAxisByNormalToPlane(plane, point)[source]#

This method creates a Feature object and a DatumAxis object normal to the specified plane and passing through the specified point.

Note

This function can be accessed by:

mdb.models[name].parts[name].AttachmentPoints
mdb.models[name].rootAssembly.AttachmentPoints

Note

Check DatumAxisByNormalToPlane on help.3ds.com/0.1..

Parameters:

plane (str) – A planar Face, an ElementFace, or a Datum object representing a datum plane.
point (int) – A ConstrainedSketchVertex, an InterestingPoint, a MeshNode, or a Datum object representing a datum point.

Returns:

A Feature object.

Return type:

Feature

Raises:

AbaqusException –

DatumAxisByParToEdge(edge, point)[source]#

This method creates a Feature object and a DatumAxis object parallel to the specified edge and passing through the specified point.

Note

This function can be accessed by:

mdb.models[name].parts[name].AttachmentPoints
mdb.models[name].rootAssembly.AttachmentPoints

Note

Check DatumAxisByParToEdge on help.3ds.com/0.1..

Parameters:

edge (str) – A straight Edge, an ElementEdge, or a Datum object representing a datum axis.
point (int) – A ConstrainedSketchVertex, an InterestingPoint, a MeshNode, or a Datum object representing a datum point.

Returns:

A Feature object.

Return type:

Feature

Raises:

AbaqusException –

DatumAxisByPrincipalAxis(principalAxis)[source]#

This method creates a Feature object and a DatumAxis object along one of the three principal axes.

Note

This function can be accessed by:

mdb.models[name].parts[name].AttachmentPoints
mdb.models[name].rootAssembly.AttachmentPoints

Note

Check DatumAxisByPrincipalAxis on help.3ds.com/0.1..

Parameters:: principalAxis (Literal[XAXIS, YAXIS, ZAXIS]) – A SymbolicConstant specifying the principal axis. Possible values are XAXIS, YAXIS, and ZAXIS.
Returns:: A Feature object.
Return type:: Feature
Raises:: AbaqusException –

DatumAxisByRotation(*args, **kwargs)[source]#

DatumAxisByThreePoint(point1, point2, point3)[source]#

This method creates a Feature object and a DatumAxis object normal to the circle described by three points and through its center.

Note

This function can be accessed by:

mdb.models[name].parts[name].AttachmentPoints
mdb.models[name].rootAssembly.AttachmentPoints

Parameters:

point1 (int) – A ConstrainedSketchVertex, an InterestingPoint, a MeshNode, or a Datum object representing a datum point specifying the first point on the circle.
point2 (int) – A ConstrainedSketchVertex, an InterestingPoint, a MeshNode, or a Datum object representing a datum point specifying the second point on the circle.
point3 (int) – A ConstrainedSketchVertex, an InterestingPoint, a MeshNode, or a Datum object representing a datum point specifying the third point on the circle.

Returns:

A Feature object.

Return type:

Feature

Raises:

AbaqusException –

DatumAxisByThruEdge(edge)[source]#

This method creates a Feature object and a DatumAxis object along the specified edge.

Note

This function can be accessed by:

mdb.models[name].parts[name].AttachmentPoints
mdb.models[name].rootAssembly.AttachmentPoints

Note

Check DatumAxisByThruEdge on help.3ds.com/0.1..

Parameters:: edge (str) – A straight Edge or an ElementEdge object.
Returns:: A Feature object.
Return type:: Feature
Raises:: AbaqusException –

DatumAxisByTwoPlane(plane1, plane2)[source]#

This method creates a Feature object and a DatumAxis object at the intersection of two planes.

Note

This function can be accessed by:

mdb.models[name].parts[name].AttachmentPoints
mdb.models[name].rootAssembly.AttachmentPoints

Note

Check DatumAxisByTwoPlane on help.3ds.com/0.1..

Parameters:

plane1 (str) – A planar Face, an ElementFace, or a Datum object representing a datum plane.
plane2 (str) – A planar Face, an ElementFace, or a Datum object representing a datum plane.

Returns:

A Feature object.

Return type:

Feature

Raises:

AbaqusException –

DatumAxisByTwoPoint(point1, point2)[source]#

This method creates a Feature object and a DatumAxis object along the line joining two points.

Note

This function can be accessed by:

mdb.models[name].parts[name].AttachmentPoints
mdb.models[name].rootAssembly.AttachmentPoints

Note

Check DatumAxisByTwoPoint on help.3ds.com/0.1..

Parameters:

point1 (int) – A ConstrainedSketchVertex, an InterestingPoint, a MeshNode, or a Datum object representing a datum point.
point2 (int) – A ConstrainedSketchVertex, an InterestingPoint, a MeshNode, or a Datum object representing a datum point.

Returns:

A Feature object.

Return type:

Feature

Raises:

AbaqusException –

DatumCsysByDefault(coordSysType, name='')[source]#

This method creates a Feature object and a DatumCsys object from the specified default coordinate system at the origin.

Note

This function can be accessed by:

mdb.models[name].parts[name].AttachmentPoints
mdb.models[name].rootAssembly.AttachmentPoints

Note

Check DatumCsysByDefault on help.3ds.com/0.1..

Parameters:

coordSysType (Literal[CARTESIAN, CYLINDRICAL, SPHERICAL]) – A SymbolicConstant specifying the default coordinate system to be used. Possible values are CARTESIAN, CYLINDRICAL, and SPHERICAL.
name (str, default: '') – A String specifying the name of the DatumCsys.

Returns:

A Feature object.

Return type:

Feature

Raises:

AbaqusException –

DatumCsysByOffset(coordSysType, datumCoordSys, vector, point, name='')[source]#

This method creates a Feature object and a DatumCsys object by offsetting the origin of an existing datum coordinate system to a specified point.

Note

This function can be accessed by:

mdb.models[name].parts[name].AttachmentPoints
mdb.models[name].rootAssembly.AttachmentPoints

Note

Check DatumCsysByOffset on help.3ds.com/0.1..

Parameters:

coordSysType (Literal[CARTESIAN, CYLINDRICAL, SPHERICAL]) – A SymbolicConstant specifying the type of coordinate system. Possible values are CARTESIAN, CYLINDRICAL, and SPHERICAL.
datumCoordSys (Datum) – A Datum object representing a datum coordinate system from which to offset.
vector (tuple) – A sequence of three Floats specifying the X-, Y-, and Z-offsets from datumCoordSys. The arguments vector and point are mutually exclusive, and one of them must be specified.
point (str) – A ConstrainedSketchVertex, InterestingPoint, DatumPoint object or a sequence of three Floats specifying the X-, Y-, and Z-coordinates of a point in space. The point represents the origin of the new datum coordinate system. The arguments vector and point are mutually exclusive, and one of them must be specified.
name (str, default: '') – A String specifying the name of the DatumCsys.

Returns:

A Feature object.

Return type:

Feature

Raises:

AbaqusException –

DatumCsysByThreePoints(coordSysType, origin, point1, point2, line1, line2, name='')[source]#

This method creates a Feature object and a DatumCsys object from three points.

Note

This function can be accessed by:

mdb.models[name].parts[name].AttachmentPoints
mdb.models[name].rootAssembly.AttachmentPoints

Note

Check DatumCsysByThreePoints on help.3ds.com/0.1..

Parameters:

coordSysType (Literal[CARTESIAN, CYLINDRICAL, SPHERICAL]) – A SymbolicConstant specifying the type of coordinate system. Possible values are CARTESIAN, CYLINDRICAL, and SPHERICAL.
origin (int) – A ConstrainedSketchVertex, an InterestingPoint, a MeshNode, or a Datum object representing a datum point specifying the origin of the coordinate system.
point1 (int) – A ConstrainedSketchVertex, an InterestingPoint, a MeshNode, or a Datum object representing a datum point specifying a point on the X-axis or the rr-axis. The point1 and line1 arguments are mutually exclusive. One of them must be specified.
point2 (int) – A ConstrainedSketchVertex, an InterestingPoint, a MeshNode, or a Datum object representing a datum point specifying a point in the X - Y plane or the rr-θθ plane. The point2 and line2 arguments are mutually exclusive. One of them must be specified.
line1 (str) – An Edge, an Element Edge, or a Datum object representing a datum axis specifying the X-axis or the rr-axis. The point1 and line1 arguments are mutually exclusive. One of them must be specified.
line2 (str) – An Edge, an Element Edge, or a Datum object representing a datum axis specifying a vector in the X - Y plane or the rr-θθ plane. The point2 and line2 arguments are mutually exclusive. One of them must be specified.
name (str, default: '') – A String specifying the name of the DatumCsys.

Returns:

A Feature object.

Return type:

Feature

Raises:

AbaqusException –

DatumCsysByTwoLines(coordSysType, line1, line2, name='')[source]#

This method creates a Feature object and a DatumCsys object from two orthogonal lines. The origin of the new datum coordinate system is placed at the intersection of the two lines.

Note

This function can be accessed by:

mdb.models[name].parts[name].AttachmentPoints
mdb.models[name].rootAssembly.AttachmentPoints

Note

Check DatumCsysByTwoLines on help.3ds.com/0.1..

Parameters:

coordSysType (Literal[CARTESIAN, CYLINDRICAL, SPHERICAL]) – A SymbolicConstant specifying the type of coordinate system. Possible values are CARTESIAN, CYLINDRICAL, and SPHERICAL.
line1 (str) – A straight Edge, an ElementEdge, or a Datum object representing a datum axis specifying the X-axis or the rr-axis.
line2 (str) – A straight Edge, an ElementEdge, or a Datum object representing a datum axis specifying a line in the X - Y plane or in the rr-θθ plane.
name (str, default: '') – A String specifying the name of the DatumCsys.

Returns:

A Feature object.

Return type:

Feature

Raises:

AbaqusException –

DatumPlaneByLinePoint(line, point)[source]#

This method creates a Feature object and a DatumPlane object that pass through the specified line and through the specified point that does not lie on the line.

Note

This function can be accessed by:

mdb.models[name].parts[name].AttachmentPoints
mdb.models[name].rootAssembly.AttachmentPoints

Note

Check DatumPlaneByLinePoint on help.3ds.com/0.1..

Parameters:

line (str) – A straight Edge, an ElementEdge, or a Datum object representing a datum axis.
point (int) – A ConstrainedSketchVertex, an InterestingPoint, a MeshNode, or a Datum object representing a datum point.

Returns:

A Feature object.

Return type:

Feature

Raises:

AbaqusException –

DatumPlaneByOffset(*args, **kwargs)[source]#

DatumPlaneByPointNormal(point, normal)[source]#

This method creates a Feature object and a DatumPlane object normal to the specified line and running through the specified point.

Note

This function can be accessed by:

mdb.models[name].parts[name].AttachmentPoints
mdb.models[name].rootAssembly.AttachmentPoints

Note

Check DatumPlaneByPointNormal on help.3ds.com/0.1..

Parameters:

point (int) – A ConstrainedSketchVertex, an InterestingPoint, a MeshNode, or a Datum object representing a datum point.
normal (str) – A straight Edge, an ElementEdge, or a Datum object representing a datum axis.

Returns:

A Feature object.

Return type:

Feature

Raises:

AbaqusException –

DatumPlaneByPrincipalPlane(principalPlane, offset)[source]#

This method creates a Feature object and a DatumPlane object through the origin along one of the three principal planes.

Note

This function can be accessed by:

mdb.models[name].parts[name].AttachmentPoints
mdb.models[name].rootAssembly.AttachmentPoints

Note

Check DatumPlaneByPrincipalPlane on help.3ds.com/0.1..

Parameters:

principalPlane (Literal[XYPLANE, YZPLANE, XZPLANE]) – A SymbolicConstant specifying the principal plane. Possible values are XYPLANE, YZPLANE, and XZPLANE.
offset (float) – A Float specifying the offset from the plane.

Returns:

A Feature object.

Return type:

Feature

Raises:

AbaqusException –

DatumPlaneByRotation(plane, axis, angle)[source]#

This method creates a Feature object and a DatumPlane object by rotating a plane about the specified axis through the specified angle.

Note

This function can be accessed by:

mdb.models[name].parts[name].AttachmentPoints
mdb.models[name].rootAssembly.AttachmentPoints

Parameters:

plane (str) – A planar Face, an ElementFace, or a Datum object representing a datum plane.
axis (str) – A straight Edge, an ElementEdge, or a Datum object representing a datum axis.
angle (float) – A Float specifying the angle in degrees to rotate the plane.

Returns:

A Feature object.

Return type:

Feature

Raises:

AbaqusException –

DatumPlaneByThreePoints(point1, point2, point3)[source]#

This method creates a Feature object and a DatumPlane object defined by passing through three points.

Note

This function can be accessed by:

mdb.models[name].parts[name].AttachmentPoints
mdb.models[name].rootAssembly.AttachmentPoints

Note

Check DatumPlaneByThreePoints on help.3ds.com/0.1..

Parameters:

point1 (int) – A ConstrainedSketchVertex, an InterestingPoint, a MeshNode, or a Datum object representing a datum point.
point2 (int) – A ConstrainedSketchVertex, an InterestingPoint, a MeshNode, or a Datum object representing a datum point.
point3 (int) – A ConstrainedSketchVertex, an InterestingPoint, a MeshNode, or a Datum object representing a datum point.

Returns:

A Feature object.

Return type:

Feature

Raises:

AbaqusException –

DatumPlaneByTwoPoint(point1, point2)[source]#

This method creates a Feature object and a DatumPlane object midway between two points and normal to the line connecting the points.

Note

This function can be accessed by:

mdb.models[name].parts[name].AttachmentPoints
mdb.models[name].rootAssembly.AttachmentPoints

Note

Check DatumPlaneByTwoPoint on help.3ds.com/0.1..

Parameters:

point1 (int) – A ConstrainedSketchVertex, an InterestingPoint, a MeshNode, or a Datum object representing a datum point.
point2 (int) – A ConstrainedSketchVertex, an InterestingPoint, a MeshNode, or a Datum object representing a datum point.

Returns:

A Feature object.

Return type:

Feature

Raises:

AbaqusException –

DatumPointByCoordinate(coords)[source]#

This method creates a Feature object and a DatumPoint object at the point defined by the specified coordinates.

Note

This function can be accessed by:

mdb.models[name].parts[name].AttachmentPoints
mdb.models[name].rootAssembly.AttachmentPoints

Note

Check DatumPointByCoordinate on help.3ds.com/0.1..

Parameters:: coords (tuple) – A sequence of three Floats specifying the X-, Y-, and Z-coordinates of the datum point.
Returns:: feature – A Feature object
Return type:: Feature

DatumPointByEdgeParam(edge, parameter)[source]#

This method creates a Feature object and a DatumPoint object along an edge at a selected distance from one end of the edge.

Note

This function can be accessed by:

mdb.models[name].parts[name].AttachmentPoints
mdb.models[name].rootAssembly.AttachmentPoints

Note

Check DatumPointByEdgeParam on help.3ds.com/0.1..

Parameters:

edge (Edge) – An Edge object.
parameter (float) – A Float specifying the distance along edge to the DatumPoint object. Possible values are 0 << parameter << 1.

Returns:

A Feature object.

Return type:

Feature

Raises:

AbaqusException –
RangeError –

DatumPointByMidPoint(point1, point2)[source]#

This method creates a Feature object and a DatumPoint object midway between two points.

Note

This function can be accessed by:

mdb.models[name].parts[name].AttachmentPoints
mdb.models[name].rootAssembly.AttachmentPoints

Note

Check DatumPointByMidPoint on help.3ds.com/0.1..

Parameters:

point1 (int) – A ConstrainedSketchVertex, an InterestingPoint, a MeshNode, or a Datum object representing a datum point.
point2 (int) – A ConstrainedSketchVertex, an InterestingPoint, a MeshNode, or a Datum object representing a datum point.

Returns:

feature – A Feature object

Return type:

Feature

DatumPointByOffset(point, vector)[source]#

This method creates a Feature object and a DatumPoint object offset from an existing point by a vector.

Note

This function can be accessed by:

mdb.models[name].parts[name].AttachmentPoints
mdb.models[name].rootAssembly.AttachmentPoints

Note

Check DatumPointByOffset on help.3ds.com/0.1..

Parameters:

point (int) – A ConstrainedSketchVertex, an InterestingPoint, a MeshNode, or a Datum object representing a datum point.
vector (tuple) – A sequence of three Floats specifying the X-, Y-, and Z-offsets from point.

Returns:

feature – A Feature object

Return type:

Feature

DatumPointByOnFace(face, edge1, offset1, edge2, offset2)[source]#

This method creates a Feature object and a DatumPoint object on the specified face, offset from two edges.

Note

This function can be accessed by:

mdb.models[name].parts[name].AttachmentPoints
mdb.models[name].rootAssembly.AttachmentPoints

Note

Check DatumPointByOnFace on help.3ds.com/0.1..

Parameters:

face (str) – A planar Face or a Datum object representing a datum plane.
edge1 (str) – A straight Edge or a Datum object representing a datum axis.
offset1 (float) – A Float specifying the offset from edge1.
edge2 (str) – A straight Edge or a Datum object representing a datum axis.
offset2 (float) – A Float specifying the offset from edge2.

Returns:

A Feature object.

Return type:

Feature

Raises:

AbaqusException –

DatumPointByProjOnEdge(point, edge)[source]#

This method creates a Feature object and a DatumPoint object along an edge by projecting an existing point along the normal to the edge.

Note

This function can be accessed by:

mdb.models[name].parts[name].AttachmentPoints
mdb.models[name].rootAssembly.AttachmentPoints

Note

Check DatumPointByProjOnEdge on help.3ds.com/0.1..

Parameters:

point (int) – A ConstrainedSketchVertex, an InterestingPoint, a MeshNode, or a Datum object representing a datum point.
edge (str) – An Edge, an ElementEdge or a Datum object representing a datum axis.

Returns:

A Feature object.

Return type:

Feature

Raises:

AbaqusException –

DatumPointByProjOnFace(point, face)[source]#

This method creates a Feature object and a DatumPoint object on a specified face by projecting an existing point onto the face.

Note

This function can be accessed by:

mdb.models[name].parts[name].AttachmentPoints
mdb.models[name].rootAssembly.AttachmentPoints

Note

Check DatumPointByProjOnFace on help.3ds.com/0.1..

Parameters:

point (int) – A ConstrainedSketchVertex, an InterestingPoint, a MeshNode, or a Datum object representing a datum point.
face (Face) – A Face object or a Datum object representing a datum plane.Note:Any other types of planes are not supported.

Returns:

A Feature object.

Return type:

Feature

Raises:

AbaqusException –

static EdgeToEdge(movableAxis, fixedAxis, flip, clearance)[source]#

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

Note

This function can be accessed by:

mdb.models[name].rootAssembly.AttachmentLines

Note

Check EdgeToEdge on help.3ds.com/0.1..

Parameters:

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

Returns:

A Feature Object.

Return type:

AssemblyFeature

Raises:

AbaqusException –

static FaceToFace(movablePlane, fixedPlane, flip, clearance)[source]#

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

Note

This function can be accessed by:

mdb.models[name].rootAssembly.AttachmentLines

Note

Check FaceToFace on help.3ds.com/0.1..

Parameters:

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

Returns:

A Feature Object.

Return type:

AssemblyFeature

Raises:

AbaqusException –

Instance(name, *args, **kwargs)[source]#

This method creates a PartInstance object and puts it into the instances repository.

Note

This function can be accessed by:

mdb.models[name].rootAssembly.Instance

Note

Check Instance on help.3ds.com/0.1..

Parameters:

name (str) – A String specifying the repository key. The name must be a valid Abaqus object name.
kwargs – Key-value arguments

Returns:

A PartInstance object.

Return type:

PartInstance

MakeSketchTransform(sketchPlane, origin=(), sketchOrientation=abaqusConstants.RIGHT, sketchPlaneSide=abaqusConstants.SIDE1, sketchUpEdge='')[source]#

This method creates a Transform object. A Transform object is a 4x3 matrix of Floats that represents the transformation from sketch coordinates to part coordinates.

Note

This function can be accessed by:

mdb.models[name].parts[name].AttachmentPoints
mdb.models[name].rootAssembly.AttachmentPoints

Note

Check MakeSketchTransform on help.3ds.com/0.1..

Parameters:

sketchPlane (str) – A Datum plane object or a planar Face object specifying the sketch plane.
origin (tuple, default: ()) – A sequence of Floats specifying the X-, Y-, and Z-coordinates that will be used as the origin of the sketch. The default value is computed as the centroid of the face.
sketchOrientation (Literal[RIGHT, LEFT, TOP, BOTTOM], default: RIGHT) – A SymbolicConstant specifying the orientation of sketchUpEdge on the sketch. Possible values are RIGHT, LEFT, TOP, and BOTTOM. The default value is RIGHT.
sketchPlaneSide (Literal[SIDE1, SIDE2], default: SIDE1) – A SymbolicConstant specifying on which side of the sketchPlane the sketch is positioned. Possible values are SIDE1 and SIDE2. The default value is SIDE1.
sketchUpEdge (str, default: '') – An Edge or DatumAxis object specifying the orientation of the sketch. If unspecified, the sketch is assumed to be oriented with the Y-direction pointing up.

Returns:

Transform – A Transform object. A Transform is an object with one method that returns the transform
matrix.

:raises Up direction is parallel` to :class:`plane normal: If the sketchUpEdge is parallel to the sketchPlane.

static ParallelCsys(movableCsys, fixedCsys)[source]#

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

Note

This function can be accessed by:

mdb.models[name].rootAssembly.AttachmentLines

Note

Check ParallelCsys on help.3ds.com/0.1..

Parameters:

movableCsys (str) – A Datum coordinate system on the part instance to be moved.
fixedCsys (str) – A Datum coordinate system on the part instance to remain fixed.

Returns:

A Feature object.

Return type:

AssemblyFeature

Raises:

AbaqusException –

static ParallelEdge(movableAxis, fixedAxis, flip)[source]#

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

Note

This function can be accessed by:

mdb.models[name].rootAssembly.AttachmentLines

Note

Check ParallelEdge on help.3ds.com/0.1..

Parameters:

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

Returns:

A Feature object.

Return type:

AssemblyFeature

Raises:

AbaqusException –

static ParallelFace(movablePlane, fixedPlane, flip)[source]#

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

Note

This function can be accessed by:

mdb.models[name].rootAssembly.AttachmentLines

Note

Check ParallelFace on help.3ds.com/0.1..

Parameters:

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

Returns:

A Feature object.

Return type:

AssemblyFeature

Raises:

AbaqusException –

PartitionCellByDatumPlane(cells, datumPlane)[source]#

This method partitions one or more cells using the given datum plane.

Note

This function can be accessed by:

mdb.models[name].parts[name].AttachmentPoints
mdb.models[name].rootAssembly.AttachmentPoints

Note

Check PartitionCellByDatumPlane on help.3ds.com/0.1..

Parameters:

cells (Tuple[Cell, ...]) – A sequence of Cell objects specifying the cells to partition.
datumPlane (DatumPlane) – A DatumPlane object.

Returns:

A Feature object.

Return type:

Feature

Raises:

AbaqusException –

PartitionCellByExtendFace(cells, extendFace)[source]#

This method partitions one or more cells by extending the underlying geometry of a given face to partition the target cells.

Note

This function can be accessed by:

mdb.models[name].parts[name].AttachmentPoints
mdb.models[name].rootAssembly.AttachmentPoints

Note

Check PartitionCellByExtendFace on help.3ds.com/0.1..

Parameters:

cells (Tuple[Cell, ...]) – A sequence of Cell objects specifying the cells to partition.
extendFace (str) – A planar, cylindrical, conical, or spherical Face object.

Returns:

A Feature object.

Return type:

Feature

Raises:

AbaqusException –

PartitionCellByExtrudeEdge(cells, edges, line, sense)[source]#

This method partitions one or more cells by extruding selected edges in the given direction.

Note

This function can be accessed by:

mdb.models[name].parts[name].AttachmentPoints
mdb.models[name].rootAssembly.AttachmentPoints

Note

Check PartitionCellByExtrudeEdge on help.3ds.com/0.1..

Parameters:

cells (Tuple[Cell, ...]) – A sequence of Cell objects specifying the cells to partition.
edges (str) – The Edge objects to be extruded. The edges must be in the same plane. The edges must form a continuous chain, without branches. The edges must belong to the same PartInstance object.
line (str) – A straight Edge or DatumAxis object specifying the extrude direction. line must be perpendicular to the plane formed by edges.
sense (SymbolicConstant) – A SymbolicConstant specifying the direction of the extrusion. Possible values are FORWARD and REVERSE. If sense = FORWARD, the extrusion is in the direction of line.

Returns:

A Feature object.

Return type:

Feature

Raises:

AbaqusException –

PartitionCellByPatchNCorners(cell, cornerPoints)[source]#

This method partitions a cell using an N-sided cutting patch defined by the given corner points.

Note

This function can be accessed by:

mdb.models[name].parts[name].AttachmentPoints
mdb.models[name].rootAssembly.AttachmentPoints

Note

Check PartitionCellByPatchNCorners on help.3ds.com/0.1..

Parameters:

cell (Cell) – A Cell object specifying the cell to partition.
cornerPoints (tuple) – A sequence of ConstrainedSketchVertex, InterestingPoint, or DatumPoint objects. 3 ≤ len(cornerPoints) ≤ 5. The corner points must not coincide.

Returns:

A Feature object.

Return type:

Feature

Raises:

AbaqusException –

PartitionCellByPatchNEdges(cell, edges)[source]#

This method partitions a cell using an N-sided cutting patch defined by the given edges.

Note

This function can be accessed by:

mdb.models[name].parts[name].AttachmentPoints
mdb.models[name].rootAssembly.AttachmentPoints

Note

Check PartitionCellByPatchNEdges on help.3ds.com/0.1..

Parameters:

cell (str) – A Cell specifying the cell to partition.
edges (Tuple[Edge, ...]) – A sequence of Edge objects bounding the patch. The edges must form a closed loop. The Edge objects must belong to the same PartInstance object as cell.

Returns:

A Feature object.

Return type:

Feature

Raises:

AbaqusException –

PartitionCellByPlaneNormalToEdge(cells, edge, point)[source]#

This method partitions one or more cells using a plane normal to an edge at the given edge point.

Note

This function can be accessed by:

mdb.models[name].parts[name].AttachmentPoints
mdb.models[name].rootAssembly.AttachmentPoints

Note

Check PartitionCellByPlaneNormalToEdge on help.3ds.com/0.1..

Parameters:

cells (Tuple[Cell, ...]) – A sequence of Cell objects specifying the cells to partition.
edge (Edge) – An Edge object specifying the normal to the plane.
point (int) – A ConstrainedSketchVertex, InterestingPoint, or DatumPoint object specifying a point on edge.

Returns:

A Feature object.

Return type:

Feature

Raises:

AbaqusException –

PartitionCellByPlanePointNormal(cells, point, normal)[source]#

This method partitions one or more cells using a plane defined by a point and a normal direction.

Note

This function can be accessed by:

mdb.models[name].parts[name].AttachmentPoints
mdb.models[name].rootAssembly.AttachmentPoints

Note

Check PartitionCellByPlanePointNormal on help.3ds.com/0.1..

Parameters:

cells (Tuple[Cell, ...]) – A sequence of Cell objects specifying the cells to partition.
point (int) – A ConstrainedSketchVertex, InterestingPoint, or DatumPoint object specifying a point on the plane.
normal (str) – A straight Edge or DatumAxis object specifying the normal to the plane.

Returns:

A Feature object.

Return type:

Feature

Raises:

AbaqusException –

PartitionCellByPlaneThreePoints(cells, point1, point2, point3)[source]#

This method partitions one or more cells using a plane defined by three points.

Note

This function can be accessed by:

mdb.models[name].parts[name].AttachmentPoints
mdb.models[name].rootAssembly.AttachmentPoints

Note

Check PartitionCellByPlaneThreePoints on help.3ds.com/0.1..

Parameters:

cells (Tuple[Cell, ...]) – A sequence of Cell objects specifying the cells to partition.
point1 (int) – A ConstrainedSketchVertex, InterestingPoint, or DatumPoint object specifying a point on the plane.
point2 (int) – A ConstrainedSketchVertex, InterestingPoint, or DatumPoint object specifying a point on the plane.
point3 (int) – A ConstrainedSketchVertex, InterestingPoint, or DatumPoint object specifying a point on the plane.Note:point1, point2, and point3 must not be colinear and must not coincide.

Returns:

A Feature object.

Return type:

Feature

Raises:

AbaqusException –

PartitionCellBySweepEdge(cells, edges, sweepPath)[source]#

This method partitions one or more cells by sweeping selected edges along the given sweep path.

Note

This function can be accessed by:

mdb.models[name].parts[name].AttachmentPoints
mdb.models[name].rootAssembly.AttachmentPoints

Note

Check PartitionCellBySweepEdge on help.3ds.com/0.1..

Parameters:

cells (Tuple[Cell, ...]) – A sequence of Cell objects specifying the cells to partition.
edges (Tuple[Edge, ...]) – A sequence of Edge objects to be swept. The edges must be in the same plane. The edges must form a continuous chain without branches. The Edge objects must all belong to the same PartInstance object.
sweepPath (Edge) – An Edge object specifying the sweep path. The start of sweepPath must be in the plane and perpendicular to the plane formed by edges. The sweep path must be planar.

Returns:

A Feature object.

Return type:

Feature

Raises:

AbaqusException –

PartitionEdgeByDatumPlane(edges, datumPlane)[source]#

This method partitions an edge where it intersects with a datum plane.

Note

This function can be accessed by:

mdb.models[name].parts[name].AttachmentPoints
mdb.models[name].rootAssembly.AttachmentPoints

Note

Check PartitionEdgeByDatumPlane on help.3ds.com/0.1..

Parameters:

edges (Tuple[Edge, ...]) – A sequence of Edge objects specifying the edges to partition.
datumPlane (DatumPlane) – A DatumPlane object specifying the location of the partition.

Returns:

A Feature object.

Return type:

Feature

Raises:

AbaqusException –

PartitionEdgeByParam(edges, parameter)[source]#

This method partitions one or more edges at the given normalized edge parameter.

Note

This function can be accessed by:

mdb.models[name].parts[name].AttachmentPoints
mdb.models[name].rootAssembly.AttachmentPoints

Note

Check PartitionEdgeByParam on help.3ds.com/0.1..

Parameters:

edges (Tuple[Edge, ...]) – A sequence of Edge objects specifying the edges to partition.
parameter (float) – A Float specifying the normalized distance along edge at which to partition. Possible values are 0.0 << parameter << 1.0.

Returns:

A Feature object.

Return type:

Feature

Raises:

AbaqusException –

PartitionEdgeByPoint(edge, point)[source]#

This method partitions an edge at the given point.

Note

This function can be accessed by:

mdb.models[name].parts[name].AttachmentPoints
mdb.models[name].rootAssembly.AttachmentPoints

Note

Check PartitionEdgeByPoint on help.3ds.com/0.1..

Parameters:

edge (Edge) – An Edge object specifying the edge to partition.
point (int) – An InterestingPoint or DatumPoint object specifying a point on edge.

Returns:

A Feature object.

Return type:

Feature

Raises:

AbaqusException –

PartitionFaceByAuto(face)[source]#

This method automatically partitions a target face into simple regions that can be meshed using a structured meshing technique.

Note

This function can be accessed by:

mdb.models[name].parts[name].AttachmentPoints
mdb.models[name].rootAssembly.AttachmentPoints

Note

Check PartitionFaceByAuto on help.3ds.com/0.1..

Parameters:: face (Face) – A Face object specifying the face to partition.
Returns:: feature – A Feature object
Return type:: Feature

PartitionFaceByCurvedPathEdgeParams(face, edge1, parameter1, edge2, parameter2)[source]#

This method partitions a face normal to two edges, using a curved path between the two given edge points defined by the normalized edge parameters.

Note

This function can be accessed by:

mdb.models[name].parts[name].AttachmentPoints
mdb.models[name].rootAssembly.AttachmentPoints

Note

Check PartitionFaceByCurvedPathEdgeParams on help.3ds.com/0.1..

Parameters:

face (Face) – A Face object specifying the face to partition.
edge1 (Edge) – An Edge object specifying the start of the partition. The edge must belong to face.
parameter1 (float) – A Float specifying the distance along edge1 at which to partition. Possible values are 0.0 ≤ distance1 ≤ 1.0.
edge2 (Edge) – An Edge object specifying the end of the partition. The edge must belong to face.
parameter2 (float) – A Float specifying the distance along edge2 at which to partition. Possible values are 0.0 ≤ distance2 ≤ 1.0.

Returns:

A Feature object.

Return type:

Feature

Raises:

AbaqusException –

PartitionFaceByCurvedPathEdgePoints(face, edge1, point1, edge2, point2)[source]#

This method partitions a face normal to two edges, using a curved path between the two given edge points.

Note

This function can be accessed by:

mdb.models[name].parts[name].AttachmentPoints
mdb.models[name].rootAssembly.AttachmentPoints

Note

Check PartitionFaceByCurvedPathEdgePoints on help.3ds.com/0.1..

Parameters:

face (Face) – A Face object specifying the face to partition.
edge1 (Edge) – An Edge object specifying the start of the partition. The edge must belong to face.
point1 (int) – A ConstrainedSketchVertex, InterestingPoint, or DatumPoint object specifying a point on edge1.
edge2 (Edge) – An Edge object specifying the end of the partition. The edge must belong to face.
point2 (int) – A ConstrainedSketchVertex, InterestingPoint, or DatumPoint object specifying a point on edge2.

Returns:

A Feature object.

Return type:

Feature

Raises:

AbaqusException –

PartitionFaceByDatumPlane(faces, datumPlane)[source]#

This method partitions one or more faces using the given datum plane.

Note

This function can be accessed by:

mdb.models[name].parts[name].AttachmentPoints
mdb.models[name].rootAssembly.AttachmentPoints

Note

Check PartitionFaceByDatumPlane on help.3ds.com/0.1..

Parameters:

faces (Tuple[Face, ...]) – A sequence of Face objects specifying the faces to partition.
datumPlane (DatumPlane) – A DatumPlane object specifying the location of the partition.

Returns:

feature – A Feature object

Return type:

Feature

PartitionFaceByExtendFace(faces, extendFace)[source]#

This method partitions one or more faces by extending the underlying geometry of another given face to partition the target faces.

Note

This function can be accessed by:

mdb.models[name].parts[name].AttachmentPoints
mdb.models[name].rootAssembly.AttachmentPoints

Note

Check PartitionFaceByExtendFace on help.3ds.com/0.1..

Parameters:

faces (Tuple[Face, ...]) – A sequence of Face objects specifying the faces to partition.
extendFace (Face) – A Face object that is to be extended to create the partition. The face to extend can be a planar, cylindrical, conical, or spherical face.

Returns:

feature – A Feature object

Return type:

Feature

PartitionFaceByIntersectFace(faces, cuttingFaces)[source]#

This method partitions one or more faces using the given cutting faces to partition the target faces.

Note

This function can be accessed by:

mdb.models[name].parts[name].AttachmentPoints
mdb.models[name].rootAssembly.AttachmentPoints

Note

Check PartitionFaceByIntersectFace on help.3ds.com/0.1..

Parameters:

faces (Tuple[Face, ...]) – A sequence of Face objects specifying the faces to partition.
cuttingFaces (Tuple[Face, ...]) – A sequence of Face objects that specify the cutting faces.

Returns:

feature – A Feature object

Return type:

Feature

PartitionFaceByProjectingEdges(faces, edges, extendEdges=False)[source]#

This method partitions one or more faces by projecting the given edges on the target faces.

Note

This function can be accessed by:

mdb.models[name].parts[name].AttachmentPoints
mdb.models[name].rootAssembly.AttachmentPoints

Note

Check PartitionFaceByProjectingEdges on help.3ds.com/0.1..

Parameters:

faces (Tuple[Face, ...]) – A sequence of Face objects specifying the faces to partition.
edges (Tuple[Edge, ...]) – A sequence of Edge objects specifying the edges that will be projected onto the target faces.
extendEdges (Union[AbaqusBoolean, bool], default: False) – A boolean specifying whether to extend the given edges at their free ends in the tangent direction before partitioning the target faces. The default value is False.

Returns:

feature – A Feature object

Return type:

Feature

PartitionFaceByShortestPath(faces, point1, point2)[source]#

This method partitions one or more faces using a minimum distance path between the two given points.

Note

This function can be accessed by:

mdb.models[name].parts[name].AttachmentPoints
mdb.models[name].rootAssembly.AttachmentPoints

Note

Check PartitionFaceByShortestPath on help.3ds.com/0.1..

Parameters:

faces (Tuple[Face, ...]) – A sequence of Face objects specifying the face to partition.
point1 (int) – A ConstrainedSketchVertex, InterestingPoint, or DatumPoint object.
point2 (int) – A ConstrainedSketchVertex, InterestingPoint, or DatumPoint object.Note:point1 and point2 must not coincide, and they must both lie on the underlying surface geometry of at least one of the target faces.

Returns:

A Feature object.

Return type:

Feature

Raises:

AbaqusException –

PartitionFaceBySketch(faces, sketch, sketchUpEdge='', sketchOrientation=abaqusConstants.RIGHT)[source]#

This method partitions one or more planar faces by sketching on them.

Note

This function can be accessed by:

mdb.models[name].parts[name].AttachmentPoints
mdb.models[name].rootAssembly.AttachmentPoints

Note

Check PartitionFaceBySketch on help.3ds.com/0.1..

Parameters:

faces (Tuple[Face, ...]) – A sequence of Face objects specifying the faces to partition.
sketch (ConstrainedSketch) – A ConstrainedSketch object specifying the partition.
sketchUpEdge (str, default: '') – An Edge or DatumAxis object specifying the orientation of sketch. This edge or datum axis must not be orthogonal to the plane defined by faces. If unspecified, sketch is assumed to be oriented in with the Y direction pointing up.
sketchOrientation (Literal[RIGHT, LEFT, TOP, BOTTOM], default: RIGHT) – A SymbolicConstant specifying the orientation of sketchUpEdge on the sketch. Possible values are RIGHT, LEFT, TOP, and BOTTOM. The default value is RIGHT.

Returns:

A Feature object.

Return type:

Feature

Raises:

AbaqusException –

PartitionFaceBySketchDistance(faces, sketchPlane, sketchPlaneSide, sketchUpEdge, sketch, distance, sketchOrientation=abaqusConstants.RIGHT)[source]#

This method partitions one or more faces by sketching on a sketch plane and then projecting the sketch toward the target faces through the given distance.

Note

This function can be accessed by:

mdb.models[name].parts[name].AttachmentPoints
mdb.models[name].rootAssembly.AttachmentPoints

Note

Check PartitionFaceBySketchDistance on help.3ds.com/0.1..

Parameters:

faces (Tuple[Face, ...]) – A sequence of Face objects specifying the faces to partition.
sketchPlane (str) – A planar Face or DatumPlane object.
sketchPlaneSide (Literal[SIDE1, SIDE2]) – A SymbolicConstant specifying the side of the plane to be used for sketching. Possible values are SIDE1 and SIDE2.
sketchUpEdge (Edge) – An Edge object specifying the orientation of sketch. This edge must not be orthogonal to sketchPlane.
sketch (ConstrainedSketch) – A ConstrainedSketch object specifying the partition.
distance (float) – A Float specifying the projection distance. Possible values are distance >> 0.0.
sketchOrientation (Literal[RIGHT, LEFT, TOP, BOTTOM], default: RIGHT) – A SymbolicConstant specifying the orientation of sketchUpEdge on the sketch. Possible values are RIGHT, LEFT, TOP, and BOTTOM. The default value is RIGHT.

Returns:

A Feature object.

Return type:

Feature

Raises:

AbaqusException –

PartitionFaceBySketchRefPoint(faces, sketchPlane, sketchUpEdge, sketch, point, sketchOrientation=abaqusConstants.RIGHT)[source]#

This method partitions one or more faces by sketching on a sketch plane and then projecting the sketch toward the target faces through a distance governed by the reference point.

Note

This function can be accessed by:

mdb.models[name].parts[name].AttachmentPoints
mdb.models[name].rootAssembly.AttachmentPoints

Note

Check PartitionFaceBySketchRefPoint on help.3ds.com/0.1..

Parameters:

faces (Tuple[Face, ...]) – A sequence of Face objects specifying the faces to partition.
sketchPlane (str) – A planar Face or DatumPlane object.
sketchUpEdge (Edge) – An Edge object or a DatumAxis object specifying the orientation of sketch. This edge or datum axis must not be orthogonal to sketchPlane.
sketch (ConstrainedSketch) – A ConstrainedSketch object specifying the partition.
point (int) – A ConstrainedSketchVertex, InterestingPoint, or DatumPoint object specifying the distance to project sketch. The point must not lie on sketchPlane.
sketchOrientation (Literal[RIGHT, LEFT, TOP, BOTTOM], default: RIGHT) – A SymbolicConstant specifying the orientation of sketchUpEdge on the sketch. Possible values are RIGHT, LEFT, TOP, and BOTTOM. The default value is RIGHT.

Returns:

A Feature object.

Return type:

Feature

Raises:

AbaqusException –

PartitionFaceBySketchThruAll(faces, sketchPlane, sketchPlaneSide, sketchUpEdge, sketch, sketchOrientation=abaqusConstants.RIGHT)[source]#

This method partitions one or more faces by sketching on a sketch plane and then projecting toward the target faces through an infinite distance.

Note

This function can be accessed by:

mdb.models[name].parts[name].AttachmentPoints
mdb.models[name].rootAssembly.AttachmentPoints

Note

Check PartitionFaceBySketchThruAll on help.3ds.com/0.1..

Parameters:

faces (Tuple[Face, ...]) – A sequence of Face objects specifying the faces to partition.
sketchPlane (str) – A planar Face or DatumPlane object.
sketchPlaneSide (Literal[SIDE1, SIDE2]) – A SymbolicConstant specifying the extrude direction of the sketch. Possible values are SIDE1 and SIDE2.
sketchUpEdge (str) – An Edge or a DatumAxis object specifying the orientation of sketch. This edge or datum axis must not be orthogonal to sketchPlane.
sketch (ConstrainedSketch) – A ConstrainedSketch object specifying the partition.
sketchOrientation (Literal[RIGHT, LEFT, TOP, BOTTOM], default: RIGHT) – A SymbolicConstant specifying the orientation of sketchUpEdge on the sketch. Possible values are RIGHT, LEFT, TOP, and BOTTOM. The default value is RIGHT.

Returns:

A Feature object.

Return type:

Feature

Raises:

AbaqusException –

ReferencePoint(point, instanceName='')[source]#

This method creates a Feature object and a ReferencePoint object at the specified location.

Note

This function can be accessed by:

mdb.models[name].parts[name].AttachmentPoints
mdb.models[name].rootAssembly.AttachmentPoints

Note

Check ReferencePoint on help.3ds.com/0.1..

Parameters:

point (Union[tuple, Vertex, InterestingPoint, MeshNode, Datum]) – A ConstrainedSketchVertex, InterestingPoint, a MeshNode, or a Datum object specifying a reference point. point can also be a sequence of three Floats representing the X-, Y-, and Z-coordinates of the point.
instanceName (str, default: '') – Used internally by the input file writer.

Returns:

feature – A Feature object

Return type:

Feature

RemoveWireEdges(wireEdgeList)[source]#

This method removes wire edges.

Note

This function can be accessed by:

mdb.models[name].parts[name].AttachmentPoints
mdb.models[name].rootAssembly.AttachmentPoints

Note

Check RemoveWireEdges on help.3ds.com/0.1..

Parameters:: wireEdgeList (Tuple[Edge, ...]) – A sequence of Edge objects specifying the edges to remove. Any specified edge that is not a wire edge will not be removed.
Returns:: feature – A Feature object
Return type:: Feature

SectionAssignment(region, sectionName, thicknessAssignment=abaqusConstants.FROM_SECTION, offset=0, offsetType=abaqusConstants.SINGLE_VALUE, offsetField='')[source]#

This method creates a SectionAssignment object.

Note

This function can be accessed by:

mdb.models[name].parts[name].SectionAssignment
mdb.models[name].rootAssembly.SectionAssignment

Note

Check SectionAssignment on help.3ds.com/0.1..

Parameters:

region (Set) – A Set object specifying the region to which the section is assigned.
sectionName (str) – A String specifying the name of the section.
thicknessAssignment (SymbolicConstant, default: FROM_SECTION) – A SymbolicConstant specifying section thickness assignment method. Possible values are FROM_SECTION and FROM_GEOMETRY. The default value is FROM_SECTION.
offset (float, default: 0) – A Float specifying the offset of the shell section. The default value is 0.0.
offsetType (SymbolicConstant, default: SINGLE_VALUE) – A SymbolicConstant specifying the method used to define the shell offset. If offsetType is set to OFFSET_FIELD the offsetField must have a value. Possible values are SINGLE_VALUE, MIDDLE_SURFACE, TOP_SURFACE, BOTTOM_SURFACE, FROM_GEOMETRY, and OFFSET_FIELD. The default value is SINGLE_VALUE.
offsetField (str, default: '') – A String specifying the name of the field specifying the offset. The default value is “”.

Returns:

A SectionAssignment object.

Return type:

SectionAssignment

Set(name, *args, **kwargs)[source]#

Surface(side1Faces=None, side2Faces=None, side12Faces=None, end1Edges=None, end2Edges=None, circumEdges=None, side1Edges=None, side2Edges=None, face1Elements=None, face2Elements=None, face3Elements=None, face4Elements=None, face5Elements=None, face6Elements=None, side1Elements=None, side2Elements=None, side12Elements=None, end1Elements=None, end2Elements=None, circumElements=None, name='')[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’)

Note

This function can be accessed by:

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

Note

Check Surface on help.3ds.com/0.1..

Parameters:

name (str, default: '') – A String specifying the repository key. The default value is an empty string.
side1Elements (Union[Face, Tuple[Face, ...], None], default: None) – A sequence of MeshElement objects (surface applies to SIDE1 of element). The default value is None.
side2Elements (Union[Face, Tuple[Face, ...], None], default: None) – A sequence of MeshElement objects (surface applies to SIDE2 of element). The default value is None.
side12Elements (Union[Face, Tuple[Face, ...], None], default: None) – A sequence of MeshElement objects (surface applies to both SIDE1 and SIDE2 of element). The default value is None.
end1Elements (Union[Face, Tuple[Face, ...], None], default: None) – A sequence of MeshElement objects (surface applies to END1 of element). The default value is None.
end2Elements (Union[Face, Tuple[Face, ...], None], default: None) – A sequence of MeshElement objects (surface applies to END2 of element). The default value is None.
circumElements (Union[Face, Tuple[Face, ...], None], default: None) – A sequence of MeshElement objects (surface applies to circumference of element). The default value is None.
face1Elements (Union[Face, Tuple[Face, ...], None], default: None) – A sequence of MeshElement objects (surface applies to FACE1 of element) or MeshFace objects. The default value is None.
face2Elements (Union[Face, Tuple[Face, ...], None], default: None) – A sequence of MeshElement objects (surface applies to FACE2 of element) or MeshFace objects. The default value is None.
face3Elements (Union[Face, Tuple[Face, ...], None], default: None) – A sequence of MeshElement objects (surface applies to FACE3 of element) or MeshFace objects. The default value is None.
face4Elements (Union[Face, Tuple[Face, ...], None], default: None) – A sequence of MeshElement objects (surface applies to FACE4 of element) or MeshFace objects. The default value is None.
face5Elements (Union[Face, Tuple[Face, ...], None], default: None) – A sequence of MeshElement objects (surface applies to FACE5 of element) or MeshFace objects. The default value is None.
face6Elements (Union[Face, Tuple[Face, ...], None], default: None) – A sequence of MeshElement objects (surface applies to FACE6 of element) or MeshFace objects. The default value is None.
side1Faces (Union[Face, Tuple[Face, ...], None], default: None) – A sequence of Face objects (surface applies to SIDE1 of face). The default value is None.
side2Faces (Union[Face, Tuple[Face, ...], None], default: None) – A sequence of Face objects (surface applies to SIDE2 of face). The default value is None.
side12Faces (Union[Face, Tuple[Face, ...], None], default: None) – A sequence of Face objects (surface applies to both SIDE1 and SIDE2 of face). The default value is None.
side1Edges (Union[Face, Tuple[Face, ...], None], default: None) – A sequence of Edge objects (surface applies to SIDE1 of edge). The default value is None.
side2Edges (Union[Face, Tuple[Face, ...], None], default: None) – A sequence of Edge objects (surface applies to SIDE2 of edge). The default value is None.
end1Edges (Union[Face, Tuple[Face, ...], None], default: None) – A sequence of Edge objects (surface applies to END1 of edge). The default value is None.
end2Edges (Union[Face, Tuple[Face, ...], None], default: None) – A sequence of Edge objects (surface applies to END2 of edge). The default value is None.
circumEdges (Union[Face, Tuple[Face, ...], None], default: None) – A sequence of Edge objects (surface applies circumferentially to edge). The default value is None.
kwargs –
The required parameters for different conditions are:
- 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

Returns:

A Surface object.

Return type:

Surface

WirePolyLine(points, mergeType=abaqusConstants.IMPRINT, meshable=ON)[source]#

This method creates an additional Feature object by creating a series of wires joining points in pairs. When such a feature is created at the Part level, then each point can be either a datum point, a vertex, a reference point, an interesting point, an orphan mesh node, or the coordinates of a point. When such a feature is created at the Assembly level, then each point can only be a vertex, a reference point, or an orphan mesh node.

Note

This function can be accessed by:

mdb.models[name].parts[name].AttachmentPoints
mdb.models[name].rootAssembly.AttachmentPoints

Note

Check WirePolyLine on help.3ds.com/0.1..

Parameters:

points (float) – A tuple of point pairs, each pair being itself represented by a tuple. For part level features each point can be a ConstrainedSketchVertex, Datum point, Reference point, orphan mesh Node, or InterestingPoint object specifying the points through which the polyline wire will pass. Each point can also be a tuple of Floats representing the coordinates of a point. For assembly level features each point can only be a ConstrainedSketchVertex, Reference point, or orphan mesh Node specifying the points through which the polyline wire will pass (coordinates cannot be specified). In any of the pairs, the first or second point can be NONE. In that case, the point pair will create a zero-length wire, which is required for certain types of connectors. You must specify at least one pair.
mergeType (Literal[MERGE, IMPRINT, SEPARATE], default: IMPRINT) – A SymbolicConstant specifying the merge behavior of the wire with existing geometry. If mergeType is MERGE, Abaqus merges the wire into solid regions of the part if the wire passes through them. If mergeType is IMPRINT, Abaqus imprints the wire on existing geometry as edges. If mergeType is SEPARATE, Abaqus neither merges nor imprints the spline wire with existing geometry. It creates the wire separately. The default value is IMPRINT.
meshable (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether the wire should be available for selection for meshing operations. If meshable = OFF, the wire can be used for connector section assignment. The default value is ON.

Returns:

feature – A Feature object

Return type:

Feature

allInstances: Dict[str, Union[PartInstance, ModelInstance]] = {}[source]#: A PartInstance object specifying the PartInstances and A ModelInstance object specifying the ModelInstances.

allInternalSets: Dict[str, Set] = {}[source]#: A repository of Set objects specifying picked regions.

allInternalSurfaces: Dict[str, Surface] = {}[source]#: A repository of Surface objects specifying picked regions.

allSets: Dict[str, Set] = {}[source]#: A repository of Set objects specifying for more information, see [Region commands](https://help.3ds.com/2022/english/DSSIMULIA_Established/SIMACAEKERRefMap/simaker-m-RegPyc-sb.htm?ContextScope=all).

allSurfaces: Dict[str, Surface] = {}[source]#: A repository of Surface objects specifying for more information, see [Region commands](https://help.3ds.com/2022/english/DSSIMULIA_Established/SIMACAEKERRefMap/simaker-m-RegPyc-sb.htm?ContextScope=all).

assignStackDirection(cells, referenceRegion)[source]#

This method assigns a stack direction to geometric cells. The stack direction will be used to orient the elements during mesh generation.

Note

Check MeshAssembly.assignStackDirection on help.3ds.com/0.1..

Parameters:

cells (Tuple[Cell, ...]) – A sequence of Cell objects specifying regions where to assign the stack direction.
referenceRegion (Face) – A Face object specifying the top side of the stack direction.

associateMeshWithGeometry(geometricEntity, elements=(), elemFaces=(), elemEdges=(), node=<abaqus.Mesh.MeshNode.MeshNode object>)[source]#

This method associates a geometric entity with mesh entities that are either orphan elements, bounds orphan elements, or were created using the bottom-up meshing technique.

Note

Check MeshAssembly.associateMeshWithGeometry on help.3ds.com/0.1..

Parameters:

geometricEntity (str) – A Cell , a Face, an Edge, or a ConstrainedSketchVertex object specifying geometric entity to be associated with one or more mesh entities.If the geometric entity is a Cell object then the argument elements must be specified.If the geometric entity is a Face object then the argument elemFaces must be specified.If the geometric entity is an Edge object then the argument elemEdges must be specified.If the geometric entity is a ConstrainedSketchVertex object then the argument node must be specified.
elements (Tuple[MeshElement, ...], default: ()) – A sequence of MeshElement objects specifying the elements to be associated with the geometric cell.
elemFaces (Tuple[MeshFace, ...], default: ()) – A sequence of MeshFace objects specifying the element faces to be associated with the geometric face.
elemEdges (Tuple[MeshEdge, ...], default: ()) – A sequence of MeshEdge objects specifying the element edges to be associated with the geometric edge.
node (MeshNode, default: <abaqus.Mesh.MeshNode.MeshNode object at 0x7f350e0ff820>) – A MeshNode object specifying the mesh node to be associated with the geometric vertex.

backup()[source]#: This method makes a backup copy of the features in the assembly. The backup() method is used in conjunction with the restore() method.

clashSets(arg1, arg2)[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.

Note

Check RegionAssemblyBase.clashSets on help.3ds.com/0.1..

Parameters:

arg1 (str) – A Set or Surface object specifying set 1.
arg2 (str) – A Set or Surface object specifying set 2.

clearGeometryCache()[source]#: This method deletes the geometry cache. Deleting the geometry cache reduces the amount of memory being used.

collapseMeshEdge(edge, collapseMethod)[source]#

This method collapses an edge of a quadrilateral or triangular element of a part instance.

Note

Check MeshEditAssembly.collapseMeshEdge on help.3ds.com/0.1..

Parameters:

edge (str) – A single MeshEdge object specifying the element edge to collapse.
collapseMethod (SymbolicConstant) – A SymbolicConstant specifying the method used to collapse the edge. Possible values are FORWARD, REVERSE, and AVERAGE.

combineElement(elements)[source]#

This method combines two triangular elements of a part instance.

Note

Check MeshEditAssembly.combineElement on help.3ds.com/0.1..

Parameters:: elements (tuple) – A sequence of triangular MeshElement objects specifying the elements to combine.

connectorOrientations: ConnectorOrientationArray = [][source]#: A ConnectorOrientationArray object.

copyMeshPattern(elements=(), faces=(), elemFaces=(), targetFace=None, nodes=(), coordinates=())[source]#

This method copies a mesh pattern from a source region consisting of a set of shell elements or element faces onto a target face, mapping nodes and elements in a one-one correspondence between source and target.

Note

Check AssemblyBase.copyMeshPattern on help.3ds.com/0.1..

Parameters:

elements (Tuple[MeshElement, ...], default: ()) – A sequence of MeshElement objects or a Set object containing elements and specifying the source region.
faces (Tuple[Face, ...], default: ()) – A sequence of Face objects that have associated with shell elements or element faces and specifying the source region.
elemFaces (Tuple[MeshFace, ...], default: ()) – A sequence of MeshFace objects specifying the source region.
targetFace (Optional[MeshFace], default: None) – A MeshFace object specifying the target region. The target face can be of a different part instance.
nodes (Tuple[MeshNode, ...], default: ()) – A sequence of MeshNode objects or a Set object containing nodes on the boundary of source region which are to be positioned to the boundary of target face.
coordinates (tuple, default: ()) – A sequence of three-dimensional coordinate tuples specifying the coordinates for each of the given nodes. When specified, the number of coordinate tuples must match the number of given nodes, and be ordered to correspond to the given nodes in ascending order according to index. These coordinates are positions of the nodes of a mesh that will be the target face corresponding to nodes provided.

createVirtualTopology(regions, mergeShortEdges=False, shortEdgeThreshold=None, mergeSmallFaces=False, smallFaceAreaThreshold=None, mergeSliverFaces=False, faceAspectRatioThreshold=None, mergeSmallAngleFaces=False, smallFaceCornerAngleThreshold=None, mergeThinStairFaces=False, thinStairFaceThreshold=None, ignoreRedundantEntities=False, cornerAngleTolerance=30, applyBlendControls=False, blendSubtendedAngleTolerance=None, blendRadiusTolerance=None)[source]#

This method creates a virtual topology feature by automatically merging faces and edges based on a set of geometric parameters. The edges and vertices that are being merged will be ignored during mesh generation.

Note

Check MeshAssembly.createVirtualTopology on help.3ds.com/0.1..

Parameters:

regions (Tuple[Face, ...]) – A sequence of Face objects or PartInstance objects specifying the domain to search for geometric entities that need to be merged. Entities identified as candidates to be merged may be merged with entities from outside the specified region.
mergeShortEdges (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to merge short edges. The default value is False.
shortEdgeThreshold (Optional[float], default: None) – A Float specifying a threshold that determines which edges are considered to be short. These edges are the candidate entities to be merged. This argument is a required argument if the argument mergeShortEdges equals True and it is ignored if the argument mergeShortEdges equals False.
mergeSmallFaces (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to merge faces with small area. The default value is False.
smallFaceAreaThreshold (Optional[float], default: None) – A Float specifying a threshold that determines which faces are considered to have a small area. These faces are the candidate entities to be merged. This argument is a required argument if the argument mergeSmallFaces equals True and it is ignored if the argument mergeSmallFaces equals False.
mergeSliverFaces (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to merge faces with high aspect ratio. The default value is False.
faceAspectRatioThreshold (Optional[float], default: None) – A Float specifying a threshold that determines which faces are considered to have high aspect ratio. These faces are candidate entities to be merged. This argument is a required argument if the argument mergeSliverFaces equals True and it is ignored if the argument mergeSliverFaces equals False.
mergeSmallAngleFaces (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to merge faces that have a sharp corner angle. The default value is False.
smallFaceCornerAngleThreshold (Optional[float], default: None) – A Float specifying a threshold that determines which face corner angles are considered to be small. These faces will be candidate entities to be merged. This argument is a required argument if the argument mergeSmallAngleFaces equals True and it is ignored if the argument mergeSmallAngleFaces equals False.
mergeThinStairFaces (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to merge faces that represent a thin stair-like feature. The default value is False.
thinStairFaceThreshold (Optional[float], default: None) – A Float specifying a threshold that determines which faces representing small stair-like features are considered thin. These faces will be candidate entities to be merged. This argument is required if the argument mergeThinStairFaces is True and it is ignored if mergeThinStairFaces is False.
ignoreRedundantEntities (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to abstract away redundant edges and vertices. The default value is False.
cornerAngleTolerance (float, default: 30) – A Float specifying the angle deviation from 180 degrees at a vertex or at an edge such that the two edges radiating from the vertex or the two faces bounded by the edge can be merged. The default value is 30.0 degrees.
applyBlendControls (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to verify that blend faces can be merged with neighboring faces. If applyBlendControls is True then all faces that have angle larger than blendSubtendedAngleTolerance and a radius smaller than blendRadiusTolerance will not be merged with neighboring faces unless the neighboring faces are also blend faces with similar geometric characteristics. The default value is False.
blendSubtendedAngleTolerance (Optional[float], default: None) – A Float specifying the largest subtended angle of blend faces that can be merged with neighboring faces. This argument is a required argument if the argument applyBlendControls equals True and it is ignored if the argument applyBlendControls equals False.
blendRadiusTolerance (Optional[float], default: None) – A Float specifying the smallest radius of curvature of blend faces that can be merged with neighboring faces. This argument is a required argument if the argument applyBlendControls equals True and it is ignored if the argument applyBlendControls equals False.

Returns:

feature – A Feature object

Return type:

Feature

datums: List[Datum] = [][source]#: A repository of Datum objects specifying all Datum objects in the assembly.

deleteAllFeatures()[source]#: This method deletes all the features in the assembly.

deleteBoundaryLayerControls(regions)[source]#

This method deletes the control parameters for boundary layer mesh for all the specified regions.

Note

Check MeshAssembly.deleteBoundaryLayerControls on help.3ds.com/0.1..

Parameters:: regions (Tuple[Cell, ...]) – A sequence of Cell objects specifying the regions for which to set the boundary layer mesh control parameters.

deleteElement(elements, deleteUnreferencedNodes=OFF)[source]#

This method deletes the given elements from a part instance. The elements must have been generated using the bottom-up meshing technique.

Note

Check MeshEditAssembly.deleteElement on help.3ds.com/0.1..

Parameters:

elements (Tuple[MeshElement, ...]) – A sequence of MeshElement objects or a Set object containing elements.
deleteUnreferencedNodes (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to delete all those associated nodes that become unreferenced after the given elements are deleted. The default value is OFF.

deleteFeatures(featureNames)[source]#

This method deletes specified features from the assembly.

Note

Check AssemblyBase.deleteFeatures on help.3ds.com/0.1..

Parameters:: featureNames (tuple) – A sequence of Strings specifying the feature names that will be deleted from the assembly.

deleteMesh(regions)[source]#

This method deletes a subset of the mesh that contains the native elements from the given part instances or regions.

Note

Check MeshAssembly.deleteMesh on help.3ds.com/0.1..

Parameters:: regions (Tuple[PartInstance, ...]) – A sequence of PartInstance objects or Region objects specifying the part instances or regions from where the native mesh is to be deleted.

deleteMeshAssociationWithGeometry(geometricEntities, addBoundingEntities=False)[source]#

This method deletes the association of geometric entities with mesh entities.

Note

Check MeshAssembly.deleteMeshAssociationWithGeometry on help.3ds.com/0.1..

Parameters:

geometricEntities (Tuple[Cell, ...]) – A sequence of Cell objects, Face objects, Edge objects, or ConstrainedSketchVertex objects specifying the geometric entities that will be disassociated from the mesh.
addBoundingEntities (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether the mesh will also be disassociated from the geometric entities that bounds the given geometricEntities. For example, if the argument geometricEntities contains a face, this boolean indicates whether the edges and vertices that bound the face will also be disassociated from the mesh. The default value is False.

deletePreviewMesh()[source]#: This method deletes all boundary meshes in the assembly. See the boundaryPreview argument of generateMesh for information about generating boundary meshes.

deleteSeeds(regions)[source]#

This method deletes the global edge seeds from the given part instances or deletes the local edge seeds from the given edges.

Note

Check MeshAssembly.deleteSeeds on help.3ds.com/0.1..

Parameters:: regions (Tuple[PartInstance, ...]) – A sequence of PartInstance objects or Edge objects specifying the part instances or edges from which the seeds are to be deleted.

deleteSets(setNames)[source]#

This command deletes the given sets from the assembly.

Note

Check RegionAssemblyBase.deleteSets on help.3ds.com/0.1..

Parameters:: setNames (tuple) – A sequence of Strings specifying the set names that will be deleted from the assembly.

deleteSurfaces(surfaceNames)[source]#

This command deletes the given surfaces from the assembly.

Note

Check RegionAssemblyBase.deleteSurfaces on help.3ds.com/0.1..

Parameters:: surfaceNames (tuple) – A sequence of Strings specifying the surface names that will be deleted from the assembly.

edges: EdgeArray = [][source]#: An EdgeArray object specifying all the edges existing at the assembly level. This member does not provide access to the edges at the instance level.

editNode(nodes, coordinate1=None, coordinate2=None, coordinate3=None, coordinates=(), offset1=None, offset2=None, offset3=None, localCsys=None, projectToGeometry=ON)[source]#

This method changes the coordinates of the given nodes on a part instance.

Note

Check MeshEditAssembly.editNode on help.3ds.com/0.1..

Parameters:

nodes (Tuple[MeshNode, ...]) – A sequence of MeshNode objects or a Set object containing nodes.
coordinate1 (Optional[float], default: None) – A Float specifying the value of the first coordinate. If coordinate1 and offset1 are unspecified, the existing value does not change.
coordinate2 (Optional[float], default: None) – A Float specifying the value of the second coordinate. If coordinate2 and offset2 are unspecified, the existing value does not change.
coordinate3 (Optional[float], default: None) – A Float specifying the value of the third coordinate. If coordinate3 and offset3 are unspecified, the existing value does not change.
coordinates (Tuple[float, ...], default: ()) – A sequence of three-dimensional coordinate tuples specifying the coordinates for each of the given nodes. When specified, the number of coordinate tuples must match the number of given nodes, and be ordered to correspond to the given nodes in ascending order according to index. Furthermore, coordinate1, coordinate2, coordinate3, offset1, offset2, or offset3 may not be specified.
offset1 (Optional[float], default: None) – A Float specifying an offset to apply to the value of the first coordinate of the specified nodes.
offset2 (Optional[float], default: None) – A Float specifying an offset to apply to the value of the second coordinate of the specified nodes.
offset3 (Optional[float], default: None) – A Float specifying an offset to apply to the value of the third coordinate of the specified nodes.
localCsys (Optional[DatumCsys], default: None) – A DatumCsys object specifying the local coordinate system. If unspecified, the global coordinate system will be used.
projectToGeometry (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether to project nodes back to their original geometry. For example, if a node is on a face, this method first positions the node at the new location and then projects it back to the original face. The default value is ON.

:raises A coordinate` and :class:`an offset may not both be specified for the same coordinate component:

elements: MeshElementArray = [][source]#: A MeshElementArray object specifying all the elements existing at the assembly level. This member does not provide access to the elements at the instance level.

engineeringFeatures: EngineeringFeature = <abaqus.EngineeringFeature.EngineeringFeature.EngineeringFeature object>[source]#: An EngineeringFeature object.

excludeFromSimulation(instances, exclude)[source]#

This method excludes the specified part instances from the analysis.

Note

Check AssemblyBase.excludeFromSimulation on help.3ds.com/0.1..

Parameters:

instances (Tuple[PartInstance, ...]) – A sequence of PartInstance objects to be excluded from the analysis.
exclude (str) – A Bool specifying whether to exclude the selected instances from the analysis or include them.

featurelistInfo()[source]#: This method prints the name and status of all the features in the feature lists.

features: Dict[str, AssemblyFeature] = {}[source]#: A repository of Feature objects specifying all Feature objects in the assembly.

featuresById: Dict[str, AssemblyFeature] = {}[source]#: A repository of Feature objects specifying all Feature objects in the assembly.The Feature objects in the featuresById repository are the same as the Feature objects in the features repository. However, the key to the objects in the featuresById repository is an integer specifying the ID, whereas the key to the objects in the features repository is a string specifying the name.

generateBottomUpExtrudedMesh(cell, numberOfLayers, extrudeVector, geometrySourceSide='', elemFacesSourceSide=(), elemSourceSide=(), depth=None, targetSide='', biasRatio=1, extendElementSets=False)[source]#

This method generates solid elements by extruding a 2D mesh along a vector, either on an orphan mesh or within a cell region using a bottom-up technique.

Note

Check MeshAssembly.generateBottomUpExtrudedMesh on help.3ds.com/0.1..

Parameters:

cell (Cell) – A Cell object specifying the geometric region where the mesh is to be generated. This argument is valid only for native part instances.
numberOfLayers (int) – An Int specifying the number of layers to be generated along the extrusion vector.
extrudeVector (tuple) – A sequence of sequences of Floats specifying the start point and end point of a vector. Each point is defined by a tuple of three coordinates indicating its position. The direction of the mesh extrusion operation is from the first point to the second point.
geometrySourceSide (str, default: '') – A Region of Face objects specifying the geometric domain to be used as the source for the extrude meshing operation.
elemFacesSourceSide (Tuple[MeshFace, ...], default: ()) – A sequence of MeshFace objects specifying the faces of 3D elements to be used as the source for the extrude meshing operation.
elemSourceSide (tuple, default: ()) – A sequence of 2D MeshElement objects specifying the elements to be used as the source for the extrude meshing operation.
depth (Optional[float], default: None) – A Float specifying the distance of the mesh extrusion. If unspecified, the vector length of the extrudeVector argument is assumed.
targetSide (str, default: '') – A datum plane, a sequence of Face objects, a sequence of MeshFace objects, or a sequence of 2D MeshElement objects specifying the target of the extrude meshing operation. If specified, this argument overrides the depth argument, and all points on the source will be extruded in the direction of the extrusion vector until meeting the target.
biasRatio (float, default: 1) – A Float specifying a ratio of the element size in the extrusion direction between the source and the target sides of the extrusion. The default is 1.0, meaning no bias.
extendElementSets (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether existing element sets that include source elements will be extended to also include extruded elements. This argument is ignored for native part instances. The default value is False.

generateBottomUpRevolvedMesh(cell, numberOfLayers, axisOfRevolution, angleOfRevolution, geometrySourceSide='', elemFacesSourceSide=(), elemSourceSide=(), extendElementSets=False)[source]#

This method generates solid elements by revolving a 2D mesh around an axis, either on an orphan mesh or within a cell region using a bottom-up technique.

Note

Check MeshAssembly.generateBottomUpRevolvedMesh on help.3ds.com/0.1..

Parameters:

cell (Cell) – A Cell object specifying the geometric region where the mesh is to be generated. This argument is valid only for native part instances.
numberOfLayers (int) – An Int specifying the number of layers of elements to be generated around the axis of revolution.
axisOfRevolution (tuple) – A sequence of sequences of Floats specifying the two points of the vector that describes the axis of revolution. Each point is defined by a tuple of three coordinates indicating its position. The direction of the axis of revolution is from the first point to the second point. The orientation of the revolution operation follows the right-hand-rule about the axis of revolution.
angleOfRevolution (float) – A Float specifying the angle of revolution.
geometrySourceSide (str, default: '') – A Region of Face objects specifying the geometric domain to be used as the source for the revolve meshing operation.
elemFacesSourceSide (Tuple[MeshFace, ...], default: ()) – A sequence of MeshFace objects specifying the faces of 3D elements to be used as the source for the revolve meshing operation.
elemSourceSide (tuple, default: ()) – A sequence of 2D MeshElement objects specifying the elements to be used as the source for the revolve meshing operation.
extendElementSets (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether existing element sets that include source elements will be extended to also include extruded elements. This argument is ignored for native part instances. The default value is False.

generateBottomUpSweptMesh(cell, geometrySourceSide='', elemFacesSourceSide=(), elemSourceSide=(), geometryConnectingSides='', elemFacesConnectingSides=(), elemConnectingSides=(), targetSide=None, numberOfLayers=None, extendElementSets=False)[source]#

This method generates solid elements by sweeping a 2D mesh, either on an orphan mesh or within a cell region using a bottom-up technique.

Note

Check MeshAssembly.generateBottomUpSweptMesh on help.3ds.com/0.1..

Parameters:

cell (Cell) – A Cell object specifying the geometric region where the mesh is to be generated. This argument is valid only for native part instances.
geometrySourceSide (str, default: '') – A Region of Face objects specifying the geometric domain to be used as the source for the sweep meshing operation.
elemFacesSourceSide (Tuple[MeshFace, ...], default: ()) – A sequence of MeshFace objects specifying the faces of 3D elements to be used as the source for the sweep meshing operation.
elemSourceSide (tuple, default: ()) – A sequence of 2D MeshElement objects specifying the elements to be used as the source for the sweep meshing operation.
geometryConnectingSides (str, default: '') – A Region of Face objects specifying the connecting sides of the sweep meshing operation.
elemFacesConnectingSides (Tuple[MeshFace, ...], default: ()) – A sequence of MeshFace objects specifying connecting sides of the sweep meshing operation.
elemConnectingSides (tuple, default: ()) – A sequence of 2D MeshElement objects specifying connecting sides of the sweep meshing operation.
targetSide (Optional[Face], default: None) – A Face object specifying the target side of the sweep meshing operation.
numberOfLayers (Optional[int], default: None) – An Int specifying the number of layers to be generated along the sweep direction.
extendElementSets (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether existing element sets that include source elements will be extended to also include swept elements. This argument is ignored for native part instances. The default value is False.

generateMesh(regions=(), seedConstraintOverride=OFF, meshTechniqueOverride=OFF, boundaryPreview=OFF, boundaryMeshOverride=OFF)[source]#

This method generates a mesh in the given part instances or regions.

Note

Check MeshAssembly.generateMesh on help.3ds.com/0.1..

Parameters:

regions (Tuple[PartInstance, ...], default: ()) – A sequence of PartInstance objects or Region objects specifying the part instances or regions where the mesh is to be generated.
seedConstraintOverride (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether mesh generation is allowed to modify seed constraints. The default value is OFF.
meshTechniqueOverride (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether mesh generation is allowed to modify the existing mesh techniques so that a compatible mesh can be generated. The default value is OFF.
boundaryPreview (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the generated mesh should be a boundary mesh. This option will only have an effect if any of the specified regions are to be meshed with tetrahedral elements or using the bottom-up technique with hexahedral or wedge elements. The default value is OFF.
boundaryMeshOverride (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether mesh generation is allowed to modify an existing boundary preview mesh. This option will only have an effect if any of the specified regions are to be meshed with tetrahedral elements and a boundary preview mesh already exists. The default value is OFF.

generateMeshByOffset(region, meshType, totalThickness, distanceBetweenLayers, numLayers, offsetDirection=abaqusConstants.OUTWARD, initialOffset=0.0, shareNodes=False, deleteBaseElements=False, constantThicknessCorners=False, extendElementSets=False)[source]#

This method generates a solid or shell mesh from an orphan mesh surface by generating layers of elements that propagate out normal to the surface boundary.

Note

Check MeshEditAssembly.generateMeshByOffset on help.3ds.com/0.1..

Parameters:

region (Region) – A Region object specifying the domain to be offset.
meshType (str) – A Symbolic Constant specifying the type of mesh to be generated. Possible values are SOLID or SHELL.
totalThickness (float) – A Float specifying the total thickness of the solid layers. This argument applies only when meshType = SOLID.
distanceBetweenLayers (float) – A Float specifying the distance between shell layers. This argument applies only when meshType = SHELL.
numLayers (int) – An Int specifying the number of element layers to be generated.
offsetDirection (str, default: OUTWARD) – A Symbolic Constant specifying the direction of the offset. This argument is required only when the given region relates to a shell mesh. Possible values are OUTWARD, INWARD, and BOTH. The default value is OUTWARD.
initialOffset (float, default: 0.0) – A Float specifying the magnitude of the initial offset. The default value is zero.
shareNodes (str, default: False) – Boolean specifying whether the first layer of nodes should be shared with nodes on the base surface. The default value is False.
deleteBaseElements (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to delete the shell elements after the offset layers are generated. The default value is False. This argument applies only when meshType = SHELL.
constantThicknessCorners (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to use element-based thickness or nodal-based thickness. The default value is False.
extendElementSets (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether existing element sets that include base elements will be extended to include corresponding offset elements. The default value is False.

getAngle(plane1, plane2, line1, line2, commonVertex='')[source]#

This method returns the angle between the specified entities.

Note

Check AssemblyBase.getAngle on help.3ds.com/0.1..

Parameters:

plane1 (str) – A Face, MeshFace, or a Datum object specifying the first plane. The Datum object must represent a datum plane. The plane1 and line1 arguments are mutually exclusive. One of them must be specified.
plane2 (str) – A Face, MeshFace, or a Datum object specifying the second plane. The Datum object must represent a datum plane. The plane2 and line2 arguments are mutually exclusive. One of them must be specified.
line1 (str) – An Edge, MeshEdge, or a Datum object specifying the first curve. The Datum object must represent a datum axis. The plane1 and line1 arguments are mutually exclusive. One of them must be specified.
line2 (str) – An Edge, MeshEdge, or a Datum object specifying the second curve. The Datum object must represent a datum axis. The plane2 and line2 arguments are mutually exclusive. One of them must be specified.
commonVertex (str, default: '') – If the two selected Edge objects have more than one vertex in common, this ConstrainedSketchVertex object specifies the vertex at which to evaluate the angle.

Returns:

A Float specifying the angle between the specified entities. If you provide a plane as an argument, Abaqus/CAE computes the angle using the normal to the plane.

Return type:

float

getCoordinates(entity)[source]#

This method returns the coordinates of a specified point.

Note

Check AssemblyBase.getCoordinates on help.3ds.com/0.1..

Parameters:: entity (str) – A ConstrainedSketchVertex, Datum point, MeshNode, or ReferencePoint specifying the entity to query.
Returns:: A tuple of three Floats representing the coordinates of the specified point.
Return type:: Tuple[float, float]

getDistance(entity1, entity2, printResults=OFF, csys=<abaqus.Datum.DatumCsys.DatumCsys object>)[source]#

Depending on the arguments provided, this method returns one of the following:

The distance between two points.
The minimum distance between a point and an edge.
The minimum distance between two edges.

Note

Check AssemblyBase.getDistance on help.3ds.com/0.1..

Parameters:

entity1 (str) – A ConstrainedSketchVertex, Datum point, MeshNode, or Edge specifying the first entity from which to measure.
entity2 (str) – A ConstrainedSketchVertex, Datum point, MeshNode, or Edge specifying the second entity to which to measure.
printResults (Union[AbaqusBoolean, bool], default: OFF) – A Boolean that determines whether a verbose output is to be printed. The default is True
csys (DatumCsys, default: <abaqus.Datum.DatumCsys.DatumCsys object at 0x7f350e2347f0>) –
A DatumCsys object specifying the desired coordinate system of the returned coordinates. By default, coordinates are given in the global coordinate system.

New in version 2022: The csys argument was added.

Returns:

A Float specifying the calculated distance.

Return type:

float

getEdgeSeeds(edge, attribute)[source]#

This method returns an edge seed parameter for a specified edge of an assembly.

Note

Check MeshAssembly.getEdgeSeeds on help.3ds.com/0.1..

Parameters:

edge (Edge) – An Edge object specifying the edge to be queried.
attribute (Union[SymbolicConstant, float]) –
A SymbolicConstant specifying the type of edge seed attribute to return. Possible values are:
- EDGE_SEEDING_METHOD
- BIAS_METHOD
- NUMBER
- AVERAGE_SIZE
- DEVIATION_FACTOR
- MIN_SIZE_FACTOR
- BIAS_RATIO
- BIAS_MIN_SIZE
- BIAS_MAX_SIZE
- VERTEX_ADJ_TO_SMALLEST_ELEM
- SMALLEST_ELEM_LOCATION
- CONSTRAINT

Returns:

The return value is a Float, an Int, or a SymbolicConstant depending on the value of the attribute argument.

The return value is dependent on the attribute argument.

If attribute = EDGE_SEEDING_METHOD, the return value is a SymbolicConstant specifying the edge seeding method used to create the seeds along the edge. Possible values are: UNIFORM_BY_NUMBER, UNIFORM_BY_SIZE, CURVATURE_BASED_BY_SIZE, BIASED, NONE
If attribute = BIAS_METHOD, the return value is a SymbolicConstant specifying the bias type used to create the seeds along the edge. Possible values are: SINGLE, DOUBLE, NONE
If attribute = NUMBER, the return value is an Int specifying the number of element seeds along the edge.
If attribute = AVERAGE_SIZE, the return value is a Float specifying the average element size along the edge.
If attribute = DEVIATION_FACTOR, the return value is a Float specifying the deviation factor h/Lh/L, where hh is the chordal deviation and LL is the element length. If edge seeds are not defined, the return value is zero.
If attribute = MIN_SIZE_FACTOR, the return value is a Float specifying the size of the smallest allowable element as a fraction of the specified global element size. If edge seeds are not defined, the return value is zero.
If attribute = BIAS_RATIO, the return value is a Float specifying the length ratio of the largest element to the smallest element.
If attribute = BIAS_MIN_SIZE, the return value is a Float specifying the length of the largest element; only applicable if the EDGE_SEEDING_METHOD is BIASED and seeds were specified by minimum and maximum sizes.
If attribute = BIAS_MAX_SIZE, the return value is a Float specifying the length of the largest element; only applicable if the EDGE_SEEDING_METHOD is BIASED and seeds were specified by minimum and maximum sizes.
If attribute = VERTEX_ADJ_TO_SMALLEST_ELEM, the return value is an Int specifying the ID of the vertex next to the smallest element; only applicable if the EDGE_SEEDING_METHOD is BIASED.
If attribute = SMALLEST_ELEM_LOCATION, the return value is a SymbolicConstant specifying the location of smallest elements for double bias seeds; only applicable if the EDGE_SEEDING_METHOD is BIASED and BIAS_METHOD is DOUBLE. Possible values are: SMALLEST_ELEM_AT_CENTER, SMALLEST_ELEM_AT_ENDS, NONE
If attribute = CONSTRAINT, the return value is a SymbolicConstant specifying how close the seeds must be matched by the mesh. Possible values are: FREE, FINER, FIXED, NONE

A value of NONE indicates that the edge is not seeded.

Return type:

Union[float, int, SymbolicConstant]

getElementType(region, elemShape)[source]#

This method returns the ElemType object of a given element shape assigned to a region of the assembly.

Note

Check MeshAssembly.getElementType on help.3ds.com/0.1..

Parameters:

region (str) – A Cell, a Face, or an Edge object specifying the region to be queried.
elemShape (SymbolicConstant) – A SymbolicConstant specifying the shape of the element for which to return the element type. Possible values are:LINEQUADTRIHEXWEDGETET

Returns:

An ElemType object.

Return type:

ElementType

Raises:

TypeError – If the region cannot be associated with element types or if the elemShape is not consistent with the dimension of the region.

getFacesAndVerticesOfAttachmentLines(edges)[source]#

Given an array of edge objects, this method returns a tuple of dictionary objects. Each object consists of five members including the attachment line and associated face and vertex objects.

Note

Check AssemblyBase.getFacesAndVerticesOfAttachmentLines on help.3ds.com/0.1..

Parameters:

edges (EdgeArray) – An EdgeArray object which is a sequence of Edge objects.

Returns:

A tuple of dictionary objects. Each dictionary contains five items with the following keys:

edge: An Edge object specifying the attachment line.
startFace: A Face object specifying the face associated with one end of the attachment line.
endFace: A Face object specifying the face associated with the other end of the attachment line.
startVertex: A ConstrainedSketchVertex object specifying the vertex associated with one end of the attachment line. This end is also associated with the startFace.
endVertex: A ConstrainedSketchVertex object specifying the vertex associated with the other end of the attachment line. This end is also associated with the endFace.

Return type:

Tuple[dict, ]

getIncompatibleMeshInterfaces(cells=())[source]#

This method returns a sequence of face objects that are meshed with incompatible elements.

Note

Check MeshAssembly.getIncompatibleMeshInterfaces on help.3ds.com/0.1..

Parameters:: cells (Tuple[Cell, ...], default: ()) – A sequence of Cell objects which will be used to search the incompatible faces.
Returns:: A sequence of Face objects.
Return type:: Tuple[Face, ]

getMassProperties(regions='', relativeAccuracy=abaqusConstants.LOW, useMesh=False, specifyDensity=False, density='', specifyThickness=False, thickness='', miAboutCenterOfMass=True, miAboutPoint=())[source]#

This method returns the mass properties of the assembly, or instances or regions. Only beams, trusses, shells, solids, point, nonstructural mass, and rotary inertia elements are supported.

Note

Check AssemblyBase.getMassProperties on help.3ds.com/0.1..

Parameters:

regions (str, default: '') – A MeshElementArray, CellArray, FaceArray, EdgeArray, or list of PartInstance objects specifying the regions whose mass properties are to be queried. The whole assembly is queried by default.
relativeAccuracy (SymbolicConstant, default: LOW) – A SymbolicConstant specifying the relative accuracy for geometry computation. Possible values are LOW, MEDIUM, and HIGH. The default value is LOW.
useMesh (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether the mesh should be used in the computation if the geometry is meshed. The default value is False.
specifyDensity (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether a user-specified density should be used in regions with density errors such as undefined material density. The default value is False.
density (str, default: '') – A double value specifying the user-specified density value to be used in regions with density errors. The user-specified density should be greater than 0.
specifyThickness (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether a user-specified thickness should be used in regions with thickness errors such as undefined thickness. The default value is False.
thickness (str, default: '') – A double value specifying the user-specified thickness value to be used in regions with thickness errors. The user-specified thickness should be greater than 0.
miAboutCenterOfMass (Union[AbaqusBoolean, bool], default: True) – A Boolean specifying if the moments of inertia should be evaluated about the center of mass. The default value is True.
miAboutPoint (tuple, default: ()) – A tuple of three floats specifying the coordinates of the point about which to evaluate the moment of inertia. By default if the moments of inertia are not being evaluated about the center of mass, they will be evaluated about the origin.

Returns:

properties – A Dictionary object with the following items: area: None or a Float specifying the sum of the area of the specified faces. The area is computed only for one side for shells. areaCentroid: None or a tuple of three Floats representing the coordinates of the area centroid. volume: None or a Float specifying the volume of the specified regions. volumeCentroid: None or a tuple of three Floats representing the coordinates of the volume centroid. massFromMassPerUnitSurfaceArea: None or a Float specifying the mass due to mass per unit surface area. mass: None or a Float specifying the mass of the specified regions. It is the total mass and includes mass from quantities such as mass per unit surface area. centerOfMass: None or a tuple of three Floats representing the coordinates of the center of mass. momentOfInertia: None or a tuple of six Floats representing the moments of inertia about the center of mass or about the point specified. warnings: A tuple of SymbolicConstants representing the problems encountered while computing the mass properties. Possible SymbolicConstants are: UNSUPPORTED_ENTITIES: Some unsupported entities exist in the specified regions. The mass properties are computed only for beams, trusses, shells, solids, point and non-structural mass elements, and rotary inertia elements. The mass properties are not computed for axisymmetric elements, springs, connectors, gaskets, or any other elements. MISSING_THICKNESS: For some regions, the section definitions are missing thickness values. ZERO_THICKNESS: For some regions, the section definitions have a zero thickness value. VARIABLE_THICKNESS: The nodal thickness or field thickness specified for some regions has been ignored. NON_APPLICABLE_THICKNESS: For some regions, the thickness value is not applicable to the corresponding sections specified on the regions. MISSING_DENSITY: For some regions, the section definitions are missing material density values. MISSING_MATERIAL_DEFINITION: For some regions, the material definition is missing. ZERO_DENSITY: For some regions, the section definitions have a zero material density value. UNSUPPORTED_DENSITY: For some regions, either a negative material density or a temperature dependent density has been specified, or the material value is missing for one or more plies in the composite section. SHELL_OFFSETS: For shells, this method does not account for any offsets specified. MISSING_SECTION_DEFINITION: For some regions, the section definition is missing. UNSUPPORTED_SECTION_DEFINITION: The section definition provided for some regions is not supported. REINFORCEMENTS: This method does not account for any reinforcements specified on the model. SMEARED_PROPERTIES: For regions with composite section assignments, the density is smeared across the thickness. The volume centroid and center of mass computations for a composite shell use a lumped mass approach where the volume and mass is assumed to be lumped in the plane of the shell. As a result of these approximations the volume centroid, center of mass and moments of inertia may be slightly inaccurate for regions with composite section assignments. UNSUPPORTED_NON_STRUCTURAL_MASS_ENTITIES: This method does not account for any non-structural mass on wires. INCORRECT_MOMENT_OF_INERTIA: For geometry regions with non-structural mass per volume, the non-structural mass is assumed to be a point mass at the centroid of the regions. Thus, the moments of inertia may be inaccurate as the distribution of the non-structural mass is not accounted for. Use the mesh for accurately computing the moments of inertia. MISSING_BEAM_ORIENTATIONS: For some regions with beam section assignments, the beam section orientations are missing. UNSUPPORTED_BEAM_PROFILES: This method supports the Box, Pipe, Circular, Rectangular, Hexagonal, Trapezoidal, I, L, T, Arbitrary, and Tapered beam profiles. Any other beam profile is not supported. TAPERED_BEAM_MI: Moment of inertia calculations for tapered beams are not accurate. SUBSTRUCTURE_INCORRECT_PROPERTIES: The user assigned density and thickness is not considered for substructures.

Return type:

dict

getMeshControl(region, attribute)[source]#

This method returns a mesh control parameter for the specified region of the assembly.

Note

Check MeshAssembly.getMeshControl on help.3ds.com/0.1..

Parameters:

region (str) – A Cell, a Face, or an Edge object specifying the region to be queried.
attribute (SymbolicConstant) –
A SymbolicConstant specifying the mesh control attribute to return. Possible values are:
- ELEM_SHAPE
- TECHNIQUE
- ALGORITHM
- MIN_TRANSITION
The return value is dependent on the attribute argument.
- If attribute = ELEM_SHAPE, the return value is a SymbolicConstant specifying the element shape used during meshing. Possible values are: LINE, QUAD, TRI, QUAD_DOMINATED, HEX, TET, WEDGE, HEX_DOMINATED
- If attribute = TECHNIQUE, the return value is a SymbolicConstant specifying the meshing technique to be used during meshing. Possible values are: FREE, STRUCTURED, SWEEP, UNMESHABLE, Where UNMESHABLE indicates that no meshing technique is applicable with the currently assigned element shape.
- If attribute = ALGORITHM, the return value is a SymbolicConstant specifying the meshing algorithm to be used during meshing. Possible values are: MEDIAL_AXIS, ADVANCING_FRONT, DEFAULT, NON_DEFAULT, NONE, Where NONE indicates that no algorithm is applicable.
- If attribute = MIN_TRANSITION, the return value is a Boolean indicating whether minimum transition will be used during meshing. This option is applicable only to the following: Free quadrilateral meshing or sweep hexahedral meshing with algorithm = MEDIAL_AXIS, Structured quadrilateral meshing.

Returns:

The return value is a SymbolicConstant or a Boolean depending on the value of the attribute argument.

Return type:

Union[bool, SymbolicConstant]

Raises:

TypeError – The region cannot carry mesh controls.

getMeshStats(regions)[source]#

This method returns the mesh statistics for the given part instances or regions.

Note

Check MeshAssembly.getMeshStats on help.3ds.com/0.1..

Parameters:: regions (tuple) – A sequence or tuple of PartInstance objects or ConstrainedSketchGeometry regions for which mesh statistics should be returned.
Returns:: A MeshStats object.
Return type:: MeshStats

getPartSeeds(region, attribute)[source]#

This method returns a part seed parameter for the specified instance.

Note

Check MeshAssembly.getPartSeeds on help.3ds.com/0.1..

Parameters:

region (PartInstance) – A PartInstance object specifying the part instance to be queried.
attribute (Union[SymbolicConstant, float]) –
A SymbolicConstant specifying the type of part seed attribute to return. Possible values are:
- SIZE
- DEFAULT_SIZE
- DEVIATION_FACTOR
- MIN_SIZE_FACTOR
The return value is dependent on the value of the attribute argument.
- If attribute = SIZE, the return value is a Float specifying the assigned global element size. If part seeds are not defined, the return value is zero.
- If attribute = DEFAULT_SIZE, the return value is a Float specifying a suggested default global element size based upon the part geometry.
- If attribute = DEVIATION_FACTOR, the return value is a Float specifying the deviation factor h/Lh/L, where hh is the chordal deviation and LL is the element length. If part seeds are not defined, the return value is zero.
- If attribute = MIN_SIZE_FACTOR, the return value is a Float specifying the size of the smallest allowable element as a fraction of the specified global element size. If part seeds are not defined, the return value is zero.

Returns:

The return value is a Float, and its value is dependent on the attribute argument.

Return type:

float

Raises:

Error – An exception occurs if the part instance does not contain native geometry.

getSurfaceSections(surface)[source]#

This method returns a list of the sections assigned to the regions encompassed by the specified surface.

Note

Check AssemblyBase.getSurfaceSections on help.3ds.com/0.1..

Parameters:: surface (str) – A string specifying the Surface name.
Returns:: A tuple of strings representing the section names. If no section names are found, the tuple will contain one empty string.
Return type:: Tuple[str, ]

getUnmeshedRegions()[source]#

This method returns all geometric regions in the assembly that require a mesh for submitting an analysis but are either unmeshed or are meshed incompletely.

Returns:: A Region object, or None.
Return type:: Region

id: Optional[int] = None[source]#: An Int specifying the ID of the feature.

ignoreEntity(entities)[source]#

This method creates a virtual topology feature. Virtual topology allows unimportant entities to be ignored during mesh generation. You can combine two adjacent faces by specifying a common edge to ignore. Similarly, you can combine two adjacent edges by specifying a common vertex to ignore.

Note

Check MeshAssembly.ignoreEntity on help.3ds.com/0.1..

Parameters:: entities (tuple) – A sequence of vertices and edges specifying the entities to be ignored during meshing.
Returns:: feature – A Feature object
Return type:: Feature

importCatiaV5File(filename, ids=())[source]#

This method imports an assembly from a CATIA V5 Elysium Neutral file into the root assembly.

Note

Check AssemblyBase.importCatiaV5File on help.3ds.com/0.1..

Parameters:

filename (str) – A String specifying the path to the CATIA V5 Elysium Neutral file from which to import the assembly.
ids (tuple, default: ()) – A sequence of Ints. Each Int in the sequence is a unique identifier of the occurrence in the assembly tree or component identifier associated with the part in the EAF file. If ids is an empty sequence, all occurrences or parts will be imported. The default value is an empty sequence.

importEafFile(filename, ids=())[source]#

This method imports an assembly from an EAF file into the root assembly.

Note

Check AssemblyBase.importEafFile on help.3ds.com/0.1..

Parameters:

filename (str) – A String specifying the path to the EAF file from which to import the assembly.
ids (tuple, default: ()) – A sequence of Ints. Each Int in the sequence is a unique identifier of the occurrence in the assembly tree or component identifier associated with the part in the EAF file. If ids is an empty sequence, all occurrences or parts will be imported. The default value is an empty sequence.

importEnfFile(filename, ids=())[source]#

This method imports an assembly from an Elysium Neutral file created by Pro/ENGINEER, I-DEAS, or CATIA V5 into the root assembly.

Note

Check AssemblyBase.importEnfFile on help.3ds.com/0.1..

Parameters:

filename (str) – A String specifying the path to the Elysium Neutral file from which to import the assembly.
ids (tuple, default: ()) – A sequence of Ints. Each Int in the sequence is a unique identifier of the occurrence in the assembly tree or component identifier associated with the part in the EAF file. If ids is an empty sequence, all occurrences or parts will be imported. The default value is an empty sequence.

importIdeasFile(filename, ids=())[source]#

This method imports an assembly from an I-DEAS Elysium Neutral file into the root assembly.

Note

Check AssemblyBase.importIdeasFile on help.3ds.com/0.1..

Parameters:

filename (str) – A String specifying the path to the I-DEAS Elysium Neutral file from which to import the assembly.
ids (tuple, default: ()) – A sequence of Ints. Each Int in the sequence is a unique identifier of the occurrence in the assembly tree or component identifier associated with the part in the EAF file. If ids is an empty sequence, all occurrences or parts will be imported. The default value is an empty sequence.

importParasolidFile(filename, ids=())[source]#

This method imports an assembly from the Parasolid file into the root assembly.

Note

Check AssemblyBase.importParasolidFile on help.3ds.com/0.1..

Parameters:

filename (str) – A String specifying the path to a Parasolid file from which to import the assembly.
ids (tuple, default: ()) – A sequence of Ints. Each Int in the sequence is a unique identifier of the occurrence in the assembly tree or component identifier associated with the part in the EAF file. If ids is an empty sequence, all occurrences or parts will be imported. The default value is an empty sequence.

importProEFile(filename, ids=())[source]#

This method imports an assembly from a Pro/ENGINEER Elysium Neutral file into the root assembly.

Note

Check AssemblyBase.importProEFile on help.3ds.com/0.1..

Parameters:

filename (str) – A String specifying the path to the Pro/ENGINEER Elysium Neutral file from which to import the assembly.
ids (tuple, default: ()) – A sequence of Ints. Each Int in the sequence is a unique identifier of the occurrence in the assembly tree or component identifier associated with the part in the EAF file. If ids is an empty sequence, all occurrences or parts will be imported. The default value is an empty sequence.

instances: Dict[str, PartInstance] = {}[source]#: A repository of PartInstance objects.

isLocked: Optional[int] = None[source]#: An Int specifying whether the assembly is locked or not. Possible values are 0 and 1.

isOutOfDate: Optional[int] = None[source]#: An Int specifying that feature parameters have been modified but that the assembly has not been regenerated. Possible values are 0 and 1.

isSetInternal(setName)[source]#

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

Note

Check RegionAssemblyBase.isSetInternal on help.3ds.com/0.1..

Parameters:: setName (str) – A string specifying the Set name.

isSuppressed()[source]#

This method queries the suppressed state of the feature.

Returns:: A Boolean value of True if the feature is suppressed and False if it is not suppressed.
Return type:: Boolean

isSurfaceInternal(surfaceName)[source]#

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

Note

Check RegionAssemblyBase.isSurfaceInternal on help.3ds.com/0.1..

Parameters:: surfaceName (str) – A string specifying the Surface name.

lock()[source]#: This method locks the assembly. Locking the assembly prevents any further changes to the assembly that can trigger regeneration of the assembly.

makeDependent(instances)[source]#

This method converts the specified part instances from independent to dependent part instances.

Note

Check AssemblyBase.makeDependent on help.3ds.com/0.1..

Parameters:: instances (Tuple[PartInstance, ...]) – A sequence of PartInstance objects to convert to dependent part instances.

makeIndependent(instances)[source]#

This method converts the specified part instances from dependent to independent part instances.

Note

Check AssemblyBase.makeIndependent on help.3ds.com/0.1..

Parameters:: instances (Tuple[PartInstance, ...]) – A sequence of PartInstance objects to convert to independent part instances.

markSetInternal(setName, internalSet)[source]#

This command marks the given Set as internal or external.

Note

Check RegionAssemblyBase.markSetInternal on help.3ds.com/0.1..

Parameters:

setName (str) – A string specifying the Set name.
internalSet (Union[AbaqusBoolean, bool]) – A Boolean specifying whether the Set should be marked as internal.

markSurfaceInternal(setName, internalSurface)[source]#

This command marks the given Surface as internal or external.

Note

Check RegionAssemblyBase.markSurfaceInternal on help.3ds.com/0.1..

Parameters:

setName (str) – A string specifying the Surface name.
internalSurface (Union[AbaqusBoolean, bool]) – A Boolean specifying whether the Surface should be marked as internal.

mergeNodes(*args, **kwargs)[source]#

modelInstances: Dict[str, ModelInstance] = {}[source]#: A repository of ModelInstance objects.

modelName: str = ''[source]#: A String specifying the name of the model to which the assembly belongs.

name: str = ''[source]#: A String specifying the repository key.

nodes: MeshNodeArray = [][source]#: A MeshNodeArray object specifying all the nodes existing at the assembly level. This member does not provide access to the nodes at the instance level.

printAssignedSections()[source]#: This method prints a summary of assigned connector sections.

printConnectorOrientations()[source]#: This method prints a summary of connector orientations.

projectNode(nodes, projectionReference)[source]#

This method projects the given nodes of a part instance onto a mesh entity, geometric entity, or a datum object.

Note

Check MeshEditAssembly.projectNode on help.3ds.com/0.1..

Parameters:

nodes (Tuple[MeshNode, ...]) – A sequence of MeshNode objects to be projected.
projectionReference (str) – An object specifying the target for the node projection operation. The projectionReference can be any one of the following objects: MeshNode, MeshEdge, MeshFace, ConstrainedSketchVertex, Edge, Face, DatumPoint, DatumAxis, or DatumPlane.

projectReferencesOntoSketch(sketch, filter=abaqusConstants.ALL_EDGES, upToFeature=None, edges=(), vertices=())[source]#

This method projects the specified edges, vertices, and datum points from the assembly onto the specified ConstrainedSketch object. The edges, vertices, and datum points appear on the sketch as reference geometry.

Note

Check AssemblyBase.projectReferencesOntoSketch on help.3ds.com/0.1..

Parameters:

sketch (str) – The ConstrainedSketch object on which the edges, vertices, and datum points are projected.
filter (SymbolicConstant, default: ALL_EDGES) – A SymbolicConstant specifying how to limit the amount of projection. Possible values are ALL_EDGES and COPLANAR_EDGES. If filter = COPLANAR_EDGES, edges that are coplanar to the sketching plane are the only candidates for projection. The default value is ALL_EDGES.
upToFeature (Optional[AssemblyFeature], default: None) – A Feature object specifying a marker in the feature-based history of the part. Abaqus/CAE projects onto the sketch only the part entities that were created before the feature specified by this marker. By default, all part entities are candidates for projection.
edges (tuple, default: ()) – A sequence of candidate edges to be projected onto the sketch. By default, all edges are candidates for projection.
vertices (tuple, default: ()) – A sequence of candidate vertices to be projected onto the sketch. By default, all vertices are candidates for projection.

queryCachedStates()[source]#: This method displays the position of geometric states relative to the sequence of features in the assembly cache. The output is displayed in the message area.

redoMeshEdit()[source]#: This method executes the edit mesh or the bottom-up meshing operation most recently undone by the undoMeshEdit method on an assembly. A redo action must be currently available for the assembly. This implies that the user must have executed the undoMeshEdit method on the assembly and that the user has not subsequently executed any further edit mesh commands on the assembly. It also implies that the user provided a sufficient cache allowance to store the undo operation.

referencePoints: Dict[str, ReferencePoint] = {}[source]#: A repository of ReferencePoint objects.

regenerate()[source]#: This method regenerates the assembly and brings it up to date with the latest values of the assembly parameters. When you modify features of an assembly, it may be convenient to postpone regeneration until you make all your changes, since regeneration can be time consuming. In contrast, when you modify features of a part that is included in the assembly, you should use this command to regenerate the assembly. When you regenerate the assembly, it will reflect the changes that you made to the part.

regenerateConstraintsTogether: Boolean = ON[source]#: A Boolean specifying whether the positioning constraints in the assembly should be regenerated together before regenerating other assembly features. The default value is ON.If the assembly has position constraint features and you modify the value of regenerateConstraintsTogether, Abaqus/CAE will regenerate the assembly features.

regenerationWarnings()[source]#: This method prints any regeneration warnings associated with the features.

restore()[source]#: This method restores the parameters of all features in the assembly to the value they had before a failed regeneration. Use the restore method after a failed regeneration, followed by a regenerate command.

restoreIgnoredEntity(entities)[source]#

This method restores vertices and edges that have been merged using a virtual topology feature.

Note

Check MeshAssembly.restoreIgnoredEntity on help.3ds.com/0.1..

Parameters:: entities (Tuple[IgnoredVertex, ...]) – A sequence of IgnoredVertex objects and IgnoredEdge objects specifying the entities to be restored.
Returns:: feature – A Feature object
Return type:: Feature

resume()[source]#: This method resumes suppressed features. Resuming a feature fully restores it to the part or assembly. You can resume the last feature you suppressed, all suppressed features, or just selected features. When you resume a child feature, Abaqus/CAE also resumes the parent features automatically.

resumeAllFeatures()[source]#: This method resumes all the suppressed features in the part or assembly.

resumeFeatures(featureNames)[source]#

This method resumes the specified suppressed features in the assembly.

Note

Check AssemblyBase.resumeFeatures on help.3ds.com/0.1..

Parameters:: featureNames (tuple) – A sequence of Strings specifying the names of features to resume.

resumeLastSetFeatures()[source]#: This method resumes the last set of features to be suppressed in the assembly.

rotate(instanceList, axisPoint, axisDirection, angle)[source]#

This method rotates given instances by the specified amount.

Note

Check AssemblyBase.rotate on help.3ds.com/0.1..

Parameters:

instanceList (tuple) – A sequence of Strings specifying the names of instances to rotate.
axisPoint (tuple) – A sequence of three Floats specifying the coordinates of a point on the axis.
axisDirection (tuple) – A sequence of three Floats specifying the direction of the axis.
angle (float) – A Float specifying the rotation angle in degrees. Use the right-hand rule to determine the direction.

saveGeometryCache()[source]#: This method caches the current geometry, which improves regeneration performance.

sectionAssignments: SectionAssignmentArray = [][source]#: A SectionAssignmentArray object.

seedEdgeByBias(biasMethod, end1Edges, end2Edges, centerEdges, endEdges, ratio, number, minSize, maxSize, constraint=abaqusConstants.FREE)[source]#

This method seeds the given edges nonuniformly using the specified number of elements and bias ratio or the specified minimum and maximum element sizes.

Note

Check MeshAssembly.seedEdgeByBias on help.3ds.com/0.1..

Parameters:

biasMethod (SymbolicConstant) – A SymbolicConstant specifying whether single- or double-biased seed distribution will be applied. If unspecified, single-biased seed distribution will be applied. Possible values are: - SINGLE: Single-biased seed distribution will be applied. - DOUBLE: Double-biased seed distribution will be applied.
end1Edges (Tuple[Edge, ...]) – A sequence of Edge objects specifying the edges to seed. The smallest elements will be positioned near the end where the normalized curve parameter=0.0. You must provide either the end1Edges or the end2Edges argument or both when biasMethod = SINGLE and omit both of them when biasMethod = DOUBLE.Note:You can determine which end is which by the order of the vertex indices returned by [getVertices()](https://help.3ds.com/2022/english/DSSIMULIA_Established/SIMACAEKERRefMap/simaker-c-edgepyc.htm?ContextScope=all#simaker-edgegetverticespyc).
end2Edges (Tuple[Edge, ...]) – A sequence of Edge objects specifying the edges to seed. The smallest elements will be positioned near the end where the normalized curve parameter=1.0.
centerEdges (Tuple[Edge, ...]) – A sequence of Edge objects specifying the edges to seed. The smallest elements will be positioned near edge center. You must provide either the centerEdges or the endEdges argument or both when biasMethod = DOUBLE and omit both of them when biasMethod = SINGLE.
endEdges (Tuple[Edge, ...]) – A sequence of Edge objects specifying the edges to seed. The smallest elements will be positioned near edge ends.
ratio (float) – A Float specifying the ratio of the largest element to the smallest element. Possible values are 1.0 ≤ ratio ≤ 106.
number (int) – An Int specifying the number of elements along each edge. Possible values are 1 ≤ number ≤ 104.
minSize (float) – A Float specifying the desired smallest element size.
maxSize (float) – A Float specifying the desired largest element size.Note:You must specify either the ratio and number or minSize and maxSize pair of arguments.
constraint (SymbolicConstant, default: FREE) –
A SymbolicConstant specifying how closely the seeds must be matched by the mesh. The default value is FREE. If unspecified, the existing constraint will remain unchanged. Possible values are:
- FREE: The resulting mesh can be finer or coarser than the specified seeds.
- FINER: The resulting mesh can be finer than the specified seeds.
- FIXED: The seeds must be exactly matched by the mesh (only with respect to the number of elements, not to the nodal positioning).

seedEdgeByNumber(edges, number, constraint=abaqusConstants.FREE)[source]#

This method seeds the given edges uniformly based on the number of elements along the edges.

Note

Check MeshAssembly.seedEdgeByNumber on help.3ds.com/0.1..

Parameters:

edges (Tuple[Edge, ...]) – A sequence of Edge objects specifying the edges to seed.
number (int) – An Int specifying the number of elements along each edge. Possible values are 1 ≤ number ≤ 104.
constraint (SymbolicConstant, default: FREE) – A SymbolicConstant specifying how closely the seeds must be matched by the mesh. The default value is FREE. If unspecified, the existing constraint will remain unchanged. Possible values are:FREE: The resulting mesh can be finer or coarser than the specified seeds.FINER: The resulting mesh can be finer than the specified seeds.FIXED: The seeds must be exactly matched by the mesh (only with respect to the number of elements, not to the nodal positioning).

seedEdgeBySize(edges, size, deviationFactor=None, minSizeFactor=None, constraint=abaqusConstants.FREE)[source]#

This method seeds the given edges either uniformly or following edge curvature distribution, based on the desired element size.

Note

Check MeshAssembly.seedEdgeBySize on help.3ds.com/0.1..

Parameters:

edges (Tuple[Edge, ...]) – A sequence of Edge objects specifying the edges to seed.
size (float) – A Float specifying the desired element size.
deviationFactor (Optional[float], default: None) – A Float specifying the deviation factor h/Lh/L, where hh is the chordal deviation and LL is the element length.
minSizeFactor (Optional[float], default: None) – A Float specifying the size of the smallest allowable element as a fraction of the specified global element size.
constraint (SymbolicConstant, default: FREE) – A SymbolicConstant specifying how closely the seeds must be matched by the mesh. The default value is FREE. If unspecified, the existing constraint will remain unchanged. Possible values are:FREE: The resulting mesh can be finer or coarser than the specified seeds.FINER: The resulting mesh can be finer than the specified seeds.FIXED: The seeds must be exactly matched by the mesh (only with respect to the number of elements, not to the nodal positioning).

seedPartInstance(regions, size, deviationFactor=None, minSizeFactor=None, constraint=abaqusConstants.FREE)[source]#

This method assigns global edge seeds to the given part instances.

Note

Check MeshAssembly.seedPartInstance on help.3ds.com/0.1..

Parameters:

regions (Tuple[PartInstance, ...]) – A sequence of PartInstance objects specifying the part instances to seed.
size (float) – A Float specifying the desired global element size for the edges.
deviationFactor (Optional[float], default: None) – A Float specifying the deviation factor h/Lh/L, where hh is the chordal deviation and LL is the element length.
minSizeFactor (Optional[float], default: None) – A Float specifying the size of the smallest allowable element as a fraction of the specified global element size.
constraint (SymbolicConstant, default: FREE) – A SymbolicConstant specifying how closely the seeds must be matched by the mesh. The default value is FREE. If unspecified, the existing constraint will remain unchanged. Possible values are:FREE: The resulting mesh can be finer or coarser than the specified seeds.FINER: The resulting mesh can be finer than the specified seeds.

setBoundaryLayerControls(regions, firstElemSize, growthFactor, numLayers, inactiveFaces=(), setName='')[source]#

This method sets the control parameters for boundary layer mesh for the specified regions.

Note

Check MeshAssembly.setBoundaryLayerControls on help.3ds.com/0.1..

Parameters:

regions (Tuple[Cell, ...]) – A sequence of Cell objects specifying the regions for which to set the boundary layer mesh control parameters.
firstElemSize (float) – A Float specifying the height of the first element layer off boundary. Possible values are 0.0 << firstElemSize ≤ 106.
growthFactor (float) – A Float specifying the ratio of heights of any two consecutive element layers. Possible values are 1.0 ≤ growthFactor ≤ 10.0.
numLayers (int) – An Int specifying the number of element layers to be generated. Possible values are 1 ≤ numLayers ≤ 104.
inactiveFaces (Tuple[Face, ...], default: ()) – A sequence of Face objects specifying the faces where boundary layer should not be generated. By default, boundary layer mesh will be generated on all faces of the selected regions.
setName (str, default: '') – A String specifying a unique name for a set that will contain boundary layer elements.

setElementType(regions, elemTypes)[source]#

This method assigns element types to the specified regions.

Note

Check MeshAssembly.setElementType on help.3ds.com/0.1..

Parameters:

regions (tuple) – A sequence of ConstrainedSketchGeometry regions or MeshElement objects, or a Set object containing either geometry regions or elements, specifying the regions to which element types are to be assigned.
elemTypes (Tuple[ElemType, ...]) – A sequence of ElemType objects, one for each element shape applicable to the regions.Note:If an ElemType object has an UNKNOWN_*xxx* value for elemCode, its order will be deduced from the order of other valid ElemType objects within the same setElementType command. If no valid ElemType objects can be found, the order will remain unchanged.

Raises:

Exception – As a result of the element assignment, a region must have the same library, family, and order for all its assigned element types. Otherwise, an exception will be thrown. For example, suppose the Hex, Wedge, and Tet elements previously assigned to a cell are all linear. The user now constructs an ElemType object with a quadratic Hex element and includes only this object in the setElementType command. An exception will be thrown because the Wedge and Tet elements will remain linear (i.e., As Is) and become incompatible with the newly assigned quadratic Hex element.

setLogicalCorners(region, corners)[source]#

This method sets the logical corners for a mappable face region.

Note

Check MeshAssembly.setLogicalCorners on help.3ds.com/0.1..

Parameters:

region (str) – A Face region.
corners (str) – Three, four, or five ConstrainedSketchVertex objects defining the logical corners for a given mappable face region.

setMeshControls(regions, elemShape=None, technique=None, algorithm=None, minTransition=ON, sizeGrowth=None, allowMapped=OFF)[source]#

This method sets the mesh control parameters for the specified regions.

Note

Check MeshAssembly.setMeshControls on help.3ds.com/0.1..

Parameters:

regions (tuple) – A sequence of Face or Cell regions specifying the regions for which to set the mesh control parameters.
elemShape (Optional[SymbolicConstant], default: None) –
A SymbolicConstant specifying the element shape to be used for meshing. The default value is QUAD for Face regions and HEX for Cell regions. If unspecified, the existing element shape will remain unchanged. Possible values are:
- QUAD: Quadrilateral mesh.
- QUAD_DOMINATED: Quadrilateral-dominated mesh.
- TRI: Triangular mesh.
- HEX: Hexahedral mesh.
- HEX_DOMINATED: Hex-dominated mesh.
- TET: Tetrahedral mesh.
- WEDGE: Wedge mesh.
technique (Optional[SymbolicConstant], default: None) –
A SymbolicConstant specifying the mesh technique to be used. The default value is FREE for Face regions. For Cell regions the initial value depends on the geometry of the regions and can be STRUCTURED, SWEEP, or unmeshable. If unspecified, the existing mesh technique(s) will remain unchanged. Possible values are:
- FREE: Free mesh technique.
- STRUCTURED: Structured mesh technique.
- SWEEP: Sweep mesh technique.
- BOTTOM_UP: Bottom-up mesh technique. Only applicable for cell regions.
- SYSTEM_ASSIGN: Allow the system to assign a suitable technique. The actual technique assigned can be STRUCTURED, SWEEP, or “unmeshable”.
algorithm (Optional[SymbolicConstant], default: None) –
A SymbolicConstant specifying the algorithm used to generate the mesh for the specified regions. Possible values are MEDIAL_AXIS, ADVANCING_FRONT, and NON_DEFAULT. If unspecified, the existing value will remain unchanged. This option is applicable only to the following:
- Free quadrilateral or quadrilateral-dominated meshing. In this case the possible values are MEDIAL_AXIS and ADVANCING_FRONT.
- Sweep hexahedral or hexahedral-dominated meshing. In this case the possible values are MEDIAL_AXIS and ADVANCING_FRONT.
- Free tetrahedral meshing. In this case the only possible value is NON_DEFAULT, and it indicates that the free tetrahedral-meshing technique available in Abaqus 6.4 or earlier will be used. If algorithm is not specified, the default tetrahedral-meshing technique will be used.
minTransition (Union[AbaqusBoolean, bool], default: ON) –
A Boolean specifying whether minimum transition is to be applied. The default value is ON. If unspecified, the existing value will remain unchanged. This option is applicable only in the following cases:
- Free quadrilateral meshing or hexahedral sweep meshing with algorithm = MEDIAL_AXIS.
- Structured quadrilateral meshing.
sizeGrowth (Optional[SymbolicConstant], default: None) – A SymbolicConstant specifying element size growth to be applied when generating the interior of a tetrahedral mesh. Possible values are MODERATE and MAXIMUM. If unspecified, the existing value will remain unchanged. This option only applies to the default tetrahedral mesher.
allowMapped (Union[AbaqusBoolean, bool], default: OFF) –
A Boolean specifying whether mapped meshing can be used to replace the selected mesh technique. The allowMapped argument is applicable only in the following cases:
- Free triangular meshing.
- Free quadrilateral or quadrilateral-dominated meshing with algorithm = ADVANCING_FRONT.
- Hexahedral or hexahedral-dominated sweep meshing with algorithm = ADVANCING_FRONT.
- Free tetrahedral meshing. allowMapped = True implies that mapped triangular meshing can be used on faces that bound three-dimensional regions.

setMeshNumberingControl(instances, startNodeLabel=None, startElemLabel=None)[source]#

This method changes the start node and/or element labels on the specified independent part instances before or after Abaqus/CAE generates the meshes. For the meshed instances, Abaqus/CAE changes the node and/or element labels while preserving the original order and incrementation.

Note

Check AssemblyBase.setMeshNumberingControl on help.3ds.com/0.1..

Parameters:

instances (Tuple[PartInstance, ...]) – A sequence of PartInstance objects to change the start node and/or element labels.
startNodeLabel (Optional[int], default: None) – A positive Integer specifying the new start node label.
startElemLabel (Optional[int], default: None) – A positive Integer specifying the new start element label.

setSweepPath(region, edge, sense)[source]#

This method sets the sweep path for a sweepable region or the revolve path for a revolvable region.

Note

Check MeshAssembly.setSweepPath on help.3ds.com/0.1..

Parameters:

region (str) – A sweepable region.
edge (Edge) – An Edge object specifying the sweep or revolve path.
sense (SymbolicConstant) – A SymbolicConstant specifying the sweep sense. The sense will affect only how gasket elements will be created; it will have no effect if gasket elements are not used. Possible values are FORWARD or REVERSE.If sense = FORWARD, the sense of the given edge’s underlying curve will be used.

setValues(regenerateConstraintsTogether)[source]#

This method modifies the behavior associated with the specified assembly.

Note

Check AssemblyBase.setValues on help.3ds.com/0.1..

Parameters:: regenerateConstraintsTogether (Union[AbaqusBoolean, bool]) – A Boolean specifying whether the positioning constraints in the assembly should be regenerated together before regenerating other assembly features. The default value is ON.If the assembly has position constraint features and you modify the value of regenerateConstraintsTogether, Abaqus/CAE will regenerate the assembly features.
Raises:: FeatureError – If one or more features in the assembly fails to regenerate

sets: Dict[str, Set] = {}[source]#: A repository of Set objects.

skins: Dict[str, Skin] = {}[source]#: A repository of Skin objects specifying the skins created on the assembly.

smoothNodes(nodes=())[source]#

This method smooths the given nodes of a native mesh, moving them locally to a more optimal location that improves the quality of the mesh

Note

Check AssemblyBase.smoothNodes on help.3ds.com/0.1..

Parameters:

nodes (Tuple[MeshNode, ...], default: ()) –

A sequence of MeshNode objects or a Set object containing nodes.

Changed in version 2020: The coordinates arguments was removed, the nodes now replaces it.

splitElement(elements)[source]#

This method splits quadrilateral elements into triangular elements.

Parameters:: elements (tuple) – A sequence of quadrilateral MeshElement objects specifying the elements to split. Each quadrilateral element is split into two triangular elements by the shorter diagonal.

splitMeshEdge(edge, parameter=0)[source]#

This method splits an edge of a quadrilateral or triangular element of a part instance.

Note

Check MeshEditAssembly.splitMeshEdge on help.3ds.com/0.1..

Parameters:

edge (str) – A single MeshEdge object specifying the element edge to split.
parameter (float, default: 0) – A Float specifying the normalized distance along the edge at which to split. Possible values are 0.0 << parameter << 1.0. The default value is 0.5.

stringers: Dict[str, Stringer] = {}[source]#: A repository of Stringer objects specifying the stringers created on the assembly.

suppress()[source]#: This method suppresses features. Suppressing a feature is equivalent to temporarily removing the feature from the part or assembly. Suppressed features remain suppressed when you regenerate a part or assembly. You cannot suppress the base feature. In addition, if you suppress a parent feature, all of its child features are also suppressed automatically. Suppressed features can be restored with the resume command.

suppressFeatures(featureNames)[source]#

This method suppresses specified features.

Note

Check AssemblyBase.suppressFeatures on help.3ds.com/0.1..

Parameters:: featureNames (tuple) – A sequence of Strings specifying the names of features to suppress in the assembly.

surfaces: Dict[str, Surface] = {}[source]#: A repository of Surface objects specifying for more information, see [Region commands](https://help.3ds.com/2022/english/DSSIMULIA_Established/SIMACAEKERRefMap/simaker-m-RegPyc-sb.htm?ContextScope=all).

swapMeshEdge(edge)[source]#

This method swaps the diagonal of two adjacent triangular elements of a part instance.

Note

Check MeshEditAssembly.swapMeshEdge on help.3ds.com/0.1..

Parameters:: edge (str) – A single MeshEdge object specifying the element edge to swap.

timeStamp: Optional[float] = None[source]#: A Float specifying which gives an indication when the assembly was last modified.

translate(instanceList, vector)[source]#

This method translates given instances by the specified amount.

Note

Check AssemblyBase.translate on help.3ds.com/0.1..

Parameters:

instanceList (tuple) – A sequence of Strings specifying the names of instances to translate.
vector (tuple) – A sequence of three Floats specifying a translation vector.

undoMeshEdit()[source]#: This method undoes the most recent edit mesh or the bottom-up meshing operation on an assembly and restores the mesh on the affected part instance to its previous state. An edit mesh undo action must be available for the assembly. This implies that prior to executing an edit mesh command on the assembly, the user enabled edit mesh undo with a sufficient cache allowance to store the edit mesh operation.

unlinkInstances(instances)[source]#

This method converts the specified PartInstance objects from linked child instances to regular instances. The parts associated with the selected instances will be converted to regular parts as well.

Note

Check AssemblyBase.unlinkInstances on help.3ds.com/0.1..

Parameters:: instances (Tuple[PartInstance, ...]) – A sequence of PartInstance objects to be converted to regular part instances.

unlock()[source]#: This method unlocks the assembly. Unlocking the assembly allows it to be regenerated after any modifications to the assembly.

verifyMeshQuality(criterion, threshold=None, elemShape=None, regions=())[source]#

This method tests the quality of part instance meshes and returns poor-quality elements.

Note

Check MeshAssembly.verifyMeshQuality on help.3ds.com/0.1..

Parameters:

criterion (SymbolicConstant) –
A SymbolicConstant specifying the criterion used for the quality check. Possible values are:
- ANALYSIS_CHECKS When this criterion is specified Abaqus/CAE will invoke the element quality checks included with the input file processor for Abaqus/Standard and Abaqus/Explicit.
- ANGULAR_DEVIATION The maximum amount (in degrees) that an element’s face corner angles deviate from the ideal angle. The ideal angle is 90° for quadrilateral element faces and 60° for triangular element faces. Elements with an angular deviation larger than the specified threshold will fail this test.
- ASPECT_RATIO The ratio between the lengths of the longest and shortest edges of an element. Elements with an aspect ratio larger than the specified threshold will fail this test.
- GEOM_DEVIATION_FACTOR The largest geometric deviation factor evaluated along any of the element edges associated with geometric edges or faces. The geometric deviation factor along an element edge is calculated by dividing the maximum gap between the element edge and its associated geometry by the length of the element edge. Elements with a geometric deviation factor larger than the specified threshold will fail this test.
- LARGE_ANGLE The largest corner angle on any of an element’s faces. Elements with face angles larger than the specified threshold (in degrees) will fail this test.
- LONGEST_EDGE The length of an element’s longest edge. Elements with an edge longer than the specified threshold will fail this test.
- MAX_FREQUENCY An estimate of an element’s contribution to the initial maximum allowable frequency for Abaqus/Standard analyses. This calculation requires appropriate section assignments and material definitions. Elements whose maximum allowable frequency is smaller than the given value will fail this test.
- SHAPE_FACTOR The shape factor for triangular and tetrahedral elements. This is the ratio between the element area or volume and the optimal element area or volume. Elements with a shape factor smaller than the specified threshold will fail this test.
- SHORTEST_EDGE The length of an element’s shortest edge. Elements with an edge shorter than the specified threshold will fail this test.
- SMALL_ANGLE The smallest corner angle on any of an element’s faces. Elements with face angles smaller than the given value (in degrees) will fail this test.
- STABLE_TIME_INCREMENT An estimate of an element’s contribution to the initial maximum stable time increment for Abaqus/Explicit analyses. This calculation requires appropriate section assignments and material definitions. Elements that require a time increment smaller than the given value will fail this test.
threshold (Optional[float], default: None) – A Float value used to determine low quality elements according to the specified criterion. This argument is ignored when the ANALYSIS_CHECKS criterion is used. For other criterion, if this argument is unspecified then no list of failed elements will be returned.
elemShape (Optional[SymbolicConstant], default: None) – A SymbolicConstant specifying an element shape for limiting the query. Possible values are LINE, QUAD, TRI, HEX, WEDGE, and TET.
regions (tuple, default: ()) – A sequence of Region or MeshElement objects. If you do not specify the regions argument, all meshes in the assembly are considered.

Returns:

A Dictionary object containing values for some number of the following keys: failedElements, warningElements, naElements (sequences of MeshElement objects); numElements (Int); average, worst (Float); worstElement (MeshElement object) .

Return type:

Dict[str, int | float | MeshElement]

vertices: VertexArray = [][source]#: A VertexArray object specifying all the vertices existing at the assembly level. This member does not provide access to the vertices at the instance level.

writeAcisFile(fileName, version=None)[source]#

This method exports the assembly to a named file in ACIS part (SAT) or assembly (ASAT) format.

Note

Check AssemblyBase.writeAcisFile on help.3ds.com/0.1..

Parameters:

fileName (str) – A String specifying the name of the file to which to write. The file name’s extension is used to determine whether a part or assembly is written. Use the file extension .asat for the assembly format.
version (Optional[float], default: None) – A Float specifying the ACIS version. For example, the Float 12.0 corresponds to ACIS Version 12.0. The default value is the current version of ACIS.

writeCADParameters(paramFile, modifiedParams=(), updatePaths='')[source]#

This method writes the parameters that were imported from the CAD system to a parameter file.

Note

Check AssemblyBase.writeCADParameters on help.3ds.com/0.1..

Parameters:

paramFile (str) – A String specifying the parameter file name.
modifiedParams (tuple, default: ()) – A tuple of tuples each containing the part name, the parameter name and the modified parameter value. Default is an empty tuple.
updatePaths (str, default: '') – A Bool specifying whether to update the path of the CAD model file specified in the parameterFile to the current directory, if the CAD model is present in the current directory.

AssemblyBase#

class AssemblyBase[source]#

An Assembly object is a container for instances of parts. The Assembly object has no constructor command. Abaqus creates the rootAssembly member when a Model object is created.

Note

This object can be accessed by:

import assembly
mdb.models[name].rootAssembly

Note

Check AssemblyBase on help.3ds.com/0.1..

Public Data Attributes:

`isOutOfDate`	An Int specifying that feature parameters have been modified but that the assembly has not been regenerated.
`timeStamp`	A Float specifying which gives an indication when the assembly was last modified.
`isLocked`	An Int specifying whether the assembly is locked or not.
`regenerateConstraintsTogether`	A Boolean specifying whether the positioning constraints in the assembly should be regenerated together before regenerating other assembly features.
`vertices`	A `VertexArray` object specifying all the vertices existing at the assembly level.
`edges`	An `EdgeArray` object specifying all the edges existing at the assembly level.
`elements`	A `MeshElementArray` object specifying all the elements existing at the assembly level.
`nodes`	A `MeshNodeArray` object specifying all the nodes existing at the assembly level.
`instances`	A repository of PartInstance objects.
`datums`	A repository of Datum objects specifying all Datum objects in the assembly.
`features`	A repository of Feature objects specifying all Feature objects in the assembly.
`featuresById`	A repository of Feature objects specifying all Feature objects in the assembly.The Feature objects in the featuresById repository are the same as the Feature objects in the features repository.
`surfaces`	A repository of Surface objects specifying for more information, see [Region commands](https://help.3ds.com/2022/english/DSSIMULIA_Established/SIMACAEKERRefMap/simaker-m-RegPyc-sb.htm?ContextScope=all).
`allSurfaces`	A repository of Surface objects specifying for more information, see [Region commands](https://help.3ds.com/2022/english/DSSIMULIA_Established/SIMACAEKERRefMap/simaker-m-RegPyc-sb.htm?ContextScope=all).
`allInternalSurfaces`	A repository of Surface objects specifying picked regions.
`sets`	A repository of Set objects.
`allSets`	A repository of Set objects specifying for more information, see [Region commands](https://help.3ds.com/2022/english/DSSIMULIA_Established/SIMACAEKERRefMap/simaker-m-RegPyc-sb.htm?ContextScope=all).
`allInternalSets`	A repository of Set objects specifying picked regions.
`skins`	A repository of Skin objects specifying the skins created on the assembly.
`stringers`	A repository of Stringer objects specifying the stringers created on the assembly.
`referencePoints`	A repository of ReferencePoint objects.
`modelInstances`	A repository of ModelInstance objects.
`allInstances`	A `PartInstance` object specifying the PartInstances and A `ModelInstance` object specifying the ModelInstances.
`engineeringFeatures`	An `EngineeringFeature` object.
`modelName`	A String specifying the name of the model to which the assembly belongs.
`connectorOrientations`	A `ConnectorOrientationArray` object.
`sectionAssignments`	A `SectionAssignmentArray` object.

Inherited from Feature

`name`	A String specifying the repository key.
`id`	An Int specifying the ID of the feature.

Public Methods:

`Instance`()	This method creates a PartInstance object and puts it into the instances repository.
`backup`()	This method makes a backup copy of the features in the assembly.
`clearGeometryCache`()	This method deletes the geometry cache.
`deleteAllFeatures`()	This method deletes all the features in the assembly.
`deleteFeatures`(featureNames)	This method deletes specified features from the assembly.
`excludeFromSimulation`(instances, exclude)	This method excludes the specified part instances from the analysis.
`featurelistInfo`()	This method prints the name and status of all the features in the feature lists.
`getMassProperties`([regions, ...])	This method returns the mass properties of the assembly, or instances or regions.
`getAngle`(plane1, plane2, line1, line2[, ...])	This method returns the angle between the specified entities.
`getCoordinates`(entity)	This method returns the coordinates of a specified point.
`getDistance`(entity1, entity2[, ...])	Depending on the arguments provided, this method returns one of the following:
`getFacesAndVerticesOfAttachmentLines`(edges)	Given an array of edge objects, this method returns a tuple of dictionary objects.
`getSurfaceSections`(surface)	This method returns a list of the sections assigned to the regions encompassed by the specified surface.
`importEafFile`(filename[, ids])	This method imports an assembly from an EAF file into the root assembly.
`importParasolidFile`(filename[, ids])	This method imports an assembly from the Parasolid file into the root assembly.
`importCatiaV5File`(filename[, ids])	This method imports an assembly from a CATIA V5 Elysium Neutral file into the root assembly.
`importEnfFile`(filename[, ids])	This method imports an assembly from an Elysium Neutral file created by Pro/ENGINEER, I-DEAS, or CATIA V5 into the root assembly.
`importIdeasFile`(filename[, ids])	This method imports an assembly from an I-DEAS Elysium Neutral file into the root assembly.
`importProEFile`(filename[, ids])	This method imports an assembly from a Pro/ENGINEER Elysium Neutral file into the root assembly.
`makeDependent`(instances)	This method converts the specified part instances from independent to dependent part instances.
`makeIndependent`(instances)	This method converts the specified part instances from dependent to independent part instances.
`printAssignedSections`()	This method prints a summary of assigned connector sections.
`printConnectorOrientations`()	This method prints a summary of connector orientations.
`projectReferencesOntoSketch`(sketch[, ...])	This method projects the specified edges, vertices, and datum points from the assembly onto the specified ConstrainedSketch object.
`queryCachedStates`()	This method displays the position of geometric states relative to the sequence of features in the assembly cache.
`regenerate`()	This method regenerates the assembly and brings it up to date with the latest values of the assembly parameters.
`regenerationWarnings`()	This method prints any regeneration warnings associated with the features.
`restore`()	This method restores the parameters of all features in the assembly to the value they had before a failed regeneration.
`resumeAllFeatures`()	This method resumes all the suppressed features in the part or assembly.
`resumeFeatures`(featureNames)	This method resumes the specified suppressed features in the assembly.
`resumeLastSetFeatures`()	This method resumes the last set of features to be suppressed in the assembly.
`rotate`(instanceList, axisPoint, ...)	This method rotates given instances by the specified amount.
`translate`(instanceList, vector)	This method translates given instances by the specified amount.
`saveGeometryCache`()	This method caches the current geometry, which improves regeneration performance.
`setValues`(regenerateConstraintsTogether)	This method modifies the behavior associated with the specified assembly.
`suppressFeatures`(featureNames)	This method suppresses specified features.
`unlinkInstances`(instances)	This method converts the specified PartInstance objects from linked child instances to regular instances.
`writeAcisFile`(fileName[, version])	This method exports the assembly to a named file in ACIS part (SAT) or assembly (ASAT) format.
`writeCADParameters`(paramFile[, ...])	This method writes the parameters that were imported from the CAD system to a parameter file.
`lock`()	This method locks the assembly.
`unlock`()	This method unlocks the assembly.
`setMeshNumberingControl`(instances[, ...])	This method changes the start node and/or element labels on the specified independent part instances before or after Abaqus/CAE generates the meshes.
`copyMeshPattern`([elements, faces, ...])	This method copies a mesh pattern from a source region consisting of a set of shell elements or element faces onto a target face, mapping nodes and elements in a one-one correspondence between source and target.
`smoothNodes`([nodes])	This method smooths the given nodes of a native mesh, moving them locally to a more optimal location that improves the quality of the mesh

Inherited from AssemblyFeature

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

Inherited from Feature

`AttachmentPoints`(name, points[, ...])	This method creates an attachment points Feature.
`AttachmentPointsAlongDirection`(name, ...[, ...])	This method creates a Feature object by creating attachment points along a direction or between two points.
`AttachmentPointsOffsetFromEdges`(name, edges)	This method creates a Feature object by creating attachment points along or offset from one or more connected edges.
`DatumAxisByCylFace`(face)	This method creates a Feature object and a DatumAxis object along the axis of a cylinder or cone.
`DatumAxisByNormalToPlane`(plane, point)	This method creates a Feature object and a DatumAxis object normal to the specified plane and passing through the specified point.
`DatumAxisByParToEdge`(edge, point)	This method creates a Feature object and a DatumAxis object parallel to the specified edge and passing through the specified point.
`DatumAxisByPrincipalAxis`(principalAxis)	This method creates a Feature object and a DatumAxis object along one of the three principal axes.
`DatumAxisByRotation`(args, *kwargs)
`DatumAxisByThreePoint`(point1, point2, point3)	This method creates a Feature object and a DatumAxis object normal to the circle described by three points and through its center.
`DatumAxisByThruEdge`(edge)	This method creates a Feature object and a DatumAxis object along the specified edge.
`DatumAxisByTwoPlane`(plane1, plane2)	This method creates a Feature object and a DatumAxis object at the intersection of two planes.
`DatumAxisByTwoPoint`(point1, point2)	This method creates a Feature object and a DatumAxis object along the line joining two points.
`DatumCsysByDefault`(coordSysType[, name])	This method creates a Feature object and a DatumCsys object from the specified default coordinate system at the origin.
`DatumCsysByOffset`(coordSysType, ...[, name])	This method creates a Feature object and a DatumCsys object by offsetting the origin of an existing datum coordinate system to a specified point.
`DatumCsysByThreePoints`(coordSysType, origin, ...)	This method creates a Feature object and a DatumCsys object from three points.
`DatumCsysByTwoLines`(coordSysType, line1, line2)	This method creates a Feature object and a DatumCsys object from two orthogonal lines.
`DatumPlaneByPrincipalPlane`(principalPlane, ...)	This method creates a Feature object and a DatumPlane object through the origin along one of the three principal planes.
`DatumPlaneByOffset`(args, *kwargs)
`DatumPlaneByRotation`(plane, axis, angle)	This method creates a Feature object and a DatumPlane object by rotating a plane about the specified axis through the specified angle.
`DatumPlaneByThreePoints`(point1, point2, point3)	This method creates a Feature object and a DatumPlane object defined by passing through three points.
`DatumPlaneByLinePoint`(line, point)	This method creates a Feature object and a DatumPlane object that pass through the specified line and through the specified point that does not lie on the line.
`DatumPlaneByPointNormal`(point, normal)	This method creates a Feature object and a DatumPlane object normal to the specified line and running through the specified point.
`DatumPlaneByTwoPoint`(point1, point2)	This method creates a Feature object and a DatumPlane object midway between two points and normal to the line connecting the points.
`DatumPointByCoordinate`(coords)	This method creates a Feature object and a DatumPoint object at the point defined by the specified coordinates.
`DatumPointByOffset`(point, vector)	This method creates a Feature object and a DatumPoint object offset from an existing point by a vector.
`DatumPointByMidPoint`(point1, point2)	This method creates a Feature object and a DatumPoint object midway between two points.
`DatumPointByOnFace`(face, edge1, offset1, ...)	This method creates a Feature object and a DatumPoint object on the specified face, offset from two edges.
`DatumPointByEdgeParam`(edge, parameter)	This method creates a Feature object and a DatumPoint object along an edge at a selected distance from one end of the edge.
`DatumPointByProjOnEdge`(point, edge)	This method creates a Feature object and a DatumPoint object along an edge by projecting an existing point along the normal to the edge.
`DatumPointByProjOnFace`(point, face)	This method creates a Feature object and a DatumPoint object on a specified face by projecting an existing point onto the face.
`MakeSketchTransform`(sketchPlane[, origin, ...])	This method creates a Transform object.
`PartitionCellByDatumPlane`(cells, datumPlane)	This method partitions one or more cells using the given datum plane.
`PartitionCellByExtendFace`(cells, extendFace)	This method partitions one or more cells by extending the underlying geometry of a given face to partition the target cells.
`PartitionCellByExtrudeEdge`(cells, edges, ...)	This method partitions one or more cells by extruding selected edges in the given direction.
`PartitionCellByPatchNCorners`(cell, cornerPoints)	This method partitions a cell using an N-sided cutting patch defined by the given corner points.
`PartitionCellByPatchNEdges`(cell, edges)	This method partitions a cell using an N-sided cutting patch defined by the given edges.
`PartitionCellByPlaneNormalToEdge`(cells, ...)	This method partitions one or more cells using a plane normal to an edge at the given edge point.
`PartitionCellByPlanePointNormal`(cells, ...)	This method partitions one or more cells using a plane defined by a point and a normal direction.
`PartitionCellByPlaneThreePoints`(cells, ...)	This method partitions one or more cells using a plane defined by three points.
`PartitionCellBySweepEdge`(cells, edges, sweepPath)	This method partitions one or more cells by sweeping selected edges along the given sweep path.
`PartitionEdgeByDatumPlane`(edges, datumPlane)	This method partitions an edge where it intersects with a datum plane.
`PartitionEdgeByParam`(edges, parameter)	This method partitions one or more edges at the given normalized edge parameter.
`PartitionEdgeByPoint`(edge, point)	This method partitions an edge at the given point.
`PartitionFaceByAuto`(face)	This method automatically partitions a target face into simple regions that can be meshed using a structured meshing technique.
`PartitionFaceByCurvedPathEdgeParams`(face, ...)	This method partitions a face normal to two edges, using a curved path between the two given edge points defined by the normalized edge parameters.
`PartitionFaceByCurvedPathEdgePoints`(face, ...)	This method partitions a face normal to two edges, using a curved path between the two given edge points.
`PartitionFaceByDatumPlane`(faces, datumPlane)	This method partitions one or more faces using the given datum plane.
`PartitionFaceByExtendFace`(faces, extendFace)	This method partitions one or more faces by extending the underlying geometry of another given face to partition the target faces.
`PartitionFaceByIntersectFace`(faces, cuttingFaces)	This method partitions one or more faces using the given cutting faces to partition the target faces.
`PartitionFaceByProjectingEdges`(faces, edges)	This method partitions one or more faces by projecting the given edges on the target faces.
`PartitionFaceByShortestPath`(faces, point1, ...)	This method partitions one or more faces using a minimum distance path between the two given points.
`PartitionFaceBySketch`(faces, sketch[, ...])	This method partitions one or more planar faces by sketching on them.
`PartitionFaceBySketchDistance`(faces, ...[, ...])	This method partitions one or more faces by sketching on a sketch plane and then projecting the sketch toward the target faces through the given distance.
`PartitionFaceBySketchRefPoint`(faces, ...[, ...])	This method partitions one or more faces by sketching on a sketch plane and then projecting the sketch toward the target faces through a distance governed by the reference point.
`PartitionFaceBySketchThruAll`(faces, ...[, ...])	This method partitions one or more faces by sketching on a sketch plane and then projecting toward the target faces through an infinite distance.
`ReferencePoint`(point[, instanceName])	This method creates a Feature object and a ReferencePoint object at the specified location.
`RemoveWireEdges`(wireEdgeList)	This method removes wire edges.
`WirePolyLine`(points[, mergeType, meshable])	This method creates an additional Feature object by creating a series of wires joining points in pairs.
`isSuppressed`()	This method queries the suppressed state of the feature.
`restore`()	This method restores the parameters of all features in the assembly to the value they had before a failed regeneration.
`resume`()	This method resumes suppressed features.
`setValues`(regenerateConstraintsTogether)	This method modifies the behavior associated with the specified assembly.
`suppress`()	This method suppresses features.

Instance(name: str, part: Part, autoOffset: Union[AbaqusBoolean, bool] = OFF, dependent: Union[AbaqusBoolean, bool] = OFF) → PartInstance[source]#

Instance(name: str, model: AssemblyModel, autoOffset: Union[AbaqusBoolean, bool] = OFF) → ModelInstance

This method creates a PartInstance object and puts it into the instances repository.

Note

This function can be accessed by:

mdb.models[name].rootAssembly.Instance

Note

Check Instance on help.3ds.com/0.1..

Parameters:

name (str) – A String specifying the repository key. The name must be a valid Abaqus object name.
kwargs – Key-value arguments

Returns:

A PartInstance object.

Return type:

PartInstance

allInstances: Dict[str, Union[PartInstance, ModelInstance]] = {}[source]#: A PartInstance object specifying the PartInstances and A ModelInstance object specifying the ModelInstances.

allInternalSets: Dict[str, Set] = {}[source]#: A repository of Set objects specifying picked regions.

allInternalSurfaces: Dict[str, Surface] = {}[source]#: A repository of Surface objects specifying picked regions.

allSets: Dict[str, Set] = {}[source]#: A repository of Set objects specifying for more information, see [Region commands](https://help.3ds.com/2022/english/DSSIMULIA_Established/SIMACAEKERRefMap/simaker-m-RegPyc-sb.htm?ContextScope=all).

allSurfaces: Dict[str, Surface] = {}[source]#: A repository of Surface objects specifying for more information, see [Region commands](https://help.3ds.com/2022/english/DSSIMULIA_Established/SIMACAEKERRefMap/simaker-m-RegPyc-sb.htm?ContextScope=all).

backup()[source]#: This method makes a backup copy of the features in the assembly. The backup() method is used in conjunction with the restore() method.

clearGeometryCache()[source]#: This method deletes the geometry cache. Deleting the geometry cache reduces the amount of memory being used.

connectorOrientations: List[ConnectorOrientation] = [][source]#: A ConnectorOrientationArray object.

copyMeshPattern(elements=(), faces=(), elemFaces=(), targetFace=None, nodes=(), coordinates=())[source]#

This method copies a mesh pattern from a source region consisting of a set of shell elements or element faces onto a target face, mapping nodes and elements in a one-one correspondence between source and target.

Note

Check AssemblyBase.copyMeshPattern on help.3ds.com/0.1..

Parameters:

elements (Tuple[MeshElement, ...], default: ()) – A sequence of MeshElement objects or a Set object containing elements and specifying the source region.
faces (Tuple[Face, ...], default: ()) – A sequence of Face objects that have associated with shell elements or element faces and specifying the source region.
elemFaces (Tuple[MeshFace, ...], default: ()) – A sequence of MeshFace objects specifying the source region.
targetFace (Optional[MeshFace], default: None) – A MeshFace object specifying the target region. The target face can be of a different part instance.
nodes (Tuple[MeshNode, ...], default: ()) – A sequence of MeshNode objects or a Set object containing nodes on the boundary of source region which are to be positioned to the boundary of target face.
coordinates (tuple, default: ()) – A sequence of three-dimensional coordinate tuples specifying the coordinates for each of the given nodes. When specified, the number of coordinate tuples must match the number of given nodes, and be ordered to correspond to the given nodes in ascending order according to index. These coordinates are positions of the nodes of a mesh that will be the target face corresponding to nodes provided.

datums: List[Datum] = [][source]#: A repository of Datum objects specifying all Datum objects in the assembly.

deleteAllFeatures()[source]#: This method deletes all the features in the assembly.

deleteFeatures(featureNames)[source]#

This method deletes specified features from the assembly.

Note

Check AssemblyBase.deleteFeatures on help.3ds.com/0.1..

Parameters:: featureNames (tuple) – A sequence of Strings specifying the feature names that will be deleted from the assembly.

edges: EdgeArray = [][source]#: An EdgeArray object specifying all the edges existing at the assembly level. This member does not provide access to the edges at the instance level.

elements: MeshElementArray = [][source]#: A MeshElementArray object specifying all the elements existing at the assembly level. This member does not provide access to the elements at the instance level.

engineeringFeatures: EngineeringFeature = <abaqus.EngineeringFeature.EngineeringFeature.EngineeringFeature object>[source]#: An EngineeringFeature object.

excludeFromSimulation(instances, exclude)[source]#

This method excludes the specified part instances from the analysis.

Note

Check AssemblyBase.excludeFromSimulation on help.3ds.com/0.1..

Parameters:

instances (Tuple[PartInstance, ...]) – A sequence of PartInstance objects to be excluded from the analysis.
exclude (str) – A Bool specifying whether to exclude the selected instances from the analysis or include them.

featurelistInfo()[source]#: This method prints the name and status of all the features in the feature lists.

features: Dict[str, AssemblyFeature] = {}[source]#: A repository of Feature objects specifying all Feature objects in the assembly.

featuresById: Dict[str, AssemblyFeature] = {}[source]#: A repository of Feature objects specifying all Feature objects in the assembly.The Feature objects in the featuresById repository are the same as the Feature objects in the features repository. However, the key to the objects in the featuresById repository is an integer specifying the ID, whereas the key to the objects in the features repository is a string specifying the name.

getAngle(plane1, plane2, line1, line2, commonVertex='')[source]#

This method returns the angle between the specified entities.

Note

Check AssemblyBase.getAngle on help.3ds.com/0.1..

Parameters:

plane1 (str) – A Face, MeshFace, or a Datum object specifying the first plane. The Datum object must represent a datum plane. The plane1 and line1 arguments are mutually exclusive. One of them must be specified.
plane2 (str) – A Face, MeshFace, or a Datum object specifying the second plane. The Datum object must represent a datum plane. The plane2 and line2 arguments are mutually exclusive. One of them must be specified.
line1 (str) – An Edge, MeshEdge, or a Datum object specifying the first curve. The Datum object must represent a datum axis. The plane1 and line1 arguments are mutually exclusive. One of them must be specified.
line2 (str) – An Edge, MeshEdge, or a Datum object specifying the second curve. The Datum object must represent a datum axis. The plane2 and line2 arguments are mutually exclusive. One of them must be specified.
commonVertex (str, default: '') – If the two selected Edge objects have more than one vertex in common, this ConstrainedSketchVertex object specifies the vertex at which to evaluate the angle.

Returns:

A Float specifying the angle between the specified entities. If you provide a plane as an argument, Abaqus/CAE computes the angle using the normal to the plane.

Return type:

float

getCoordinates(entity)[source]#

This method returns the coordinates of a specified point.

Note

Check AssemblyBase.getCoordinates on help.3ds.com/0.1..

Parameters:: entity (str) – A ConstrainedSketchVertex, Datum point, MeshNode, or ReferencePoint specifying the entity to query.
Returns:: A tuple of three Floats representing the coordinates of the specified point.
Return type:: Tuple[float, float]

getDistance(entity1, entity2, printResults=OFF, csys=<abaqus.Datum.DatumCsys.DatumCsys object>)[source]#

Depending on the arguments provided, this method returns one of the following:

The distance between two points.
The minimum distance between a point and an edge.
The minimum distance between two edges.

Note

Check AssemblyBase.getDistance on help.3ds.com/0.1..

Parameters:

entity1 (str) – A ConstrainedSketchVertex, Datum point, MeshNode, or Edge specifying the first entity from which to measure.
entity2 (str) – A ConstrainedSketchVertex, Datum point, MeshNode, or Edge specifying the second entity to which to measure.
printResults (Union[AbaqusBoolean, bool], default: OFF) – A Boolean that determines whether a verbose output is to be printed. The default is True
csys (DatumCsys, default: <abaqus.Datum.DatumCsys.DatumCsys object at 0x7f350e2347f0>) –
A DatumCsys object specifying the desired coordinate system of the returned coordinates. By default, coordinates are given in the global coordinate system.

New in version 2022: The csys argument was added.

Returns:

A Float specifying the calculated distance.

Return type:

float

getFacesAndVerticesOfAttachmentLines(edges)[source]#

Given an array of edge objects, this method returns a tuple of dictionary objects. Each object consists of five members including the attachment line and associated face and vertex objects.

Note

Check AssemblyBase.getFacesAndVerticesOfAttachmentLines on help.3ds.com/0.1..

Parameters:

edges (EdgeArray) – An EdgeArray object which is a sequence of Edge objects.

Returns:

A tuple of dictionary objects. Each dictionary contains five items with the following keys:

edge: An Edge object specifying the attachment line.
startFace: A Face object specifying the face associated with one end of the attachment line.
endFace: A Face object specifying the face associated with the other end of the attachment line.
startVertex: A ConstrainedSketchVertex object specifying the vertex associated with one end of the attachment line. This end is also associated with the startFace.
endVertex: A ConstrainedSketchVertex object specifying the vertex associated with the other end of the attachment line. This end is also associated with the endFace.

Return type:

Tuple[dict, ]

getMassProperties(regions='', relativeAccuracy=abaqusConstants.LOW, useMesh=False, specifyDensity=False, density='', specifyThickness=False, thickness='', miAboutCenterOfMass=True, miAboutPoint=())[source]#

This method returns the mass properties of the assembly, or instances or regions. Only beams, trusses, shells, solids, point, nonstructural mass, and rotary inertia elements are supported.

Note

Check AssemblyBase.getMassProperties on help.3ds.com/0.1..

Parameters:

regions (str, default: '') – A MeshElementArray, CellArray, FaceArray, EdgeArray, or list of PartInstance objects specifying the regions whose mass properties are to be queried. The whole assembly is queried by default.
relativeAccuracy (SymbolicConstant, default: LOW) – A SymbolicConstant specifying the relative accuracy for geometry computation. Possible values are LOW, MEDIUM, and HIGH. The default value is LOW.
useMesh (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether the mesh should be used in the computation if the geometry is meshed. The default value is False.
specifyDensity (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether a user-specified density should be used in regions with density errors such as undefined material density. The default value is False.
density (str, default: '') – A double value specifying the user-specified density value to be used in regions with density errors. The user-specified density should be greater than 0.
specifyThickness (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether a user-specified thickness should be used in regions with thickness errors such as undefined thickness. The default value is False.
thickness (str, default: '') – A double value specifying the user-specified thickness value to be used in regions with thickness errors. The user-specified thickness should be greater than 0.
miAboutCenterOfMass (Union[AbaqusBoolean, bool], default: True) – A Boolean specifying if the moments of inertia should be evaluated about the center of mass. The default value is True.
miAboutPoint (tuple, default: ()) – A tuple of three floats specifying the coordinates of the point about which to evaluate the moment of inertia. By default if the moments of inertia are not being evaluated about the center of mass, they will be evaluated about the origin.

Returns:

properties – A Dictionary object with the following items: area: None or a Float specifying the sum of the area of the specified faces. The area is computed only for one side for shells. areaCentroid: None or a tuple of three Floats representing the coordinates of the area centroid. volume: None or a Float specifying the volume of the specified regions. volumeCentroid: None or a tuple of three Floats representing the coordinates of the volume centroid. massFromMassPerUnitSurfaceArea: None or a Float specifying the mass due to mass per unit surface area. mass: None or a Float specifying the mass of the specified regions. It is the total mass and includes mass from quantities such as mass per unit surface area. centerOfMass: None or a tuple of three Floats representing the coordinates of the center of mass. momentOfInertia: None or a tuple of six Floats representing the moments of inertia about the center of mass or about the point specified. warnings: A tuple of SymbolicConstants representing the problems encountered while computing the mass properties. Possible SymbolicConstants are: UNSUPPORTED_ENTITIES: Some unsupported entities exist in the specified regions. The mass properties are computed only for beams, trusses, shells, solids, point and non-structural mass elements, and rotary inertia elements. The mass properties are not computed for axisymmetric elements, springs, connectors, gaskets, or any other elements. MISSING_THICKNESS: For some regions, the section definitions are missing thickness values. ZERO_THICKNESS: For some regions, the section definitions have a zero thickness value. VARIABLE_THICKNESS: The nodal thickness or field thickness specified for some regions has been ignored. NON_APPLICABLE_THICKNESS: For some regions, the thickness value is not applicable to the corresponding sections specified on the regions. MISSING_DENSITY: For some regions, the section definitions are missing material density values. MISSING_MATERIAL_DEFINITION: For some regions, the material definition is missing. ZERO_DENSITY: For some regions, the section definitions have a zero material density value. UNSUPPORTED_DENSITY: For some regions, either a negative material density or a temperature dependent density has been specified, or the material value is missing for one or more plies in the composite section. SHELL_OFFSETS: For shells, this method does not account for any offsets specified. MISSING_SECTION_DEFINITION: For some regions, the section definition is missing. UNSUPPORTED_SECTION_DEFINITION: The section definition provided for some regions is not supported. REINFORCEMENTS: This method does not account for any reinforcements specified on the model. SMEARED_PROPERTIES: For regions with composite section assignments, the density is smeared across the thickness. The volume centroid and center of mass computations for a composite shell use a lumped mass approach where the volume and mass is assumed to be lumped in the plane of the shell. As a result of these approximations the volume centroid, center of mass and moments of inertia may be slightly inaccurate for regions with composite section assignments. UNSUPPORTED_NON_STRUCTURAL_MASS_ENTITIES: This method does not account for any non-structural mass on wires. INCORRECT_MOMENT_OF_INERTIA: For geometry regions with non-structural mass per volume, the non-structural mass is assumed to be a point mass at the centroid of the regions. Thus, the moments of inertia may be inaccurate as the distribution of the non-structural mass is not accounted for. Use the mesh for accurately computing the moments of inertia. MISSING_BEAM_ORIENTATIONS: For some regions with beam section assignments, the beam section orientations are missing. UNSUPPORTED_BEAM_PROFILES: This method supports the Box, Pipe, Circular, Rectangular, Hexagonal, Trapezoidal, I, L, T, Arbitrary, and Tapered beam profiles. Any other beam profile is not supported. TAPERED_BEAM_MI: Moment of inertia calculations for tapered beams are not accurate. SUBSTRUCTURE_INCORRECT_PROPERTIES: The user assigned density and thickness is not considered for substructures.

Return type:

dict

getSurfaceSections(surface)[source]#

This method returns a list of the sections assigned to the regions encompassed by the specified surface.

Note

Check AssemblyBase.getSurfaceSections on help.3ds.com/0.1..

Parameters:: surface (str) – A string specifying the Surface name.
Returns:: A tuple of strings representing the section names. If no section names are found, the tuple will contain one empty string.
Return type:: Tuple[str, ]

importCatiaV5File(filename, ids=())[source]#

This method imports an assembly from a CATIA V5 Elysium Neutral file into the root assembly.

Note

Check AssemblyBase.importCatiaV5File on help.3ds.com/0.1..

Parameters:

filename (str) – A String specifying the path to the CATIA V5 Elysium Neutral file from which to import the assembly.
ids (tuple, default: ()) – A sequence of Ints. Each Int in the sequence is a unique identifier of the occurrence in the assembly tree or component identifier associated with the part in the EAF file. If ids is an empty sequence, all occurrences or parts will be imported. The default value is an empty sequence.

importEafFile(filename, ids=())[source]#

This method imports an assembly from an EAF file into the root assembly.

Note

Check AssemblyBase.importEafFile on help.3ds.com/0.1..

Parameters:

filename (str) – A String specifying the path to the EAF file from which to import the assembly.
ids (tuple, default: ()) – A sequence of Ints. Each Int in the sequence is a unique identifier of the occurrence in the assembly tree or component identifier associated with the part in the EAF file. If ids is an empty sequence, all occurrences or parts will be imported. The default value is an empty sequence.

importEnfFile(filename, ids=())[source]#

This method imports an assembly from an Elysium Neutral file created by Pro/ENGINEER, I-DEAS, or CATIA V5 into the root assembly.

Note

Check AssemblyBase.importEnfFile on help.3ds.com/0.1..

Parameters:

filename (str) – A String specifying the path to the Elysium Neutral file from which to import the assembly.
ids (tuple, default: ()) – A sequence of Ints. Each Int in the sequence is a unique identifier of the occurrence in the assembly tree or component identifier associated with the part in the EAF file. If ids is an empty sequence, all occurrences or parts will be imported. The default value is an empty sequence.

importIdeasFile(filename, ids=())[source]#

This method imports an assembly from an I-DEAS Elysium Neutral file into the root assembly.

Note

Check AssemblyBase.importIdeasFile on help.3ds.com/0.1..

Parameters:

filename (str) – A String specifying the path to the I-DEAS Elysium Neutral file from which to import the assembly.
ids (tuple, default: ()) – A sequence of Ints. Each Int in the sequence is a unique identifier of the occurrence in the assembly tree or component identifier associated with the part in the EAF file. If ids is an empty sequence, all occurrences or parts will be imported. The default value is an empty sequence.

importParasolidFile(filename, ids=())[source]#

This method imports an assembly from the Parasolid file into the root assembly.

Note

Check AssemblyBase.importParasolidFile on help.3ds.com/0.1..

Parameters:

filename (str) – A String specifying the path to a Parasolid file from which to import the assembly.
ids (tuple, default: ()) – A sequence of Ints. Each Int in the sequence is a unique identifier of the occurrence in the assembly tree or component identifier associated with the part in the EAF file. If ids is an empty sequence, all occurrences or parts will be imported. The default value is an empty sequence.

importProEFile(filename, ids=())[source]#

This method imports an assembly from a Pro/ENGINEER Elysium Neutral file into the root assembly.

Note

Check AssemblyBase.importProEFile on help.3ds.com/0.1..

Parameters:

filename (str) – A String specifying the path to the Pro/ENGINEER Elysium Neutral file from which to import the assembly.
ids (tuple, default: ()) – A sequence of Ints. Each Int in the sequence is a unique identifier of the occurrence in the assembly tree or component identifier associated with the part in the EAF file. If ids is an empty sequence, all occurrences or parts will be imported. The default value is an empty sequence.

instances: Dict[str, PartInstance] = {}[source]#: A repository of PartInstance objects.

isLocked: Optional[int] = None[source]#: An Int specifying whether the assembly is locked or not. Possible values are 0 and 1.

isOutOfDate: Optional[int] = None[source]#: An Int specifying that feature parameters have been modified but that the assembly has not been regenerated. Possible values are 0 and 1.

lock()[source]#: This method locks the assembly. Locking the assembly prevents any further changes to the assembly that can trigger regeneration of the assembly.

makeDependent(instances)[source]#

This method converts the specified part instances from independent to dependent part instances.

Note

Check AssemblyBase.makeDependent on help.3ds.com/0.1..

Parameters:: instances (Tuple[PartInstance, ...]) – A sequence of PartInstance objects to convert to dependent part instances.

makeIndependent(instances)[source]#

This method converts the specified part instances from dependent to independent part instances.

Note

Check AssemblyBase.makeIndependent on help.3ds.com/0.1..

Parameters:: instances (Tuple[PartInstance, ...]) – A sequence of PartInstance objects to convert to independent part instances.

modelInstances: Dict[str, ModelInstance] = {}[source]#: A repository of ModelInstance objects.

modelName: str = ''[source]#: A String specifying the name of the model to which the assembly belongs.

nodes: MeshNodeArray = [][source]#: A MeshNodeArray object specifying all the nodes existing at the assembly level. This member does not provide access to the nodes at the instance level.

printAssignedSections()[source]#: This method prints a summary of assigned connector sections.

printConnectorOrientations()[source]#: This method prints a summary of connector orientations.

projectReferencesOntoSketch(sketch, filter=abaqusConstants.ALL_EDGES, upToFeature=None, edges=(), vertices=())[source]#

This method projects the specified edges, vertices, and datum points from the assembly onto the specified ConstrainedSketch object. The edges, vertices, and datum points appear on the sketch as reference geometry.

Note

Check AssemblyBase.projectReferencesOntoSketch on help.3ds.com/0.1..

Parameters:

sketch (str) – The ConstrainedSketch object on which the edges, vertices, and datum points are projected.
filter (SymbolicConstant, default: ALL_EDGES) – A SymbolicConstant specifying how to limit the amount of projection. Possible values are ALL_EDGES and COPLANAR_EDGES. If filter = COPLANAR_EDGES, edges that are coplanar to the sketching plane are the only candidates for projection. The default value is ALL_EDGES.
upToFeature (Optional[AssemblyFeature], default: None) – A Feature object specifying a marker in the feature-based history of the part. Abaqus/CAE projects onto the sketch only the part entities that were created before the feature specified by this marker. By default, all part entities are candidates for projection.
edges (tuple, default: ()) – A sequence of candidate edges to be projected onto the sketch. By default, all edges are candidates for projection.
vertices (tuple, default: ()) – A sequence of candidate vertices to be projected onto the sketch. By default, all vertices are candidates for projection.

queryCachedStates()[source]#: This method displays the position of geometric states relative to the sequence of features in the assembly cache. The output is displayed in the message area.

referencePoints: Dict[str, ReferencePoint] = {}[source]#: A repository of ReferencePoint objects.

regenerate()[source]#: This method regenerates the assembly and brings it up to date with the latest values of the assembly parameters. When you modify features of an assembly, it may be convenient to postpone regeneration until you make all your changes, since regeneration can be time consuming. In contrast, when you modify features of a part that is included in the assembly, you should use this command to regenerate the assembly. When you regenerate the assembly, it will reflect the changes that you made to the part.

regenerateConstraintsTogether: Union[AbaqusBoolean, bool] = ON[source]#: A Boolean specifying whether the positioning constraints in the assembly should be regenerated together before regenerating other assembly features. The default value is ON.If the assembly has position constraint features and you modify the value of regenerateConstraintsTogether, Abaqus/CAE will regenerate the assembly features.

regenerationWarnings()[source]#: This method prints any regeneration warnings associated with the features.

restore()[source]#: This method restores the parameters of all features in the assembly to the value they had before a failed regeneration. Use the restore method after a failed regeneration, followed by a regenerate command.

resumeAllFeatures()[source]#: This method resumes all the suppressed features in the part or assembly.

resumeFeatures(featureNames)[source]#

This method resumes the specified suppressed features in the assembly.

Note

Check AssemblyBase.resumeFeatures on help.3ds.com/0.1..

Parameters:: featureNames (tuple) – A sequence of Strings specifying the names of features to resume.

resumeLastSetFeatures()[source]#: This method resumes the last set of features to be suppressed in the assembly.

rotate(instanceList, axisPoint, axisDirection, angle)[source]#

This method rotates given instances by the specified amount.

Note

Check AssemblyBase.rotate on help.3ds.com/0.1..

Parameters:

instanceList (tuple) – A sequence of Strings specifying the names of instances to rotate.
axisPoint (tuple) – A sequence of three Floats specifying the coordinates of a point on the axis.
axisDirection (tuple) – A sequence of three Floats specifying the direction of the axis.
angle (float) – A Float specifying the rotation angle in degrees. Use the right-hand rule to determine the direction.

saveGeometryCache()[source]#: This method caches the current geometry, which improves regeneration performance.

sectionAssignments: List[SectionAssignment] = [][source]#: A SectionAssignmentArray object.

setMeshNumberingControl(instances, startNodeLabel=None, startElemLabel=None)[source]#

This method changes the start node and/or element labels on the specified independent part instances before or after Abaqus/CAE generates the meshes. For the meshed instances, Abaqus/CAE changes the node and/or element labels while preserving the original order and incrementation.

Note

Check AssemblyBase.setMeshNumberingControl on help.3ds.com/0.1..

Parameters:

instances (Tuple[PartInstance, ...]) – A sequence of PartInstance objects to change the start node and/or element labels.
startNodeLabel (Optional[int], default: None) – A positive Integer specifying the new start node label.
startElemLabel (Optional[int], default: None) – A positive Integer specifying the new start element label.

setValues(regenerateConstraintsTogether)[source]#

This method modifies the behavior associated with the specified assembly.

Note

Check AssemblyBase.setValues on help.3ds.com/0.1..

Parameters:: regenerateConstraintsTogether (Union[AbaqusBoolean, bool]) – A Boolean specifying whether the positioning constraints in the assembly should be regenerated together before regenerating other assembly features. The default value is ON.If the assembly has position constraint features and you modify the value of regenerateConstraintsTogether, Abaqus/CAE will regenerate the assembly features.
Raises:: FeatureError – If one or more features in the assembly fails to regenerate

sets: Dict[str, Set] = {}[source]#: A repository of Set objects.

skins: Dict[str, Skin] = {}[source]#: A repository of Skin objects specifying the skins created on the assembly.

smoothNodes(nodes=())[source]#

This method smooths the given nodes of a native mesh, moving them locally to a more optimal location that improves the quality of the mesh

Note

Check AssemblyBase.smoothNodes on help.3ds.com/0.1..

Parameters:

nodes (Tuple[MeshNode, ...], default: ()) –

A sequence of MeshNode objects or a Set object containing nodes.

Changed in version 2020: The coordinates arguments was removed, the nodes now replaces it.

stringers: Dict[str, Stringer] = {}[source]#: A repository of Stringer objects specifying the stringers created on the assembly.

suppressFeatures(featureNames)[source]#

This method suppresses specified features.

Note

Check AssemblyBase.suppressFeatures on help.3ds.com/0.1..

Parameters:: featureNames (tuple) – A sequence of Strings specifying the names of features to suppress in the assembly.

surfaces: Dict[str, Surface] = {}[source]#: A repository of Surface objects specifying for more information, see [Region commands](https://help.3ds.com/2022/english/DSSIMULIA_Established/SIMACAEKERRefMap/simaker-m-RegPyc-sb.htm?ContextScope=all).

timeStamp: Optional[float] = None[source]#: A Float specifying which gives an indication when the assembly was last modified.

translate(instanceList, vector)[source]#

This method translates given instances by the specified amount.

Note

Check AssemblyBase.translate on help.3ds.com/0.1..

Parameters:

instanceList (tuple) – A sequence of Strings specifying the names of instances to translate.
vector (tuple) – A sequence of three Floats specifying a translation vector.

unlinkInstances(instances)[source]#

This method converts the specified PartInstance objects from linked child instances to regular instances. The parts associated with the selected instances will be converted to regular parts as well.

Note

Check AssemblyBase.unlinkInstances on help.3ds.com/0.1..

Parameters:: instances (Tuple[PartInstance, ...]) – A sequence of PartInstance objects to be converted to regular part instances.

unlock()[source]#: This method unlocks the assembly. Unlocking the assembly allows it to be regenerated after any modifications to the assembly.

vertices: VertexArray = [][source]#: A VertexArray object specifying all the vertices existing at the assembly level. This member does not provide access to the vertices at the instance level.

writeAcisFile(fileName, version=None)[source]#

This method exports the assembly to a named file in ACIS part (SAT) or assembly (ASAT) format.

Note

Check AssemblyBase.writeAcisFile on help.3ds.com/0.1..

Parameters:

fileName (str) – A String specifying the name of the file to which to write. The file name’s extension is used to determine whether a part or assembly is written. Use the file extension .asat for the assembly format.
version (Optional[float], default: None) – A Float specifying the ACIS version. For example, the Float 12.0 corresponds to ACIS Version 12.0. The default value is the current version of ACIS.

writeCADParameters(paramFile, modifiedParams=(), updatePaths='')[source]#

This method writes the parameters that were imported from the CAD system to a parameter file.

Note

Check AssemblyBase.writeCADParameters on help.3ds.com/0.1..

Parameters:

paramFile (str) – A String specifying the parameter file name.
modifiedParams (tuple, default: ()) – A tuple of tuples each containing the part name, the parameter name and the modified parameter value. Default is an empty tuple.
updatePaths (str, default: '') – A Bool specifying whether to update the path of the CAD model file specified in the parameterFile to the current directory, if the CAD model is present in the current directory.

ConnectorOrientation#

class ConnectorOrientation(region, localCsys1=None, axis1=abaqusConstants.AXIS_1, angle1=0, orient2sameAs1=ON, localCsys2=None, axis2=abaqusConstants.AXIS_1, angle2=0)[source]#

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

Note

This object can be accessed by:

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

Note

Check ConnectorOrientation on help.3ds.com/0.1..

Public Data Attributes:

`localCsys1`	A `DatumCsys` object specifying the local coordinate system of the first connector point.
`axis1`	A SymbolicConstant specifying the axis of a datum coordinate system about which an additional rotation is applied.
`angle1`	A Float specifying the angle of the additional rotation.
`orient2sameAs1`	A Boolean specifying whether or not the second connector point is to use the same local coordinate system, axis, and angle as the first point.
`localCsys2`	A `DatumCsys` object specifying the local coordinate system of the second connector point.
`axis2`	A SymbolicConstant specifying the axis of a datum coordinate system about which an additional rotation is applied.
`angle2`	A Float specifying the angle of the additional rotation.

Public Methods:

`__init__`(region[, localCsys1, axis1, ...])	This method creates a ConnectorOrientation object.
`setValues`(args, *kwargs)	This method modifies the ConnectorOrientation object.

angle1: float = 0[source]#: A Float specifying the angle of the additional rotation. The default value is 0.0.

angle2: float = 0[source]#: A Float specifying the angle of the additional rotation. The default value is 0.0.

axis1: SymbolicConstant = AXIS_1[source]#: A SymbolicConstant specifying the axis of a datum coordinate system about which an additional rotation is applied. Possible values are AXIS_1, AXIS_2, and AXIS_3. The default value is AXIS_1.

axis2: SymbolicConstant = AXIS_1[source]#: A SymbolicConstant specifying the axis of a datum coordinate system about which an additional rotation is applied. Possible values are AXIS_1, AXIS_2, and AXIS_3. The default value is AXIS_1.

localCsys1: Optional[DatumCsys] = None[source]#: A DatumCsys object specifying the local coordinate system of the first connector point. This value may be None, indicating the global coordinate system.

localCsys2: Optional[DatumCsys] = None[source]#: A DatumCsys object specifying the local coordinate system of the second connector point. This value may be None, indicating the global coordinate system.

orient2sameAs1: Union[AbaqusBoolean, bool] = ON[source]#: A Boolean specifying whether or not the second connector point is to use the same local coordinate system, axis, and angle as the first point. The default value is ON.

region: Set[source]#: A Set object specifying the region to which the orientation is assigned.

setValues(*args, **kwargs)[source]#: This method modifies the ConnectorOrientation object.

ConnectorOrientationArray#

ConnectorOrientationArray[source]#: alias of List[ConnectorOrientation]

AssemblyFeature#

class AssemblyFeature[source]#

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

Note

This object can be accessed by:

import assembly

Note

Check AssemblyFeature on help.3ds.com/0.1..

Public Data Attributes:

Inherited from Feature

`name`	A String specifying the repository key.
`id`	An Int specifying the ID of the feature.

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

Inherited from Feature

`AttachmentPoints`(name, points[, ...])	This method creates an attachment points Feature.
`AttachmentPointsAlongDirection`(name, ...[, ...])	This method creates a Feature object by creating attachment points along a direction or between two points.
`AttachmentPointsOffsetFromEdges`(name, edges)	This method creates a Feature object by creating attachment points along or offset from one or more connected edges.
`DatumAxisByCylFace`(face)	This method creates a Feature object and a DatumAxis object along the axis of a cylinder or cone.
`DatumAxisByNormalToPlane`(plane, point)	This method creates a Feature object and a DatumAxis object normal to the specified plane and passing through the specified point.
`DatumAxisByParToEdge`(edge, point)	This method creates a Feature object and a DatumAxis object parallel to the specified edge and passing through the specified point.
`DatumAxisByPrincipalAxis`(principalAxis)	This method creates a Feature object and a DatumAxis object along one of the three principal axes.
`DatumAxisByRotation`(args, *kwargs)
`DatumAxisByThreePoint`(point1, point2, point3)	This method creates a Feature object and a DatumAxis object normal to the circle described by three points and through its center.
`DatumAxisByThruEdge`(edge)	This method creates a Feature object and a DatumAxis object along the specified edge.
`DatumAxisByTwoPlane`(plane1, plane2)	This method creates a Feature object and a DatumAxis object at the intersection of two planes.
`DatumAxisByTwoPoint`(point1, point2)	This method creates a Feature object and a DatumAxis object along the line joining two points.
`DatumCsysByDefault`(coordSysType[, name])	This method creates a Feature object and a DatumCsys object from the specified default coordinate system at the origin.
`DatumCsysByOffset`(coordSysType, ...[, name])	This method creates a Feature object and a DatumCsys object by offsetting the origin of an existing datum coordinate system to a specified point.
`DatumCsysByThreePoints`(coordSysType, origin, ...)	This method creates a Feature object and a DatumCsys object from three points.
`DatumCsysByTwoLines`(coordSysType, line1, line2)	This method creates a Feature object and a DatumCsys object from two orthogonal lines.
`DatumPlaneByPrincipalPlane`(principalPlane, ...)	This method creates a Feature object and a DatumPlane object through the origin along one of the three principal planes.
`DatumPlaneByOffset`(args, *kwargs)
`DatumPlaneByRotation`(plane, axis, angle)	This method creates a Feature object and a DatumPlane object by rotating a plane about the specified axis through the specified angle.
`DatumPlaneByThreePoints`(point1, point2, point3)	This method creates a Feature object and a DatumPlane object defined by passing through three points.
`DatumPlaneByLinePoint`(line, point)	This method creates a Feature object and a DatumPlane object that pass through the specified line and through the specified point that does not lie on the line.
`DatumPlaneByPointNormal`(point, normal)	This method creates a Feature object and a DatumPlane object normal to the specified line and running through the specified point.
`DatumPlaneByTwoPoint`(point1, point2)	This method creates a Feature object and a DatumPlane object midway between two points and normal to the line connecting the points.
`DatumPointByCoordinate`(coords)	This method creates a Feature object and a DatumPoint object at the point defined by the specified coordinates.
`DatumPointByOffset`(point, vector)	This method creates a Feature object and a DatumPoint object offset from an existing point by a vector.
`DatumPointByMidPoint`(point1, point2)	This method creates a Feature object and a DatumPoint object midway between two points.
`DatumPointByOnFace`(face, edge1, offset1, ...)	This method creates a Feature object and a DatumPoint object on the specified face, offset from two edges.
`DatumPointByEdgeParam`(edge, parameter)	This method creates a Feature object and a DatumPoint object along an edge at a selected distance from one end of the edge.
`DatumPointByProjOnEdge`(point, edge)	This method creates a Feature object and a DatumPoint object along an edge by projecting an existing point along the normal to the edge.
`DatumPointByProjOnFace`(point, face)	This method creates a Feature object and a DatumPoint object on a specified face by projecting an existing point onto the face.
`MakeSketchTransform`(sketchPlane[, origin, ...])	This method creates a Transform object.
`PartitionCellByDatumPlane`(cells, datumPlane)	This method partitions one or more cells using the given datum plane.
`PartitionCellByExtendFace`(cells, extendFace)	This method partitions one or more cells by extending the underlying geometry of a given face to partition the target cells.
`PartitionCellByExtrudeEdge`(cells, edges, ...)	This method partitions one or more cells by extruding selected edges in the given direction.
`PartitionCellByPatchNCorners`(cell, cornerPoints)	This method partitions a cell using an N-sided cutting patch defined by the given corner points.
`PartitionCellByPatchNEdges`(cell, edges)	This method partitions a cell using an N-sided cutting patch defined by the given edges.
`PartitionCellByPlaneNormalToEdge`(cells, ...)	This method partitions one or more cells using a plane normal to an edge at the given edge point.
`PartitionCellByPlanePointNormal`(cells, ...)	This method partitions one or more cells using a plane defined by a point and a normal direction.
`PartitionCellByPlaneThreePoints`(cells, ...)	This method partitions one or more cells using a plane defined by three points.
`PartitionCellBySweepEdge`(cells, edges, sweepPath)	This method partitions one or more cells by sweeping selected edges along the given sweep path.
`PartitionEdgeByDatumPlane`(edges, datumPlane)	This method partitions an edge where it intersects with a datum plane.
`PartitionEdgeByParam`(edges, parameter)	This method partitions one or more edges at the given normalized edge parameter.
`PartitionEdgeByPoint`(edge, point)	This method partitions an edge at the given point.
`PartitionFaceByAuto`(face)	This method automatically partitions a target face into simple regions that can be meshed using a structured meshing technique.
`PartitionFaceByCurvedPathEdgeParams`(face, ...)	This method partitions a face normal to two edges, using a curved path between the two given edge points defined by the normalized edge parameters.
`PartitionFaceByCurvedPathEdgePoints`(face, ...)	This method partitions a face normal to two edges, using a curved path between the two given edge points.
`PartitionFaceByDatumPlane`(faces, datumPlane)	This method partitions one or more faces using the given datum plane.
`PartitionFaceByExtendFace`(faces, extendFace)	This method partitions one or more faces by extending the underlying geometry of another given face to partition the target faces.
`PartitionFaceByIntersectFace`(faces, cuttingFaces)	This method partitions one or more faces using the given cutting faces to partition the target faces.
`PartitionFaceByProjectingEdges`(faces, edges)	This method partitions one or more faces by projecting the given edges on the target faces.
`PartitionFaceByShortestPath`(faces, point1, ...)	This method partitions one or more faces using a minimum distance path between the two given points.
`PartitionFaceBySketch`(faces, sketch[, ...])	This method partitions one or more planar faces by sketching on them.
`PartitionFaceBySketchDistance`(faces, ...[, ...])	This method partitions one or more faces by sketching on a sketch plane and then projecting the sketch toward the target faces through the given distance.
`PartitionFaceBySketchRefPoint`(faces, ...[, ...])	This method partitions one or more faces by sketching on a sketch plane and then projecting the sketch toward the target faces through a distance governed by the reference point.
`PartitionFaceBySketchThruAll`(faces, ...[, ...])	This method partitions one or more faces by sketching on a sketch plane and then projecting toward the target faces through an infinite distance.
`ReferencePoint`(point[, instanceName])	This method creates a Feature object and a ReferencePoint object at the specified location.
`RemoveWireEdges`(wireEdgeList)	This method removes wire edges.
`WirePolyLine`(points[, mergeType, meshable])	This method creates an additional Feature object by creating a series of wires joining points in pairs.
`isSuppressed`()	This method queries the suppressed state of the feature.
`restore`()	This method restores the parameters of a feature to the value they had when the backup method was invoked on the part or assembly.
`resume`()	This method resumes suppressed features.
`setValues`([parameter, parameter1, ...])	This method modifies the Feature object.
`suppress`()	This method suppresses features.

static AttachmentLines(name, points, sourceFaces, sourceElementFaces, targetFaces, targetElementFaces, projectionMethod=abaqusConstants.PROJECT_BY_PROXIMITY, projectionDirStartPt=None, projectionDirEndPt=None, sourceToTargetProjMethod=abaqusConstants.PROJECT_BY_NUMBER, numProjections='', projectionDistance='', flipSourceToTargetDirection=OFF, setName='')[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.

Note

This function can be accessed by:

mdb.models[name].rootAssembly.AttachmentLines

Note

Check AttachmentLines on help.3ds.com/0.1..

Parameters:

name (str) – A String specifying a unique Feature name.
points (int) – 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 (Tuple[Face, ...]) – A sequence of Face objects specifying the geometry faces onto which the points are to be projected.
sourceElementFaces (Tuple[MeshFace, ...]) – A sequence of MeshFace objects specifying the orphan mesh element faces onto which the points are to be projected.
targetFaces (Tuple[Face, ...]) – A sequence of Face objects specifying the geometry faces on which the attachment lines will terminate.
targetElementFaces (Tuple[MeshFace, ...]) – A sequence of MeshFace objects specifying the orphan mesh element faces on which the attachment lines will terminate.
projectionMethod (SymbolicConstant, default: PROJECT_BY_PROXIMITY) – 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 (Optional[float], default: None) – 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 (Optional[float], default: None) – 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 (SymbolicConstant, default: PROJECT_BY_NUMBER) – 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 (str, default: '') – 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 (str, default: '') – A float specifying the maximum distance of the projection vector when the source to target projection method is PROJECT_BY_DISTANCE.
flipSourceToTargetDirection (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the computed projection direction from the source to the target faces should be flipped.
setName (str, default: '') – A String specifying a unique set name.

Returns:

A Feature object.

Return type:

AssemblyFeature

static Coaxial(movableAxis, fixedAxis, flip)[source]#

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

Note

This function can be accessed by:

mdb.models[name].rootAssembly.AttachmentLines

Note

Check Coaxial on help.3ds.com/0.1..

Parameters:

movableAxis (str) – A cylindrical or conical Face on the part instance to be moved.
fixedAxis (str) – A cylindrical or conical Face on the part instance that remains fixed.
flip (Union[AbaqusBoolean, bool]) – A Boolean specifying whether the axes are forward aligned (OFF) or reverse aligned (ON).

Returns:

A Feature object.

Return type:

AssemblyFeature

Raises:

AbaqusException –

static CoincidentPoint(movablePoint, fixedPoint)[source]#

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

Note

This function can be accessed by:

mdb.models[name].rootAssembly.AttachmentLines

Note

Check CoincidentPoint on help.3ds.com/0.1..

Parameters:

movablePoint (str) – A ConstrainedSketchVertex, a Datum point, or a ReferencePoint or a mesh node from an orphan mesh on the part instance to be moved.
fixedPoint (str) – 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 – A Feature object

Return type:

AssemblyFeature

static EdgeToEdge(movableAxis, fixedAxis, flip, clearance)[source]#

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

Note

This function can be accessed by:

mdb.models[name].rootAssembly.AttachmentLines

Note

Check EdgeToEdge on help.3ds.com/0.1..

Parameters:

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

Returns:

A Feature Object.

Return type:

AssemblyFeature

Raises:

AbaqusException –

static FaceToFace(movablePlane, fixedPlane, flip, clearance)[source]#

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

Note

This function can be accessed by:

mdb.models[name].rootAssembly.AttachmentLines

Note

Check FaceToFace on help.3ds.com/0.1..

Parameters:

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

Returns:

A Feature Object.

Return type:

AssemblyFeature

Raises:

AbaqusException –

static ParallelCsys(movableCsys, fixedCsys)[source]#

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

Note

This function can be accessed by:

mdb.models[name].rootAssembly.AttachmentLines

Note

Check ParallelCsys on help.3ds.com/0.1..

Parameters:

movableCsys (str) – A Datum coordinate system on the part instance to be moved.
fixedCsys (str) – A Datum coordinate system on the part instance to remain fixed.

Returns:

A Feature object.

Return type:

AssemblyFeature

Raises:

AbaqusException –

static ParallelEdge(movableAxis, fixedAxis, flip)[source]#

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

Note

This function can be accessed by:

mdb.models[name].rootAssembly.AttachmentLines

Note

Check ParallelEdge on help.3ds.com/0.1..

Parameters:

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

Returns:

A Feature object.

Return type:

AssemblyFeature

Raises:

AbaqusException –

static ParallelFace(movablePlane, fixedPlane, flip)[source]#

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

Note

This function can be accessed by:

mdb.models[name].rootAssembly.AttachmentLines

Note

Check ParallelFace on help.3ds.com/0.1..

Parameters:

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

Returns:

A Feature object.

Return type:

AssemblyFeature

Raises:

AbaqusException –

ModelInstance#

class ModelInstance(name, model, autoOffset=OFF)[source]#

A ModelInstance object is an instance of a Model.

Note

This object can be accessed by:

import assembly
mdb.models[name].rootAssembly.modelInstances[i]

Note

Check ModelInstance on help.3ds.com/0.1..

Public Data Attributes:

`sets`	A repository of Set objects specifying the sets created on the assembly.
`surfaces`	A repository of Surface objects specifying the surfaces created on the assembly.
`vertices`	A `VertexArray` object.
`edges`	An `EdgeArray` object.
`elements`	A `MeshElementArray` object.
`nodes`	A `MeshNodeArray` object.
`datums`	A repository of Datum objects.
`referencePoints`	A repository of ReferencePoint objects.

Public Methods:

`__init__`(name, model[, autoOffset])	This method creates a ModelInstance object and puts it into the instances repository.
`ConvertConstraints`()	This method converts the position constraints of an instance to absolute positions.
`getPosition`()	This method prints the sum of the translations and rotations applied to the ModelInstance object.
`replace`(instanceOf[, applyConstraints])	This method replaces one instance with an instance of another model.
`translate`(vector)	This method translates an instance by the specified amount.

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.

datums: Dict[str, Datum] = {}[source]#: A repository of Datum objects.

edges: EdgeArray = [][source]#: An EdgeArray object.

elements: MeshElementArray = [][source]#: A MeshElementArray object.

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

nodes: MeshNodeArray = [][source]#: A MeshNodeArray object.

referencePoints: Dict[str, ReferencePoint] = {}[source]#: A repository of ReferencePoint objects.

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

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

New in version 2019: The replace method was added.

Note

Check ModelInstance.replace on help.3ds.com/0.1..

Parameters:

instanceOf (Model) – A Model object to be instanced. If the model does not exist, no ModelInstance object is created.
applyConstraints (Union[AbaqusBoolean, bool], default: True) – 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.

sets: Dict[str, Set] = {}[source]#: A repository of Set objects specifying the sets created on the assembly. 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] = {}[source]#: A repository of Surface objects specifying the surfaces created on the assembly. For more information, see [Region commands](https://help.3ds.com/2022/english/DSSIMULIA_Established/SIMACAEKERRefMap/simaker-m-RegPyc-sb.htm?ContextScope=all).

translate(vector)[source]#

This method translates an instance by the specified amount.

Note

Check ModelInstance.translate on help.3ds.com/0.1..

Parameters:: vector (tuple) – A sequence of three Floats specifying a translation vector.

vertices: VertexArray = [][source]#: A VertexArray object.

PartInstance#

class PartInstance(name, part, autoOffset=OFF, dependent=OFF)[source]#

A PartInstance object is an instance of a Part object.

Note

This object can be accessed by:

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

Note

Check PartInstance on help.3ds.com/0.1..

Public Data Attributes:

`name`	A String specifying the repository key.
`dependent`	A Boolean specifying whether the part instance is dependent or independent.
`excludedFromSimulation`	A Boolean specifying whether the part instance is excluded from the simulation.
`geometryValidity`	A Boolean specifying the validity of the geometry of the instance.
`analysisType`	A SymbolicConstant specifying the part type.
`referenceNode`	An Int specifying the reference node number.
`part`	A `Part` object specifying the instanced part.
`sets`	A repository of Set objects specifying the sets created on the part.
`surfaces`	A repository of Surface objects specifying the surfaces created on the part.
`skins`	A repository of Skin objects specifying the skins created on the part.
`stringers`	A repository of Stringer objects specifying the stringers created on the part.
`vertices`	A `VertexArray` object.
`ignoredVertices`	An `IgnoredVertexArray` object.
`edges`	An `EdgeArray` object.
`ignoredEdges`	An `IgnoredEdgeArray` object.
`faces`	A `FaceArray` object.
`cells`	A `CellArray` object.
`datums`	A repository of Datum objects.
`elements`	A `MeshElementArray` object.
`nodes`	A `MeshNodeArray` object.
`elemFaces`	A repository of MeshFace objects specifying all the element faces in the part instance.
`elementFaces`	A `MeshFaceArray` object.
`elemEdges`	A repository of MeshEdge objects specifying all the element edges in the part instance.
`elementEdges`	A `MeshEdgeArray` object.
`referencePoints`	A repository of ReferencePoint objects.
`partName`	A String specifying the name of the part from which the instance was created.

Public Methods:

`__init__`(name, part[, autoOffset, dependent])	This method creates a PartInstance object and puts it into the instances repository.
`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.).
`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.
`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, fixedList, direction, clearance, isFaceEdges=OFF)[source]#

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

Note

Check Contact on help.3ds.com/0.1..

Parameters:

movableList (tuple) – A sequence of Face or Edge objects on the part instance to be moved.
fixedList (tuple) – A sequence of Face or Edge objects on the part instance to remain fixed.
direction (tuple) – A sequence of three Floats specifying the direction of contact.
clearance (float) – A Float specifying the distance between the two faces along the direction of contact.
isFaceEdges (Union[AbaqusBoolean, bool], default: OFF) – 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 – A Feature object

Return type:

Feature

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, instanceToBeCut, cuttingInstances, originalInstances=abaqusConstants.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.

Note

This function can be accessed by:

mdb.models[name].rootAssembly.Instance

Note

Check InstanceFromBooleanCut on help.3ds.com/0.1..

Parameters:

name (str) – A String specifying the repository key. The name must be a valid Abaqus object name.
instanceToBeCut (str) – A PartInstance specifying the base instance from which to cut other instances.
cuttingInstances (Tuple[PartInstance]) – A sequence of PartInstance objects specifying the instances with which to cut the base instance.
originalInstances (SymbolicConstant, default: SUPPRESS) – 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.

Return type:

PartInstance

InstanceFromBooleanMerge(name, instances, keepIntersections=False, originalInstances=abaqusConstants.SUPPRESS, domain=abaqusConstants.GEOMETRY, mergeNodes=abaqusConstants.BOUNDARY_ONLY, nodeMergingTolerance=None, removeDuplicateElements=True)[source]#

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

Note

This function can be accessed by:

mdb.models[name].rootAssembly.Instance

Note

Check InstanceFromBooleanMerge on help.3ds.com/0.1..

Parameters:

name (str) – A String specifying the repository key. The name must be a valid Abaqus object name.
instances (Tuple[PartInstance]) – A sequence of PartInstance objects specifying the part instances to merge.
keepIntersections (Union[AbaqusBoolean, bool], default: False) – 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 (SymbolicConstant, default: SUPPRESS) – 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 (SymbolicConstant, default: GEOMETRY) – 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 (SymbolicConstant, default: BOUNDARY_ONLY) – 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 (Optional[float], default: None) – 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 (Union[AbaqusBoolean, bool], default: True) – 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.

Return type:

PartInstance

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

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

Note

This function can be accessed by:

mdb.models[name].rootAssembly.Instance

Note

Check LinearInstancePattern on help.3ds.com/0.1..

Parameters:

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

Returns:

A sequence of PartInstance objects.

Return type:

Tuple[PartInstance, ]

RadialInstancePattern(instanceList, number, totalAngle, point=(), axis=())[source]#

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

Note

This function can be accessed by:

mdb.models[name].rootAssembly.Instance

Note

Check RadialInstancePattern on help.3ds.com/0.1..

Parameters:

instanceList (tuple) – A sequence of Strings specifying the names of instances to pattern.
number (int) – An Int specifying the total number of instances, including the original instances, that appear in the radial pattern.
totalAngle (float) – 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 (tuple, default: ()) – A sequence of three Floats specifying the center of the radial pattern. The default value is (0.0, 0.0, 0.0).
axis (tuple, default: ()) – 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 sequence of PartInstance objects.

Return type:

Tuple[PartInstance, ]

analysisType: Optional[SymbolicConstant] = None[source]#: A SymbolicConstant specifying the part type. Possible values are DEFORMABLE_BODY, EULERIAN, DISCRETE_RIGID_SURFACE, and ANALYTIC_RIGID_SURFACE.

cells: CellArray = [][source]#: A CellArray object.

checkGeometry(detailed=OFF, level=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.).

Note

Check PartInstance.checkGeometry on help.3ds.com/0.1..

Parameters:

detailed (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether detailed output will be printed to the replay file. The default value is OFF.
level (Optional[int], default: None) – 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: :raises specified: :raises dependent part instance. In this case, this command should be called on the Part: :raises instead. The geometry of :class:`dependent part instances cannot be changed.:

datums: List[Datum] = [][source]#: A repository of Datum objects.

dependent: Union[AbaqusBoolean, bool] = OFF[source]#: A Boolean specifying whether the part instance is dependent or independent. If dependent = OFF, the part instance is independent. The default value is OFF.

edges: EdgeArray = [][source]#: An EdgeArray object.

elemEdges: Dict[str, MeshEdge] = {}[source]#: A repository of 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 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.

elemFaces: Dict[str, MeshFace] = {}[source]#: A repository of 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 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.

elementEdges: MeshEdgeArray = [][source]#: A MeshEdgeArray object.

elementFaces: MeshFaceArray = [][source]#: A MeshFaceArray object.

elements: MeshElementArray = [][source]#: A MeshElementArray object.

excludedFromSimulation: Union[AbaqusBoolean, bool] = OFF[source]#: 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.

faces: FaceArray = [][source]#: A FaceArray object.

geometryValidity: Union[AbaqusBoolean, bool] = OFF[source]#: 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.

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 tuple including the point of rotation, axis of rotation, and rotation angle (in degrees).
Return type:: tuple

getTranslation()[source]#

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

Returns:: A tuple of three Floats representing the translation.
Return type:: Tuple[float, float, float]

ignoredEdges: IgnoredEdgeArray = [][source]#: An IgnoredEdgeArray object.

ignoredVertices: IgnoredVertexArray = [][source]#: An IgnoredVertexArray object.

name: str = ''[source]#: A String specifying the repository key. The name must be a valid Abaqus object name.

nodes: MeshNodeArray = [][source]#: A MeshNodeArray object.

part: Optional[Part] = None[source]#: A Part object specifying the instanced part.

partName: str = ''[source]#: A String specifying the name of the part from which the instance was created.

referenceNode: Optional[int] = None[source]#: An Int specifying the reference node number. This member is valid only if analysisType = DISCRETE_RIGID_SURFACE or ANALYTIC_RIGID_SURFACE.

referencePoints: Dict[str, ReferencePoint] = {}[source]#: A repository of ReferencePoint objects.

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

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

Note

Check PartInstance.replace on help.3ds.com/0.1..

Parameters:

instanceOf (Part) – A Part object specifying which Part will be instanced in place of the original Part.
applyConstraints (Union[AbaqusBoolean, bool], default: True) – 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, axisDirection, angle)[source]#

This method translates an instance by the specified amount.

Note

Check PartInstance.rotateAboutAxis on help.3ds.com/0.1..

Parameters:

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

sets: Dict[str, Set] = {}[source]#: 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).

skins: Dict[str, Skin] = {}[source]#: 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] = {}[source]#: 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).

surfaces: Dict[str, Surface] = {}[source]#: 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).

translate(vector)[source]#

This method translates an instance by the specified amount.

Note

Check PartInstance.translate on help.3ds.com/0.1..

Parameters:: vector (tuple) – A sequence of three Floats specifying a translation vector.

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

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

Note

Check PartInstance.translateTo on help.3ds.com/0.1..

Parameters:

movableList (tuple) – A sequence of Face or Edge objects on the part instance to be moved.
fixedList (tuple) – A sequence of Face or Edge objects on the part instances to remain fixed.
direction (tuple) – A sequence of three Floats specifying the direction of contact.
clearance (float) – A Float specifying the distance between the two faces along the direction of contact.
vector (tuple, default: ()) – 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 – A Feature object

Return type:

Feature

vertices: VertexArray = [][source]#: A VertexArray object.

PartInstanceArray#

PartInstanceArray[source]#: alias of List[PartInstance]