Part#

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

Create parts#

class PartModel(name, description='', stefanBoltzmann=None, absoluteZero=None, waveFormulation=abaqusConstants.NOT_SET, modelType=abaqusConstants.STANDARD_EXPLICIT, universalGas=None, copyConstraints=ON, copyConnectors=ON, copyInteractions=ON)[source]#

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

Note

This object can be accessed by:

mdb.models[name]
Part(name, dimensionality, type, twist=OFF)[source]#

This method creates a Part object and places it in the parts repository.

Note

This function can be accessed by:

mdb.models[name].Part
Parameters:
  • name (str) – A String specifying the repository key.

  • dimensionality (Literal[THREE_D, TWO_D_PLANAR, AXISYMMETRIC]) – A SymbolicConstant specifying the dimensionality of the part. Possible values are THREE_D, TWO_D_PLANAR, and AXISYMMETRIC.

  • type (Literal[DEFORMABLE_BODY, EULERIAN, DISCRETE_RIGID_SURFACE, ANALYTIC_RIGID_SURFACE]) – A SymbolicConstant specifying the type of the part. Possible values are DEFORMABLE_BODY, EULERIAN, DISCRETE_RIGID_SURFACE, and ANALYTIC_RIGID_SURFACE.

  • twist (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to include a twist DEGREE OF FREEDOM in the part (only available when dimensionality = AXISYMMETRIC and type = DEFORMABLE_BODY). The default value is OFF.

Returns:

A Part object.

Return type:

Part

class PartBase(name: str, dimensionality: SymbolicConstant, type: SymbolicConstant, twist: Union[AbaqusBoolean, bool] = OFF)[source]#
class PartBase(name: str, objectToCopy: str, scale: float = 1, mirrorPlane: SymbolicConstant = NONE, compressFeatureList: Union[AbaqusBoolean, bool] = OFF, separate: Union[AbaqusBoolean, bool] = OFF)

The Part object defines the physical attributes of a structure. Parts are instanced into the assembly and positioned before an analysis.

Note

This object can be accessed by:

import part
mdb.models[name].parts[name]
Lock()[source]#

This method locks the part. Locking the part prevents any further changes to the part that can trigger regeneration of the part.

LockForUpgrade()[source]#

This method locks the part for upgrade. Locking the part prevents any further changes to the part that can trigger regeneration of the part. When the part is unlocked, all the parts are upgraded and regenrated.

Part2DGeomFrom2DMesh(name, part, featureAngle, splineCurvatureLimit=90, twist=OFF)[source]#

This method creates a geometric Part object from the outline of an existing two-dimensional orphan mesh Part object and places it in the parts repository. If the Part2DGeomFrom2DMesh method cannot create a valid two-dimensional shell section from the two-dimensional mesh, the method fails and creates an empty geometry part with a failed base shell feature.

Note

This function can be accessed by:

mdb.models[name].Part
Parameters:
  • name (str) – A String specifying the repository key.

  • part (PartBase) – A Part object specifying an existing two-dimensional orphan mesh Part object.

  • featureAngle (float) – A Float specifying the angle (in degrees) between line segments that triggers a break in the geometry.

  • splineCurvatureLimit (float, default: 90) – A Float specifying the traversal angle in degrees of the spline that triggers a break in the geometry. The default value is 90.

  • twist (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to include a twist DEGREE OF FREEDOM in the part (only available when dimensionality = AXISYMMETRIC and type = DEFORMABLE_BODY). The default value is OFF.

Returns:

part – A Part object

  • If the specified part is not an orphan mesh part: Specified part must be an orphan mesh.

  • If the Part2DGeomFrom2DMesh method cannot create a valid two-dimensional shell section from the two-dimensional mesh: Planar shell feature failed

  • If the specified part is not two-dimensional: Cannot create a geometry from a 3D part.

  • If the specified part is a rigid body: Cannot create a geometry from a rigid body.

Return type:

Part

PartFromBooleanCut(name, instanceToBeCut, cuttingInstances)[source]#

This method creates a Part in the parts 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].Part
Parameters:
  • name (str) – A String specifying the repository key.

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

Returns:

part – A Part object

Return type:

Part

PartFromBooleanMerge(name, instances, keepIntersections=False, mergeNodes=abaqusConstants.BOUNDARY_ONLY, nodeMergingTolerance=None, removeDuplicateElements=ON, domain=abaqusConstants.GEOMETRY)[source]#

This method creates a Part in the parts repository after merging two or more part instances. The part instances can be either Abaqus native parts or orphan mesh parts, but they cannot be a combination of both.

Note

This function can be accessed by:

mdb.models[name].Part
Parameters:
  • name (str) – A String specifying the repository key.

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

  • mergeNodes (SymbolicConstant, default: BOUNDARY_ONLY) – A SymbolicConstant specifying whether the nodes of orphan mesh part instances should be retained after the merge operation. 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 orphan mesh part instances that will be merged and replaced with a single new node. The location of the new node is the average position of the deleted nodes. The default value is 10-6.

  • removeDuplicateElements (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether elements with the same connectivity after the merge will merged into a single element. The default value is ON.

  • domain (SymbolicConstant, default: GEOMETRY) – A SymbolicConstant specifying whether the part instances being merged are geometric instances or mesh instances. Possible values are GEOMETRY, MESH or BOTH. The default value is GEOMETRY.

Returns:

part – A Part object

Return type:

Part

PartFromExtrude2DMesh(name, part, depth, elementSize)[source]#

This method creates a Part object by extruding an existing two-dimensional orphan mesh Part object in the positive Z-direction and places it in the parts repository.

Note

This function can be accessed by:

mdb.models[name].Part
Parameters:
  • name (str) – A String specifying the repository key.

  • part (PartBase) – A Part object specifying an existing two-dimensional orphan mesh Part object.

  • depth (float) – A Float specifying the total extrusion distance.

  • elementSize (float) – A Float specifying an approximate element length in the extruded direction.

Returns:

part – A Part object

  • If the specified part is not an orphan mesh part: Cannot extrude a geometric part.

  • If the specified part is not two-dimensional: Cannot extrude a 3D part.

  • If the specified part is a rigid body: Cannot change dimension of a rigid body.

Return type:

Part

PartFromGeometryFile(name, geometryFile, dimensionality, type, bodyNum=1, combine=False, booleanSolids=False, retainBoundary=False, usePartNameFromFile=OFF, stitchTolerance=1, twist=OFF, scale=1, convertToAnalytical=0, convertToPrecise=0)[source]#

This method creates a Part object and places it in the parts repository.

Note

This function can be accessed by:

mdb.models[name].Part
Parameters:
  • name (str) – A String specifying the repository key.

  • geometryFile (AcisFile) – An AcisFile object specifying a file containing geometry.

  • dimensionality (SymbolicConstant) – A SymbolicConstant specifying the dimensionality of the part. Possible values are THREE_D, TWO_D_PLANAR, and AXISYMMETRIC.

  • type (SymbolicConstant) – A SymbolicConstant specifying the type of the part. Possible values are DEFORMABLE_BODY, EULERIAN, DISCRETE_RIGID_SURFACE, and ANALYTIC_RIGID_SURFACE.

  • bodyNum (int, default: 1) – An Int specifying the desired body to be selected from an ACIS object containing a list of N ACIS bodies. Possible values are 1 ≤ bodyNumN. The default value is 1.

  • combine (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying weather to create a single part by combining all the bodies in the ACIS object. This argument is ignored if bodyNum is specified. The default value is False.

  • booleanSolids (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether the solids should be boolean while combining all the bodies.The default value is FALSE.

  • retainBoundary (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether the intersecting boundaries should be retained while boolean the solids.The default value is FALSE.

  • usePartNameFromFile (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the part names specified in a STEP file should be used as the names in the Abaqus model database. If this option is TRUE, the part names in the STEP file will be used; if FALSE, each imported part will be named using the text of the name argument followed by a number. This functionality is available only for import from STEP files; for import from all other types of files this option should be FALSE.

  • stitchTolerance (float, default: 1) – A Float indicating the maximum gap to be stitched. The value should be smaller than the minimum feature size and bigger than the maximum gap expected to be stitched in the model. Otherwise this command may remove small (sliver) edges that are smaller than the tolerance. The default value is 1.0

  • twist (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to include a twist DEGREE OF FREEDOM in the part (only available when dimensionality = AXISYMMETRIC and type = DEFORMABLE_BODY). The default value is OFF.

  • scale (float, default: 1) – A Float specifying the scaling factor to apply to the imported geometric entities. The default value is 1.0.

  • convertToAnalytical (int, default: 0) – An Int specifying whether to convert to analytical entities. Possible values are 0 or 1. The default value is 0. If convertToAnalytical = 1, all the numerical entities, such as splines, are converted to analytical entities, such as arcs and lines, during the repair phase of the command.

  • convertToPrecise (int, default: 0) – An Int specifying whether to convert to precise geometry. Possible value are 0 or 1. The default value is 0. If convertToPrecise = 1, the application will attempt to re-evaluate the tolerant entities to be more precise.

Returns:

part – A Part object

  • If the ACIS file is corrupt: PartError: the file is corrupt

  • If the dimensionality does not correspond to what is found in the ACIS file: PartError: dimensionality does not match the contents of the file

  • If the type does not correspond to what is found in the ACIS file: PartError: type does not match the contents of the file

Return type:

Part

PartFromInstanceMesh(name, partInstances=(), copyPartSets=False, copyAssemblySets=False)[source]#

This method creates a Part object containing the mesh found in the supplied PartInstance objects and places the new Part object in the parts repository.

Note

This function can be accessed by:

mdb.models[name].Part
Parameters:
  • name (str) – A String specifying the repository key.

  • partInstances (Tuple[PartInstance, ...], default: ()) – A sequence of PartInstance objects to be used in the creation of the new mesh part. If the partInstances argument is omitted, the new Part object contains the mesh of all the part instances in the assembly.

  • copyPartSets (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to copy sets, surfaces, and attributes from the base part or parts of the specified part instances to the new part. The default is False.

  • copyAssemblySets (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to copy assembly-level sets that reference entities of the specified part instances to the new part. The default is False.

Returns:

part – A Part object

  • If the analysis type (deformable or rigid) is not consistent among the supplied part instances: The selected part instances do not have a consistent analysis type.

  • If the assembly does not contain a mesh: The current assembly does not contain a mesh for a mesh part.

  • If the specified part instances do not contain a mesh: The selected part instances do not have a mesh for a mesh part.

Return type:

Part

PartFromMesh(name, copySets=False)[source]#

This method creates a Part object containing the mesh found in the part and places the new Part object in the parts repository.

Note

This function can be accessed by:

mdb.models[name].Part
Parameters:
  • name (str) – A String specifying the repository key.

  • copySets (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to copy sets, surfaces, and attributes to the new part. The default is False.

Returns:

part – A Part object

  • If the part does not contain a mesh: The current part does not contain a mesh for a mesh part.

Return type:

Part

PartFromMeshMirror(name, part, point1, point2)[source]#

This method creates a Part object by mirroring an existing orphan mesh Part object about a specified plane and places it in the parts repository. The result is a union of the original and the mirrored copy. Contrast the PartFromMeshMirror method with the mirrorPlane argument of the Part copy constructor. The mirrorPlane argument creates only the second half of the part but does not unite the two halves.

Note

This function can be accessed by:

mdb.models[name].Part
Parameters:
  • name (str) – A String specifying the repository key.

  • part (PartBase) – A Part object specifying an existing orphan mesh part.

  • point1 (tuple) – A sequence of three Floats specifying a point on the mirror plane. This point is the local origin in the local system of the plane.

  • point2 (tuple) – A sequence of three Floats specifying a point in the direction of the normal to the mirror plane. This point must not be coincident with point1.

Returns:

part – A Part object

  • If the specified part is not an orphan mesh part: Cannot mirror a geometric part.

  • If the specified part is a rigid body: Cannot mirror a rigid body.

  • If point1 and point2 are coincident: Mirror plane director has zero length.

  • If the specified part is two-dimensional and the plane is not parallel to the Z-axis: Mirror plane must be parallel to Z axis for 2D parts

Return type:

Part

PartFromNodesAndElements(name, dimensionality, type, nodes, elements, twist=OFF)[source]#

This method creates a Part object from nodes and elements and places it in the parts repository.

Note

This function can be accessed by:

mdb.models[name].Part
Parameters:
  • name (str) – A String specifying the repository key.

  • dimensionality (SymbolicConstant) – A SymbolicConstant specifying the dimensionality of the part. Possible values are THREE_D, TWO_D_PLANAR, and AXISYMMETRIC.

  • type (SymbolicConstant) – A SymbolicConstant specifying the type of the part. Possible values are DEFORMABLE_BODY, EULERIAN, DISCRETE_RIGID_SURFACE, and ANALYTIC_RIGID_SURFACE.

  • nodes (tuple) – A sequence of (nodeLabels, nodeCoords) specifying the nodes of the mesh. nodeLabels is a sequence of Ints specifying the node labels, and nodeCoords is a sequence of sequences of three Floats specifying the nodal coordinates.

  • elements (tuple) – A sequence of sequences of(meshType, elementLabels, elementConns) specifying the elements of the mesh. meshType is a String specifying the element type. elementlabels is a sequence of Ints specifying the element labels. elementConns is a sequence of sequences of node labels specifying the element connectivity.

  • twist (Union[AbaqusBoolean, bool], default: OFF) – A boolean specifying whether the part is defined with twist. This option has meaning only when dimensionality = AXISYMMETRIC. Possible values are ON and OFF. The default value is OFF.

Returns:

part – A Part object

Return type:

Part

PartFromOdb(name, odb, fileName='', instance='', elementSet='', shape=abaqusConstants.UNDEFORMED, step=None, frame=None, twist=OFF)[source]#

This method creates an orphan mesh Part object by reading an output database. The new part is placed in the parts repository.

Note

This function can be accessed by:

mdb.models[name].Part
Parameters:
  • name (str) – A String specifying the repository key.

  • odb (str) – An output database object.

  • fileName (str, default: '') – A String specifying the name of the output database file from which to create the part. The default value is an empty string.

  • instance (str, default: '') – A String specifying the part instance in the output database from which to create the part. If no instance name is specified, Abaqus creates an orphan mesh part from the first part instance in the output database.

  • elementSet (str, default: '') – A String specifying an element set defined on the output database. Only elements from this set will be imported. The default is to import all element sets.

  • shape (SymbolicConstant, default: UNDEFORMED) – A SymbolicConstant specifying the configuration state. Possible values are UNDEFORMED and DEFORMED. The default value is UNDEFORMED.

  • step (Optional[int], default: None) – An Int specifying the step number for reading deformed coordinates. 0≤step≤N−10≤step≤N-1 where NN is the number of available steps. The default value is the last available step. You should specify the step argument only when shape = DEFORMED.

  • frame (Optional[int], default: None) – An Int specifying the frame number for reading deformed coordinates. 0≤frame≤N−10≤frame≤N-1 where NN is the number of available frames. The default value is the last available frame. You should specify the frame argument only when shape = DEFORMED.

  • twist (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to include a twist DEGREE OF FREEDOM in the part (only available when dimensionality = AXISYMMETRIC and type = DEFORMABLE_BODY). The default value is OFF.

Returns:

part – A Part object

  • If the output database contains elements of more than one dimensionality or type: File contains both axisymmetric and nonaxisymmetric elements.File contains both 2D and 3D elements.File contains both rigid and deformable elements.

  • If more than one part is found on the output database: PartError: importing of more than one part is not currently supported

  • If the output database does not contain any valid results for the specified step: Error. File does not contain any valid frames.

  • If the specified step and frame do not contain any displacements: Error. Specified frame does not contain nodal displacements.

  • If the specified element set is not found on the output database: Error. Specified element set is not defined in the ODB.

  • If the step number is invalid: OdiError: Invalid step index: i. Available step indices: 0 - j.

  • If the frame number is invalid: OdiError: Invalid frame index: i. Available frame indices: 0 - j.

Return type:

Part

PartFromSection3DMeshByPlane(name, part, point1, point2, point3)[source]#

This method creates a Part object by cutting an existing three-dimensional orphan mesh Part object by a plane and places it in the parts repository. This method is valid only for orphan mesh parts composed of 8-node brick elements.

Note

This function can be accessed by:

mdb.models[name].Part
Parameters:
  • name (str) – A String specifying the repository key.

  • part (PartBase) – A Part object specifying an existing three-dimensional orphan mesh part.

  • point1 (float) – A Sequence of three Floats specifying a point on the cutting plane. This point is the local origin in the local system of the plane.

  • point2 (float) – A Sequence of three Floats specifying a point in the direction of the normal to the cutting plane. This point must not be coincident with point1.

  • point3 (tuple) – A sequence of three Floats specifying the direction of the local 1-axis in the local system of the plane. This point must not project onto point1.

Returns:

part – A Part object

  • If the specified part is not an orphan mesh part: Cannot reduce dimension of a geometric part.

  • If the specified part is not three-dimensional: Cannot reduce dimension of a 2D part.

  • If the specified part is a rigid body: Cannot change dimension of a rigid body.

  • If point1 and point2 are coincident: Cutting plane director has zero length.

  • If point3 projects onto point1: Local axis point projects to origin.

  • If no elements are cut by the specified plane: Cannot reduce part dimension.

Return type:

Part

PartFromSubstructure(name, substructureFile, odbFile)[source]#

This method creates a substructure Part object by reading a substructure sim file and places it in the parts repository.

Note

This function can be accessed by:

mdb.models[name].Part
Parameters:
  • name (str) – A String specifying the repository key.

  • substructureFile (str) – A substructure sim file.

  • odbFile (str) – The output database file corresponding to the substructure sim file.

Returns:

part – A Part object

  • If the specified part is not a substructure: File specified does not contain a substructure.

  • If the specified part already exists: A part with the same name already exists.

  • If the substructure cannot be imported: The output database is missing nodes and elements.Nested substructures are not supported.The substructure sim file was generated using a version that is different from the current version.

Return type:

Part

Unlock()[source]#

This method unlocks the part. Unlocking the part allows it to be regenerated after any modifications to the part.

addGeomToSketch(sketch)[source]#

This method converts a part into a sketch by projecting all of the edges of the part onto the X-Y plane of the sketch. You can use addGeomToSketch with a part of any modeling space.

Parameters:

sketch (ConstrainedSketch) – A ConstrainedSketch object.

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 the contents of the allSets repository is the same as the contents of the sets repository.

allSurfaces: Dict[str, Surface] = {}[source]#

A repository of Surface objects specifying the contents of the allSurfaces repository is the same as the contents of the surfaces repository.

assignThickness(faces, thickness=None, topFaces=(), bottomFaces=())[source]#

This method assigns thickness data to shell faces. The thickness can be used while assigning shell and membrane sections to faces.

Parameters:
  • faces (Tuple[Face, ...]) – A sequence of Face objects specifying the regions where thickness will be applied.

  • thickness (Optional[float], default: None) – A Float specifying the thickness along the given faces . Either thickness, topFaces, or bottomFaces must be specified.

  • topFaces (Tuple[Face, ...], default: ()) – A sequence of Face objects whose distance to faces argument is used to calculate the thickness along the faces. The combination of topFaces and bottomFaces determines the thickness and the offset of the elements. If bottomFaces is not specified then the thickness is twice the distance to the topFaces. This argument will be ignored if thickness is specified. Either thickness, topFaces, or bottomFaces must be specified.

  • bottomFaces (Tuple[Face, ...], default: ()) – A sequence of Face objects whose distance to faces is used to calculate the thickness along the faces. The combination of topFaces and bottomFaces determines the thickness and the offset of the elements. If topFaces is not specified then the thickness is twice the distance to the bottomFaces. This argument will be ignored if thickness is specified. Either thickness, topFaces, or bottomFaces must be specified.

backup()[source]#

This method makes a backup copy of the features in the part. Use the restore method to retrieve the part’s features from the backup.

cells: CellArray = [][source]#

A CellArray object specifying all the cells in the part.

checkGeometry(detailed=OFF, reportFacetErrors=OFF, level=None)[source]#

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

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.

  • reportFacetErrors (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether faces are checked for proper facetting. 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.

clearGeometryCache()[source]#

This method clears the geometry cache. Clearing the geometry cache reduces the amount of memory being used to cache part features.

compositeLayups: Dict[str, CompositeLayup] = {}[source]#

A repository of CompositeLayup objects.

copyMeshPattern(elements, faces, elemFaces, targetFace, 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.

Parameters:
  • elements (Tuple[MeshElement, ...]) – A sequence of MeshElement objects or a Set object containing elements and specifying the source region.

  • faces (Tuple[Face, ...]) – A sequence of Face objects that have associated with shell elements or element faces and specifying the source region.

  • elemFaces (Tuple[MeshFace, ...]) – A sequence of MeshFace objects specifying the source region.

  • targetFace (MeshFace) – A MeshFace object specifying the target region.

  • nodes (Tuple[MeshNode, ...]) – 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) – 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 the datums in the part.

deleteAllFeatures()[source]#

This method deletes all the features in the part.

deleteFeatures(featureNames)[source]#

This method deletes the given features.

Parameters:

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

edges: EdgeArray = [][source]#

An EdgeArray object specifying all the edges in the part.

elemEdges: Dict[str, MeshEdge] = {}[source]#

A repository of MeshEdge objects specifying all the element edges in the part. 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. 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 specifying all the unique element edges in the part.

elementFaces: MeshFaceArray = [][source]#

A MeshFaceArray object specifying all the unique element faces in the part.

elements: MeshElementArray = [][source]#

A MeshElementArray object specifying all the elements in the part.

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

An EngineeringFeature object.

faces: FaceArray = [][source]#

A FaceArray object specifying all the faces in the part.

features: Dict[str, PartFeature] = {}[source]#

A repository of Feature objects specifying all the features in the part.

featuresById: Dict[str, PartFeature] = {}[source]#

A repository of Feature objects specifying all Feature objects in the part. 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.

geometryValidity: Union[AbaqusBoolean, bool] = OFF[source]#

A Boolean specifying the validity of the geometry of the part. The value is computed, but it can be set to ON to perform feature and mesh operations on an invalid part. There is no guarantee that such operations will work if the part was originally invalid.

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

This method returns the angle between the specified entities.

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:

angle – 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

getArea(faces, relativeAccuracy=0)[source]#

This method returns the total surface area of a given face or group of faces.

Parameters:
  • faces (Tuple[Face, ...]) – A sequence of Face objects whose area the method will calculate.

  • relativeAccuracy (float, default: 0) – A Float specifying that the area computation should stop when the specified relative accuracy has been achieved. The default value is 0.000001 (0.0001%).

Returns:

area – A Float specifying the sum of the calculated areas of the given faces.

Return type:

float

getAssociatedCADPaths()[source]#

This method returns the paths to the associated CAD part and root file. These are only available if the part was imported from one of the supported CAD softwares using the Associative Import capability. The root file can be the assembly file or the part file, depending on what which one was imported.

Returns:

paths – A sequence containing the path to the associated CAD part and assembly file

Return type:

tuple

getCADParameters()[source]#

This method returns the names and values of the CAD parameters associated with the part. These are only available if the part was imported from one of the supported CAD softwares using the Associative Import capability, and if the parameter names defined in that CAD software are prefixed with the string ABQ.

Returns:

paras – A dictionary object representing a map of the name of the parameter and its associated value.

Return type:

dict

getCentroid(faces, cells, relativeAccuracy=0)[source]#

Location of the centroid of a given face/cell or group of faces/cells

Parameters:
  • faces (Tuple[Face, ...]) – A sequence of Face objects whose centroid the method will calculate. The arguments faces and cells are mutually exclusive.

  • cells (Tuple[Face, ...]) – A sequence of Face objects whose centroid the method will calculate. The arguments faces and cells are mutually exclusive.

  • relativeAccuracy (float, default: 0) – A Float specifying that the centroid computation should stop when the specified relative accuracy has been achieved. The default value is 0.000001 (0.0001%).

Returns:

centroid – A sequence of Floats specifying the X-, Y-, and Z-coordinates of the centroid. Depending on the arguments provided, this method returns the following:

  • The location of the centroid of a given face or group of faces.

  • The location of the centroid of a given cell or group of cells.

Return type:

Tuple[float, ]

getCoordinates(entity, csys)[source]#

This method returns the coordinates of specified point.

Parameters:
  • entity (str) – A ConstrainedSketchVertex, Datum point, MeshNode, or ReferencePoint specifying the entity to query.

  • csys (DatumCsys) –

    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.

Return type:

A tuple of 3 Floats representing the coordinates of the specified point.

getCurvature(edges, samplePoints=100)[source]#

This method returns the maximum curvature of a given edge or group of edges. For an arc, the curvature is constant over the entire edge, and equal to the inverse of the radius. For a straight line, the curvature is constant and equal to 0. For a spline edge, the curvature varies over a range, and this methods computes the maximum.

Parameters:
  • edges (Tuple[Edge, ...]) – A sequence of Edge objects whose curvature the method will calculate.

  • samplePoints (int, default: 100) – An Int specifying the number of points along each edge at which the curvature will be computed. The higher the number of sample points, the better the accuracy of the computation. The default value is 100.

Returns:

curvature – A Float specifying the maximum curvature.

Return type:

float

getDistance(entity1, entity2)[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.

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.

Returns:

distance – A Float specifying the distance between entity1 and entity2.

Return type:

float

getFeatureCells(name)[source]#

This method returns a sequence of Cell objects that are created by the given feature.

Parameters:

name (str) – A string specifying the feature name.

Returns:

cells – Sequence of Cell objects.

Return type:

Tuple[Cell, ]

:raises Error : Incorrect feature name: An exception occurs if a feature with the given name does not exist.

getFeatureEdges(name)[source]#

This method returns a sequence of Edge objects that are created by the given feature.

Parameters:

name (str) – A string specifying the feature name.

Returns:

edges – Sequence of Edge objects.

Return type:

Tuple[Edge, ]

Raises:

Error – An exception occurs if a feature with the given name does not exist.

getFeatureFaces(name)[source]#

This method returns a sequence of Face objects that are created by the given feature.

Parameters:

name (str) – A string specifying the feature name.

Returns:

faces – Sequence of Face objects.

Return type:

Tuple[Face, ]

:raises Error : Incorrect feature name: An exception occurs if a feature with the given name does not exist.

getFeatureVertices(name)[source]#

This method returns a sequence of ConstrainedSketchVertex objects that are created by the given feature.

Parameters:

name (str) – A string specifying the feature name.

Returns:

vertices – Sequence of ConstrainedSketchVertex objects.

Return type:

Tuple[ConstrainedSketchVertex, ]

Raises:

Error – An exception occurs if a feature with the given name does not exist.

getLength(edges)[source]#

This method returns the length of a given edge or group of edges.

Parameters:

edges (Tuple[Edge, ...]) – A sequence of Edge objects whose total length the method will calculate.

Returns:

length – A Float specifying the total length

Return type:

float

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

This method returns the mass properties of a part or region. Only beams, trusses, shells, solids, point, nonstructural mass, and rotary inertia elements are supported.

Parameters:
  • regions (str, default: '') – A MeshElementArray, CellArray, FaceArray, or EdgeArray specifying the regions whose mass properties are to be queried. The whole part 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 region. 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. UNSUPPORTED_NON_STRUCTURAL_MASS_PROPORTIONAL: Non-structural mass with Mass Proportional distribution is not supported. Results are computed using Volume Proportional distribution.

Return type:

dict

getPerimeter(faces)[source]#

This method returns the total perimeter of a given face or group of faces. All faces need to be on the same part. If the specified faces have shared edges, these edges are excluded from the computation, thus providing the length of the outer perimeter of the specified faces.

Parameters:

faces (Tuple[Face, ...]) – A sequence of Face objects whose perimeter the method will calculate.

Returns:

perimeter – A Float specifying the perimeter

Return type:

float

getVolume(cells, relativeAccuracy=0)[source]#

This method returns the volume area of a given cell or group of cells.

Parameters:
  • cells (Tuple[Cell, ...]) – A sequence of Cell objects whose volume the method will calculate.

  • relativeAccuracy (float, default: 0) – A Float specifying the relative accuracy of the computation. The default value is 0.000001 (0.0001%).

Returns:

volume – A Float specifying the sum of the areas of the given faces

Return type:

float

ignoredEdges: IgnoredEdgeArray = [][source]#

An IgnoredEdgeArray object specifying all the ignored edges in the part.

ignoredVertices: IgnoredVertexArray = [][source]#

An IgnoredVertexArray object specifying all the ignored vertices in the part.

isAlignedWithSketch()[source]#

This method checks if the normal of an analytical rigid surface part is aligned with that of its sketch.

Returns:

A Boolean value of True if the part is aligned with the sketch and False if it is not aligned.

Return type:

Boolean

Raises:

AbaqusException – If the part is not an analytical rigid part.

isOutOfDate: Optional[int] = None[source]#

An Int specifying that feature parameters have been modified but that the part has not been regenerated. Possible values are 0 and 1.

materialOrientations: List[MaterialOrientation] = [][source]#

A MaterialOrientationArray object.

nodes: MeshNodeArray = [][source]#

A MeshNodeArray object specifying all the nodes in the part.

printAssignedSections()[source]#

This method prints information on each section that has been assigned to a region of the part.

projectEdgesOntoSketch(sketch, edges, constrainToBackground=True)[source]#

This method projects the selected edges of a part onto the specified ConstrainedSketch object. The edges appear as sketch geometry after projection. If the plane of projection is not parallel to the specified edge, the resultant sketch geometry may be of a different type. For example, a circular edge can be projected as an ellipse or a line depending on the angle of the plane of projection. By default, the projected edge will be constrained to the background geometry. You can remove this constraint by setting constrainToBackground to False.

Parameters:
  • sketch (str) – The ConstrainedSketch object on which the edges are projected.

  • edges (tuple) – A sequence of candidate edges to be projected onto the sketch.

  • constrainToBackground (Union[AbaqusBoolean, bool], default: True) – A Boolean that determines whether the projected edges need to constrained to the background geometry. The default is True.

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

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

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[PartFeature], 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, part entities in features created before the sketch you are editing are candidates for projection.

  • edges (tuple, default: ()) – A sequence of candidate edges whose vertices need to be projected onto the sketch. By default, all edges specified by the filter argument 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.

queryAttributes(printResults=OFF)[source]#
This method prints the following information about a part:
  • the name, modeling space, and analysis type; and

  • whether twist is included (only available when the modeling space is axisymmetric and

the analysis type is deformable); and
  • the number of vertices, edges, faces and cells if applicable.

Parameters:

printResults (Union[AbaqusBoolean, bool], default: OFF) – A Boolean which specifies whether the above information is to be printed. The default value is True

Returns:

attributes – A Dictionary object with string keys and integer values which returns the above information with the keys being numVertices, numEdges, numFaces, numCells, numWiredEdges, numShellFaces and numSolidFaces.

Return type:

dict

queryCachedStates()[source]#

This method displays the position of geometric states relative to the sequence of features in the part cache. The output is displayed in the message area.

queryDisjointPlyRegions()[source]#

This method provides a list of all composite plys in the current part which have disjoint regions.

queryGeometry(relativeAccuracy=0, printResults=True)[source]#
This method prints the following information about a part:
  • the name, modeling space, and analysis type;

  • whether twist is included (only available when the modeling space is axisymmetric and

the analysis type is deformable);
  • a 3D point representing the minimum of the part’s bounding box;

  • a 3D point representing the maximum of the part’s bounding box;

  • a 3D point representing the part’s centroid (only on 3D solid parts); and

  • the volume (only on 3D solid parts).

Parameters:
  • relativeAccuracy (float, default: 0) – A Float specifying that the property computations should stop when the specified relative accuracy has been achieved. The default value is 0.000001 (0.0001%).

  • printResults (Union[AbaqusBoolean, bool], default: True) – A Boolean which specifies whether the above information is to be printed. The default value is True.

Returns:

geometry – A Dictionary object with string keys, which returns the above information with the keys being name, space, type, volume, centroid, category and boundingBox.

Return type:

dict

queryRegionsMissingSections()[source]#

This method returns all regions in the part that do not have a section assignment but require one for analysis.

Returns:

region – A Region object, or None

Return type:

Region

referencePoints: ReferencePoints = {}[source]#

A repository of ReferencePoint objects.

regenerate()[source]#

This method regenerates a part. When you modify features, it may be convenient to postpone regeneration until you make all your changes, since regeneration can be time consuming.

regenerationWarnings()[source]#

This method prints any regeneration warnings associated with the features.

removeInvalidGeometry()[source]#

Removes all invalid entities from the part, leaving a valid part. This is not recorded as a feature in the feature list, therefore it should be used on parts that have a single feature (such as an imported part). Note:This may remove valid entities that are connected to invalid ones. You can identify invalid entities using the query toolset before using this command.

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.

resumeFeatures(featureNames)[source]#

This method resumes the specified suppressed features in the part.

Parameters:

featureNames (tuple) – A tuple of names of features which are to be resumed.

resumeLastSetFeatures()[source]#

This method resumes the last set of features to be suppressed in the part.

retainedNodes: MeshNodeArray = [][source]#

A MeshNodeArray object specifying all the retained nodes in the substructure part.

saveGeometryCache()[source]#

This method caches the current geometry. Caching the current geometry improves regeneration performance.

sectionAssignments: List[SectionAssignment] = [][source]#

A SectionAssignmentArray object.

setAssociatedCADPaths(partFile='', rootFile='')[source]#

This method sets the paths to the associated CAD part and root file. This method is only available if the part was imported from one of the supported CAD softwares using the Associative Import capability. The root file can be the assembly file or the part file, depending on the one that was imported. This method can be used to specify the new paths when the CAD data is moved to a different directory.

Parameters:
  • partFile (str, default: '') – A String specifying the name of the associated CAD part file.

  • rootFile (str, default: '') – A String specifying the name of the root associated CAD file. This can be the same as the part file or can be the assembly file, depending on the one that was imported.

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

This method modifies the Part object.

Raises:

RangeError

sets: Dict[str, Set] = {}[source]#

A repository of Set objects specifying for more information, see Set.

skins: Dict[str, Skin] = {}[source]#

A repository of Skin objects specifying the skins created on the part.

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

Parameters:

nodes (Tuple[MeshNode, ...]) – A sequence of MeshNode objects or a Set object containing nodes.

stringers: Dict[str, Stringer] = {}[source]#

A repository of Stringer objects specifying the stringers created on the part.

suppressFeatures(featureNames)[source]#

This method suppresses the given features.

Parameters:

featureNames (tuple) – A tuple of names of features which are to be suppressed in the part.

surfaces: Dict[str, Surface] = {}[source]#

A repository of Surface objects specifying for more information, see Surface.

timeStamp: Optional[float] = None[source]#

A Float specifying when the part was last modified.

vertices: VertexArray = [][source]#

A VertexArray object specifying all the vertices in the part.

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

This method exports the geometry of the part to a named file in ACIS format.

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.

    Changed in version 2018: Add description for thr file name’s extension.

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

:raises Cannot export orphan mesh parts` to :class:`ACIS: If the part is an orphan mesh part.

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

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

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.

writeIgesFile(fileName, flavor)[source]#

This method exports the geometry of the part to a named file in IGES format.

Parameters:
  • fileName (str) – A String specifying the name of the file to which to write.

  • flavor (SymbolicConstant) – A SymbolicConstant specifying a particular flavor of IGES. Possible values are STANDARD, AUTOCAD, SOLIDWORKS, JAMA, and MSBO.

:raises Cannot export orphan mesh parts` to :class:`IGES: If the part is an orphan mesh part.

writeStepFile(fileName)[source]#

This method exports the geometry of the part to a named file in STEP format.

Parameters:

fileName (str) – A String specifying the name of the file to which to write.

Raises:

Parterror – If the part contains no geometry.

writeVdaFile(fileName)[source]#

This method exports the geometry of the part to a named file in VDA-FS format.

Parameters:

fileName (str) – A String specifying the name of the file to which to write.

:raises Cannot export orphan mesh parts` to :class:`VDA-FS: If the part is an orphan mesh part.

Object features#

Part#

class Part(name: str, dimensionality: SymbolicConstant, type: SymbolicConstant, twist: Union[AbaqusBoolean, bool] = OFF)[source]#
class Part(name: str, objectToCopy: str, scale: float = 1, mirrorPlane: SymbolicConstant = NONE, compressFeatureList: Union[AbaqusBoolean, bool] = OFF, separate: Union[AbaqusBoolean, bool] = OFF)

The Part object defines the physical attributes of a structure. Parts are instanced into the assembly and positioned before an analysis.

Note

This object can be accessed by:

import part
mdb.models[name].parts[name]

Public Data Attributes:

Inherited from PartBase

geometryValidity

A Boolean specifying the validity of the geometry of the part.

isOutOfDate

An Int specifying that feature parameters have been modified but that the part has not been regenerated.

timeStamp

A Float specifying when the part was last modified.

vertices

A VertexArray object specifying all the vertices in the part.

ignoredVertices

An IgnoredVertexArray object specifying all the ignored vertices in the part.

edges

An EdgeArray object specifying all the edges in the part.

ignoredEdges

An IgnoredEdgeArray object specifying all the ignored edges in the part.

faces

A FaceArray object specifying all the faces in the part.

cells

A CellArray object specifying all the cells in the part.

features

A repository of Feature objects specifying all the features in the part.

featuresById

A repository of Feature objects specifying all Feature objects in the part.

datums

A repository of Datum objects specifying all the datums in the part.

elements

A MeshElementArray object specifying all the elements in the part.

elemFaces

A repository of MeshFace objects specifying all the element faces in the part.

elementFaces

A MeshFaceArray object specifying all the unique element faces in the part.

nodes

A MeshNodeArray object specifying all the nodes in the part.

retainedNodes

A MeshNodeArray object specifying all the retained nodes in the substructure part.

sets

A repository of Set objects specifying for more information, see Set.

allSets

A repository of Set objects specifying the contents of the allSets repository is the same as the contents of the sets repository.

allInternalSets

A repository of Set objects specifying picked regions.

surfaces

A repository of Surface objects specifying for more information, see Surface.

allSurfaces

A repository of Surface objects specifying the contents of the allSurfaces repository is the same as the contents of the surfaces repository.

allInternalSurfaces

A repository of Surface objects specifying picked regions.

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.

referencePoints

A repository of ReferencePoint objects.

engineeringFeatures

An EngineeringFeature object.

sectionAssignments

A SectionAssignmentArray object.

materialOrientations

A MaterialOrientationArray object.

compositeLayups

A repository of CompositeLayup objects.

elemEdges

A repository of MeshEdge objects specifying all the element edges in the part.

elementEdges

A MeshEdgeArray object specifying all the unique element edges in the part.

Inherited from Feature

name

A String specifying the repository key.

id

An Int specifying the ID of the feature.

Public Methods:

Inherited from MeshEditPart

adjustMidsideNode(cornerNodes, parameter)

This method is used to adjust the midside node of second-order elements of an orphan mesh part.

cleanMesh(mergeTolerance[, growEdges, ...])

This method is used to collapse short element edges and delete collapsed elements, or grow short element edges, on an orphan mesh part composed of linear elements.

collapseMeshEdge(edge, collapseMethod)

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

combineElement(elements)

This method combines two triangular elements of an orphan mesh part or an Abaqus native mesh.

convertSolidMeshToShell()

This method removes all solid elements from an orphan mesh part and creates triangular or quadrilateral shell elements along their outer faces.

deleteElement(elements[, ...])

This method deletes the given elements from an orphan mesh part or an Abaqus native mesh.

deleteNode(nodes[, deleteUnreferencedNodes])

This method deletes the given nodes from an orphan mesh part.

editNode(nodes[, coordinate1, coordinate2, ...])

This method changes the coordinates of the given nodes on an orphan mesh part or on an Abaqus native mesh.

projectNode(nodes, projectionReference)

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

generateMesh([elemShape])

This method generates a new mesh on an orphan mesh part based on the original mesh.

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.

mergeElement(edge, elements)

Merge a selection of elements arranged in layers on an orphan mesh part into a single layer.

mergeNodes(*args, **kwargs)

orientElements(pickedElements, referenceRegion)

This method orients the stack direction of elements in a continuum shell or gasket mesh.

removeElementSize()

This method removes the global element size from an orphan mesh part.

renumberElement([elements, startLabel, ...])

This method assigns new labels to orphan mesh elements.

renumberNode([nodes, startLabel, increment, ...])

This method assigns new labels to orphan mesh nodes.

setElementSize(size)

This method sets the global element size for an orphan mesh part.

splitElement(elements)

This method splits quadrilateral elements of an orphan mesh part or a Abaqus native mesh into triangular elements.

splitMeshEdge(edge[, parameter])

This method splits an edge of a quadrilateral or triangular element of an orphan mesh part or an Abaqus native mesh.

subdivideElement([elements, divisionNumber, ...])

Subdivide a selection of elements on an orphan mesh part in one or more directions.

swapMeshEdge(edge)

This method swaps the diagonal of two adjacent triangular elements of an orphan mesh part or an Abaqus native mesh.

wrapMesh(radius)

This method wraps a planar orphan mesh part about the Z-axis.

redoMeshEdit()

This method executes the edit mesh or the bottom-up meshing operation most recently undone by the undoMeshEdit method on an part.

undoMeshEdit()

This method undoes the most recent edit mesh or the bottom-up meshing operation on a part and restores the mesh to its previous state.

Inherited from MeshPart

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 parts or regions.

deleteMeshAssociationWithGeometry(...[, ...])

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

deletePreviewMesh()

This method deletes all boundary meshes in the parts.

deleteSeeds(regions)

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

generateMesh([elemShape])

This method generates a new mesh on an orphan mesh part based on the original mesh.

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.

getEdgeSeeds(edge, attribute)

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

getElementType(region, elemShape)

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

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 a part.

getMeshStats(regions)

This method returns the mesh statistics for the given regions.

getPartSeeds(attribute)

This method returns a part seed parameter for the part.

getUnmeshedRegions()

This method returns all geometric regions in the part 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.

seedPart(size[, deviationFactor, ...])

This method assigns global edge seeds to the given parts.

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 mesh quality of a part and returns poor-quality elements.

Node(coordinates[, localCsys, label])

This method creates a node on an orphan mesh part.

Inherited from PropertyPart

CompositeLayup(name[, description, ...])

This method creates a CompositeLayup object.

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

This method creates a SectionAssignment object.

MaterialOrientation([region, localCsys, ...])

This method creates a MaterialOrientation object.

assignBeamSectionOrientation(region, method, n1)

This method assigns a beam section orientation to a region of a part.

assignMaterialOrientation(region, localCsys)

This method assigns a material orientation to a region.

assignRebarOrientation(region, localCsys[, ...])

This method assigns a rebar reference orientation to a region.

flipNormal(regions[, referenceRegion])

This method flips the normals of shell or membrane elements of an orphan mesh or of two-dimensional geometric regions.

flipTangent(regions)

This method flips the tangents of beam or truss elements of an orphan mesh or of one-dimensional geometric regions.

unassignBeamSectionOrientation(index)

This method deletes a beam section orientation assignment.

unassignMaterialOrientation(index)

This method deletes a material orientation assignment.

unassignRebarOrientation(index)

This method deletes a rebar orientation assignment.

Inherited from RegionPart

Surface([side1Faces, side2Faces, ...])

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

Set(name, *args, **kwargs)

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

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

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

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

This method modifies underlying entities of the selected skin.

Stringer(name[, edges, elementEdges])

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

Inherited from RegionPartBase

clashSets(arg1, arg2)

This command prints a message describing the relationship between the contents of two sets.

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.

deleteSets(setNames)

This command deletes the given sets from the part.

deleteSurfaces(surfaceNames)

This command deletes the given surfaces from the part.

Inherited from PartBase

__init__(*args, **kwargs)

PartFromBooleanCut(name, instanceToBeCut, ...)

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

PartFromBooleanMerge(name, instances[, ...])

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

PartFromExtrude2DMesh(name, part, depth, ...)

This method creates a Part object by extruding an existing two-dimensional orphan mesh Part object in the positive Z-direction and places it in the parts repository.

PartFromGeometryFile(name, geometryFile, ...)

This method creates a Part object and places it in the parts repository.

PartFromInstanceMesh(name[, partInstances, ...])

This method creates a Part object containing the mesh found in the supplied PartInstance objects and places the new Part object in the parts repository.

PartFromMesh(name[, copySets])

This method creates a Part object containing the mesh found in the part and places the new Part object in the parts repository.

PartFromMeshMirror(name, part, point1, point2)

This method creates a Part object by mirroring an existing orphan mesh Part object about a specified plane and places it in the parts repository.

PartFromNodesAndElements(name, ...[, twist])

This method creates a Part object from nodes and elements and places it in the parts repository.

PartFromOdb(name, odb[, fileName, instance, ...])

This method creates an orphan mesh Part object by reading an output database.

PartFromSection3DMeshByPlane(name, part, ...)

This method creates a Part object by cutting an existing three-dimensional orphan mesh Part object by a plane and places it in the parts repository.

PartFromSubstructure(name, substructureFile, ...)

This method creates a substructure Part object by reading a substructure sim file and places it in the parts repository.

Part2DGeomFrom2DMesh(name, part, featureAngle)

This method creates a geometric Part object from the outline of an existing two-dimensional orphan mesh Part object and places it in the parts repository.

setValues(*args, **kwargs)

This method modifies the Part object.

addGeomToSketch(sketch)

This method converts a part into a sketch by projecting all of the edges of the part onto the X-Y plane of the sketch.

assignThickness(faces[, thickness, ...])

This method assigns thickness data to shell faces.

backup()

This method makes a backup copy of the features in the part.

checkGeometry([detailed, reportFacetErrors, ...])

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

clearGeometryCache()

This method clears the geometry cache.

deleteAllFeatures()

This method deletes all the features in the part.

deleteFeatures(featureNames)

This method deletes the given features.

getAngle(plane1, plane2, line1, line2[, ...])

This method returns the angle between the specified entities.

getArea(faces[, relativeAccuracy])

This method returns the total surface area of a given face or group of faces.

getAssociatedCADPaths()

This method returns the paths to the associated CAD part and root file.

getCADParameters()

This method returns the names and values of the CAD parameters associated with the part.

getCentroid(faces, cells[, relativeAccuracy])

Location of the centroid of a given face/cell or group of faces/cells

getCoordinates(entity, csys)

This method returns the coordinates of specified point.

getCurvature(edges[, samplePoints])

This method returns the maximum curvature of a given edge or group of edges.

getDistance(entity1, entity2)

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

getLength(edges)

This method returns the length of a given edge or group of edges.

getPerimeter(faces)

This method returns the total perimeter of a given face or group of faces.

getVolume(cells[, relativeAccuracy])

This method returns the volume area of a given cell or group of cells.

getMassProperties([regions, ...])

This method returns the mass properties of a part or region.

getFeatureFaces(name)

This method returns a sequence of Face objects that are created by the given feature.

getFeatureEdges(name)

This method returns a sequence of Edge objects that are created by the given feature.

getFeatureCells(name)

This method returns a sequence of Cell objects that are created by the given feature.

getFeatureVertices(name)

This method returns a sequence of ConstrainedSketchVertex objects that are created by the given feature.

isAlignedWithSketch()

This method checks if the normal of an analytical rigid surface part is aligned with that of its sketch.

printAssignedSections()

This method prints information on each section that has been assigned to a region of the part.

projectEdgesOntoSketch(sketch, edges[, ...])

This method projects the selected edges of a part onto the specified ConstrainedSketch object.

projectReferencesOntoSketch(sketch[, ...])

This method projects the vertices of specified edges, and datum points from the part onto the specified ConstrainedSketch object.

queryAttributes([printResults])

This method prints the following information about a part:

queryCachedStates()

This method displays the position of geometric states relative to the sequence of features in the part cache.

queryGeometry([relativeAccuracy, printResults])

This method prints the following information about a part:

queryRegionsMissingSections()

This method returns all regions in the part that do not have a section assignment but require one for analysis.

queryDisjointPlyRegions()

This method provides a list of all composite plys in the current part which have disjoint regions.

regenerate()

This method regenerates a part.

regenerationWarnings()

This method prints any regeneration warnings associated with the features.

removeInvalidGeometry()

Removes all invalid entities from the part, leaving a valid part.

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.

resumeFeatures(featureNames)

This method resumes the specified suppressed features in the part.

resumeLastSetFeatures()

This method resumes the last set of features to be suppressed in the part.

saveGeometryCache()

This method caches the current geometry.

setAssociatedCADPaths([partFile, rootFile])

This method sets the paths to the associated CAD part and root file.

suppressFeatures(featureNames)

This method suppresses the given features.

writeAcisFile(fileName[, version])

This method exports the geometry of the part to a named file in ACIS format.

writeCADParameters(paramFile[, ...])

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

writeIgesFile(fileName, flavor)

This method exports the geometry of the part to a named file in IGES format.

writeStepFile(fileName)

This method exports the geometry of the part to a named file in STEP format.

writeVdaFile(fileName)

This method exports the geometry of the part to a named file in VDA-FS format.

copyMeshPattern(elements, faces, elemFaces, ...)

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

Lock()

This method locks the part.

Unlock()

This method unlocks the part.

LockForUpgrade()

This method locks the part for upgrade.

Inherited from PartFeature

AutoRepair()

This method carries out a sequence of geometry repair operations if it contains invalid entities.

AddCells(faceList[, flipped])

This method tries to convert a shell entity to a solid entity.

AnalyticRigidSurf2DPlanar(sketch)

This method creates a first Feature object for an analytical rigid surface by creating a planar wire from the given ConstrainedSketch object.

AnalyticRigidSurfExtrude(sketch[, depth])

This method creates a first Feature object for an analytical rigid surface by extruding the given ConstrainedSketch object by the given depth, creating a surface.

AnalyticRigidSurfRevolve(sketch)

This method creates a first Feature object for an analytical rigid surface by revolving the given ConstrainedSketch object by 360° about the Y-axis.

AssignMidsurfaceRegion(cellList)

This method assign a mid-surface property to sequence of Cell objects.

BaseSolidExtrude(sketch, depth[, ...])

This method creates a first Feature object by extruding the given ConstrainedSketch object by the given depth, creating a solid.

BaseSolidRevolve(sketch, angle[, pitch, ...])

This method creates a first Feature object by revolving the given ConstrainedSketch object by the given angle, creating a solid.

BaseSolidSweep(sketch, path)

This method creates a first Feature object by sweeping the given profile ConstrainedSketch object along the path defined by the path ConstrainedSketch object, creating a solid.

BaseShell(sketch)

This method creates a first Feature object by creating a planar shell from the given ConstrainedSketch object.

BaseShellExtrude(sketch, depth[, ...])

This method creates a first Feature object by extruding the given ConstrainedSketch object by the given depth, creating a shell.

BaseShellRevolve(sketch, angle[, pitch, ...])

This method creates a first Feature object by revolving the given ConstrainedSketch object by the given angle, creating a shell.

BaseShellSweep(sketch, path)

This method creates a first Feature object by sweeping the given section ConstrainedSketch object along the path defined by the path ConstrainedSketch object, creating a shell.

BaseWire(sketch)

This method creates a first Feature object by creating a planar wire from the given ConstrainedSketch object.

BlendFaces(side1, side2[, method, path])

This method creates a Feature object by creating new faces that blends two sets of faces.

Chamfer(length, edgeList)

This method creates an additional Feature object by chamfering the given list of edges with a given length.

Mirror(mirrorPlane, keepOriginal[, ...])

This method mirrors existing part geometry across a plane to create new geometry.

ConvertToAnalytical()

This method attempts to change entities into a simpler form that will speed up processing and make entities available during feature operations.

ConvertToPrecise([method])

This method attempts to change imprecise entities so that the geometry becomes precise.

CoverEdges(edgeList[, tryAnalytical])

This method generates a face using the given edges as the face's boundaries.

Cut(sketchPlane, sketchPlaneSide, ...[, ...])

This method creates an additional Feature object by cutting a hole using the given ConstrainedSketch object.

CutExtrude(sketchPlane, sketchPlaneSide, ...)

This method creates an additional Feature object by extruding the given ConstrainedSketch object by the given depth and cutting away material in the solid and shell regions of the part.

CutLoft(loftsections[, startCondition, ...])

This method creates an additional Feature object by lofting between the given sections and cutting away material from the part.

CutRevolve(sketchPlane, sketchPlaneSide, ...)

This method creates an additional Feature object by revolving the given ConstrainedSketch object by the given angle and cutting away material from the part.

CutSweep(path, profile[, pathPlane, ...])

This method creates an additional Feature object by sweeping the given ConstrainedSketch object along a path which may be a ConstrainedSketch or a sequence of Edge objects and cutting away material from the part.

ExtendFaces([faces, extendAlong, distance, ...])

This method extends faces along its free edges by offsetting the external edges along the surfaces.

FaceFromElementFaces(elementFaces[, stitch, ...])

This method creates a geometry face from a collection of orphan element faces.

HoleBlindFromEdges(plane, planeSide, ...)

This method creates an additional Feature object by creating a circular blind hole of the given diameter and depth and cutting away material in the solid and shell regions of the part.

HoleFromEdges(diameter, edge1, distance1, ...)

This method creates an additional Feature object by creating a circular hole of the given diameter in a 2D planar part and cutting away material in the shell and wire regions of the part.

HoleThruAllFromEdges(plane, planeSide, ...)

This method creates an additional Feature object by creating a circular through hole of the given diameter and cutting away material in the solid and shell regions of the part.

MergeEdges([edgeList, extendSelection])

This method merges edges either by extending the user selection or using only the selected edges.

OffsetFaces(faceList[, distance, ...])

This method creates new faces by offsetting existing faces.

RemoveCells(cellList)

This method converts a solid entity to a shell entity.

RemoveFaces(faceList[, deleteCells])

This method removes faces from a solid entity or from a shell entity.

RemoveFacesAndStitch(faceList)

This method removes faces from a solid entity and attempts to close the resulting gap by extending the neighboring faces of the solid.

RemoveRedundantEntities([vertexList, ...])

This method removes redundant edges and vertices from a solid or a shell entity.

RepairFaceNormals([faceList])

This method works on the entire part or a sequence of shell faces.

RepairInvalidEdges(edgeList)

This method repairs invalid edges.

RepairSliver(face, point1, point2[, ...])

This method repairs the selected sliver from the selected face.

RepairSmallEdges(edgeList[, toleranceChecks])

This method repairs small edges.

RepairSmallFaces(faceList[, toleranceChecks])

This method repairs small faces.

ReplaceFaces(faceList[, stitch])

This method replaces the selected faces with a single face.

Round(radius, edgeList, vertexList)

This method creates an additional Feature object by rounding (filleting) the given list of entities with the given radius.

Shell(sketchPlane, sketchPlaneSide, ...[, ...])

This method creates an additional Feature object by creating a planar shell from the given ConstrainedSketch object.

ShellExtrude(sketchPlane, sketchPlaneSide, ...)

This method creates an additional Feature object by extruding the given ConstrainedSketch object by the given depth, creating a shell protrusion.

ShellLoft(loftsections[, startCondition, ...])

This method creates an additional Feature object by lofting between the given sections and adding shell faces to the part.

ShellRevolve(sketchPlane, sketchPlaneSide, ...)

This method creates an additional Feature object by revolving the given ConstrainedSketch object by the given angle, creating a shell protrusion.

ShellSweep(path, profile[, pathPlane, ...])

This method creates an additional Feature object by sweeping the given ConstrainedSketch object or a sequence of Edge objects along a path which may be a ConstrainedSketch or a sequence of Edge objects, creating a shell swept protrusion.

SolidExtrude(sketchPlane, sketchPlaneSide, ...)

This method creates an additional Feature object by extruding the given ConstrainedSketch object by the given depth, creating a solid protrusion.

SolidLoft(loftsections[, startCondition, ...])

This method creates an additional Feature object by lofting between the given sections and adding material to the part.

SolidRevolve(sketchPlane, sketchPlaneSide, ...)

This method creates an additional Feature object by revolving the given ConstrainedSketch object by the given angle, creating a solid protrusion.

SolidSweep(path, profile[, pathPlane, ...])

This method creates an additional Feature object by sweeping the given ConstrainedSketch object or a Face object along a path which may be a ConstrainedSketch or a sequence of Edge objects, creating a solid swept protrusion.

Stitch([edgeList, stitchTolerance])

This method attempts to create a valid part by binding together free and imprecise edges of all the faces of a part.

Wire(sketchPlane, sketchPlaneSide, ...[, ...])

This method creates an additional Feature object by creating a planar wire from the given ConstrainedSketch object.

WireSpline(points[, mergeType, ...])

This method creates an additional Feature object by creating a spline wire that passes through a sequence of given points.

WirePolyLine(points[, mergeType, meshable])

This method creates an additional Feature object by creating a polyline wire that passes through a sequence of given points.

WireFromEdge(edgeList)

This method creates an additional Feature object by creating a Wire by selecting one or more Edge objects of a Solid or Shell part.

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 polyline wire that passes through a sequence of given points.

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(*args, **kwargs)

This method modifies the Part object.

suppress()

This method suppresses features.


AddCells(faceList, flipped=OFF)[source]#

This method tries to convert a shell entity to a solid entity. The conversion is not always successful.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • faceList (Tuple[Face, ...]) – A sequence of Face objects specifying the faces bounding the cell to add.

  • flipped (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying the direction of feature creation. The possible values are True and False. The default is True indicating that the direction is opposite to the face normal. When multiple faces are selected, Abaqus attempts to create cells on both sides of the selected faces and ignores the flipped argument.

Returns:

feature – A Feature object

Return type:

Feature

AnalyticRigidSurf2DPlanar(sketch)[source]#

This method creates a first Feature object for an analytical rigid surface by creating a planar wire from the given ConstrainedSketch object.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:

sketch (ConstrainedSketch) – A ConstrainedSketch object specifying the planar wire.

Returns:

feature – A Feature object

Return type:

Feature

AnalyticRigidSurfExtrude(sketch, depth=1)[source]#

This method creates a first Feature object for an analytical rigid surface by extruding the given ConstrainedSketch object by the given depth, creating a surface.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
Returns:

feature – A Feature object

Return type:

Feature

AnalyticRigidSurfRevolve(sketch)[source]#

This method creates a first Feature object for an analytical rigid surface by revolving the given ConstrainedSketch object by 360° about the Y-axis.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:

sketch (ConstrainedSketch) – A ConstrainedSketch object specifying the surface to be revolved.

Returns:

feature – A Feature object

Return type:

Feature

AssignMidsurfaceRegion(cellList)[source]#

This method assign a mid-surface property to sequence of Cell objects. If a reference representation of the part does not exist, it creates one. It also copies the cells to the reference representation and deletes the cells from the active representation of the part.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:

cellList (Tuple[Cell, ...]) – A sequence of Cell objects specifying the regions that will be used for mid-surface construction. These regions will be copied to the reference representation of the part.

Returns:

feature – A Feature object

Return type:

Feature

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

AutoRepair()[source]#

This method carries out a sequence of geometry repair operations if it contains invalid entities. It is expected to improve the geometry, but it does not guarantee that the number of invalid entities will decrease. In some cases, it can also increase the number of invalid entities. Since a number of geometry repair operations and validity checks are performed, it could be a slow operation depending on the complexity of the geometry.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Returns:

feature – A Feature object

Return type:

Feature

BaseShell(sketch)[source]#

This method creates a first Feature object by creating a planar shell from the given ConstrainedSketch object. The ConstrainedSketch object must define a closed profile.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:

sketch (ConstrainedSketch) – A ConstrainedSketch object specifying the planar shell.

Returns:

feature – A Feature object

Return type:

Feature

BaseShellExtrude(sketch, depth, draftAngle=None, pitch=None)[source]#

This method creates a first Feature object by extruding the given ConstrainedSketch object by the given depth, creating a shell. The ConstrainedSketch object can define either an open or closed profile.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • sketch (ConstrainedSketch) – A ConstrainedSketch object specifying the shape to be extruded.

  • depth (float) – A Float specifying the extrusion depth. Possible values are Floats > 0.

  • draftAngle (Optional[float], default: None) – A Float specifying the draft angle in degrees. Possible values are -90.0 ≤ draftAngle ≤ 90.0. By convention, for a positive draft angle an outer loop will draft outward and an inner loop will draft inward. The opposite is true for a negative draft angle. The default value, 0, implies a normal extrude. The arguments draftAngle and pitch are mutually exclusive.

  • pitch (Optional[float], default: None) – A Float specifying the pitch. The pitch is the distance traveled along the axial direction by the sketch when the sketch has completed one full revolution about the twist axis. Pitch can be specified as positive or negative to achieve right-handed or left-handed twist about the twist axis, respectively. The default value, 0, implies a normal extrude. Possible values are -105 ≤ pitch ≤ 105. The arguments draftAngle and pitch are mutually exclusive.

Returns:

A Feature object.

Return type:

Feature

Raises:

RangeError

BaseShellRevolve(sketch, angle, pitch=None, flipRevolveDirection=OFF, flipPitchDirection=OFF, moveSketchNormalToPath=OFF)[source]#

This method creates a first Feature object by revolving the given ConstrainedSketch object by the given angle, creating a shell. The ConstrainedSketch object can define either an open or closed profile and an axis of revolution. The axis is defined by a single construction line.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • sketch (ConstrainedSketch) – A ConstrainedSketch object specifying the shape to be revolved.

  • angle (float) – A Float specifying the revolve angle in degrees. Possible values are 0 ≤ angle ≤ 360.Note:If pitch >> 0, there is no upper limit for angle.

  • pitch (Optional[float], default: None) – A Float specifying the pitch. The pitch is the distance traveled along the axial direction, measured between corresponding points on the sketch when it has completed one full revolution about the axis of revolution. Possible values are 0 ≤ pitch ≤ 105. The default value, 0, implies a normal revolve.

  • flipRevolveDirection (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to override the direction of feature creation. If flipRevolveDirection = OFF, the default direction of revolution is used. If flipRevolveDirection = ON, the revolve direction is reversed. The default value is OFF.

  • flipPitchDirection (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to override the direction of translation. If flipPitchDirection = OFF, the direction of translation is given by the direction of the revolve axis. If flipPitchDirection = ON, the translation direction is reversed. The default value is OFF.

  • moveSketchNormalToPath (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to rotate the sketch so that it is normal to the path of revolution when using the pitch option. If moveSketchNormalToPath = OFF, the sketch plane remains parallel to the revolve axis. If moveSketchNormalToPath = ON, the sketch is moved to match the angle created by the pitch before being revolved. The default value is OFF.

Returns:

feature – A Feature object

Return type:

Feature

BaseShellSweep(sketch, path)[source]#

This method creates a first Feature object by sweeping the given section ConstrainedSketch object along the path defined by the path ConstrainedSketch object, creating a shell. The ConstrainedSketch object can define either an open or closed profile. The origin of the profile sketch is positioned at the start of the sweep path and swept perpendicular to the path. No checks are made for self-intersection.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
Returns:

feature – A Feature object

Return type:

Feature

BaseSolidExtrude(sketch, depth, draftAngle=None, pitch=None)[source]#

This method creates a first Feature object by extruding the given ConstrainedSketch object by the given depth, creating a solid. The ConstrainedSketch object must define a closed profile.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • sketch (ConstrainedSketch) – A ConstrainedSketch object specifying the plane shape to be extruded.

  • depth (float) – A Float specifying the extrusion depth. Possible values are 10-5 ≤ depth ≤ 105.

  • draftAngle (Optional[float], default: None) – A Float specifying the draft angle in degrees. Possible values are -90.0 ≤ draftAngle ≤ 90.0. By convention, for a positive draft angle an outer loop will draft outward and an inner loop will draft inward. The opposite is true for a negative draft angle. The default value, 0, implies a normal extrude. The arguments draftAngle and pitch are mutually exclusive.

  • pitch (Optional[float], default: None) – A Float specifying the pitch. The pitch is the distance traveled along the axial direction by the sketch when the sketch has completed one full revolution about the twist axis. Pitch can be specified as positive or negative to achieve right-handed or left-handed twist about the twist axis, respectively. The default value, 0, implies a normal extrude. Possible values are -105 ≤ pitch ≤ 105. The arguments draftAngle and pitch are mutually exclusive.

Returns:

A Feature object.

Return type:

Feature

BaseSolidRevolve(sketch, angle, pitch=None, flipRevolveDirection=OFF, flipPitchDirection=OFF, moveSketchNormalToPath=OFF)[source]#

This method creates a first Feature object by revolving the given ConstrainedSketch object by the given angle, creating a solid. The ConstrainedSketch object must define a closed profile and an axis of revolution. The axis is defined by a single construction line.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • sketch (ConstrainedSketch) – A ConstrainedSketch object specifying the shape to be revolved.

  • angle (float) – A Float specifying the revolve angle in degrees. Possible values are 10-4 ≤ angle ≤ 360.Note:If pitch >>0, there is no upper limit for angle.

  • pitch (Optional[float], default: None) – A Float specifying the pitch. The pitch is the distance traveled along the axial direction, measured between corresponding points on the sketch when it has completed one full revolution about the axis of revolution. Possible values are 0 ≤ pitch ≤ 105. The default value, 0, implies a normal revolve.

  • flipRevolveDirection (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to override the direction of feature creation. If flipRevolveDirection = OFF, the default direction of revolution is used. If flipRevolveDirection = ON, the revolve direction is reversed. The default value is OFF.

  • flipPitchDirection (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to override the direction of translation. If flipPitchDirection = OFF, the direction of translation is given by the direction of the revolve axis. If flipPitchDirection = ON, the translation direction is reversed. The default value is OFF.

  • moveSketchNormalToPath (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to rotate the sketch so that it is normal to the path of revolution when using the pitch option. If moveSketchNormalToPath = OFF, the sketch plane remains parallel to the revolve axis. If moveSketchNormalToPath = ON, the sketch is moved to match the angle created by the pitch before being revolved. The default value is OFF.

Returns:

A Feature object.

Return type:

Feature

Raises:

RangeError

BaseSolidSweep(sketch, path)[source]#

This method creates a first Feature object by sweeping the given profile ConstrainedSketch object along the path defined by the path ConstrainedSketch object, creating a solid. The profile ConstrainedSketch object must define a closed profile. The origin of the profile sketch is positioned at the start of the sweep path and swept perpendicular to the path. No checks are made for self-intersection.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
Returns:

feature – A Feature object

Return type:

Feature

BaseWire(sketch)[source]#

This method creates a first Feature object by creating a planar wire from the given ConstrainedSketch object.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:

sketch (ConstrainedSketch) – A ConstrainedSketch object specifying the planar wire.

Returns:

feature – A Feature object

Return type:

Feature

BlendFaces(side1, side2, method=None, path=None)[source]#

This method creates a Feature object by creating new faces that blends two sets of faces.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • side1 (Tuple[Edge, ...]) – A sequence of Edge objects specifying one side of the blend. The edges must form a continuous chain without branches.

  • side2 (tuple) – A sequence of Edge or Face objects specifying the second side of the blend. If side2 contains Edge objects then they must form a continuous chain without branches.

  • method (Optional[Literal[TANGENT, SHORTEST_PATH, SPECIFY_PATH]], default: None) – A SymbolicConstant indicating a method for creating blends. This argument is a required argument if side2 contains Edge object and it is ignored if side2 contains Faceobjects. It can have one of the following values:TANGENT: The blend is tangent to the sides.SHORTEST_PATH: The blend connects the two sides based on linear interpolation between the two sides.SPECIFY_PATH: The blend connects the two sides along a specified path.

  • path (Optional[Edge], default: None) – An Edge object that connects side1 to side2 and specifies the path for creating the blend. This argument is required if method = SPECIFY_PATH; otherwise, it is ignored.

Returns:

feature – A Feature object

Return type:

Feature

Chamfer(length, edgeList)[source]#

This method creates an additional Feature object by chamfering the given list of edges with a given length.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • length (float) – A Float specifying the length of the chamfer.

  • edgeList (Tuple[Edge, ...]) – A sequence of Edge objects specifying the edges to chamfer.

Returns:

feature – A Feature object

Return type:

Feature

CompositeLayup(name, description='', offsetType=abaqusConstants.GLOBAL, offsetField='', offsetValues=0, elementType=abaqusConstants.SHELL, symmetric=OFF)[source]#

This method creates a CompositeLayup object.

Note

This function can be accessed by:

mdb.models[name].parts[name].CompositeLayup
Parameters:
  • name (str) – A String specifying the repository key.

  • description (str, default: '') – A String specifying a description of the composite layup.

  • offsetType (SymbolicConstant, default: GLOBAL) – A SymbolicConstant specifying the method used to define the shell offset. If offsetType = OFFSET_FIELD the offsetField argument is required. This member is valid only if elementType = SHELL. Possible values are SINGLE_VALUE, MIDDLE_SURFACE, TOP_SURFACE, BOTTOM_SURFACE, OFFSET_FIELD, and GLOBAL. The default value is GLOBAL.

  • offsetField (str, default: '') – A String specifying The name of the field specifying the offset. This member is valid only if elementType = SHELL. The default value is an empty string.

  • offsetValues (float, default: 0) – A Float specifying The offset of the shell section. This member is valid only if elementType = SHELL. The default value is 0.0.

  • elementType (SymbolicConstant, default: SHELL) – A SymbolicConstant specifying the type of element in the composite layup. Possible values are SHELL, CONTINUUM_SHELL, and SOLID. The default value is SHELL.

  • symmetric (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether or not the layup should be made symmetric by the analysis. The default value is OFF.

Returns:

layup – A CompositeLayup object.

Return type:

CompositeLayup

Raises:

AbaqusException

ConvertToAnalytical()[source]#

This method attempts to change entities into a simpler form that will speed up processing and make entities available during feature operations.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Returns:

feature – A Feature object

Return type:

Feature

ConvertToPrecise(method=abaqusConstants.RECOMPUTE_GEOMETRY)[source]#

This method attempts to change imprecise entities so that the geometry becomes precise.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:

method (Literal[RECOMPUTE_GEOMETRY, TIGHTEN_GAPS], default: RECOMPUTE_GEOMETRY) – A SymbolicConstant specifying the method to be used to convert the part to precise. Possible values are RECOMPUTE_GEOMETRY and TIGHTEN_GAPS. The default value is RECOMPUTE_GEOMETRY.

Returns:

feature – A Feature object

Return type:

Feature

CoverEdges(edgeList, tryAnalytical=False)[source]#

This method generates a face using the given edges as the face’s boundaries. The CoverEdges method generates a face by creating the geometry consisting of the underlying surface, associated edges, and vertices.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • edgeList (Tuple[Edge, ...]) – A sequence of Edge objects specifying the edges that bound the new face.

  • tryAnalytical (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether the newly created face should be analytical or not. The default is False.

Returns:

A Feature object.

Return type:

Feature

Raises:
  • Parterror – If the given boundary is not a closed loop.

  • Parterror – If the given boundary contains a zero length component.

  • Parterror – If the underlying surface is too difficult to fit.

Cut(sketchPlane, sketchPlaneSide, sketchUpEdge, sketch, sketchOrientation=None)[source]#

This method creates an additional Feature object by cutting a hole using the given ConstrainedSketch object.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • sketchPlane (str) – A Datum plane object or a planar Face object.

  • sketchPlaneSide (Literal[SIDE1, SIDE2]) – A SymbolicConstant specifying the direction of feature creation. Possible values are SIDE1 and SIDE2.

  • sketchUpEdge (Edge) – An Edge object or a Datum axis object specifying the vertical (Y) direction of the sketch.

  • sketch (ConstrainedSketch) – A ConstrainedSketch object specifying the planar cut.

  • sketchOrientation (Optional[Literal[RIGHT, LEFT, TOP, BOTTOM]], default: None) – A SymbolicConstant specifying the orientation of sketchUpEdge on the sketch. Possible values are RIGHT, LEFT, TOP, and BOTTOM.

Returns:

feature – A Feature object

Return type:

Feature

CutExtrude(sketchPlane, sketchPlaneSide, sketchUpEdge, sketchOrientation, sketch, depth=None, upToFace='', draftAngle=None, pitch=None, flipExtrudeDirection=OFF)[source]#

This method creates an additional Feature object by extruding the given ConstrainedSketch object by the given depth and cutting away material in the solid and shell regions of the part. The ConstrainedSketch object must define a closed profile. The CutExtrude method creates a blind cut (using depth), an up-to-face cut (using upToFace), or a through-all cut (if depth and upToFace are not specified).

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • sketchPlane (str) – A Datum plane object or a planar Face object.

  • sketchPlaneSide (Literal[SIDE1, SIDE2]) – A SymbolicConstant specifying the direction of feature creation. Possible values are SIDE1 and SIDE2.

  • sketchUpEdge (Edge) – An Edge object or a Datum axis object specifying the vertical (Y) direction of the sketch.

  • sketchOrientation (Literal[RIGHT, LEFT, TOP, BOTTOM]) – A SymbolicConstant specifying the orientation of sketchUpEdge on the sketch. Possible values are RIGHT, LEFT, TOP, and BOTTOM.

  • sketch (ConstrainedSketch) – A ConstrainedSketch object specifying the planar sketch to be extruded.

  • depth (Optional[float], default: None) – A Float specifying the extrusion depth. If depth is specified, the cut will be a blind cut. The default is to not specify a depth.

  • upToFace (str, default: '') – A Face specifying the face up to which to cut. If upToFace is specified, the cut will be an up-to-face cut. The default is to not specify a face.Note:If neither depth nor upToFace is specified, the cut will be a through-all cut.

  • draftAngle (Optional[float], default: None) – A Float specifying the draft angle in degrees. Possible values are -90.0 ≤ draftAngle ≤ 90.0. By convention, for a positive draft angle an outer loop will draft outward and an inner loop will draft inward. The opposite is true for a negative draft angle. The default value, 0, implies a normal extrude. The arguments draftAngle and pitch are mutually exclusive.

  • pitch (Optional[float], default: None) – A Float specifying the pitch. The pitch is the distance traveled along the axial direction by the sketch when the sketch has completed one full revolution about the twist axis. Pitch can be specified as positive or negative to achieve right-handed or left-handed twist about the twist axis, respectively. The default value, 0, implies a normal extrude. Possible values are -105 ≤ pitch ≤ 105. The arguments draftAngle and pitch are mutually exclusive.

  • flipExtrudeDirection (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to override the direction of feature creation. If the value is OFF, it means use the direction defined by the sketchPlaneSide; if the value is ON, it means use the opposite direction to the one defined by sketchPlaneSide. The default value is OFF.

Returns:

feature – A Feature object

Return type:

Feature

CutLoft(loftsections, startCondition=None, endCondition=None, startTangent=None, startMagnitude=None, endTangent=None, endMagnitude=None, globalSmoothing=OFF)[source]#

This method creates an additional Feature object by lofting between the given sections and cutting away material from the part. You define the sections using a sequence of edges from the part or an EdgeArray.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • loftsections (tuple) – A sequence of sequences of edges specifying the cross-sections to be lofted. Each outer sequence specifies a section through which the method will pass the loft feature. Each outer sequence can be defined as a sequence of edges or as an EdgeArray. The edges specifying a section must form a simple closed profile and must not contain multiple loops.

  • startCondition (Optional[Literal[NONE, NORMAL, RADIAL, SPECIFIED]], default: None) – A SymbolicConstant specifying the tangent direction at the start section of the loft feature. Possible values are NONE, NORMAL, RADIAL, and SPECIFIED. You can specify this argument only if the start and end sections are planar. You cannot use this argument in conjunction with the path argument. You must use the startCondition argument in conjunction with the endCondition argument.

  • endCondition (Optional[Literal[NONE, NORMAL, RADIAL, SPECIFIED]], default: None) – A SymbolicConstant specifying the tangent direction at the end section of the loft feature. Possible values are NONE, NORMAL, RADIAL, and SPECIFIED. You can specify this argument only if the start and end sections are planar. You cannot use this argument in conjunction with the path argument. You must use the endCondition argument in conjunction with the startCondition argument.

  • startTangent (Optional[float], default: None) – A Float specifying the angle in degrees of the tangent with respect to the plane in which the start section lies. You must specify the startTangent argument if startCondition = SPECIFIED. Possible values are 0.0 ≤ startTangent ≤ 180.0.

  • startMagnitude (Optional[float], default: None) – A Float specifying the magnitude of the startTangent. You must specify the startMagnitude argument if startCondition = SPECIFIED. Possible values are 0.0 << startMagnitude << 100.0.

  • endTangent (Optional[float], default: None) – A Float specifying the angle in degrees of the tangent with respect to the plane in which the end section lies. You must specify the endTangent argument if startCondition = SPECIFIED. Possible values are 0.0 ≤ endTangent ≤ 180.0.

  • endMagnitude (Optional[float], default: None) – A Float specifying the magnitude of the endTangent. This argument is to be used when the endCondition argument has the value SPECIFIED. Possible values are 0.0 << endMagnitude << 100.0.

  • globalSmoothing (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether each path defined in the paths argument is applied locally or globally.If the path is applied locally, its effect is felt only on faces created from the edges on the loftSections through which the paths pass through.If the path is applied globally, an averaging algorithm is applied over all the paths defined and is distributed over all the faces created.The default value is ON (globally).

Returns:

feature – A Feature object

Return type:

Feature

CutRevolve(sketchPlane, sketchPlaneSide, sketchUpEdge, sketchOrientation, sketch, angle, pitch=None, flipRevolveDirection=OFF, flipPitchDirection=OFF, moveSketchNormalToPath=OFF)[source]#

This method creates an additional Feature object by revolving the given ConstrainedSketch object by the given angle and cutting away material from the part. The ConstrainedSketch object must define a closed profile and an axis of revolution.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • sketchPlane (str) – A Datum plane object or a planar Face object.

  • sketchPlaneSide (Literal[SIDE1, SIDE2]) – A SymbolicConstant specifying the direction of feature creation. Possible values are SIDE1 and SIDE2.

  • sketchUpEdge (Edge) – An Edge object or a Datum axis object specifying the vertical (Y) direction of the sketch.

  • sketchOrientation (Literal[RIGHT, LEFT, TOP, BOTTOM]) – A SymbolicConstant specifying the orientation of sketchUpEdge on the sketch. Possible values are RIGHT, LEFT, TOP, and BOTTOM.

  • sketch (ConstrainedSketch) – A ConstrainedSketch object specifying the planar sketch to be revolved.

  • angle (float) – A Float specifying the angle in degrees to be revolved.

  • pitch (Optional[float], default: None) – A Float specifying the pitch. The pitch is the distance traveled along the axial direction, measured between corresponding points on the sketch when it has completed one full revolution about the axis of revolution. Possible values are 0 ≤ pitch ≤ 105. The default value, 0, implies a normal revolve.

  • flipRevolveDirection (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to override the direction of feature creation. If flipRevolveDirection = OFF, the default direction of revolution is used. If flipRevolveDirection = ON, the revolve direction is reversed. The default value is OFF.

  • flipPitchDirection (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to override the direction of translation. If flipPitchDirection = OFF, the direction of translation is given by the direction of the revolve axis. If flipPitchDirection = ON, the translation direction is reversed. The default value is OFF.

  • moveSketchNormalToPath (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to rotate the sketch so that it is normal to the path of revolution when using the pitch option. If moveSketchNormalToPath = OFF, the sketch plane remains parallel to the revolve axis. If moveSketchNormalToPath = ON, the sketch is moved to match the angle created by the pitch before being revolved. The default value is OFF.

Returns:

feature – A Feature object

Return type:

Feature

CutSweep(path, profile, pathPlane='', pathUpEdge=None, pathOrientation=abaqusConstants.RIGHT, sketchPlane='', sketchUpEdge=None, sketchOrientation=abaqusConstants.RIGHT, draftAngle=None, pitch=None, profileNormal=OFF, flipSweepDirection=OFF)[source]#

This method creates an additional Feature object by sweeping the given ConstrainedSketch object along a path which may be a ConstrainedSketch or a sequence of Edge objects and cutting away material from the part. If the profile section is a ConstrainedSketch object, it must define a closed profile. The section sketch can be created at the normal plane at the start of the sweep path or it may be created on a Datum plane or a planar Face. No checks are made for self-intersection.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • path (str) – Path may either be a ConstrainedSketch object or a sequence of Edge objects specifying the path of the sweep.

  • profile (str) – Profile may either be a ConstrainedSketch object or a Face object specifying the section to be swept.

  • pathPlane (str, default: '') – A Datum plane object or a planar Face object. Only required when path is a ConstrainedSketch object.

  • pathUpEdge (Optional[Edge], default: None) – An Edge object or a Datum axis object specifying the vertical (Y) direction of the path sketch. Only required when path is a ConstrainedSketch object.

  • pathOrientation (Literal[RIGHT, LEFT, TOP, BOTTOM], default: RIGHT) – A SymbolicConstant specifying the orientation of pathUpEdge on the sketch. Possible values are RIGHT, LEFT, TOP, and BOTTOM. Default value is RIGHT. Only required when path is a ConstrainedSketch object.

  • sketchPlane (str, default: '') – A Datum plane object or a planar Face object specifying the plane on which to sketch the profile. Not required when profile is a Face object. When profile is chosen as a ConstrainedSketch object, user may or may not give this as input. If user does not give this as input, the normal plane at the start of the path will be the sketchPlane.

  • sketchUpEdge (Optional[Edge], default: None) – An Edge object or a Datum axis object specifying the vertical (Y) direction of the profile sketch. Only required when profile is a ConstrainedSketch object.

  • 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. Default value is RIGHT. Only required when profile is a ConstrainedSketch object.

  • draftAngle (Optional[float], default: None) – A Float specifying the draft angle in degrees. Possible values are -90.0 ≤ draftAngle ≤ 90.0. By convention, for a positive draft angle an outer loop will draft outward and an inner loop will draft inward. The opposite is true for a negative draft angle. The default value, 0, implies a normal extrude. The arguments draftAngle and pitch are mutually exclusive.

  • pitch (Optional[float], default: None) – A Float specifying the pitch. The pitch is the distance traveled along the axial direction by the sketch when the sketch has completed one full revolution about the twist axis. Pitch can be specified as positive or negative to achieve right-handed or left-handed twist about the twist axis, respectively. The default value, 0, implies a normal extrude. Possible values are -105 ≤ pitch ≤ 105. The arguments draftAngle and pitch are mutually exclusive.

  • profileNormal (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to keep the profile normal same as original or varying through out the sweep path. When profileNormal = OFF, the profile normal will vary through out the sweep path. When profileNormal = ON, the profile normal will be same as original through out the sweep path. The default value is OFF.

  • flipSweepDirection (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to flip the direction in which sweep operation will be performed. When flipSweepDirection = OFF, sweep operation will be performed in the direction of path direction. When flipSweepDirection = ON, sweep operation will be performed in the direction opposite to the path direction. The default value is OFF.

Returns:

feature – A Feature object

Return type:

Feature

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

EditSkin(name='', faces=(), edges=(), elementFaces=(), elementEdges=())[source]#

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

Note

This function can be accessed by:

mdb.models[name].parts[name].EditSkin
Parameters:
  • name (str, default: '') – A String specifying the repository key. The default value is an empty string.

  • faces (Tuple[Face, ...], default: ()) – A sequence of Face objects specifying the faces on which skins should be created. Applicable to three and two-dimensional parts.

  • edges (Tuple[Edge, ...], default: ()) – A sequence of Edge objects specifying the edges on which skins should be created. Applicable to axisymmetric parts.

  • elementFaces (Tuple[MeshFace, ...], default: ()) – A sequence of MeshFace objects specifying the mesh faces on which skins should be created. Applicable to three and two-dimensional parts.

  • elementEdges (Tuple[MeshEdge, ...], default: ()) – A sequence of MeshEdge objects specifying the mesh edges on which skins should be created. Applicable to axisymmetric parts.

Returns:

skin – A Skin object

Return type:

Skin

ExtendFaces(faces=(), extendAlong=(), distance=None, upToFaces=(), trimToExtendedTargetSurfaces=True, upToReferenceRep=OFF)[source]#

This method extends faces along its free edges by offsetting the external edges along the surfaces. One of distance, upToReferenceRep, or upToFaces must be used to specify how far the faces need to be extended.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • faces (Tuple[Face, ...], default: ()) – A sequence of Face objects specifying the faces to be extended. The faces cannot belong to the reference representation. The faces and extendAlong arguments are mutually exclusive. One of them must be specified.

  • extendAlong (Tuple[Edge, ...], default: ()) – A sequence of Edge objects specifying the edges where to extend the faces. Only free edges are considered. The interior edges will be ignored. The faces and extendAlong arguments are mutually exclusive. One of them must be specified.

  • distance (Optional[float], default: None) – A Float indicating the distance to extend the faces along the edges. Either distance, upToReferenceRep, or upToFaces must be specified.

  • upToFaces (Tuple[Face, ...], default: ()) – A sequence of Face objects specifying the faces that the selected faces should be extended up to.

  • trimToExtendedTargetSurfaces (Union[AbaqusBoolean, bool], default: True) – A Boolean indicating that the surfaces of up to target faces should be extended before extending and trimming the selected faces. The default value is True.

  • upToReferenceRep (Union[AbaqusBoolean, bool], default: OFF) – A Boolean indicating that the selected faces should be extended along the selected edges and be trimmed along their intersection with the reference representation.

Returns:

feature – A Feature object

Return type:

Feature

FaceFromElementFaces(elementFaces, stitch=OFF, stitchTolerance=None, analyticFitTolerance=None, associateFace=OFF)[source]#

This method creates a geometry face from a collection of orphan element faces.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • elementFaces (Region) – A Region object specifying the collection of orphan element faces.

  • stitch (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the created geometry face should be stitched with existing geometry faces. Default value is TRUE.

  • stitchTolerance (Optional[float], default: None) – A Float indicating the maximum gap to be stitched. The value should be smaller than the minimum feature size and bigger than the maximum gap expected to be stitched in the model. Otherwise this command may remove small (sliver) edges that are smaller than the tolerance. If stitch tolerance is not provided then default value of 0.001 will be used for stitching.

  • analyticFitTolerance (Optional[float], default: None) – A Float indicating the analytical surface fitting tolerance. If analytical tolerance is not provided then default value of 0.015 will be used for analytical surface fitting.

  • associateFace (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the created geometry face should be associated with the mesh. Default value is TRUE.

Returns:

feature – A Feature object

Return type:

Feature

HoleBlindFromEdges(plane, planeSide, diameter, edge1, distance1, edge2, distance2, depth)[source]#

This method creates an additional Feature object by creating a circular blind hole of the given diameter and depth and cutting away material in the solid and shell regions of the part. The center of the hole is offset from two non-parallel straight edges by the given distances.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • plane (str) – A Datum plane object or a planar Face object.

  • planeSide (Literal[SIDE1, SIDE2]) – A SymbolicConstant specifying the direction of feature creation. Possible values are SIDE1 and SIDE2.

  • diameter (float) – A Float specifying the diameter of the hole.

  • edge1 (Edge) – An Edge object specifying the edge from which distance1 is measured.

  • distance1 (float) – A Float specifying the offset from edge1.

  • edge2 (Edge) – An Edge object specifying the edge from which distance2 is measured.

  • distance2 (float) – A Float specifying the offset from edge2.

  • depth (float) – A Float specifying the depth of the hole.

Returns:

feature – A Feature object

Return type:

Feature

HoleFromEdges(diameter, edge1, distance1, edge2, distance2)[source]#

This method creates an additional Feature object by creating a circular hole of the given diameter in a 2D planar part and cutting away material in the shell and wire regions of the part. The center of the hole is offset from two non-parallel straight edges by the given distances.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • diameter (float) – A Float specifying the diameter of the hole.

  • edge1 (Edge) – An Edge object specifying the edge from which distance1 is measured.

  • distance1 (float) – A Float specifying the offset from edge1.

  • edge2 (Edge) – An Edge object specifying the edge from which distance2 is measured.

  • distance2 (float) – A Float specifying the offset from edge2.

Returns:

feature – A Feature object

Return type:

Feature

HoleThruAllFromEdges(plane, planeSide, diameter, edge1, distance1, edge2, distance2)[source]#

This method creates an additional Feature object by creating a circular through hole of the given diameter and cutting away material in the solid and shell regions of the part. The center of the hole is offset from two non-parallel straight edges by the given distances.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • plane (str) – A Datum plane object or a planar Face object.

  • planeSide (Literal[SIDE1, SIDE2]) – A SymbolicConstant specifying the direction of feature creation. Possible values are SIDE1 and SIDE2.

  • diameter (float) – A Float specifying the diameter of the hole.

  • edge1 (Edge) – An Edge object specifying the edge from which distance1 is measured.

  • distance1 (float) – A Float specifying the offset from edge1.

  • edge2 (Edge) – An Edge object specifying the edge from which distance2 is measured.

  • distance2 (float) – A Float specifying the offset from edge2.

Returns:

feature – A Feature object

Return type:

Feature

Lock()[source]#

This method locks the part. Locking the part prevents any further changes to the part that can trigger regeneration of the part.

LockForUpgrade()[source]#

This method locks the part for upgrade. Locking the part prevents any further changes to the part that can trigger regeneration of the part. When the part is unlocked, all the parts are upgraded and regenrated.

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

MaterialOrientation(region=None, localCsys=None, axis=abaqusConstants.AXIS_1, angle=0, stackDirection=abaqusConstants.STACK_3, fieldName='', orientationType=abaqusConstants.GLOBAL, normalAxisDirection=abaqusConstants.AXIS_3, normalAxisDefinition=abaqusConstants.NORMAL_VECTOR, normalAxisRegion=None, normalAxisDatum=None, flipNormalDirection=OFF, normalAxisVector=(), primaryAxisDirection=abaqusConstants.AXIS_1, primaryAxisDefinition=abaqusConstants.PRIMARY_VECTOR, primaryAxisRegion=None, primaryAxisDatum=None, flipPrimaryDirection=OFF, primaryAxisVector=())[source]#

This method creates a MaterialOrientation object.

Note

This function can be accessed by:

mdb.models[name].parts[name].MaterialOrientation
Parameters:
  • region (Optional[Set], default: None) – A Set object specifying a region for which the material orientation is defined.

  • localCsys (Optional[DatumCsys], default: None) – A DatumCsys object specifying the local coordinate system or None, describing the material orientation for the given region. In the ODB, this member was previously accessible using “csys,” but support has now been added for localCsys and the csys member will be deprecated.

  • axis (SymbolicConstant, default: AXIS_1) – A SymbolicConstant specifying the axis of a datum coordinate system about which an additional rotation is applied. For shells this axis is also the shell normal. Possible values are AXIS_1, AXIS_2, and AXIS_3. The default value is AXIS_1.

  • angle (float, default: 0) – A Float specifying the angle of the additional rotation (if accessed from the ODB instead of the MDB, it will be a string instead of a float). The default value is 0.0.

  • stackDirection (SymbolicConstant, default: STACK_3) – A SymbolicConstant specifying the stack or thickness direction. Possible values are STACK_1, STACK_2, STACK_3, and STACK_ORIENTATION. The default value is STACK_3.

  • fieldName (str, default: '') – A String specifying the name of the DiscreteField object specifying the orientation. The default value is an empty string.

  • orientationType (SymbolicConstant, default: GLOBAL) – A SymbolicConstant specifying the method used to define the material orientation. If orientationType = SYSTEM, the region and localCsys arguments are required. If orientationType = FIELD, the fieldName argument is required. Possible values are GLOBAL, SYSTEM, FIELD, DISCRETE, and USER. The default value is GLOBAL.

  • normalAxisDirection (SymbolicConstant, default: AXIS_3) – A SymbolicConstant specifying the axis that is defined by the normal axis direction for a discrete orientation. Possible values are AXIS_1, AXIS_2, and AXIS_3. The default value is AXIS_3.

  • normalAxisDefinition (SymbolicConstant, default: NORMAL_VECTOR) – A SymbolicConstant specifying the method used to define the normal axis direction for a discrete orientation. Possible values are SURFACE, NORMAL_DATUM, and NORMAL_VECTOR. The default value is NORMAL_VECTOR.

  • normalAxisRegion (Optional[Surface], default: None) – A Surface object specifying a region whose geometric normals define the normal axis for the discrete orientation.

  • normalAxisDatum (Optional[DatumAxis], default: None) – A DatumAxis object specifying the Datum Axis or None, describing the normal axis direction for the discrete orientation.

  • flipNormalDirection (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying the flag to reverse the direction of the defined normal axis direction. The default value is OFF.

  • normalAxisVector (tuple, default: ()) – A sequence of Floats specifying the vector that defines the direction of the normal axis of the discrete orientation.

  • primaryAxisDirection (SymbolicConstant, default: AXIS_1) – A SymbolicConstant specifying the axis that is defined by the primary axis direction for a discrete orientation. Possible values are AXIS_1, AXIS_2, and AXIS_3. The default value is AXIS_1.

  • primaryAxisDefinition (SymbolicConstant, default: PRIMARY_VECTOR) – A SymbolicConstant specifying the method used to define the primary axis direction for a discrete orientation. Possible values are SURFACE, PRIMARY_DATUM, and PRIMARY_VECTOR. The default value is PRIMARY_VECTOR.

  • primaryAxisRegion (Optional[Set], default: None) – A Set object specifying a region whose geometric tangents define the primary axis for the discrete orientation.

  • primaryAxisDatum (Optional[DatumAxis], default: None) – A DatumAxis object specifying the Datum Axis or None, describing the primary axis direction for the discrete orientation.

  • flipPrimaryDirection (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying the flag to reverse the direction of the defined primary axis direction. The default value is OFF.

  • primaryAxisVector (tuple, default: ()) – A sequence of Floats specifying the vector that defines the direction of the primary axis of the discrete orientation.

Returns:

orientation – A MaterialOrientation object.

Return type:

MaterialOrientation

MergeEdges(edgeList=(), extendSelection=OFF)[source]#

This method merges edges either by extending the user selection or using only the selected edges.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • edgeList (Tuple[Edge, ...], default: ()) – A sequence of Edge objects specifying the edges to be merged.

  • extendSelection (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the user selection needs to be extended to include edges till branching occurs. Branching is said to occur when the vertex of an edge is shared by more than two edges.

Returns:

feature – A Feature object

Return type:

Feature

Mirror(mirrorPlane, keepOriginal, keepInternalBoundaries=OFF)[source]#

This method mirrors existing part geometry across a plane to create new geometry.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • mirrorPlane (str) – A Datum plane object or a planar Face object.

  • keepOriginal (Union[AbaqusBoolean, bool]) – A boolean specifying whether or not the original part geometry should be retained.

  • keepInternalBoundaries (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether internal boundaries will be retained. The default value is OFF.

Returns:

feature – A Feature object

Return type:

Feature

Node(coordinates, localCsys=None, label=None)[source]#

This method creates a node on an orphan mesh part.

Note

This function can be accessed by:

mdb.models[name].parts[name].Node
Parameters:
  • coordinates (tuple) – A sequence of three Floats specifying the coordinates of the new node.

  • localCsys (Optional[DatumCsys], default: None) – A DatumCsys object specifying the local coordinate system. If unspecified, the global coordinate system will be used.

  • label (Optional[int], default: None) – An Int specifying the node label.

Returns:

A MeshNode object.

Return type:

MeshNode

OffsetFaces(faceList, distance=None, targetFaces=(), targetFacesMethod=None, fractionDistance=None, trimToReferenceRep=OFF)[source]#

This method creates new faces by offsetting existing faces.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • faceList (Tuple[Face, ...]) – A sequence of Face objects specifying the faces that will be offset. The faces may belong to the part or to the reference representation associated with the part.

  • distance (Optional[float], default: None) – A Float indicating the distance to offset the faces. Either distance or targetFaces must be specified.

  • targetFaces (Tuple[Face, ...], default: ()) – A sequence of Face objects whose distance to the faces argument together with the targetFacesMethod determines the distance to offset the faces. Either distance or targetFaces must be specified.

  • targetFacesMethod (Optional[Literal[HALF_OF_AVERAGE, CLOSEST_POINT_FRACTION, FARTHEST_POINT_FRACTION]], default: None) – A SymbolicConstant indicating how to calculate the distance to offset. It can have one of the following values:HALF_OF_AVERAGE: Offset the faces by a distance equals to half the average distance to target faces.CLOSEST_POINT_FRACTION: Offset the faces by a distance equals to the fraction of the distance to the approximate closest point on the selected target faces.FARTHEST_POINT_FRACTION: Offset the faces by a distance equals to the fraction of the distance to the approximate farthest point on the selected target faces.

  • fractionDistance (Optional[float], default: None) – A Float indicating the fraction of the distance to the closest or the farthest point on the target faces. Its default value is 0.5.

  • trimToReferenceRep (Union[AbaqusBoolean, bool], default: OFF) – A Boolean indicating whether to extend the offset faces and trim them along their intersection with the reference representation.

Returns:

feature – A Feature object

Return type:

Feature

Part2DGeomFrom2DMesh(name, part, featureAngle, splineCurvatureLimit=90, twist=OFF)[source]#

This method creates a geometric Part object from the outline of an existing two-dimensional orphan mesh Part object and places it in the parts repository. If the Part2DGeomFrom2DMesh method cannot create a valid two-dimensional shell section from the two-dimensional mesh, the method fails and creates an empty geometry part with a failed base shell feature.

Note

This function can be accessed by:

mdb.models[name].Part
Parameters:
  • name (str) – A String specifying the repository key.

  • part (PartBase) – A Part object specifying an existing two-dimensional orphan mesh Part object.

  • featureAngle (float) – A Float specifying the angle (in degrees) between line segments that triggers a break in the geometry.

  • splineCurvatureLimit (float, default: 90) – A Float specifying the traversal angle in degrees of the spline that triggers a break in the geometry. The default value is 90.

  • twist (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to include a twist DEGREE OF FREEDOM in the part (only available when dimensionality = AXISYMMETRIC and type = DEFORMABLE_BODY). The default value is OFF.

Returns:

part – A Part object

  • If the specified part is not an orphan mesh part: Specified part must be an orphan mesh.

  • If the Part2DGeomFrom2DMesh method cannot create a valid two-dimensional shell section from the two-dimensional mesh: Planar shell feature failed

  • If the specified part is not two-dimensional: Cannot create a geometry from a 3D part.

  • If the specified part is a rigid body: Cannot create a geometry from a rigid body.

Return type:

Part

PartFromBooleanCut(name, instanceToBeCut, cuttingInstances)[source]#

This method creates a Part in the parts 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].Part
Parameters:
  • name (str) – A String specifying the repository key.

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

Returns:

part – A Part object

Return type:

Part

PartFromBooleanMerge(name, instances, keepIntersections=False, mergeNodes=abaqusConstants.BOUNDARY_ONLY, nodeMergingTolerance=None, removeDuplicateElements=ON, domain=abaqusConstants.GEOMETRY)[source]#

This method creates a Part in the parts repository after merging two or more part instances. The part instances can be either Abaqus native parts or orphan mesh parts, but they cannot be a combination of both.

Note

This function can be accessed by:

mdb.models[name].Part
Parameters:
  • name (str) – A String specifying the repository key.

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

  • mergeNodes (SymbolicConstant, default: BOUNDARY_ONLY) – A SymbolicConstant specifying whether the nodes of orphan mesh part instances should be retained after the merge operation. 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 orphan mesh part instances that will be merged and replaced with a single new node. The location of the new node is the average position of the deleted nodes. The default value is 10-6.

  • removeDuplicateElements (Union[AbaqusBoolean, bool], default: ON) – A Boolean specifying whether elements with the same connectivity after the merge will merged into a single element. The default value is ON.

  • domain (SymbolicConstant, default: GEOMETRY) – A SymbolicConstant specifying whether the part instances being merged are geometric instances or mesh instances. Possible values are GEOMETRY, MESH or BOTH. The default value is GEOMETRY.

Returns:

part – A Part object

Return type:

Part

PartFromExtrude2DMesh(name, part, depth, elementSize)[source]#

This method creates a Part object by extruding an existing two-dimensional orphan mesh Part object in the positive Z-direction and places it in the parts repository.

Note

This function can be accessed by:

mdb.models[name].Part
Parameters:
  • name (str) – A String specifying the repository key.

  • part (PartBase) – A Part object specifying an existing two-dimensional orphan mesh Part object.

  • depth (float) – A Float specifying the total extrusion distance.

  • elementSize (float) – A Float specifying an approximate element length in the extruded direction.

Returns:

part – A Part object

  • If the specified part is not an orphan mesh part: Cannot extrude a geometric part.

  • If the specified part is not two-dimensional: Cannot extrude a 3D part.

  • If the specified part is a rigid body: Cannot change dimension of a rigid body.

Return type:

Part

PartFromGeometryFile(name, geometryFile, dimensionality, type, bodyNum=1, combine=False, booleanSolids=False, retainBoundary=False, usePartNameFromFile=OFF, stitchTolerance=1, twist=OFF, scale=1, convertToAnalytical=0, convertToPrecise=0)[source]#

This method creates a Part object and places it in the parts repository.

Note

This function can be accessed by:

mdb.models[name].Part
Parameters:
  • name (str) – A String specifying the repository key.

  • geometryFile (AcisFile) – An AcisFile object specifying a file containing geometry.

  • dimensionality (SymbolicConstant) – A SymbolicConstant specifying the dimensionality of the part. Possible values are THREE_D, TWO_D_PLANAR, and AXISYMMETRIC.

  • type (SymbolicConstant) – A SymbolicConstant specifying the type of the part. Possible values are DEFORMABLE_BODY, EULERIAN, DISCRETE_RIGID_SURFACE, and ANALYTIC_RIGID_SURFACE.

  • bodyNum (int, default: 1) – An Int specifying the desired body to be selected from an ACIS object containing a list of N ACIS bodies. Possible values are 1 ≤ bodyNumN. The default value is 1.

  • combine (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying weather to create a single part by combining all the bodies in the ACIS object. This argument is ignored if bodyNum is specified. The default value is False.

  • booleanSolids (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether the solids should be boolean while combining all the bodies.The default value is FALSE.

  • retainBoundary (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether the intersecting boundaries should be retained while boolean the solids.The default value is FALSE.

  • usePartNameFromFile (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the part names specified in a STEP file should be used as the names in the Abaqus model database. If this option is TRUE, the part names in the STEP file will be used; if FALSE, each imported part will be named using the text of the name argument followed by a number. This functionality is available only for import from STEP files; for import from all other types of files this option should be FALSE.

  • stitchTolerance (float, default: 1) – A Float indicating the maximum gap to be stitched. The value should be smaller than the minimum feature size and bigger than the maximum gap expected to be stitched in the model. Otherwise this command may remove small (sliver) edges that are smaller than the tolerance. The default value is 1.0

  • twist (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to include a twist DEGREE OF FREEDOM in the part (only available when dimensionality = AXISYMMETRIC and type = DEFORMABLE_BODY). The default value is OFF.

  • scale (float, default: 1) – A Float specifying the scaling factor to apply to the imported geometric entities. The default value is 1.0.

  • convertToAnalytical (int, default: 0) – An Int specifying whether to convert to analytical entities. Possible values are 0 or 1. The default value is 0. If convertToAnalytical = 1, all the numerical entities, such as splines, are converted to analytical entities, such as arcs and lines, during the repair phase of the command.

  • convertToPrecise (int, default: 0) – An Int specifying whether to convert to precise geometry. Possible value are 0 or 1. The default value is 0. If convertToPrecise = 1, the application will attempt to re-evaluate the tolerant entities to be more precise.

Returns:

part – A Part object

  • If the ACIS file is corrupt: PartError: the file is corrupt

  • If the dimensionality does not correspond to what is found in the ACIS file: PartError: dimensionality does not match the contents of the file

  • If the type does not correspond to what is found in the ACIS file: PartError: type does not match the contents of the file

Return type:

Part

PartFromInstanceMesh(name, partInstances=(), copyPartSets=False, copyAssemblySets=False)[source]#

This method creates a Part object containing the mesh found in the supplied PartInstance objects and places the new Part object in the parts repository.

Note

This function can be accessed by:

mdb.models[name].Part
Parameters:
  • name (str) – A String specifying the repository key.

  • partInstances (Tuple[PartInstance, ...], default: ()) – A sequence of PartInstance objects to be used in the creation of the new mesh part. If the partInstances argument is omitted, the new Part object contains the mesh of all the part instances in the assembly.

  • copyPartSets (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to copy sets, surfaces, and attributes from the base part or parts of the specified part instances to the new part. The default is False.

  • copyAssemblySets (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to copy assembly-level sets that reference entities of the specified part instances to the new part. The default is False.

Returns:

part – A Part object

  • If the analysis type (deformable or rigid) is not consistent among the supplied part instances: The selected part instances do not have a consistent analysis type.

  • If the assembly does not contain a mesh: The current assembly does not contain a mesh for a mesh part.

  • If the specified part instances do not contain a mesh: The selected part instances do not have a mesh for a mesh part.

Return type:

Part

PartFromMesh(name, copySets=False)[source]#

This method creates a Part object containing the mesh found in the part and places the new Part object in the parts repository.

Note

This function can be accessed by:

mdb.models[name].Part
Parameters:
  • name (str) – A String specifying the repository key.

  • copySets (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether to copy sets, surfaces, and attributes to the new part. The default is False.

Returns:

part – A Part object

  • If the part does not contain a mesh: The current part does not contain a mesh for a mesh part.

Return type:

Part

PartFromMeshMirror(name, part, point1, point2)[source]#

This method creates a Part object by mirroring an existing orphan mesh Part object about a specified plane and places it in the parts repository. The result is a union of the original and the mirrored copy. Contrast the PartFromMeshMirror method with the mirrorPlane argument of the Part copy constructor. The mirrorPlane argument creates only the second half of the part but does not unite the two halves.

Note

This function can be accessed by:

mdb.models[name].Part
Parameters:
  • name (str) – A String specifying the repository key.

  • part (PartBase) – A Part object specifying an existing orphan mesh part.

  • point1 (tuple) – A sequence of three Floats specifying a point on the mirror plane. This point is the local origin in the local system of the plane.

  • point2 (tuple) – A sequence of three Floats specifying a point in the direction of the normal to the mirror plane. This point must not be coincident with point1.

Returns:

part – A Part object

  • If the specified part is not an orphan mesh part: Cannot mirror a geometric part.

  • If the specified part is a rigid body: Cannot mirror a rigid body.

  • If point1 and point2 are coincident: Mirror plane director has zero length.

  • If the specified part is two-dimensional and the plane is not parallel to the Z-axis: Mirror plane must be parallel to Z axis for 2D parts

Return type:

Part

PartFromNodesAndElements(name, dimensionality, type, nodes, elements, twist=OFF)[source]#

This method creates a Part object from nodes and elements and places it in the parts repository.

Note

This function can be accessed by:

mdb.models[name].Part
Parameters:
  • name (str) – A String specifying the repository key.

  • dimensionality (SymbolicConstant) – A SymbolicConstant specifying the dimensionality of the part. Possible values are THREE_D, TWO_D_PLANAR, and AXISYMMETRIC.

  • type (SymbolicConstant) – A SymbolicConstant specifying the type of the part. Possible values are DEFORMABLE_BODY, EULERIAN, DISCRETE_RIGID_SURFACE, and ANALYTIC_RIGID_SURFACE.

  • nodes (tuple) – A sequence of (nodeLabels, nodeCoords) specifying the nodes of the mesh. nodeLabels is a sequence of Ints specifying the node labels, and nodeCoords is a sequence of sequences of three Floats specifying the nodal coordinates.

  • elements (tuple) – A sequence of sequences of(meshType, elementLabels, elementConns) specifying the elements of the mesh. meshType is a String specifying the element type. elementlabels is a sequence of Ints specifying the element labels. elementConns is a sequence of sequences of node labels specifying the element connectivity.

  • twist (Union[AbaqusBoolean, bool], default: OFF) – A boolean specifying whether the part is defined with twist. This option has meaning only when dimensionality = AXISYMMETRIC. Possible values are ON and OFF. The default value is OFF.

Returns:

part – A Part object

Return type:

Part

PartFromOdb(name, odb, fileName='', instance='', elementSet='', shape=abaqusConstants.UNDEFORMED, step=None, frame=None, twist=OFF)[source]#

This method creates an orphan mesh Part object by reading an output database. The new part is placed in the parts repository.

Note

This function can be accessed by:

mdb.models[name].Part
Parameters:
  • name (str) – A String specifying the repository key.

  • odb (str) – An output database object.

  • fileName (str, default: '') – A String specifying the name of the output database file from which to create the part. The default value is an empty string.

  • instance (str, default: '') – A String specifying the part instance in the output database from which to create the part. If no instance name is specified, Abaqus creates an orphan mesh part from the first part instance in the output database.

  • elementSet (str, default: '') – A String specifying an element set defined on the output database. Only elements from this set will be imported. The default is to import all element sets.

  • shape (SymbolicConstant, default: UNDEFORMED) – A SymbolicConstant specifying the configuration state. Possible values are UNDEFORMED and DEFORMED. The default value is UNDEFORMED.

  • step (Optional[int], default: None) – An Int specifying the step number for reading deformed coordinates. 0≤step≤N−10≤step≤N-1 where NN is the number of available steps. The default value is the last available step. You should specify the step argument only when shape = DEFORMED.

  • frame (Optional[int], default: None) – An Int specifying the frame number for reading deformed coordinates. 0≤frame≤N−10≤frame≤N-1 where NN is the number of available frames. The default value is the last available frame. You should specify the frame argument only when shape = DEFORMED.

  • twist (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to include a twist DEGREE OF FREEDOM in the part (only available when dimensionality = AXISYMMETRIC and type = DEFORMABLE_BODY). The default value is OFF.

Returns:

part – A Part object

  • If the output database contains elements of more than one dimensionality or type: File contains both axisymmetric and nonaxisymmetric elements.File contains both 2D and 3D elements.File contains both rigid and deformable elements.

  • If more than one part is found on the output database: PartError: importing of more than one part is not currently supported

  • If the output database does not contain any valid results for the specified step: Error. File does not contain any valid frames.

  • If the specified step and frame do not contain any displacements: Error. Specified frame does not contain nodal displacements.

  • If the specified element set is not found on the output database: Error. Specified element set is not defined in the ODB.

  • If the step number is invalid: OdiError: Invalid step index: i. Available step indices: 0 - j.

  • If the frame number is invalid: OdiError: Invalid frame index: i. Available frame indices: 0 - j.

Return type:

Part

PartFromSection3DMeshByPlane(name, part, point1, point2, point3)[source]#

This method creates a Part object by cutting an existing three-dimensional orphan mesh Part object by a plane and places it in the parts repository. This method is valid only for orphan mesh parts composed of 8-node brick elements.

Note

This function can be accessed by:

mdb.models[name].Part
Parameters:
  • name (str) – A String specifying the repository key.

  • part (PartBase) – A Part object specifying an existing three-dimensional orphan mesh part.

  • point1 (float) – A Sequence of three Floats specifying a point on the cutting plane. This point is the local origin in the local system of the plane.

  • point2 (float) – A Sequence of three Floats specifying a point in the direction of the normal to the cutting plane. This point must not be coincident with point1.

  • point3 (tuple) – A sequence of three Floats specifying the direction of the local 1-axis in the local system of the plane. This point must not project onto point1.

Returns:

part – A Part object

  • If the specified part is not an orphan mesh part: Cannot reduce dimension of a geometric part.

  • If the specified part is not three-dimensional: Cannot reduce dimension of a 2D part.

  • If the specified part is a rigid body: Cannot change dimension of a rigid body.

  • If point1 and point2 are coincident: Cutting plane director has zero length.

  • If point3 projects onto point1: Local axis point projects to origin.

  • If no elements are cut by the specified plane: Cannot reduce part dimension.

Return type:

Part

PartFromSubstructure(name, substructureFile, odbFile)[source]#

This method creates a substructure Part object by reading a substructure sim file and places it in the parts repository.

Note

This function can be accessed by:

mdb.models[name].Part
Parameters:
  • name (str) – A String specifying the repository key.

  • substructureFile (str) – A substructure sim file.

  • odbFile (str) – The output database file corresponding to the substructure sim file.

Returns:

part – A Part object

  • If the specified part is not a substructure: File specified does not contain a substructure.

  • If the specified part already exists: A part with the same name already exists.

  • If the substructure cannot be imported: The output database is missing nodes and elements.Nested substructures are not supported.The substructure sim file was generated using a version that is different from the current version.

Return type:

Part

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
Parameters:
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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
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

RemoveCells(cellList)[source]#

This method converts a solid entity to a shell entity.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:

cellList (Tuple[Cell, ...]) – A sequence of Cell objects specifying the cells to remove.

Returns:

A Boolean value.

Return type:

Boolean

Raises:

Parterror – If the intended volume to be turned into a shell entity is not three-dimensional.

RemoveFaces(faceList, deleteCells=False)[source]#

This method removes faces from a solid entity or from a shell entity.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • faceList (Tuple[Face, ...]) – A sequence of Face objects specifying the faces to remove.

  • deleteCells (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether all cells are to be deleted when the faces are removed. The default value is False.

Returns:

feature – A Feature object

Return type:

Feature

RemoveFacesAndStitch(faceList)[source]#

This method removes faces from a solid entity and attempts to close the resulting gap by extending the neighboring faces of the solid.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:

faceList (Tuple[Face, ...]) – A sequence of Face objects specifying the faces to remove.

Returns:

feature – A Feature object

Return type:

Feature

RemoveRedundantEntities(vertexList=(), edgeList=(), removeEdgeVertices=True)[source]#

This method removes redundant edges and vertices from a solid or a shell entity. One of the two arguments is required.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • vertexList (Tuple[Vertex, ...], default: ()) – A sequence of ConstrainedSketchVertex objects specifying the vertices to be removed.

  • edgeList (Tuple[Edge, ...], default: ()) – A sequence of Edge objects specifying the edges to be removed.

  • removeEdgeVertices (Union[AbaqusBoolean, bool], default: True) – A Boolean specifying whether the vertices of the redundant edges need to be removed. The default is True.

Returns:

A Feature object.

Return type:

Feature

Raises:

Parterror – If the selected entity is not a redundant entity.

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

RepairFaceNormals(faceList=())[source]#

This method works on the entire part or a sequence of shell faces. When the entire part is selected, it aligns all the shell face normals, and inverts all of the solid faces’ normals if the solid was originally inside out. When a few shell faces are selected, it inverts the normals of the selected faces.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:

faceList (Tuple[Face, ...], default: ()) – A sequence of Face objects.

Returns:

feature – A Feature object

Return type:

Feature

RepairInvalidEdges(edgeList)[source]#

This method repairs invalid edges. It will always attempt to improve edges even if none of selected edges are initially invalid and may leave behind invalid edges that could not be repaired.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:

edgeList (Tuple[Edge, ...]) – A sequence of Edge objects.

Returns:

feature – A Feature object

Return type:

Feature

RepairSliver(face, point1, point2, toleranceChecks=True)[source]#

This method repairs the selected sliver from the selected face. The sliver area is specified using two points. A face partition is carried out at the specified points and the smaller of the two faces is removed.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • face (Face) – A Face object specifying the face on which the sliver is located.

  • point1 (int) – A point specifying the location for partition creation. It can be a ConstrainedSketchVertex object, an Interesting Point or three coordinates specifying the point on an edge of the face.

  • point2 (int) – A point specifying the location for partition creation. It can be a ConstrainedSketchVertex object, an Interesting Point or three coordinates specifying the point on an edge of the face.

  • toleranceChecks (Union[AbaqusBoolean, bool], default: True) – A Boolean specifying whether to use internal tolerance checks to restrict the size of the sliver face being removed. The default is True.

Returns:

feature – A Feature object

Return type:

Feature

RepairSmallEdges(edgeList, toleranceChecks=True)[source]#

This method repairs small edges. This method will attempt to replace selected small edges with vertices and extend the adjacent faces and edges. This method might leave behind some small edges that cannot be removed.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • edgeList (Tuple[Edge, ...]) – A sequence of Edge objects.

  • toleranceChecks (Union[AbaqusBoolean, bool], default: True) – A Boolean specifying whether to use internal tolerance checks to restrict the size of the edges being removed. The default is True.

Returns:

feature – A Feature object

Return type:

Feature

RepairSmallFaces(faceList, toleranceChecks=True)[source]#

This method repairs small faces. It will attempt to replace the selected small faces with edges or vertices and extend the adjacent faces. This method might leave behind some small faces that cannot be removed.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • faceList (Tuple[Face, ...]) – A sequence of Face objects.

  • toleranceChecks (Union[AbaqusBoolean, bool], default: True) – A Boolean specifying whether to use internal tolerance checks to restrict the size of the faces being removed. The default is True.

Returns:

feature – A Feature object

Return type:

Feature

ReplaceFaces(faceList, stitch=True)[source]#

This method replaces the selected faces with a single face. If one single face is selected, that alone is replaced with a new face.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • faceList (Tuple[Face, ...]) – A sequence of Face objects to be replaced.

  • stitch (Union[AbaqusBoolean, bool], default: True) – A Boolean specifying whether the newly created face needs to be stitched to the existing geometry. The default is True.

Returns:

feature – A Feature object

Return type:

Feature

Round(radius, edgeList, vertexList)[source]#

This method creates an additional Feature object by rounding (filleting) the given list of entities with the given radius.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • radius (float) – A Float specifying the radius of the fillets.

  • edgeList (Tuple[Edge, ...]) – A sequence of Edge objects. Solid and Shell edges of a part can be rounded. The operation will fail for non-manifold edges. The edgeList and vertexList arguments are mutually exclusive. One of them must be specified.

  • vertexList (Tuple[Vertex, ...]) – A sequence of ConstrainedSketchVertex objects. Vertices that are connected to two wire edges can be rounded. The operation will fail for a vertex connected to a face. The edgeList and vertexList arguments are mutually exclusive. One of them must be specified.

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

assignment – A SectionAssignment object

Return type:

SectionAssignment

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

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

Note

This function can be accessed by:

mdb.models[name].parts[name].Set
mdb.models[name].rootAssembly.Set
Parameters:

name

Returns:

set – A Set object

Return type:

Set

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

This method creates an additional Feature object by creating a planar shell from the given ConstrainedSketch object. The ConstrainedSketch object must define a closed profile.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • sketchPlane (str) – A Datum plane object or a planar Face object.

  • sketchPlaneSide (Literal[SIDE1, SIDE2]) – A SymbolicConstant specifying the direction of feature creation. Possible values are SIDE1 and SIDE2.

  • sketchUpEdge (Edge) – An Edge object or a Datum axis object specifying the vertical (Y) direction of the sketch.

  • sketch (ConstrainedSketch) – A ConstrainedSketch object specifying the planar shell.

  • 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:

feature – A Feature object

Return type:

Feature

ShellExtrude(sketchPlane, sketchPlaneSide, sketchUpEdge, sketch, depth=None, upToFace='', sketchOrientation=abaqusConstants.RIGHT, draftAngle=None, pitch=None, flipExtrudeDirection=OFF, keepInternalBoundaries=OFF)[source]#

This method creates an additional Feature object by extruding the given ConstrainedSketch object by the given depth, creating a shell protrusion. The ConstrainedSketch object can define either an open or closed profile.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • sketchPlane (str) – A Datum plane object or a planar Face object.

  • sketchPlaneSide (Literal[SIDE1, SIDE2]) – A SymbolicConstant specifying the direction of feature creation. Possible values are SIDE1 and SIDE2.

  • sketchUpEdge (Edge) – An Edge object or a Datum axis object specifying the vertical (Y) direction of the sketch.

  • sketch (ConstrainedSketch) – A ConstrainedSketch object specifying the planar sketch to be extruded.

  • depth (Optional[float], default: None) – A Float specifying the extrusion depth. The default is to not specify a depth. Either depth or upToFace must be used to define the extrusion depth.

  • upToFace (str, default: '') – A Face specifying the face up to which to extrude. If upToFace is specified, the extrusion will be an up-to-face extrusion. The default is to not specify a face. Either depth or upToFace must be used to define the extrusion depth.

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

  • draftAngle (Optional[float], default: None) – A Float specifying the draft angle in degrees. Possible values are -90.0 ≤ draftAngle ≤ 90.0. By convention, for a positive draft angle an outer loop will draft outward and an inner loop will draft inward. The opposite is true for a negative draft angle. The default value, 0, implies a normal extrude. The arguments draftAngle and pitch are mutually exclusive.

  • pitch (Optional[float], default: None) – A Float specifying the pitch. The pitch is the distance traveled along the axial direction by the sketch when the sketch has completed one full revolution about the twist axis. Pitch can be specified as positive or negative to achieve right-handed or left-handed twist about the twist axis, respectively. The default value, 0, implies a normal extrude. Possible values are -105 ≤ pitch ≤ 105. The arguments draftAngle and pitch are mutually exclusive.

  • flipExtrudeDirection (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to override the direction of feature creation. If the value is OFF, it means use the direction defined by the sketchPlaneSide; if the value is ON, it means use the opposite direction to the one defined by sketchPlaneSide. The default value is OFF.

  • keepInternalBoundaries (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether internal boundaries will be retained. The default value is OFF.

Returns:

feature – A Feature object

Return type:

Feature

ShellLoft(loftsections, startCondition=None, endCondition=None, startTangent=None, startMagnitude=None, endTangent=None, endMagnitude=None, paths=(), globalSmoothing=OFF, keepInternalBoundaries=OFF)[source]#

This method creates an additional Feature object by lofting between the given sections and adding shell faces to the part. You define the sections using a sequence of edges from the part or an EdgeArray.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • loftsections (tuple) – A sequence of sequences of edges specifying the cross-sections to be lofted. Each outer sequence specifies a section through which the method will pass the loft feature. Each outer sequence can be defined as a sequence of edges or as an EdgeArray. The edges specifying a section must form a simple closed profile and must not contain multiple loops.

  • startCondition (Optional[Literal[NONE, NORMAL, RADIAL, SPECIFIED]], default: None) – A SymbolicConstant specifying the tangent direction at the start section of the loft feature. Possible values are NONE, NORMAL, RADIAL and SPECIFIED. You can specify this argument only if the start and end sections are planar. You cannot use this argument in conjunction with the path argument. You must use the startCondition argument in conjunction with the endCondition argument.

  • endCondition (Optional[Literal[NONE, NORMAL, RADIAL, SPECIFIED]], default: None) – A SymbolicConstant specifying the tangent direction at the end section of the loft feature. Possible values are NONE, NORMAL, RADIAL and SPECIFIED. You can specify this argument only if the start and end sections are planar. You cannot use this argument in conjunction with the path argument. You must use the endCondition argument in conjunction with the startCondition argument.

  • startTangent (Optional[float], default: None) – A Float specifying the angle in degrees of the tangent with respect to the plane in which the start section lies. You must specify the startTangent argument if startCondition = SPECIFIED. Possible values are 0.0 ≤ startTangent ≤ 180.0.

  • startMagnitude (Optional[float], default: None) – A Float specifying the magnitude of the startTangent. You must specify the startMagnitude argument if startCondition = SPECIFIED. Possible values are 0.0 << startMagnitude << 100.0.

  • endTangent (Optional[float], default: None) – A Float specifying the angle in degrees of the tangent with respect to the plane in which the end section lies. You must specify the endTangent argument if startCondition = SPECIFIED. Possible values are 0.0 ≤ endTangent ≤ 180.0.

  • endMagnitude (Optional[float], default: None) – A Float specifying the magnitude of the endTangent. This argument is to be used when the endCondition argument has the value SPECIFIED. Possible values are 0.0 << endMagnitude << 100.0.

  • paths (tuple, default: ()) – A sequence of sequences of edges that pass through each section in the loft feature. Each sequence specifies a path followed by the face or an edge created by a loft feature. Each path must start at the first section, end at the last section, and pass through each section. In addition, the order of the sequences must be the same as the order of the sections in the loftsections argument. Each path must not self-intersect and must be tangent continuous. In addition, the paths must not intersect each other. You cannot use the paths argument in conjunction with the startCondition and endCondition arguments.

  • globalSmoothing (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether each path defined in the paths argument is applied locally or globally.If the path is applied locally, its effect is felt only on faces created from the edges on the loftsections through which the paths pass through.If the path is applied globally, an averaging algorithm is applied over all the paths defined and is distributed over all the faces created.The default value is ON (globally).

  • keepInternalBoundaries (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether internal boundaries will be retained. The default value is OFF.

Returns:

feature – A Feature object

Return type:

Feature

ShellRevolve(sketchPlane, sketchPlaneSide, sketchUpEdge, sketch, angle, sketchOrientation=abaqusConstants.RIGHT, pitch=None, flipRevolveDirection=OFF, flipPitchDirection=OFF, moveSketchNormalToPath=OFF, keepInternalBoundaries=OFF)[source]#

This method creates an additional Feature object by revolving the given ConstrainedSketch object by the given angle, creating a shell protrusion. The ConstrainedSketch object can define either an open or closed profile and an axis of revolution. The axis is defined by a single construction line. For a description of the plane positioning arguments, see SolidExtrude.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • sketchPlane (str) – A Datum plane object or a planar Face object.

  • sketchPlaneSide (Literal[SIDE1, SIDE2]) – A SymbolicConstant specifying the direction of feature creation. Possible values are SIDE1 and SIDE2.

  • sketchUpEdge (Edge) – An Edge object or a Datum axis object specifying the vertical (Y) direction of the sketch.

  • sketch (ConstrainedSketch) – A ConstrainedSketch object specifying the planar sketch to be revolved.

  • angle (float) – A Float specifying the angle in degrees to be revolved.

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

  • pitch (Optional[float], default: None) – A Float specifying the pitch. The pitch is the distance traveled along the axial direction, measured between corresponding points on the sketch when it has completed one full revolution about the axis of revolution. Possible values are 0 ≤ pitch ≤ 105. The default value, 0, implies a normal revolve.

  • flipRevolveDirection (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to override the direction of feature creation. If flipRevolveDirection = OFF, the default direction of revolution is used. If flipRevolveDirection = ON, the revolve direction is reversed. The default value is OFF.

  • flipPitchDirection (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to override the direction of translation. If flipPitchDirection = OFF, the direction of translation is given by the direction of the revolve axis. If flipPitchDirection = ON, the translation direction is reversed. The default value is OFF.

  • moveSketchNormalToPath (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to rotate the sketch so that it is normal to the path of revolution when using the pitch option. If moveSketchNormalToPath = OFF, the sketch plane remains parallel to the revolve axis. If moveSketchNormalToPath = ON, the sketch is moved to match the angle created by the pitch before being revolved. The default value is OFF.

  • keepInternalBoundaries (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether internal boundaries will be retained. The default value is OFF.

Returns:

feature – A Feature object

Return type:

Feature

ShellSweep(path, profile, pathPlane='', pathUpEdge=None, pathOrientation=abaqusConstants.RIGHT, sketchPlane='', sketchUpEdge=None, sketchOrientation=abaqusConstants.RIGHT, draftAngle=None, pitch=None, profileNormal=OFF, flipSweepDirection=OFF, keepInternalBoundaries=OFF)[source]#

This method creates an additional Feature object by sweeping the given ConstrainedSketch object or a sequence of Edge objects along a path which may be a ConstrainedSketch or a sequence of Edge objects, creating a shell swept protrusion. The section can be an open or a closed profile. The section sketch can be created at the normal plane at the start of the sweep path or it may be created on a Datum plane or a planar Face. No checks are made for self-intersection.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • path (str) – Path may either be a ConstrainedSketch object or a sequence of Edge objects specifying the path of the sweep.

  • profile (str) – Profile may either be a ConstrainedSketch object or a sequence of Edge objects specifying the section to be swept.

  • pathPlane (str, default: '') – A Datum plane object or a planar Face object. Only required when path is a ConstrainedSketch object.

  • pathUpEdge (Optional[Edge], default: None) – An Edge object or a Datum axis object specifying the vertical (Y) direction of the path sketch. Only required when path is a ConstrainedSketch object.

  • pathOrientation (Literal[RIGHT, LEFT, TOP, BOTTOM], default: RIGHT) – A SymbolicConstant specifying the orientation of pathUpEdge on the sketch. Possible values are RIGHT, LEFT, TOP, and BOTTOM. Default value is RIGHT. Only required when path is a ConstrainedSketch object.

  • sketchPlane (str, default: '') – A Datum plane object or a planar Face object specifying the plane on which to sketch the profile. Not required when profile is a Face object. When profile is chosen as ConstrainedSketch object, user may or may not give this as input. If user does not give this as input, the normal plane at the start of the path will be the sketchPlane.

  • sketchUpEdge (Optional[Edge], default: None) – An Edge object or a Datum axis object specifying the vertical (Y) direction of the profile sketch. Only required when profile is a ConstrainedSketch object.

  • 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. Default value is RIGHT. Only required when profile is a ConstrainedSketch object.

  • draftAngle (Optional[float], default: None) – A Float specifying the draft angle in degrees. Possible values are -90.0 ≤ draftAngle ≤ 90.0. By convention, for a positive draft angle an outer loop will draft outward and an inner loop will draft inward. The opposite is true for a negative draft angle. The default value, 0, implies a normal extrude. The arguments draftAngle and pitch are mutually exclusive.

  • pitch (Optional[float], default: None) – A Float specifying the pitch. The pitch is the distance traveled along the axial direction by the sketch when the sketch has completed one full revolution about the twist axis. Pitch can be specified as positive or negative to achieve right-handed or left-handed twist about the twist axis, respectively. The default value, 0, implies a normal extrude. Possible values are -105 ≤ pitch ≤ 105. The arguments draftAngle and pitch are mutually exclusive.

  • profileNormal (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to keep the profile normal same as original or varying through out the sweep path. When profileNormal = OFF, the profile normal will vary through out the sweep path. When profileNormal = ON, the profile normal will be same as original through out the sweep path. The default value is OFF.

  • flipSweepDirection (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to flip the direction in which sweep operation will be performed. When flipSweepDirection = OFF, sweep operation will be performed in the direction of path direction. When flipSweepDirection = ON, sweep operation will be performed in the direction opposite to the path direction. The default value is OFF.

  • keepInternalBoundaries (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether internal boundaries will be retained. The default value is OFF.

Returns:

feature – A Feature object

Return type:

Feature

Skin(name, faces=(), edges=(), elementFaces=(), elementEdges=())[source]#

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

Note

This function can be accessed by:

mdb.models[name].parts[name].Skin
Parameters:
  • name (str) – A String specifying the repository key. The default value is an empty string.

  • faces (Tuple[Face, ...], default: ()) – A sequence of Face objects specifying the faces on which skins should be created. Applicable to three and two-dimensional parts.

  • edges (Tuple[Edge, ...], default: ()) – A sequence of Edge objects specifying the edges on which skins should be created. Applicable to axisymmetric parts.

  • elementFaces (Tuple[MeshFace, ...], default: ()) – A sequence of MeshFace objects specifying the mesh faces on which skins should be created. Applicable to three and two-dimensional parts.

  • elementEdges (Tuple[MeshEdge, ...], default: ()) – A sequence of MeshEdge objects specifying the mesh edges on which skins should be created. Applicable to axisymmetric parts.

Returns:

skin – A Skin object

Return type:

Skin

SolidExtrude(sketchPlane, sketchPlaneSide, sketchUpEdge, sketch, depth=None, upToFace='', sketchOrientation=abaqusConstants.RIGHT, draftAngle=None, pitch=None, flipExtrudeDirection=OFF, keepInternalBoundaries=OFF)[source]#

This method creates an additional Feature object by extruding the given ConstrainedSketch object by the given depth, creating a solid protrusion. The ConstrainedSketch object must define a closed profile.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • sketchPlane (str) – A Datum plane object or a planar Face object.

  • sketchPlaneSide (Literal[SIDE1, SIDE2]) – A SymbolicConstant specifying the direction of feature creation. Possible values are SIDE1 and SIDE2.

  • sketchUpEdge (Edge) – An Edge object or a Datum axis object specifying the vertical (Y) direction of the sketch.

  • sketch (ConstrainedSketch) – A ConstrainedSketch object specifying the planar sketch to be extruded.

  • depth (Optional[float], default: None) – A Float specifying the extrusion depth. The default is to not specify a depth. Either depth or upToFace must be used to define the extrusion depth.

  • upToFace (str, default: '') – A Face specifying the face up to which to extrude. If upToFace is specified, the extrusion will be an up-to-face extrusion. The default is to not specify a face. Either depth or upToFace must be used to define the extrusion depth.

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

  • draftAngle (Optional[float], default: None) – A Float specifying the draft angle in degrees. Possible values are -90.0 ≤ draftAngle ≤ 90.0. By convention, for a positive draft angle an outer loop will draft outward and an inner loop will draft inward. The opposite is true for a negative draft angle. The default value, 0, implies a normal extrude. The arguments draftAngle and pitch are mutually exclusive.

  • pitch (Optional[float], default: None) – A Float specifying the pitch. The pitch is the distance traveled along the axial direction by the sketch when the sketch has completed one full revolution about the twist axis. Pitch can be specified as positive or negative to achieve right-handed or left-handed twist about the twist axis, respectively. The default value, 0, implies a normal extrude. Possible values are -105 ≤ pitch ≤ 105. The arguments draftAngle and pitch are mutually exclusive.

  • flipExtrudeDirection (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to override the direction of feature creation. If the value is OFF, it means use the direction defined by the sketchPlaneSide; if the value is ON, it means use the opposite direction to the one defined by sketchPlaneSide. The default value is OFF.

  • keepInternalBoundaries (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether internal boundaries will be retained. The default value is OFF.

Returns:

feature – A Feature object

Return type:

Feature

SolidLoft(loftsections, startCondition=None, endCondition=None, startTangent=None, startMagnitude=None, endTangent=None, endMagnitude=None, paths=(), globalSmoothing=OFF, keepInternalBoundaries=OFF)[source]#

This method creates an additional Feature object by lofting between the given sections and adding material to the part. You define the sections using a sequence of edges from the part or an EdgeArray.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • loftsections (tuple) – A sequence of sequences of edges specifying the cross-sections to be lofted. Each outer sequence specifies a section through which Abaqus will pass the loft feature. Each outer sequence can be defined as a sequence of edges or as an EdgeArray. The edges specifying a section must form a simple closed profile and must not contain multiple loops.

  • startCondition (Optional[Literal[NONE, NORMAL, RADIAL, SPECIFIED]], default: None) – A SymbolicConstant specifying the tangent direction at the start section of the loft feature. Possible values are NONE, NORMAL, RADIAL and SPECIFIED. You can specify this argument only if the start and end sections are planar. You cannot use this argument in conjunction with the path argument. You must use the startCondition argument in conjunction with the endCondition argument.

  • endCondition (Optional[Literal[NONE, NORMAL, RADIAL, SPECIFIED]], default: None) – A SymbolicConstant specifying the tangent direction at the end section of the loft feature. Possible values are NONE, NORMAL, RADIAL and SPECIFIED. You can specify this argument only if the start and end sections are planar. You cannot use this argument in conjunction with the path argument. You must use the endCondition argument in conjunction with the startCondition argument.

  • startTangent (Optional[float], default: None) – A Float specifying the angle in degrees of the tangent with respect to the plane in which the start section lies. You must specify the startTangent argument if startCondition = SPECIFIED. Possible values are 0.0 ≤ startTangent ≤ 180.0.

  • startMagnitude (Optional[float], default: None) – A Float specifying the magnitude of the startTangent. You must specify the startMagnitude argument if startCondition = SPECIFIED. Possible values are 0.0 << startMagnitude << 100.0.

  • endTangent (Optional[float], default: None) – A Float specifying the angle in degrees of the tangent with respect to the plane in which the end section lies. You must specify the endTangent argument if startCondition = SPECIFIED. Possible values are 0.0 ≤ endTangent ≤ 180.0.

  • endMagnitude (Optional[float], default: None) – A Float specifying the magnitude of the endTangent. This argument is to be used when the endCondition argument has the value SPECIFIED. Possible values are 0.0 << endMagnitude << 100.0.

  • paths (tuple, default: ()) – A sequence of sequences of edges that pass through each section in the loft feature. Each sequence specifies a path followed by the face or an edge created by a loft feature. Each path must start at the first section, end at the last section, and pass through each section. In addition, the order of the sequences must be the same as the order of the sections in the loftsections argument. Each path must not self-intersect and must be tangent continuous. In addition, the paths must not intersect each other. You cannot use the paths argument in conjunction with the startCondition and endCondition arguments.

  • globalSmoothing (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether each path defined in the paths argument is applied locally or globally.If the path is applied locally, its effect is felt only on faces created from the edges on the loftsections through which the paths pass through.If the path is applied globally, an averaging algorithm is applied over all the paths defined and is distributed over all the faces created.The default value is ON (globally).

  • keepInternalBoundaries (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether internal boundaries will be retained. The default value is OFF.

Returns:

feature – A Feature object

Return type:

Feature

SolidRevolve(sketchPlane, sketchPlaneSide, sketchUpEdge, sketch, angle, sketchOrientation=abaqusConstants.RIGHT, pitch=None, flipRevolveDirection=OFF, flipPitchDirection=OFF, moveSketchNormalToPath=OFF, keepInternalBoundaries=OFF)[source]#

This method creates an additional Feature object by revolving the given ConstrainedSketch object by the given angle, creating a solid protrusion. The ConstrainedSketch object must define a closed profile and an axis of revolution. The axis is defined by a single construction line.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • sketchPlane (str) – A Datum plane object or a planar Face object.

  • sketchPlaneSide (Literal[SIDE1, SIDE2]) – A SymbolicConstant specifying the direction of feature creation. Possible values are SIDE1 and SIDE2.

  • sketchUpEdge (Edge) – An Edge object or a Datum axis object specifying the vertical (Y) direction of the sketch.

  • sketch (ConstrainedSketch) – A ConstrainedSketch object specifying the planar sketch to be revolved.

  • angle (float) – A Float specifying the angle in degrees to be revolved.

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

  • pitch (Optional[float], default: None) – A Float specifying the pitch. The pitch is the distance traveled along the axial direction, measured between corresponding points on the sketch when it has completed one full revolution about the axis of revolution. Possible values are 0 ≤ pitch ≤ 105. The default value, 0, implies a normal revolve.

  • flipRevolveDirection (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to override the direction of feature creation. If flipRevolveDirection = OFF, the default direction of revolution is used. If flipRevolveDirection = ON, the revolve direction is reversed. The default value is OFF.

  • flipPitchDirection (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to override the direction of translation. If flipPitchDirection = OFF, the direction of translation is given by the direction of the revolve axis. If flipPitchDirection = ON, the translation direction is reversed. The default value is OFF.

  • moveSketchNormalToPath (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to rotate the sketch so that it is normal to the path of revolution when using the pitch option. If moveSketchNormalToPath = OFF, the sketch plane remains parallel to the revolve axis. If moveSketchNormalToPath = ON, the sketch is moved to match the angle created by the pitch before being revolved. The default value is OFF.

  • keepInternalBoundaries (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether internal boundaries will be retained. The default value is OFF.

Returns:

feature – A Feature object

Return type:

Feature

SolidSweep(path, profile, pathPlane='', pathUpEdge=None, pathOrientation=abaqusConstants.RIGHT, sketchPlane='', sketchUpEdge=None, sketchOrientation=abaqusConstants.RIGHT, draftAngle=None, pitch=None, profileNormal=OFF, flipSweepDirection=OFF, keepInternalBoundaries=OFF)[source]#

This method creates an additional Feature object by sweeping the given ConstrainedSketch object or a Face object along a path which may be a ConstrainedSketch or a sequence of Edge objects, creating a solid swept protrusion. If the profile section is a ConstrainedSketch object, it must define a closed profile. The section sketch can be created at the normal plane at the start of the sweep path or it may be created on a Datum plane or a planar Face. No checks are made for self-intersection.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • path (str) – Path may either be a ConstrainedSketch object or a sequence of Edge objects specifying the path of the sweep.

  • profile (str) – Profile may either be a ConstrainedSketch object or a Face object specifying the section to be swept.

  • pathPlane (str, default: '') – A Datum plane object or a planar Face object. Only required when path is a ConstrainedSketch object.

  • pathUpEdge (Optional[Edge], default: None) – An Edge object or a Datum axis object specifying the vertical (Y) direction of the path sketch. Only required when path is a ConstrainedSketch object.

  • pathOrientation (Literal[RIGHT, LEFT, TOP, BOTTOM], default: RIGHT) – A SymbolicConstant specifying the orientation of pathUpEdge on the sketch. Possible values are RIGHT, LEFT, TOP, and BOTTOM. Default value is RIGHT. Only required when path is a ConstrainedSketch object.

  • sketchPlane (str, default: '') – A Datum plane object or a planar Face object specifying the plane on which to sketch the profile. Not required when profile is a Face object. When profile is chosen as ConstrainedSketch object, user may or may not give this as input. If user does not give this as input, the normal plane at the start of the path will be the sketchPlane.

  • sketchUpEdge (Optional[Edge], default: None) – An Edge object or a Datum axis object specifying the vertical (Y) direction of the profile sketch. Only required when profile is a ConstrainedSketch object.

  • 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. Default value is RIGHT. Only required when profile is a ConstrainedSketch object.

  • draftAngle (Optional[float], default: None) – A Float specifying the draft angle in degrees. Possible values are -90.0 ≤ draftAngle ≤ 90.0. By convention, for a positive draft angle an outer loop will draft outward and an inner loop will draft inward. The opposite is true for a negative draft angle. The default value, 0, implies a normal extrude. The arguments draftAngle and pitch are mutually exclusive.

  • pitch (Optional[float], default: None) – A Float specifying the pitch. The pitch is the distance traveled along the axial direction by the sketch when the sketch has completed one full revolution about the twist axis. Pitch can be specified as positive or negative to achieve right-handed or left-handed twist about the twist axis, respectively. The default value, 0, implies a normal extrude. Possible values are -105 ≤ pitch ≤ 105. The arguments draftAngle and pitch are mutually exclusive.

  • profileNormal (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to keep the profile normal same as original or varying through out the sweep path. When profileNormal = OFF, the profile normal will vary through out the sweep path. When profileNormal = ON, the profile normal will be same as original through out the sweep path. The default value is OFF.

  • flipSweepDirection (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to flip the direction in which sweep operation will be performed. When flipSweepDirection = OFF, sweep operation will be performed in the direction of path direction. When flipSweepDirection = ON, sweep operation will be performed in the direction opposite to the path direction. The default value is OFF.

  • keepInternalBoundaries (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether internal boundaries will be retained. The default value is OFF.

Returns:

feature – A Feature object

Return type:

Feature

Stitch(edgeList=(), stitchTolerance=None)[source]#

This method attempts to create a valid part by binding together free and imprecise edges of all the faces of a part. If edgeList is not given, a global stitch will be performed. If stitchTolerance is not specified, a value of 1.0 will be used.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • edgeList (Tuple[Edge, ...], default: ()) – A sequence of Edge objects specifying the edges that need to be stitched.

  • stitchTolerance (Optional[float], default: None) – A Float indicating the maximum gap to be stitched. The value should be smaller than the minimum feature size and bigger than the maximum gap expected to be stitched in the model. Otherwise this command may remove small (sliver) edges that are smaller than the tolerance.

Returns:

feature – A Feature object

Return type:

Feature

Stringer(name, edges=(), elementEdges=())[source]#

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

Note

This function can be accessed by:

mdb.models[name].parts[name].Stringer
Parameters:
  • name (str) – A String specifying the repository key. The default value is an empty string.

  • edges (Tuple[Edge, ...], default: ()) – A sequence of Edge objects specifying the edges on which stringers should be created. Applicable to three and two-dimensional parts.

  • elementEdges (Tuple[MeshEdge, ...], default: ()) – A sequence of MeshEdge objects specifying the mesh edges on which stringers should be created. Applicable to three and two-dimensional parts.

Returns:

stringer – A Stringer object

Return type:

Stringer

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='', **kwargs)[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
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:

surf – A Surface object

Return type:

Surface

Unlock()[source]#

This method unlocks the part. Unlocking the part allows it to be regenerated after any modifications to the part.

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

This method creates an additional Feature object by creating a planar wire from the given ConstrainedSketch object. The ConstrainedSketch object must define a closed profile.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • sketchPlane (str) – A Datum plane object or a planar Face object specifying the plane on which to sketch.

  • sketchPlaneSide (Literal[SIDE1, SIDE2]) – A SymbolicConstant specifying the direction of feature creation. Possible values are SIDE1 and SIDE2.

  • sketchUpEdge (Edge) – An Edge object or a Datum axis object specifying the vertical (Y) direction of the sketch.

  • sketch (ConstrainedSketch) – A ConstrainedSketch object specifying the planar sketch to be revolved.

  • 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:

feature – A Feature object

Return type:

Feature

WireFromEdge(edgeList)[source]#

This method creates an additional Feature object by creating a Wire by selecting one or more Edge objects of a Solid or Shell part.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:

edgeList (str) – A list of Edge objects specifying the edges from which the wire is to be created.

Returns:

feature – A Feature object

Return type:

Feature

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

This method creates an additional Feature object by creating a polyline wire that passes through a sequence of given points. Each point can be a datum point, a vertex, an interesting point, or a tuple.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • points (tuple) – A sequence of ConstrainedSketchVertex, Datum point, or InterestingPoint objects specifying the points through which the polyline wire will pass. points can also be a sequence of tuples of Floats. You must specify at least two values in the sequence.

  • 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 in 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

WireSpline(points, mergeType=abaqusConstants.IMPRINT, smoothClosedSpline=OFF)[source]#

This method creates an additional Feature object by creating a spline wire that passes through a sequence of given points. Each point can be a datum point, a vertex, an interesting point, or a tuple.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • points (tuple) – A sequence of ConstrainedSketchVertex, Datum point, or InterestingPoint objects specifying the points through which the spline wire will pass. points can also be a sequence of tuples of Floats. You must specify at least two values in the sequence.

  • 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 spline 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.

  • smoothClosedSpline (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying the behavior of Abaqus when the points defining a spline wire form a closed loop (the start and end points are the same). If smoothClosedSpline = ON, Abaqus creates a smooth spline wire where the tangencies at the end point meet smoothly. If smoothClosedSpline = OFF, Abaqus does not automatically create a smooth end condition. The default value in OFF.

Returns:

feature – A Feature object

Return type:

Feature

addGeomToSketch(sketch)[source]#

This method converts a part into a sketch by projecting all of the edges of the part onto the X-Y plane of the sketch. You can use addGeomToSketch with a part of any modeling space.

Parameters:

sketch (ConstrainedSketch) – A ConstrainedSketch object.

adjustMidsideNode(cornerNodes, parameter)[source]#

This method is used to adjust the midside node of second-order elements of an orphan mesh part.

Parameters:
  • cornerNodes (Tuple[Node, ...]) – A sequence of Node objects specifying the nodes towards which connected midside nodes will be biased.

  • parameter (float) – A Float specifying the normalized distance along the edge of the midside nodes. Possible values are 0.0 ≤ parameter ≤ 1.0, where 0.0 specifies the position of the corner node. The default value is 0.5.

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 the contents of the allSets repository is the same as the contents of the sets repository.

allSurfaces: Dict[str, Surface] = {}[source]#

A repository of Surface objects specifying the contents of the allSurfaces repository is the same as the contents of the surfaces repository.

assignBeamSectionOrientation(region, method, n1)[source]#

This method assigns a beam section orientation to a region of a part.

Note

This function can be accessed by:

mdb.models[name].parts[name].assignBeamSectionOrientation
Parameters:
  • region (tuple) – A sequence of geomSequences of Edge objects or a sequence of sequences of one-dimensional elements.

  • method (SymbolicConstant) – A SymbolicConstant specifying the assignment method. Only a value of N1_COSINES is currently supported.

  • n1 (tuple) – A sequence of three Floats specifying the approximate local n1n1-direction of the beam cross-section.

assignMaterialOrientation(region, localCsys, axis=abaqusConstants.AXIS_1, angle=0)[source]#

This method assigns a material orientation to a region.

Note

This function can be accessed by:

mdb.models[name].parts[name].assignMaterialOrientation
Parameters:
  • region (tuple) – A sequence of geomSequences of ConstrainedSketchVertex, Edge, Face, and Cell objects or a sequence of sequences of elements.

  • localCsys (Datum) – A Datum object specifying the local coordinate system or None, indicating the global coordinate system.

  • axis (SymbolicConstant, default: AXIS_1) – A SymbolicConstant specifying the axis of a cylindrical or spherical datum coordinate system about which an additional rotation is applied. For shells this axis is also the shell normal. Possible values are AXIS_1, AXIS_2, and AXIS_3. The default value is AXIS_1.

  • angle (float, default: 0) – A Float specifying the angle of the additional rotation. The default value is 0.0.

assignRebarOrientation(region, localCsys, axis=abaqusConstants.AXIS_1, angle=0)[source]#

This method assigns a rebar reference orientation to a region.

Note

This function can be accessed by:

mdb.models[name].parts[name].assignRebarOrientation
Parameters:
  • region (tuple) – A sequence of geomSequences of ConstrainedSketchVertex, Edge, Face, and Cell objects or a sequence of sequences of elements.

  • localCsys (Datum) – A Datum object specifying the local coordinate system or None, indicating the global coordinate system.

  • axis (SymbolicConstant, default: AXIS_1) – A SymbolicConstant specifying the axis of a cylindrical or spherical datum coordinate system about which an additional rotation is applied. For shells this axis is also the shell normal. Possible values are AXIS_1, AXIS_2, and AXIS_3. The default value is AXIS_1.

  • angle (float, default: 0) – A Float specifying the angle of the additional rotation. The default value is 0.0.

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.

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.

assignThickness(faces, thickness=None, topFaces=(), bottomFaces=())[source]#

This method assigns thickness data to shell faces. The thickness can be used while assigning shell and membrane sections to faces.

Parameters:
  • faces (Tuple[Face, ...]) – A sequence of Face objects specifying the regions where thickness will be applied.

  • thickness (Optional[float], default: None) – A Float specifying the thickness along the given faces . Either thickness, topFaces, or bottomFaces must be specified.

  • topFaces (Tuple[Face, ...], default: ()) – A sequence of Face objects whose distance to faces argument is used to calculate the thickness along the faces. The combination of topFaces and bottomFaces determines the thickness and the offset of the elements. If bottomFaces is not specified then the thickness is twice the distance to the topFaces. This argument will be ignored if thickness is specified. Either thickness, topFaces, or bottomFaces must be specified.

  • bottomFaces (Tuple[Face, ...], default: ()) – A sequence of Face objects whose distance to faces is used to calculate the thickness along the faces. The combination of topFaces and bottomFaces determines the thickness and the offset of the elements. If topFaces is not specified then the thickness is twice the distance to the bottomFaces. This argument will be ignored if thickness is specified. Either thickness, topFaces, or bottomFaces must be specified.

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.

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 Mesh:py:class:~abaqus.BasicGeometry.Face.Face 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 0x7f350e3436d0>) – 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 part. Use the restore method to retrieve the part’s features from the backup.

cells: CellArray = [][source]#

A CellArray object specifying all the cells in the part.

checkGeometry(detailed=OFF, reportFacetErrors=OFF, level=None)[source]#

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

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.

  • reportFacetErrors (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether faces are checked for proper facetting. 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.

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.

Parameters:
  • arg1 (str) – A Set or Surface object specifying set 1.

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

cleanMesh(mergeTolerance, growEdges=OFF, elements='', refEdge='', thicknessDir=None, moveLayers=False)[source]#

This method is used to collapse short element edges and delete collapsed elements, or grow short element edges, on an orphan mesh part composed of linear elements.

Parameters:
  • mergeTolerance (float) – A Float specifying the edge length tolerance. During the operation, edges shorter than the given tolerance will be collapsed, or grown to the specified length.

  • growEdges (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether short element edges will be grown to the specified tolerance. Default is False, meaning short edges will be collapsed.

  • elements (str, default: '') – The elements to consider as the domain for the operation. By default all elements on the part are considered. The elements may be given as a MeshElementArray, a list of MeshElement objects, a Set, or a list of Set objects.

  • refEdge (str, default: '') – A MeshEdge specifying a reference edge to indicate a topological direction in a structured mesh that will limit which edges within the element domain are considered. That is, only edges that are found to be topologically parallel to the given reference edge will be considered by the operation. By default all edges of the element domain are considered, unless thicknessDir is specified, in which case the operation will attempt to determine the topological edges from the thickness direction.

  • thicknessDir (Optional[float], default: None) – A tuple of two or three Floats indicating a vector along which element edge lengths will be measured.

  • moveLayers (Union[AbaqusBoolean, bool], default: False) – A Boolean indicating whether element edges will be all grown in the direction of the thickness vector specified by thicknessDir. This argument is ignored unless growEdges is True and thicknessDir is provided. When this argument is True the growth of any given element edge will no longer be constrained by short edges on neighboring elements, but elements could move from their original positions in cases where there are multiple adjacent layers of thin elements. The default value is False.

clearGeometryCache()[source]#

This method clears the geometry cache. Clearing the geometry cache reduces the amount of memory being used to cache part features.

collapseMeshEdge(edge, collapseMethod)[source]#

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

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 an orphan mesh part or an Abaqus native mesh.

Parameters:

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

compositeLayups: Dict[str, CompositeLayup] = {}[source]#

A repository of CompositeLayup objects.

convertSolidMeshToShell()[source]#

This method removes all solid elements from an orphan mesh part and creates triangular or quadrilateral shell elements along their outer faces.

copyMeshPattern(elements, faces, elemFaces, targetFace, 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.

Parameters:
  • elements (Tuple[MeshElement, ...]) – A sequence of MeshElement objects or a Set object containing elements and specifying the source region.

  • faces (Tuple[Face, ...]) – A sequence of Face objects that have associated with shell elements or element faces and specifying the source region.

  • elemFaces (Tuple[MeshFace, ...]) – A sequence of MeshFace objects specifying the source region.

  • targetFace (MeshFace) – A MeshFace object specifying the target region.

  • nodes (Tuple[MeshNode, ...]) – 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) – 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.

Parameters:
  • regions (Tuple[Face, ...], default: ()) – A sequence of Face 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. If regions is not specified then the entire part is the domain for searching geometric entities that need to be merged.

  • 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 the 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 the datums in the part.

deleteAllFeatures()[source]#

This method deletes all the features in the part.

deleteBoundaryLayerControls(regions)[source]#

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

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 an orphan mesh part or an Abaqus native mesh. If the elements belong to an Abaqus native mesh then the elements must have been generated using the bottom-up meshing technique.

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 the given features.

Parameters:

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

deleteMesh(regions)[source]#

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

Parameters:

regions (Tuple[MeshPart]) – A sequence of Part objects or Region objects specifying the parts or regions from which the native mesh is to be deleted.

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

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

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.

deleteNode(nodes, deleteUnreferencedNodes=OFF)[source]#

This method deletes the given nodes from an orphan mesh part.

Parameters:
  • nodes (Tuple[MeshNode, ...]) – A sequence of MeshNode objects or a Set object containing nodes.

  • deleteUnreferencedNodes (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to delete all those associated nodes that become unreferenced after the given nodes and the connected elements are deleted. The default value is OFF.

deletePreviewMesh()[source]#

This method deletes all boundary meshes in the parts. 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 parts or deletes the local edge seeds from the given edges.

Parameters:

regions (Tuple[MeshPart]) – A sequence of Part objects or Edge objects specifying the parts or edges from which the seeds are to be deleted.

deleteSets(setNames)[source]#

This command deletes the given sets from the part.

Parameters:

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

deleteSurfaces(surfaceNames)[source]#

This command deletes the given surfaces from the part.

Parameters:

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

edges: EdgeArray = [][source]#

An EdgeArray object specifying all the edges in the part.

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 an orphan mesh part or on an Abaqus native mesh.

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:

elemEdges: Dict[str, MeshEdge] = {}[source]#

A repository of MeshEdge objects specifying all the element edges in the part. 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. 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 specifying all the unique element edges in the part.

elementFaces: MeshFaceArray = [][source]#

A MeshFaceArray object specifying all the unique element faces in the part.

elements: MeshElementArray = [][source]#

A MeshElementArray object specifying all the elements in the part.

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

An EngineeringFeature object.

faces: FaceArray = [][source]#

A FaceArray object specifying all the faces in the part.

features: Dict[str, PartFeature] = {}[source]#

A repository of Feature objects specifying all the features in the part.

featuresById: Dict[str, PartFeature] = {}[source]#

A repository of Feature objects specifying all Feature objects in the part. 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.

flipNormal(regions, referenceRegion='')[source]#

This method flips the normals of shell or membrane elements of an orphan mesh or of two-dimensional geometric regions.

Note

This function can be accessed by:

mdb.models[name].parts[name].flipNormal
Parameters:
  • regions (Region) – A Region object specifying the region on which normals are flipped. For 3D parts, the region contains Face objects or two-dimensional triangle or quadrilateral Element objects. For axisymmetric parts, the region contains Edge objects or line Elements objects.

  • referenceRegion (str, default: '') – A two-dimensional element object whose normal is to be matched. If unspecified, all the normals associated with the given regions will be flipped. The referenceRegion argument is applicable only if the argument regions contain a sequence of quadrilateral or triangular elements.

flipTangent(regions)[source]#

This method flips the tangents of beam or truss elements of an orphan mesh or of one-dimensional geometric regions.

Note

This function can be accessed by:

mdb.models[name].parts[name].flipTangent
Parameters:

regions (Region) – A Region object specifying the region on which normals are flipped. The region contains Edge objects or one-dimensional Element objects.

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.

Parameters:
  • cell (Cell) – A Cell object specifying the geometric region where the mesh is to be generated. This argument is valid only for native parts.

  • 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 Mesh:py:class:~abaqus.BasicGeometry.Face.Face 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 Mesh:py:class:~abaqus.BasicGeometry.Face.Face 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 parts. 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.

Parameters:
  • cell (Cell) – A Cell object specifying the geometric region where the mesh is to be generated. This argument is valid only for native parts.

  • 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 Mesh:py:class:~abaqus.BasicGeometry.Face.Face 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 parts. 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.

Parameters:
  • cell (Cell) – A Cell object specifying the geometric region where the mesh is to be generated. This argument is valid only for native parts.

  • 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 Mesh:py:class:~abaqus.BasicGeometry.Face.Face 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 connecting sides of the sweep meshing operation.

  • elemFacesConnectingSides (Tuple[MeshFace, ...], default: ()) – A sequence of Mesh:py:class:~abaqus.BasicGeometry.Face.Face 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 parts. The default value is False.

generateMesh(elemShape=None)[source]#

This method generates a new mesh on an orphan mesh part based on the original mesh.

Parameters:

elemShape (Optional[SymbolicConstant], default: None) – A SymbolicConstant specifying the element shape to be used for meshing. Possible values are:TRIRefine a planar triangular mesh and replace it with a new one. If no element sizes are attached, the new mesh will be governed by the sizes of the boundary edges in the old mesh. TETCreate a tetrahedral mesh from a closed shell of triangular elements.

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.

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.

geometryValidity: Boolean = OFF[source]#

A Boolean specifying the validity of the geometry of the part. The value is computed, but it can be set to ON to perform feature and mesh operations on an invalid part. There is no guarantee that such operations will work if the part was originally invalid.

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

This method returns the angle between the specified entities.

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:

angle – 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

getArea(faces, relativeAccuracy=0)[source]#

This method returns the total surface area of a given face or group of faces.

Parameters:
  • faces (Tuple[Face, ...]) – A sequence of Face objects whose area the method will calculate.

  • relativeAccuracy (float, default: 0) – A Float specifying that the area computation should stop when the specified relative accuracy has been achieved. The default value is 0.000001 (0.0001%).

Returns:

area – A Float specifying the sum of the calculated areas of the given faces.

Return type:

float

getAssociatedCADPaths()[source]#

This method returns the paths to the associated CAD part and root file. These are only available if the part was imported from one of the supported CAD softwares using the Associative Import capability. The root file can be the assembly file or the part file, depending on what which one was imported.

Returns:

paths – A sequence containing the path to the associated CAD part and assembly file

Return type:

tuple

getCADParameters()[source]#

This method returns the names and values of the CAD parameters associated with the part. These are only available if the part was imported from one of the supported CAD softwares using the Associative Import capability, and if the parameter names defined in that CAD software are prefixed with the string ABQ.

Returns:

paras – A dictionary object representing a map of the name of the parameter and its associated value.

Return type:

dict

getCentroid(faces, cells, relativeAccuracy=0)[source]#

Location of the centroid of a given face/cell or group of faces/cells

Parameters:
  • faces (Tuple[Face, ...]) – A sequence of Face objects whose centroid the method will calculate. The arguments faces and cells are mutually exclusive.

  • cells (Tuple[Face, ...]) – A sequence of Face objects whose centroid the method will calculate. The arguments faces and cells are mutually exclusive.

  • relativeAccuracy (float, default: 0) – A Float specifying that the centroid computation should stop when the specified relative accuracy has been achieved. The default value is 0.000001 (0.0001%).

Returns:

centroid – A sequence of Floats specifying the X-, Y-, and Z-coordinates of the centroid. Depending on the arguments provided, this method returns the following:

  • The location of the centroid of a given face or group of faces.

  • The location of the centroid of a given cell or group of cells.

Return type:

Tuple[float, ]

getCoordinates(entity, csys)[source]#

This method returns the coordinates of specified point.

Parameters:
  • entity (str) – A ConstrainedSketchVertex, Datum point, MeshNode, or ReferencePoint specifying the entity to query.

  • csys (DatumCsys) –

    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.

Return type:

A tuple of 3 Floats representing the coordinates of the specified point.

getCurvature(edges, samplePoints=100)[source]#

This method returns the maximum curvature of a given edge or group of edges. For an arc, the curvature is constant over the entire edge, and equal to the inverse of the radius. For a straight line, the curvature is constant and equal to 0. For a spline edge, the curvature varies over a range, and this methods computes the maximum.

Parameters:
  • edges (Tuple[Edge, ...]) – A sequence of Edge objects whose curvature the method will calculate.

  • samplePoints (int, default: 100) – An Int specifying the number of points along each edge at which the curvature will be computed. The higher the number of sample points, the better the accuracy of the computation. The default value is 100.

Returns:

curvature – A Float specifying the maximum curvature.

Return type:

float

getDistance(entity1, entity2)[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.

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.

Returns:

distance – A Float specifying the distance between entity1 and entity2.

Return type:

float

getEdgeSeeds(edge, attribute)[source]#

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

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 a part.

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:

    • LINE

    • QUAD

    • TRI

    • HEX

    • WEDGE

    • TET

Returns:

An ElemType object.

Return type:

ElementType

Raises:

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

getFeatureCells(name)[source]#

This method returns a sequence of Cell objects that are created by the given feature.

Parameters:

name (str) – A string specifying the feature name.

Returns:

cells – Sequence of Cell objects.

Return type:

Tuple[Cell, ]

:raises Error : Incorrect feature name: An exception occurs if a feature with the given name does not exist.

getFeatureEdges(name)[source]#

This method returns a sequence of Edge objects that are created by the given feature.

Parameters:

name (str) – A string specifying the feature name.

Returns:

edges – Sequence of Edge objects.

Return type:

Tuple[Edge, ]

Raises:

Error – An exception occurs if a feature with the given name does not exist.

getFeatureFaces(name)[source]#

This method returns a sequence of Face objects that are created by the given feature.

Parameters:

name (str) – A string specifying the feature name.

Returns:

faces – Sequence of Face objects.

Return type:

Tuple[Face, ]

:raises Error : Incorrect feature name: An exception occurs if a feature with the given name does not exist.

getFeatureVertices(name)[source]#

This method returns a sequence of ConstrainedSketchVertex objects that are created by the given feature.

Parameters:

name (str) – A string specifying the feature name.

Returns:

vertices – Sequence of ConstrainedSketchVertex objects.

Return type:

Tuple[ConstrainedSketchVertex, ]

Raises:

Error – An exception occurs if a feature with the given name does not exist.

getIncompatibleMeshInterfaces(cells=())[source]#

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

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

getLength(edges)[source]#

This method returns the length of a given edge or group of edges.

Parameters:

edges (Tuple[Edge, ...]) – A sequence of Edge objects whose total length the method will calculate.

Returns:

length – A Float specifying the total length

Return type:

float

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

This method returns the mass properties of a part or region. Only beams, trusses, shells, solids, point, nonstructural mass, and rotary inertia elements are supported.

Parameters:
  • regions (str, default: '') – A MeshElementArray, CellArray, FaceArray, or EdgeArray specifying the regions whose mass properties are to be queried. The whole part 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 region. 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. UNSUPPORTED_NON_STRUCTURAL_MASS_PROPORTIONAL: Non-structural mass with Mass Proportional distribution is not supported. Results are computed using Volume Proportional distribution.

Return type:

dict

getMeshControl(region, attribute)[source]#

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

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

Parameters:

regions (tuple) – A sequence or tuple of ConstrainedSketchGeometry regions for which mesh statistics should be returned.

Returns:

A MeshStats object.

Return type:

MeshStats

getPartSeeds(attribute)[source]#

This method returns a part seed parameter for the part.

Parameters:

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 depends 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 that depends on the value of the attribute argument.

Return type:

float

Raises:

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

getPerimeter(faces)[source]#

This method returns the total perimeter of a given face or group of faces. All faces need to be on the same part. If the specified faces have shared edges, these edges are excluded from the computation, thus providing the length of the outer perimeter of the specified faces.

Parameters:

faces (Tuple[Face, ...]) – A sequence of Face objects whose perimeter the method will calculate.

Returns:

perimeter – A Float specifying the perimeter

Return type:

float

getUnmeshedRegions()[source]#

This method returns all geometric regions in the part 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

getVolume(cells, relativeAccuracy=0)[source]#

This method returns the volume area of a given cell or group of cells.

Parameters:
  • cells (Tuple[Cell, ...]) – A sequence of Cell objects whose volume the method will calculate.

  • relativeAccuracy (float, default: 0) – A Float specifying the relative accuracy of the computation. The default value is 0.000001 (0.0001%).

Returns:

volume – A Float specifying the sum of the areas of the given faces

Return type:

float

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.

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

ignoredEdges: IgnoredEdgeArray = [][source]#

An IgnoredEdgeArray object specifying all the ignored edges in the part.

ignoredVertices: IgnoredVertexArray = [][source]#

An IgnoredVertexArray object specifying all the ignored vertices in the part.

isAlignedWithSketch()[source]#

This method checks if the normal of an analytical rigid surface part is aligned with that of its sketch.

Returns:

A Boolean value of True if the part is aligned with the sketch and False if it is not aligned.

Return type:

Boolean

Raises:

AbaqusException – If the part is not an analytical rigid part.

isOutOfDate: Optional[int] = None[source]#

An Int specifying that feature parameters have been modified but that the part has not been regenerated. Possible values are 0 and 1.

isSetInternal(setName)[source]#

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

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.

Parameters:

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

markSetInternal(setName, internalSet)[source]#

This command marks the given Set as internal or external.

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.

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

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

materialOrientations: MaterialOrientationArray = [][source]#

A MaterialOrientationArray object.

mergeElement(edge, elements)[source]#

Merge a selection of elements arranged in layers on an orphan mesh part into a single layer.

Parameters:
  • edge (str) – A MeshEdge of one of the specified elements that serves as a reference edge to indicate the topological direction for merging elements. All specified elements must be reachable by topological navigation from this element edge, and the topological direction must be unambiguous.

  • elements (str) – A MeshElementArray, a list of MeshElement objects, a Set, or a list of Set objects containing the elements to be included in the merge operation.

mergeNodes(*args, **kwargs)[source]#
name: str = ''[source]#

A String specifying the repository key.

nodes: MeshNodeArray = [][source]#

A MeshNodeArray object specifying all the nodes in the part.

orientElements(pickedElements, referenceRegion)[source]#

This method orients the stack direction of elements in a continuum shell or gasket mesh.

Parameters:
  • pickedElements (Tuple[MeshElement, ...]) – A sequence of MeshElement objects specifying the elements to orient.

  • referenceRegion (MeshFace) – A MeshFace object specifying a reference top face that indicates the desired orientation.

printAssignedSections()[source]#

This method prints information on each section that has been assigned to a region of the part.

projectEdgesOntoSketch(sketch, edges, constrainToBackground=True)[source]#

This method projects the selected edges of a part onto the specified ConstrainedSketch object. The edges appear as sketch geometry after projection. If the plane of projection is not parallel to the specified edge, the resultant sketch geometry may be of a different type. For example, a circular edge can be projected as an ellipse or a line depending on the angle of the plane of projection. By default, the projected edge will be constrained to the background geometry. You can remove this constraint by setting constrainToBackground to False.

Parameters:
  • sketch (str) – The ConstrainedSketch object on which the edges are projected.

  • edges (tuple) – A sequence of candidate edges to be projected onto the sketch.

  • constrainToBackground (Union[AbaqusBoolean, bool], default: True) – A Boolean that determines whether the projected edges need to constrained to the background geometry. The default is True.

projectNode(nodes, projectionReference)[source]#

This method projects the given nodes onto a mesh entity, geometric entity, or a datum object. The nodes may belong to an orphan mesh part or to an Abaqus native mesh.

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 vertices of specified edges, and datum points from the part onto the specified ConstrainedSketch object. The vertices and datum points appear on the sketch as reference geometry.

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[PartFeature], 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, part entities in features created before the sketch you are editing are candidates for projection.

  • edges (tuple, default: ()) – A sequence of candidate edges whose vertices need to be projected onto the sketch. By default, all edges specified by the filter argument 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.

queryAttributes(printResults=OFF)[source]#
This method prints the following information about a part:
  • the name, modeling space, and analysis type; and

  • whether twist is included (only available when the modeling space is axisymmetric and

the analysis type is deformable); and
  • the number of vertices, edges, faces and cells if applicable.

Parameters:

printResults (Union[AbaqusBoolean, bool], default: OFF) – A Boolean which specifies whether the above information is to be printed. The default value is True

Returns:

attributes – A Dictionary object with string keys and integer values which returns the above information with the keys being numVertices, numEdges, numFaces, numCells, numWiredEdges, numShellFaces and numSolidFaces.

Return type:

dict

queryCachedStates()[source]#

This method displays the position of geometric states relative to the sequence of features in the part cache. The output is displayed in the message area.

queryDisjointPlyRegions()[source]#

This method provides a list of all composite plys in the current part which have disjoint regions.

queryGeometry(relativeAccuracy=0, printResults=True)[source]#
This method prints the following information about a part:
  • the name, modeling space, and analysis type;

  • whether twist is included (only available when the modeling space is axisymmetric and

the analysis type is deformable);
  • a 3D point representing the minimum of the part’s bounding box;

  • a 3D point representing the maximum of the part’s bounding box;

  • a 3D point representing the part’s centroid (only on 3D solid parts); and

  • the volume (only on 3D solid parts).

Parameters:
  • relativeAccuracy (float, default: 0) – A Float specifying that the property computations should stop when the specified relative accuracy has been achieved. The default value is 0.000001 (0.0001%).

  • printResults (Union[AbaqusBoolean, bool], default: True) – A Boolean which specifies whether the above information is to be printed. The default value is True.

Returns:

geometry – A Dictionary object with string keys, which returns the above information with the keys being name, space, type, volume, centroid, category and boundingBox.

Return type:

dict

queryRegionsMissingSections()[source]#

This method returns all regions in the part that do not have a section assignment but require one for analysis.

Returns:

region – A Region object, or None

Return type:

Region

redoMeshEdit()[source]#

This method executes the edit mesh or the bottom-up meshing operation most recently undone by the undoMeshEdit method on an part. A redo action must be currently available for the part. This implies that the user must have executed the undoMeshEdit method on the part 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: ReferencePoints = {}[source]#

A repository of ReferencePoint objects.

regenerate()[source]#

This method regenerates a part. When you modify features, it may be convenient to postpone regeneration until you make all your changes, since regeneration can be time consuming.

regenerationWarnings()[source]#

This method prints any regeneration warnings associated with the features.

removeElementSize()[source]#

This method removes the global element size from an orphan mesh part.

removeInvalidGeometry()[source]#

Removes all invalid entities from the part, leaving a valid part. This is not recorded as a feature in the feature list, therefore it should be used on parts that have a single feature (such as an imported part). Note:This may remove valid entities that are connected to invalid ones. You can identify invalid entities using the query toolset before using this command.

renumberElement(elements=(), startLabel=None, increment=None, offset=None, labels='')[source]#

This method assigns new labels to orphan mesh elements.

Parameters:
  • elements (tuple, default: ()) – A MeshElementArray or a tuple or list of MeshElement objects, or a Set containing elements to be renumbered. If unspecified, all elements in the part will be renumbered.

  • startLabel (Optional[int], default: None) – A positive Int specifying the new label for the first element in elements.

  • increment (Optional[int], default: None) – A positive Int specifying the increment used for computation of new labels for all consecutive elements in elements.

  • offset (Optional[int], default: None) – An Int by which existing labels of the specified elements will be offset.

  • labels (str, default: '') – A list of labels for the specified elements. The length of this list must match the number of specified elements.

Raises:
  • Error – Renumbering is attempted on a native part

  • Error – Renumbering data is specified incorrectly

  • Error – Renumbering will result in invalid labels

  • Error – Renumbering will result in conflicting labels

renumberNode(nodes=(), startLabel=None, increment=None, offset=None, labels='')[source]#

This method assigns new labels to orphan mesh nodes.

Parameters:
  • nodes (tuple, default: ()) – A MeshNodeArray or a tuple or list of MeshNode objects, or a Set containing nodes to be renumbered. If unspecified, all nodes in the part will be renumbered.

  • startLabel (Optional[int], default: None) – A positive Int specifying the new label for the first node in nodes.

  • increment (Optional[int], default: None) – A positive Int specifying the increment used for computation of new labels for all consecutive nodes in nodes.

  • offset (Optional[int], default: None) – An Int by which existing labels of the specified nodes will be offset.

  • labels (str, default: '') – A list of labels for the specified nodes. The length of this list must match the number of specified nodes.

Raises:
  • Error – Renumbering is attempted on a native part.

  • Error – Renumbering data is specified incorrectly.

  • Error – Renumbering will result in invalid labels.

  • Error – Renumbering will result in conflicting labels.

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.

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.

resumeFeatures(featureNames)[source]#

This method resumes the specified suppressed features in the part.

Parameters:

featureNames (tuple) – A tuple of names of features which are to be resumed.

resumeLastSetFeatures()[source]#

This method resumes the last set of features to be suppressed in the part.

retainedNodes: MeshNodeArray = [][source]#

A MeshNodeArray object specifying all the retained nodes in the substructure part.

saveGeometryCache()[source]#

This method caches the current geometry. Caching the current geometry 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.

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.

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.

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

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

This method assigns global edge seeds to the given parts.

Parameters:
  • 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.

setAssociatedCADPaths(partFile='', rootFile='')[source]#

This method sets the paths to the associated CAD part and root file. This method is only available if the part was imported from one of the supported CAD softwares using the Associative Import capability. The root file can be the assembly file or the part file, depending on the one that was imported. This method can be used to specify the new paths when the CAD data is moved to a different directory.

Parameters:
  • partFile (str, default: '') – A String specifying the name of the associated CAD part file.

  • rootFile (str, default: '') – A String specifying the name of the root associated CAD file. This can be the same as the part file or can be the assembly file, depending on the one that was imported.

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

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

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.

setElementSize(size)[source]#

This method sets the global element size for an orphan mesh part.

Parameters:

size (float) – A Float specifying the desired element size.

setElementType(regions, elemTypes)[source]#

This method assigns element types to the specified regions.

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.

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.

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

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

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

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

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(*args, **kwargs)[source]#

This method modifies the Part object.

Raises:

RangeError

sets: Dict[str, Set] = {}[source]#

A repository of Set objects specifying for more information, see Set.

skins: Dict[str, Skin] = {}[source]#

A repository of Skin objects specifying the skins created on the part.

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

Parameters:

nodes (Tuple[MeshNode, ...]) – A sequence of MeshNode objects or a Set object containing nodes.

splitElement(elements)[source]#

This method splits quadrilateral elements of an orphan mesh part or a Abaqus native mesh 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 an orphan mesh part or an Abaqus native mesh.

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

  • parameter (float, default: 0) – A Float specifying the normalized distance along 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 part.

subdivideElement(elements='', divisionNumber=2, face=None, edge=None)[source]#

Subdivide a selection of elements on an orphan mesh part in one or more directions.

Parameters:
  • elements (str, default: '') – A MeshElementArray, a list of MeshElement objects, a Set, or a list of Set objects containing the elements to be subdivided. By default all the elements of the part are subdivided.

  • divisionNumber (int, default: 2) – An Int specifying the number of resulting elements for each input element in each direction of the subdivision. If face or edge are not specified, elements will be subdivided according to this number in all possible directions. Must be greater than one. Default is 2.

  • face (Optional[MeshFace], default: None) – A MeshFace object that serves as a reference for indicating two topological directions for the subdivision operation. Must be a face of one of the specified elements, and all specified elements must be reachable by topological navigation from this element face. May not be combined with edge.

  • edge (Optional[MeshEdge], default: None) – A MeshEdge object that serves as a reference for indicating a single topological direction for the subdivision operation. Must be an edge of one of the specified elements, and all specified elements must be reachable by topological navigation from this element edge. May not be combined with face.

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 the given features.

Parameters:

featureNames (tuple) – A tuple of names of features which are to be suppressed in the part.

surfaces: Dict[str, Surface] = {}[source]#

A repository of Surface objects specifying for more information, see Surface.

swapMeshEdge(edge)[source]#

This method swaps the diagonal of two adjacent triangular elements of an orphan mesh part or an Abaqus native mesh.

Parameters:

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

timeStamp: Optional[float] = None[source]#

A Float specifying when the part was last modified.

unassignBeamSectionOrientation(index)[source]#

This method deletes a beam section orientation assignment.

Note

This function can be accessed by:

mdb.models[name].parts[name].unassignBeamSectionOrientation
Parameters:

index (int) – An Int specifying the number of the beam section orientation assignment to be deleted.

unassignMaterialOrientation(index)[source]#

This method deletes a material orientation assignment.

Note

This function can be accessed by:

mdb.models[name].parts[name].unassignMaterialOrientation
Parameters:

index (int) – An Int specifying the number of the material assignment to be deleted.

unassignRebarOrientation(index)[source]#

This method deletes a rebar orientation assignment.

Note

This function can be accessed by:

mdb.models[name].parts[name].unassignRebarOrientation
Parameters:

index (int) – An Int specifying the number of the rebar reference orientation assignment to be deleted.

undoMeshEdit()[source]#

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

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

This method tests the mesh quality of a part and returns poor-quality elements.

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, the entire part mesh is 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 in the part.

wrapMesh(radius)[source]#

This method wraps a planar orphan mesh part about the Z-axis.

Parameters:

radius (float) – A Float specifying the radius of the cylinder about which the part is to be wrapped. The wrapping procedure will relocate a node at point (xx, yy) on the planar mesh to (x,θ,zx,θ,z), where rr is the specified radius, θθ = xrxr, and zz=yy.

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

This method exports the geometry of the part to a named file in ACIS format.

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.

    Changed in version 2018: Add description for thr file name’s extension.

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

:raises Cannot export orphan mesh parts` to :class:`ACIS: If the part is an orphan mesh part.

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

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

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.

writeIgesFile(fileName, flavor)[source]#

This method exports the geometry of the part to a named file in IGES format.

Parameters:
  • fileName (str) – A String specifying the name of the file to which to write.

  • flavor (SymbolicConstant) – A SymbolicConstant specifying a particular flavor of IGES. Possible values are STANDARD, AUTOCAD, SOLIDWORKS, JAMA, and MSBO.

:raises Cannot export orphan mesh parts` to :class:`IGES: If the part is an orphan mesh part.

writeStepFile(fileName)[source]#

This method exports the geometry of the part to a named file in STEP format.

Parameters:

fileName (str) – A String specifying the name of the file to which to write.

Raises:

Parterror – If the part contains no geometry.

writeVdaFile(fileName)[source]#

This method exports the geometry of the part to a named file in VDA-FS format.

Parameters:

fileName (str) – A String specifying the name of the file to which to write.

:raises Cannot export orphan mesh parts` to :class:`VDA-FS: If the part is an orphan mesh part.

PartFeature#

class PartFeature[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 part

Public Data Attributes:

Inherited from Feature

name

A String specifying the repository key.

id

An Int specifying the ID of the feature.

Public Methods:

AutoRepair()

This method carries out a sequence of geometry repair operations if it contains invalid entities.

AddCells(faceList[, flipped])

This method tries to convert a shell entity to a solid entity.

AnalyticRigidSurf2DPlanar(sketch)

This method creates a first Feature object for an analytical rigid surface by creating a planar wire from the given ConstrainedSketch object.

AnalyticRigidSurfExtrude(sketch[, depth])

This method creates a first Feature object for an analytical rigid surface by extruding the given ConstrainedSketch object by the given depth, creating a surface.

AnalyticRigidSurfRevolve(sketch)

This method creates a first Feature object for an analytical rigid surface by revolving the given ConstrainedSketch object by 360° about the Y-axis.

AssignMidsurfaceRegion(cellList)

This method assign a mid-surface property to sequence of Cell objects.

BaseSolidExtrude(sketch, depth[, ...])

This method creates a first Feature object by extruding the given ConstrainedSketch object by the given depth, creating a solid.

BaseSolidRevolve(sketch, angle[, pitch, ...])

This method creates a first Feature object by revolving the given ConstrainedSketch object by the given angle, creating a solid.

BaseSolidSweep(sketch, path)

This method creates a first Feature object by sweeping the given profile ConstrainedSketch object along the path defined by the path ConstrainedSketch object, creating a solid.

BaseShell(sketch)

This method creates a first Feature object by creating a planar shell from the given ConstrainedSketch object.

BaseShellExtrude(sketch, depth[, ...])

This method creates a first Feature object by extruding the given ConstrainedSketch object by the given depth, creating a shell.

BaseShellRevolve(sketch, angle[, pitch, ...])

This method creates a first Feature object by revolving the given ConstrainedSketch object by the given angle, creating a shell.

BaseShellSweep(sketch, path)

This method creates a first Feature object by sweeping the given section ConstrainedSketch object along the path defined by the path ConstrainedSketch object, creating a shell.

BaseWire(sketch)

This method creates a first Feature object by creating a planar wire from the given ConstrainedSketch object.

BlendFaces(side1, side2[, method, path])

This method creates a Feature object by creating new faces that blends two sets of faces.

Chamfer(length, edgeList)

This method creates an additional Feature object by chamfering the given list of edges with a given length.

Mirror(mirrorPlane, keepOriginal[, ...])

This method mirrors existing part geometry across a plane to create new geometry.

ConvertToAnalytical()

This method attempts to change entities into a simpler form that will speed up processing and make entities available during feature operations.

ConvertToPrecise([method])

This method attempts to change imprecise entities so that the geometry becomes precise.

CoverEdges(edgeList[, tryAnalytical])

This method generates a face using the given edges as the face's boundaries.

Cut(sketchPlane, sketchPlaneSide, ...[, ...])

This method creates an additional Feature object by cutting a hole using the given ConstrainedSketch object.

CutExtrude(sketchPlane, sketchPlaneSide, ...)

This method creates an additional Feature object by extruding the given ConstrainedSketch object by the given depth and cutting away material in the solid and shell regions of the part.

CutLoft(loftsections[, startCondition, ...])

This method creates an additional Feature object by lofting between the given sections and cutting away material from the part.

CutRevolve(sketchPlane, sketchPlaneSide, ...)

This method creates an additional Feature object by revolving the given ConstrainedSketch object by the given angle and cutting away material from the part.

CutSweep(path, profile[, pathPlane, ...])

This method creates an additional Feature object by sweeping the given ConstrainedSketch object along a path which may be a ConstrainedSketch or a sequence of Edge objects and cutting away material from the part.

ExtendFaces([faces, extendAlong, distance, ...])

This method extends faces along its free edges by offsetting the external edges along the surfaces.

FaceFromElementFaces(elementFaces[, stitch, ...])

This method creates a geometry face from a collection of orphan element faces.

HoleBlindFromEdges(plane, planeSide, ...)

This method creates an additional Feature object by creating a circular blind hole of the given diameter and depth and cutting away material in the solid and shell regions of the part.

HoleFromEdges(diameter, edge1, distance1, ...)

This method creates an additional Feature object by creating a circular hole of the given diameter in a 2D planar part and cutting away material in the shell and wire regions of the part.

HoleThruAllFromEdges(plane, planeSide, ...)

This method creates an additional Feature object by creating a circular through hole of the given diameter and cutting away material in the solid and shell regions of the part.

MergeEdges([edgeList, extendSelection])

This method merges edges either by extending the user selection or using only the selected edges.

OffsetFaces(faceList[, distance, ...])

This method creates new faces by offsetting existing faces.

RemoveCells(cellList)

This method converts a solid entity to a shell entity.

RemoveFaces(faceList[, deleteCells])

This method removes faces from a solid entity or from a shell entity.

RemoveFacesAndStitch(faceList)

This method removes faces from a solid entity and attempts to close the resulting gap by extending the neighboring faces of the solid.

RemoveRedundantEntities([vertexList, ...])

This method removes redundant edges and vertices from a solid or a shell entity.

RepairFaceNormals([faceList])

This method works on the entire part or a sequence of shell faces.

RepairInvalidEdges(edgeList)

This method repairs invalid edges.

RepairSliver(face, point1, point2[, ...])

This method repairs the selected sliver from the selected face.

RepairSmallEdges(edgeList[, toleranceChecks])

This method repairs small edges.

RepairSmallFaces(faceList[, toleranceChecks])

This method repairs small faces.

ReplaceFaces(faceList[, stitch])

This method replaces the selected faces with a single face.

Round(radius, edgeList, vertexList)

This method creates an additional Feature object by rounding (filleting) the given list of entities with the given radius.

Shell(sketchPlane, sketchPlaneSide, ...[, ...])

This method creates an additional Feature object by creating a planar shell from the given ConstrainedSketch object.

ShellExtrude(sketchPlane, sketchPlaneSide, ...)

This method creates an additional Feature object by extruding the given ConstrainedSketch object by the given depth, creating a shell protrusion.

ShellLoft(loftsections[, startCondition, ...])

This method creates an additional Feature object by lofting between the given sections and adding shell faces to the part.

ShellRevolve(sketchPlane, sketchPlaneSide, ...)

This method creates an additional Feature object by revolving the given ConstrainedSketch object by the given angle, creating a shell protrusion.

ShellSweep(path, profile[, pathPlane, ...])

This method creates an additional Feature object by sweeping the given ConstrainedSketch object or a sequence of Edge objects along a path which may be a ConstrainedSketch or a sequence of Edge objects, creating a shell swept protrusion.

SolidExtrude(sketchPlane, sketchPlaneSide, ...)

This method creates an additional Feature object by extruding the given ConstrainedSketch object by the given depth, creating a solid protrusion.

SolidLoft(loftsections[, startCondition, ...])

This method creates an additional Feature object by lofting between the given sections and adding material to the part.

SolidRevolve(sketchPlane, sketchPlaneSide, ...)

This method creates an additional Feature object by revolving the given ConstrainedSketch object by the given angle, creating a solid protrusion.

SolidSweep(path, profile[, pathPlane, ...])

This method creates an additional Feature object by sweeping the given ConstrainedSketch object or a Face object along a path which may be a ConstrainedSketch or a sequence of Edge objects, creating a solid swept protrusion.

Stitch([edgeList, stitchTolerance])

This method attempts to create a valid part by binding together free and imprecise edges of all the faces of a part.

Wire(sketchPlane, sketchPlaneSide, ...[, ...])

This method creates an additional Feature object by creating a planar wire from the given ConstrainedSketch object.

WireSpline(points[, mergeType, ...])

This method creates an additional Feature object by creating a spline wire that passes through a sequence of given points.

WirePolyLine(points[, mergeType, meshable])

This method creates an additional Feature object by creating a polyline wire that passes through a sequence of given points.

WireFromEdge(edgeList)

This method creates an additional Feature object by creating a Wire by selecting one or more Edge objects of a Solid or Shell part.

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 polyline wire that passes through a sequence of given points.

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.


AddCells(faceList, flipped=OFF)[source]#

This method tries to convert a shell entity to a solid entity. The conversion is not always successful.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • faceList (Tuple[Face, ...]) – A sequence of Face objects specifying the faces bounding the cell to add.

  • flipped (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying the direction of feature creation. The possible values are True and False. The default is True indicating that the direction is opposite to the face normal. When multiple faces are selected, Abaqus attempts to create cells on both sides of the selected faces and ignores the flipped argument.

Returns:

feature – A Feature object

Return type:

Feature

AnalyticRigidSurf2DPlanar(sketch)[source]#

This method creates a first Feature object for an analytical rigid surface by creating a planar wire from the given ConstrainedSketch object.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:

sketch (ConstrainedSketch) – A ConstrainedSketch object specifying the planar wire.

Returns:

feature – A Feature object

Return type:

Feature

AnalyticRigidSurfExtrude(sketch, depth=1)[source]#

This method creates a first Feature object for an analytical rigid surface by extruding the given ConstrainedSketch object by the given depth, creating a surface.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
Returns:

feature – A Feature object

Return type:

Feature

AnalyticRigidSurfRevolve(sketch)[source]#

This method creates a first Feature object for an analytical rigid surface by revolving the given ConstrainedSketch object by 360° about the Y-axis.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:

sketch (ConstrainedSketch) – A ConstrainedSketch object specifying the surface to be revolved.

Returns:

feature – A Feature object

Return type:

Feature

AssignMidsurfaceRegion(cellList)[source]#

This method assign a mid-surface property to sequence of Cell objects. If a reference representation of the part does not exist, it creates one. It also copies the cells to the reference representation and deletes the cells from the active representation of the part.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:

cellList (Tuple[Cell, ...]) – A sequence of Cell objects specifying the regions that will be used for mid-surface construction. These regions will be copied to the reference representation of the part.

Returns:

feature – A Feature object

Return type:

Feature

AutoRepair()[source]#

This method carries out a sequence of geometry repair operations if it contains invalid entities. It is expected to improve the geometry, but it does not guarantee that the number of invalid entities will decrease. In some cases, it can also increase the number of invalid entities. Since a number of geometry repair operations and validity checks are performed, it could be a slow operation depending on the complexity of the geometry.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Returns:

feature – A Feature object

Return type:

Feature

BaseShell(sketch)[source]#

This method creates a first Feature object by creating a planar shell from the given ConstrainedSketch object. The ConstrainedSketch object must define a closed profile.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:

sketch (ConstrainedSketch) – A ConstrainedSketch object specifying the planar shell.

Returns:

feature – A Feature object

Return type:

Feature

BaseShellExtrude(sketch, depth, draftAngle=None, pitch=None)[source]#

This method creates a first Feature object by extruding the given ConstrainedSketch object by the given depth, creating a shell. The ConstrainedSketch object can define either an open or closed profile.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • sketch (ConstrainedSketch) – A ConstrainedSketch object specifying the shape to be extruded.

  • depth (float) – A Float specifying the extrusion depth. Possible values are Floats > 0.

  • draftAngle (Optional[float], default: None) – A Float specifying the draft angle in degrees. Possible values are -90.0 ≤ draftAngle ≤ 90.0. By convention, for a positive draft angle an outer loop will draft outward and an inner loop will draft inward. The opposite is true for a negative draft angle. The default value, 0, implies a normal extrude. The arguments draftAngle and pitch are mutually exclusive.

  • pitch (Optional[float], default: None) – A Float specifying the pitch. The pitch is the distance traveled along the axial direction by the sketch when the sketch has completed one full revolution about the twist axis. Pitch can be specified as positive or negative to achieve right-handed or left-handed twist about the twist axis, respectively. The default value, 0, implies a normal extrude. Possible values are -105 ≤ pitch ≤ 105. The arguments draftAngle and pitch are mutually exclusive.

Returns:

A Feature object.

Return type:

Feature

Raises:

RangeError

BaseShellRevolve(sketch, angle, pitch=None, flipRevolveDirection=OFF, flipPitchDirection=OFF, moveSketchNormalToPath=OFF)[source]#

This method creates a first Feature object by revolving the given ConstrainedSketch object by the given angle, creating a shell. The ConstrainedSketch object can define either an open or closed profile and an axis of revolution. The axis is defined by a single construction line.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • sketch (ConstrainedSketch) – A ConstrainedSketch object specifying the shape to be revolved.

  • angle (float) – A Float specifying the revolve angle in degrees. Possible values are 0 ≤ angle ≤ 360.Note:If pitch >> 0, there is no upper limit for angle.

  • pitch (Optional[float], default: None) – A Float specifying the pitch. The pitch is the distance traveled along the axial direction, measured between corresponding points on the sketch when it has completed one full revolution about the axis of revolution. Possible values are 0 ≤ pitch ≤ 105. The default value, 0, implies a normal revolve.

  • flipRevolveDirection (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to override the direction of feature creation. If flipRevolveDirection = OFF, the default direction of revolution is used. If flipRevolveDirection = ON, the revolve direction is reversed. The default value is OFF.

  • flipPitchDirection (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to override the direction of translation. If flipPitchDirection = OFF, the direction of translation is given by the direction of the revolve axis. If flipPitchDirection = ON, the translation direction is reversed. The default value is OFF.

  • moveSketchNormalToPath (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to rotate the sketch so that it is normal to the path of revolution when using the pitch option. If moveSketchNormalToPath = OFF, the sketch plane remains parallel to the revolve axis. If moveSketchNormalToPath = ON, the sketch is moved to match the angle created by the pitch before being revolved. The default value is OFF.

Returns:

feature – A Feature object

Return type:

Feature

BaseShellSweep(sketch, path)[source]#

This method creates a first Feature object by sweeping the given section ConstrainedSketch object along the path defined by the path ConstrainedSketch object, creating a shell. The ConstrainedSketch object can define either an open or closed profile. The origin of the profile sketch is positioned at the start of the sweep path and swept perpendicular to the path. No checks are made for self-intersection.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
Returns:

feature – A Feature object

Return type:

Feature

BaseSolidExtrude(sketch, depth, draftAngle=None, pitch=None)[source]#

This method creates a first Feature object by extruding the given ConstrainedSketch object by the given depth, creating a solid. The ConstrainedSketch object must define a closed profile.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • sketch (ConstrainedSketch) – A ConstrainedSketch object specifying the plane shape to be extruded.

  • depth (float) – A Float specifying the extrusion depth. Possible values are 10-5 ≤ depth ≤ 105.

  • draftAngle (Optional[float], default: None) – A Float specifying the draft angle in degrees. Possible values are -90.0 ≤ draftAngle ≤ 90.0. By convention, for a positive draft angle an outer loop will draft outward and an inner loop will draft inward. The opposite is true for a negative draft angle. The default value, 0, implies a normal extrude. The arguments draftAngle and pitch are mutually exclusive.

  • pitch (Optional[float], default: None) – A Float specifying the pitch. The pitch is the distance traveled along the axial direction by the sketch when the sketch has completed one full revolution about the twist axis. Pitch can be specified as positive or negative to achieve right-handed or left-handed twist about the twist axis, respectively. The default value, 0, implies a normal extrude. Possible values are -105 ≤ pitch ≤ 105. The arguments draftAngle and pitch are mutually exclusive.

Returns:

A Feature object.

Return type:

Feature

BaseSolidRevolve(sketch, angle, pitch=None, flipRevolveDirection=OFF, flipPitchDirection=OFF, moveSketchNormalToPath=OFF)[source]#

This method creates a first Feature object by revolving the given ConstrainedSketch object by the given angle, creating a solid. The ConstrainedSketch object must define a closed profile and an axis of revolution. The axis is defined by a single construction line.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • sketch (ConstrainedSketch) – A ConstrainedSketch object specifying the shape to be revolved.

  • angle (float) – A Float specifying the revolve angle in degrees. Possible values are 10-4 ≤ angle ≤ 360.Note:If pitch >>0, there is no upper limit for angle.

  • pitch (Optional[float], default: None) – A Float specifying the pitch. The pitch is the distance traveled along the axial direction, measured between corresponding points on the sketch when it has completed one full revolution about the axis of revolution. Possible values are 0 ≤ pitch ≤ 105. The default value, 0, implies a normal revolve.

  • flipRevolveDirection (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to override the direction of feature creation. If flipRevolveDirection = OFF, the default direction of revolution is used. If flipRevolveDirection = ON, the revolve direction is reversed. The default value is OFF.

  • flipPitchDirection (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to override the direction of translation. If flipPitchDirection = OFF, the direction of translation is given by the direction of the revolve axis. If flipPitchDirection = ON, the translation direction is reversed. The default value is OFF.

  • moveSketchNormalToPath (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to rotate the sketch so that it is normal to the path of revolution when using the pitch option. If moveSketchNormalToPath = OFF, the sketch plane remains parallel to the revolve axis. If moveSketchNormalToPath = ON, the sketch is moved to match the angle created by the pitch before being revolved. The default value is OFF.

Returns:

A Feature object.

Return type:

Feature

Raises:

RangeError

BaseSolidSweep(sketch, path)[source]#

This method creates a first Feature object by sweeping the given profile ConstrainedSketch object along the path defined by the path ConstrainedSketch object, creating a solid. The profile ConstrainedSketch object must define a closed profile. The origin of the profile sketch is positioned at the start of the sweep path and swept perpendicular to the path. No checks are made for self-intersection.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
Returns:

feature – A Feature object

Return type:

Feature

BaseWire(sketch)[source]#

This method creates a first Feature object by creating a planar wire from the given ConstrainedSketch object.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:

sketch (ConstrainedSketch) – A ConstrainedSketch object specifying the planar wire.

Returns:

feature – A Feature object

Return type:

Feature

BlendFaces(side1, side2, method=None, path=None)[source]#

This method creates a Feature object by creating new faces that blends two sets of faces.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • side1 (Tuple[Edge, ...]) – A sequence of Edge objects specifying one side of the blend. The edges must form a continuous chain without branches.

  • side2 (tuple) – A sequence of Edge or Face objects specifying the second side of the blend. If side2 contains Edge objects then they must form a continuous chain without branches.

  • method (Optional[Literal[TANGENT, SHORTEST_PATH, SPECIFY_PATH]], default: None) – A SymbolicConstant indicating a method for creating blends. This argument is a required argument if side2 contains Edge object and it is ignored if side2 contains Faceobjects. It can have one of the following values:TANGENT: The blend is tangent to the sides.SHORTEST_PATH: The blend connects the two sides based on linear interpolation between the two sides.SPECIFY_PATH: The blend connects the two sides along a specified path.

  • path (Optional[Edge], default: None) – An Edge object that connects side1 to side2 and specifies the path for creating the blend. This argument is required if method = SPECIFY_PATH; otherwise, it is ignored.

Returns:

feature – A Feature object

Return type:

Feature

Chamfer(length, edgeList)[source]#

This method creates an additional Feature object by chamfering the given list of edges with a given length.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • length (float) – A Float specifying the length of the chamfer.

  • edgeList (Tuple[Edge, ...]) – A sequence of Edge objects specifying the edges to chamfer.

Returns:

feature – A Feature object

Return type:

Feature

ConvertToAnalytical()[source]#

This method attempts to change entities into a simpler form that will speed up processing and make entities available during feature operations.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Returns:

feature – A Feature object

Return type:

Feature

ConvertToPrecise(method=abaqusConstants.RECOMPUTE_GEOMETRY)[source]#

This method attempts to change imprecise entities so that the geometry becomes precise.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:

method (Literal[RECOMPUTE_GEOMETRY, TIGHTEN_GAPS], default: RECOMPUTE_GEOMETRY) – A SymbolicConstant specifying the method to be used to convert the part to precise. Possible values are RECOMPUTE_GEOMETRY and TIGHTEN_GAPS. The default value is RECOMPUTE_GEOMETRY.

Returns:

feature – A Feature object

Return type:

Feature

CoverEdges(edgeList, tryAnalytical=False)[source]#

This method generates a face using the given edges as the face’s boundaries. The CoverEdges method generates a face by creating the geometry consisting of the underlying surface, associated edges, and vertices.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • edgeList (Tuple[Edge, ...]) – A sequence of Edge objects specifying the edges that bound the new face.

  • tryAnalytical (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether the newly created face should be analytical or not. The default is False.

Returns:

A Feature object.

Return type:

Feature

Raises:
  • Parterror – If the given boundary is not a closed loop.

  • Parterror – If the given boundary contains a zero length component.

  • Parterror – If the underlying surface is too difficult to fit.

Cut(sketchPlane, sketchPlaneSide, sketchUpEdge, sketch, sketchOrientation=None)[source]#

This method creates an additional Feature object by cutting a hole using the given ConstrainedSketch object.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • sketchPlane (str) – A Datum plane object or a planar Face object.

  • sketchPlaneSide (Literal[SIDE1, SIDE2]) – A SymbolicConstant specifying the direction of feature creation. Possible values are SIDE1 and SIDE2.

  • sketchUpEdge (Edge) – An Edge object or a Datum axis object specifying the vertical (Y) direction of the sketch.

  • sketch (ConstrainedSketch) – A ConstrainedSketch object specifying the planar cut.

  • sketchOrientation (Optional[Literal[RIGHT, LEFT, TOP, BOTTOM]], default: None) – A SymbolicConstant specifying the orientation of sketchUpEdge on the sketch. Possible values are RIGHT, LEFT, TOP, and BOTTOM.

Returns:

feature – A Feature object

Return type:

Feature

CutExtrude(sketchPlane, sketchPlaneSide, sketchUpEdge, sketchOrientation, sketch, depth=None, upToFace='', draftAngle=None, pitch=None, flipExtrudeDirection=OFF)[source]#

This method creates an additional Feature object by extruding the given ConstrainedSketch object by the given depth and cutting away material in the solid and shell regions of the part. The ConstrainedSketch object must define a closed profile. The CutExtrude method creates a blind cut (using depth), an up-to-face cut (using upToFace), or a through-all cut (if depth and upToFace are not specified).

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • sketchPlane (str) – A Datum plane object or a planar Face object.

  • sketchPlaneSide (Literal[SIDE1, SIDE2]) – A SymbolicConstant specifying the direction of feature creation. Possible values are SIDE1 and SIDE2.

  • sketchUpEdge (Edge) – An Edge object or a Datum axis object specifying the vertical (Y) direction of the sketch.

  • sketchOrientation (Literal[RIGHT, LEFT, TOP, BOTTOM]) – A SymbolicConstant specifying the orientation of sketchUpEdge on the sketch. Possible values are RIGHT, LEFT, TOP, and BOTTOM.

  • sketch (ConstrainedSketch) – A ConstrainedSketch object specifying the planar sketch to be extruded.

  • depth (Optional[float], default: None) – A Float specifying the extrusion depth. If depth is specified, the cut will be a blind cut. The default is to not specify a depth.

  • upToFace (str, default: '') – A Face specifying the face up to which to cut. If upToFace is specified, the cut will be an up-to-face cut. The default is to not specify a face.Note:If neither depth nor upToFace is specified, the cut will be a through-all cut.

  • draftAngle (Optional[float], default: None) – A Float specifying the draft angle in degrees. Possible values are -90.0 ≤ draftAngle ≤ 90.0. By convention, for a positive draft angle an outer loop will draft outward and an inner loop will draft inward. The opposite is true for a negative draft angle. The default value, 0, implies a normal extrude. The arguments draftAngle and pitch are mutually exclusive.

  • pitch (Optional[float], default: None) – A Float specifying the pitch. The pitch is the distance traveled along the axial direction by the sketch when the sketch has completed one full revolution about the twist axis. Pitch can be specified as positive or negative to achieve right-handed or left-handed twist about the twist axis, respectively. The default value, 0, implies a normal extrude. Possible values are -105 ≤ pitch ≤ 105. The arguments draftAngle and pitch are mutually exclusive.

  • flipExtrudeDirection (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to override the direction of feature creation. If the value is OFF, it means use the direction defined by the sketchPlaneSide; if the value is ON, it means use the opposite direction to the one defined by sketchPlaneSide. The default value is OFF.

Returns:

feature – A Feature object

Return type:

Feature

CutLoft(loftsections, startCondition=None, endCondition=None, startTangent=None, startMagnitude=None, endTangent=None, endMagnitude=None, globalSmoothing=OFF)[source]#

This method creates an additional Feature object by lofting between the given sections and cutting away material from the part. You define the sections using a sequence of edges from the part or an EdgeArray.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • loftsections (tuple) – A sequence of sequences of edges specifying the cross-sections to be lofted. Each outer sequence specifies a section through which the method will pass the loft feature. Each outer sequence can be defined as a sequence of edges or as an EdgeArray. The edges specifying a section must form a simple closed profile and must not contain multiple loops.

  • startCondition (Optional[Literal[NONE, NORMAL, RADIAL, SPECIFIED]], default: None) – A SymbolicConstant specifying the tangent direction at the start section of the loft feature. Possible values are NONE, NORMAL, RADIAL, and SPECIFIED. You can specify this argument only if the start and end sections are planar. You cannot use this argument in conjunction with the path argument. You must use the startCondition argument in conjunction with the endCondition argument.

  • endCondition (Optional[Literal[NONE, NORMAL, RADIAL, SPECIFIED]], default: None) – A SymbolicConstant specifying the tangent direction at the end section of the loft feature. Possible values are NONE, NORMAL, RADIAL, and SPECIFIED. You can specify this argument only if the start and end sections are planar. You cannot use this argument in conjunction with the path argument. You must use the endCondition argument in conjunction with the startCondition argument.

  • startTangent (Optional[float], default: None) – A Float specifying the angle in degrees of the tangent with respect to the plane in which the start section lies. You must specify the startTangent argument if startCondition = SPECIFIED. Possible values are 0.0 ≤ startTangent ≤ 180.0.

  • startMagnitude (Optional[float], default: None) – A Float specifying the magnitude of the startTangent. You must specify the startMagnitude argument if startCondition = SPECIFIED. Possible values are 0.0 << startMagnitude << 100.0.

  • endTangent (Optional[float], default: None) – A Float specifying the angle in degrees of the tangent with respect to the plane in which the end section lies. You must specify the endTangent argument if startCondition = SPECIFIED. Possible values are 0.0 ≤ endTangent ≤ 180.0.

  • endMagnitude (Optional[float], default: None) – A Float specifying the magnitude of the endTangent. This argument is to be used when the endCondition argument has the value SPECIFIED. Possible values are 0.0 << endMagnitude << 100.0.

  • globalSmoothing (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether each path defined in the paths argument is applied locally or globally.If the path is applied locally, its effect is felt only on faces created from the edges on the loftSections through which the paths pass through.If the path is applied globally, an averaging algorithm is applied over all the paths defined and is distributed over all the faces created.The default value is ON (globally).

Returns:

feature – A Feature object

Return type:

Feature

CutRevolve(sketchPlane, sketchPlaneSide, sketchUpEdge, sketchOrientation, sketch, angle, pitch=None, flipRevolveDirection=OFF, flipPitchDirection=OFF, moveSketchNormalToPath=OFF)[source]#

This method creates an additional Feature object by revolving the given ConstrainedSketch object by the given angle and cutting away material from the part. The ConstrainedSketch object must define a closed profile and an axis of revolution.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • sketchPlane (str) – A Datum plane object or a planar Face object.

  • sketchPlaneSide (Literal[SIDE1, SIDE2]) – A SymbolicConstant specifying the direction of feature creation. Possible values are SIDE1 and SIDE2.

  • sketchUpEdge (Edge) – An Edge object or a Datum axis object specifying the vertical (Y) direction of the sketch.

  • sketchOrientation (Literal[RIGHT, LEFT, TOP, BOTTOM]) – A SymbolicConstant specifying the orientation of sketchUpEdge on the sketch. Possible values are RIGHT, LEFT, TOP, and BOTTOM.

  • sketch (ConstrainedSketch) – A ConstrainedSketch object specifying the planar sketch to be revolved.

  • angle (float) – A Float specifying the angle in degrees to be revolved.

  • pitch (Optional[float], default: None) – A Float specifying the pitch. The pitch is the distance traveled along the axial direction, measured between corresponding points on the sketch when it has completed one full revolution about the axis of revolution. Possible values are 0 ≤ pitch ≤ 105. The default value, 0, implies a normal revolve.

  • flipRevolveDirection (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to override the direction of feature creation. If flipRevolveDirection = OFF, the default direction of revolution is used. If flipRevolveDirection = ON, the revolve direction is reversed. The default value is OFF.

  • flipPitchDirection (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to override the direction of translation. If flipPitchDirection = OFF, the direction of translation is given by the direction of the revolve axis. If flipPitchDirection = ON, the translation direction is reversed. The default value is OFF.

  • moveSketchNormalToPath (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to rotate the sketch so that it is normal to the path of revolution when using the pitch option. If moveSketchNormalToPath = OFF, the sketch plane remains parallel to the revolve axis. If moveSketchNormalToPath = ON, the sketch is moved to match the angle created by the pitch before being revolved. The default value is OFF.

Returns:

feature – A Feature object

Return type:

Feature

CutSweep(path, profile, pathPlane='', pathUpEdge=None, pathOrientation=abaqusConstants.RIGHT, sketchPlane='', sketchUpEdge=None, sketchOrientation=abaqusConstants.RIGHT, draftAngle=None, pitch=None, profileNormal=OFF, flipSweepDirection=OFF)[source]#

This method creates an additional Feature object by sweeping the given ConstrainedSketch object along a path which may be a ConstrainedSketch or a sequence of Edge objects and cutting away material from the part. If the profile section is a ConstrainedSketch object, it must define a closed profile. The section sketch can be created at the normal plane at the start of the sweep path or it may be created on a Datum plane or a planar Face. No checks are made for self-intersection.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • path (str) – Path may either be a ConstrainedSketch object or a sequence of Edge objects specifying the path of the sweep.

  • profile (str) – Profile may either be a ConstrainedSketch object or a Face object specifying the section to be swept.

  • pathPlane (str, default: '') – A Datum plane object or a planar Face object. Only required when path is a ConstrainedSketch object.

  • pathUpEdge (Optional[Edge], default: None) – An Edge object or a Datum axis object specifying the vertical (Y) direction of the path sketch. Only required when path is a ConstrainedSketch object.

  • pathOrientation (Literal[RIGHT, LEFT, TOP, BOTTOM], default: RIGHT) – A SymbolicConstant specifying the orientation of pathUpEdge on the sketch. Possible values are RIGHT, LEFT, TOP, and BOTTOM. Default value is RIGHT. Only required when path is a ConstrainedSketch object.

  • sketchPlane (str, default: '') – A Datum plane object or a planar Face object specifying the plane on which to sketch the profile. Not required when profile is a Face object. When profile is chosen as a ConstrainedSketch object, user may or may not give this as input. If user does not give this as input, the normal plane at the start of the path will be the sketchPlane.

  • sketchUpEdge (Optional[Edge], default: None) – An Edge object or a Datum axis object specifying the vertical (Y) direction of the profile sketch. Only required when profile is a ConstrainedSketch object.

  • 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. Default value is RIGHT. Only required when profile is a ConstrainedSketch object.

  • draftAngle (Optional[float], default: None) – A Float specifying the draft angle in degrees. Possible values are -90.0 ≤ draftAngle ≤ 90.0. By convention, for a positive draft angle an outer loop will draft outward and an inner loop will draft inward. The opposite is true for a negative draft angle. The default value, 0, implies a normal extrude. The arguments draftAngle and pitch are mutually exclusive.

  • pitch (Optional[float], default: None) – A Float specifying the pitch. The pitch is the distance traveled along the axial direction by the sketch when the sketch has completed one full revolution about the twist axis. Pitch can be specified as positive or negative to achieve right-handed or left-handed twist about the twist axis, respectively. The default value, 0, implies a normal extrude. Possible values are -105 ≤ pitch ≤ 105. The arguments draftAngle and pitch are mutually exclusive.

  • profileNormal (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to keep the profile normal same as original or varying through out the sweep path. When profileNormal = OFF, the profile normal will vary through out the sweep path. When profileNormal = ON, the profile normal will be same as original through out the sweep path. The default value is OFF.

  • flipSweepDirection (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to flip the direction in which sweep operation will be performed. When flipSweepDirection = OFF, sweep operation will be performed in the direction of path direction. When flipSweepDirection = ON, sweep operation will be performed in the direction opposite to the path direction. The default value is OFF.

Returns:

feature – A Feature object

Return type:

Feature

ExtendFaces(faces=(), extendAlong=(), distance=None, upToFaces=(), trimToExtendedTargetSurfaces=True, upToReferenceRep=OFF)[source]#

This method extends faces along its free edges by offsetting the external edges along the surfaces. One of distance, upToReferenceRep, or upToFaces must be used to specify how far the faces need to be extended.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • faces (Tuple[Face, ...], default: ()) – A sequence of Face objects specifying the faces to be extended. The faces cannot belong to the reference representation. The faces and extendAlong arguments are mutually exclusive. One of them must be specified.

  • extendAlong (Tuple[Edge, ...], default: ()) – A sequence of Edge objects specifying the edges where to extend the faces. Only free edges are considered. The interior edges will be ignored. The faces and extendAlong arguments are mutually exclusive. One of them must be specified.

  • distance (Optional[float], default: None) – A Float indicating the distance to extend the faces along the edges. Either distance, upToReferenceRep, or upToFaces must be specified.

  • upToFaces (Tuple[Face, ...], default: ()) – A sequence of Face objects specifying the faces that the selected faces should be extended up to.

  • trimToExtendedTargetSurfaces (Union[AbaqusBoolean, bool], default: True) – A Boolean indicating that the surfaces of up to target faces should be extended before extending and trimming the selected faces. The default value is True.

  • upToReferenceRep (Union[AbaqusBoolean, bool], default: OFF) – A Boolean indicating that the selected faces should be extended along the selected edges and be trimmed along their intersection with the reference representation.

Returns:

feature – A Feature object

Return type:

Feature

FaceFromElementFaces(elementFaces, stitch=OFF, stitchTolerance=None, analyticFitTolerance=None, associateFace=OFF)[source]#

This method creates a geometry face from a collection of orphan element faces.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • elementFaces (Region) – A Region object specifying the collection of orphan element faces.

  • stitch (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the created geometry face should be stitched with existing geometry faces. Default value is TRUE.

  • stitchTolerance (Optional[float], default: None) – A Float indicating the maximum gap to be stitched. The value should be smaller than the minimum feature size and bigger than the maximum gap expected to be stitched in the model. Otherwise this command may remove small (sliver) edges that are smaller than the tolerance. If stitch tolerance is not provided then default value of 0.001 will be used for stitching.

  • analyticFitTolerance (Optional[float], default: None) – A Float indicating the analytical surface fitting tolerance. If analytical tolerance is not provided then default value of 0.015 will be used for analytical surface fitting.

  • associateFace (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the created geometry face should be associated with the mesh. Default value is TRUE.

Returns:

feature – A Feature object

Return type:

Feature

HoleBlindFromEdges(plane, planeSide, diameter, edge1, distance1, edge2, distance2, depth)[source]#

This method creates an additional Feature object by creating a circular blind hole of the given diameter and depth and cutting away material in the solid and shell regions of the part. The center of the hole is offset from two non-parallel straight edges by the given distances.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • plane (str) – A Datum plane object or a planar Face object.

  • planeSide (Literal[SIDE1, SIDE2]) – A SymbolicConstant specifying the direction of feature creation. Possible values are SIDE1 and SIDE2.

  • diameter (float) – A Float specifying the diameter of the hole.

  • edge1 (Edge) – An Edge object specifying the edge from which distance1 is measured.

  • distance1 (float) – A Float specifying the offset from edge1.

  • edge2 (Edge) – An Edge object specifying the edge from which distance2 is measured.

  • distance2 (float) – A Float specifying the offset from edge2.

  • depth (float) – A Float specifying the depth of the hole.

Returns:

feature – A Feature object

Return type:

Feature

HoleFromEdges(diameter, edge1, distance1, edge2, distance2)[source]#

This method creates an additional Feature object by creating a circular hole of the given diameter in a 2D planar part and cutting away material in the shell and wire regions of the part. The center of the hole is offset from two non-parallel straight edges by the given distances.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • diameter (float) – A Float specifying the diameter of the hole.

  • edge1 (Edge) – An Edge object specifying the edge from which distance1 is measured.

  • distance1 (float) – A Float specifying the offset from edge1.

  • edge2 (Edge) – An Edge object specifying the edge from which distance2 is measured.

  • distance2 (float) – A Float specifying the offset from edge2.

Returns:

feature – A Feature object

Return type:

Feature

HoleThruAllFromEdges(plane, planeSide, diameter, edge1, distance1, edge2, distance2)[source]#

This method creates an additional Feature object by creating a circular through hole of the given diameter and cutting away material in the solid and shell regions of the part. The center of the hole is offset from two non-parallel straight edges by the given distances.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • plane (str) – A Datum plane object or a planar Face object.

  • planeSide (Literal[SIDE1, SIDE2]) – A SymbolicConstant specifying the direction of feature creation. Possible values are SIDE1 and SIDE2.

  • diameter (float) – A Float specifying the diameter of the hole.

  • edge1 (Edge) – An Edge object specifying the edge from which distance1 is measured.

  • distance1 (float) – A Float specifying the offset from edge1.

  • edge2 (Edge) – An Edge object specifying the edge from which distance2 is measured.

  • distance2 (float) – A Float specifying the offset from edge2.

Returns:

feature – A Feature object

Return type:

Feature

MergeEdges(edgeList=(), extendSelection=OFF)[source]#

This method merges edges either by extending the user selection or using only the selected edges.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • edgeList (Tuple[Edge, ...], default: ()) – A sequence of Edge objects specifying the edges to be merged.

  • extendSelection (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether the user selection needs to be extended to include edges till branching occurs. Branching is said to occur when the vertex of an edge is shared by more than two edges.

Returns:

feature – A Feature object

Return type:

Feature

Mirror(mirrorPlane, keepOriginal, keepInternalBoundaries=OFF)[source]#

This method mirrors existing part geometry across a plane to create new geometry.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • mirrorPlane (str) – A Datum plane object or a planar Face object.

  • keepOriginal (Union[AbaqusBoolean, bool]) – A boolean specifying whether or not the original part geometry should be retained.

  • keepInternalBoundaries (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether internal boundaries will be retained. The default value is OFF.

Returns:

feature – A Feature object

Return type:

Feature

OffsetFaces(faceList, distance=None, targetFaces=(), targetFacesMethod=None, fractionDistance=None, trimToReferenceRep=OFF)[source]#

This method creates new faces by offsetting existing faces.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • faceList (Tuple[Face, ...]) – A sequence of Face objects specifying the faces that will be offset. The faces may belong to the part or to the reference representation associated with the part.

  • distance (Optional[float], default: None) – A Float indicating the distance to offset the faces. Either distance or targetFaces must be specified.

  • targetFaces (Tuple[Face, ...], default: ()) – A sequence of Face objects whose distance to the faces argument together with the targetFacesMethod determines the distance to offset the faces. Either distance or targetFaces must be specified.

  • targetFacesMethod (Optional[Literal[HALF_OF_AVERAGE, CLOSEST_POINT_FRACTION, FARTHEST_POINT_FRACTION]], default: None) – A SymbolicConstant indicating how to calculate the distance to offset. It can have one of the following values:HALF_OF_AVERAGE: Offset the faces by a distance equals to half the average distance to target faces.CLOSEST_POINT_FRACTION: Offset the faces by a distance equals to the fraction of the distance to the approximate closest point on the selected target faces.FARTHEST_POINT_FRACTION: Offset the faces by a distance equals to the fraction of the distance to the approximate farthest point on the selected target faces.

  • fractionDistance (Optional[float], default: None) – A Float indicating the fraction of the distance to the closest or the farthest point on the target faces. Its default value is 0.5.

  • trimToReferenceRep (Union[AbaqusBoolean, bool], default: OFF) – A Boolean indicating whether to extend the offset faces and trim them along their intersection with the reference representation.

Returns:

feature – A Feature object

Return type:

Feature

RemoveCells(cellList)[source]#

This method converts a solid entity to a shell entity.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:

cellList (Tuple[Cell, ...]) – A sequence of Cell objects specifying the cells to remove.

Returns:

A Boolean value.

Return type:

Boolean

Raises:

Parterror – If the intended volume to be turned into a shell entity is not three-dimensional.

RemoveFaces(faceList, deleteCells=False)[source]#

This method removes faces from a solid entity or from a shell entity.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • faceList (Tuple[Face, ...]) – A sequence of Face objects specifying the faces to remove.

  • deleteCells (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying whether all cells are to be deleted when the faces are removed. The default value is False.

Returns:

feature – A Feature object

Return type:

Feature

RemoveFacesAndStitch(faceList)[source]#

This method removes faces from a solid entity and attempts to close the resulting gap by extending the neighboring faces of the solid.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:

faceList (Tuple[Face, ...]) – A sequence of Face objects specifying the faces to remove.

Returns:

feature – A Feature object

Return type:

Feature

RemoveRedundantEntities(vertexList=(), edgeList=(), removeEdgeVertices=True)[source]#

This method removes redundant edges and vertices from a solid or a shell entity. One of the two arguments is required.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • vertexList (Tuple[Vertex, ...], default: ()) – A sequence of ConstrainedSketchVertex objects specifying the vertices to be removed.

  • edgeList (Tuple[Edge, ...], default: ()) – A sequence of Edge objects specifying the edges to be removed.

  • removeEdgeVertices (Union[AbaqusBoolean, bool], default: True) – A Boolean specifying whether the vertices of the redundant edges need to be removed. The default is True.

Returns:

A Feature object.

Return type:

Feature

Raises:

Parterror – If the selected entity is not a redundant entity.

RepairFaceNormals(faceList=())[source]#

This method works on the entire part or a sequence of shell faces. When the entire part is selected, it aligns all the shell face normals, and inverts all of the solid faces’ normals if the solid was originally inside out. When a few shell faces are selected, it inverts the normals of the selected faces.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:

faceList (Tuple[Face, ...], default: ()) – A sequence of Face objects.

Returns:

feature – A Feature object

Return type:

Feature

RepairInvalidEdges(edgeList)[source]#

This method repairs invalid edges. It will always attempt to improve edges even if none of selected edges are initially invalid and may leave behind invalid edges that could not be repaired.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:

edgeList (Tuple[Edge, ...]) – A sequence of Edge objects.

Returns:

feature – A Feature object

Return type:

Feature

RepairSliver(face, point1, point2, toleranceChecks=True)[source]#

This method repairs the selected sliver from the selected face. The sliver area is specified using two points. A face partition is carried out at the specified points and the smaller of the two faces is removed.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • face (Face) – A Face object specifying the face on which the sliver is located.

  • point1 (int) – A point specifying the location for partition creation. It can be a ConstrainedSketchVertex object, an Interesting Point or three coordinates specifying the point on an edge of the face.

  • point2 (int) – A point specifying the location for partition creation. It can be a ConstrainedSketchVertex object, an Interesting Point or three coordinates specifying the point on an edge of the face.

  • toleranceChecks (Union[AbaqusBoolean, bool], default: True) – A Boolean specifying whether to use internal tolerance checks to restrict the size of the sliver face being removed. The default is True.

Returns:

feature – A Feature object

Return type:

Feature

RepairSmallEdges(edgeList, toleranceChecks=True)[source]#

This method repairs small edges. This method will attempt to replace selected small edges with vertices and extend the adjacent faces and edges. This method might leave behind some small edges that cannot be removed.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • edgeList (Tuple[Edge, ...]) – A sequence of Edge objects.

  • toleranceChecks (Union[AbaqusBoolean, bool], default: True) – A Boolean specifying whether to use internal tolerance checks to restrict the size of the edges being removed. The default is True.

Returns:

feature – A Feature object

Return type:

Feature

RepairSmallFaces(faceList, toleranceChecks=True)[source]#

This method repairs small faces. It will attempt to replace the selected small faces with edges or vertices and extend the adjacent faces. This method might leave behind some small faces that cannot be removed.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • faceList (Tuple[Face, ...]) – A sequence of Face objects.

  • toleranceChecks (Union[AbaqusBoolean, bool], default: True) – A Boolean specifying whether to use internal tolerance checks to restrict the size of the faces being removed. The default is True.

Returns:

feature – A Feature object

Return type:

Feature

ReplaceFaces(faceList, stitch=True)[source]#

This method replaces the selected faces with a single face. If one single face is selected, that alone is replaced with a new face.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • faceList (Tuple[Face, ...]) – A sequence of Face objects to be replaced.

  • stitch (Union[AbaqusBoolean, bool], default: True) – A Boolean specifying whether the newly created face needs to be stitched to the existing geometry. The default is True.

Returns:

feature – A Feature object

Return type:

Feature

Round(radius, edgeList, vertexList)[source]#

This method creates an additional Feature object by rounding (filleting) the given list of entities with the given radius.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • radius (float) – A Float specifying the radius of the fillets.

  • edgeList (Tuple[Edge, ...]) – A sequence of Edge objects. Solid and Shell edges of a part can be rounded. The operation will fail for non-manifold edges. The edgeList and vertexList arguments are mutually exclusive. One of them must be specified.

  • vertexList (Tuple[Vertex, ...]) – A sequence of ConstrainedSketchVertex objects. Vertices that are connected to two wire edges can be rounded. The operation will fail for a vertex connected to a face. The edgeList and vertexList arguments are mutually exclusive. One of them must be specified.

Returns:

feature – A Feature object

Return type:

Feature

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

This method creates an additional Feature object by creating a planar shell from the given ConstrainedSketch object. The ConstrainedSketch object must define a closed profile.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • sketchPlane (str) – A Datum plane object or a planar Face object.

  • sketchPlaneSide (Literal[SIDE1, SIDE2]) – A SymbolicConstant specifying the direction of feature creation. Possible values are SIDE1 and SIDE2.

  • sketchUpEdge (Edge) – An Edge object or a Datum axis object specifying the vertical (Y) direction of the sketch.

  • sketch (ConstrainedSketch) – A ConstrainedSketch object specifying the planar shell.

  • 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:

feature – A Feature object

Return type:

Feature

ShellExtrude(sketchPlane, sketchPlaneSide, sketchUpEdge, sketch, depth=None, upToFace='', sketchOrientation=abaqusConstants.RIGHT, draftAngle=None, pitch=None, flipExtrudeDirection=OFF, keepInternalBoundaries=OFF)[source]#

This method creates an additional Feature object by extruding the given ConstrainedSketch object by the given depth, creating a shell protrusion. The ConstrainedSketch object can define either an open or closed profile.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • sketchPlane (str) – A Datum plane object or a planar Face object.

  • sketchPlaneSide (Literal[SIDE1, SIDE2]) – A SymbolicConstant specifying the direction of feature creation. Possible values are SIDE1 and SIDE2.

  • sketchUpEdge (Edge) – An Edge object or a Datum axis object specifying the vertical (Y) direction of the sketch.

  • sketch (ConstrainedSketch) – A ConstrainedSketch object specifying the planar sketch to be extruded.

  • depth (Optional[float], default: None) – A Float specifying the extrusion depth. The default is to not specify a depth. Either depth or upToFace must be used to define the extrusion depth.

  • upToFace (str, default: '') – A Face specifying the face up to which to extrude. If upToFace is specified, the extrusion will be an up-to-face extrusion. The default is to not specify a face. Either depth or upToFace must be used to define the extrusion depth.

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

  • draftAngle (Optional[float], default: None) – A Float specifying the draft angle in degrees. Possible values are -90.0 ≤ draftAngle ≤ 90.0. By convention, for a positive draft angle an outer loop will draft outward and an inner loop will draft inward. The opposite is true for a negative draft angle. The default value, 0, implies a normal extrude. The arguments draftAngle and pitch are mutually exclusive.

  • pitch (Optional[float], default: None) – A Float specifying the pitch. The pitch is the distance traveled along the axial direction by the sketch when the sketch has completed one full revolution about the twist axis. Pitch can be specified as positive or negative to achieve right-handed or left-handed twist about the twist axis, respectively. The default value, 0, implies a normal extrude. Possible values are -105 ≤ pitch ≤ 105. The arguments draftAngle and pitch are mutually exclusive.

  • flipExtrudeDirection (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to override the direction of feature creation. If the value is OFF, it means use the direction defined by the sketchPlaneSide; if the value is ON, it means use the opposite direction to the one defined by sketchPlaneSide. The default value is OFF.

  • keepInternalBoundaries (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether internal boundaries will be retained. The default value is OFF.

Returns:

feature – A Feature object

Return type:

Feature

ShellLoft(loftsections, startCondition=None, endCondition=None, startTangent=None, startMagnitude=None, endTangent=None, endMagnitude=None, paths=(), globalSmoothing=OFF, keepInternalBoundaries=OFF)[source]#

This method creates an additional Feature object by lofting between the given sections and adding shell faces to the part. You define the sections using a sequence of edges from the part or an EdgeArray.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • loftsections (tuple) – A sequence of sequences of edges specifying the cross-sections to be lofted. Each outer sequence specifies a section through which the method will pass the loft feature. Each outer sequence can be defined as a sequence of edges or as an EdgeArray. The edges specifying a section must form a simple closed profile and must not contain multiple loops.

  • startCondition (Optional[Literal[NONE, NORMAL, RADIAL, SPECIFIED]], default: None) – A SymbolicConstant specifying the tangent direction at the start section of the loft feature. Possible values are NONE, NORMAL, RADIAL and SPECIFIED. You can specify this argument only if the start and end sections are planar. You cannot use this argument in conjunction with the path argument. You must use the startCondition argument in conjunction with the endCondition argument.

  • endCondition (Optional[Literal[NONE, NORMAL, RADIAL, SPECIFIED]], default: None) – A SymbolicConstant specifying the tangent direction at the end section of the loft feature. Possible values are NONE, NORMAL, RADIAL and SPECIFIED. You can specify this argument only if the start and end sections are planar. You cannot use this argument in conjunction with the path argument. You must use the endCondition argument in conjunction with the startCondition argument.

  • startTangent (Optional[float], default: None) – A Float specifying the angle in degrees of the tangent with respect to the plane in which the start section lies. You must specify the startTangent argument if startCondition = SPECIFIED. Possible values are 0.0 ≤ startTangent ≤ 180.0.

  • startMagnitude (Optional[float], default: None) – A Float specifying the magnitude of the startTangent. You must specify the startMagnitude argument if startCondition = SPECIFIED. Possible values are 0.0 << startMagnitude << 100.0.

  • endTangent (Optional[float], default: None) – A Float specifying the angle in degrees of the tangent with respect to the plane in which the end section lies. You must specify the endTangent argument if startCondition = SPECIFIED. Possible values are 0.0 ≤ endTangent ≤ 180.0.

  • endMagnitude (Optional[float], default: None) – A Float specifying the magnitude of the endTangent. This argument is to be used when the endCondition argument has the value SPECIFIED. Possible values are 0.0 << endMagnitude << 100.0.

  • paths (tuple, default: ()) – A sequence of sequences of edges that pass through each section in the loft feature. Each sequence specifies a path followed by the face or an edge created by a loft feature. Each path must start at the first section, end at the last section, and pass through each section. In addition, the order of the sequences must be the same as the order of the sections in the loftsections argument. Each path must not self-intersect and must be tangent continuous. In addition, the paths must not intersect each other. You cannot use the paths argument in conjunction with the startCondition and endCondition arguments.

  • globalSmoothing (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether each path defined in the paths argument is applied locally or globally.If the path is applied locally, its effect is felt only on faces created from the edges on the loftsections through which the paths pass through.If the path is applied globally, an averaging algorithm is applied over all the paths defined and is distributed over all the faces created.The default value is ON (globally).

  • keepInternalBoundaries (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether internal boundaries will be retained. The default value is OFF.

Returns:

feature – A Feature object

Return type:

Feature

ShellRevolve(sketchPlane, sketchPlaneSide, sketchUpEdge, sketch, angle, sketchOrientation=abaqusConstants.RIGHT, pitch=None, flipRevolveDirection=OFF, flipPitchDirection=OFF, moveSketchNormalToPath=OFF, keepInternalBoundaries=OFF)[source]#

This method creates an additional Feature object by revolving the given ConstrainedSketch object by the given angle, creating a shell protrusion. The ConstrainedSketch object can define either an open or closed profile and an axis of revolution. The axis is defined by a single construction line. For a description of the plane positioning arguments, see SolidExtrude.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • sketchPlane (str) – A Datum plane object or a planar Face object.

  • sketchPlaneSide (Literal[SIDE1, SIDE2]) – A SymbolicConstant specifying the direction of feature creation. Possible values are SIDE1 and SIDE2.

  • sketchUpEdge (Edge) – An Edge object or a Datum axis object specifying the vertical (Y) direction of the sketch.

  • sketch (ConstrainedSketch) – A ConstrainedSketch object specifying the planar sketch to be revolved.

  • angle (float) – A Float specifying the angle in degrees to be revolved.

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

  • pitch (Optional[float], default: None) – A Float specifying the pitch. The pitch is the distance traveled along the axial direction, measured between corresponding points on the sketch when it has completed one full revolution about the axis of revolution. Possible values are 0 ≤ pitch ≤ 105. The default value, 0, implies a normal revolve.

  • flipRevolveDirection (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to override the direction of feature creation. If flipRevolveDirection = OFF, the default direction of revolution is used. If flipRevolveDirection = ON, the revolve direction is reversed. The default value is OFF.

  • flipPitchDirection (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to override the direction of translation. If flipPitchDirection = OFF, the direction of translation is given by the direction of the revolve axis. If flipPitchDirection = ON, the translation direction is reversed. The default value is OFF.

  • moveSketchNormalToPath (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to rotate the sketch so that it is normal to the path of revolution when using the pitch option. If moveSketchNormalToPath = OFF, the sketch plane remains parallel to the revolve axis. If moveSketchNormalToPath = ON, the sketch is moved to match the angle created by the pitch before being revolved. The default value is OFF.

  • keepInternalBoundaries (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether internal boundaries will be retained. The default value is OFF.

Returns:

feature – A Feature object

Return type:

Feature

ShellSweep(path, profile, pathPlane='', pathUpEdge=None, pathOrientation=abaqusConstants.RIGHT, sketchPlane='', sketchUpEdge=None, sketchOrientation=abaqusConstants.RIGHT, draftAngle=None, pitch=None, profileNormal=OFF, flipSweepDirection=OFF, keepInternalBoundaries=OFF)[source]#

This method creates an additional Feature object by sweeping the given ConstrainedSketch object or a sequence of Edge objects along a path which may be a ConstrainedSketch or a sequence of Edge objects, creating a shell swept protrusion. The section can be an open or a closed profile. The section sketch can be created at the normal plane at the start of the sweep path or it may be created on a Datum plane or a planar Face. No checks are made for self-intersection.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • path (str) – Path may either be a ConstrainedSketch object or a sequence of Edge objects specifying the path of the sweep.

  • profile (str) – Profile may either be a ConstrainedSketch object or a sequence of Edge objects specifying the section to be swept.

  • pathPlane (str, default: '') – A Datum plane object or a planar Face object. Only required when path is a ConstrainedSketch object.

  • pathUpEdge (Optional[Edge], default: None) – An Edge object or a Datum axis object specifying the vertical (Y) direction of the path sketch. Only required when path is a ConstrainedSketch object.

  • pathOrientation (Literal[RIGHT, LEFT, TOP, BOTTOM], default: RIGHT) – A SymbolicConstant specifying the orientation of pathUpEdge on the sketch. Possible values are RIGHT, LEFT, TOP, and BOTTOM. Default value is RIGHT. Only required when path is a ConstrainedSketch object.

  • sketchPlane (str, default: '') – A Datum plane object or a planar Face object specifying the plane on which to sketch the profile. Not required when profile is a Face object. When profile is chosen as ConstrainedSketch object, user may or may not give this as input. If user does not give this as input, the normal plane at the start of the path will be the sketchPlane.

  • sketchUpEdge (Optional[Edge], default: None) – An Edge object or a Datum axis object specifying the vertical (Y) direction of the profile sketch. Only required when profile is a ConstrainedSketch object.

  • 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. Default value is RIGHT. Only required when profile is a ConstrainedSketch object.

  • draftAngle (Optional[float], default: None) – A Float specifying the draft angle in degrees. Possible values are -90.0 ≤ draftAngle ≤ 90.0. By convention, for a positive draft angle an outer loop will draft outward and an inner loop will draft inward. The opposite is true for a negative draft angle. The default value, 0, implies a normal extrude. The arguments draftAngle and pitch are mutually exclusive.

  • pitch (Optional[float], default: None) – A Float specifying the pitch. The pitch is the distance traveled along the axial direction by the sketch when the sketch has completed one full revolution about the twist axis. Pitch can be specified as positive or negative to achieve right-handed or left-handed twist about the twist axis, respectively. The default value, 0, implies a normal extrude. Possible values are -105 ≤ pitch ≤ 105. The arguments draftAngle and pitch are mutually exclusive.

  • profileNormal (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to keep the profile normal same as original or varying through out the sweep path. When profileNormal = OFF, the profile normal will vary through out the sweep path. When profileNormal = ON, the profile normal will be same as original through out the sweep path. The default value is OFF.

  • flipSweepDirection (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to flip the direction in which sweep operation will be performed. When flipSweepDirection = OFF, sweep operation will be performed in the direction of path direction. When flipSweepDirection = ON, sweep operation will be performed in the direction opposite to the path direction. The default value is OFF.

  • keepInternalBoundaries (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether internal boundaries will be retained. The default value is OFF.

Returns:

feature – A Feature object

Return type:

Feature

SolidExtrude(sketchPlane, sketchPlaneSide, sketchUpEdge, sketch, depth=None, upToFace='', sketchOrientation=abaqusConstants.RIGHT, draftAngle=None, pitch=None, flipExtrudeDirection=OFF, keepInternalBoundaries=OFF)[source]#

This method creates an additional Feature object by extruding the given ConstrainedSketch object by the given depth, creating a solid protrusion. The ConstrainedSketch object must define a closed profile.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • sketchPlane (str) – A Datum plane object or a planar Face object.

  • sketchPlaneSide (Literal[SIDE1, SIDE2]) – A SymbolicConstant specifying the direction of feature creation. Possible values are SIDE1 and SIDE2.

  • sketchUpEdge (Edge) – An Edge object or a Datum axis object specifying the vertical (Y) direction of the sketch.

  • sketch (ConstrainedSketch) – A ConstrainedSketch object specifying the planar sketch to be extruded.

  • depth (Optional[float], default: None) – A Float specifying the extrusion depth. The default is to not specify a depth. Either depth or upToFace must be used to define the extrusion depth.

  • upToFace (str, default: '') – A Face specifying the face up to which to extrude. If upToFace is specified, the extrusion will be an up-to-face extrusion. The default is to not specify a face. Either depth or upToFace must be used to define the extrusion depth.

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

  • draftAngle (Optional[float], default: None) – A Float specifying the draft angle in degrees. Possible values are -90.0 ≤ draftAngle ≤ 90.0. By convention, for a positive draft angle an outer loop will draft outward and an inner loop will draft inward. The opposite is true for a negative draft angle. The default value, 0, implies a normal extrude. The arguments draftAngle and pitch are mutually exclusive.

  • pitch (Optional[float], default: None) – A Float specifying the pitch. The pitch is the distance traveled along the axial direction by the sketch when the sketch has completed one full revolution about the twist axis. Pitch can be specified as positive or negative to achieve right-handed or left-handed twist about the twist axis, respectively. The default value, 0, implies a normal extrude. Possible values are -105 ≤ pitch ≤ 105. The arguments draftAngle and pitch are mutually exclusive.

  • flipExtrudeDirection (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to override the direction of feature creation. If the value is OFF, it means use the direction defined by the sketchPlaneSide; if the value is ON, it means use the opposite direction to the one defined by sketchPlaneSide. The default value is OFF.

  • keepInternalBoundaries (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether internal boundaries will be retained. The default value is OFF.

Returns:

feature – A Feature object

Return type:

Feature

SolidLoft(loftsections, startCondition=None, endCondition=None, startTangent=None, startMagnitude=None, endTangent=None, endMagnitude=None, paths=(), globalSmoothing=OFF, keepInternalBoundaries=OFF)[source]#

This method creates an additional Feature object by lofting between the given sections and adding material to the part. You define the sections using a sequence of edges from the part or an EdgeArray.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • loftsections (tuple) – A sequence of sequences of edges specifying the cross-sections to be lofted. Each outer sequence specifies a section through which Abaqus will pass the loft feature. Each outer sequence can be defined as a sequence of edges or as an EdgeArray. The edges specifying a section must form a simple closed profile and must not contain multiple loops.

  • startCondition (Optional[Literal[NONE, NORMAL, RADIAL, SPECIFIED]], default: None) – A SymbolicConstant specifying the tangent direction at the start section of the loft feature. Possible values are NONE, NORMAL, RADIAL and SPECIFIED. You can specify this argument only if the start and end sections are planar. You cannot use this argument in conjunction with the path argument. You must use the startCondition argument in conjunction with the endCondition argument.

  • endCondition (Optional[Literal[NONE, NORMAL, RADIAL, SPECIFIED]], default: None) – A SymbolicConstant specifying the tangent direction at the end section of the loft feature. Possible values are NONE, NORMAL, RADIAL and SPECIFIED. You can specify this argument only if the start and end sections are planar. You cannot use this argument in conjunction with the path argument. You must use the endCondition argument in conjunction with the startCondition argument.

  • startTangent (Optional[float], default: None) – A Float specifying the angle in degrees of the tangent with respect to the plane in which the start section lies. You must specify the startTangent argument if startCondition = SPECIFIED. Possible values are 0.0 ≤ startTangent ≤ 180.0.

  • startMagnitude (Optional[float], default: None) – A Float specifying the magnitude of the startTangent. You must specify the startMagnitude argument if startCondition = SPECIFIED. Possible values are 0.0 << startMagnitude << 100.0.

  • endTangent (Optional[float], default: None) – A Float specifying the angle in degrees of the tangent with respect to the plane in which the end section lies. You must specify the endTangent argument if startCondition = SPECIFIED. Possible values are 0.0 ≤ endTangent ≤ 180.0.

  • endMagnitude (Optional[float], default: None) – A Float specifying the magnitude of the endTangent. This argument is to be used when the endCondition argument has the value SPECIFIED. Possible values are 0.0 << endMagnitude << 100.0.

  • paths (tuple, default: ()) – A sequence of sequences of edges that pass through each section in the loft feature. Each sequence specifies a path followed by the face or an edge created by a loft feature. Each path must start at the first section, end at the last section, and pass through each section. In addition, the order of the sequences must be the same as the order of the sections in the loftsections argument. Each path must not self-intersect and must be tangent continuous. In addition, the paths must not intersect each other. You cannot use the paths argument in conjunction with the startCondition and endCondition arguments.

  • globalSmoothing (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether each path defined in the paths argument is applied locally or globally.If the path is applied locally, its effect is felt only on faces created from the edges on the loftsections through which the paths pass through.If the path is applied globally, an averaging algorithm is applied over all the paths defined and is distributed over all the faces created.The default value is ON (globally).

  • keepInternalBoundaries (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether internal boundaries will be retained. The default value is OFF.

Returns:

feature – A Feature object

Return type:

Feature

SolidRevolve(sketchPlane, sketchPlaneSide, sketchUpEdge, sketch, angle, sketchOrientation=abaqusConstants.RIGHT, pitch=None, flipRevolveDirection=OFF, flipPitchDirection=OFF, moveSketchNormalToPath=OFF, keepInternalBoundaries=OFF)[source]#

This method creates an additional Feature object by revolving the given ConstrainedSketch object by the given angle, creating a solid protrusion. The ConstrainedSketch object must define a closed profile and an axis of revolution. The axis is defined by a single construction line.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • sketchPlane (str) – A Datum plane object or a planar Face object.

  • sketchPlaneSide (Literal[SIDE1, SIDE2]) – A SymbolicConstant specifying the direction of feature creation. Possible values are SIDE1 and SIDE2.

  • sketchUpEdge (Edge) – An Edge object or a Datum axis object specifying the vertical (Y) direction of the sketch.

  • sketch (ConstrainedSketch) – A ConstrainedSketch object specifying the planar sketch to be revolved.

  • angle (float) – A Float specifying the angle in degrees to be revolved.

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

  • pitch (Optional[float], default: None) – A Float specifying the pitch. The pitch is the distance traveled along the axial direction, measured between corresponding points on the sketch when it has completed one full revolution about the axis of revolution. Possible values are 0 ≤ pitch ≤ 105. The default value, 0, implies a normal revolve.

  • flipRevolveDirection (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to override the direction of feature creation. If flipRevolveDirection = OFF, the default direction of revolution is used. If flipRevolveDirection = ON, the revolve direction is reversed. The default value is OFF.

  • flipPitchDirection (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to override the direction of translation. If flipPitchDirection = OFF, the direction of translation is given by the direction of the revolve axis. If flipPitchDirection = ON, the translation direction is reversed. The default value is OFF.

  • moveSketchNormalToPath (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to rotate the sketch so that it is normal to the path of revolution when using the pitch option. If moveSketchNormalToPath = OFF, the sketch plane remains parallel to the revolve axis. If moveSketchNormalToPath = ON, the sketch is moved to match the angle created by the pitch before being revolved. The default value is OFF.

  • keepInternalBoundaries (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether internal boundaries will be retained. The default value is OFF.

Returns:

feature – A Feature object

Return type:

Feature

SolidSweep(path, profile, pathPlane='', pathUpEdge=None, pathOrientation=abaqusConstants.RIGHT, sketchPlane='', sketchUpEdge=None, sketchOrientation=abaqusConstants.RIGHT, draftAngle=None, pitch=None, profileNormal=OFF, flipSweepDirection=OFF, keepInternalBoundaries=OFF)[source]#

This method creates an additional Feature object by sweeping the given ConstrainedSketch object or a Face object along a path which may be a ConstrainedSketch or a sequence of Edge objects, creating a solid swept protrusion. If the profile section is a ConstrainedSketch object, it must define a closed profile. The section sketch can be created at the normal plane at the start of the sweep path or it may be created on a Datum plane or a planar Face. No checks are made for self-intersection.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • path (str) – Path may either be a ConstrainedSketch object or a sequence of Edge objects specifying the path of the sweep.

  • profile (str) – Profile may either be a ConstrainedSketch object or a Face object specifying the section to be swept.

  • pathPlane (str, default: '') – A Datum plane object or a planar Face object. Only required when path is a ConstrainedSketch object.

  • pathUpEdge (Optional[Edge], default: None) – An Edge object or a Datum axis object specifying the vertical (Y) direction of the path sketch. Only required when path is a ConstrainedSketch object.

  • pathOrientation (Literal[RIGHT, LEFT, TOP, BOTTOM], default: RIGHT) – A SymbolicConstant specifying the orientation of pathUpEdge on the sketch. Possible values are RIGHT, LEFT, TOP, and BOTTOM. Default value is RIGHT. Only required when path is a ConstrainedSketch object.

  • sketchPlane (str, default: '') – A Datum plane object or a planar Face object specifying the plane on which to sketch the profile. Not required when profile is a Face object. When profile is chosen as ConstrainedSketch object, user may or may not give this as input. If user does not give this as input, the normal plane at the start of the path will be the sketchPlane.

  • sketchUpEdge (Optional[Edge], default: None) – An Edge object or a Datum axis object specifying the vertical (Y) direction of the profile sketch. Only required when profile is a ConstrainedSketch object.

  • 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. Default value is RIGHT. Only required when profile is a ConstrainedSketch object.

  • draftAngle (Optional[float], default: None) – A Float specifying the draft angle in degrees. Possible values are -90.0 ≤ draftAngle ≤ 90.0. By convention, for a positive draft angle an outer loop will draft outward and an inner loop will draft inward. The opposite is true for a negative draft angle. The default value, 0, implies a normal extrude. The arguments draftAngle and pitch are mutually exclusive.

  • pitch (Optional[float], default: None) – A Float specifying the pitch. The pitch is the distance traveled along the axial direction by the sketch when the sketch has completed one full revolution about the twist axis. Pitch can be specified as positive or negative to achieve right-handed or left-handed twist about the twist axis, respectively. The default value, 0, implies a normal extrude. Possible values are -105 ≤ pitch ≤ 105. The arguments draftAngle and pitch are mutually exclusive.

  • profileNormal (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to keep the profile normal same as original or varying through out the sweep path. When profileNormal = OFF, the profile normal will vary through out the sweep path. When profileNormal = ON, the profile normal will be same as original through out the sweep path. The default value is OFF.

  • flipSweepDirection (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to flip the direction in which sweep operation will be performed. When flipSweepDirection = OFF, sweep operation will be performed in the direction of path direction. When flipSweepDirection = ON, sweep operation will be performed in the direction opposite to the path direction. The default value is OFF.

  • keepInternalBoundaries (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether internal boundaries will be retained. The default value is OFF.

Returns:

feature – A Feature object

Return type:

Feature

Stitch(edgeList=(), stitchTolerance=None)[source]#

This method attempts to create a valid part by binding together free and imprecise edges of all the faces of a part. If edgeList is not given, a global stitch will be performed. If stitchTolerance is not specified, a value of 1.0 will be used.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • edgeList (Tuple[Edge, ...], default: ()) – A sequence of Edge objects specifying the edges that need to be stitched.

  • stitchTolerance (Optional[float], default: None) – A Float indicating the maximum gap to be stitched. The value should be smaller than the minimum feature size and bigger than the maximum gap expected to be stitched in the model. Otherwise this command may remove small (sliver) edges that are smaller than the tolerance.

Returns:

feature – A Feature object

Return type:

Feature

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

This method creates an additional Feature object by creating a planar wire from the given ConstrainedSketch object. The ConstrainedSketch object must define a closed profile.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • sketchPlane (str) – A Datum plane object or a planar Face object specifying the plane on which to sketch.

  • sketchPlaneSide (Literal[SIDE1, SIDE2]) – A SymbolicConstant specifying the direction of feature creation. Possible values are SIDE1 and SIDE2.

  • sketchUpEdge (Edge) – An Edge object or a Datum axis object specifying the vertical (Y) direction of the sketch.

  • sketch (ConstrainedSketch) – A ConstrainedSketch object specifying the planar sketch to be revolved.

  • 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:

feature – A Feature object

Return type:

Feature

WireFromEdge(edgeList)[source]#

This method creates an additional Feature object by creating a Wire by selecting one or more Edge objects of a Solid or Shell part.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:

edgeList (str) – A list of Edge objects specifying the edges from which the wire is to be created.

Returns:

feature – A Feature object

Return type:

Feature

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

This method creates an additional Feature object by creating a polyline wire that passes through a sequence of given points. Each point can be a datum point, a vertex, an interesting point, or a tuple.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • points (tuple) – A sequence of ConstrainedSketchVertex, Datum point, or InterestingPoint objects specifying the points through which the polyline wire will pass. points can also be a sequence of tuples of Floats. You must specify at least two values in the sequence.

  • 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 in 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

WireSpline(points, mergeType=abaqusConstants.IMPRINT, smoothClosedSpline=OFF)[source]#

This method creates an additional Feature object by creating a spline wire that passes through a sequence of given points. Each point can be a datum point, a vertex, an interesting point, or a tuple.

Note

This function can be accessed by:

mdb.models[name].parts[name].AutoRepair
Parameters:
  • points (tuple) – A sequence of ConstrainedSketchVertex, Datum point, or InterestingPoint objects specifying the points through which the spline wire will pass. points can also be a sequence of tuples of Floats. You must specify at least two values in the sequence.

  • 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 spline 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.

  • smoothClosedSpline (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying the behavior of Abaqus when the points defining a spline wire form a closed loop (the start and end points are the same). If smoothClosedSpline = ON, Abaqus creates a smooth spline wire where the tangencies at the end point meet smoothly. If smoothClosedSpline = OFF, Abaqus does not automatically create a smooth end condition. The default value in OFF.

Returns:

feature – A Feature object

Return type:

Feature

MeshEditPart#

class MeshEditPart(name: str, dimensionality: SymbolicConstant, type: SymbolicConstant, twist: Union[AbaqusBoolean, bool] = OFF)[source]
class MeshEditPart(name: str, objectToCopy: str, scale: float = 1, mirrorPlane: SymbolicConstant = NONE, compressFeatureList: Union[AbaqusBoolean, bool] = OFF, separate: Union[AbaqusBoolean, bool] = OFF)

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

Note

This object can be accessed by:

import meshEdit

Public Data Attributes:

Inherited from PartBase

geometryValidity

A Boolean specifying the validity of the geometry of the part.

isOutOfDate

An Int specifying that feature parameters have been modified but that the part has not been regenerated.

timeStamp

A Float specifying when the part was last modified.

vertices

A VertexArray object specifying all the vertices in the part.

ignoredVertices

An IgnoredVertexArray object specifying all the ignored vertices in the part.

edges

An EdgeArray object specifying all the edges in the part.

ignoredEdges

An IgnoredEdgeArray object specifying all the ignored edges in the part.

faces

A FaceArray object specifying all the faces in the part.

cells

A CellArray object specifying all the cells in the part.

features

A repository of Feature objects specifying all the features in the part.

featuresById

A repository of Feature objects specifying all Feature objects in the part.

datums

A repository of Datum objects specifying all the datums in the part.

elements

A MeshElementArray object specifying all the elements in the part.

elemFaces

A repository of MeshFace objects specifying all the element faces in the part.

elementFaces

A MeshFaceArray object specifying all the unique element faces in the part.

nodes

A MeshNodeArray object specifying all the nodes in the part.

retainedNodes

A MeshNodeArray object specifying all the retained nodes in the substructure part.

sets

A repository of Set objects specifying for more information, see Set.

allSets

A repository of Set objects specifying the contents of the allSets repository is the same as the contents of the sets repository.

allInternalSets

A repository of Set objects specifying picked regions.

surfaces

A repository of Surface objects specifying for more information, see Surface.

allSurfaces

A repository of Surface objects specifying the contents of the allSurfaces repository is the same as the contents of the surfaces repository.

allInternalSurfaces

A repository of Surface objects specifying picked regions.

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.

referencePoints

A repository of ReferencePoint objects.

engineeringFeatures

An EngineeringFeature object.

sectionAssignments

A SectionAssignmentArray object.

materialOrientations

A MaterialOrientationArray object.

compositeLayups

A repository of CompositeLayup objects.

elemEdges

A repository of MeshEdge objects specifying all the element edges in the part.

elementEdges

A MeshEdgeArray object specifying all the unique element edges in the part.

Inherited from Feature

name

A String specifying the repository key.

id

An Int specifying the ID of the feature.

Public Methods:

adjustMidsideNode(cornerNodes, parameter)

This method is used to adjust the midside node of second-order elements of an orphan mesh part.

cleanMesh(mergeTolerance[, growEdges, ...])

This method is used to collapse short element edges and delete collapsed elements, or grow short element edges, on an orphan mesh part composed of linear elements.

collapseMeshEdge(edge, collapseMethod)

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

combineElement(elements)

This method combines two triangular elements of an orphan mesh part or an Abaqus native mesh.

convertSolidMeshToShell()

This method removes all solid elements from an orphan mesh part and creates triangular or quadrilateral shell elements along their outer faces.

deleteElement(elements[, ...])

This method deletes the given elements from an orphan mesh part or an Abaqus native mesh.

deleteNode(nodes[, deleteUnreferencedNodes])

This method deletes the given nodes from an orphan mesh part.

editNode(nodes[, coordinate1, coordinate2, ...])

This method changes the coordinates of the given nodes on an orphan mesh part or on an Abaqus native mesh.

projectNode(nodes, projectionReference)

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

generateMesh([elemShape])

This method generates a new mesh on an orphan mesh part based on the original mesh.

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.

mergeElement(edge, elements)

Merge a selection of elements arranged in layers on an orphan mesh part into a single layer.

mergeNodes()

orientElements(pickedElements, referenceRegion)

This method orients the stack direction of elements in a continuum shell or gasket mesh.

removeElementSize()

This method removes the global element size from an orphan mesh part.

renumberElement([elements, startLabel, ...])

This method assigns new labels to orphan mesh elements.

renumberNode([nodes, startLabel, increment, ...])

This method assigns new labels to orphan mesh nodes.

setElementSize(size)

This method sets the global element size for an orphan mesh part.

splitElement(elements)

This method splits quadrilateral elements of an orphan mesh part or a Abaqus native mesh into triangular elements.

splitMeshEdge(edge[, parameter])

This method splits an edge of a quadrilateral or triangular element of an orphan mesh part or an Abaqus native mesh.

subdivideElement([elements, divisionNumber, ...])

Subdivide a selection of elements on an orphan mesh part in one or more directions.

swapMeshEdge(edge)

This method swaps the diagonal of two adjacent triangular elements of an orphan mesh part or an Abaqus native mesh.

wrapMesh(radius)

This method wraps a planar orphan mesh part about the Z-axis.

redoMeshEdit()

This method executes the edit mesh or the bottom-up meshing operation most recently undone by the undoMeshEdit method on an part.

undoMeshEdit()

This method undoes the most recent edit mesh or the bottom-up meshing operation on a part and restores the mesh to its previous state.

Inherited from PartBase

__init__(*args, **kwargs)

PartFromBooleanCut(name, instanceToBeCut, ...)

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

PartFromBooleanMerge(name, instances[, ...])

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

PartFromExtrude2DMesh(name, part, depth, ...)

This method creates a Part object by extruding an existing two-dimensional orphan mesh Part object in the positive Z-direction and places it in the parts repository.

PartFromGeometryFile(name, geometryFile, ...)

This method creates a Part object and places it in the parts repository.

PartFromInstanceMesh(name[, partInstances, ...])

This method creates a Part object containing the mesh found in the supplied PartInstance objects and places the new Part object in the parts repository.

PartFromMesh(name[, copySets])

This method creates a Part object containing the mesh found in the part and places the new Part object in the parts repository.

PartFromMeshMirror(name, part, point1, point2)

This method creates a Part object by mirroring an existing orphan mesh Part object about a specified plane and places it in the parts repository.

PartFromNodesAndElements(name, ...[, twist])

This method creates a Part object from nodes and elements and places it in the parts repository.

PartFromOdb(name, odb[, fileName, instance, ...])

This method creates an orphan mesh Part object by reading an output database.

PartFromSection3DMeshByPlane(name, part, ...)

This method creates a Part object by cutting an existing three-dimensional orphan mesh Part object by a plane and places it in the parts repository.

PartFromSubstructure(name, substructureFile, ...)

This method creates a substructure Part object by reading a substructure sim file and places it in the parts repository.

Part2DGeomFrom2DMesh(name, part, featureAngle)

This method creates a geometric Part object from the outline of an existing two-dimensional orphan mesh Part object and places it in the parts repository.

setValues(*args, **kwargs)

This method modifies the Part object.

addGeomToSketch(sketch)

This method converts a part into a sketch by projecting all of the edges of the part onto the X-Y plane of the sketch.

assignThickness(faces[, thickness, ...])

This method assigns thickness data to shell faces.

backup()

This method makes a backup copy of the features in the part.

checkGeometry([detailed, reportFacetErrors, ...])

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

clearGeometryCache()

This method clears the geometry cache.

deleteAllFeatures()

This method deletes all the features in the part.

deleteFeatures(featureNames)

This method deletes the given features.

getAngle(plane1, plane2, line1, line2[, ...])

This method returns the angle between the specified entities.

getArea(faces[, relativeAccuracy])

This method returns the total surface area of a given face or group of faces.

getAssociatedCADPaths()

This method returns the paths to the associated CAD part and root file.

getCADParameters()

This method returns the names and values of the CAD parameters associated with the part.

getCentroid(faces, cells[, relativeAccuracy])

Location of the centroid of a given face/cell or group of faces/cells

getCoordinates(entity, csys)

This method returns the coordinates of specified point.

getCurvature(edges[, samplePoints])

This method returns the maximum curvature of a given edge or group of edges.

getDistance(entity1, entity2)

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

getLength(edges)

This method returns the length of a given edge or group of edges.

getPerimeter(faces)

This method returns the total perimeter of a given face or group of faces.

getVolume(cells[, relativeAccuracy])

This method returns the volume area of a given cell or group of cells.

getMassProperties([regions, ...])

This method returns the mass properties of a part or region.

getFeatureFaces(name)

This method returns a sequence of Face objects that are created by the given feature.

getFeatureEdges(name)

This method returns a sequence of Edge objects that are created by the given feature.

getFeatureCells(name)

This method returns a sequence of Cell objects that are created by the given feature.

getFeatureVertices(name)

This method returns a sequence of ConstrainedSketchVertex objects that are created by the given feature.

isAlignedWithSketch()

This method checks if the normal of an analytical rigid surface part is aligned with that of its sketch.

printAssignedSections()

This method prints information on each section that has been assigned to a region of the part.

projectEdgesOntoSketch(sketch, edges[, ...])

This method projects the selected edges of a part onto the specified ConstrainedSketch object.

projectReferencesOntoSketch(sketch[, ...])

This method projects the vertices of specified edges, and datum points from the part onto the specified ConstrainedSketch object.

queryAttributes([printResults])

This method prints the following information about a part:

queryCachedStates()

This method displays the position of geometric states relative to the sequence of features in the part cache.

queryGeometry([relativeAccuracy, printResults])

This method prints the following information about a part:

queryRegionsMissingSections()

This method returns all regions in the part that do not have a section assignment but require one for analysis.

queryDisjointPlyRegions()

This method provides a list of all composite plys in the current part which have disjoint regions.

regenerate()

This method regenerates a part.

regenerationWarnings()

This method prints any regeneration warnings associated with the features.

removeInvalidGeometry()

Removes all invalid entities from the part, leaving a valid part.

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.

resumeFeatures(featureNames)

This method resumes the specified suppressed features in the part.

resumeLastSetFeatures()

This method resumes the last set of features to be suppressed in the part.

saveGeometryCache()

This method caches the current geometry.

setAssociatedCADPaths([partFile, rootFile])

This method sets the paths to the associated CAD part and root file.

suppressFeatures(featureNames)

This method suppresses the given features.

writeAcisFile(fileName[, version])

This method exports the geometry of the part to a named file in ACIS format.

writeCADParameters(paramFile[, ...])

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

writeIgesFile(fileName, flavor)

This method exports the geometry of the part to a named file in IGES format.

writeStepFile(fileName)

This method exports the geometry of the part to a named file in STEP format.

writeVdaFile(fileName)

This method exports the geometry of the part to a named file in VDA-FS format.

copyMeshPattern(elements, faces, elemFaces, ...)

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

Lock()

This method locks the part.

Unlock()

This method unlocks the part.

LockForUpgrade()

This method locks the part for upgrade.

Inherited from PartFeature

AutoRepair()

This method carries out a sequence of geometry repair operations if it contains invalid entities.

AddCells(faceList[, flipped])

This method tries to convert a shell entity to a solid entity.

AnalyticRigidSurf2DPlanar(sketch)

This method creates a first Feature object for an analytical rigid surface by creating a planar wire from the given ConstrainedSketch object.

AnalyticRigidSurfExtrude(sketch[, depth])

This method creates a first Feature object for an analytical rigid surface by extruding the given ConstrainedSketch object by the given depth, creating a surface.

AnalyticRigidSurfRevolve(sketch)

This method creates a first Feature object for an analytical rigid surface by revolving the given ConstrainedSketch object by 360° about the Y-axis.

AssignMidsurfaceRegion(cellList)

This method assign a mid-surface property to sequence of Cell objects.

BaseSolidExtrude(sketch, depth[, ...])

This method creates a first Feature object by extruding the given ConstrainedSketch object by the given depth, creating a solid.

BaseSolidRevolve(sketch, angle[, pitch, ...])

This method creates a first Feature object by revolving the given ConstrainedSketch object by the given angle, creating a solid.

BaseSolidSweep(sketch, path)

This method creates a first Feature object by sweeping the given profile ConstrainedSketch object along the path defined by the path ConstrainedSketch object, creating a solid.

BaseShell(sketch)

This method creates a first Feature object by creating a planar shell from the given ConstrainedSketch object.

BaseShellExtrude(sketch, depth[, ...])

This method creates a first Feature object by extruding the given ConstrainedSketch object by the given depth, creating a shell.

BaseShellRevolve(sketch, angle[, pitch, ...])

This method creates a first Feature object by revolving the given ConstrainedSketch object by the given angle, creating a shell.

BaseShellSweep(sketch, path)

This method creates a first Feature object by sweeping the given section ConstrainedSketch object along the path defined by the path ConstrainedSketch object, creating a shell.

BaseWire(sketch)

This method creates a first Feature object by creating a planar wire from the given ConstrainedSketch object.

BlendFaces(side1, side2[, method, path])

This method creates a Feature object by creating new faces that blends two sets of faces.

Chamfer(length, edgeList)

This method creates an additional Feature object by chamfering the given list of edges with a given length.

Mirror(mirrorPlane, keepOriginal[, ...])

This method mirrors existing part geometry across a plane to create new geometry.

ConvertToAnalytical()

This method attempts to change entities into a simpler form that will speed up processing and make entities available during feature operations.

ConvertToPrecise([method])

This method attempts to change imprecise entities so that the geometry becomes precise.

CoverEdges(edgeList[, tryAnalytical])

This method generates a face using the given edges as the face's boundaries.

Cut(sketchPlane, sketchPlaneSide, ...[, ...])

This method creates an additional Feature object by cutting a hole using the given ConstrainedSketch object.

CutExtrude(sketchPlane, sketchPlaneSide, ...)

This method creates an additional Feature object by extruding the given ConstrainedSketch object by the given depth and cutting away material in the solid and shell regions of the part.

CutLoft(loftsections[, startCondition, ...])

This method creates an additional Feature object by lofting between the given sections and cutting away material from the part.

CutRevolve(sketchPlane, sketchPlaneSide, ...)

This method creates an additional Feature object by revolving the given ConstrainedSketch object by the given angle and cutting away material from the part.

CutSweep(path, profile[, pathPlane, ...])

This method creates an additional Feature object by sweeping the given ConstrainedSketch object along a path which may be a ConstrainedSketch or a sequence of Edge objects and cutting away material from the part.

ExtendFaces([faces, extendAlong, distance, ...])

This method extends faces along its free edges by offsetting the external edges along the surfaces.

FaceFromElementFaces(elementFaces[, stitch, ...])

This method creates a geometry face from a collection of orphan element faces.

HoleBlindFromEdges(plane, planeSide, ...)

This method creates an additional Feature object by creating a circular blind hole of the given diameter and depth and cutting away material in the solid and shell regions of the part.

HoleFromEdges(diameter, edge1, distance1, ...)

This method creates an additional Feature object by creating a circular hole of the given diameter in a 2D planar part and cutting away material in the shell and wire regions of the part.

HoleThruAllFromEdges(plane, planeSide, ...)

This method creates an additional Feature object by creating a circular through hole of the given diameter and cutting away material in the solid and shell regions of the part.

MergeEdges([edgeList, extendSelection])

This method merges edges either by extending the user selection or using only the selected edges.

OffsetFaces(faceList[, distance, ...])

This method creates new faces by offsetting existing faces.

RemoveCells(cellList)

This method converts a solid entity to a shell entity.

RemoveFaces(faceList[, deleteCells])

This method removes faces from a solid entity or from a shell entity.

RemoveFacesAndStitch(faceList)

This method removes faces from a solid entity and attempts to close the resulting gap by extending the neighboring faces of the solid.

RemoveRedundantEntities([vertexList, ...])

This method removes redundant edges and vertices from a solid or a shell entity.

RepairFaceNormals([faceList])

This method works on the entire part or a sequence of shell faces.

RepairInvalidEdges(edgeList)

This method repairs invalid edges.

RepairSliver(face, point1, point2[, ...])

This method repairs the selected sliver from the selected face.

RepairSmallEdges(edgeList[, toleranceChecks])

This method repairs small edges.

RepairSmallFaces(faceList[, toleranceChecks])

This method repairs small faces.

ReplaceFaces(faceList[, stitch])

This method replaces the selected faces with a single face.

Round(radius, edgeList, vertexList)

This method creates an additional Feature object by rounding (filleting) the given list of entities with the given radius.

Shell(sketchPlane, sketchPlaneSide, ...[, ...])

This method creates an additional Feature object by creating a planar shell from the given ConstrainedSketch object.

ShellExtrude(sketchPlane, sketchPlaneSide, ...)

This method creates an additional Feature object by extruding the given ConstrainedSketch object by the given depth, creating a shell protrusion.

ShellLoft(loftsections[, startCondition, ...])

This method creates an additional Feature object by lofting between the given sections and adding shell faces to the part.

ShellRevolve(sketchPlane, sketchPlaneSide, ...)

This method creates an additional Feature object by revolving the given ConstrainedSketch object by the given angle, creating a shell protrusion.

ShellSweep(path, profile[, pathPlane, ...])

This method creates an additional Feature object by sweeping the given ConstrainedSketch object or a sequence of Edge objects along a path which may be a ConstrainedSketch or a sequence of Edge objects, creating a shell swept protrusion.

SolidExtrude(sketchPlane, sketchPlaneSide, ...)

This method creates an additional Feature object by extruding the given ConstrainedSketch object by the given depth, creating a solid protrusion.

SolidLoft(loftsections[, startCondition, ...])

This method creates an additional Feature object by lofting between the given sections and adding material to the part.

SolidRevolve(sketchPlane, sketchPlaneSide, ...)

This method creates an additional Feature object by revolving the given ConstrainedSketch object by the given angle, creating a solid protrusion.

SolidSweep(path, profile[, pathPlane, ...])

This method creates an additional Feature object by sweeping the given ConstrainedSketch object or a Face object along a path which may be a ConstrainedSketch or a sequence of Edge objects, creating a solid swept protrusion.

Stitch([edgeList, stitchTolerance])

This method attempts to create a valid part by binding together free and imprecise edges of all the faces of a part.

Wire(sketchPlane, sketchPlaneSide, ...[, ...])

This method creates an additional Feature object by creating a planar wire from the given ConstrainedSketch object.

WireSpline(points[, mergeType, ...])

This method creates an additional Feature object by creating a spline wire that passes through a sequence of given points.

WirePolyLine(points[, mergeType, meshable])

This method creates an additional Feature object by creating a polyline wire that passes through a sequence of given points.

WireFromEdge(edgeList)

This method creates an additional Feature object by creating a Wire by selecting one or more Edge objects of a Solid or Shell part.

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 polyline wire that passes through a sequence of given points.

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(*args, **kwargs)

This method modifies the Part object.

suppress()

This method suppresses features.


adjustMidsideNode(cornerNodes, parameter)[source]

This method is used to adjust the midside node of second-order elements of an orphan mesh part.

Parameters:
  • cornerNodes (Tuple[Node, ...]) – A sequence of Node objects specifying the nodes towards which connected midside nodes will be biased.

  • parameter (float) – A Float specifying the normalized distance along the edge of the midside nodes. Possible values are 0.0 ≤ parameter ≤ 1.0, where 0.0 specifies the position of the corner node. The default value is 0.5.

cleanMesh(mergeTolerance, growEdges=OFF, elements='', refEdge='', thicknessDir=None, moveLayers=False)[source]

This method is used to collapse short element edges and delete collapsed elements, or grow short element edges, on an orphan mesh part composed of linear elements.

Parameters:
  • mergeTolerance (float) – A Float specifying the edge length tolerance. During the operation, edges shorter than the given tolerance will be collapsed, or grown to the specified length.

  • growEdges (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether short element edges will be grown to the specified tolerance. Default is False, meaning short edges will be collapsed.

  • elements (str, default: '') – The elements to consider as the domain for the operation. By default all elements on the part are considered. The elements may be given as a MeshElementArray, a list of MeshElement objects, a Set, or a list of Set objects.

  • refEdge (str, default: '') – A MeshEdge specifying a reference edge to indicate a topological direction in a structured mesh that will limit which edges within the element domain are considered. That is, only edges that are found to be topologically parallel to the given reference edge will be considered by the operation. By default all edges of the element domain are considered, unless thicknessDir is specified, in which case the operation will attempt to determine the topological edges from the thickness direction.

  • thicknessDir (Optional[float], default: None) – A tuple of two or three Floats indicating a vector along which element edge lengths will be measured.

  • moveLayers (Union[AbaqusBoolean, bool], default: False) – A Boolean indicating whether element edges will be all grown in the direction of the thickness vector specified by thicknessDir. This argument is ignored unless growEdges is True and thicknessDir is provided. When this argument is True the growth of any given element edge will no longer be constrained by short edges on neighboring elements, but elements could move from their original positions in cases where there are multiple adjacent layers of thin elements. The default value is False.

collapseMeshEdge(edge, collapseMethod)[source]

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

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 an orphan mesh part or an Abaqus native mesh.

Parameters:

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

convertSolidMeshToShell()[source]

This method removes all solid elements from an orphan mesh part and creates triangular or quadrilateral shell elements along their outer faces.

deleteElement(elements, deleteUnreferencedNodes=OFF)[source]

This method deletes the given elements from an orphan mesh part or an Abaqus native mesh. If the elements belong to an Abaqus native mesh then the elements must have been generated using the bottom-up meshing technique.

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.

deleteNode(nodes, deleteUnreferencedNodes=OFF)[source]

This method deletes the given nodes from an orphan mesh part.

Parameters:
  • nodes (Tuple[MeshNode, ...]) – A sequence of MeshNode objects or a Set object containing nodes.

  • deleteUnreferencedNodes (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to delete all those associated nodes that become unreferenced after the given nodes and the connected elements are deleted. The default value is OFF.

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 an orphan mesh part or on an Abaqus native mesh.

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:

generateMesh(elemShape=None)[source]

This method generates a new mesh on an orphan mesh part based on the original mesh.

Parameters:

elemShape (Optional[SymbolicConstant], default: None) – A SymbolicConstant specifying the element shape to be used for meshing. Possible values are:TRIRefine a planar triangular mesh and replace it with a new one. If no element sizes are attached, the new mesh will be governed by the sizes of the boundary edges in the old mesh. TETCreate a tetrahedral mesh from a closed shell of triangular elements.

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.

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.

mergeElement(edge, elements)[source]

Merge a selection of elements arranged in layers on an orphan mesh part into a single layer.

Parameters:
  • edge (str) – A MeshEdge of one of the specified elements that serves as a reference edge to indicate the topological direction for merging elements. All specified elements must be reachable by topological navigation from this element edge, and the topological direction must be unambiguous.

  • elements (str) – A MeshElementArray, a list of MeshElement objects, a Set, or a list of Set objects containing the elements to be included in the merge operation.

mergeNodes(nodes: Tuple[Node, ...], tolerance: Optional[float] = None, removeDuplicateElements: Union[AbaqusBoolean, bool] = True, keepHighLabels: Union[AbaqusBoolean, bool] = False)[source]
mergeNodes(node1: MeshNode, node2: MeshNode, removeDuplicateElements: Union[AbaqusBoolean, bool] = True, keepHighLabels: Union[AbaqusBoolean, bool] = False)
orientElements(pickedElements, referenceRegion)[source]

This method orients the stack direction of elements in a continuum shell or gasket mesh.

Parameters:
  • pickedElements (Tuple[MeshElement, ...]) – A sequence of MeshElement objects specifying the elements to orient.

  • referenceRegion (MeshFace) – A MeshFace object specifying a reference top face that indicates the desired orientation.

projectNode(nodes, projectionReference)[source]

This method projects the given nodes onto a mesh entity, geometric entity, or a datum object. The nodes may belong to an orphan mesh part or to an Abaqus native mesh.

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.

redoMeshEdit()[source]

This method executes the edit mesh or the bottom-up meshing operation most recently undone by the undoMeshEdit method on an part. A redo action must be currently available for the part. This implies that the user must have executed the undoMeshEdit method on the part 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.

removeElementSize()[source]

This method removes the global element size from an orphan mesh part.

renumberElement(elements=(), startLabel=None, increment=None, offset=None, labels='')[source]

This method assigns new labels to orphan mesh elements.

Parameters:
  • elements (tuple, default: ()) – A MeshElementArray or a tuple or list of MeshElement objects, or a Set containing elements to be renumbered. If unspecified, all elements in the part will be renumbered.

  • startLabel (Optional[int], default: None) – A positive Int specifying the new label for the first element in elements.

  • increment (Optional[int], default: None) – A positive Int specifying the increment used for computation of new labels for all consecutive elements in elements.

  • offset (Optional[int], default: None) – An Int by which existing labels of the specified elements will be offset.

  • labels (str, default: '') – A list of labels for the specified elements. The length of this list must match the number of specified elements.

Raises:
  • Error – Renumbering is attempted on a native part

  • Error – Renumbering data is specified incorrectly

  • Error – Renumbering will result in invalid labels

  • Error – Renumbering will result in conflicting labels

renumberNode(nodes=(), startLabel=None, increment=None, offset=None, labels='')[source]

This method assigns new labels to orphan mesh nodes.

Parameters:
  • nodes (tuple, default: ()) – A MeshNodeArray or a tuple or list of MeshNode objects, or a Set containing nodes to be renumbered. If unspecified, all nodes in the part will be renumbered.

  • startLabel (Optional[int], default: None) – A positive Int specifying the new label for the first node in nodes.

  • increment (Optional[int], default: None) – A positive Int specifying the increment used for computation of new labels for all consecutive nodes in nodes.

  • offset (Optional[int], default: None) – An Int by which existing labels of the specified nodes will be offset.

  • labels (str, default: '') – A list of labels for the specified nodes. The length of this list must match the number of specified nodes.

Raises:
  • Error – Renumbering is attempted on a native part.

  • Error – Renumbering data is specified incorrectly.

  • Error – Renumbering will result in invalid labels.

  • Error – Renumbering will result in conflicting labels.

setElementSize(size)[source]

This method sets the global element size for an orphan mesh part.

Parameters:

size (float) – A Float specifying the desired element size.

splitElement(elements)[source]

This method splits quadrilateral elements of an orphan mesh part or a Abaqus native mesh 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 an orphan mesh part or an Abaqus native mesh.

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

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

subdivideElement(elements='', divisionNumber=2, face=None, edge=None)[source]

Subdivide a selection of elements on an orphan mesh part in one or more directions.

Parameters:
  • elements (str, default: '') – A MeshElementArray, a list of MeshElement objects, a Set, or a list of Set objects containing the elements to be subdivided. By default all the elements of the part are subdivided.

  • divisionNumber (int, default: 2) – An Int specifying the number of resulting elements for each input element in each direction of the subdivision. If face or edge are not specified, elements will be subdivided according to this number in all possible directions. Must be greater than one. Default is 2.

  • face (Optional[MeshFace], default: None) – A MeshFace object that serves as a reference for indicating two topological directions for the subdivision operation. Must be a face of one of the specified elements, and all specified elements must be reachable by topological navigation from this element face. May not be combined with edge.

  • edge (Optional[MeshEdge], default: None) – A MeshEdge object that serves as a reference for indicating a single topological direction for the subdivision operation. Must be an edge of one of the specified elements, and all specified elements must be reachable by topological navigation from this element edge. May not be combined with face.

swapMeshEdge(edge)[source]

This method swaps the diagonal of two adjacent triangular elements of an orphan mesh part or an Abaqus native mesh.

Parameters:

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

undoMeshEdit()[source]

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

wrapMesh(radius)[source]

This method wraps a planar orphan mesh part about the Z-axis.

Parameters:

radius (float) – A Float specifying the radius of the cylinder about which the part is to be wrapped. The wrapping procedure will relocate a node at point (xx, yy) on the planar mesh to (x,θ,zx,θ,z), where rr is the specified radius, θθ = xrxr, and zz=yy.

MeshPart#

class MeshPart(name: str, dimensionality: SymbolicConstant, type: SymbolicConstant, twist: Union[AbaqusBoolean, bool] = OFF)[source]
class MeshPart(name: str, objectToCopy: str, scale: float = 1, mirrorPlane: SymbolicConstant = NONE, compressFeatureList: Union[AbaqusBoolean, bool] = OFF, separate: Union[AbaqusBoolean, bool] = OFF)

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

Note

This object can be accessed by:

import mesh

Public Data Attributes:

Inherited from PartBase

geometryValidity

A Boolean specifying the validity of the geometry of the part.

isOutOfDate

An Int specifying that feature parameters have been modified but that the part has not been regenerated.

timeStamp

A Float specifying when the part was last modified.

vertices

A VertexArray object specifying all the vertices in the part.

ignoredVertices

An IgnoredVertexArray object specifying all the ignored vertices in the part.

edges

An EdgeArray object specifying all the edges in the part.

ignoredEdges

An IgnoredEdgeArray object specifying all the ignored edges in the part.

faces

A FaceArray object specifying all the faces in the part.

cells

A CellArray object specifying all the cells in the part.

features

A repository of Feature objects specifying all the features in the part.

featuresById

A repository of Feature objects specifying all Feature objects in the part.

datums

A repository of Datum objects specifying all the datums in the part.

elements

A MeshElementArray object specifying all the elements in the part.

elemFaces

A repository of MeshFace objects specifying all the element faces in the part.

elementFaces

A MeshFaceArray object specifying all the unique element faces in the part.

nodes

A MeshNodeArray object specifying all the nodes in the part.

retainedNodes

A MeshNodeArray object specifying all the retained nodes in the substructure part.

sets

A repository of Set objects specifying for more information, see Set.

allSets

A repository of Set objects specifying the contents of the allSets repository is the same as the contents of the sets repository.

allInternalSets

A repository of Set objects specifying picked regions.

surfaces

A repository of Surface objects specifying for more information, see Surface.

allSurfaces

A repository of Surface objects specifying the contents of the allSurfaces repository is the same as the contents of the surfaces repository.

allInternalSurfaces

A repository of Surface objects specifying picked regions.

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.

referencePoints

A repository of ReferencePoint objects.

engineeringFeatures

An EngineeringFeature object.

sectionAssignments

A SectionAssignmentArray object.

materialOrientations

A MaterialOrientationArray object.

compositeLayups

A repository of CompositeLayup objects.

elemEdges

A repository of MeshEdge objects specifying all the element edges in the part.

elementEdges

A MeshEdgeArray object specifying all the unique element edges in the part.

Inherited from Feature

name

A String specifying the repository key.

id

An Int specifying the ID of the feature.

Public Methods:

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 parts or regions.

deleteMeshAssociationWithGeometry(...[, ...])

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

deletePreviewMesh()

This method deletes all boundary meshes in the parts.

deleteSeeds(regions)

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

generateMesh([regions, ...])

This method generates a mesh in the given parts or regions.

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.

getEdgeSeeds(edge, attribute)

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

getElementType(region, elemShape)

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

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 a part.

getMeshStats(regions)

This method returns the mesh statistics for the given regions.

getPartSeeds(attribute)

This method returns a part seed parameter for the part.

getUnmeshedRegions()

This method returns all geometric regions in the part 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.

seedPart(size[, deviationFactor, ...])

This method assigns global edge seeds to the given parts.

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 mesh quality of a part and returns poor-quality elements.

Node(coordinates[, localCsys, label])

This method creates a node on an orphan mesh part.

Inherited from PartBase

__init__(*args, **kwargs)

PartFromBooleanCut(name, instanceToBeCut, ...)

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

PartFromBooleanMerge(name, instances[, ...])

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

PartFromExtrude2DMesh(name, part, depth, ...)

This method creates a Part object by extruding an existing two-dimensional orphan mesh Part object in the positive Z-direction and places it in the parts repository.

PartFromGeometryFile(name, geometryFile, ...)

This method creates a Part object and places it in the parts repository.

PartFromInstanceMesh(name[, partInstances, ...])

This method creates a Part object containing the mesh found in the supplied PartInstance objects and places the new Part object in the parts repository.

PartFromMesh(name[, copySets])

This method creates a Part object containing the mesh found in the part and places the new Part object in the parts repository.

PartFromMeshMirror(name, part, point1, point2)

This method creates a Part object by mirroring an existing orphan mesh Part object about a specified plane and places it in the parts repository.

PartFromNodesAndElements(name, ...[, twist])

This method creates a Part object from nodes and elements and places it in the parts repository.

PartFromOdb(name, odb[, fileName, instance, ...])

This method creates an orphan mesh Part object by reading an output database.

PartFromSection3DMeshByPlane(name, part, ...)

This method creates a Part object by cutting an existing three-dimensional orphan mesh Part object by a plane and places it in the parts repository.

PartFromSubstructure(name, substructureFile, ...)

This method creates a substructure Part object by reading a substructure sim file and places it in the parts repository.

Part2DGeomFrom2DMesh(name, part, featureAngle)

This method creates a geometric Part object from the outline of an existing two-dimensional orphan mesh Part object and places it in the parts repository.

setValues(*args, **kwargs)

This method modifies the Part object.

addGeomToSketch(sketch)

This method converts a part into a sketch by projecting all of the edges of the part onto the X-Y plane of the sketch.

assignThickness(faces[, thickness, ...])

This method assigns thickness data to shell faces.

backup()

This method makes a backup copy of the features in the part.

checkGeometry([detailed, reportFacetErrors, ...])

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

clearGeometryCache()

This method clears the geometry cache.

deleteAllFeatures()

This method deletes all the features in the part.

deleteFeatures(featureNames)

This method deletes the given features.

getAngle(plane1, plane2, line1, line2[, ...])

This method returns the angle between the specified entities.

getArea(faces[, relativeAccuracy])

This method returns the total surface area of a given face or group of faces.

getAssociatedCADPaths()

This method returns the paths to the associated CAD part and root file.

getCADParameters()

This method returns the names and values of the CAD parameters associated with the part.

getCentroid(faces, cells[, relativeAccuracy])

Location of the centroid of a given face/cell or group of faces/cells

getCoordinates(entity, csys)

This method returns the coordinates of specified point.

getCurvature(edges[, samplePoints])

This method returns the maximum curvature of a given edge or group of edges.

getDistance(entity1, entity2)

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

getLength(edges)

This method returns the length of a given edge or group of edges.

getPerimeter(faces)

This method returns the total perimeter of a given face or group of faces.

getVolume(cells[, relativeAccuracy])

This method returns the volume area of a given cell or group of cells.

getMassProperties([regions, ...])

This method returns the mass properties of a part or region.

getFeatureFaces(name)

This method returns a sequence of Face objects that are created by the given feature.

getFeatureEdges(name)

This method returns a sequence of Edge objects that are created by the given feature.

getFeatureCells(name)

This method returns a sequence of Cell objects that are created by the given feature.

getFeatureVertices(name)

This method returns a sequence of ConstrainedSketchVertex objects that are created by the given feature.

isAlignedWithSketch()

This method checks if the normal of an analytical rigid surface part is aligned with that of its sketch.

printAssignedSections()

This method prints information on each section that has been assigned to a region of the part.

projectEdgesOntoSketch(sketch, edges[, ...])

This method projects the selected edges of a part onto the specified ConstrainedSketch object.

projectReferencesOntoSketch(sketch[, ...])

This method projects the vertices of specified edges, and datum points from the part onto the specified ConstrainedSketch object.

queryAttributes([printResults])

This method prints the following information about a part:

queryCachedStates()

This method displays the position of geometric states relative to the sequence of features in the part cache.

queryGeometry([relativeAccuracy, printResults])

This method prints the following information about a part:

queryRegionsMissingSections()

This method returns all regions in the part that do not have a section assignment but require one for analysis.

queryDisjointPlyRegions()

This method provides a list of all composite plys in the current part which have disjoint regions.

regenerate()

This method regenerates a part.

regenerationWarnings()

This method prints any regeneration warnings associated with the features.

removeInvalidGeometry()

Removes all invalid entities from the part, leaving a valid part.

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.

resumeFeatures(featureNames)

This method resumes the specified suppressed features in the part.

resumeLastSetFeatures()

This method resumes the last set of features to be suppressed in the part.

saveGeometryCache()

This method caches the current geometry.

setAssociatedCADPaths([partFile, rootFile])

This method sets the paths to the associated CAD part and root file.

suppressFeatures(featureNames)

This method suppresses the given features.

writeAcisFile(fileName[, version])

This method exports the geometry of the part to a named file in ACIS format.

writeCADParameters(paramFile[, ...])

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

writeIgesFile(fileName, flavor)

This method exports the geometry of the part to a named file in IGES format.

writeStepFile(fileName)

This method exports the geometry of the part to a named file in STEP format.

writeVdaFile(fileName)

This method exports the geometry of the part to a named file in VDA-FS format.

copyMeshPattern(elements, faces, elemFaces, ...)

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

Lock()

This method locks the part.

Unlock()

This method unlocks the part.

LockForUpgrade()

This method locks the part for upgrade.

Inherited from PartFeature

AutoRepair()

This method carries out a sequence of geometry repair operations if it contains invalid entities.

AddCells(faceList[, flipped])

This method tries to convert a shell entity to a solid entity.

AnalyticRigidSurf2DPlanar(sketch)

This method creates a first Feature object for an analytical rigid surface by creating a planar wire from the given ConstrainedSketch object.

AnalyticRigidSurfExtrude(sketch[, depth])

This method creates a first Feature object for an analytical rigid surface by extruding the given ConstrainedSketch object by the given depth, creating a surface.

AnalyticRigidSurfRevolve(sketch)

This method creates a first Feature object for an analytical rigid surface by revolving the given ConstrainedSketch object by 360° about the Y-axis.

AssignMidsurfaceRegion(cellList)

This method assign a mid-surface property to sequence of Cell objects.

BaseSolidExtrude(sketch, depth[, ...])

This method creates a first Feature object by extruding the given ConstrainedSketch object by the given depth, creating a solid.

BaseSolidRevolve(sketch, angle[, pitch, ...])

This method creates a first Feature object by revolving the given ConstrainedSketch object by the given angle, creating a solid.

BaseSolidSweep(sketch, path)

This method creates a first Feature object by sweeping the given profile ConstrainedSketch object along the path defined by the path ConstrainedSketch object, creating a solid.

BaseShell(sketch)

This method creates a first Feature object by creating a planar shell from the given ConstrainedSketch object.

BaseShellExtrude(sketch, depth[, ...])

This method creates a first Feature object by extruding the given ConstrainedSketch object by the given depth, creating a shell.

BaseShellRevolve(sketch, angle[, pitch, ...])

This method creates a first Feature object by revolving the given ConstrainedSketch object by the given angle, creating a shell.

BaseShellSweep(sketch, path)

This method creates a first Feature object by sweeping the given section ConstrainedSketch object along the path defined by the path ConstrainedSketch object, creating a shell.

BaseWire(sketch)

This method creates a first Feature object by creating a planar wire from the given ConstrainedSketch object.

BlendFaces(side1, side2[, method, path])

This method creates a Feature object by creating new faces that blends two sets of faces.

Chamfer(length, edgeList)

This method creates an additional Feature object by chamfering the given list of edges with a given length.

Mirror(mirrorPlane, keepOriginal[, ...])

This method mirrors existing part geometry across a plane to create new geometry.

ConvertToAnalytical()

This method attempts to change entities into a simpler form that will speed up processing and make entities available during feature operations.

ConvertToPrecise([method])

This method attempts to change imprecise entities so that the geometry becomes precise.

CoverEdges(edgeList[, tryAnalytical])

This method generates a face using the given edges as the face's boundaries.

Cut(sketchPlane, sketchPlaneSide, ...[, ...])

This method creates an additional Feature object by cutting a hole using the given ConstrainedSketch object.

CutExtrude(sketchPlane, sketchPlaneSide, ...)

This method creates an additional Feature object by extruding the given ConstrainedSketch object by the given depth and cutting away material in the solid and shell regions of the part.

CutLoft(loftsections[, startCondition, ...])

This method creates an additional Feature object by lofting between the given sections and cutting away material from the part.

CutRevolve(sketchPlane, sketchPlaneSide, ...)

This method creates an additional Feature object by revolving the given ConstrainedSketch object by the given angle and cutting away material from the part.

CutSweep(path, profile[, pathPlane, ...])

This method creates an additional Feature object by sweeping the given ConstrainedSketch object along a path which may be a ConstrainedSketch or a sequence of Edge objects and cutting away material from the part.

ExtendFaces([faces, extendAlong, distance, ...])

This method extends faces along its free edges by offsetting the external edges along the surfaces.

FaceFromElementFaces(elementFaces[, stitch, ...])

This method creates a geometry face from a collection of orphan element faces.

HoleBlindFromEdges(plane, planeSide, ...)

This method creates an additional Feature object by creating a circular blind hole of the given diameter and depth and cutting away material in the solid and shell regions of the part.

HoleFromEdges(diameter, edge1, distance1, ...)

This method creates an additional Feature object by creating a circular hole of the given diameter in a 2D planar part and cutting away material in the shell and wire regions of the part.

HoleThruAllFromEdges(plane, planeSide, ...)

This method creates an additional Feature object by creating a circular through hole of the given diameter and cutting away material in the solid and shell regions of the part.

MergeEdges([edgeList, extendSelection])

This method merges edges either by extending the user selection or using only the selected edges.

OffsetFaces(faceList[, distance, ...])

This method creates new faces by offsetting existing faces.

RemoveCells(cellList)

This method converts a solid entity to a shell entity.

RemoveFaces(faceList[, deleteCells])

This method removes faces from a solid entity or from a shell entity.

RemoveFacesAndStitch(faceList)

This method removes faces from a solid entity and attempts to close the resulting gap by extending the neighboring faces of the solid.

RemoveRedundantEntities([vertexList, ...])

This method removes redundant edges and vertices from a solid or a shell entity.

RepairFaceNormals([faceList])

This method works on the entire part or a sequence of shell faces.

RepairInvalidEdges(edgeList)

This method repairs invalid edges.

RepairSliver(face, point1, point2[, ...])

This method repairs the selected sliver from the selected face.

RepairSmallEdges(edgeList[, toleranceChecks])

This method repairs small edges.

RepairSmallFaces(faceList[, toleranceChecks])

This method repairs small faces.

ReplaceFaces(faceList[, stitch])

This method replaces the selected faces with a single face.

Round(radius, edgeList, vertexList)

This method creates an additional Feature object by rounding (filleting) the given list of entities with the given radius.

Shell(sketchPlane, sketchPlaneSide, ...[, ...])

This method creates an additional Feature object by creating a planar shell from the given ConstrainedSketch object.

ShellExtrude(sketchPlane, sketchPlaneSide, ...)

This method creates an additional Feature object by extruding the given ConstrainedSketch object by the given depth, creating a shell protrusion.

ShellLoft(loftsections[, startCondition, ...])

This method creates an additional Feature object by lofting between the given sections and adding shell faces to the part.

ShellRevolve(sketchPlane, sketchPlaneSide, ...)

This method creates an additional Feature object by revolving the given ConstrainedSketch object by the given angle, creating a shell protrusion.

ShellSweep(path, profile[, pathPlane, ...])

This method creates an additional Feature object by sweeping the given ConstrainedSketch object or a sequence of Edge objects along a path which may be a ConstrainedSketch or a sequence of Edge objects, creating a shell swept protrusion.

SolidExtrude(sketchPlane, sketchPlaneSide, ...)

This method creates an additional Feature object by extruding the given ConstrainedSketch object by the given depth, creating a solid protrusion.

SolidLoft(loftsections[, startCondition, ...])

This method creates an additional Feature object by lofting between the given sections and adding material to the part.

SolidRevolve(sketchPlane, sketchPlaneSide, ...)

This method creates an additional Feature object by revolving the given ConstrainedSketch object by the given angle, creating a solid protrusion.

SolidSweep(path, profile[, pathPlane, ...])

This method creates an additional Feature object by sweeping the given ConstrainedSketch object or a Face object along a path which may be a ConstrainedSketch or a sequence of Edge objects, creating a solid swept protrusion.

Stitch([edgeList, stitchTolerance])

This method attempts to create a valid part by binding together free and imprecise edges of all the faces of a part.

Wire(sketchPlane, sketchPlaneSide, ...[, ...])

This method creates an additional Feature object by creating a planar wire from the given ConstrainedSketch object.

WireSpline(points[, mergeType, ...])

This method creates an additional Feature object by creating a spline wire that passes through a sequence of given points.

WirePolyLine(points[, mergeType, meshable])

This method creates an additional Feature object by creating a polyline wire that passes through a sequence of given points.

WireFromEdge(edgeList)

This method creates an additional Feature object by creating a Wire by selecting one or more Edge objects of a Solid or Shell part.

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 polyline wire that passes through a sequence of given points.

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(*args, **kwargs)

This method modifies the Part object.

suppress()

This method suppresses features.


Node(coordinates, localCsys=None, label=None)[source]

This method creates a node on an orphan mesh part.

Note

This function can be accessed by:

mdb.models[name].parts[name].Node
Parameters:
  • coordinates (tuple) – A sequence of three Floats specifying the coordinates of the new node.

  • localCsys (Optional[DatumCsys], default: None) – A DatumCsys object specifying the local coordinate system. If unspecified, the global coordinate system will be used.

  • label (Optional[int], default: None) – An Int specifying the node label.

Returns:

A MeshNode object.

Return type:

MeshNode

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.

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.

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 Mesh:py:class:~abaqus.BasicGeometry.Face.Face 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 0x7f350e3436d0>) – A MeshNode object specifying the mesh node to be associated with the geometric vertex.

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.

Parameters:
  • regions (Tuple[Face, ...], default: ()) – A sequence of Face 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. If regions is not specified then the entire part is the domain for searching geometric entities that need to be merged.

  • 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 the 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

deleteBoundaryLayerControls(regions)[source]

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

Parameters:

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

deleteMesh(regions)[source]

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

Parameters:

regions (Tuple[MeshPart]) – A sequence of Part objects or Region objects specifying the parts or regions from which the native mesh is to be deleted.

deleteMeshAssociationWithGeometry(geometricEntities, addBoundingEntities=False)[source]

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

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 parts. 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 parts or deletes the local edge seeds from the given edges.

Parameters:

regions (Tuple[MeshPart]) – A sequence of Part objects or Edge objects specifying the parts or edges from which the seeds are to be deleted.

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.

Parameters:
  • cell (Cell) – A Cell object specifying the geometric region where the mesh is to be generated. This argument is valid only for native parts.

  • 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 Mesh:py:class:~abaqus.BasicGeometry.Face.Face 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 Mesh:py:class:~abaqus.BasicGeometry.Face.Face 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 parts. 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.

Parameters:
  • cell (Cell) – A Cell object specifying the geometric region where the mesh is to be generated. This argument is valid only for native parts.

  • 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 Mesh:py:class:~abaqus.BasicGeometry.Face.Face 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 parts. 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.

Parameters:
  • cell (Cell) – A Cell object specifying the geometric region where the mesh is to be generated. This argument is valid only for native parts.

  • 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 Mesh:py:class:~abaqus.BasicGeometry.Face.Face 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 connecting sides of the sweep meshing operation.

  • elemFacesConnectingSides (Tuple[MeshFace, ...], default: ()) – A sequence of Mesh:py:class:~abaqus.BasicGeometry.Face.Face 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 parts. The default value is False.

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

This method generates a mesh in the given parts or regions.

Parameters:
  • regions (Tuple[MeshPart], default: ()) – A sequence of Part objects or Region objects specifying the parts 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 preview 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.

getEdgeSeeds(edge, attribute)[source]

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

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 a part.

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:

    • LINE

    • QUAD

    • TRI

    • HEX

    • WEDGE

    • TET

Returns:

An ElemType object.

Return type:

ElementType

Raises:

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

getIncompatibleMeshInterfaces(cells=())[source]

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

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

getMeshControl(region, attribute)[source]

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

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

Parameters:

regions (tuple) – A sequence or tuple of ConstrainedSketchGeometry regions for which mesh statistics should be returned.

Returns:

A MeshStats object.

Return type:

MeshStats

getPartSeeds(attribute)[source]

This method returns a part seed parameter for the part.

Parameters:

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 depends 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 that depends on the value of the attribute argument.

Return type:

float

Raises:

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

getUnmeshedRegions()[source]

This method returns all geometric regions in the part 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

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.

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

restoreIgnoredEntity(entities)[source]

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

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

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.

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.

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.

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

seedPart(size, deviationFactor=None, minSizeFactor=None, constraint=abaqusConstants.FREE)[source]

This method assigns global edge seeds to the given parts.

Parameters:
  • 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.

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.

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.

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.

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

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

setSweepPath(region, edge, sense)[source]

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

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.

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

This method tests the mesh quality of a part and returns poor-quality elements.

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, the entire part mesh is 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]

PropertyPart#

class PropertyPart(name: str, dimensionality: SymbolicConstant, type: SymbolicConstant, twist: Union[AbaqusBoolean, bool] = OFF)[source]
class PropertyPart(name: str, objectToCopy: str, scale: float = 1, mirrorPlane: SymbolicConstant = NONE, compressFeatureList: Union[AbaqusBoolean, bool] = OFF, separate: Union[AbaqusBoolean, bool] = OFF)

Public Data Attributes:

Inherited from PartBase

geometryValidity

A Boolean specifying the validity of the geometry of the part.

isOutOfDate

An Int specifying that feature parameters have been modified but that the part has not been regenerated.

timeStamp

A Float specifying when the part was last modified.

vertices

A VertexArray object specifying all the vertices in the part.

ignoredVertices

An IgnoredVertexArray object specifying all the ignored vertices in the part.

edges

An EdgeArray object specifying all the edges in the part.

ignoredEdges

An IgnoredEdgeArray object specifying all the ignored edges in the part.

faces

A FaceArray object specifying all the faces in the part.

cells

A CellArray object specifying all the cells in the part.

features

A repository of Feature objects specifying all the features in the part.

featuresById

A repository of Feature objects specifying all Feature objects in the part.

datums

A repository of Datum objects specifying all the datums in the part.

elements

A MeshElementArray object specifying all the elements in the part.

elemFaces

A repository of MeshFace objects specifying all the element faces in the part.

elementFaces

A MeshFaceArray object specifying all the unique element faces in the part.

nodes

A MeshNodeArray object specifying all the nodes in the part.

retainedNodes

A MeshNodeArray object specifying all the retained nodes in the substructure part.

sets

A repository of Set objects specifying for more information, see Set.

allSets

A repository of Set objects specifying the contents of the allSets repository is the same as the contents of the sets repository.

allInternalSets

A repository of Set objects specifying picked regions.

surfaces

A repository of Surface objects specifying for more information, see Surface.

allSurfaces

A repository of Surface objects specifying the contents of the allSurfaces repository is the same as the contents of the surfaces repository.

allInternalSurfaces

A repository of Surface objects specifying picked regions.

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.

referencePoints

A repository of ReferencePoint objects.

engineeringFeatures

An EngineeringFeature object.

sectionAssignments

A SectionAssignmentArray object.

materialOrientations

A MaterialOrientationArray object.

compositeLayups

A repository of CompositeLayup objects.

elemEdges

A repository of MeshEdge objects specifying all the element edges in the part.

elementEdges

A MeshEdgeArray object specifying all the unique element edges in the part.

Inherited from Feature

name

A String specifying the repository key.

id

An Int specifying the ID of the feature.

Public Methods:

CompositeLayup(name[, description, ...])

This method creates a CompositeLayup object.

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

This method creates a SectionAssignment object.

MaterialOrientation([region, localCsys, ...])

This method creates a MaterialOrientation object.

assignBeamSectionOrientation(region, method, n1)

This method assigns a beam section orientation to a region of a part.

assignMaterialOrientation(region, localCsys)

This method assigns a material orientation to a region.

assignRebarOrientation(region, localCsys[, ...])

This method assigns a rebar reference orientation to a region.

flipNormal(regions[, referenceRegion])

This method flips the normals of shell or membrane elements of an orphan mesh or of two-dimensional geometric regions.

flipTangent(regions)

This method flips the tangents of beam or truss elements of an orphan mesh or of one-dimensional geometric regions.

unassignBeamSectionOrientation(index)

This method deletes a beam section orientation assignment.

unassignMaterialOrientation(index)

This method deletes a material orientation assignment.

unassignRebarOrientation(index)

This method deletes a rebar orientation assignment.

Inherited from PartBase

__init__(*args, **kwargs)

PartFromBooleanCut(name, instanceToBeCut, ...)

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

PartFromBooleanMerge(name, instances[, ...])

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

PartFromExtrude2DMesh(name, part, depth, ...)

This method creates a Part object by extruding an existing two-dimensional orphan mesh Part object in the positive Z-direction and places it in the parts repository.

PartFromGeometryFile(name, geometryFile, ...)

This method creates a Part object and places it in the parts repository.

PartFromInstanceMesh(name[, partInstances, ...])

This method creates a Part object containing the mesh found in the supplied PartInstance objects and places the new Part object in the parts repository.

PartFromMesh(name[, copySets])

This method creates a Part object containing the mesh found in the part and places the new Part object in the parts repository.

PartFromMeshMirror(name, part, point1, point2)

This method creates a Part object by mirroring an existing orphan mesh Part object about a specified plane and places it in the parts repository.

PartFromNodesAndElements(name, ...[, twist])

This method creates a Part object from nodes and elements and places it in the parts repository.

PartFromOdb(name, odb[, fileName, instance, ...])

This method creates an orphan mesh Part object by reading an output database.

PartFromSection3DMeshByPlane(name, part, ...)

This method creates a Part object by cutting an existing three-dimensional orphan mesh Part object by a plane and places it in the parts repository.

PartFromSubstructure(name, substructureFile, ...)

This method creates a substructure Part object by reading a substructure sim file and places it in the parts repository.

Part2DGeomFrom2DMesh(name, part, featureAngle)

This method creates a geometric Part object from the outline of an existing two-dimensional orphan mesh Part object and places it in the parts repository.

setValues(*args, **kwargs)

This method modifies the Part object.

addGeomToSketch(sketch)

This method converts a part into a sketch by projecting all of the edges of the part onto the X-Y plane of the sketch.

assignThickness(faces[, thickness, ...])

This method assigns thickness data to shell faces.

backup()

This method makes a backup copy of the features in the part.

checkGeometry([detailed, reportFacetErrors, ...])

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

clearGeometryCache()

This method clears the geometry cache.

deleteAllFeatures()

This method deletes all the features in the part.

deleteFeatures(featureNames)

This method deletes the given features.

getAngle(plane1, plane2, line1, line2[, ...])

This method returns the angle between the specified entities.

getArea(faces[, relativeAccuracy])

This method returns the total surface area of a given face or group of faces.

getAssociatedCADPaths()

This method returns the paths to the associated CAD part and root file.

getCADParameters()

This method returns the names and values of the CAD parameters associated with the part.

getCentroid(faces, cells[, relativeAccuracy])

Location of the centroid of a given face/cell or group of faces/cells

getCoordinates(entity, csys)

This method returns the coordinates of specified point.

getCurvature(edges[, samplePoints])

This method returns the maximum curvature of a given edge or group of edges.

getDistance(entity1, entity2)

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

getLength(edges)

This method returns the length of a given edge or group of edges.

getPerimeter(faces)

This method returns the total perimeter of a given face or group of faces.

getVolume(cells[, relativeAccuracy])

This method returns the volume area of a given cell or group of cells.

getMassProperties([regions, ...])

This method returns the mass properties of a part or region.

getFeatureFaces(name)

This method returns a sequence of Face objects that are created by the given feature.

getFeatureEdges(name)

This method returns a sequence of Edge objects that are created by the given feature.

getFeatureCells(name)

This method returns a sequence of Cell objects that are created by the given feature.

getFeatureVertices(name)

This method returns a sequence of ConstrainedSketchVertex objects that are created by the given feature.

isAlignedWithSketch()

This method checks if the normal of an analytical rigid surface part is aligned with that of its sketch.

printAssignedSections()

This method prints information on each section that has been assigned to a region of the part.

projectEdgesOntoSketch(sketch, edges[, ...])

This method projects the selected edges of a part onto the specified ConstrainedSketch object.

projectReferencesOntoSketch(sketch[, ...])

This method projects the vertices of specified edges, and datum points from the part onto the specified ConstrainedSketch object.

queryAttributes([printResults])

This method prints the following information about a part:

queryCachedStates()

This method displays the position of geometric states relative to the sequence of features in the part cache.

queryGeometry([relativeAccuracy, printResults])

This method prints the following information about a part:

queryRegionsMissingSections()

This method returns all regions in the part that do not have a section assignment but require one for analysis.

queryDisjointPlyRegions()

This method provides a list of all composite plys in the current part which have disjoint regions.

regenerate()

This method regenerates a part.

regenerationWarnings()

This method prints any regeneration warnings associated with the features.

removeInvalidGeometry()

Removes all invalid entities from the part, leaving a valid part.

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.

resumeFeatures(featureNames)

This method resumes the specified suppressed features in the part.

resumeLastSetFeatures()

This method resumes the last set of features to be suppressed in the part.

saveGeometryCache()

This method caches the current geometry.

setAssociatedCADPaths([partFile, rootFile])

This method sets the paths to the associated CAD part and root file.

suppressFeatures(featureNames)

This method suppresses the given features.

writeAcisFile(fileName[, version])

This method exports the geometry of the part to a named file in ACIS format.

writeCADParameters(paramFile[, ...])

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

writeIgesFile(fileName, flavor)

This method exports the geometry of the part to a named file in IGES format.

writeStepFile(fileName)

This method exports the geometry of the part to a named file in STEP format.

writeVdaFile(fileName)

This method exports the geometry of the part to a named file in VDA-FS format.

copyMeshPattern(elements, faces, elemFaces, ...)

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

Lock()

This method locks the part.

Unlock()

This method unlocks the part.

LockForUpgrade()

This method locks the part for upgrade.

Inherited from PartFeature

AutoRepair()

This method carries out a sequence of geometry repair operations if it contains invalid entities.

AddCells(faceList[, flipped])

This method tries to convert a shell entity to a solid entity.

AnalyticRigidSurf2DPlanar(sketch)

This method creates a first Feature object for an analytical rigid surface by creating a planar wire from the given ConstrainedSketch object.

AnalyticRigidSurfExtrude(sketch[, depth])

This method creates a first Feature object for an analytical rigid surface by extruding the given ConstrainedSketch object by the given depth, creating a surface.

AnalyticRigidSurfRevolve(sketch)

This method creates a first Feature object for an analytical rigid surface by revolving the given ConstrainedSketch object by 360° about the Y-axis.

AssignMidsurfaceRegion(cellList)

This method assign a mid-surface property to sequence of Cell objects.

BaseSolidExtrude(sketch, depth[, ...])

This method creates a first Feature object by extruding the given ConstrainedSketch object by the given depth, creating a solid.

BaseSolidRevolve(sketch, angle[, pitch, ...])

This method creates a first Feature object by revolving the given ConstrainedSketch object by the given angle, creating a solid.

BaseSolidSweep(sketch, path)

This method creates a first Feature object by sweeping the given profile ConstrainedSketch object along the path defined by the path ConstrainedSketch object, creating a solid.

BaseShell(sketch)

This method creates a first Feature object by creating a planar shell from the given ConstrainedSketch object.

BaseShellExtrude(sketch, depth[, ...])

This method creates a first Feature object by extruding the given ConstrainedSketch object by the given depth, creating a shell.

BaseShellRevolve(sketch, angle[, pitch, ...])

This method creates a first Feature object by revolving the given ConstrainedSketch object by the given angle, creating a shell.

BaseShellSweep(sketch, path)

This method creates a first Feature object by sweeping the given section ConstrainedSketch object along the path defined by the path ConstrainedSketch object, creating a shell.

BaseWire(sketch)

This method creates a first Feature object by creating a planar wire from the given ConstrainedSketch object.

BlendFaces(side1, side2[, method, path])

This method creates a Feature object by creating new faces that blends two sets of faces.

Chamfer(length, edgeList)

This method creates an additional Feature object by chamfering the given list of edges with a given length.

Mirror(mirrorPlane, keepOriginal[, ...])

This method mirrors existing part geometry across a plane to create new geometry.

ConvertToAnalytical()

This method attempts to change entities into a simpler form that will speed up processing and make entities available during feature operations.

ConvertToPrecise([method])

This method attempts to change imprecise entities so that the geometry becomes precise.

CoverEdges(edgeList[, tryAnalytical])

This method generates a face using the given edges as the face's boundaries.

Cut(sketchPlane, sketchPlaneSide, ...[, ...])

This method creates an additional Feature object by cutting a hole using the given ConstrainedSketch object.

CutExtrude(sketchPlane, sketchPlaneSide, ...)

This method creates an additional Feature object by extruding the given ConstrainedSketch object by the given depth and cutting away material in the solid and shell regions of the part.

CutLoft(loftsections[, startCondition, ...])

This method creates an additional Feature object by lofting between the given sections and cutting away material from the part.

CutRevolve(sketchPlane, sketchPlaneSide, ...)

This method creates an additional Feature object by revolving the given ConstrainedSketch object by the given angle and cutting away material from the part.

CutSweep(path, profile[, pathPlane, ...])

This method creates an additional Feature object by sweeping the given ConstrainedSketch object along a path which may be a ConstrainedSketch or a sequence of Edge objects and cutting away material from the part.

ExtendFaces([faces, extendAlong, distance, ...])

This method extends faces along its free edges by offsetting the external edges along the surfaces.

FaceFromElementFaces(elementFaces[, stitch, ...])

This method creates a geometry face from a collection of orphan element faces.

HoleBlindFromEdges(plane, planeSide, ...)

This method creates an additional Feature object by creating a circular blind hole of the given diameter and depth and cutting away material in the solid and shell regions of the part.

HoleFromEdges(diameter, edge1, distance1, ...)

This method creates an additional Feature object by creating a circular hole of the given diameter in a 2D planar part and cutting away material in the shell and wire regions of the part.

HoleThruAllFromEdges(plane, planeSide, ...)

This method creates an additional Feature object by creating a circular through hole of the given diameter and cutting away material in the solid and shell regions of the part.

MergeEdges([edgeList, extendSelection])

This method merges edges either by extending the user selection or using only the selected edges.

OffsetFaces(faceList[, distance, ...])

This method creates new faces by offsetting existing faces.

RemoveCells(cellList)

This method converts a solid entity to a shell entity.

RemoveFaces(faceList[, deleteCells])

This method removes faces from a solid entity or from a shell entity.

RemoveFacesAndStitch(faceList)

This method removes faces from a solid entity and attempts to close the resulting gap by extending the neighboring faces of the solid.

RemoveRedundantEntities([vertexList, ...])

This method removes redundant edges and vertices from a solid or a shell entity.

RepairFaceNormals([faceList])

This method works on the entire part or a sequence of shell faces.

RepairInvalidEdges(edgeList)

This method repairs invalid edges.

RepairSliver(face, point1, point2[, ...])

This method repairs the selected sliver from the selected face.

RepairSmallEdges(edgeList[, toleranceChecks])

This method repairs small edges.

RepairSmallFaces(faceList[, toleranceChecks])

This method repairs small faces.

ReplaceFaces(faceList[, stitch])

This method replaces the selected faces with a single face.

Round(radius, edgeList, vertexList)

This method creates an additional Feature object by rounding (filleting) the given list of entities with the given radius.

Shell(sketchPlane, sketchPlaneSide, ...[, ...])

This method creates an additional Feature object by creating a planar shell from the given ConstrainedSketch object.

ShellExtrude(sketchPlane, sketchPlaneSide, ...)

This method creates an additional Feature object by extruding the given ConstrainedSketch object by the given depth, creating a shell protrusion.

ShellLoft(loftsections[, startCondition, ...])

This method creates an additional Feature object by lofting between the given sections and adding shell faces to the part.

ShellRevolve(sketchPlane, sketchPlaneSide, ...)

This method creates an additional Feature object by revolving the given ConstrainedSketch object by the given angle, creating a shell protrusion.

ShellSweep(path, profile[, pathPlane, ...])

This method creates an additional Feature object by sweeping the given ConstrainedSketch object or a sequence of Edge objects along a path which may be a ConstrainedSketch or a sequence of Edge objects, creating a shell swept protrusion.

SolidExtrude(sketchPlane, sketchPlaneSide, ...)

This method creates an additional Feature object by extruding the given ConstrainedSketch object by the given depth, creating a solid protrusion.

SolidLoft(loftsections[, startCondition, ...])

This method creates an additional Feature object by lofting between the given sections and adding material to the part.

SolidRevolve(sketchPlane, sketchPlaneSide, ...)

This method creates an additional Feature object by revolving the given ConstrainedSketch object by the given angle, creating a solid protrusion.

SolidSweep(path, profile[, pathPlane, ...])

This method creates an additional Feature object by sweeping the given ConstrainedSketch object or a Face object along a path which may be a ConstrainedSketch or a sequence of Edge objects, creating a solid swept protrusion.

Stitch([edgeList, stitchTolerance])

This method attempts to create a valid part by binding together free and imprecise edges of all the faces of a part.

Wire(sketchPlane, sketchPlaneSide, ...[, ...])

This method creates an additional Feature object by creating a planar wire from the given ConstrainedSketch object.

WireSpline(points[, mergeType, ...])

This method creates an additional Feature object by creating a spline wire that passes through a sequence of given points.

WirePolyLine(points[, mergeType, meshable])

This method creates an additional Feature object by creating a polyline wire that passes through a sequence of given points.

WireFromEdge(edgeList)

This method creates an additional Feature object by creating a Wire by selecting one or more Edge objects of a Solid or Shell part.

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 polyline wire that passes through a sequence of given points.

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(*args, **kwargs)

This method modifies the Part object.

suppress()

This method suppresses features.


CompositeLayup(name, description='', offsetType=abaqusConstants.GLOBAL, offsetField='', offsetValues=0, elementType=abaqusConstants.SHELL, symmetric=OFF)[source]

This method creates a CompositeLayup object.

Note

This function can be accessed by:

mdb.models[name].parts[name].CompositeLayup
Parameters:
  • name (str) – A String specifying the repository key.

  • description (str, default: '') – A String specifying a description of the composite layup.

  • offsetType (SymbolicConstant, default: GLOBAL) – A SymbolicConstant specifying the method used to define the shell offset. If offsetType = OFFSET_FIELD the offsetField argument is required. This member is valid only if elementType = SHELL. Possible values are SINGLE_VALUE, MIDDLE_SURFACE, TOP_SURFACE, BOTTOM_SURFACE, OFFSET_FIELD, and GLOBAL. The default value is GLOBAL.

  • offsetField (str, default: '') – A String specifying The name of the field specifying the offset. This member is valid only if elementType = SHELL. The default value is an empty string.

  • offsetValues (float, default: 0) – A Float specifying The offset of the shell section. This member is valid only if elementType = SHELL. The default value is 0.0.

  • elementType (SymbolicConstant, default: SHELL) – A SymbolicConstant specifying the type of element in the composite layup. Possible values are SHELL, CONTINUUM_SHELL, and SOLID. The default value is SHELL.

  • symmetric (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether or not the layup should be made symmetric by the analysis. The default value is OFF.

Returns:

layup – A CompositeLayup object.

Return type:

CompositeLayup

Raises:

AbaqusException

MaterialOrientation(region=None, localCsys=None, axis=abaqusConstants.AXIS_1, angle=0, stackDirection=abaqusConstants.STACK_3, fieldName='', orientationType=abaqusConstants.GLOBAL, normalAxisDirection=abaqusConstants.AXIS_3, normalAxisDefinition=abaqusConstants.NORMAL_VECTOR, normalAxisRegion=None, normalAxisDatum=None, flipNormalDirection=OFF, normalAxisVector=(), primaryAxisDirection=abaqusConstants.AXIS_1, primaryAxisDefinition=abaqusConstants.PRIMARY_VECTOR, primaryAxisRegion=None, primaryAxisDatum=None, flipPrimaryDirection=OFF, primaryAxisVector=())[source]

This method creates a MaterialOrientation object.

Note

This function can be accessed by:

mdb.models[name].parts[name].MaterialOrientation
Parameters:
  • region (Optional[Set], default: None) – A Set object specifying a region for which the material orientation is defined.

  • localCsys (Optional[DatumCsys], default: None) – A DatumCsys object specifying the local coordinate system or None, describing the material orientation for the given region. In the ODB, this member was previously accessible using “csys,” but support has now been added for localCsys and the csys member will be deprecated.

  • axis (SymbolicConstant, default: AXIS_1) – A SymbolicConstant specifying the axis of a datum coordinate system about which an additional rotation is applied. For shells this axis is also the shell normal. Possible values are AXIS_1, AXIS_2, and AXIS_3. The default value is AXIS_1.

  • angle (float, default: 0) – A Float specifying the angle of the additional rotation (if accessed from the ODB instead of the MDB, it will be a string instead of a float). The default value is 0.0.

  • stackDirection (SymbolicConstant, default: STACK_3) – A SymbolicConstant specifying the stack or thickness direction. Possible values are STACK_1, STACK_2, STACK_3, and STACK_ORIENTATION. The default value is STACK_3.

  • fieldName (str, default: '') – A String specifying the name of the DiscreteField object specifying the orientation. The default value is an empty string.

  • orientationType (SymbolicConstant, default: GLOBAL) – A SymbolicConstant specifying the method used to define the material orientation. If orientationType = SYSTEM, the region and localCsys arguments are required. If orientationType = FIELD, the fieldName argument is required. Possible values are GLOBAL, SYSTEM, FIELD, DISCRETE, and USER. The default value is GLOBAL.

  • normalAxisDirection (SymbolicConstant, default: AXIS_3) – A SymbolicConstant specifying the axis that is defined by the normal axis direction for a discrete orientation. Possible values are AXIS_1, AXIS_2, and AXIS_3. The default value is AXIS_3.

  • normalAxisDefinition (SymbolicConstant, default: NORMAL_VECTOR) – A SymbolicConstant specifying the method used to define the normal axis direction for a discrete orientation. Possible values are SURFACE, NORMAL_DATUM, and NORMAL_VECTOR. The default value is NORMAL_VECTOR.

  • normalAxisRegion (Optional[Surface], default: None) – A Surface object specifying a region whose geometric normals define the normal axis for the discrete orientation.

  • normalAxisDatum (Optional[DatumAxis], default: None) – A DatumAxis object specifying the Datum Axis or None, describing the normal axis direction for the discrete orientation.

  • flipNormalDirection (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying the flag to reverse the direction of the defined normal axis direction. The default value is OFF.

  • normalAxisVector (tuple, default: ()) – A sequence of Floats specifying the vector that defines the direction of the normal axis of the discrete orientation.

  • primaryAxisDirection (SymbolicConstant, default: AXIS_1) – A SymbolicConstant specifying the axis that is defined by the primary axis direction for a discrete orientation. Possible values are AXIS_1, AXIS_2, and AXIS_3. The default value is AXIS_1.

  • primaryAxisDefinition (SymbolicConstant, default: PRIMARY_VECTOR) – A SymbolicConstant specifying the method used to define the primary axis direction for a discrete orientation. Possible values are SURFACE, PRIMARY_DATUM, and PRIMARY_VECTOR. The default value is PRIMARY_VECTOR.

  • primaryAxisRegion (Optional[Set], default: None) – A Set object specifying a region whose geometric tangents define the primary axis for the discrete orientation.

  • primaryAxisDatum (Optional[DatumAxis], default: None) – A DatumAxis object specifying the Datum Axis or None, describing the primary axis direction for the discrete orientation.

  • flipPrimaryDirection (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying the flag to reverse the direction of the defined primary axis direction. The default value is OFF.

  • primaryAxisVector (tuple, default: ()) – A sequence of Floats specifying the vector that defines the direction of the primary axis of the discrete orientation.

Returns:

orientation – A MaterialOrientation object.

Return type:

MaterialOrientation

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

assignment – A SectionAssignment object

Return type:

SectionAssignment

assignBeamSectionOrientation(region, method, n1)[source]

This method assigns a beam section orientation to a region of a part.

Note

This function can be accessed by:

mdb.models[name].parts[name].assignBeamSectionOrientation
Parameters:
  • region (tuple) – A sequence of geomSequences of Edge objects or a sequence of sequences of one-dimensional elements.

  • method (SymbolicConstant) – A SymbolicConstant specifying the assignment method. Only a value of N1_COSINES is currently supported.

  • n1 (tuple) – A sequence of three Floats specifying the approximate local n1n1-direction of the beam cross-section.

assignMaterialOrientation(region, localCsys, axis=abaqusConstants.AXIS_1, angle=0)[source]

This method assigns a material orientation to a region.

Note

This function can be accessed by:

mdb.models[name].parts[name].assignMaterialOrientation
Parameters:
  • region (tuple) – A sequence of geomSequences of ConstrainedSketchVertex, Edge, Face, and Cell objects or a sequence of sequences of elements.

  • localCsys (Datum) – A Datum object specifying the local coordinate system or None, indicating the global coordinate system.

  • axis (SymbolicConstant, default: AXIS_1) – A SymbolicConstant specifying the axis of a cylindrical or spherical datum coordinate system about which an additional rotation is applied. For shells this axis is also the shell normal. Possible values are AXIS_1, AXIS_2, and AXIS_3. The default value is AXIS_1.

  • angle (float, default: 0) – A Float specifying the angle of the additional rotation. The default value is 0.0.

assignRebarOrientation(region, localCsys, axis=abaqusConstants.AXIS_1, angle=0)[source]

This method assigns a rebar reference orientation to a region.

Note

This function can be accessed by:

mdb.models[name].parts[name].assignRebarOrientation
Parameters:
  • region (tuple) – A sequence of geomSequences of ConstrainedSketchVertex, Edge, Face, and Cell objects or a sequence of sequences of elements.

  • localCsys (Datum) – A Datum object specifying the local coordinate system or None, indicating the global coordinate system.

  • axis (SymbolicConstant, default: AXIS_1) – A SymbolicConstant specifying the axis of a cylindrical or spherical datum coordinate system about which an additional rotation is applied. For shells this axis is also the shell normal. Possible values are AXIS_1, AXIS_2, and AXIS_3. The default value is AXIS_1.

  • angle (float, default: 0) – A Float specifying the angle of the additional rotation. The default value is 0.0.

flipNormal(regions, referenceRegion='')[source]

This method flips the normals of shell or membrane elements of an orphan mesh or of two-dimensional geometric regions.

Note

This function can be accessed by:

mdb.models[name].parts[name].flipNormal
Parameters:
  • regions (Region) – A Region object specifying the region on which normals are flipped. For 3D parts, the region contains Face objects or two-dimensional triangle or quadrilateral Element objects. For axisymmetric parts, the region contains Edge objects or line Elements objects.

  • referenceRegion (str, default: '') – A two-dimensional element object whose normal is to be matched. If unspecified, all the normals associated with the given regions will be flipped. The referenceRegion argument is applicable only if the argument regions contain a sequence of quadrilateral or triangular elements.

flipTangent(regions)[source]

This method flips the tangents of beam or truss elements of an orphan mesh or of one-dimensional geometric regions.

Note

This function can be accessed by:

mdb.models[name].parts[name].flipTangent
Parameters:

regions (Region) – A Region object specifying the region on which normals are flipped. The region contains Edge objects or one-dimensional Element objects.

unassignBeamSectionOrientation(index)[source]

This method deletes a beam section orientation assignment.

Note

This function can be accessed by:

mdb.models[name].parts[name].unassignBeamSectionOrientation
Parameters:

index (int) – An Int specifying the number of the beam section orientation assignment to be deleted.

unassignMaterialOrientation(index)[source]

This method deletes a material orientation assignment.

Note

This function can be accessed by:

mdb.models[name].parts[name].unassignMaterialOrientation
Parameters:

index (int) – An Int specifying the number of the material assignment to be deleted.

unassignRebarOrientation(index)[source]

This method deletes a rebar orientation assignment.

Note

This function can be accessed by:

mdb.models[name].parts[name].unassignRebarOrientation
Parameters:

index (int) – An Int specifying the number of the rebar reference orientation assignment to be deleted.

RegionPart#

class RegionPart(name: str, dimensionality: SymbolicConstant, type: SymbolicConstant, twist: Union[AbaqusBoolean, bool] = OFF)[source]
class RegionPart(name: str, objectToCopy: str, scale: float = 1, mirrorPlane: SymbolicConstant = NONE, compressFeatureList: Union[AbaqusBoolean, bool] = OFF, separate: Union[AbaqusBoolean, bool] = OFF)

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

Note

This object can be accessed by:

import regionToolset

Public Data Attributes:

Inherited from PartBase

geometryValidity

A Boolean specifying the validity of the geometry of the part.

isOutOfDate

An Int specifying that feature parameters have been modified but that the part has not been regenerated.

timeStamp

A Float specifying when the part was last modified.

vertices

A VertexArray object specifying all the vertices in the part.

ignoredVertices

An IgnoredVertexArray object specifying all the ignored vertices in the part.

edges

An EdgeArray object specifying all the edges in the part.

ignoredEdges

An IgnoredEdgeArray object specifying all the ignored edges in the part.

faces

A FaceArray object specifying all the faces in the part.

cells

A CellArray object specifying all the cells in the part.

features

A repository of Feature objects specifying all the features in the part.

featuresById

A repository of Feature objects specifying all Feature objects in the part.

datums

A repository of Datum objects specifying all the datums in the part.

elements

A MeshElementArray object specifying all the elements in the part.

elemFaces

A repository of MeshFace objects specifying all the element faces in the part.

elementFaces

A MeshFaceArray object specifying all the unique element faces in the part.

nodes

A MeshNodeArray object specifying all the nodes in the part.

retainedNodes

A MeshNodeArray object specifying all the retained nodes in the substructure part.

sets

A repository of Set objects specifying for more information, see Set.

allSets

A repository of Set objects specifying the contents of the allSets repository is the same as the contents of the sets repository.

allInternalSets

A repository of Set objects specifying picked regions.

surfaces

A repository of Surface objects specifying for more information, see Surface.

allSurfaces

A repository of Surface objects specifying the contents of the allSurfaces repository is the same as the contents of the surfaces repository.

allInternalSurfaces

A repository of Surface objects specifying picked regions.

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.

referencePoints

A repository of ReferencePoint objects.

engineeringFeatures

An EngineeringFeature object.

sectionAssignments

A SectionAssignmentArray object.

materialOrientations

A MaterialOrientationArray object.

compositeLayups

A repository of CompositeLayup objects.

elemEdges

A repository of MeshEdge objects specifying all the element edges in the part.

elementEdges

A MeshEdgeArray object specifying all the unique element edges in the part.

Inherited from Feature

name

A String specifying the repository key.

id

An Int specifying the ID of the feature.

Public Methods:

Surface([side1Faces, side2Faces, ...])

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

Set([skinFaces, skinEdges, stringerEdges])

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

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

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

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

This method modifies underlying entities of the selected skin.

Stringer(name[, edges, elementEdges])

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

Inherited from RegionPartBase

clashSets(arg1, arg2)

This command prints a message describing the relationship between the contents of two sets.

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.

deleteSets(setNames)

This command deletes the given sets from the part.

deleteSurfaces(surfaceNames)

This command deletes the given surfaces from the part.

Inherited from PartBase

__init__(*args, **kwargs)

PartFromBooleanCut(name, instanceToBeCut, ...)

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

PartFromBooleanMerge(name, instances[, ...])

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

PartFromExtrude2DMesh(name, part, depth, ...)

This method creates a Part object by extruding an existing two-dimensional orphan mesh Part object in the positive Z-direction and places it in the parts repository.

PartFromGeometryFile(name, geometryFile, ...)

This method creates a Part object and places it in the parts repository.

PartFromInstanceMesh(name[, partInstances, ...])

This method creates a Part object containing the mesh found in the supplied PartInstance objects and places the new Part object in the parts repository.

PartFromMesh(name[, copySets])

This method creates a Part object containing the mesh found in the part and places the new Part object in the parts repository.

PartFromMeshMirror(name, part, point1, point2)

This method creates a Part object by mirroring an existing orphan mesh Part object about a specified plane and places it in the parts repository.

PartFromNodesAndElements(name, ...[, twist])

This method creates a Part object from nodes and elements and places it in the parts repository.

PartFromOdb(name, odb[, fileName, instance, ...])

This method creates an orphan mesh Part object by reading an output database.

PartFromSection3DMeshByPlane(name, part, ...)

This method creates a Part object by cutting an existing three-dimensional orphan mesh Part object by a plane and places it in the parts repository.

PartFromSubstructure(name, substructureFile, ...)

This method creates a substructure Part object by reading a substructure sim file and places it in the parts repository.

Part2DGeomFrom2DMesh(name, part, featureAngle)

This method creates a geometric Part object from the outline of an existing two-dimensional orphan mesh Part object and places it in the parts repository.

setValues(*args, **kwargs)

This method modifies the Part object.

addGeomToSketch(sketch)

This method converts a part into a sketch by projecting all of the edges of the part onto the X-Y plane of the sketch.

assignThickness(faces[, thickness, ...])

This method assigns thickness data to shell faces.

backup()

This method makes a backup copy of the features in the part.

checkGeometry([detailed, reportFacetErrors, ...])

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

clearGeometryCache()

This method clears the geometry cache.

deleteAllFeatures()

This method deletes all the features in the part.

deleteFeatures(featureNames)

This method deletes the given features.

getAngle(plane1, plane2, line1, line2[, ...])

This method returns the angle between the specified entities.

getArea(faces[, relativeAccuracy])

This method returns the total surface area of a given face or group of faces.

getAssociatedCADPaths()

This method returns the paths to the associated CAD part and root file.

getCADParameters()

This method returns the names and values of the CAD parameters associated with the part.

getCentroid(faces, cells[, relativeAccuracy])

Location of the centroid of a given face/cell or group of faces/cells

getCoordinates(entity, csys)

This method returns the coordinates of specified point.

getCurvature(edges[, samplePoints])

This method returns the maximum curvature of a given edge or group of edges.

getDistance(entity1, entity2)

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

getLength(edges)

This method returns the length of a given edge or group of edges.

getPerimeter(faces)

This method returns the total perimeter of a given face or group of faces.

getVolume(cells[, relativeAccuracy])

This method returns the volume area of a given cell or group of cells.

getMassProperties([regions, ...])

This method returns the mass properties of a part or region.

getFeatureFaces(name)

This method returns a sequence of Face objects that are created by the given feature.

getFeatureEdges(name)

This method returns a sequence of Edge objects that are created by the given feature.

getFeatureCells(name)

This method returns a sequence of Cell objects that are created by the given feature.

getFeatureVertices(name)

This method returns a sequence of ConstrainedSketchVertex objects that are created by the given feature.

isAlignedWithSketch()

This method checks if the normal of an analytical rigid surface part is aligned with that of its sketch.

printAssignedSections()

This method prints information on each section that has been assigned to a region of the part.

projectEdgesOntoSketch(sketch, edges[, ...])

This method projects the selected edges of a part onto the specified ConstrainedSketch object.

projectReferencesOntoSketch(sketch[, ...])

This method projects the vertices of specified edges, and datum points from the part onto the specified ConstrainedSketch object.

queryAttributes([printResults])

This method prints the following information about a part:

queryCachedStates()

This method displays the position of geometric states relative to the sequence of features in the part cache.

queryGeometry([relativeAccuracy, printResults])

This method prints the following information about a part:

queryRegionsMissingSections()

This method returns all regions in the part that do not have a section assignment but require one for analysis.

queryDisjointPlyRegions()

This method provides a list of all composite plys in the current part which have disjoint regions.

regenerate()

This method regenerates a part.

regenerationWarnings()

This method prints any regeneration warnings associated with the features.

removeInvalidGeometry()

Removes all invalid entities from the part, leaving a valid part.

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.

resumeFeatures(featureNames)

This method resumes the specified suppressed features in the part.

resumeLastSetFeatures()

This method resumes the last set of features to be suppressed in the part.

saveGeometryCache()

This method caches the current geometry.

setAssociatedCADPaths([partFile, rootFile])

This method sets the paths to the associated CAD part and root file.

suppressFeatures(featureNames)

This method suppresses the given features.

writeAcisFile(fileName[, version])

This method exports the geometry of the part to a named file in ACIS format.

writeCADParameters(paramFile[, ...])

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

writeIgesFile(fileName, flavor)

This method exports the geometry of the part to a named file in IGES format.

writeStepFile(fileName)

This method exports the geometry of the part to a named file in STEP format.

writeVdaFile(fileName)

This method exports the geometry of the part to a named file in VDA-FS format.

copyMeshPattern(elements, faces, elemFaces, ...)

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

Lock()

This method locks the part.

Unlock()

This method unlocks the part.

LockForUpgrade()

This method locks the part for upgrade.

Inherited from PartFeature

AutoRepair()

This method carries out a sequence of geometry repair operations if it contains invalid entities.

AddCells(faceList[, flipped])

This method tries to convert a shell entity to a solid entity.

AnalyticRigidSurf2DPlanar(sketch)

This method creates a first Feature object for an analytical rigid surface by creating a planar wire from the given ConstrainedSketch object.

AnalyticRigidSurfExtrude(sketch[, depth])

This method creates a first Feature object for an analytical rigid surface by extruding the given ConstrainedSketch object by the given depth, creating a surface.

AnalyticRigidSurfRevolve(sketch)

This method creates a first Feature object for an analytical rigid surface by revolving the given ConstrainedSketch object by 360° about the Y-axis.

AssignMidsurfaceRegion(cellList)

This method assign a mid-surface property to sequence of Cell objects.

BaseSolidExtrude(sketch, depth[, ...])

This method creates a first Feature object by extruding the given ConstrainedSketch object by the given depth, creating a solid.

BaseSolidRevolve(sketch, angle[, pitch, ...])

This method creates a first Feature object by revolving the given ConstrainedSketch object by the given angle, creating a solid.

BaseSolidSweep(sketch, path)

This method creates a first Feature object by sweeping the given profile ConstrainedSketch object along the path defined by the path ConstrainedSketch object, creating a solid.

BaseShell(sketch)

This method creates a first Feature object by creating a planar shell from the given ConstrainedSketch object.

BaseShellExtrude(sketch, depth[, ...])

This method creates a first Feature object by extruding the given ConstrainedSketch object by the given depth, creating a shell.

BaseShellRevolve(sketch, angle[, pitch, ...])

This method creates a first Feature object by revolving the given ConstrainedSketch object by the given angle, creating a shell.

BaseShellSweep(sketch, path)

This method creates a first Feature object by sweeping the given section ConstrainedSketch object along the path defined by the path ConstrainedSketch object, creating a shell.

BaseWire(sketch)

This method creates a first Feature object by creating a planar wire from the given ConstrainedSketch object.

BlendFaces(side1, side2[, method, path])

This method creates a Feature object by creating new faces that blends two sets of faces.

Chamfer(length, edgeList)

This method creates an additional Feature object by chamfering the given list of edges with a given length.

Mirror(mirrorPlane, keepOriginal[, ...])

This method mirrors existing part geometry across a plane to create new geometry.

ConvertToAnalytical()

This method attempts to change entities into a simpler form that will speed up processing and make entities available during feature operations.

ConvertToPrecise([method])

This method attempts to change imprecise entities so that the geometry becomes precise.

CoverEdges(edgeList[, tryAnalytical])

This method generates a face using the given edges as the face's boundaries.

Cut(sketchPlane, sketchPlaneSide, ...[, ...])

This method creates an additional Feature object by cutting a hole using the given ConstrainedSketch object.

CutExtrude(sketchPlane, sketchPlaneSide, ...)

This method creates an additional Feature object by extruding the given ConstrainedSketch object by the given depth and cutting away material in the solid and shell regions of the part.

CutLoft(loftsections[, startCondition, ...])

This method creates an additional Feature object by lofting between the given sections and cutting away material from the part.

CutRevolve(sketchPlane, sketchPlaneSide, ...)

This method creates an additional Feature object by revolving the given ConstrainedSketch object by the given angle and cutting away material from the part.

CutSweep(path, profile[, pathPlane, ...])

This method creates an additional Feature object by sweeping the given ConstrainedSketch object along a path which may be a ConstrainedSketch or a sequence of Edge objects and cutting away material from the part.

ExtendFaces([faces, extendAlong, distance, ...])

This method extends faces along its free edges by offsetting the external edges along the surfaces.

FaceFromElementFaces(elementFaces[, stitch, ...])

This method creates a geometry face from a collection of orphan element faces.

HoleBlindFromEdges(plane, planeSide, ...)

This method creates an additional Feature object by creating a circular blind hole of the given diameter and depth and cutting away material in the solid and shell regions of the part.

HoleFromEdges(diameter, edge1, distance1, ...)

This method creates an additional Feature object by creating a circular hole of the given diameter in a 2D planar part and cutting away material in the shell and wire regions of the part.

HoleThruAllFromEdges(plane, planeSide, ...)

This method creates an additional Feature object by creating a circular through hole of the given diameter and cutting away material in the solid and shell regions of the part.

MergeEdges([edgeList, extendSelection])

This method merges edges either by extending the user selection or using only the selected edges.

OffsetFaces(faceList[, distance, ...])

This method creates new faces by offsetting existing faces.

RemoveCells(cellList)

This method converts a solid entity to a shell entity.

RemoveFaces(faceList[, deleteCells])

This method removes faces from a solid entity or from a shell entity.

RemoveFacesAndStitch(faceList)

This method removes faces from a solid entity and attempts to close the resulting gap by extending the neighboring faces of the solid.

RemoveRedundantEntities([vertexList, ...])

This method removes redundant edges and vertices from a solid or a shell entity.

RepairFaceNormals([faceList])

This method works on the entire part or a sequence of shell faces.

RepairInvalidEdges(edgeList)

This method repairs invalid edges.

RepairSliver(face, point1, point2[, ...])

This method repairs the selected sliver from the selected face.

RepairSmallEdges(edgeList[, toleranceChecks])

This method repairs small edges.

RepairSmallFaces(faceList[, toleranceChecks])

This method repairs small faces.

ReplaceFaces(faceList[, stitch])

This method replaces the selected faces with a single face.

Round(radius, edgeList, vertexList)

This method creates an additional Feature object by rounding (filleting) the given list of entities with the given radius.

Shell(sketchPlane, sketchPlaneSide, ...[, ...])

This method creates an additional Feature object by creating a planar shell from the given ConstrainedSketch object.

ShellExtrude(sketchPlane, sketchPlaneSide, ...)

This method creates an additional Feature object by extruding the given ConstrainedSketch object by the given depth, creating a shell protrusion.

ShellLoft(loftsections[, startCondition, ...])

This method creates an additional Feature object by lofting between the given sections and adding shell faces to the part.

ShellRevolve(sketchPlane, sketchPlaneSide, ...)

This method creates an additional Feature object by revolving the given ConstrainedSketch object by the given angle, creating a shell protrusion.

ShellSweep(path, profile[, pathPlane, ...])

This method creates an additional Feature object by sweeping the given ConstrainedSketch object or a sequence of Edge objects along a path which may be a ConstrainedSketch or a sequence of Edge objects, creating a shell swept protrusion.

SolidExtrude(sketchPlane, sketchPlaneSide, ...)

This method creates an additional Feature object by extruding the given ConstrainedSketch object by the given depth, creating a solid protrusion.

SolidLoft(loftsections[, startCondition, ...])

This method creates an additional Feature object by lofting between the given sections and adding material to the part.

SolidRevolve(sketchPlane, sketchPlaneSide, ...)

This method creates an additional Feature object by revolving the given ConstrainedSketch object by the given angle, creating a solid protrusion.

SolidSweep(path, profile[, pathPlane, ...])

This method creates an additional Feature object by sweeping the given ConstrainedSketch object or a Face object along a path which may be a ConstrainedSketch or a sequence of Edge objects, creating a solid swept protrusion.

Stitch([edgeList, stitchTolerance])

This method attempts to create a valid part by binding together free and imprecise edges of all the faces of a part.

Wire(sketchPlane, sketchPlaneSide, ...[, ...])

This method creates an additional Feature object by creating a planar wire from the given ConstrainedSketch object.

WireSpline(points[, mergeType, ...])

This method creates an additional Feature object by creating a spline wire that passes through a sequence of given points.

WirePolyLine(points[, mergeType, meshable])

This method creates an additional Feature object by creating a polyline wire that passes through a sequence of given points.

WireFromEdge(edgeList)

This method creates an additional Feature object by creating a Wire by selecting one or more Edge objects of a Solid or Shell part.

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 polyline wire that passes through a sequence of given points.

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(*args, **kwargs)

This method modifies the Part object.

suppress()

This method suppresses features.


EditSkin(name='', faces=(), edges=(), elementFaces=(), elementEdges=())[source]

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

Note

This function can be accessed by:

mdb.models[name].parts[name].EditSkin
Parameters:
  • name (str, default: '') – A String specifying the repository key. The default value is an empty string.

  • faces (Tuple[Face, ...], default: ()) – A sequence of Face objects specifying the faces on which skins should be created. Applicable to three and two-dimensional parts.

  • edges (Tuple[Edge, ...], default: ()) – A sequence of Edge objects specifying the edges on which skins should be created. Applicable to axisymmetric parts.

  • elementFaces (Tuple[MeshFace, ...], default: ()) – A sequence of MeshFace objects specifying the mesh faces on which skins should be created. Applicable to three and two-dimensional parts.

  • elementEdges (Tuple[MeshEdge, ...], default: ()) – A sequence of MeshEdge objects specifying the mesh edges on which skins should be created. Applicable to axisymmetric parts.

Returns:

skin – A Skin object

Return type:

Skin

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

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

Note

This function can be accessed by:

mdb.models[name].parts[name].Set
mdb.models[name].rootAssembly.Set
Parameters:

name

Returns:

set – A Set object

Return type:

Set

Skin(name, faces=(), edges=(), elementFaces=(), elementEdges=())[source]

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

Note

This function can be accessed by:

mdb.models[name].parts[name].Skin
Parameters:
  • name (str) – A String specifying the repository key. The default value is an empty string.

  • faces (Tuple[Face, ...], default: ()) – A sequence of Face objects specifying the faces on which skins should be created. Applicable to three and two-dimensional parts.

  • edges (Tuple[Edge, ...], default: ()) – A sequence of Edge objects specifying the edges on which skins should be created. Applicable to axisymmetric parts.

  • elementFaces (Tuple[MeshFace, ...], default: ()) – A sequence of MeshFace objects specifying the mesh faces on which skins should be created. Applicable to three and two-dimensional parts.

  • elementEdges (Tuple[MeshEdge, ...], default: ()) – A sequence of MeshEdge objects specifying the mesh edges on which skins should be created. Applicable to axisymmetric parts.

Returns:

skin – A Skin object

Return type:

Skin

Stringer(name, edges=(), elementEdges=())[source]

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

Note

This function can be accessed by:

mdb.models[name].parts[name].Stringer
Parameters:
  • name (str) – A String specifying the repository key. The default value is an empty string.

  • edges (Tuple[Edge, ...], default: ()) – A sequence of Edge objects specifying the edges on which stringers should be created. Applicable to three and two-dimensional parts.

  • elementEdges (Tuple[MeshEdge, ...], default: ()) – A sequence of MeshEdge objects specifying the mesh edges on which stringers should be created. Applicable to three and two-dimensional parts.

Returns:

stringer – A Stringer object

Return type:

Stringer

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='', **kwargs)[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
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:

surf – A Surface object

Return type:

Surface

AcisFile#

class AcisFile[source]#

The AcisFile object is a file object used to open ACIS-, STEP-, and IGES-format files.

Note

This object can be accessed by:

import part

Public Data Attributes:

numberOfParts

An Int specifying the number of parts in the object.

Public Methods:

openAcis(fileName[, scaleFromFile])

This method creates an AcisFile object from a file containing ACIS-format geometry.

openCatia(fileName[, topology, ...])

This method creates an AcisFile object from a file containing V5-format geometry.

openEnf(fileName, fileType[, topology, ...])

This method creates an AcisFile object from a file containing Elysium Neutral File-format geometry that was created by CATIA V5, I-DEAS, or Pro/ENGINEER.

openIges(fileName[, trimCurve, ...])

This method creates an AcisFile object from a file containing IGES-format geometry.

openParasolid(fileName[, topology])

This method creates an AcisFile object from a file containing Parasolid-format geometry.

openStep(fileName[, scale])

This method creates an AcisFile object from a file containing STEP-format geometry.

openVda(fileName)

This method creates an AcisFile object from a file containing VDA-FS-format geometry.

openSolidworks(fileName[, topology])

This method creates an AcisFile object from a file containing Solidworks format geometry.

writeAcisFile(fileName[, version])

This method exports the assembly to a named file in ACIS format.


numberOfParts: Optional[int] = None[source]#

An Int specifying the number of parts in the object.

openAcis(fileName, scaleFromFile=OFF)[source]#

This method creates an AcisFile object from a file containing ACIS-format geometry. This object is subsequently used by the PartFromGeometryFile method.

Note

This function can be accessed by:

mdb.openAcis
Parameters:
  • fileName (str) – A String specifying the path to the ACIS file to open.

  • scaleFromFile (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to scale, rotate, and translate the part using the transform read from the ACIS file. The default value is OFF.

Returns:

An AcisFile object.

Return type:

AcisFile

Raises:
  • Texterror – File is from a newer version of ACIS than the CAE kernel.

  • Texterror – The data in the ACIS file are corrupted.

openCatia(fileName, topology=None, convertUnits=OFF, combineBodies=OFF)[source]#

This method creates an AcisFile object from a file containing V5-format geometry. This object is subsequently used by the PartFromGeometryFile method.

Note

This function can be accessed by:

mdb.openAcis
Parameters:
  • fileName (str) – A String specifying the path to the CATIA file to open.

  • topology (Optional[SymbolicConstant], default: None) – A SymbolicConstant specifying the topology of the data to be read from the file and of the part to be created. Possible values are SOLID , SHELL, and WIRE. If topology = SOLID, Abaqus/CAE attempts to attach cells to create a solid. If topology = SHELL, Abaqus/CAE builds the body as a shell entity and not as a solid entity. The default value is SOLID .

  • convertUnits (SymbolicConstant, default: OFF) – A SymbolicConstant specifying whether the original units should be retained. Possible values are ON and OFF. The default value is OFF.

  • combineBodies (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to combine the bodies in the CATPart file. If the bodies to be combined touch or overlap, invalid entities would result. For CATProduct files, this option will be ignored.

Returns:

An AcisFile object.

Return type:

AcisFile

openEnf(fileName, fileType, topology=abaqusConstants.SOLID, convertUnits=OFF)[source]#

This method creates an AcisFile object from a file containing Elysium Neutral File-format geometry that was created by CATIA V5, I-DEAS, or Pro/ENGINEER. This object is subsequently used by the PartFromGeometryFile method.

Note

This function can be accessed by:

mdb.openAcis
Parameters:
  • fileName (str) – A String specifying the path to the Elysium Neutral File that was created by I-DEAS, Pro/ENGINEER, or CATIA V5.

  • fileType (str) – A String specifying the type of CAD system that created the file. Possible values are “ideas”, “proe”, or “catiav5” or a combination similar to “proe/ideas/catiav5” if the type is unknown.

  • topology (SymbolicConstant, default: SOLID) – A SymbolicConstant specifying the topology of the data to be read from the file and of the part to be created. Possible values are SOLID , SHELL, and WIRE. If topology = SOLID, Abaqus/CAE attempts to attach cells to create a solid. If topology = SHELL, Abaqus/CAE builds the body as a shell entity and not as a solid entity. The default value is SOLID.

  • convertUnits (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying if the dimensions of the part should be converted to millimeters. The default value is OFF.

Returns:

An AcisFile object.

Return type:

AcisFile

openIges(fileName, trimCurve=abaqusConstants.DEFAULT, scaleFromFile=OFF, msbo=False, includedLayers=(), topology=abaqusConstants.SOLID, uniteWires=ON)[source]#

This method creates an AcisFile object from a file containing IGES-format geometry. This object is subsequently used by the PartFromGeometryFile method.

Note

This function can be accessed by:

mdb.openAcis
Parameters:
  • fileName (str) – A String specifying the path to the IGES file to open.

  • trimCurve (SymbolicConstant, default: DEFAULT) – A SymbolicConstant specifying the method used to define the trim curves that bound parametric surfaces. Possible values are:DEFAULT, use either of the following as specified by the contents of the IGES file.PARAMETRIC_DATA, use the parameter space of the surface being trimmed.THREED_DATA, use real space—the coordinate system of the part along with an indication that the trim curve lies on the parametric surface.The default value is DEFAULT.

  • scaleFromFile (SymbolicConstant, default: OFF) – A SymbolicConstant specifying whether the imported geometry needs to be scaled using the units information available in the IGES file. Possible values are ON and OFF. The default value is OFF. When the argument is set to ON, the geometry is scaled to millimeters with respect to the unit system specified in the IGES file.

  • msbo (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying if the IGES file contains MSBO (Manifold Solid B-Rep Object) entities. The default value is False.

  • includedLayers (tuple, default: ()) – A sequence of Ints specifying the levels or layers of entities that will be translated from the IGES file to build the part. The default is to include all the layers.

  • topology (SymbolicConstant, default: SOLID) – A SymbolicConstant specifying the topology of the data to be read from the file and of the part to be created. Possible values are SOLID , SHELL, and WIRE. If topology = SOLID, Abaqus/CAE attempts to attach cells to create a solid. If topology = SHELL, Abaqus/CAE builds the body as a shell entity and not as a solid entity. The default value is SOLID.

  • uniteWires (SymbolicConstant, default: ON) – A SymbolicConstant specifying whether the imported wires need to be united or not. Possible values are ON and OFF. The default value is ON. When importing a sketch, this value is set to OFF.

Returns:

An AcisFile object.

Return type:

AcisFile

Raises:

Texterror – The data in the IGES file are corrupted.

openParasolid(fileName, topology=abaqusConstants.SOLID)[source]#

This method creates an AcisFile object from a file containing Parasolid-format geometry. This object is subsequently used by the PartFromGeometryFile method.

Note

This function can be accessed by:

mdb.openAcis
Parameters:
  • fileName (str) – A String specifying the path to the Parasolid file to open.

  • topology (SymbolicConstant, default: SOLID) – A SymbolicConstant specifying the topology of the data to be read from the file and of the part to be created. Possible values are SOLID , SHELL, and WIRE. If topology = SOLID, Abaqus/CAE attempts to attach cells to create a solid. If topology = SHELL, Abaqus/CAE builds the body as a shell entity and not as a solid entity. The default value is SOLID.

Returns:

An AcisFile object.

Return type:

AcisFile

openSolidworks(fileName, topology=abaqusConstants.SOLID)[source]#

This method creates an AcisFile object from a file containing Solidworks format geometry. This object is subsequently used by the PartFromGeometryFile method.

Note

This function can be accessed by:

mdb.openAcis

New in version 2020: The openSolidworks method was added.

Parameters:
  • fileName (str) – A String specifying the path to the Solidworks file to open.

  • topology (SymbolicConstant, default: SOLID) – A SymbolicConstant specifying the topology of the data to be read from the file and of the part to be created. Possible values are SOLID, SHELL, and WIRE. If topology = SOLID, Abaqus/CAE attempts to attach cells to create a solid entity. If topology = SHELL, Abaqus/CAE builds the body as a shell entity, not as a solid entity. The default value is SOLID.

Return type:

An AcisFile object.

Raises:

Texterror – The data in the Solidworks file are corrupted.

openStep(fileName, scale=1)[source]#

This method creates an AcisFile object from a file containing STEP-format geometry. This object is subsequently used by the PartFromGeometryFile method.

Note

This function can be accessed by:

mdb.openAcis
Parameters:
  • fileName (str) – A String specifying the path to the STEP file to open.

  • scale (float, default: 1) – A Float specifying the scaling factor to apply to the imported geometric entities. The default value is 1.0.

Returns:

An AcisFile object.

Return type:

AcisFile

Raises:

Texterror – The data in the STEP file are corrupted.

openVda(fileName)[source]#

This method creates an AcisFile object from a file containing VDA-FS-format geometry. This object is subsequently used by the PartFromGeometryFile method.

Note

This function can be accessed by:

mdb.openAcis
Parameters:

fileName (str) – A String specifying the path to the VDA-FS file to open.

Returns:

An AcisFile object.

Return type:

AcisFile

Raises:

Texterror – The data in the VDA-FS file are corrupted.

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

This method exports the assembly to a named file in ACIS format.

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.

    Changed in version 2018: Add description for thr file name’s extension.

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

AcisMdb#

class AcisMdb(pathName='')[source]

The Mdb object is the high-level Abaqus model database. A model database stores models and analysis controls.

Note

This object can be accessed by:

mdb

Public Data Attributes:

Inherited from MdbBase

version

An Int specifying the release number of the Mdb object in memory.

lastChangedCount

A Float specifying the value of a counter associated with the Mdb object.

jobs

A repository of Job objects.

adaptivityProcesses

A repository of AdaptivityProcess objects.

coexecutions

A repository of Coexecution objects.

optimizationProcesses

A repository of OptimizationProcess objects.

meshEditOptions

A MeshEditOptions object specifying the undo/redo behavior when editing meshes on parts or part instances.

models

A repository of Model objects.

customData

A RepositorySupport object.

annotations

A repository of Annotation objects.

Public Methods:

openAcis(fileName[, scaleFromFile])

This method creates an AcisFile object from a file containing ACIS-format geometry.

openCatia(fileName[, topology, ...])

This method creates an AcisFile object from a file containing V5-format geometry.

openEnf(fileName, fileType[, topology, ...])

This method creates an AcisFile object from a file containing Elysium Neutral File-format geometry that was created by CATIA V5, I-DEAS, or Pro/ENGINEER.

openIges(fileName[, trimCurve, ...])

This method creates an AcisFile object from a file containing IGES-format geometry.

openParasolid(fileName[, topology])

This method creates an AcisFile object from a file containing Parasolid-format geometry.

openStep(fileName[, scale])

This method creates an AcisFile object from a file containing STEP-format geometry.

openVda(fileName)

This method creates an AcisFile object from a file containing VDA-FS-format geometry.

openSolidworks(fileName[, topology])

This method creates an AcisFile object from a file containing Solidworks format geometry.

Inherited from MdbBase

__init__([pathName])

This constructor creates an empty Mdb object.

importDxf(fileName)

This method creates a ConstrainedSketch object from a file containing dxf-format (AutoCAD) geometry.

openMdb(pathName)

This method opens an existing model database file.

close()

This method closes an open Mdb object but does not save the Mdb object to disk.

save()

This method saves an Mdb object to disk at the location specified by pathName (pathName is a member of the Mdb object).

saveAs(pathName)

This method saves an Mdb object to disk at the specified location.

openAuxMdb(pathName)

This method opens an auxiliary Mdb object on the disk at the specified location.

closeAuxMdb()

This method closes the auxiliary Mdb which had been opened earlier using the openAuxMdb command.

getAuxMdbModelNames()

This method returns a list of model names present in the auxiliary Mdb which had been opened earlier using the openAuxMdb command.

copyAuxMdbModel(fromName[, toName])

This method copies a specified model from the auxiliary Mdb which had been opened earlier using the openAuxMdb command.


static openAcis(fileName, scaleFromFile=OFF)[source]

This method creates an AcisFile object from a file containing ACIS-format geometry. This object is subsequently used by the PartFromGeometryFile method.

Note

This function can be accessed by:

mdb.openAcis
Parameters:
  • fileName (str) – A String specifying the path to the ACIS file to open.

  • scaleFromFile (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to scale, rotate, and translate the part using the transform read from the ACIS file. The default value is OFF.

Returns:

An AcisFile object.

Return type:

AcisFile

Raises:
  • Texterror – File is from a newer version of ACIS than the CAE kernel.

  • Texterror – The data in the ACIS file are corrupted.

static openCatia(fileName, topology=None, convertUnits=OFF, combineBodies=OFF)[source]

This method creates an AcisFile object from a file containing V5-format geometry. This object is subsequently used by the PartFromGeometryFile method.

Note

This function can be accessed by:

mdb.openCatia
Parameters:
  • fileName (str) – A String specifying the path to the CATIA file to open.

  • topology (Optional[SymbolicConstant], default: None) – A SymbolicConstant specifying the topology of the data to be read from the file and of the part to be created. Possible values are SOLID , SHELL, and WIRE. If topology = SOLID, Abaqus/CAE attempts to attach cells to create a solid. If topology = SHELL, Abaqus/CAE builds the body as a shell entity and not as a solid entity. The default value is SOLID .

  • convertUnits (SymbolicConstant, default: OFF) – A SymbolicConstant specifying whether the original units should be retained. Possible values are ON and OFF. The default value is OFF.

  • combineBodies (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying whether to combine the bodies in the CATPart file. If the bodies to be combined touch or overlap, invalid entities would result. For CATProduct files, this option will be ignored.

Returns:

An AcisFile object.

Return type:

AcisFile

static openEnf(fileName, fileType, topology=abaqusConstants.SOLID, convertUnits=OFF)[source]

This method creates an AcisFile object from a file containing Elysium Neutral File-format geometry that was created by CATIA V5, I-DEAS, or Pro/ENGINEER. This object is subsequently used by the PartFromGeometryFile method.

Note

This function can be accessed by:

mdb.openEnf
Parameters:
  • fileName (str) – A String specifying the path to the Elysium Neutral File that was created by I-DEAS, Pro/ENGINEER, or CATIA V5.

  • fileType (str) – A String specifying the type of CAD system that created the file. Possible values are “ideas”, “proe”, or “catiav5” or a combination similar to “proe/ideas/catiav5” if the type is unknown.

  • topology (SymbolicConstant, default: SOLID) – A SymbolicConstant specifying the topology of the data to be read from the file and of the part to be created. Possible values are SOLID , SHELL, and WIRE. If topology = SOLID, Abaqus/CAE attempts to attach cells to create a solid. If topology = SHELL, Abaqus/CAE builds the body as a shell entity and not as a solid entity. The default value is SOLID.

  • convertUnits (Union[AbaqusBoolean, bool], default: OFF) – A Boolean specifying if the dimensions of the part should be converted to millimeters. The default value is OFF.

Returns:

An AcisFile object.

Return type:

AcisFile

static openIges(fileName, trimCurve=abaqusConstants.DEFAULT, scaleFromFile=OFF, msbo=False, includedLayers=(), topology=abaqusConstants.SOLID, uniteWires=ON)[source]

This method creates an AcisFile object from a file containing IGES-format geometry. This object is subsequently used by the PartFromGeometryFile method.

Note

This function can be accessed by:

mdb.openIges
Parameters:
  • fileName (str) – A String specifying the path to the IGES file to open.

  • trimCurve (SymbolicConstant, default: DEFAULT) – A SymbolicConstant specifying the method used to define the trim curves that bound parametric surfaces. Possible values are:DEFAULT, use either of the following as specified by the contents of the IGES file.PARAMETRIC_DATA, use the parameter space of the surface being trimmed.THREED_DATA, use real space—the coordinate system of the part along with an indication that the trim curve lies on the parametric surface.The default value is DEFAULT.

  • scaleFromFile (SymbolicConstant, default: OFF) – A SymbolicConstant specifying whether the imported geometry needs to be scaled using the units information available in the IGES file. Possible values are ON and OFF. The default value is OFF. When the argument is set to ON, the geometry is scaled to millimeters with respect to the unit system specified in the IGES file.

  • msbo (Union[AbaqusBoolean, bool], default: False) – A Boolean specifying if the IGES file contains MSBO (Manifold Solid B-Rep Object) entities. The default value is False.

  • includedLayers (tuple, default: ()) – A sequence of Ints specifying the levels or layers of entities that will be translated from the IGES file to build the part. The default is to include all the layers.

  • topology (SymbolicConstant, default: SOLID) – A SymbolicConstant specifying the topology of the data to be read from the file and of the part to be created. Possible values are SOLID , SHELL, and WIRE. If topology = SOLID, Abaqus/CAE attempts to attach cells to create a solid. If topology = SHELL, Abaqus/CAE builds the body as a shell entity and not as a solid entity. The default value is SOLID.

  • uniteWires (SymbolicConstant, default: ON) – A SymbolicConstant specifying whether the imported wires need to be united or not. Possible values are ON and OFF. The default value is ON. When importing a sketch, this value is set to OFF.

Returns:

An AcisFile object.

Return type:

AcisFile

Raises:

Texterror – The data in the IGES file are corrupted.

static openParasolid(fileName, topology=abaqusConstants.SOLID)[source]

This method creates an AcisFile object from a file containing Parasolid-format geometry. This object is subsequently used by the PartFromGeometryFile method.

Note

This function can be accessed by:

mdb.openParasolid
Parameters:
  • fileName (str) – A String specifying the path to the Parasolid file to open.

  • topology (SymbolicConstant, default: SOLID) – A SymbolicConstant specifying the topology of the data to be read from the file and of the part to be created. Possible values are SOLID , SHELL, and WIRE. If topology = SOLID, Abaqus/CAE attempts to attach cells to create a solid. If topology = SHELL, Abaqus/CAE builds the body as a shell entity and not as a solid entity. The default value is SOLID.

Returns:

An AcisFile object.

Return type:

AcisFile

static openSolidworks(fileName, topology=abaqusConstants.SOLID)[source]

This method creates an AcisFile object from a file containing Solidworks format geometry. This object is subsequently used by the PartFromGeometryFile method.

Note

This function can be accessed by:

openSolidworks

New in version 2020: The openSolidworks method was added.

Parameters:
  • fileName (str) – A String specifying the path to the Solidworks file to open.

  • topology (SymbolicConstant, default: SOLID) – A SymbolicConstant specifying the topology of the data to be read from the file and of the part to be created. Possible values are SOLID, SHELL, and WIRE. If topology = SOLID, Abaqus/CAE attempts to attach cells to create a solid entity. If topology = SHELL, Abaqus/CAE builds the body as a shell entity, not as a solid entity. The default value is SOLID.

Return type:

An AcisFile object.

Raises:

Texterror – The data in the Solidworks file are corrupted.

static openStep(fileName, scale=1)[source]

This method creates an AcisFile object from a file containing STEP-format geometry. This object is subsequently used by the PartFromGeometryFile method.

Note

This function can be accessed by:

mdb.openStep
Parameters:
  • fileName (str) – A String specifying the path to the STEP file to open.

  • scale (float, default: 1) – A Float specifying the scaling factor to apply to the imported geometric entities. The default value is 1.0.

Returns:

An AcisFile object.

Return type:

AcisFile

Raises:

Texterror – The data in the STEP file are corrupted.

static openVda(fileName)[source]

This method creates an AcisFile object from a file containing VDA-FS-format geometry. This object is subsequently used by the PartFromGeometryFile method.

Note

This function can be accessed by:

mdb.openVda
Parameters:

fileName (str) – A String specifying the path to the VDA-FS file to open.

Returns:

An AcisFile object.

Return type:

AcisFile

Raises:

Texterror – The data in the VDA-FS file are corrupted.