Engineering Feature¶

A specific type of engineering feature object is designed for each type of engineering feature.

Create engineering features¶

class EngineeringFeature[source]¶

Bases: EngineeringFeatureBase

Public Data Attributes:

Inherited from EngineeringFeatureBase

`inertias`	A repository of Inertia objects.
`cracks`	A repository of Crack objects.
`fasteners`	A repository of Fastener objects.
`springDashpots`	A repository of SpringDashpot objects.
`imperfections`	A repository of Imperfection objects.

Public Methods:

`AssembledFastener`(name, region, ...[, ...])	This method creates an AssembledFastener object.
`ContourIntegral`(name, crackFront, crackTip, ...)	This method creates a ContourIntegral object.
`DebondVCCT`(name, initiationStep, ...[, ...])	This method creates a DebondVCCT object.
`DiscreteFastener`(name, region, influenceRadius)	This method creates a DiscreteFastener object.
`HeatCapacitance`(name, region, table[, ...])	This method creates a HeatCapacitance object.
`NonstructuralMass`(name, region, units, magnitude)	This method creates a NonstructuralMass object.
`PointFastener`(name, region, physicalRadius)	This method creates a PointFastener object.
`PointMassInertia`(name, region[, mass, ...])	This method creates a PointMassInertia object.
`SpringDashpotToGround`(name, region, dof[, ...])	This method creates a SpringDashpotToGround object.
`TwoPointSpringDashpot`(name, regionPairs, axis)	This method creates a TwoPointSpringDashpot object.
`XFEMCrack`(name, crackDomain[, ...])	This method creates a XFEMCrack object.
`FileImperfection`(name, file, step, ...[, ...])	This method creates a FileImperfection object.
`InputImperfection`(name, file[, system])	This method creates a InputImperfection object.
`DataImperfection`(name, imperfectionTable[, ...])	This method creates a DataImperfection object.

Inherited from EngineeringFeatureBase

`assignSeam`(regions)	This method creates a seam crack along an edge or a face.
`deleteSeam`(regions)	This method deletes a seam crack.

Member Details:

AssembledFastener( name, region, templateModel, controlSet, templateSurfaces, assignedSurfaces, propertyPrefix, orientMethod=NORMALS, localCsys=None, scriptName='', )[source]¶

This method creates an AssembledFastener object. Although the constructor is available both for parts and for the assembly, AssembledFastener objects are currently supported only under the assembly.

Note

This function can be accessed by:

mdb.models[name].parts[name].engineeringFeatures.AssembledFastener
mdb.models[name].rootAssembly.engineeringFeatures.AssembledFastener

Note

Check AssembledFastener on help.3ds.com/2023.

Parameters:¶

name¶: A String specifying the repository key.
region¶: A Region object specifying the region of attachment points to which assembled fasteners are applied.
templateModel¶: A String specifying the name of the template model.
controlSet¶: A Region object specifying the template model control point set. The set must contain a single node or vertex.
templateSurfaces¶: A sequence of Strings specifying the names of the template model surfaces that are referenced by tie or coupling constraints.
assignedSurfaces¶: A sequence of Strings specifying the names of the main model surfaces that will be substituted for the template model constraint surfaces.
propertyPrefix¶: A String specifying the name of the property prefix string. This string will be prepended to every property name as it is copied to the main model from the template model.
orientMethod=NORMALS¶: A SymbolicConstant specifying the method used to orient the virtual instances of the template model at each attachment point. Possible values are NORMALS and CSYS. The default value is NORMALS.
localCsys=None¶: None or a DatumCsys object specifying the local coordinate system. If localCsys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.This argument applies only when orientMethod = CSYS.
scriptName=''¶: A String specifying the name of the property generation script. The default value is an empty string.

Returns:¶

An AssembledFastener object.

Return type:¶

AssembledFastener

ContourIntegral( name, crackFront, crackTip, extensionDirectionMethod, symmetric=0, listOfRegions=0, crackFrontName='', crackTipName='', crackNormal=(), qVectors=(), midNodePosition=0, collapsedElementAtTip=NONE, )[source]¶

This method creates a ContourIntegral object. Although the constructor is available both for parts and for the assembly, ContourIntegral objects are currently supported only under the assembly.

Note

This function can be accessed by:

mdb.models[name].parts[name].engineeringFeatures.ContourIntegral
mdb.models[name].rootAssembly.engineeringFeatures.ContourIntegral

Note

Check ContourIntegral on help.3ds.com/2023.

Parameters:¶

name¶: A String specifying the repository key.
crackFront¶: A RegionArray object specifying the crack-front region to which the contour integral is applied. If the crack-front consists of a single region, a Region object may be specified instead of a sequence with a single item in it.
crackTip¶: A RegionArray object specifying the crack-tip region to which the contour integral is applied. If the crack-tip consists of a single region, a Region object may be specified instead of a sequence with a single item in it.
extensionDirectionMethod¶: A SymbolicConstant specifying how the virtual crack extension direction vectors are defined. Possible values are CRACK_NORMAL and Q_VECTORS.
symmetric=0¶: A Boolean specifying whether the crack is defined on a half model (about a symmetry plane) or whether it is defined on the whole model. The default value is OFF.
listOfRegions=0¶: A Boolean specifying whether the regions specified by crackFront and crackTip are specified using a single region or tuples of region objects. The default value is OFF.
crackFrontName=''¶: A String specifying the name of the crack-front region generated from the tuple of regions specifying the crack-front region. This argument is valid only when listOfRegions is ON. The default value is name + Front.
crackTipName=''¶: A String specifying the name of the crack-tip region generated from the tuple of regions specifying the crack-tip region. This parameter is valid only when listOfRegions = ON. The default value is name + Tip.
crackNormal=()¶: A sequence of sequences of Floats specifying the two points of the vector that describes the crack normal direction. Each point is defined by a tuple of two or three coordinates indicating its position. This argument is required only when extensionDirectionMethod = CRACK_NORMAL. The default value is an empty sequence.
qVectors=()¶: A sequence of sequences of sequences of Floats specifying the vectors that indicate the set of crack extension directions. Each vector is described by a tuple of two points, and each point is described by a tuple of two or three coordinates indicating its position. This argument is required only when extensionDirectionMethod = Q_VECTORS. The default value is an empty sequence.
midNodePosition=0¶: A Float specifying the position of the midside node along the edges of the second-order elements that radiate from the crack tip. Possible values are 0.0 < midNodeParameter < 1.0. The default value is 0.5.
collapsedElementAtTip=NONE¶: A SymbolicConstant specifying the crack-tip singularity. Possible values are NONE, SINGLE_NODE, and DUPLICATE_NODES. The default value is NONE.

Returns:¶

A ContourIntegral object.

Return type:¶

ContourIntegral

DataImperfection(name, imperfectionTable, system=R)[source]¶

This method creates a DataImperfection object.

Note

This function can be accessed by:

mdb.models[name].rootAssembly.engineeringFeatures.DataImperfection

Parameters:¶

name¶: A String specifying the repository key.
imperfectionTable¶: A sequence of sequences of Ints and Floats specifying the imperfection components at a given node. The items in the table data are described below.
system=R¶: A SymbolicConstant specifying the coordinate system. The imperfection values in the data lines would be treated as perturbation values of the respective coordinates. Possible values are R, C, and S. The default value is R.

Returns:¶

A DataImperfection object.

Return type:¶

DataImperfection

DebondVCCT( name, initiationStep, surfToSurfInteraction, debondingForceAmplitude=STEP, printToDATFrequency=1, )[source]¶

This method creates a DebondVCCT object. Although the constructor is available both for parts and for the assembly, DebondVCCT objects are currently supported only under the assembly.

Note

This function can be accessed by:

mdb.models[name].parts[name].engineeringFeatures.DebondVCCT
mdb.models[name].rootAssembly.engineeringFeatures.DebondVCCT

Note

Check DebondVCCT on help.3ds.com/2023.

Parameters:¶

name¶: A String specifying the repository key.
initiationStep¶: A String specifying the name of the step in which the DebondVCCT object is created.
surfToSurfInteraction¶: A String specifying the name of the SurfaceToSurfaceContactStd object that defines the surface to surface interaction for the crack surfaces.
debondingForceAmplitude=STEP¶: A SymbolicConstant specifying whether the debond force between the two surfaces at the crack tip is to be released immediately or gradually during the following increment after debonding. Possible values are STEP and RAMP. The default value is STEP.
printToDATFrequency=1¶: An Int specifying the frequency at which output will be printed to DAT file. The default value is 1.

Returns:¶

A DebondVCCT object.

Return type:¶

DebondVCCT

DiscreteFastener( name, region, influenceRadius, ur1=1, ur2=1, ur3=1, coupling=CONTINUUM, weightingMethod=UNIFORM, localCsys=None, )[source]¶

This method creates a DiscreteFastener object. Although the constructor is available both for parts and for the assembly, DiscreteFastener objects are currently supported only under the assembly.

Note

This function can be accessed by:

mdb.models[name].parts[name].engineeringFeatures.DiscreteFastener
mdb.models[name].rootAssembly.engineeringFeatures.DiscreteFastener

Note

Check DiscreteFastener on help.3ds.com/2023.

Parameters:¶

name¶: A String specifying the repository key.
region¶: A Region object specifying the region to which the fastener is applied.
influenceRadius¶: The SymbolicConstant WHOLE_SURFACE or a Float specifying the coupling influence radius.
ur1=1¶: A Boolean specifying whether to constrain rotational displacement component about the 1-direction. The default value is ON.
ur2=1¶: A Boolean specifying whether to constrain rotational displacement component about the 2-direction. The default value is ON.
ur3=1¶: A Boolean specifying whether to constrain rotational displacement component about the 3-direction. The default value is ON.
coupling=CONTINUUM¶: A SymbolicConstant specifying the coupling method used to couple the displacement and rotation of each attachment point to the average motion of the surface nodes within the radius of influence from the fastening point. Possible values are CONTINUUM and STRUCTURAL. The default value is CONTINUUM.
weightingMethod=UNIFORM¶: A SymbolicConstant specifying the weighting scheme to be used to weight the contribution of the displacements of the surface nodes within the radius of influence to the motion of the fastening point. UNIFORM, LINEAR, QUADRATIC, and CUBIC indicate uniform, linear decreasing, quadratic polynomial decreasing, and cubic polynomial monotonic decreasing weight distributions. Possible values are UNIFORM, LINEAR, QUADRATIC, and CUBIC. The default value is UNIFORM.
localCsys=None¶: None or a DatumCsys object specifying the local coordinate system of fastener couplings. If localCsys = None, couplings are defined in the global coordinate system. When this member is queried, it returns an Int. The default value is None.

Returns:¶

A DiscreteFastener object.

Return type:¶

DiscreteFastener

FileImperfection( name, file, step, linearSuperpositions, region=<abaqus.Region.Region.Region object>, increment=-1, )[source]¶

This method creates a FileImperfection object.

Note

This function can be accessed by:

mdb.models[name].rootAssembly.engineeringFeatures.FileImperfection

Parameters:¶

name¶: A String specifying the repository key.
file¶: A String specifying the results file from a previous analysis from which the file imperfection is applied.
step¶: An Int specifying the step number (in the analysis whose file is being used as input to this option) from which the modal or displacement data are to be read.
linearSuperpositions¶: A sequence of sequences of Integers and Floats specifying linearSuperpositions. The items in the table data are described below.
region : Region, default: <abaqus.Region.Region.Region object at 0x7f160e51b0d0>: A Region object specifying the region to which the file imperfection is applied. By default, the imperfection will be applied to all nodes in the model.
increment : int, default: -1: An Int specifying the increment number (in the analysis whose file is being used as input to this option) from which the displacement data are to be read. By default, the data will be read from the last increment available for the specified step.

Returns:¶

A FileImperfection object.

Return type:¶

FileImperfection

HeatCapacitance( name, region, table, temperatureDependency=0, dependencies=0, )[source]¶

This method creates a HeatCapacitance object.

Note

This function can be accessed by:

mdb.models[name].parts[name].engineeringFeatures.HeatCapacitance
mdb.models[name].rootAssembly.engineeringFeatures.HeatCapacitance

Note

Check HeatCapacitance on help.3ds.com/2023.

Parameters:¶

name¶: A String specifying the repository key.
region¶: A Region object specifying the region to which the heat capacitance is applied.
table¶: A sequence of sequences of Floats specifying heat capacitance properties. The items in the table data are described below.
temperatureDependency=0¶: A Boolean specifying whether the data depend on temperature. The default value is OFF.
dependencies=0¶: An Int specifying the number of field variable dependencies. The default value is 0.

Returns:¶

A HeatCapacitance object.

Return type:¶

HeatCapacitance

InputImperfection(name, file, system=R)[source]¶

This method creates a InputImperfection object.

Note

This function can be accessed by:

mdb.models[name].rootAssembly.engineeringFeatures.InputImperfection

Parameters:¶

name¶: A String specifying the repository key.
file¶: A String specifying the name of the alternate input file containing the imperfection data.
system=R¶: A SymbolicConstant specifying the coordinate system. The imperfection values in the alternate input file being used as input to this option would be treated as perturbation values of respective coordinates. Possible values are R, C and S. The default value is R.

Returns:¶

A InputImperfection object.

Return type:¶

InputImperfection

NonstructuralMass( name, region, units, magnitude, distribution=MASS_PROPORTIONAL, )[source]¶

This method creates a NonstructuralMass object.

Note

This function can be accessed by:

mdb.models[name].parts[name].engineeringFeatures.NonstructuralMass
mdb.models[name].rootAssembly.engineeringFeatures.NonstructuralMass

Note

Check NonstructuralMass on help.3ds.com/2023.

Parameters:¶

name¶: A String specifying the repository key.
region¶: A Region object specifying the region to which the mass is applied.
units¶: A SymbolicConstant specifying the units used to specify the nonstructural mass. Possible values are TOTAL_MASS, MASS_PER_VOLUME, MASS_PER_AREA, and MASS_PER_LENGTH.
magnitude¶: A Float specifying the mass magnitude.
distribution=MASS_PROPORTIONAL¶: A SymbolicConstant specifying the distribution of the nonstructural mass. Possible values are MASS_PROPORTIONAL and VOLUME_PROPORTIONAL. The default value is MASS_PROPORTIONAL.The distribution argument applies only when units = TOTAL_MASS.

Returns:¶

A NonstructuralMass object.

Return type:¶

NonstructuralMass

PointFastener( name, region, physicalRadius, directionVector=None, targetSurfaces=MODEL, ur1=1, ur2=1, ur3=1, attachmentMethod=FACETOFACE, influenceRadius=DEFAULT, searchRadius=DEFAULT, maximumLayers=ALL, coupling=CONTINUUM, weightingMethod=UNIFORM, additionalMass=0, adjustOrientation=1, localCsys=None, connectionType=CONNECTOR, sectionName='', connectorOrientationLocalCsys1=None, axis1=AXIS_1, angle1=0, orient2SameAs1=1, connectorOrientationLocalCsys2=None, axis2=AXIS_1, angle2=0, unsorted=0, )[source]¶

This method creates a PointFastener object. Although the constructor is available both for parts and for the assembly, PointFastener objects are currently supported only under the assembly.

Note

This function can be accessed by:

mdb.models[name].parts[name].engineeringFeatures.PointFastener
mdb.models[name].rootAssembly.engineeringFeatures.PointFastener

Note

Check PointFastener on help.3ds.com/2023.

Parameters:¶

name¶: A String specifying the repository key.
region¶: A Region object specifying the region to which fasteners are applied.
physicalRadius¶: A Float specifying the physical fastener radius.
directionVector=None¶: A VertexArray object of length 2 specifying the direction of projection. Instead of through a ConstrainedSketchVertex, each point may be specified through a tuple of coordinates. The default value is None.
targetSurfaces=MODEL¶: A RegionArray object specifying surfaces to be fastened. The default value is MODEL.
ur1=1¶: A Boolean specifying whether to constrain rotational displacement component about the 1-direction. The default value is ON.
ur2=1¶: A Boolean specifying whether to constrain rotational displacement component about the 2-direction. The default value is ON.
ur3=1¶: A Boolean specifying whether to constrain rotational displacement component about the 3-direction. The default value is ON.
attachmentMethod=FACETOFACE¶: A SymbolicConstant specifying the method used to locate points for attaching fasteners. Possible values are FACETOFACE, EDGETOFACE, FACETOEDGE, and EDGETOEDGE. The default value is FACETOFACE.
influenceRadius=DEFAULT¶: The SymbolicConstant DEFAULT or a Float specifying the maximum distance from the projection point on a connected surface within which the nodes on that surface must lie to contribute to the motion of the projection point. If the value is DEFAULT, a radius is computed from the fastener diameter and the surface facet lengths. The default value is DEFAULT.
searchRadius=DEFAULT¶: The SymbolicConstant DEFAULT or a Float specifying the distance from the positioning points within which the connected points must lie. The default value is DEFAULT.
maximumLayers=ALL¶: The SymbolicConstant ALL or an Int specifying the maximum number of layers for each fastener. If the value is ALL, the maximum possible number of layers within the searchRadius will be used for each fastener. The default value is ALL.
coupling=CONTINUUM¶: A SymbolicConstant specifying the coupling method used to couple the displacement and rotation of each attachment point to the average motion of the surface nodes within the radius of influence from the fastener projection point. Possible values are CONTINUUM and STRUCTURAL. The default value is CONTINUUM.
weightingMethod=UNIFORM¶: A SymbolicConstant specifying the weighting scheme to be used to weight the contribution of the displacements of the surface nodes within the radius of influence to the motion of the fastener projection point. UNIFORM, LINEAR, QUADRATIC, and CUBIC indicate uniform, linear decreasing, quadratic polynomial decreasing, and cubic polynomial monotonic decreasing weight distributions. Possible values are UNIFORM, LINEAR, QUADRATIC, and CUBIC. The default value is UNIFORM.
additionalMass=0¶: A Float specifying the mass that will be distributed to fastener attachment points. The default value is 0.0.
adjustOrientation=1¶: A Boolean specifying whether to adjust localCsys such that the local z-axis for each fastener is normal to the surface that is closest to the reference node for that fastener. The default value is ON.
localCsys=None¶: None or a DatumCsys object specifying the local coordinate system. If localCsys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.
connectionType=CONNECTOR¶: A SymbolicConstant specifying the fastener connection type. Possible values are CONNECTOR and BEAM_MPC. The default value is CONNECTOR.
sectionName=''¶: A String specifying the connector section assigned to generated connectors. The default value is an empty string.
connectorOrientationLocalCsys1=None¶: None or a DatumCsys object specifying the local coordinate system of the first connector point in generated connectors. If connectorOrientationLocalCsys1 = None, the degrees of freedom are defined in the global coordinate system. When this member is queried, it returns an Int. The default value is None.
axis1=AXIS_1¶: A SymbolicConstant specifying the axis of a datum coordinate system about which an additional rotation is applied for the first point in generated connectors. 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 for the first point in generated connectors. The default value is 0.0.
orient2SameAs1=1¶: A Boolean specifying whether or not the second connector point in generated connectors is to use the same local coordinate system, axis, and angle as the first point. The default value is ON.
connectorOrientationLocalCsys2=None¶: None or a DatumCsys object specifying the local coordinate system of the second connector point in generated connectors. If connectorOrientationLocalCsys2 = None, the degrees of freedom are defined in the global coordinate system. When this member is queried, it returns an Int. The default value is None.
axis2=AXIS_1¶: A SymbolicConstant specifying the axis of a datum coordinate system about which an additional rotation is applied for the second point in generated connectors. 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 for the second point in generated connectors. The default value is 0.0.
unsorted=0¶: A Boolean specifying whether the analysis product should leave targetSurfaces in the given unsorted order, or sort them by proximity to determine the connectivity of fastening points. The default value is OFF.

Returns:¶

A PointFastener object.

Return type:¶

PointFastener

PointMassInertia( name, region, mass=0, mass1=0, mass2=0, mass3=0, i11=0, i22=0, i33=0, i12=0, i13=0, i23=0, localCsys=None, alpha=0, composite=0, )[source]¶

This method creates a PointMassInertia object.

Note

This function can be accessed by:

mdb.models[name].parts[name].engineeringFeatures.PointMassInertia
mdb.models[name].rootAssembly.engineeringFeatures.PointMassInertia

Note

Check PointMassInertia on help.3ds.com/2023.

Parameters:¶

name¶: A String specifying the repository key.
region¶: A Region object specifying the region to which the mass or rotary inertia is applied.
mass=0¶: A Float specifying the mass magnitude for isotropic mass. This parameter cannot be specified when anisotropic mass terms are specified. The default value is 0.0.
mass1=0¶: A Float specifying the mass in the 1-direction for anisotropic mass. This parameter cannot be specified when isotropic mass is also specified. The default value is 0.0.
mass2=0¶: A Float specifying the mass in the 2-direction for anisotropic mass. This parameter cannot be specified when isotropic mass is also specified. The default value is 0.0.
mass3=0¶: A Float specifying the mass in the 3-direction for anisotropic mass. This parameter cannot be specified when isotropic mass is also specified. The default value is 0.0.
i11=0¶: A Float specifying the rotary inertia about the local 1-axis, I11I11. The default value is 0.0.
i22=0¶: A Float specifying the rotary inertia about the local 2-axis, I22I22. The default value is 0.0.
i33=0¶: A Float specifying the rotary inertia about the local 3-axis, I33I33. The default value is 0.0.
i12=0¶: A Float specifying the product of inertia, I12I12. The default value is 0.0.
i13=0¶: A Float specifying the product of inertia, I13I13. The default value is 0.0.
i23=0¶: A Float specifying the product of inertia, I23I23. The default value is 0.0.
localCsys=None¶: None or a DatumCsys object specifying the local coordinate system for the anisotropic mass terms (when specified), and the rotary inertia (when specified). If localCsys = None, the anisotropic mass and rotary inertia data are defined in the global coordinate system. The default value is None.
alpha=0¶: A Float specifying the alpha damping magnitude. The default value is 0.0.This argument applies only to Abaqus/Standard analyses.
composite=0¶: A Float specifying the composite damping magnitude. The default value is 0.0.This argument applies only to Abaqus/Standard analyses.

Returns:¶

A PointMassInertia object.

Return type:¶

PointMassInertia

SpringDashpotToGround( name, region, dof, orientation=None, springBehavior=0, dashpotBehavior=0, springStiffness=0, dashpotCoefficient=0, )[source]¶

This method creates a SpringDashpotToGround object.

Note

This function can be accessed by:

mdb.models[name].parts[name].engineeringFeatures.SpringDashpotToGround
mdb.models[name].rootAssembly.engineeringFeatures.SpringDashpotToGround

Note

Check SpringDashpotToGround on help.3ds.com/2023.

Parameters:¶

name¶: A String specifying the repository key.
region¶: A Region object specifying the region to which the springs and/or dashpots are applied.
dof¶: An Int specifying the degree of freedom associated with the spring and dashpot behaviors.
orientation=None¶: None or a DatumCsys object specifying the local directions for the spring and/or dashpot. If orientation = None, the spring and/or dashpot data are defined in the global coordinate system. The default value is None.
springBehavior=0¶: A Boolean specifying whether to apply spring behavior to the selected points. The default value is OFF.At least one of the arguments springBehavior = ON or dashpotBehavior = ON must be specified.
dashpotBehavior=0¶: A Boolean specifying whether to apply dashpot behavior to the selected points. The default value is OFF.At least one of the arguments springBehavior = ON or dashpotBehavior = ON must be specified.
springStiffness=0¶: A Float specifying the force per relative displacement for the spring. The default value is 0.0.
dashpotCoefficient=0¶: A Float specifying the force per relative velocity for the dashpot. The default value is 0.0.

Returns:¶

A SpringDashpotToGround object.

Return type:¶

SpringDashpotToGround

TwoPointSpringDashpot( name, regionPairs, axis, dof1=0, dof2=0, orientation=None, springBehavior=0, dashpotBehavior=0, springStiffness=0, dashpotCoefficient=0, )[source]¶

This method creates a TwoPointSpringDashpot object.

Note

This function can be accessed by:

mdb.models[name].parts[name].engineeringFeatures.TwoPointSpringDashpot
mdb.models[name].rootAssembly.engineeringFeatures.TwoPointSpringDashpot

Note

Check TwoPointSpringDashpot on help.3ds.com/2023.

Parameters:¶

name¶: A String specifying the repository key.
regionPairs¶: A sequence of pairs of Region objects specifying the points between which the springs and/or dashpots are applied.
axis¶: A SymbolicConstant specifying whether the axis of the springs and/or dashpots follows the rotation of the nodes or is in a specified direction. Possible values are NODAL_LINE and FIXED_DOF.
dof1=0¶: An Int specifying the degree of freedom with which the springs and/or dashpots are associated at their first points. The dof1 argument applies only when axis = FIXED_DOFS. The default value is 0.
dof2=0¶: An Int specifying the degree of freedom with which the springs and/or dashpots are associated at their second points. The dof2 argument applies only when axis = FIXED_DOFS. The default value is 0.
orientation=None¶: None or a DatumCsys object specifying the local directions for the spring and/or dashpot. If orientation = None, the spring and/or dashpot data are defined in the global coordinate system. The default value is None.The orientation argument applies only when axis = FIXED_DOFS.
springBehavior=0¶: A Boolean specifying whether to apply spring behavior to the selected point pairs. The default value is OFF.At least one of the arguments springBehavior = ON or dashpotBehavior = ON must be specified.
dashpotBehavior=0¶: A Boolean specifying whether to apply dashpot behavior to the selected point pairs. The default value is OFF.At least one of the arguments springBehavior = ON or dashpotBehavior = ON must be specified.
springStiffness=0¶: A Float specifying the force per relative displacement for the springs. The default value is 0.0.
dashpotCoefficient=0¶: A Float specifying the force per relative velocity for the dashpots. The default value is 0.0.

Returns:¶

A TwoPointSpringDashpot object.

Return type:¶

TwoPointSpringDashpot

XFEMCrack( name, crackDomain, allowCrackGrowth=1, crackLocation=None, singularityCalcRadius=None, interactionProperty='', elemId=(), nodeId=(), hasCrackFront=(), crackPlaneDist=(), crackFrontDist=(), autoDetectValue='', )[source]¶

This method creates a XFEMCrack object. Although the constructor is available both for parts and for the assembly, XFEMCrack objects are currently supported only under the assembly.

Note

This function can be accessed by:

mdb.models[name].parts[name].engineeringFeatures.XFEMCrack
mdb.models[name].rootAssembly.engineeringFeatures.XFEMCrack

Note

Check XFEMCrack on help.3ds.com/2023.

Parameters:¶

name¶: A String specifying the repository key.
crackDomain¶: A Region object specifying the region that contains the crack or is likely to contain the crack.
allowCrackGrowth=1¶: A Boolean specifying whether the crack is allowed to propagate (grow). The default value is ON.
crackLocation=None¶: A Region object specifying the initial crack location. This parameter is required when allowCrackGrowth = OFF.
singularityCalcRadius=None¶: None or a Float specifying the radius from the crack tips within which the elements are used for crack singularity calculations. This argument applies only when allowCrackGrowth = OFF. The default value is None.
interactionProperty=''¶: A String specifying the name of the ContactProperty object that defines the contact properties for the crack surfaces. The default value is an empty string.
elemId=()¶: A sequence of Ints specifying the labels of the elements that are intersected by the initial crack location. This argument is used only by the input file reader.
nodeId=()¶: A sequence of Ints specifying the position of a node in the corresponding element connectivity. This argument is used only by the input file reader.
hasCrackFront=()¶: A sequence of Ints specifying the values indicating the inclusion/exclusion of the crackFrontDist values. A zero value indicates that crackFrontDist is not specified for the ith pair elemId and nodeId. This argument is used only by the input file reader.
crackPlaneDist=()¶: A sequence of Floats specifying the values of the first signed distance function. This argument is used by the input file reader.
crackFrontDist=()¶: A sequence of Floats specifying the values of the second signed distance function. This argument is used only by the input file reader.
autoDetectValue=''¶: An integer specifying the number of element layers around the crack location, to which the crack domain is shrunk.

Returns:¶

A XFEMCrack object.

Return type:¶

XFEMCrack

Other Classes¶

class AssembledFastener( name, region, templateModel, controlSet, templateSurfaces, assignedSurfaces, propertyPrefix, orientMethod=NORMALS, localCsys=None, scriptName='', )[source]¶

Bases: Fastener

The AssembledFastener object defines an assembled fastener. The AssembledFastener object is derived from the Fastener object.

Note

This object can be accessed by:

import part
mdb.models[name].parts[name].engineeringFeatures.fasteners[name]
import assembly
mdb.models[name].rootAssembly.engineeringFeatures.fasteners[name]

Note

Check AssembledFastener on help.3ds.com/2023.

Member Details:

assignedSurfaces : --is-rst--:py:class:`tuple`\ \[:py:class:`str`, :py:data:`...<Ellipsis>`] = ()[source]¶: A sequence of Strings specifying the names of the main model surfaces that will be substituted for the template model constraint surfaces.

controlSet : --is-rst--:py:class:`~abaqus.Region.Region.Region`[source]¶: A Region object specifying the template model control point set. The set must contain a single node or vertex.

localCsys : --is-rst--:py:class:`int` | :py:obj:`None` = None[source]¶: None or a DatumCsys object specifying the local coordinate system. If localCsys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.This argument applies only when orientMethod = CSYS.

orientMethod : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'NORMALS'[source]¶: A SymbolicConstant specifying the method used to orient the virtual instances of the template model at each attachment point. Possible values are NORMALS and CSYS. The default value is NORMALS.

propertyPrefix : --is-rst--:py:class:`str`[source]¶: A String specifying the name of the property prefix string. This string will be prepended to every property name as it is copied to the main model from the template model.

region : --is-rst--:py:class:`~abaqus.Region.Region.Region`[source]¶: A Region object specifying the region of attachment points to which assembled fasteners are applied.

scriptName : --is-rst--:py:class:`str` = ''[source]¶: A String specifying the name of the property generation script. The default value is an empty string.

setValues(orientMethod=NORMALS, localCsys=None, scriptName='')[source]¶

This method modifies the AssembledFastener object.

Note

Check AssembledFastener.setValues on help.3ds.com/2023.

Parameters:¶

orientMethod=NORMALS¶: A SymbolicConstant specifying the method used to orient the virtual instances of the template model at each attachment point. Possible values are NORMALS and CSYS. The default value is NORMALS.
localCsys=None¶: None or a DatumCsys object specifying the local coordinate system. If localCsys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.This argument applies only when orientMethod = CSYS.
scriptName=''¶: A String specifying the name of the property generation script. The default value is an empty string.

suppressed : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]¶: A Boolean specifying whether the fastener is suppressed or not. The default value is OFF.

templateModel : --is-rst--:py:class:`str`[source]¶: A String specifying the name of the template model.

templateSurfaces : --is-rst--:py:class:`tuple`\ \[:py:class:`str`, :py:data:`...<Ellipsis>`] = ()[source]¶: A sequence of Strings specifying the names of the template model surfaces that are referenced by tie or coupling constraints.

class Fastener[source]¶

Bases: object

The Fastener object is the abstract base type for PointFastener, DiscreteFastener, and AssembledFastener.

Note

This object can be accessed by:

import part
mdb.models[name].parts[name].engineeringFeatures.fasteners[name]
import assembly
mdb.models[name].rootAssembly.engineeringFeatures.fasteners[name]

Note

Check Fastener on help.3ds.com/2023.

Member Details:

name : --is-rst--:py:class:`str` = ''[source]¶: A String specifying the repository key.

resume()[source]¶: This method resumes the fastener that was previously suppressed.

suppress()[source]¶: This method suppresses the fastener.

suppressed : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]¶: A Boolean specifying whether the fastener is suppressed or not. The default value is OFF.

class ContourIntegral( name, crackFront, crackTip, extensionDirectionMethod, symmetric=0, listOfRegions=0, crackFrontName='', crackTipName='', crackNormal=(), qVectors=(), midNodePosition=0, collapsedElementAtTip=NONE, )[source]¶

Bases: Crack

The ContourIntegral object defines contour integral objects on an region. Currently only assembly regions are supported. The ContourIntegral object is derived from the Crack object.

Note

This object can be accessed by:

import part
mdb.models[name].parts[name].engineeringFeatures.cracks[name]
import assembly
mdb.models[name].rootAssembly.engineeringFeatures.cracks[name]

The corresponding analysis keywords are:

CONTOUR INTEGRAL

Note

Check ContourIntegral on help.3ds.com/2023.

Member Details:

collapsedElementAtTip : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'NONE'[source]¶: A SymbolicConstant specifying the crack-tip singularity. Possible values are NONE, SINGLE_NODE, and DUPLICATE_NODES. The default value is NONE.

crackFront : --is-rst--:py:class:`~typing.List`\ \[:py:class:`~abaqus.Region.Region.Region`][source]¶: A RegionArray object specifying the crack-front region to which the contour integral is applied. If the crack-front consists of a single region, a Region object may be specified instead of a sequence with a single item in it.

crackFrontName : --is-rst--:py:class:`str` = ''[source]¶: A String specifying the name of the crack-front region generated from the tuple of regions specifying the crack-front region. This argument is valid only when listOfRegions is ON. The default value is name + Front.

crackNormal : --is-rst--:py:class:`tuple`\ \[:py:class:`tuple`\ \[:py:class:`float`, :py:data:`...<Ellipsis>`], :py:data:`...<Ellipsis>`] = ()[source]¶: A sequence of sequences of Floats specifying the two points of the vector that describes the crack normal direction. Each point is defined by a tuple of two or three coordinates indicating its position. This argument is required only when extensionDirectionMethod = CRACK_NORMAL. The default value is an empty sequence.

crackTip : --is-rst--:py:class:`~typing.List`\ \[:py:class:`~abaqus.Region.Region.Region`][source]¶: A RegionArray object specifying the crack-tip region to which the contour integral is applied. If the crack-tip consists of a single region, a Region object may be specified instead of a sequence with a single item in it.

crackTipName : --is-rst--:py:class:`str` = ''[source]¶: A String specifying the name of the crack-tip region generated from the tuple of regions specifying the crack-tip region. This parameter is valid only when listOfRegions = ON. The default value is name + Tip.

extensionDirectionMethod : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶: A SymbolicConstant specifying how the virtual crack extension direction vectors are defined. Possible values are CRACK_NORMAL and Q_VECTORS.

listOfRegions : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]¶: A Boolean specifying whether the regions specified by crackFront and crackTip are specified using a single region or tuples of region objects. The default value is OFF.

midNodePosition : --is-rst--:py:class:`float` = 0[source]¶: A Float specifying the position of the midside node along the edges of the second-order elements that radiate from the crack tip. Possible values are 0.0 < midNodeParameter < 1.0. The default value is 0.5.

qVectors : --is-rst--:py:class:`tuple`\ \[:py:class:`tuple`\ \[:py:class:`float`, :py:data:`...<Ellipsis>`], :py:data:`...<Ellipsis>`] = ()[source]¶: A sequence of sequences of sequences of Floats specifying the vectors that indicate the set of crack extension directions. Each vector is described by a tuple of two points, and each point is described by a tuple of two or three coordinates indicating its position. This argument is required only when extensionDirectionMethod = Q_VECTORS. The default value is an empty sequence.

setValues( symmetric=0, listOfRegions=0, crackFrontName='', crackTipName='', crackNormal=(), qVectors=(), midNodePosition=0, collapsedElementAtTip=NONE, )[source]¶

This method modifies the ContourIntegral object.

Note

Check ContourIntegral.setValues on help.3ds.com/2023.

Parameters:¶

symmetric=0¶: A Boolean specifying whether the crack is defined on a half model (about a symmetry plane) or whether it is defined on the whole model. The default value is OFF.
listOfRegions=0¶: A Boolean specifying whether the regions specified by crackFront and crackTip are specified using a single region or tuples of region objects. The default value is OFF.
crackFrontName=''¶: A String specifying the name of the crack-front region generated from the tuple of regions specifying the crack-front region. This argument is valid only when listOfRegions is ON. The default value is name + Front.
crackTipName=''¶: A String specifying the name of the crack-tip region generated from the tuple of regions specifying the crack-tip region. This parameter is valid only when listOfRegions = ON. The default value is name + Tip.
crackNormal=()¶: A sequence of sequences of Floats specifying the two points of the vector that describes the crack normal direction. Each point is defined by a tuple of two or three coordinates indicating its position. This argument is required only when extensionDirectionMethod = CRACK_NORMAL. The default value is an empty sequence.
qVectors=()¶: A sequence of sequences of sequences of Floats specifying the vectors that indicate the set of crack extension directions. Each vector is described by a tuple of two points, and each point is described by a tuple of two or three coordinates indicating its position. This argument is required only when extensionDirectionMethod = Q_VECTORS. The default value is an empty sequence.
midNodePosition=0¶: A Float specifying the position of the midside node along the edges of the second-order elements that radiate from the crack tip. Possible values are 0.0 < midNodeParameter < 1.0. The default value is 0.5.
collapsedElementAtTip=NONE¶: A SymbolicConstant specifying the crack-tip singularity. Possible values are NONE, SINGLE_NODE, and DUPLICATE_NODES. The default value is NONE.

suppressed : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]¶: A Boolean specifying whether the crack is suppressed or not. The default value is OFF.

symmetric : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]¶: A Boolean specifying whether the crack is defined on a half model (about a symmetry plane) or whether it is defined on the whole model. The default value is OFF.

class Crack[source]¶

Bases: object

The Crack object is the abstract base type for ContourIntegral and future crack objects.

Note

This object can be accessed by:

import part
mdb.models[name].parts[name].engineeringFeatures.cracks[name]
import assembly
mdb.models[name].rootAssembly.engineeringFeatures.cracks[name]

Note

Check Crack on help.3ds.com/2023.

Member Details:

name : --is-rst--:py:class:`str` = ''[source]¶: A String specifying the repository key.

resume()[source]¶: This method resumes the crack that was previously suppressed.

suppress()[source]¶: This method suppresses the crack.

suppressed : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]¶: A Boolean specifying whether the crack is suppressed or not. The default value is OFF.

class DataImperfection(name, imperfectionTable, system=R)[source]¶

Bases: Imperfection

The DataImperfection object defines geometric imperfection on an assembly region. The DataImperfection object is derived from the Imperfection object.

Note

This object can be accessed by:

import assembly
mdb.models[name].rootAssembly.engineeringFeatures.imperfections[name]

The corresponding analysis keywords are:

IMPERFECTION

The table data for this object are:

Node number.
Component of imperfection in the first coordinate direction.
Component of imperfection in the second coordinate direction.
Component of imperfection in the third coordinate direction.

Added in version 2023: The DataImperfection class was added.

Member Details:

imperfectionTable : --is-rst--:py:class:`tuple`\ \[:py:class:`tuple`\ \[:py:class:`int` | :py:class:`float`, :py:data:`...<Ellipsis>`], :py:data:`...<Ellipsis>`] = ()[source]¶: A sequence of sequences of Ints and Floats specifying the imperfection components at a given node. The items in the table data are described below.

setValues(imperfectionTable, system=R)[source]¶

This method modifies the DataImperfection object.

Parameters:¶

imperfectionTable¶: A sequence of sequences of Ints and Floats specifying the imperfection components at a given node. The items in the table data are described below.
system=R¶: A SymbolicConstant specifying the coordinate system. The imperfection values in the data lines would be treated as perturbation values of the respective coordinates. Possible values are R, C, and S. The default value is R.

suppressed : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]¶: A Boolean specifying whether the imperfection is suppressed or not. The default value is OFF.

system : --is-rst--:py:data:`~typing.Literal`\ \[``R``, ``C``, ``S``] = 'R'[source]¶: A SymbolicConstant specifying the coordinate system. The imperfection values in the data lines would be treated as perturbation values of the respective coordinates. Possible values are R, C, and S. The default value is R.

class Imperfection[source]¶

Bases: object

The Imperfection object is the abstract base type for FileImperfection, InputImperfection, and DataImperfection.

Note

This object can be accessed by:

import assembly
mdb.models[name].rootAssembly.engineeringFeatures.imperfections[name]

Added in version 2023: The Imperfection class was added.

Note

Check Imperfection on help.3ds.com/2023.

Member Details:

name : --is-rst--:py:class:`str` = ''[source]¶: A String specifying the repository key.

resume()[source]¶: This method resumes the imperfection that was previously suppressed.

suppress()[source]¶: This method suppresses the imperfection.

suppressed : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]¶: A Boolean specifying whether the fastener is suppressed or not. The default value is OFF.

class DebondVCCT( name, initiationStep, surfToSurfInteraction, debondingForceAmplitude=STEP, printToDATFrequency=1, )[source]¶

Bases: Crack

The DebondVCCT object defines the parameters needed to activate crack propagation using VCCT. The DebondVCCT object is derived from the Crack object.

Note

This object can be accessed by:

import part
mdb.models[name].parts[name].engineeringFeatures.cracks[name]
import assembly
mdb.models[name].rootAssembly.engineeringFeatures.cracks[name]

The corresponding analysis keywords are:

DEBOND

Note

Check DebondVCCT on help.3ds.com/2023.

Member Details:

debondingForceAmplitude : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'STEP'[source]¶: A SymbolicConstant specifying whether the debond force between the two surfaces at the crack tip is to be released immediately or gradually during the following increment after debonding. Possible values are STEP and RAMP. The default value is STEP.

initiationStep : --is-rst--:py:class:`str`[source]¶: A String specifying the name of the step in which the DebondVCCT object is created.

printToDATFrequency : --is-rst--:py:class:`int` = 1[source]¶: An Int specifying the frequency at which output will be printed to DAT file. The default value is 1.

setValues(debondingForceAmplitude=STEP, printToDATFrequency=1)[source]¶

This method modifies the DebondVCCT object.

Note

Check DebondVCCT.setValues on help.3ds.com/2023.

Parameters:¶

debondingForceAmplitude=STEP¶: A SymbolicConstant specifying whether the debond force between the two surfaces at the crack tip is to be released immediately or gradually during the following increment after debonding. Possible values are STEP and RAMP. The default value is STEP.
printToDATFrequency=1¶: An Int specifying the frequency at which output will be printed to DAT file. The default value is 1.

suppressed : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]¶: A Boolean specifying whether the crack is suppressed or not. The default value is OFF.

surfToSurfInteraction : --is-rst--:py:class:`str`[source]¶: A String specifying the name of the SurfaceToSurfaceContactStd object that defines the surface to surface interaction for the crack surfaces.

class DiscreteFastener( name, region, influenceRadius, ur1=1, ur2=1, ur3=1, coupling=CONTINUUM, weightingMethod=UNIFORM, localCsys=None, )[source]¶

Bases: Fastener

The DiscreteFastener object defines a discrete fastener. The DiscreteFastener object is derived from the Fastener object.

Note

This object can be accessed by:

import part
mdb.models[name].parts[name].engineeringFeatures.fasteners[name]
import assembly
mdb.models[name].rootAssembly.engineeringFeatures.fasteners[name]

The corresponding analysis keywords are:

COUPLING

Note

Check DiscreteFastener on help.3ds.com/2023.

Member Details:

coupling : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'CONTINUUM'[source]¶: A SymbolicConstant specifying the coupling method used to couple the displacement and rotation of each attachment point to the average motion of the surface nodes within the radius of influence from the fastening point. Possible values are CONTINUUM and STRUCTURAL. The default value is CONTINUUM.

influenceRadius : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`, :py:class:`float`][source]¶: The SymbolicConstant WHOLE_SURFACE or a Float specifying the coupling influence radius.

localCsys : --is-rst--:py:class:`int` | :py:obj:`None` = None[source]¶: None or a DatumCsys object specifying the local coordinate system of fastener couplings. If localCsys = None, couplings are defined in the global coordinate system. When this member is queried, it returns an Int. The default value is None.

region : --is-rst--:py:class:`~abaqus.Region.Region.Region`[source]¶: A Region object specifying the region to which the fastener is applied.

setValues( ur1=1, ur2=1, ur3=1, coupling=CONTINUUM, weightingMethod=UNIFORM, localCsys=None, )[source]¶

This method modifies the DiscreteFastener object.

Note

Check DiscreteFastener.setValues on help.3ds.com/2023.

Parameters:¶

ur1=1¶: A Boolean specifying whether to constrain rotational displacement component about the 1-direction. The default value is ON.
ur2=1¶: A Boolean specifying whether to constrain rotational displacement component about the 2-direction. The default value is ON.
ur3=1¶: A Boolean specifying whether to constrain rotational displacement component about the 3-direction. The default value is ON.
coupling=CONTINUUM¶: A SymbolicConstant specifying the coupling method used to couple the displacement and rotation of each attachment point to the average motion of the surface nodes within the radius of influence from the fastening point. Possible values are CONTINUUM and STRUCTURAL. The default value is CONTINUUM.
weightingMethod=UNIFORM¶: A SymbolicConstant specifying the weighting scheme to be used to weight the contribution of the displacements of the surface nodes within the radius of influence to the motion of the fastening point. UNIFORM, LINEAR, QUADRATIC, and CUBIC indicate uniform, linear decreasing, quadratic polynomial decreasing, and cubic polynomial monotonic decreasing weight distributions. Possible values are UNIFORM, LINEAR, QUADRATIC, and CUBIC. The default value is UNIFORM.
localCsys=None¶: None or a DatumCsys object specifying the local coordinate system of fastener couplings. If localCsys = None, couplings are defined in the global coordinate system. When this member is queried, it returns an Int. The default value is None.

suppressed : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]¶: A Boolean specifying whether the fastener is suppressed or not. The default value is OFF.

ur1 : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 1[source]¶: A Boolean specifying whether to constrain rotational displacement component about the 1-direction. The default value is ON.

ur2 : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 1[source]¶: A Boolean specifying whether to constrain rotational displacement component about the 2-direction. The default value is ON.

ur3 : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 1[source]¶: A Boolean specifying whether to constrain rotational displacement component about the 3-direction. The default value is ON.

weightingMethod : --is-rst--:py:data:`~typing.Literal`\ \[``QUADRATIC``, ``UNIFORM``, ``CUBIC``, ``LINEAR``] = 'UNIFORM'[source]¶: A SymbolicConstant specifying the weighting scheme to be used to weight the contribution of the displacements of the surface nodes within the radius of influence to the motion of the fastening point. UNIFORM, LINEAR, QUADRATIC, and CUBIC indicate uniform, linear decreasing, quadratic polynomial decreasing, and cubic polynomial monotonic decreasing weight distributions. Possible values are UNIFORM, LINEAR, QUADRATIC, and CUBIC. The default value is UNIFORM.

class EngineeringFeatureBase[source]¶

Bases: object

The EngineeringFeature object is a container for various specific engineering feature repositories. The EngineeringFeature object has no explicit constructor or methods.

Note

This object can be accessed by:

import part
mdb.models[name].parts[name].engineeringFeatures
import assembly
mdb.models[name].rootAssembly.engineeringFeatures

Note

Check EngineeringFeatureBase on help.3ds.com/2023.

Member Details:

assignSeam(regions)[source]¶

This method creates a seam crack along an edge or a face.

Note

Check EngineeringFeatureBase.assignSeam on help.3ds.com/2023.

Parameters:¶

regions¶: A sequence of Region objects specifying the domain of the seam crack. The Region objects must be faces or edges.

cracks : --is-rst--:py:class:`dict`\ \[:py:class:`str`, :py:class:`~abaqus.EngineeringFeature.Crack.Crack`] = {}[source]¶: A repository of Crack objects.

deleteSeam(regions)[source]¶

This method deletes a seam crack.

Note

Check EngineeringFeatureBase.deleteSeam on help.3ds.com/2023.

Parameters:¶

regions¶: A sequence of Region objects specifying the domain of the seam crack. The Region objects must be faces or edges.

fasteners : --is-rst--:py:class:`dict`\ \[:py:class:`str`, :py:class:`~abaqus.EngineeringFeature.Fastener.Fastener`] = {}[source]¶: A repository of Fastener objects.

imperfections : --is-rst--:py:class:`dict`\ \[:py:class:`str`, :py:class:`~abaqus.EngineeringFeature.Imperfection.Imperfection`] = {}[source]¶: A repository of Imperfection objects.

inertias : --is-rst--:py:class:`dict`\ \[:py:class:`str`, :py:class:`~abaqus.EngineeringFeature.Inertia.Inertia`] = {}[source]¶: A repository of Inertia objects.

springDashpots : --is-rst--:py:class:`dict`\ \[:py:class:`str`, :py:class:`~abaqus.EngineeringFeature.SpringDashpot.SpringDashpot`] = {}[source]¶: A repository of SpringDashpot objects.

class FileImperfection( name, file, step, linearSuperpositions, region=<abaqus.Region.Region.Region object>, increment=-1, )[source]¶

Bases: Imperfection

The FileImperfection object defines geometric imperfection on an assembly region. The FileImperfection object is derived from the Imperfection object.

Note

This object can be accessed by:

import assembly
mdb.models[name].rootAssembly.engineeringFeatures.imperfections[name]

The corresponding analysis keywords are:

IMPERFECTION

The table data for this object are:

Mode Number.
Scaling factor for this mode.

Added in version 2023: The FileImperfection class was added.

Member Details:

file : --is-rst--:py:class:`str`[source]¶: A String specifying the results file from a previous analysis from which the file imperfection is applied.

increment : --is-rst--:py:class:`int` = -1[source]¶: An Int specifying the increment number (in the analysis whose file is being used as input to this option) from which the displacement data are to be read. By default, the data will be read from the last increment available for the specified step.

linearSuperpositions : --is-rst--:py:class:`tuple`\ \[:py:class:`tuple`\ \[:py:class:`int` | :py:class:`float`, :py:data:`...<Ellipsis>`], :py:data:`...<Ellipsis>`] = ()[source]¶: A sequence of sequences of Integers and Floats specifying linearSuperpositions. The items in the table data are described below.

region : --is-rst--:py:class:`~abaqus.Region.Region.Region` = <abaqus.Region.Region.Region object>[source]¶: A Region object specifying the region to which the file imperfection is applied. By default, the imperfection will be applied to all nodes in the model.

setValues( file, step, linearSuperpositions, region=<abaqus.Region.Region.Region object>, increment=-1, )[source]¶

This method modifies the FileImperfection object.

Parameters:¶

file¶: A String specifying the results file from a previous analysis from which the file imperfection is applied.
step¶: An Int specifying the step number (in the analysis whose file is being used as input to this option) from which the modal or displacement data are to be read.
linearSuperpositions¶: A sequence of sequences of Integers and Floats specifying linearSuperpositions. The items in the table data are described below.
region : Region, default: <abaqus.Region.Region.Region object at 0x7f160e6ff250>: A Region object specifying the region to which the file imperfection is applied. By default, the imperfection will be applied to all nodes in the model.
increment : int, default: -1: An Int specifying the increment number (in the analysis whose file is being used as input to this option) from which the displacement data are to be read. By default, the data will be read from the last increment available for the specified step.

step : --is-rst--:py:class:`int`[source]¶: An Int specifying the step number (in the analysis whose file is being used as input to this option) from which the modal or displacement data are to be read.

suppressed : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]¶: A Boolean specifying whether the imperfection is suppressed or not. The default value is OFF.

class HeatCapacitance(name, region, table, temperatureDependency=0, dependencies=0)[source]¶

Bases: Inertia

The HeatCapacitance object defines point heat capacitance on a part or an assembly region. The HeatCapacitance object is derived from the Inertia object.

Note

This object can be accessed by:

import part
mdb.models[name].parts[name].engineeringFeatures.inertias[name]
import assembly
mdb.models[name].rootAssembly.engineeringFeatures.inertias[name]

The table data specify the following:

Heat capacitance magnitude, ρcVρ⁢c⁢V (density x specific heat x volume).
Temperature, if the data depend on temperature.
Value of the first field variable, if the data depend on field variables.
Value of the second field variable.
Etc.

The corresponding analysis keywords are:

HEATCAP

Note

Check HeatCapacitance on help.3ds.com/2023.

Member Details:

dependencies : --is-rst--:py:class:`int` = 0[source]¶: An Int specifying the number of field variable dependencies. The default value is 0.

region : --is-rst--:py:class:`~abaqus.Region.Region.Region`[source]¶: A Region object specifying the region to which the heat capacitance is applied.

setValues(temperatureDependency=0, dependencies=0)[source]¶

This method modifies the HeatCapacitance object.

Note

Check HeatCapacitance.setValues on help.3ds.com/2023.

Parameters:¶

temperatureDependency=0¶: A Boolean specifying whether the data depend on temperature. The default value is OFF.
dependencies=0¶: An Int specifying the number of field variable dependencies. The default value is 0.

suppressed : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]¶: A Boolean specifying whether the inertia is suppressed or not. The default value is OFF.

table : --is-rst--:py:class:`tuple`\ \[:py:class:`tuple`\ \[:py:class:`float`, :py:data:`...<Ellipsis>`], :py:data:`...<Ellipsis>`] = ()[source]¶: A sequence of sequences of Floats specifying heat capacitance properties. The items in the table data are described below.

temperatureDependency : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]¶: A Boolean specifying whether the data depend on temperature. The default value is OFF.

class InputImperfection(name, file, system=R)[source]¶

Bases: Imperfection

The InputImperfection object defines geometric imperfection on an assembly region. The InputImperfection object is derived from the Imperfection object.

Note

This object can be accessed by:

import assembly
mdb.models[name].rootAssembly.engineeringFeatures.imperfections[name]

The corresponding analysis keywords are:

IMPERFECTION

Added in version 2023: The InputImperfection class was added.

Member Details:

file : --is-rst--:py:class:`str`[source]¶: A String specifying the name of the alternate input file containing the imperfection data.

setValues(file, system=R)[source]¶

This method modifies the InputImperfection object.

Parameters:¶

file¶: A String specifying the name of the alternate input file containing the imperfection data.
system=R¶: A SymbolicConstant specifying the coordinate system. The imperfection values in the alternate input file being used as input to this option would be treated as perturbation values of respective coordinates. Possible values are R, C and S. The default value is R.

suppressed : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]¶: A Boolean specifying whether the imperfection is suppressed or not. The default value is OFF.

system : --is-rst--:py:data:`~typing.Literal`\ \[``R``, ``C``, ``S``] = 'R'[source]¶: A SymbolicConstant specifying the coordinate system. The imperfection values in the alternate input file being used as input to this option would be treated as perturbation values of respective coordinates. Possible values are R, C and S. The default value is R.

class NonstructuralMass(name, region, units, magnitude, distribution=MASS_PROPORTIONAL)[source]¶

Bases: Inertia

The NonstructuralMass object defines the mass contribution from nonstructural features into the model. The NonstructuralMass object is derived from the Inertia object.

Note

This object can be accessed by:

import part
mdb.models[name].parts[name].engineeringFeatures.inertias[name]
import assembly
mdb.models[name].rootAssembly.engineeringFeatures.inertias[name]

The corresponding analysis keywords are:

NONSTRUCTURAL MASS

Note

Check NonstructuralMass on help.3ds.com/2023.

Member Details:

distribution : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'MASS_PROPORTIONAL'[source]¶: A SymbolicConstant specifying the distribution of the nonstructural mass. Possible values are MASS_PROPORTIONAL and VOLUME_PROPORTIONAL. The default value is MASS_PROPORTIONAL.The distribution argument applies only when units = TOTAL_MASS.

magnitude : --is-rst--:py:class:`float`[source]¶: A Float specifying the mass magnitude.

region : --is-rst--:py:class:`~abaqus.Region.Region.Region`[source]¶: A Region object specifying the region to which the mass is applied.

setValues(distribution=MASS_PROPORTIONAL)[source]¶

This method modifies the NonstructuralMass object.

Note

Check NonstructuralMass.setValues on help.3ds.com/2023.

Parameters:¶

distribution=MASS_PROPORTIONAL¶: A SymbolicConstant specifying the distribution of the nonstructural mass. Possible values are MASS_PROPORTIONAL and VOLUME_PROPORTIONAL. The default value is MASS_PROPORTIONAL.The distribution argument applies only when units = TOTAL_MASS.

suppressed : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]¶: A Boolean specifying whether the inertia is suppressed or not. The default value is OFF.

units : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶: A SymbolicConstant specifying the units used to specify the nonstructural mass. Possible values are TOTAL_MASS, MASS_PER_VOLUME, MASS_PER_AREA, and MASS_PER_LENGTH.

class PointFastener( name, region, physicalRadius, directionVector=None, targetSurfaces=MODEL, ur1=1, ur2=1, ur3=1, attachmentMethod=FACETOFACE, influenceRadius=DEFAULT, searchRadius=DEFAULT, maximumLayers=ALL, coupling=CONTINUUM, weightingMethod=UNIFORM, additionalMass=0, adjustOrientation=1, localCsys=None, connectionType=CONNECTOR, sectionName='', connectorOrientationLocalCsys1=None, axis1=AXIS_1, angle1=0, orient2SameAs1=1, connectorOrientationLocalCsys2=None, axis2=AXIS_1, angle2=0, unsorted=0, )[source]¶

Bases: Fastener

The PointFastener object defines a point fastener. The PointFastener object is derived from the Fastener object.

Note

This object can be accessed by:

import part
mdb.models[name].parts[name].engineeringFeatures.fasteners[name]
import assembly
mdb.models[name].rootAssembly.engineeringFeatures.fasteners[name]

The corresponding analysis keywords are:

FASTENER

Note

Check PointFastener on help.3ds.com/2023.

Member Details:

additionalMass : --is-rst--:py:class:`float` = 0[source]¶: A Float specifying the mass that will be distributed to fastener attachment points. The default value is 0.0.

adjustOrientation : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 1[source]¶: A Boolean specifying whether to adjust localCsys such that the local z-axis for each fastener is normal to the surface that is closest to the reference node for that fastener. The default value is ON.

angle1 : --is-rst--:py:class:`float` = 0[source]¶: A Float specifying the angle of the additional rotation for the first point in generated connectors. The default value is 0.0.

angle2 : --is-rst--:py:class:`float` = 0[source]¶: A Float specifying the angle of the additional rotation for the second point in generated connectors. The default value is 0.0.

attachmentMethod : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'FACETOFACE'[source]¶: A SymbolicConstant specifying the method used to locate points for attaching fasteners. Possible values are FACETOFACE, EDGETOFACE, FACETOEDGE, and EDGETOEDGE. The default value is FACETOFACE.

axis1 : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'AXIS_1'[source]¶: A SymbolicConstant specifying the axis of a datum coordinate system about which an additional rotation is applied for the first point in generated connectors. 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'[source]¶: A SymbolicConstant specifying the axis of a datum coordinate system about which an additional rotation is applied for the second point in generated connectors. Possible values are AXIS_1, AXIS_2, and AXIS_3. The default value is AXIS_1.

connectionType : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'CONNECTOR'[source]¶: A SymbolicConstant specifying the fastener connection type. Possible values are CONNECTOR and BEAM_MPC. The default value is CONNECTOR.

connectorOrientationLocalCsys1 : --is-rst--:py:class:`int` | :py:obj:`None` = None[source]¶: None or a DatumCsys object specifying the local coordinate system of the first connector point in generated connectors. If connectorOrientationLocalCsys1 = None, the degrees of freedom are defined in the global coordinate system. When this member is queried, it returns an Int. The default value is None.

connectorOrientationLocalCsys2 : --is-rst--:py:class:`int` | :py:obj:`None` = None[source]¶: None or a DatumCsys object specifying the local coordinate system of the second connector point in generated connectors. If connectorOrientationLocalCsys2 = None, the degrees of freedom are defined in the global coordinate system. When this member is queried, it returns an Int. The default value is None.

coupling : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'CONTINUUM'[source]¶: A SymbolicConstant specifying the coupling method used to couple the displacement and rotation of each attachment point to the average motion of the surface nodes within the radius of influence from the fastener projection point. Possible values are CONTINUUM and STRUCTURAL. The default value is CONTINUUM.

directionVector : --is-rst--:py:class:`tuple` | :py:obj:`None` = None[source]¶: A VertexArray object of length 2 specifying the direction of projection. Instead of through a ConstrainedSketchVertex, each point may be specified through a tuple of coordinates. The default value is None.

influenceRadius : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`, :py:class:`float`] = 'DEFAULT'[source]¶: The SymbolicConstant DEFAULT or a Float specifying the maximum distance from the projection point on a connected surface within which the nodes on that surface must lie to contribute to the motion of the projection point. If the value is DEFAULT, a radius is computed from the fastener diameter and the surface facet lengths. The default value is DEFAULT.

localCsys : --is-rst--:py:class:`int` | :py:obj:`None` = None[source]¶: None or a DatumCsys object specifying the local coordinate system. If localCsys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.

maximumLayers : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'ALL'[source]¶: The SymbolicConstant ALL or an Int specifying the maximum number of layers for each fastener. If the value is ALL, the maximum possible number of layers within the searchRadius will be used for each fastener. The default value is ALL.

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

physicalRadius : --is-rst--:py:class:`float`[source]¶: A Float specifying the physical fastener radius.

region : --is-rst--:py:class:`~abaqus.Region.Region.Region`[source]¶: A Region object specifying the region to which fasteners are applied.

searchRadius : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`, :py:class:`float`] = 'DEFAULT'[source]¶: The SymbolicConstant DEFAULT or a Float specifying the distance from the positioning points within which the connected points must lie. The default value is DEFAULT.

sectionName : --is-rst--:py:class:`str` = ''[source]¶: A String specifying the connector section assigned to generated connectors. The default value is an empty string.

setValues( directionVector=None, targetSurfaces=MODEL, ur1=1, ur2=1, ur3=1, attachmentMethod=FACETOFACE, influenceRadius=DEFAULT, searchRadius=DEFAULT, maximumLayers=ALL, coupling=CONTINUUM, weightingMethod=UNIFORM, additionalMass=0, adjustOrientation=1, localCsys=None, connectionType=CONNECTOR, sectionName='', connectorOrientationLocalCsys1=None, axis1=AXIS_1, angle1=0, orient2SameAs1=1, connectorOrientationLocalCsys2=None, axis2=AXIS_1, angle2=0, unsorted=0, )[source]¶

This method modifies the PointFastener object.

Note

Check PointFastener.setValues on help.3ds.com/2023.

Parameters:¶

directionVector=None¶: A VertexArray object of length 2 specifying the direction of projection. Instead of through a ConstrainedSketchVertex, each point may be specified through a tuple of coordinates. The default value is None.
targetSurfaces=MODEL¶: A RegionArray object specifying surfaces to be fastened. The default value is MODEL.
ur1=1¶: A Boolean specifying whether to constrain rotational displacement component about the 1-direction. The default value is ON.
ur2=1¶: A Boolean specifying whether to constrain rotational displacement component about the 2-direction. The default value is ON.
ur3=1¶: A Boolean specifying whether to constrain rotational displacement component about the 3-direction. The default value is ON.
attachmentMethod=FACETOFACE¶: A SymbolicConstant specifying the method used to locate points for attaching fasteners. Possible values are FACETOFACE, EDGETOFACE, FACETOEDGE, and EDGETOEDGE. The default value is FACETOFACE.
influenceRadius=DEFAULT¶: The SymbolicConstant DEFAULT or a Float specifying the maximum distance from the projection point on a connected surface within which the nodes on that surface must lie to contribute to the motion of the projection point. If the value is DEFAULT, a radius is computed from the fastener diameter and the surface facet lengths. The default value is DEFAULT.
searchRadius=DEFAULT¶: The SymbolicConstant DEFAULT or a Float specifying the distance from the positioning points within which the connected points must lie. The default value is DEFAULT.
maximumLayers=ALL¶: The SymbolicConstant ALL or an Int specifying the maximum number of layers for each fastener. If the value is ALL, the maximum possible number of layers within the searchRadius will be used for each fastener. The default value is ALL.
coupling=CONTINUUM¶: A SymbolicConstant specifying the coupling method used to couple the displacement and rotation of each attachment point to the average motion of the surface nodes within the radius of influence from the fastener projection point. Possible values are CONTINUUM and STRUCTURAL. The default value is CONTINUUM.
weightingMethod=UNIFORM¶: A SymbolicConstant specifying the weighting scheme to be used to weight the contribution of the displacements of the surface nodes within the radius of influence to the motion of the fastener projection point. UNIFORM, LINEAR, QUADRATIC, and CUBIC indicate uniform, linear decreasing, quadratic polynomial decreasing, and cubic polynomial monotonic decreasing weight distributions. Possible values are UNIFORM, LINEAR, QUADRATIC, and CUBIC. The default value is UNIFORM.
additionalMass=0¶: A Float specifying the mass that will be distributed to fastener attachment points. The default value is 0.0.
adjustOrientation=1¶: A Boolean specifying whether to adjust localCsys such that the local z-axis for each fastener is normal to the surface that is closest to the reference node for that fastener. The default value is ON.
localCsys=None¶: None or a DatumCsys object specifying the local coordinate system. If localCsys = None, the global coordinate system is used. When this member is queried, it returns an Int. The default value is None.
connectionType=CONNECTOR¶: A SymbolicConstant specifying the fastener connection type. Possible values are CONNECTOR and BEAM_MPC. The default value is CONNECTOR.
sectionName=''¶: A String specifying the connector section assigned to generated connectors. The default value is an empty string.
connectorOrientationLocalCsys1=None¶: None or a DatumCsys object specifying the local coordinate system of the first connector point in generated connectors. If connectorOrientationLocalCsys1 = None, the degrees of freedom are defined in the global coordinate system. When this member is queried, it returns an Int. The default value is None.
axis1=AXIS_1¶: A SymbolicConstant specifying the axis of a datum coordinate system about which an additional rotation is applied for the first point in generated connectors. 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 for the first point in generated connectors. The default value is 0.0.
orient2SameAs1=1¶: A Boolean specifying whether or not the second connector point in generated connectors is to use the same local coordinate system, axis, and angle as the first point. The default value is ON.
connectorOrientationLocalCsys2=None¶: None or a DatumCsys object specifying the local coordinate system of the second connector point in generated connectors. If connectorOrientationLocalCsys2 = None, the degrees of freedom are defined in the global coordinate system. When this member is queried, it returns an Int. The default value is None.
axis2=AXIS_1¶: A SymbolicConstant specifying the axis of a datum coordinate system about which an additional rotation is applied for the second point in generated connectors. 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 for the second point in generated connectors. The default value is 0.0.
unsorted=0¶: A Boolean specifying whether the analysis product should leave targetSurfaces in the given unsorted order, or sort them by proximity to determine the connectivity of fastening points. The default value is OFF.

suppressed : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]¶: A Boolean specifying whether the fastener is suppressed or not. The default value is OFF.

targetSurfaces : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~typing.List`\ \[:py:class:`~abaqus.Region.Region.Region`], :py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`] = 'MODEL'[source]¶: A RegionArray object specifying surfaces to be fastened. The default value is MODEL.

unsorted : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]¶: A Boolean specifying whether the analysis product should leave targetSurfaces in the given unsorted order, or sort them by proximity to determine the connectivity of fastening points. The default value is OFF.

ur1 : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 1[source]¶: A Boolean specifying whether to constrain rotational displacement component about the 1-direction. The default value is ON.

ur2 : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 1[source]¶: A Boolean specifying whether to constrain rotational displacement component about the 2-direction. The default value is ON.

ur3 : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 1[source]¶: A Boolean specifying whether to constrain rotational displacement component about the 3-direction. The default value is ON.

weightingMethod : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` = 'UNIFORM'[source]¶: A SymbolicConstant specifying the weighting scheme to be used to weight the contribution of the displacements of the surface nodes within the radius of influence to the motion of the fastener projection point. UNIFORM, LINEAR, QUADRATIC, and CUBIC indicate uniform, linear decreasing, quadratic polynomial decreasing, and cubic polynomial monotonic decreasing weight distributions. Possible values are UNIFORM, LINEAR, QUADRATIC, and CUBIC. The default value is UNIFORM.

class PointMassInertia( name, region, mass=0, mass1=0, mass2=0, mass3=0, i11=0, i22=0, i33=0, i12=0, i13=0, i23=0, localCsys=None, alpha=0, composite=0, )[source]¶

Bases: Inertia

The PointMassInertia object defines point masses and point rotary inertia on a part or an assembly region. The PointMassInertia object is derived from the Inertia object.

Note

This object can be accessed by:

import part
mdb.models[name].parts[name].engineeringFeatures.inertias[name]
import assembly
mdb.models[name].rootAssembly.engineeringFeatures.inertias[name]

The corresponding analysis keywords are:

MASS

Note

Check PointMassInertia on help.3ds.com/2023.

Member Details:

alpha : --is-rst--:py:class:`float` = 0[source]¶: A Float specifying the alpha damping magnitude. The default value is 0.0.This argument applies only to Abaqus/Standard analyses.

composite : --is-rst--:py:class:`float` = 0[source]¶: A Float specifying the composite damping magnitude. The default value is 0.0.This argument applies only to Abaqus/Standard analyses.

i11 : --is-rst--:py:class:`float` = 0[source]¶: A Float specifying the rotary inertia about the local 1-axis, I11I11. The default value is 0.0.

i12 : --is-rst--:py:class:`float` = 0[source]¶: A Float specifying the product of inertia, I12I12. The default value is 0.0.

i13 : --is-rst--:py:class:`float` = 0[source]¶: A Float specifying the product of inertia, I13I13. The default value is 0.0.

i22 : --is-rst--:py:class:`float` = 0[source]¶: A Float specifying the rotary inertia about the local 2-axis, I22I22. The default value is 0.0.

i23 : --is-rst--:py:class:`float` = 0[source]¶: A Float specifying the product of inertia, I23I23. The default value is 0.0.

i33 : --is-rst--:py:class:`float` = 0[source]¶: A Float specifying the rotary inertia about the local 3-axis, I33I33. The default value is 0.0.

localCsys : --is-rst--:py:class:`str` | :py:obj:`None` = None[source]¶: None or a DatumCsys object specifying the local coordinate system for the anisotropic mass terms (when specified), and the rotary inertia (when specified). If localCsys = None, the anisotropic mass and rotary inertia data are defined in the global coordinate system. The default value is None.

mass : --is-rst--:py:class:`float` = 0[source]¶: A Float specifying the mass magnitude for isotropic mass. This parameter cannot be specified when anisotropic mass terms are specified. The default value is 0.0.

mass1 : --is-rst--:py:class:`float` = 0[source]¶: A Float specifying the mass in the 1-direction for anisotropic mass. This parameter cannot be specified when isotropic mass is also specified. The default value is 0.0.

mass2 : --is-rst--:py:class:`float` = 0[source]¶: A Float specifying the mass in the 2-direction for anisotropic mass. This parameter cannot be specified when isotropic mass is also specified. The default value is 0.0.

mass3 : --is-rst--:py:class:`float` = 0[source]¶: A Float specifying the mass in the 3-direction for anisotropic mass. This parameter cannot be specified when isotropic mass is also specified. The default value is 0.0.

region : --is-rst--:py:class:`~abaqus.Region.Region.Region`[source]¶: A Region object specifying the region to which the mass or rotary inertia is applied.

setValues( mass=0, mass1=0, mass2=0, mass3=0, i11=0, i22=0, i33=0, i12=0, i13=0, i23=0, localCsys=None, alpha=0, composite=0, )[source]¶

This method modifies the PointMassInertia object.

Note

Check PointMassInertia.setValues on help.3ds.com/2023.

Parameters:¶

mass=0¶: A Float specifying the mass magnitude for isotropic mass. This parameter cannot be specified when anisotropic mass terms are specified. The default value is 0.0.
mass1=0¶: A Float specifying the mass in the 1-direction for anisotropic mass. This parameter cannot be specified when isotropic mass is also specified. The default value is 0.0.
mass2=0¶: A Float specifying the mass in the 2-direction for anisotropic mass. This parameter cannot be specified when isotropic mass is also specified. The default value is 0.0.
mass3=0¶: A Float specifying the mass in the 3-direction for anisotropic mass. This parameter cannot be specified when isotropic mass is also specified. The default value is 0.0.
i11=0¶: A Float specifying the rotary inertia about the local 1-axis, I11I11. The default value is 0.0.
i22=0¶: A Float specifying the rotary inertia about the local 2-axis, I22I22. The default value is 0.0.
i33=0¶: A Float specifying the rotary inertia about the local 3-axis, I33I33. The default value is 0.0.
i12=0¶: A Float specifying the product of inertia, I12I12. The default value is 0.0.
i13=0¶: A Float specifying the product of inertia, I13I13. The default value is 0.0.
i23=0¶: A Float specifying the product of inertia, I23I23. The default value is 0.0.
localCsys=None¶: None or a DatumCsys object specifying the local coordinate system for the anisotropic mass terms (when specified), and the rotary inertia (when specified). If localCsys = None, the anisotropic mass and rotary inertia data are defined in the global coordinate system. The default value is None.
alpha=0¶: A Float specifying the alpha damping magnitude. The default value is 0.0.This argument applies only to Abaqus/Standard analyses.
composite=0¶: A Float specifying the composite damping magnitude. The default value is 0.0.This argument applies only to Abaqus/Standard analyses.

suppressed : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]¶: A Boolean specifying whether the inertia is suppressed or not. The default value is OFF.

class SpringDashpotToGround( name, region, dof, orientation=None, springBehavior=0, dashpotBehavior=0, springStiffness=0, dashpotCoefficient=0, )[source]¶

Bases: SpringDashpot

The SpringDashpotToGround object defines springs and/or dashpots between points and ground on a part or an assembly region. The SpringDashpotToGround object is derived from the SpringDashpot object.

Note

This object can be accessed by:

import part
mdb.models[name].parts[name].engineeringFeatures.springDashpots[name]
import assembly
mdb.models[name].rootAssembly.engineeringFeatures.springDashpots[name]

The corresponding analysis keywords are:

ELEMENT
SPRING
DASHPOT

Note

Check SpringDashpotToGround on help.3ds.com/2023.

Member Details:

dashpotBehavior : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]¶: A Boolean specifying whether to apply dashpot behavior to the selected points. The default value is OFF.At least one of the arguments springBehavior = ON or dashpotBehavior = ON must be specified.

dashpotCoefficient : --is-rst--:py:class:`float` = 0[source]¶: A Float specifying the force per relative velocity for the dashpot. The default value is 0.0.

dof : --is-rst--:py:class:`int`[source]¶: An Int specifying the degree of freedom associated with the spring and dashpot behaviors.

orientation : --is-rst--:py:class:`str` | :py:obj:`None` = None[source]¶: None or a DatumCsys object specifying the local directions for the spring and/or dashpot. If orientation = None, the spring and/or dashpot data are defined in the global coordinate system. The default value is None.

region : --is-rst--:py:class:`~abaqus.Region.Region.Region`[source]¶: A Region object specifying the region to which the springs and/or dashpots are applied.

setValues( orientation=None, springBehavior=0, dashpotBehavior=0, springStiffness=0, dashpotCoefficient=0, )[source]¶

This method modifies the SpringDashpotToGround object.

Note

Check SpringDashpotToGround.setValues on help.3ds.com/2023.

Parameters:¶

orientation=None¶: None or a DatumCsys object specifying the local directions for the spring and/or dashpot. If orientation = None, the spring and/or dashpot data are defined in the global coordinate system. The default value is None.
springBehavior=0¶: A Boolean specifying whether to apply spring behavior to the selected points. The default value is OFF.At least one of the arguments springBehavior = ON or dashpotBehavior = ON must be specified.
dashpotBehavior=0¶: A Boolean specifying whether to apply dashpot behavior to the selected points. The default value is OFF.At least one of the arguments springBehavior = ON or dashpotBehavior = ON must be specified.
springStiffness=0¶: A Float specifying the force per relative displacement for the spring. The default value is 0.0.
dashpotCoefficient=0¶: A Float specifying the force per relative velocity for the dashpot. The default value is 0.0.

springBehavior : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]¶: A Boolean specifying whether to apply spring behavior to the selected points. The default value is OFF.At least one of the arguments springBehavior = ON or dashpotBehavior = ON must be specified.

springStiffness : --is-rst--:py:class:`float` = 0[source]¶: A Float specifying the force per relative displacement for the spring. The default value is 0.0.

suppressed : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]¶: A Boolean specifying whether the spring/dashpot is suppressed or not. The default value is OFF.

class TwoPointSpringDashpot( name, regionPairs, axis, dof1=0, dof2=0, orientation=None, springBehavior=0, dashpotBehavior=0, springStiffness=0, dashpotCoefficient=0, )[source]¶

Bases: SpringDashpot

The TwoPointSpringDashpot object defines springs and/or dashpots between two points on a part or an assembly. The TwoPointSpringDashpot object is derived from the SpringDashpot object.

Note

This object can be accessed by:

import part
mdb.models[name].parts[name].engineeringFeatures.springDashpots[name]
import assembly
mdb.models[name].rootAssembly.engineeringFeatures.springDashpots[name]

The corresponding analysis keywords are:

ELEMENT
SPRING
DASHPOT

Note

Check TwoPointSpringDashpot on help.3ds.com/2023.

Member Details:

axis : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶: A SymbolicConstant specifying whether the axis of the springs and/or dashpots follows the rotation of the nodes or is in a specified direction. Possible values are NODAL_LINE and FIXED_DOF.

dashpotBehavior : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]¶: A Boolean specifying whether to apply dashpot behavior to the selected point pairs. The default value is OFF.At least one of the arguments springBehavior = ON or dashpotBehavior = ON must be specified.

dashpotCoefficient : --is-rst--:py:class:`float` = 0[source]¶: A Float specifying the force per relative velocity for the dashpots. The default value is 0.0.

dof1 : --is-rst--:py:class:`int` = 0[source]¶: An Int specifying the degree of freedom with which the springs and/or dashpots are associated at their first points. The dof1 argument applies only when axis = FIXED_DOFS. The default value is 0.

dof2 : --is-rst--:py:class:`int` = 0[source]¶: An Int specifying the degree of freedom with which the springs and/or dashpots are associated at their second points. The dof2 argument applies only when axis = FIXED_DOFS. The default value is 0.

orientation : --is-rst--:py:class:`str` | :py:obj:`None` = None[source]¶: None or a DatumCsys object specifying the local directions for the spring and/or dashpot. If orientation = None, the spring and/or dashpot data are defined in the global coordinate system. The default value is None.The orientation argument applies only when axis = FIXED_DOFS.

regionPairs : --is-rst--:py:class:`tuple`[source]¶: A sequence of pairs of Region objects specifying the points between which the springs and/or dashpots are applied.

setValues( dof1=0, dof2=0, orientation=None, springBehavior=0, dashpotBehavior=0, springStiffness=0, dashpotCoefficient=0, )[source]¶

This method modifies the TwoPointSpringDashpot object.

Note

Check TwoPointSpringDashpot.setValues on help.3ds.com/2023.

Parameters:¶

dof1=0¶: An Int specifying the degree of freedom with which the springs and/or dashpots are associated at their first points. The dof1 argument applies only when axis = FIXED_DOFS. The default value is 0.
dof2=0¶: An Int specifying the degree of freedom with which the springs and/or dashpots are associated at their second points. The dof2 argument applies only when axis = FIXED_DOFS. The default value is 0.
orientation=None¶: None or a DatumCsys object specifying the local directions for the spring and/or dashpot. If orientation = None, the spring and/or dashpot data are defined in the global coordinate system. The default value is None.The orientation argument applies only when axis = FIXED_DOFS.
springBehavior=0¶: A Boolean specifying whether to apply spring behavior to the selected point pairs. The default value is OFF.At least one of the arguments springBehavior = ON or dashpotBehavior = ON must be specified.
dashpotBehavior=0¶: A Boolean specifying whether to apply dashpot behavior to the selected point pairs. The default value is OFF.At least one of the arguments springBehavior = ON or dashpotBehavior = ON must be specified.
springStiffness=0¶: A Float specifying the force per relative displacement for the springs. The default value is 0.0.
dashpotCoefficient=0¶: A Float specifying the force per relative velocity for the dashpots. The default value is 0.0.

springBehavior : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]¶: A Boolean specifying whether to apply spring behavior to the selected point pairs. The default value is OFF.At least one of the arguments springBehavior = ON or dashpotBehavior = ON must be specified.

springStiffness : --is-rst--:py:class:`float` = 0[source]¶: A Float specifying the force per relative displacement for the springs. The default value is 0.0.

suppressed : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]¶: A Boolean specifying whether the spring/dashpot is suppressed or not. The default value is OFF.

class XFEMCrack( name, crackDomain, allowCrackGrowth=1, crackLocation=None, singularityCalcRadius=None, interactionProperty='', elemId=(), nodeId=(), hasCrackFront=(), crackPlaneDist=(), crackFrontDist=(), autoDetectValue='', )[source]¶

Bases: Crack

The XFEMCrack object defines the parameters needed to model crack initiation or crack growth using XFEM technology. Currently only assembly regions are supported. The XFEMCrack object is derived from the Crack object.

Note

This object can be accessed by:

import part
mdb.models[name].parts[name].engineeringFeatures.cracks[name]
import assembly
mdb.models[name].rootAssembly.engineeringFeatures.cracks[name]

The corresponding analysis keywords are:

ENRICHMENT
INITIAL CONDITIONS

Note

Check XFEMCrack on help.3ds.com/2023.

Member Details:

allowCrackGrowth : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 1[source]¶: A Boolean specifying whether the crack is allowed to propagate (grow). The default value is ON.

autoDetectValue : --is-rst--:py:class:`str` = ''[source]¶: An integer specifying the number of element layers around the crack location, to which the crack domain is shrunk.

crackDomain : --is-rst--:py:class:`~abaqus.Region.Region.Region`[source]¶: A Region object specifying the region that contains the crack or is likely to contain the crack.

crackFrontDist : --is-rst--:py:class:`tuple`\ \[:py:class:`float`, :py:data:`...<Ellipsis>`] = ()[source]¶: A sequence of Floats specifying the values of the second signed distance function. This argument is used only by the input file reader.

crackLocation : --is-rst--:py:class:`~abaqus.Region.Region.Region` | :py:obj:`None` = None[source]¶: A Region object specifying the initial crack location. This parameter is required when allowCrackGrowth = OFF.

crackPlaneDist : --is-rst--:py:class:`tuple`\ \[:py:class:`float`, :py:data:`...<Ellipsis>`] = ()[source]¶: A sequence of Floats specifying the values of the first signed distance function. This argument is used by the input file reader.

elemId : --is-rst--:py:class:`tuple`\ \[:py:class:`int`, :py:data:`...<Ellipsis>`] = ()[source]¶: A sequence of Ints specifying the labels of the elements that are intersected by the initial crack location. This argument is used only by the input file reader.

hasCrackFront : --is-rst--:py:class:`tuple`\ \[:py:class:`int`, :py:data:`...<Ellipsis>`] = ()[source]¶: A sequence of Ints specifying the values indicating the inclusion/exclusion of the crackFrontDist values. A zero value indicates that crackFrontDist is not specified for the ith pair elemId and nodeId. This argument is used only by the input file reader.

interactionProperty : --is-rst--:py:class:`str` = ''[source]¶: A String specifying the name of the ContactProperty object that defines the contact properties for the crack surfaces. The default value is an empty string.

nodeId : --is-rst--:py:class:`tuple`\ \[:py:class:`int`, :py:data:`...<Ellipsis>`] = ()[source]¶: A sequence of Ints specifying the position of a node in the corresponding element connectivity. This argument is used only by the input file reader.

setValues( allowCrackGrowth=1, crackLocation=None, singularityCalcRadius=None, interactionProperty='', elemId=(), nodeId=(), hasCrackFront=(), crackPlaneDist=(), crackFrontDist=(), autoDetectValue='', )[source]¶

This method modifies the XFEMCrack object.

Note

Check XFEMCrack.setValues on help.3ds.com/2023.

Parameters:¶

allowCrackGrowth=1¶: A Boolean specifying whether the crack is allowed to propagate (grow). The default value is ON.
crackLocation=None¶: A Region object specifying the initial crack location. This parameter is required when allowCrackGrowth = OFF.
singularityCalcRadius=None¶: None or a Float specifying the radius from the crack tips within which the elements are used for crack singularity calculations. This argument applies only when allowCrackGrowth = OFF. The default value is None.
interactionProperty=''¶: A String specifying the name of the ContactProperty object that defines the contact properties for the crack surfaces. The default value is an empty string.
elemId=()¶: A sequence of Ints specifying the labels of the elements that are intersected by the initial crack location. This argument is used only by the input file reader.
nodeId=()¶: A sequence of Ints specifying the position of a node in the corresponding element connectivity. This argument is used only by the input file reader.
hasCrackFront=()¶: A sequence of Ints specifying the values indicating the inclusion/exclusion of the crackFrontDist values. A zero value indicates that crackFrontDist is not specified for the ith pair elemId and nodeId. This argument is used only by the input file reader.
crackPlaneDist=()¶: A sequence of Floats specifying the values of the first signed distance function. This argument is used by the input file reader.
crackFrontDist=()¶: A sequence of Floats specifying the values of the second signed distance function. This argument is used only by the input file reader.
autoDetectValue=''¶: An integer specifying the number of element layers around the crack location, to which the crack domain is shrunk.

singularityCalcRadius : --is-rst--:py:class:`float` | :py:obj:`None` = None[source]¶: None or a Float specifying the radius from the crack tips within which the elements are used for crack singularity calculations. This argument applies only when allowCrackGrowth = OFF. The default value is None.

suppressed : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]¶: A Boolean specifying whether the crack is suppressed or not. The default value is OFF.

class Inertia[source]¶

Bases: object

The Inertia object is the abstract base type for HeatCapacitance, NonstructuralMass, and PointMassInertia.

Note

This object can be accessed by:

import part
mdb.models[name].parts[name].engineeringFeatures.inertias[name]
import assembly
mdb.models[name].rootAssembly.engineeringFeatures.inertias[name]

Note

Check Inertia on help.3ds.com/2023.

Member Details:

name : --is-rst--:py:class:`str` = ''[source]¶: A String specifying the repository key.

resume()[source]¶: This method resumes the inertia that was previously suppressed.

suppress()[source]¶: This method suppresses the inertia.

suppressed : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]¶: A Boolean specifying whether the inertia is suppressed or not. The default value is OFF.

class SpringDashpot[source]¶

Bases: object

The SpringDashpot object is the abstract base type for the SpringDashpotToGround and TwoPointSpringDashpot objects.

Note

This object can be accessed by:

import part
mdb.models[name].parts[name].engineeringFeatures.springDashpots[name]
import assembly
mdb.models[name].rootAssembly.engineeringFeatures.springDashpots[name]

Note

Check SpringDashpot on help.3ds.com/2023.

Member Details:

name : --is-rst--:py:class:`str` = ''[source]¶: A String specifying the repository key.

resume()[source]¶: This method resumes the spring/dashpot that was previously suppressed.

suppress()[source]¶: This method suppresses the spring/dashpot.

suppressed : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] = 0[source]¶: A Boolean specifying whether the spring/dashpot is suppressed or not. The default value is OFF.