Assembly¶

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

Create instances¶

class AssemblyModel( name, description='', stefanBoltzmann=None, absoluteZero=None, waveFormulation=NOT_SET, modelType=STANDARD_EXPLICIT, universalGas=None, copyConstraints=1, copyConnectors=1, copyInteractions=1, )[源代码]¶

基类：ModelBase

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

备注

This object can be accessed by:

mdb.models[name]

备注

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

Public Data Attributes:

Inherited from ModelBase

`name`	A String specifying the repository key.
`stefanBoltzmann`	None or a Float specifying the Stefan-Boltzmann constant.
`absoluteZero`	None or a Float specifying the absolute zero constant.
`waveFormulation`	A SymbolicConstant specifying the type of incident wave formulation to be used in acoustic problems.
`universalGas`	None or a Float specifying the universal gas constant.
`noPartsInputFile`	A Boolean specifying whether an input file should be written without parts and assemblies.
`endRestartStep`	A Boolean specifying that the step specified by restartStep should be terminated at the increment specified by restartIncrement.
`shellToSolid`	A Boolean specifying that a shell global model drives a solid submodel.
`lastChangedCount`	A Float specifying the time stamp that indicates when the model was last changed.
`description`	A String specifying the purpose and contents of the Model object.
`restartJob`	A String specifying the name of the job that generated the restart data.
`restartStep`	A String specifying the name of the step where the restart analysis will start.
`globalJob`	A String specifying the name of the job that generated the results for the global model.
`copyConstraints`	A boolean specifying the status of constraints created in a model, in the model which instances this model.
`copyConnectors`	A boolean specifying the status of connectors created in a model, in the model which instances this model.
`copyInteractions`	A boolean specifying the status of interactions created in a model, in the model which instances this model.
`keywordBlock`	A KeywordBlock object.
`amplitudes`	A repository of Amplitude objects.
`profiles`	A repository of Profile objects.
`boundaryConditions`	A repository of BoundaryCondition objects.
`constraints`	A repository of ConstrainedSketchConstraint objects.
`analyticalFields`	A repository of AnalyticalField objects.
`discreteFields`	A repository of DiscreteField objects.
`predefinedFields`	A repository of PredefinedField objects.
`interactions`	A repository of Interaction objects.
`interactionProperties`	A repository of InteractionProperty objects.
`contactControls`	A repository of ContactControl objects.
`contactInitializations`	A repository of ContactInitialization objects.
`contactStabilizations`	A repository of ContactStabilization objects.
`linkedInstances`	A tuple of tuples of Strings specifying the linked child PartInstance name in the current model to the corresponding parent PartInstance name in a different model.
`linkedParts`	A tuple of tuples of Strings specifying the linked child Part name in the current model to the corresponding parent Part name in a different model.
`loads`	A repository of Load objects.
`materials`	A repository of Material objects.
`calibrations`	A repository of Calibration objects.
`sections`	A repository of Section objects.
`remeshingRules`	A repository of RemeshingRule objects.
`sketches`	A repository of ConstrainedSketch objects.
`parts`	A repository of Part objects.
`steps`	A repository of Step objects.
`featureOptions`	A FeatureOptions object.
`adaptiveMeshConstraints`	A repository of AdaptiveMeshConstraint objects.
`adaptiveMeshControls`	A repository of AdaptiveMeshControl objects.
`timePoints`	A repository of TimePoint objects.
`filters`	A repository of Filter objects.
`integratedOutputSections`	A repository of IntegratedOutputSection objects.
`fieldOutputRequests`	A repository of FieldOutputRequest objects.
`historyOutputRequests`	A repository of HistoryOutputRequest objects.
`optimizationTasks`	A repository of OptimizationTask objects.
`tableCollections`	A repository of TableCollection objects.
`eventSeriesTypes`	A repository of EventSeriesType objects.
`eventSeriesDatas`	A repository of EventSeriesData objects.
`restartIncrement`	An Int specifying the increment, interval, iteration or cycle where the restart analysis will start.
`rootAssembly`	An Assembly object.

Public Methods:

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

Inherited from ModelBase

`__init__`(name[, description, ...])	This method creates a Model object.
`ModelFromInputFile`(name, inputFileName)	This method creates a Model object by reading the keywords in an input file and creating the corresponding Abaqus/CAE objects.
`ModelFromOdbFile`(name, odbFileName)	This method creates a Model object by reading an output database and creating any corresponding Abaqus/CAE objects.
`ModelFromNastranFile`(modelName, inputFileName)	This method creates a Model object by reading the keywords in a Nastran bulk data file or Nastran input file and creating any corresponding Abaqus/CAE objects.
`setValues`([description, noPartsInputFile, ...])	This method modifies the Model object.

Member Details:

Instance(name, objectToCopy)[源代码]¶

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

备注

This function can be accessed by:

mdb.models[name].Instance

备注

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

参数:¶

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

返回:¶

A Model object.

返回类型:¶

Model

convertAllSketches(regenerate=True, convertReversedSketches=True)[源代码]¶

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

备注

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

参数:¶

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

返回:¶

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

返回类型:¶

list[str]

linkInstances(instancesMap)[源代码]¶

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

备注

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

参数:¶

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

返回:¶

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

返回类型:¶

list[str]

Other Classes¶

class Assembly[源代码]¶

基类：MeshEditAssembly, MeshAssembly, PropertyAssembly, RegionAssembly, Displayable

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

备注

This object can be accessed by:

import assembly
mdb.models[name].rootAssembly

备注

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

Member Details:

ConnectorOrientation( region, localCsys1=None, axis1=AXIS_1, angle1=0, orient2sameAs1=1, localCsys2=None, axis2=AXIS_1, angle2=0, )[源代码]¶

This method creates a ConnectorOrientation object.

备注

This function can be accessed by:

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

备注

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

参数:¶

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

返回:¶

A ConnectorOrientation object.

返回类型:¶

ConnectorOrientation

class ConnectorOrientation( region, localCsys1=None, axis1=AXIS_1, angle1=0, orient2sameAs1=1, localCsys2=None, axis2=AXIS_1, angle2=0, )[源代码]¶

基类：object

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

备注

This object can be accessed by:

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

备注

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

Member Details:

angle1 : --is-rst--:py:class:`float` = 0[源代码]¶: A Float specifying the angle of the additional rotation. The default value is 0.0.

angle2 : --is-rst--:py:class:`float` = 0[源代码]¶: A Float specifying the angle of the additional rotation. The default value is 0.0.

axis1 : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'AXIS_1'[源代码]¶: A SymbolicConstant specifying the axis of a datum coordinate system about which an additional rotation is applied. Possible values are AXIS_1, AXIS_2, and AXIS_3. The default value is AXIS_1.

axis2 : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'AXIS_1'[源代码]¶: A SymbolicConstant specifying the axis of a datum coordinate system about which an additional rotation is applied. Possible values are AXIS_1, AXIS_2, and AXIS_3. The default value is AXIS_1.

localCsys1 : --is-rst--:py:class:`~abaqus.Datum.DatumCsys.DatumCsys` | :py:obj:`None` = <abaqus.Datum.DatumCsys.DatumCsys object>[源代码]¶: A DatumCsys object specifying the local coordinate system of the first connector point. This value may be None, indicating the global coordinate system.

localCsys2 : --is-rst--:py:class:`~abaqus.Datum.DatumCsys.DatumCsys` | :py:obj:`None` = <abaqus.Datum.DatumCsys.DatumCsys object>[源代码]¶: A DatumCsys object specifying the local coordinate system of the second connector point. This value may be None, indicating the global coordinate system.

orient2sameAs1 : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 1[源代码]¶: A Boolean specifying whether or not the second connector point is to use the same local coordinate system, axis, and angle as the first point. The default value is ON.

region : --is-rst--:py:class:`~abaqus.Region.Set.Set`[源代码]¶: A Set object specifying the region to which the orientation is assigned.

setValues(*args, **kwargs)[源代码]¶: This method modifies the ConnectorOrientation object.

class AssemblyBase[源代码]¶

基类：AssemblyFeature

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

备注

This object can be accessed by:

import assembly
mdb.models[name].rootAssembly

备注

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

Member Details:

Instance( name: str, part: Part, autoOffset: AbaqusBoolean | bool = OFF, dependent: AbaqusBoolean | bool = OFF, ) → PartInstance[源代码]¶

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

Instance(name, *args, **kwargs)

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

备注

This function can be accessed by:

mdb.models[name].rootAssembly.Instance

备注

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

参数:¶

name: str¶
name: A String specifying the repository key. The name must be a valid Abaqus object name.
**kwargs: Key-value arguments

返回:¶

A PartInstance object.

返回类型:¶

PartInstance

InstanceFromBooleanCut( name, instanceToBeCut, cuttingInstances, originalInstances=SUPPRESS, )[源代码]¶

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

备注

This function can be accessed by:

mdb.models[name].rootAssembly.InstanceFromBooleanCut

备注

Check InstanceFromBooleanCut on help.3ds.com/2024.

参数:¶

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

返回:¶

A PartInstance object.

返回类型:¶

PartInstance

InstanceFromBooleanMerge( name, instances, keepIntersections=False, originalInstances=SUPPRESS, domain=GEOMETRY, mergeNodes=BOUNDARY_ONLY, nodeMergingTolerance=None, removeDuplicateElements=True, )[源代码]¶

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

备注

This function can be accessed by:

mdb.models[name].rootAssembly.InstanceFromBooleanMerge

备注

Check InstanceFromBooleanMerge on help.3ds.com/2024.

参数:¶

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

返回:¶

A PartInstance object.

返回类型:¶

PartInstance

LinearInstancePattern( instanceList, number1, spacing1, number2, spacing2, direction1=(), direction2=(), )[源代码]¶

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

备注

This function can be accessed by:

mdb.models[name].rootAssembly.LinearInstancePattern

备注

Check LinearInstancePattern on help.3ds.com/2024.

参数:¶

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

返回:¶

A sequence of PartInstance objects.

返回类型:¶

Sequence[PartInstance]

RadialInstancePattern(instanceList, number, totalAngle, point=(), axis=())[源代码]¶

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

备注

This function can be accessed by:

mdb.models[name].rootAssembly.RadialInstancePattern

备注

Check RadialInstancePattern on help.3ds.com/2024.

参数:¶

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

返回:¶

A sequence of PartInstance objects.

返回类型:¶

Sequence[PartInstance]

allInstances : --is-rst--:py:class:`dict`\ \[:py:class:`str`, :py:data:`~typing.Union`\ \[:py:class:`~abaqus.Assembly.PartInstance.PartInstance`, :py:class:`~abaqus.Assembly.ModelInstance.ModelInstance`]] = {}[源代码]¶: A PartInstance object specifying the PartInstances and A ModelInstance object specifying the ModelInstances.

allInternalSets : --is-rst--:py:class:`dict`\ \[:py:class:`str`, :py:class:`~abaqus.Region.Set.Set`] = {}[源代码]¶: A repository of Set objects specifying picked regions.

allInternalSurfaces : --is-rst--:py:class:`dict`\ \[:py:class:`str`, :py:class:`~abaqus.Region.Surface.Surface`] = {}[源代码]¶: A repository of Surface objects specifying picked regions.

allSets : --is-rst--:py:class:`dict`\ \[:py:class:`str`, :py:class:`~abaqus.Region.Set.Set`] = {}[源代码]¶: A repository of Set objects specifying for more information, see [Region commands](https://help.3ds.com/2022/english/DSSIMULIA_Established/SIMACAEKERRefMap/simaker-m-RegPyc-sb.htm?ContextScope=all).

allSurfaces : --is-rst--:py:class:`dict`\ \[:py:class:`str`, :py:class:`~abaqus.Region.Surface.Surface`] = {}[源代码]¶: A repository of Surface objects specifying for more information, see [Region commands](https://help.3ds.com/2022/english/DSSIMULIA_Established/SIMACAEKERRefMap/simaker-m-RegPyc-sb.htm?ContextScope=all).

backup()[源代码]¶

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

The backup() method is used in conjunction with the restore() method.

clearGeometryCache()[源代码]¶

This method deletes the geometry cache.

Deleting the geometry cache reduces the amount of memory being used.

connectorOrientations : --is-rst--:py:class:`~typing.List`\ \[:py:class:`~abaqus.Assembly.ConnectorOrientation.ConnectorOrientation`] = [][源代码]¶: A ConnectorOrientationArray object.

copyMeshPattern( elements=(), faces=(), elemFaces=(), targetFace=None, nodes=(), coordinates=(), )[源代码]¶

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.

备注

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

参数:¶

elements=()¶: A sequence of MeshElement objects or a Set object containing elements and specifying the source region.
faces=()¶: A sequence of Face objects that have associated with shell elements or element faces and specifying the source region.
elemFaces=()¶: A sequence of MeshFace objects specifying the source region.
targetFace=None¶: A MeshFace object specifying the target region. The target face can be of a different part instance.
nodes=()¶: 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=()¶: 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 : --is-rst--:py:class:`list`\ \[:py:class:`~abaqus.Datum.Datum.Datum`] = [][源代码]¶: A repository of Datum objects specifying all Datum objects in the assembly.

deleteAllFeatures()[源代码]¶: This method deletes all the features in the assembly.

deleteFeatures(featureNames)[源代码]¶

This method deletes specified features from the assembly.

备注

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

参数:¶

featureNames¶: A sequence of Strings specifying the feature names that will be deleted from the assembly.

edges : --is-rst--:py:class:`~abaqus.BasicGeometry.EdgeArray.EdgeArray` = [][源代码]¶: An EdgeArray object specifying all the edges existing at the assembly level. This member does not provide access to the edges at the instance level.

elements : --is-rst--:py:class:`~abaqus.Mesh.MeshElementArray.MeshElementArray` = [][源代码]¶: A MeshElementArray object specifying all the elements existing at the assembly level. This member does not provide access to the elements at the instance level.

engineeringFeatures : --is-rst--:py:class:`~abaqus.EngineeringFeature.EngineeringFeature.EngineeringFeature` = <abaqus.EngineeringFeature.EngineeringFeature.EngineeringFeature object>[源代码]¶: An EngineeringFeature object.

excludeFromSimulation(instances, exclude)[源代码]¶

This method excludes the specified part instances from the analysis.

备注

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

参数:¶

instances¶: A sequence of PartInstance objects to be excluded from the analysis.
exclude¶: A Bool specifying whether to exclude the selected instances from the analysis or include them.

featurelistInfo()[源代码]¶: This method prints the name and status of all the features in the feature lists.

features : --is-rst--:py:class:`dict`\ \[:py:class:`str`, :py:class:`~abaqus.Assembly.AssemblyFeature.AssemblyFeature`] = {}[源代码]¶: A repository of Feature objects specifying all Feature objects in the assembly.

featuresById : --is-rst--:py:class:`dict`\ \[:py:class:`str`, :py:class:`~abaqus.Assembly.AssemblyFeature.AssemblyFeature`] = {}[源代码]¶: A repository of Feature objects specifying all Feature objects in the assembly.The Feature objects in the featuresById repository are the same as the Feature objects in the features repository. However, the key to the objects in the featuresById repository is an integer specifying the ID, whereas the key to the objects in the features repository is a string specifying the name.

getAngle(plane1, plane2, line1, line2, commonVertex='')[源代码]¶

This method returns the angle between the specified entities.

备注

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

参数:¶

plane1¶: 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¶: 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¶: 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¶: 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=''¶: 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.

返回:¶

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.

返回类型:¶

float

getCoordinates(entity, csys=<abaqus.Datum.DatumCsys.DatumCsys object>)[源代码]¶

This method returns the coordinates of a specified point.

备注

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

参数:¶

entity¶

A ConstrainedSketchVertex, Datum point, MeshNode, or ReferencePoint specifying the entity to query.

csys : DatumCsys, default: <abaqus.Datum.DatumCsys.DatumCsys object at 0x7fadcad89510>

A DatumCsys object specifying the desired coordinate system of the returned coordinates. By default, coordinates are given in the global coordinate system.

Added in version 2023: The csys argument was added.

返回:¶

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

返回类型:¶

tuple[float, float]

getDistance( entity1, entity2, printResults=0, csys=<abaqus.Datum.DatumCsys.DatumCsys object>, )[源代码]¶

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.

在 2023 版本发生变更: The csys argument was removed.

备注

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

参数:¶

entity1¶: A ConstrainedSketchVertex, Datum point, MeshNode, or Edge specifying the first entity from which to measure.
entity2¶: A ConstrainedSketchVertex, Datum point, MeshNode, or Edge specifying the second entity to which to measure.
printResults : Union[AbaqusBoolean, bool], default: 0: A Boolean that determines whether a verbose output is to be printed. The default is True

返回:¶

A Float specifying the calculated distance.

返回类型:¶

float

getFacesAndVerticesOfAttachmentLines(edges)[源代码]¶

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

备注

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

参数:¶

edges¶: An EdgeArray object which is a sequence of Edge objects.

返回:¶

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

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

返回类型:¶

Sequence[dict]

getMassProperties( regions='', relativeAccuracy=LOW, useMesh=False, specifyDensity=False, density='', specifyThickness=False, thickness='', miAboutCenterOfMass=True, miAboutPoint=Ellipsis, )[源代码]¶

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

备注

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

参数:¶

regions=''¶: A MeshElementArray, CellArray, FaceArray, EdgeArray, or list of PartInstance objects specifying the regions whose mass properties are to be queried. The whole assembly is queried by default.
relativeAccuracy=LOW¶: A SymbolicConstant specifying the relative accuracy for geometry computation. Possible values are LOW, MEDIUM, and HIGH. The default value is LOW.
useMesh=False¶: A Boolean specifying whether the mesh should be used in the computation if the geometry is meshed. The default value is False.
specifyDensity=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=''¶: 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=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=''¶: 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=True¶: A Boolean specifying if the moments of inertia should be evaluated about the center of mass. The default value is True.
miAboutPoint=Ellipsis¶: 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.

返回:¶

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

返回类型:¶

dict

getSurfaceSections(surface)[源代码]¶

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

备注

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

参数:¶

surface¶: A string specifying the Surface name.

返回:¶

A tuple of strings representing the section names. If no section names are found, the tuple will contain one empty string.

返回类型:¶

Sequence[str]

importCatiaV5File(filename, ids=())[源代码]¶

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

备注

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

参数:¶

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

importEafFile(filename, ids=())[源代码]¶

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

备注

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

参数:¶

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

importEnfFile(filename, ids=())[源代码]¶

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

备注

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

参数:¶

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

importIdeasFile(filename, ids=())[源代码]¶

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

备注

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

参数:¶

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

importParasolidFile(filename, ids=())[源代码]¶

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

备注

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

参数:¶

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

importProEFile(filename, ids=())[源代码]¶

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

备注

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

参数:¶

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

instances : --is-rst--:py:class:`dict`\ \[:py:class:`str`, :py:class:`~abaqus.Assembly.PartInstance.PartInstance`] = {}[源代码]¶: A repository of PartInstance objects.

isLocked : --is-rst--:py:class:`int` | :py:obj:`None` = None[源代码]¶: An Int specifying whether the assembly is locked or not. Possible values are 0 and 1.

isOutOfDate : --is-rst--:py:class:`int` | :py:obj:`None` = None[源代码]¶: An Int specifying that feature parameters have been modified but that the assembly has not been regenerated. Possible values are 0 and 1.

lock()[源代码]¶

This method locks the assembly.

Locking the assembly prevents any further changes to the assembly that can trigger regeneration of the assembly.

makeDependent(instances)[源代码]¶

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

备注

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

参数:¶

instances¶: A sequence of PartInstance objects to convert to dependent part instances.

makeIndependent(instances)[源代码]¶

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

备注

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

参数:¶

instances¶: A sequence of PartInstance objects to convert to independent part instances.

modelInstances : --is-rst--:py:class:`dict`\ \[:py:class:`str`, :py:class:`~abaqus.Assembly.ModelInstance.ModelInstance`] = {}[源代码]¶: A repository of ModelInstance objects.

modelName : --is-rst--:py:class:`str` = ''[源代码]¶: A String specifying the name of the model to which the assembly belongs.

nodes : --is-rst--:py:class:`~abaqus.Mesh.MeshNodeArray.MeshNodeArray` = [][源代码]¶: A MeshNodeArray object specifying all the nodes existing at the assembly level. This member does not provide access to the nodes at the instance level.

printAssignedSections()[源代码]¶: This method prints a summary of assigned connector sections.

printConnectorOrientations()[源代码]¶: This method prints a summary of connector orientations.

projectReferencesOntoSketch( sketch, filter=ALL_EDGES, upToFeature=None, edges=(), vertices=(), )[源代码]¶

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

备注

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

参数:¶

sketch¶: The ConstrainedSketch object on which the edges, vertices, and datum points are projected.
filter=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=None¶: A Feature object specifying a marker in the feature-based history of the part. Abaqus/CAE projects onto the sketch only the part entities that were created before the feature specified by this marker. By default, all part entities are candidates for projection.
edges=()¶: A sequence of candidate edges to be projected onto the sketch. By default, all edges are candidates for projection.
vertices=()¶: A sequence of candidate vertices to be projected onto the sketch. By default, all vertices are candidates for projection.

queryCachedStates()[源代码]¶

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

The output is displayed in the message area.

referencePoints : --is-rst--:py:class:`dict`\ \[:py:class:`str`, :py:class:`~abaqus.BasicGeometry.ReferencePoint.ReferencePoint`] = {}[源代码]¶: A repository of ReferencePoint objects.

regenerate()[源代码]¶

This method regenerates the assembly and brings it up to date with the latest values of the assembly parameters.

When you modify features of an assembly, it may be convenient to postpone regeneration until you make all your changes, since regeneration can be time consuming. In contrast, when you modify features of a part that is included in the assembly, you should use this command to regenerate the assembly. When you regenerate the assembly, it will reflect the changes that you made to the part.

regenerateConstraintsTogether : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 1[源代码]¶: A Boolean specifying whether the positioning constraints in the assembly should be regenerated together before regenerating other assembly features. The default value is ON.If the assembly has position constraint features and you modify the value of regenerateConstraintsTogether, Abaqus/CAE will regenerate the assembly features.

regenerationWarnings()[源代码]¶: This method prints any regeneration warnings associated with the features.

restore()[源代码]¶

This method restores the parameters of all features in the assembly to the value they had before a failed regeneration.

Use the restore method after a failed regeneration, followed by a regenerate command.

resumeAllFeatures()[源代码]¶: This method resumes all the suppressed features in the part or assembly.

resumeFeatures(featureNames)[源代码]¶

This method resumes the specified suppressed features in the assembly.

备注

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

参数:¶

featureNames¶: A sequence of Strings specifying the names of features to resume.

resumeLastSetFeatures()[源代码]¶: This method resumes the last set of features to be suppressed in the assembly.

rotate(instanceList, axisPoint, axisDirection, angle)[源代码]¶

This method rotates given instances by the specified amount.

备注

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

参数:¶

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

saveGeometryCache()[源代码]¶: This method caches the current geometry, which improves regeneration performance.

sectionAssignments : --is-rst--:py:class:`~typing.List`\ \[:py:class:`~abaqus.Property.SectionAssignment.SectionAssignment`] = [][源代码]¶: A SectionAssignmentArray object.

setMeshNumberingControl(instances, startNodeLabel=None, startElemLabel=None)[源代码]¶

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

备注

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

参数:¶

instances¶: A sequence of PartInstance objects to change the start node and/or element labels.
startNodeLabel=None¶: A positive Integer specifying the new start node label.
startElemLabel=None¶: A positive Integer specifying the new start element label.

setValues(regenerateConstraintsTogether)[源代码]¶

This method modifies the behavior associated with the specified assembly.

备注

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

参数:¶

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

抛出:¶

FeatureError – Regeneration failed, If one or more features in the assembly fails to regenerate

sets : --is-rst--:py:class:`dict`\ \[:py:class:`str`, :py:class:`~abaqus.Region.Set.Set`] = {}[源代码]¶: A repository of Set objects.

skins : --is-rst--:py:class:`dict`\ \[:py:class:`str`, :py:class:`~abaqus.Region.Skin.Skin`] = {}[源代码]¶: A repository of Skin objects specifying the skins created on the assembly.

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.

备注

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

参数:¶

nodes=()¶

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

在 2020 版本发生变更: The coordinates arguments was removed, the nodes now replaces it.

stringers : --is-rst--:py:class:`dict`\ \[:py:class:`str`, :py:class:`~abaqus.Region.Stringer.Stringer`] = {}[源代码]¶: A repository of Stringer objects specifying the stringers created on the assembly.

suppressFeatures(featureNames)[源代码]¶

This method suppresses specified features.

备注

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

参数:¶

featureNames¶: A sequence of Strings specifying the names of features to suppress in the assembly.

surfaces : --is-rst--:py:class:`dict`\ \[:py:class:`str`, :py:class:`~abaqus.Region.Surface.Surface`] = {}[源代码]¶: A repository of Surface objects specifying for more information, see [Region commands](https://help.3ds.com/2022/english/DSSIMULIA_Established/SIMACAEKERRefMap/simaker-m-RegPyc-sb.htm?ContextScope=all).

timeStamp : --is-rst--:py:class:`float` | :py:obj:`None` = None[源代码]¶: A Float specifying which gives an indication when the assembly was last modified.

translate(instanceList, vector)[源代码]¶

This method translates given instances by the specified amount.

备注

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

参数:¶

instanceList¶: A sequence of Strings specifying the names of instances to translate.
vector¶: A sequence of three Floats specifying a translation vector.

unlinkInstances(instances)[源代码]¶

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

备注

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

参数:¶

instances¶: A sequence of PartInstance objects to be converted to regular part instances.

unlock()[源代码]¶

This method unlocks the assembly.

Unlocking the assembly allows it to be regenerated after any modifications to the assembly.

vertices : --is-rst--:py:class:`~abaqus.BasicGeometry.VertexArray.VertexArray` = [][源代码]¶: A VertexArray object specifying all the vertices existing at the assembly level. This member does not provide access to the vertices at the instance level.

writeAcisFile(fileName, version=None)[源代码]¶

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

备注

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

参数:¶

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

writeCADParameters(paramFile, modifiedParams=(), updatePaths='')[源代码]¶

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

备注

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

参数:¶

paramFile¶: A String specifying the parameter file name.
modifiedParams=()¶: A tuple of tuples each containing the part name, the parameter name and the modified parameter value. Default is an empty tuple.
updatePaths=''¶: 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.

class AssemblyFeature[源代码]¶

基类：Feature

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

备注

This object can be accessed by:

import assembly

备注

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

Member Details:

static AttachmentLines( name, points, sourceFaces, sourceElementFaces, targetFaces, targetElementFaces, projectionMethod=PROJECT_BY_PROXIMITY, projectionDirStartPt=None, projectionDirEndPt=None, sourceToTargetProjMethod=PROJECT_BY_NUMBER, numProjections='', projectionDistance='', flipSourceToTargetDirection=0, setName='', )[源代码]¶

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

备注

This function can be accessed by:

mdb.models[name].rootAssembly.AttachmentLines

备注

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

参数:¶

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

返回:¶

A Feature object.

返回类型:¶

AssemblyFeature

static Coaxial(movableAxis, fixedAxis, flip)[源代码]¶

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

备注

This function can be accessed by:

mdb.models[name].rootAssembly.AttachmentLines

备注

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

参数:¶

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

返回:¶

A Feature object.

返回类型:¶

AssemblyFeature

抛出:¶

AbaqusException –

static CoincidentPoint(movablePoint, fixedPoint)[源代码]¶

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

备注

This function can be accessed by:

mdb.models[name].rootAssembly.AttachmentLines

备注

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

参数:¶

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

返回:¶

feature – A Feature object

返回类型:¶

AssemblyFeature

static EdgeToEdge(movableAxis, fixedAxis, flip, clearance)[源代码]¶

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

备注

This function can be accessed by:

mdb.models[name].rootAssembly.AttachmentLines

备注

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

参数:¶

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

返回:¶

A Feature Object.

返回类型:¶

AssemblyFeature

抛出:¶

AbaqusException –

static FaceToFace(movablePlane, fixedPlane, flip, clearance)[源代码]¶

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

备注

This function can be accessed by:

mdb.models[name].rootAssembly.AttachmentLines

备注

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

参数:¶

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

返回:¶

A Feature Object.

返回类型:¶

AssemblyFeature

抛出:¶

AbaqusException –

static ParallelCsys(movableCsys, fixedCsys)[源代码]¶

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

备注

This function can be accessed by:

mdb.models[name].rootAssembly.AttachmentLines

备注

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

参数:¶

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

返回:¶

A Feature object.

返回类型:¶

AssemblyFeature

抛出:¶

AbaqusException –

static ParallelEdge(movableAxis, fixedAxis, flip)[源代码]¶

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

备注

This function can be accessed by:

mdb.models[name].rootAssembly.AttachmentLines

备注

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

参数:¶

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

返回:¶

A Feature object.

返回类型:¶

AssemblyFeature

抛出:¶

AbaqusException –

static ParallelFace(movablePlane, fixedPlane, flip)[源代码]¶

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

备注

This function can be accessed by:

mdb.models[name].rootAssembly.AttachmentLines

备注

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

参数:¶

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

返回:¶

A Feature object.

返回类型:¶

AssemblyFeature

抛出:¶

AbaqusException –

class ModelInstance(name, model, autoOffset=0)[源代码]¶

基类：object

A ModelInstance object is an instance of a Model.

备注

This object can be accessed by:

import assembly
mdb.models[name].rootAssembly.modelInstances[i]

备注

Check ModelInstance on help.3ds.com/2024.

Member Details:

ConvertConstraints()[源代码]¶

This method converts the position constraints of an instance to absolute positions.

The method deletes the constraint features on the instance but preserves the position in space.

datums : --is-rst--:py:class:`dict`\ \[:py:class:`str`, :py:class:`~abaqus.Datum.Datum.Datum`] = {}[源代码]¶: A repository of Datum objects.

edges : --is-rst--:py:class:`~abaqus.BasicGeometry.EdgeArray.EdgeArray` = [][源代码]¶: An EdgeArray object.

elements : --is-rst--:py:class:`~abaqus.Mesh.MeshElementArray.MeshElementArray` = [][源代码]¶: A MeshElementArray object.

getPosition()[源代码]¶: This method prints the sum of the translations and rotations applied to the ModelInstance object.

nodes : --is-rst--:py:class:`~abaqus.Mesh.MeshNodeArray.MeshNodeArray` = [][源代码]¶: A MeshNodeArray object.

referencePoints : --is-rst--:py:class:`dict`\ \[:py:class:`str`, :py:class:`~abaqus.BasicGeometry.ReferencePoint.ReferencePoint`] = {}[源代码]¶: A repository of ReferencePoint objects.

replace(instanceOf, applyConstraints=True)[源代码]¶

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

Added in version 2019: The replace method was added.

备注

Check ModelInstance.replace on help.3ds.com/2024.

参数:¶

instanceOf¶: A Model object to be instanced. If the model does not exist, no ModelInstance object is created.
applyConstraints=True¶: A Boolean specifying whether to apply existing constraints on the new instance or to position the new instance in the same place as the original instance. The default value is True. A value of False indicates that constraints applies to the instance are deleted will be deleted from the feature list.

sets : --is-rst--:py:class:`dict`\ \[:py:class:`str`, :py:class:`~abaqus.Region.Set.Set`] = {}[源代码]¶: A repository of Set objects specifying the sets created on the assembly. For more information, see [Region commands](https://help.3ds.com/2022/english/DSSIMULIA_Established/SIMACAEKERRefMap/simaker-m-RegPyc-sb.htm?ContextScope=all).

surfaces : --is-rst--:py:class:`dict`\ \[:py:class:`str`, :py:class:`~abaqus.Region.Surface.Surface`] = {}[源代码]¶: A repository of Surface objects specifying the surfaces created on the assembly. For more information, see [Region commands](https://help.3ds.com/2022/english/DSSIMULIA_Established/SIMACAEKERRefMap/simaker-m-RegPyc-sb.htm?ContextScope=all).

translate(vector)[源代码]¶

This method translates an instance by the specified amount.

备注

Check ModelInstance.translate on help.3ds.com/2024.

参数:¶

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

vertices : --is-rst--:py:class:`~abaqus.BasicGeometry.VertexArray.VertexArray` = [][源代码]¶: A VertexArray object.

class PartInstance(name, part, autoOffset=0, dependent=0)[源代码]¶

基类：object

A PartInstance object is an instance of a Part object.

备注

This object can be accessed by:

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

备注

Check PartInstance on help.3ds.com/2024.

Member Details:

Contact(movableList, fixedList, direction, clearance, isFaceEdges=0)[源代码]¶

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

备注

Check Contact on help.3ds.com/2024.

参数:¶

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

返回:¶

feature – A Feature object

返回类型:¶

Feature

ConvertConstraints()[源代码]¶

This method converts the position constraints of an instance to absolute positions.

The method deletes the constraint features on the instance but preserves the position in space.

analysisType : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[源代码]¶: A SymbolicConstant specifying the part type. Possible values are DEFORMABLE_BODY, EULERIAN, DISCRETE_RIGID_SURFACE, and ANALYTIC_RIGID_SURFACE.

cells : --is-rst--:py:class:`~abaqus.BasicGeometry.CellArray.CellArray` = [][源代码]¶: A CellArray object.

checkGeometry(detailed=0, level=None)[源代码]¶

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

备注

Check PartInstance.checkGeometry on help.3ds.com/2024.

参数:¶

detailed=0¶: A Boolean specifying whether detailed output will be printed to the replay file. The default value is OFF.
level=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.

抛出:¶

Exception – An exception is thrown if this is a dependent part instance and level was either not specified or was set to 20, because the validity status cannot be updated for a dependent part instance. In this case, this command should be called on the Part instead. The geometry of dependent part instances cannot be changed.

datums : --is-rst--:py:class:`list`\ \[:py:class:`~abaqus.Datum.Datum.Datum`] = [][源代码]¶: A repository of Datum objects.

dependent : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[源代码]¶: A Boolean specifying whether the part instance is dependent or independent. If dependent = OFF, the part instance is independent. The default value is OFF.

edges : --is-rst--:py:class:`~abaqus.BasicGeometry.EdgeArray.EdgeArray` = [][源代码]¶: An EdgeArray object.

elemEdges : --is-rst--:py:class:`dict`\ \[:py:class:`str`, :py:class:`~abaqus.Mesh.MeshEdge.MeshEdge`] = {}[源代码]¶: A repository of MeshEdge objects specifying all the element edges in the part instance. For a given element and a given edge index on a given face within that element, the corresponding MeshEdge object can be retrieved from the repository by using the key calculated as (i*32 + j*4 + k), where i, j, and k are zero-based element, face, and edge indices, respectively.

elemFaces : --is-rst--:py:class:`dict`\ \[:py:class:`str`, :py:class:`~abaqus.Mesh.MeshFace.MeshFace`] = {}[源代码]¶

elementEdges : --is-rst--:py:class:`~abaqus.Mesh.MeshEdgeArray.MeshEdgeArray` = [][源代码]¶: A MeshEdgeArray object.

elementFaces : --is-rst--:py:class:`~abaqus.Mesh.MeshFaceArray.MeshFaceArray` = [][源代码]¶: A MeshFaceArray object.

elements : --is-rst--:py:class:`~abaqus.Mesh.MeshElementArray.MeshElementArray` = [][源代码]¶: A MeshElementArray object.

excludedFromSimulation : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[源代码]¶: A Boolean specifying whether the part instance is excluded from the simulation. If excludedFromSimulation = ON, the part instance is excluded from the simulation. The default value is OFF.

faces : --is-rst--:py:class:`~abaqus.BasicGeometry.FaceArray.FaceArray` = [][源代码]¶: A FaceArray object.

geometryValidity : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[源代码]¶: A Boolean specifying the validity of the geometry of the instance. The value is computed, but it can be set to ON to perform feature and mesh operations on an invalid instance. There is no guarantee that such operations will work if the instance was originally invalid.

getPosition()[源代码]¶: This method prints the sum of the translations and rotations applied to the PartInstance object.

getRotation()[源代码]¶

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

返回:¶: A tuple including the point of rotation, axis of rotation, and rotation angle (in degrees).
返回类型:¶: tuple

getTranslation()[源代码]¶

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

返回:¶: A tuple of three Floats representing the translation.
返回类型:¶: tuple[float, float, float]

ignoredEdges : --is-rst--:py:class:`~abaqus.BasicGeometry.IgnoredEdgeArray.IgnoredEdgeArray` = [][源代码]¶: An IgnoredEdgeArray object.

ignoredVertices : --is-rst--:py:class:`~abaqus.BasicGeometry.IgnoredVertexArray.IgnoredVertexArray` = [][源代码]¶: An IgnoredVertexArray object.

name : --is-rst--:py:class:`str` = ''[源代码]¶: A String specifying the repository key. The name must be a valid Abaqus object name.

nodes : --is-rst--:py:class:`~abaqus.Mesh.MeshNodeArray.MeshNodeArray` = [][源代码]¶: A MeshNodeArray object.

part : --is-rst--:py:class:`~abaqus.Part.Part.Part` | :py:obj:`None` = None[源代码]¶: A Part object specifying the instanced part.

partName : --is-rst--:py:class:`str` = ''[源代码]¶: A String specifying the name of the part from which the instance was created.

referenceNode : --is-rst--:py:class:`int` | :py:obj:`None` = None[源代码]¶: An Int specifying the reference node number. This member is valid only if analysisType = DISCRETE_RIGID_SURFACE or ANALYTIC_RIGID_SURFACE.

referencePoints : --is-rst--:py:class:`dict`\ \[:py:class:`str`, :py:class:`~abaqus.BasicGeometry.ReferencePoint.ReferencePoint`] = {}[源代码]¶: A repository of ReferencePoint objects.

replace(instanceOf, applyConstraints=True)[源代码]¶

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

备注

Check PartInstance.replace on help.3ds.com/2024.

参数:¶

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

rotateAboutAxis(axisPoint, axisDirection, angle)[源代码]¶

This method translates an instance by the specified amount.

备注

Check PartInstance.rotateAboutAxis on help.3ds.com/2024.

参数:¶

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

sets : --is-rst--:py:class:`dict`\ \[:py:class:`str`, :py:class:`~abaqus.Region.Set.Set`] = {}[源代码]¶: A repository of Set objects specifying the sets created on the part. For more information, see Region commands.

skins : --is-rst--:py:class:`dict`\ \[:py:class:`str`, :py:class:`~abaqus.Region.Skin.Skin`] = {}[源代码]¶: A repository of Skin objects specifying the skins created on the part. For more information, see Region commands.

stringers : --is-rst--:py:class:`dict`\ \[:py:class:`str`, :py:class:`~abaqus.Region.Stringer.Stringer`] = {}[源代码]¶: A repository of Stringer objects specifying the stringers created on the part. For more information, see Region commands.

surfaces : --is-rst--:py:class:`dict`\ \[:py:class:`str`, :py:class:`~abaqus.Region.Surface.Surface`] = {}[源代码]¶: A repository of Surface objects specifying the surfaces created on the part. For more information, see Region commands.

translate(vector)[源代码]¶

This method translates an instance by the specified amount.

备注

Check PartInstance.translate on help.3ds.com/2024.

参数:¶

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

translateTo(movableList, fixedList, direction, clearance, vector=())[源代码]¶

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

备注

Check PartInstance.translateTo on help.3ds.com/2024.

参数:¶

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

返回:¶

feature – A Feature object

返回类型:¶

Feature

vertices : --is-rst--:py:class:`~abaqus.BasicGeometry.VertexArray.VertexArray` = [][源代码]¶: A VertexArray object.