Constraint¶
The Constraint commands define constraints between regions of the model.
Create constraints¶
- class ConstraintModel(
- name,
- description=
''
, - stefanBoltzmann=
None
, - absoluteZero=
None
, - waveFormulation=
NOT_SET
, - modelType=
STANDARD_EXPLICIT
, - universalGas=
None
, - copyConstraints=
1
, - copyConnectors=
1
, - copyInteractions=
1
, Bases:
ModelBase
Abaqus creates a Model object named Model-1 when a session is started.
Note
This object can be accessed by:
mdb.models[name]
Note
Public Data Attributes:
Inherited from
ModelBase
A String specifying the repository key.
None or a Float specifying the Stefan-Boltzmann constant.
None or a Float specifying the absolute zero constant.
A SymbolicConstant specifying the type of incident wave formulation to be used in acoustic problems.
None or a Float specifying the universal gas constant.
A Boolean specifying whether an input file should be written without parts and assemblies.
A Boolean specifying that the step specified by restartStep should be terminated at the increment specified by restartIncrement.
A Boolean specifying that a shell global model drives a solid submodel.
A Float specifying the time stamp that indicates when the model was last changed.
A String specifying the purpose and contents of the Model object.
A String specifying the name of the job that generated the restart data.
A String specifying the name of the step where the restart analysis will start.
A String specifying the name of the job that generated the results for the global model.
A boolean specifying the status of constraints created in a model, in the model which instances this model.
A boolean specifying the status of connectors created in a model, in the model which instances this model.
A boolean specifying the status of interactions created in a model, in the model which instances this model.
A KeywordBlock object.
A repository of Amplitude objects.
A repository of Profile objects.
A repository of BoundaryCondition objects.
A repository of ConstrainedSketchConstraint objects.
A repository of AnalyticalField objects.
A repository of DiscreteField objects.
A repository of PredefinedField objects.
A repository of Interaction objects.
A repository of InteractionProperty objects.
A repository of ContactControl objects.
A repository of ContactInitialization objects.
A repository of ContactStabilization objects.
A tuple of tuples of Strings specifying the linked child PartInstance name in the current model to the corresponding parent PartInstance name in a different model.
A tuple of tuples of Strings specifying the linked child Part name in the current model to the corresponding parent Part name in a different model.
A repository of Load objects.
A repository of Material objects.
A repository of Calibration objects.
A repository of Section objects.
A repository of RemeshingRule objects.
A repository of ConstrainedSketch objects.
A repository of Part objects.
A repository of Step objects.
A FeatureOptions object.
A repository of AdaptiveMeshConstraint objects.
A repository of AdaptiveMeshControl objects.
A repository of TimePoint objects.
A repository of Filter objects.
A repository of IntegratedOutputSection objects.
A repository of FieldOutputRequest objects.
A repository of HistoryOutputRequest objects.
A repository of OptimizationTask objects.
A repository of TableCollection objects.
A repository of EventSeriesType objects.
A repository of EventSeriesData objects.
An Int specifying the increment, interval, iteration or cycle where the restart analysis will start.
An Assembly object.
Public Methods:
AdjustPoints
(name, surface, controlPoints)This method creates an AdjustPoints object.
Coupling
(name, surface, controlPoint, ...[, ...])This method creates a Coupling object.
DisplayBody
(name, instance, controlPoints)This method creates a DisplayBody object.
EmbeddedRegion
(name, embeddedRegion, hostRegion)This method creates a EmbeddedRegion object.
Equation
(name, terms)This method creates an Equation object.
MultipointConstraint
(name, surface, ...[, ...])This method creates a MultipointConstraint object.
RigidBody
(name, refPointRegion[, ...])This method creates a RigidBody object.
ShellSolidCoupling
(name, shellEdge, solidFace)This method creates a ShellSolidCoupling object.
Tie
(name, main, secondary[, adjust, ...])This method creates a Tie object.
Inherited from
ModelBase
__init__
(name[, description, ...])This method creates a Model object.
ModelFromInputFile
(name, inputFileName)This method creates a Model object by reading the keywords in an input file and creating the corresponding Abaqus/CAE objects.
ModelFromOdbFile
(name, odbFileName)This method creates a Model object by reading an output database and creating any corresponding Abaqus/CAE objects.
ModelFromNastranFile
(modelName, inputFileName)This method creates a Model object by reading the keywords in a Nastran bulk data file or Nastran input file and creating any corresponding Abaqus/CAE objects.
setValues
([description, noPartsInputFile, ...])This method modifies the Model object.
Member Details:
- AdjustPoints(name, surface, controlPoints)[source]¶
This method creates an AdjustPoints object.
Note
This function can be accessed by:
mdb.models[name].AdjustPoints
Note
- Coupling(
- name,
- surface,
- controlPoint,
- influenceRadius,
- couplingType,
- rotationalCouplingType,
- adjust=
0
, - localCsys=
None
, - u1=
1
, - u2=
1
, - u3=
1
, - ur1=
1
, - ur2=
1
, - ur3=
1
, - weightingMethod=
UNIFORM
, - alpha=
0.0
, This method creates a Coupling object.
Note
This function can be accessed by:
mdb.models[name].Coupling
Note
- Parameters:¶
- name¶
A String specifying the constraint repository key.
- surface¶
A Region object specifying the surface on which the coupling nodes are located.
- controlPoint¶
A Region object specifying the constraint control point.
- influenceRadius¶
The SymbolicConstant WHOLE_SURFACE or a Float specifying the influence radius.
- couplingType¶
A SymbolicConstant specifying the coupling constraint type. Possible values are KINEMATIC, DISTRIBUTING, and STRUCTURAL.
- rotationalCouplingType¶
A SymbolicConstant specifying the rotational coupling constraint type. Possible values are ROTATIONAL_CONTINUUM and ROTATIONAL_STRUCTURAL.
Added in version 2024: The
rotationalCouplingType
argument was added.- adjust=
0
¶ A Boolean specifying if the control point will be adjusted (moved) to the surface. The point will be adjusted in the direction normal to the specified surface. The default value is OFF.
- localCsys=
None
¶ None or a DatumCsys object specifying the initial orientation of the local coordinate system for the coupling’s degrees of freedom. If localCsys = None, the coupling is defined in the global coordinate system. The default value is None.
- u1=
1
¶ A Boolean specifying if the displacement component in the 1-direction is constrained to the reference node for a kinematic coupling constraint. The default value is ON.The u1 argument applies only when couplingType = KINEMATIC.
- u2=
1
¶ A Boolean specifying if the displacement component in the 2-direction is constrained to the reference node for a kinematic coupling constraint. The default value is ON.The u2 argument applies only when couplingType = KINEMATIC.
- u3=
1
¶ A Boolean specifying if the displacement component in the 3-direction is constrained to the reference node for a kinematic coupling constraint. The default value is ON.The u3 argument applies only when couplingType = KINEMATIC.
- ur1=
1
¶ A Boolean specifying if the rotational displacement component about the 1-direction is constrained to the reference node for a kinematic coupling constraint. The default value is ON.The ur1 argument applies only when couplingType = KINEMATIC.
- ur2=
1
¶ A Boolean specifying if the rotational displacement component about the 2-direction is constrained to the reference node for a kinematic coupling constraint. The default value is ON.The ur2 argument applies only when couplingType = KINEMATIC.
- ur3=
1
¶ A Boolean specifying if the rotational displacement component about the 3-direction is constrained to the reference node for a kinematic coupling constraint. The default value is ON.The ur3 argument applies only when couplingType = KINEMATIC.
- weightingMethod=
UNIFORM
¶ A SymbolicConstant specifying an optional weighting method used for calculating the distributing weight factors. Possible values are UNIFORM, LINEAR, QUADRATIC, and CUBIC. The default value is UNIFORM.The weightingMethod argument applies only when couplingType = DISTRIBUTING.
- alpha=
0.0
¶ A Float specifying the value of the thermal expansion coefficient. The default value is 0.0. The alpha argument applies only when couplingType=KINEMATIC.
Added in version 2022: The
alpha
argument was added.
- Returns:¶
A Coupling object.
- Return type:¶
- DisplayBody(name, instance, controlPoints)[source]¶
This method creates a DisplayBody object.
Note
This function can be accessed by:
mdb.models[name].DisplayBody
Note
- Parameters:¶
- name¶
A String specifying the constraint repository key.
- instance¶
A PartInstance object specifying the part instance that is to be used for display only.
- controlPoints¶
A ModelDotArray object specifying the motion of the PartInstance. The control points may be ConstrainedSketchVertex, ReferencePoint, or MeshNode objects. Their motion will control the motion of the PartInstance. If this argument is set to an empty sequence, the PartInstance will remain fixed in space during the analysis. The sequence can have either one object or three objects.
- Returns:¶
A DisplayBody object.
- Return type:¶
- EmbeddedRegion(
- name,
- embeddedRegion,
- hostRegion,
- weightFactorTolerance=
None
, - toleranceMethod=
BOTH
, - absoluteTolerance=
0
, - fractionalTolerance=
0
, This method creates a EmbeddedRegion object.
Note
This function can be accessed by:
mdb.models[name].EmbeddedRegion
Note
- Parameters:¶
- name¶
A String specifying the constraint repository key.
- embeddedRegion¶
A Region object specifying the body region to be embedded.
- hostRegion¶
A Region object specifying the host region. A value of None indicates that the host region is the whole model.
- weightFactorTolerance=
None
¶ A Float specifying a small value below which the weighting factors will be zeroed out. The default value is 10⁻⁶.
- toleranceMethod=
BOTH
¶ A SymbolicConstant specifying the method used to determine the embedded element tolerance. Possible values are ABSOLUTE, FRACTIONAL, and BOTH. The default value is BOTH.
- absoluteTolerance=
0
¶ A Float specifying the absolute value by which a node on the embedded region may lie outside the host region. If absoluteTolerance = 0.0, the fractionalTolerance value will be used. The default value is 0.0.This argument applies only when toleranceMethod = ABSOLUTE or BOTH.
- fractionalTolerance=
0
¶ A Float specifying the fractional value by which a node on the embedded region may lie outside the host region. The fractional value is based on the average element size within the host region. The default value is 0.05.If both tolerance arguments are specified, the smaller value will be used.This argument applies only when toleranceMethod = FRACTIONAL or BOTH.
- Returns:¶
An EmbeddedRegion object.
- Return type:¶
- Equation(name, terms)[source]¶
This method creates an Equation object.
Note
This function can be accessed by:
mdb.models[name].Equation
Note
- MultipointConstraint( )[source]¶
This method creates a MultipointConstraint object.
Note
This function can be accessed by:
mdb.models[name].MultipointConstraint
Note
- Parameters:¶
- name¶
A String specifying the constraint repository key.
- surface¶
A Region object specifying the surface on which the MultipointConstraint nodes are located.
- controlPoint¶
A Region object specifying the constraint control point.
- mpcType¶
A SymbolicConstant specifying the MPC type of the constraint. Possible values are BEAM_MPC, ELBOW_MPC, PIN_MPC, LINK_MPC, TIE_MPC, and USER_MPC.
- csys=
None
¶ None or a DatumCsys object specifying the initial orientation of the local coordinate system for the MultipointConstraint’s degrees of freedom. If localCsys = None, the MultipointConstraint is defined in the global coordinate system. The default value is None.
- userType=
0
¶ An Int specifying to differentiate between different constraint types in a user-defined MultipointConstraint. The default value is 0.The userType argument applies only when mpcType = USER_MPC.
- userMode=
DOF_MODE_MPC
¶ A SymbolicConstant specifying the mode of the constraint when it is user-defined. Possible values are DOF_MODE_MPC and NODE_MODE_MPC. The default value is DOF_MODE_MPC.The userMode argument applies only when mpcType = USER_MPC.
- Returns:¶
A MultipointConstraint object.
- Return type:¶
- RigidBody(
- name,
- refPointRegion,
- bodyRegion=
None
, - tieRegion=
None
, - pinRegion=
None
, - surfaceRegion=
None
, - refPointAtCOM=
0
, - isothermal=
0
, This method creates a RigidBody object.
Note
This function can be accessed by:
mdb.models[name].RigidBody
Note
- Parameters:¶
- name¶
A String specifying the constraint repository key.
- refPointRegion¶
A Region object specifying the reference point.
- bodyRegion=
None
¶ None or a Region object specifying the elements constrained to the movement of the reference point. The default value is None.
- tieRegion=
None
¶ None or a Region object specifying the nodes tied to the movement of the reference point. The default value is None.
- pinRegion=
None
¶ None or a Region object specifying the nodes pinned to the movement of the reference point. The default value is None.
- surfaceRegion=
None
¶ None or a Region object specifying the analytic surface constrained to the movement of the reference point. The default value is None.
- refPointAtCOM=
0
¶ A Boolean specifying whether the analysis product should recompute the reference point position to be at the center of mass. The default value is OFF.
- isothermal=
0
¶ A Boolean specifying whether the temperature degree of freedom should be constrained. The default value is OFF.
- Returns:¶
A RigidBody object.
- Return type:¶
- ShellSolidCoupling(
- name,
- shellEdge,
- solidFace,
- positionToleranceMethod=
COMPUTED
, - positionTolerance=
0
, - influenceDistanceMethod=
DEFAULT
, - influenceDistance=
0
, This method creates a ShellSolidCoupling object.
Note
This function can be accessed by:
mdb.models[name].ShellSolidCoupling
Note
- Parameters:¶
- name¶
A String specifying the constraint repository key.
- shellEdge¶
A Region object specifying the name of the shell edge surface.
- solidFace¶
A Region object specifying the name of the solid surface.
- positionToleranceMethod=
COMPUTED
¶ A SymbolicConstant specifying the method used to determine the position tolerance. Possible values are COMPUTED and SPECIFIED. The default value is COMPUTED.
- positionTolerance=
0
¶ A Float specifying the position tolerance. The default value is 0.0.The positionTolerance argument applies only when positionToleranceMethod = SPECIFIED. Note: Abaqus will not constrain nodes on the solid face region outside the position tolerance.
- influenceDistanceMethod=
DEFAULT
¶ A SymbolicConstant specifying the method used to determine the influence distance. Possible values are DEFAULT and SPECIFIED. The default value is DEFAULT.
- influenceDistance=
0
¶ A Float specifying the influence distance. The influenceDistance argument applies only when influenceDistanceMethod = SPECIFIED. The default value is 0.0.
- Returns:¶
A ShellSolidCoupling object.
- Return type:¶
- Tie(
- name,
- main,
- secondary,
- adjust=
1
, - positionToleranceMethod=
COMPUTED
, - positionTolerance=
0
, - tieRotations=
1
, - constraintRatioMethod=
DEFAULT
, - constraintRatio=
0
, - constraintEnforcement=
SOLVER_DEFAULT
, - thickness=
1
, This method creates a Tie object.
Note
This function can be accessed by:
mdb.models[name].Tie
Note
Check Tie on help.3ds.com/2024.
- Parameters:¶
- name¶
A String specifying the constraint repository key.
- main¶
A Region object specifying the name of the main surface.
Changed in version 2022: The
master
argument was renamed tomain
.- secondary¶
A Region object specifying the name of the secondary surface.
Changed in version 2022: The
slave
argument was renamed tosecondary
.- adjust=
1
¶ A Boolean specifying whether initial positions of tied secondary nodes are adjusted to lie on the main surface. The default value is ON.
- positionToleranceMethod=
COMPUTED
¶ A SymbolicConstant specifying the method used to determine the position tolerance. Possible values are COMPUTED and SPECIFIED. The default value is COMPUTED.
- positionTolerance=
0
¶ A Float specifying the position tolerance. The positionTolerance argument applies only when positionToleranceMethod = SPECIFIED. The default value is 0.0.
- tieRotations=
1
¶ A Boolean specifying whether rotation degrees of freedom should be tied. The default value is ON.
- constraintRatioMethod=
DEFAULT
¶ A SymbolicConstant specifying the method used to determine the constraint ratio. Possible values are DEFAULT and SPECIFIED. The default value is DEFAULT.
- constraintRatio=
0
¶ A Float specifying the fractional distance between the main reference surface and the secondary node at which the translational constraint should act. The constraintRatio argument applies only when constraintRatioMethod = SPECIFIED. The default value is 0.0.
- constraintEnforcement=
SOLVER_DEFAULT
¶ A SymbolicConstant specifying the discretization method. Possible values are SOLVER_DEFAULT, NODE_TO_SURFACE, and SURFACE_TO_SURFACE. The default value is SOLVER_DEFAULT.
- thickness=
1
¶ A Boolean specifying whether shell element thickness is considered. The default value is ON.
- Returns:¶
A Tie object.
- Return type:¶
Other Classes¶
- class AdjustPoints(name, surface, controlPoints)[source]¶
Bases:
Constraint
The AdjustPoints constraint object is used to adjust points (nodes) to a surface. The AdjustPoints object is derived from the ConstrainedSketchConstraint object.
Note
This object can be accessed by:
import interaction mdb.models[name].constraints[name]
The corresponding analysis keywords are:
ADJUST
Note
Member Details:
- controlPoints : --is-rst--:py:class:`~abaqus.Region.Region.Region`[source]¶
A Region object specifying the constraint control points.
- class Constraint[source]¶
Bases:
object
The ConstrainedSketchConstraint object is the abstract base type for other ConstrainedSketchConstraint objects. The ConstrainedSketchConstraint object has no explicit constructor. The members of the ConstrainedSketchConstraint object are common to all objects derived from the ConstrainedSketchConstraint.
Note
This object can be accessed by:
import interaction mdb.models[name].constraints[name]
Note
Member Details:
- class Coupling(
- name,
- surface,
- controlPoint,
- influenceRadius,
- couplingType,
- rotationalCouplingType,
- adjust=
0
, - localCsys=
None
, - u1=
1
, - u2=
1
, - u3=
1
, - ur1=
1
, - ur2=
1
, - ur3=
1
, - weightingMethod=
UNIFORM
, - alpha=
0.0
, Bases:
Constraint
The Coupling object defines a constraint between a group of coupling nodes located on a region and a reference point. The Coupling object is derived from the ConstrainedSketchConstraint object.
Note
This object can be accessed by:
import interaction mdb.models[name].constraints[name]
The corresponding analysis keywords are:
COUPLING
Note
Member Details:
-
adjust : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] =
0
[source]¶ A Boolean specifying if the control point will be adjusted (moved) to the surface. The point will be adjusted in the direction normal to the specified surface. The default value is OFF.
-
alpha : --is-rst--:py:class:`float` =
0.0
[source]¶ A Float specifying the value of the thermal expansion coefficient. The default value is 0.0. The alpha argument applies only when couplingType=KINEMATIC.
Added in version 2022: The
alpha
attribute was added.
- controlPoint : --is-rst--:py:class:`~abaqus.Region.Region.Region`[source]¶
A Region object specifying the constraint control point.
- couplingType : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying the coupling constraint type. Possible values are KINEMATIC, DISTRIBUTING, and STRUCTURAL.
- 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 influence radius.
-
localCsys : --is-rst--:py:class:`str` | :py:obj:`None` =
None
[source]¶ None or a DatumCsys object specifying the initial orientation of the local coordinate system for the coupling’s degrees of freedom. If localCsys = None, the coupling is defined in the global coordinate system. The default value is None.
- rotationalCouplingType : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying the rotational coupling constraint type. Possible values are ROTATIONAL_CONTINUUM and ROTATIONAL_STRUCTURAL.
Added in version 2024: The
rotationalCouplingType
attribute was added.
- setValues( )[source]¶
This method modifies the Coupling object.
Note
- Parameters:¶
- adjust=
0
¶ A Boolean specifying if the control point will be adjusted (moved) to the surface. The point will be adjusted in the direction normal to the specified surface. The default value is OFF.
- localCsys=
None
¶ None or a DatumCsys object specifying the initial orientation of the local coordinate system for the coupling’s degrees of freedom. If localCsys = None, the coupling is defined in the global coordinate system. The default value is None.
- u1=
1
¶ A Boolean specifying if the displacement component in the 1-direction is constrained to the reference node for a kinematic coupling constraint. The default value is ON.The u1 argument applies only when couplingType = KINEMATIC.
- u2=
1
¶ A Boolean specifying if the displacement component in the 2-direction is constrained to the reference node for a kinematic coupling constraint. The default value is ON.The u2 argument applies only when couplingType = KINEMATIC.
- u3=
1
¶ A Boolean specifying if the displacement component in the 3-direction is constrained to the reference node for a kinematic coupling constraint. The default value is ON.The u3 argument applies only when couplingType = KINEMATIC.
- ur1=
1
¶ A Boolean specifying if the rotational displacement component about the 1-direction is constrained to the reference node for a kinematic coupling constraint. The default value is ON.The ur1 argument applies only when couplingType = KINEMATIC.
- ur2=
1
¶ A Boolean specifying if the rotational displacement component about the 2-direction is constrained to the reference node for a kinematic coupling constraint. The default value is ON.The ur2 argument applies only when couplingType = KINEMATIC.
- ur3=
1
¶ A Boolean specifying if the rotational displacement component about the 3-direction is constrained to the reference node for a kinematic coupling constraint. The default value is ON.The ur3 argument applies only when couplingType = KINEMATIC.
- weightingMethod=
UNIFORM
¶ A SymbolicConstant specifying an optional weighting method used for calculating the distributing weight factors. Possible values are UNIFORM, LINEAR, QUADRATIC, and CUBIC. The default value is UNIFORM.The weightingMethod argument applies only when couplingType = DISTRIBUTING.
- adjust=
-
suppressed : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] =
0
[source]¶ A Boolean specifying whether the constraint is suppressed or not. The default value is OFF.
- surface : --is-rst--:py:class:`~abaqus.Region.Region.Region`[source]¶
A Region object specifying the surface on which the coupling nodes are located.
-
u1 : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] =
1
[source]¶ A Boolean specifying if the displacement component in the 1-direction is constrained to the reference node for a kinematic coupling constraint. The default value is ON.The u1 argument applies only when couplingType = KINEMATIC.
-
u2 : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] =
1
[source]¶ A Boolean specifying if the displacement component in the 2-direction is constrained to the reference node for a kinematic coupling constraint. The default value is ON.The u2 argument applies only when couplingType = KINEMATIC.
-
u3 : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] =
1
[source]¶ A Boolean specifying if the displacement component in the 3-direction is constrained to the reference node for a kinematic coupling constraint. The default value is ON.The u3 argument applies only when couplingType = KINEMATIC.
-
ur1 : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] =
1
[source]¶ A Boolean specifying if the rotational displacement component about the 1-direction is constrained to the reference node for a kinematic coupling constraint. The default value is ON.The ur1 argument applies only when couplingType = KINEMATIC.
-
ur2 : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] =
1
[source]¶ A Boolean specifying if the rotational displacement component about the 2-direction is constrained to the reference node for a kinematic coupling constraint. The default value is ON.The ur2 argument applies only when couplingType = KINEMATIC.
-
ur3 : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] =
1
[source]¶ A Boolean specifying if the rotational displacement component about the 3-direction is constrained to the reference node for a kinematic coupling constraint. The default value is ON.The ur3 argument applies only when couplingType = KINEMATIC.
-
weightingMethod : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` =
'UNIFORM'
[source]¶ A SymbolicConstant specifying an optional weighting method used for calculating the distributing weight factors. Possible values are UNIFORM, LINEAR, QUADRATIC, and CUBIC. The default value is UNIFORM.The weightingMethod argument applies only when couplingType = DISTRIBUTING.
- class DisplayBody(name, instance, controlPoints)[source]¶
Bases:
Constraint
The DisplayBody object defines a constraint such that the specified instance is used for display only and does not take part in the analysis. However it will still be visible during postprocessing and its position at any frame will be defined by the translation and rotation of the specified control points. The DisplayBody object is derived from the ConstrainedSketchConstraint object.
Note
This object can be accessed by:
import interaction mdb.models[name].constraints[name]
The corresponding analysis keywords are:
DISPLAY BODY
Note
Member Details:
- controlPoints : --is-rst--:py:class:`~typing.List`\ \[:py:class:`~abaqus.BasicGeometry.ModelDot.ModelDot`][source]¶
A ModelDotArray object specifying the motion of the PartInstance. The control points may be ConstrainedSketchVertex, ReferencePoint, or MeshNode objects. Their motion will control the motion of the PartInstance. If this argument is set to an empty sequence, the PartInstance will remain fixed in space during the analysis. The sequence can have either one object or three objects.
- class EmbeddedRegion(
- name,
- embeddedRegion,
- hostRegion,
- weightFactorTolerance=
None
, - toleranceMethod=
BOTH
, - absoluteTolerance=
0
, - fractionalTolerance=
0
, Bases:
Constraint
The EmbeddedRegion object allows you to embed a region of the model within a “host” region of the model or within the whole model. The EmbeddedRegion object is derived from the ConstrainedSketchConstraint object.
Note
This object can be accessed by:
import interaction mdb.models[name].constraints[name]
The corresponding analysis keywords are:
EMBEDDED ELEMENT
Note
Member Details:
-
absoluteTolerance : --is-rst--:py:class:`float` =
0
[source]¶ A Float specifying the absolute value by which a node on the embedded region may lie outside the host region. If absoluteTolerance = 0.0, the fractionalTolerance value will be used. The default value is 0.0.This argument applies only when toleranceMethod = ABSOLUTE or BOTH.
- embeddedRegion : --is-rst--:py:class:`~abaqus.Region.Region.Region`[source]¶
A Region object specifying the body region to be embedded.
-
fractionalTolerance : --is-rst--:py:class:`float` =
0
[source]¶ A Float specifying the fractional value by which a node on the embedded region may lie outside the host region. The fractional value is based on the average element size within the host region. The default value is 0.05.If both tolerance arguments are specified, the smaller value will be used.This argument applies only when toleranceMethod = FRACTIONAL or BOTH.
- hostRegion : --is-rst--:py:class:`~abaqus.Region.Region.Region`[source]¶
A Region object specifying the host region. A value of None indicates that the host region is the whole model.
- setValues(
- weightFactorTolerance=
None
, - toleranceMethod=
BOTH
, - absoluteTolerance=
0
, - fractionalTolerance=
0
, This method modifies the EmbeddedRegion object.
Note
- Parameters:¶
- weightFactorTolerance=
None
¶ A Float specifying a small value below which the weighting factors will be zeroed out. The default value is 10⁻⁶.
- toleranceMethod=
BOTH
¶ A SymbolicConstant specifying the method used to determine the embedded element tolerance. Possible values are ABSOLUTE, FRACTIONAL, and BOTH. The default value is BOTH.
- absoluteTolerance=
0
¶ A Float specifying the absolute value by which a node on the embedded region may lie outside the host region. If absoluteTolerance = 0.0, the fractionalTolerance value will be used. The default value is 0.0.This argument applies only when toleranceMethod = ABSOLUTE or BOTH.
- fractionalTolerance=
0
¶ A Float specifying the fractional value by which a node on the embedded region may lie outside the host region. The fractional value is based on the average element size within the host region. The default value is 0.05.If both tolerance arguments are specified, the smaller value will be used.This argument applies only when toleranceMethod = FRACTIONAL or BOTH.
- weightFactorTolerance=
-
suppressed : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] =
0
[source]¶ A Boolean specifying whether the constraint is suppressed or not. The default value is OFF.
- class Equation(name, terms)[source]¶
Bases:
Constraint
The Equation object defines a linear multi-point constraint between a set of degrees of freedom. The Equation object is derived from the ConstrainedSketchConstraint object.
Note
This object can be accessed by:
import interaction mdb.models[name].constraints[name]
The corresponding analysis keywords are:
EQUATION
Note
Member Details:
- class MultipointConstraint( )[source]¶
Bases:
Constraint
The MultipointConstraint object defines a constraint between a group of MultipointConstraint nodes located on a region and a reference point. The MultipointConstraint object is derived from the ConstrainedSketchConstraint object.
Note
This object can be accessed by:
import interaction mdb.models[name].constraints[name]
The corresponding analysis keywords are:
MPC
Note
Member Details:
- controlPoint : --is-rst--:py:class:`~abaqus.Region.Region.Region`[source]¶
A Region object specifying the constraint control point.
-
csys : --is-rst--:py:class:`str` | :py:obj:`None` =
None
[source]¶ None or a DatumCsys object specifying the initial orientation of the local coordinate system for the MultipointConstraint’s degrees of freedom. If localCsys = None, the MultipointConstraint is defined in the global coordinate system. The default value is None.
- mpcType : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant`[source]¶
A SymbolicConstant specifying the MPC type of the constraint. Possible values are BEAM_MPC, ELBOW_MPC, PIN_MPC, LINK_MPC, TIE_MPC, and USER_MPC.
-
setValues(csys=
None
, userType=0
, userMode=DOF_MODE_MPC
)[source]¶ This method modifies the MultipointConstraint object.
- Parameters:¶
- csys=
None
¶ None or a DatumCsys object specifying the initial orientation of the local coordinate system for the MultipointConstraint’s degrees of freedom. If localCsys = None, the MultipointConstraint is defined in the global coordinate system. The default value is None.
- userType=
0
¶ An Int specifying to differentiate between different constraint types in a user-defined MultipointConstraint. The default value is 0.The userType argument applies only when mpcType = USER_MPC.
- userMode=
DOF_MODE_MPC
¶ A SymbolicConstant specifying the mode of the constraint when it is user-defined. Possible values are DOF_MODE_MPC and NODE_MODE_MPC. The default value is DOF_MODE_MPC.The userMode argument applies only when mpcType = USER_MPC.
- csys=
-
suppressed : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] =
0
[source]¶ A Boolean specifying whether the constraint is suppressed or not. The default value is OFF.
- surface : --is-rst--:py:class:`~abaqus.Region.Region.Region`[source]¶
A Region object specifying the surface on which the MultipointConstraint nodes are located.
-
userMode : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` =
'DOF_MODE_MPC'
[source]¶ A SymbolicConstant specifying the mode of the constraint when it is user-defined. Possible values are DOF_MODE_MPC and NODE_MODE_MPC. The default value is DOF_MODE_MPC.The userMode argument applies only when mpcType = USER_MPC.
- class RigidBody(
- name,
- refPointRegion,
- bodyRegion=
None
, - tieRegion=
None
, - pinRegion=
None
, - surfaceRegion=
None
, - refPointAtCOM=
0
, - isothermal=
0
, Bases:
Constraint
The RigidBody object constrains all the degrees of freedom on the specified regions to the degree of freedom of its associated reference point. The RigidBody object is derived from the ConstrainedSketchConstraint object.
Note
This object can be accessed by:
import interaction mdb.models[name].constraints[name]
The corresponding analysis keywords are:
RIGID BODY
Note
Member Details:
-
bodyRegion : --is-rst--:py:class:`str` | :py:obj:`None` =
None
[source]¶ None or a Region object specifying the elements constrained to the movement of the reference point. The default value is None.
-
isothermal : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] =
0
[source]¶ A Boolean specifying whether the temperature degree of freedom should be constrained. The default value is OFF.
-
pinRegion : --is-rst--:py:class:`str` | :py:obj:`None` =
None
[source]¶ None or a Region object specifying the nodes pinned to the movement of the reference point. The default value is None.
-
refPointAtCOM : --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 recompute the reference point position to be at the center of mass. The default value is OFF.
- refPointRegion : --is-rst--:py:class:`~abaqus.Region.Region.Region`[source]¶
A Region object specifying the reference point.
- setValues(
- bodyRegion=
None
, - tieRegion=
None
, - pinRegion=
None
, - surfaceRegion=
None
, - refPointAtCOM=
0
, - isothermal=
0
, This method modifies the RigidBody object.
Note
- Parameters:¶
- bodyRegion=
None
¶ None or a Region object specifying the elements constrained to the movement of the reference point. The default value is None.
- tieRegion=
None
¶ None or a Region object specifying the nodes tied to the movement of the reference point. The default value is None.
- pinRegion=
None
¶ None or a Region object specifying the nodes pinned to the movement of the reference point. The default value is None.
- surfaceRegion=
None
¶ None or a Region object specifying the analytic surface constrained to the movement of the reference point. The default value is None.
- refPointAtCOM=
0
¶ A Boolean specifying whether the analysis product should recompute the reference point position to be at the center of mass. The default value is OFF.
- isothermal=
0
¶ A Boolean specifying whether the temperature degree of freedom should be constrained. The default value is OFF.
- bodyRegion=
-
suppressed : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] =
0
[source]¶ A Boolean specifying whether the constraint is suppressed or not. The default value is OFF.
- class ShellSolidCoupling(
- name,
- shellEdge,
- solidFace,
- positionToleranceMethod=
COMPUTED
, - positionTolerance=
0
, - influenceDistanceMethod=
DEFAULT
, - influenceDistance=
0
, Bases:
Constraint
The ShellSolidCoupling object defines two surfaces to be tied together for the duration of a simulation. The ShellSolidCoupling object is derived from the ConstrainedSketchConstraint object.
Note
This object can be accessed by:
import interaction mdb.models[name].constraints[name]
The corresponding analysis keywords are:
SHELL TO SOLID COUPLING
Note
Member Details:
-
influenceDistance : --is-rst--:py:class:`float` =
0
[source]¶ A Float specifying the influence distance. The influenceDistance argument applies only when influenceDistanceMethod = SPECIFIED. The default value is 0.0.
-
influenceDistanceMethod : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` =
'DEFAULT'
[source]¶ A SymbolicConstant specifying the method used to determine the influence distance. Possible values are DEFAULT and SPECIFIED. The default value is DEFAULT.
-
positionTolerance : --is-rst--:py:class:`float` =
0
[source]¶ A Float specifying the position tolerance. The default value is 0.0.The positionTolerance argument applies only when positionToleranceMethod = SPECIFIED. Note: Abaqus will not constrain nodes on the solid face region outside the position tolerance.
-
positionToleranceMethod : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` =
'COMPUTED'
[source]¶ A SymbolicConstant specifying the method used to determine the position tolerance. Possible values are COMPUTED and SPECIFIED. The default value is COMPUTED.
- setValues(
- positionToleranceMethod=
COMPUTED
, - positionTolerance=
0
, - influenceDistanceMethod=
DEFAULT
, - influenceDistance=
0
, This method modifies the ShellSolidCoupling object.
- Parameters:¶
- positionToleranceMethod=
COMPUTED
¶ A SymbolicConstant specifying the method used to determine the position tolerance. Possible values are COMPUTED and SPECIFIED. The default value is COMPUTED.
- positionTolerance=
0
¶ A Float specifying the position tolerance. The default value is 0.0.The positionTolerance argument applies only when positionToleranceMethod = SPECIFIED. Note: Abaqus will not constrain nodes on the solid face region outside the position tolerance.
- influenceDistanceMethod=
DEFAULT
¶ A SymbolicConstant specifying the method used to determine the influence distance. Possible values are DEFAULT and SPECIFIED. The default value is DEFAULT.
- influenceDistance=
0
¶ A Float specifying the influence distance. The influenceDistance argument applies only when influenceDistanceMethod = SPECIFIED. The default value is 0.0.
- positionToleranceMethod=
- shellEdge : --is-rst--:py:class:`~abaqus.Region.Region.Region`[source]¶
A Region object specifying the name of the shell edge surface.
- class Tie(
- name,
- main,
- secondary,
- adjust=
1
, - positionToleranceMethod=
COMPUTED
, - positionTolerance=
0
, - tieRotations=
1
, - constraintRatioMethod=
DEFAULT
, - constraintRatio=
0
, - constraintEnforcement=
SOLVER_DEFAULT
, - thickness=
1
, Bases:
Constraint
The Tie object defines two surfaces to be tied together for the duration of a simulation. The Tie object is derived from the ConstrainedSketchConstraint object.
Note
This object can be accessed by:
import interaction mdb.models[name].constraints[name]
The corresponding analysis keywords are:
TIE
Note
Check Tie on help.3ds.com/2024.
Member Details:
-
adjust : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] =
1
[source]¶ A Boolean specifying whether initial positions of tied secondary nodes are adjusted to lie on the main surface. The default value is ON.
-
constraintEnforcement : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` =
'SOLVER_DEFAULT'
[source]¶ A SymbolicConstant specifying the discretization method. Possible values are SOLVER_DEFAULT, NODE_TO_SURFACE, and SURFACE_TO_SURFACE. The default value is SOLVER_DEFAULT.
-
constraintRatio : --is-rst--:py:class:`float` =
0
[source]¶ A Float specifying the fractional distance between the main reference surface and the secondary node at which the translational constraint should act. The constraintRatio argument applies only when constraintRatioMethod = SPECIFIED. The default value is 0.0.
-
constraintRatioMethod : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` =
'DEFAULT'
[source]¶ A SymbolicConstant specifying the method used to determine the constraint ratio. Possible values are DEFAULT and SPECIFIED. The default value is DEFAULT.
- main : --is-rst--:py:class:`~abaqus.Region.Region.Region`[source]¶
A Region object specifying the name of the main surface.
Changed in version 2022: The
master
attribute was renamed tomain
.
-
positionTolerance : --is-rst--:py:class:`float` =
0
[source]¶ A Float specifying the position tolerance. The positionTolerance argument applies only when positionToleranceMethod = SPECIFIED. The default value is 0.0.
-
positionToleranceMethod : --is-rst--:py:class:`~abaqus.UtilityAndView.SymbolicConstant.SymbolicConstant` =
'COMPUTED'
[source]¶ A SymbolicConstant specifying the method used to determine the position tolerance. Possible values are COMPUTED and SPECIFIED. The default value is COMPUTED.
- secondary : --is-rst--:py:class:`~abaqus.Region.Region.Region`[source]¶
A Region object specifying the name of the secondary surface.
Changed in version 2022: The
slave
attribute was renamed tosecondary
.
- setValues(
- adjust=
1
, - positionToleranceMethod=
COMPUTED
, - positionTolerance=
0
, - tieRotations=
1
, - constraintRatioMethod=
DEFAULT
, - constraintRatio=
0
, - constraintEnforcement=
SOLVER_DEFAULT
, - thickness=
1
, This method modifies the Tie object.
Note
- Parameters:¶
- adjust=
1
¶ A Boolean specifying whether initial positions of tied secondary nodes are adjusted to lie on the main surface. The default value is ON.
- positionToleranceMethod=
COMPUTED
¶ A SymbolicConstant specifying the method used to determine the position tolerance. Possible values are COMPUTED and SPECIFIED. The default value is COMPUTED.
- positionTolerance=
0
¶ A Float specifying the position tolerance. The positionTolerance argument applies only when positionToleranceMethod = SPECIFIED. The default value is 0.0.
- tieRotations=
1
¶ A Boolean specifying whether rotation degrees of freedom should be tied. The default value is ON.
- constraintRatioMethod=
DEFAULT
¶ A SymbolicConstant specifying the method used to determine the constraint ratio. Possible values are DEFAULT and SPECIFIED. The default value is DEFAULT.
- constraintRatio=
0
¶ A Float specifying the fractional distance between the main reference surface and the secondary node at which the translational constraint should act. The constraintRatio argument applies only when constraintRatioMethod = SPECIFIED. The default value is 0.0.
- constraintEnforcement=
SOLVER_DEFAULT
¶ A SymbolicConstant specifying the discretization method. Possible values are SOLVER_DEFAULT, NODE_TO_SURFACE, and SURFACE_TO_SURFACE. The default value is SOLVER_DEFAULT.
- thickness=
1
¶ A Boolean specifying whether shell element thickness is considered. The default value is ON.
- adjust=
-
suppressed : --is-rst--:py:data:`~typing.Union`\ \[:py:class:`~abaqus.UtilityAndView.AbaqusBoolean.AbaqusBoolean`, :py:class:`bool`] =
0
[source]¶ A Boolean specifying whether the constraint is suppressed or not. The default value is OFF.
- swapSurfaces()[source]¶
This method switches the main and secondary surfaces of a tied constraint.
This command is valid only during the step in which the interaction is created.