Constraint#

The Constraint commands define constraints between regions of the model.

Create constraints#

class ConstraintModel(name: str, description: str = '', stefanBoltzmann: float | None = None, absoluteZero: float | None = None, waveFormulation: SymbolicConstantType = 'NOT_SET', modelType: SymbolicConstantType = 'STANDARD_EXPLICIT', universalGas: float | None = None, copyConstraints: BooleanType = 1, copyConnectors: BooleanType = 1, copyInteractions: BooleanType = 1)[source]#

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

Notes

This object can be accessed by:

mdb.models[name]

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.

AdjustPoints(name: str, surface: Region, controlPoints: Region) → AdjustPoints[source]#

This method creates an AdjustPoints object.

Parameters:

name: A String specifying the constraint repository key.
surface: A Region object specifying the surface to which the controlPoints are adjusted.
controlPoints: A Region object specifying the constraint control points.

Returns:

An AdjustPoints object.

Notes

This function can be accessed by:

mdb.models[name].AdjustPoints

Coupling(name: str, surface: Region, controlPoint: Region, influenceRadius: SymbolicConstantType | float, couplingType: SymbolicConstantType, adjust: BooleanType = 0, localCsys: str | None = None, u1: BooleanType = 1, u2: BooleanType = 1, u3: BooleanType = 1, ur1: BooleanType = 1, ur2: BooleanType = 1, ur3: BooleanType = 1, weightingMethod: SymbolicConstantType = 'UNIFORM') → Coupling[source]#

This method creates a Coupling object.

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

Returns:

A Coupling object.

Notes

This function can be accessed by:

mdb.models[name].Coupling

DisplayBody(name: str, instance: PartInstance, controlPoints: ModelDotArray) → DisplayBody[source]#

This method creates a DisplayBody object.

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.

Notes

This function can be accessed by:

mdb.models[name].DisplayBody

EmbeddedRegion(name: str, embeddedRegion: Region, hostRegion: Region, weightFactorTolerance: float | None = None, toleranceMethod: SymbolicConstantType | None = None, absoluteTolerance: float = 0, fractionalTolerance: float = 0) → EmbeddedRegion[source]#

This method creates a EmbeddedRegion object.

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: A Float specifying a small value below which the weighting factors will be zeroed out. The default value is 10–6.
toleranceMethod: 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: 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: 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.

Notes

This function can be accessed by:

mdb.models[name].EmbeddedRegion

Equation(name: str, terms: tuple) → Equation[source]#

This method creates an Equation object.

Parameters:

name: A String specifying the constraint repository key.
terms: A sequence of (Float, String, Int, Int) sequences specifying a coefficient, Set name, degree of freedom, and coordinate system ID. The coordinate system ID is optional.

Returns:

An Equation object.

Raises:

If terms does not contain more than one entry:
Equation must have two or more terms.

Notes

This function can be accessed by:

mdb.models[name].Equation

MultipointConstraint(name: str, surface: Region, controlPoint: Region, mpcType: SymbolicConstantType, csys: str | None = None, userType: int = 0, userMode: SymbolicConstantType = 'DOF_MODE_MPC') → MultipointConstraint[source]#

This method creates a MultipointConstraint object.

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

Notes

This function can be accessed by:

mdb.models[name].MultipointConstraint

RigidBody(name: str, refPointRegion: Region, bodyRegion: str | None = None, tieRegion: str | None = None, pinRegion: str | None = None, surfaceRegion: str | None = None, refPointAtCOM: BooleanType = 0, isothermal: BooleanType = 0) → RigidBody[source]#

This method creates a RigidBody object.

Parameters:

name: A String specifying the constraint repository key.
refPointRegion: A Region object specifying the reference point.
bodyRegion: None or a Region object specifying the elements constrained to the movement of the reference point. The default value is None.
tieRegion: None or a Region object specifying the nodes tied to the movement of the reference point. The default value is None.
pinRegion: None or a Region object specifying the nodes pinned to the movement of the reference point. The default value is None.
surfaceRegion: None or a Region object specifying the analytic surface constrained to the movement of the reference point. The default value is None.
refPointAtCOM: 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: A Boolean specifying whether the temperature degree of freedom should be constrained. The default value is OFF.

Returns:

A RigidBody object.

Notes

This function can be accessed by:

mdb.models[name].RigidBody

ShellSolidCoupling(name: str, shellEdge: Region, solidFace: Region, positionToleranceMethod: SymbolicConstantType = 'COMPUTED', positionTolerance: float = 0, influenceDistanceMethod: SymbolicConstantType = 'DEFAULT', influenceDistance: float = 0) → ShellSolidCoupling[source]#

This method creates a ShellSolidCoupling object.

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: A SymbolicConstant specifying the method used to determine the position tolerance. Possible values are COMPUTED and SPECIFIED. The default value is COMPUTED.
positionTolerance: 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: A SymbolicConstant specifying the method used to determine the influence distance. Possible values are DEFAULT and SPECIFIED. The default value is DEFAULT.
influenceDistance: A Float specifying the influence distance. The influenceDistance argument applies only when *influenceDistanceMethod*=SPECIFIED. The default value is 0.0.

Returns:

A ShellSolidCoupling object.

Notes

This function can be accessed by:

mdb.models[name].ShellSolidCoupling

Tie(name: str, main: Region, secondary: Region, adjust: BooleanType = 1, positionToleranceMethod: SymbolicConstantType = 'COMPUTED', positionTolerance: float = 0, tieRotations: BooleanType = 1, constraintRatioMethod: SymbolicConstantType = 'DEFAULT', constraintRatio: float = 0, constraintEnforcement: SymbolicConstantType = 'SOLVER_DEFAULT', thickness: BooleanType = 1) → Tie[source]#

This method creates a Tie object.

Parameters:

name: A String specifying the constraint repository key.
main: A Region object specifying the name of the master surface.
secondary: A Region object specifying the name of the slave surface.
adjust: A Boolean specifying whether initial positions of tied slave nodes are adjusted to lie on the master surface. The default value is ON.
positionToleranceMethod: A SymbolicConstant specifying the method used to determine the position tolerance. Possible values are COMPUTED and SPECIFIED. The default value is COMPUTED.
positionTolerance: A Float specifying the position tolerance. The positionTolerance argument applies only when *positionToleranceMethod*=SPECIFIED. The default value is 0.0.
tieRotations: A Boolean specifying whether rotation degrees of freedom should be tied. The default value is ON.
constraintRatioMethod: A SymbolicConstant specifying the method used to determine the constraint ratio. Possible values are DEFAULT and SPECIFIED. The default value is DEFAULT.
constraintRatio: A Float specifying the fractional distance between the master reference surface and the slave node at which the translational constraint should act. The constraintRatio argument applies only when *constraintRatioMethod*=SPECIFIED. The default value is 0.0.
constraintEnforcement: 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: A Boolean specifying whether shell element thickness is considered. The default value is ON.

Returns:

A Tie object.

Notes

This function can be accessed by:

mdb.models[name].Tie

Object features#

Constraint#

class Constraint[source]#

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.

Notes

This object can be accessed by:

import interaction
mdb.models[name].constraints[name]

Attributes:

name: str: A String specifying the constraint repository key.
suppressed: Boolean: A Boolean specifying whether the constraint is suppressed or not. The default value is OFF.

Methods

`delete`(indices)	This method allows you to delete existing constraints.
`resume`()	This method resumes the constraint that was previously suppressed.
`suppress`()	This method suppresses the constraint.

delete(indices: tuple)[source]#

This method allows you to delete existing constraints.

Parameters:

indices: A sequence of Ints specifying the index of each constraint to delete.

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

suppress()[source]#: This method suppresses the constraint.

AdjustPoints#

class AdjustPoints(name: str, surface: Region, controlPoints: Region)[source]#

The AdjustPoints constraint object is used to adjust points (nodes) to a surface. The AdjustPoints object is derived from the ConstrainedSketchConstraint object.

Notes

This object can be accessed by:

import interaction
mdb.models[name].constraints[name]

The corresponding analysis keywords are:

ADJUST

Attributes:

suppressed: Boolean: A Boolean specifying whether the constraint is suppressed or not. The default value is OFF.

Methods

setValues()

This method modifies the AdjustPoints object.

setValues()[source]#: This method modifies the AdjustPoints object.

Coupling#

class Coupling(name: str, surface: Region, controlPoint: Region, influenceRadius: SymbolicConstantType | float, couplingType: SymbolicConstantType, adjust: BooleanType = 0, localCsys: str | None = None, u1: BooleanType = 1, u2: BooleanType = 1, u3: BooleanType = 1, ur1: BooleanType = 1, ur2: BooleanType = 1, ur3: BooleanType = 1, weightingMethod: SymbolicConstantType = 'UNIFORM', alpha: float = 0.0)[source]#

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.

Notes

This object can be accessed by:

import interaction
mdb.models[name].constraints[name]

The corresponding analysis keywords are:

COUPLING

Attributes:

suppressed: Boolean: A Boolean specifying whether the constraint is suppressed or not. The default value is OFF.

Methods

setValues([adjust, localCsys, u1, u2, u3, ...])

This method modifies the Coupling object.

setValues(adjust: BooleanType = 0, localCsys: str | None = None, u1: BooleanType = 1, u2: BooleanType = 1, u3: BooleanType = 1, ur1: BooleanType = 1, ur2: BooleanType = 1, ur3: BooleanType = 1, weightingMethod: SymbolicConstantType = 'UNIFORM', alpha: float = 0.0)[source]#

This method modifies the Coupling object.

Parameters:

adjust: 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 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: 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: 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: 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: 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: 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: 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: 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: A Float specifying the value of the thermal expansion coefficient. The default value is 0.0. The alpha argument applies only when couplingType=KINEMATIC.

DisplayBody#

class DisplayBody(name: str, instance: PartInstance, controlPoints: ModelDotArray)[source]#

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.

Notes

This object can be accessed by:

import interaction
mdb.models[name].constraints[name]

The corresponding analysis keywords are:

DISPLAY BODY

Attributes:

suppressed: Boolean: A Boolean specifying whether the constraint is suppressed or not. The default value is OFF.

Methods

setValues()

This method modifies the DisplayBody object.

setValues()[source]#: This method modifies the DisplayBody object.

EmbeddedRegion#

class EmbeddedRegion(name: str, embeddedRegion: Region, hostRegion: Region, weightFactorTolerance: float | None = None, toleranceMethod: SymbolicConstantType | None = None, absoluteTolerance: float = 0, fractionalTolerance: float = 0)[source]#

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.

Notes

This object can be accessed by:

import interaction
mdb.models[name].constraints[name]

The corresponding analysis keywords are:

EMBEDDED ELEMENT

Attributes:

suppressed: Boolean: A Boolean specifying whether the constraint is suppressed or not. The default value is OFF.

Methods

setValues([weightFactorTolerance, ...])

This method modifies the EmbeddedRegion object.

setValues(weightFactorTolerance: float | None = None, toleranceMethod: SymbolicConstantType | None = None, absoluteTolerance: float = 0, fractionalTolerance: float = 0)[source]#

This method modifies the EmbeddedRegion object.

Parameters:

weightFactorTolerance: A Float specifying a small value below which the weighting factors will be zeroed out. The default value is 10–6.
toleranceMethod: 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: 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: 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.

Equation#

class Equation(name: str, terms: tuple)[source]#

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.

Notes

This object can be accessed by:

import interaction
mdb.models[name].constraints[name]

The corresponding analysis keywords are:

EQUATION

Attributes:

suppressed: Boolean: A Boolean specifying whether the constraint is suppressed or not. The default value is OFF.

Methods

setValues()

This method modifies the Equation object.

setValues()[source]#

This method modifies the Equation object.

Raises:

If terms does not contain more than one entry:
Equation must have two or more terms.

MultipointConstraint#

class MultipointConstraint(name: str, surface: Region, controlPoint: Region, mpcType: SymbolicConstantType, csys: str | None = None, userType: int = 0, userMode: SymbolicConstantType = 'DOF_MODE_MPC')[source]#

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.

Notes

This object can be accessed by:

import interaction
mdb.models[name].constraints[name]

The corresponding analysis keywords are:

Attributes:

suppressed: Boolean: A Boolean specifying whether the constraint is suppressed or not. The default value is OFF.

Methods

setValues([csys, userType, userMode])

This method modifies the MultipointConstraint object.

setValues(csys: str | None = None, userType: int = 0, userMode: SymbolicConstantType = 'DOF_MODE_MPC')[source]#

This method modifies the MultipointConstraint object.

Parameters:

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

RigidBody#

class RigidBody(name: str, refPointRegion: Region, bodyRegion: str | None = None, tieRegion: str | None = None, pinRegion: str | None = None, surfaceRegion: str | None = None, refPointAtCOM: BooleanType = 0, isothermal: BooleanType = 0)[source]#

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.

Notes

This object can be accessed by:

import interaction
mdb.models[name].constraints[name]

The corresponding analysis keywords are:

RIGID BODY

Attributes:

suppressed: Boolean: A Boolean specifying whether the constraint is suppressed or not. The default value is OFF.

Methods

setValues([bodyRegion, tieRegion, ...])

This method modifies the RigidBody object.

setValues(bodyRegion: str | None = None, tieRegion: str | None = None, pinRegion: str | None = None, surfaceRegion: str | None = None, refPointAtCOM: BooleanType = 0, isothermal: BooleanType = 0)[source]#

This method modifies the RigidBody object.

Parameters:

bodyRegion: None or a Region object specifying the elements constrained to the movement of the reference point. The default value is None.
tieRegion: None or a Region object specifying the nodes tied to the movement of the reference point. The default value is None.
pinRegion: None or a Region object specifying the nodes pinned to the movement of the reference point. The default value is None.
surfaceRegion: None or a Region object specifying the analytic surface constrained to the movement of the reference point. The default value is None.
refPointAtCOM: 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: A Boolean specifying whether the temperature degree of freedom should be constrained. The default value is OFF.

ShellSolidCoupling#

class ShellSolidCoupling(name: str, shellEdge: Region, solidFace: Region, positionToleranceMethod: SymbolicConstantType = 'COMPUTED', positionTolerance: float = 0, influenceDistanceMethod: SymbolicConstantType = 'DEFAULT', influenceDistance: float = 0)[source]#

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.

Notes

This object can be accessed by:

import interaction
mdb.models[name].constraints[name]

The corresponding analysis keywords are:

SHELL TO SOLID COUPLING

Attributes:

suppressed: Boolean: A Boolean specifying whether the constraint is suppressed or not. The default value is OFF.

Methods

setValues([positionToleranceMethod, ...])

This method modifies the ShellSolidCoupling object.

setValues(positionToleranceMethod: SymbolicConstantType = 'COMPUTED', positionTolerance: float = 0, influenceDistanceMethod: SymbolicConstantType = 'DEFAULT', influenceDistance: float = 0)[source]#

This method modifies the ShellSolidCoupling object.

Parameters:

positionToleranceMethod: A SymbolicConstant specifying the method used to determine the position tolerance. Possible values are COMPUTED and SPECIFIED. The default value is COMPUTED.
positionTolerance: 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: A SymbolicConstant specifying the method used to determine the influence distance. Possible values are DEFAULT and SPECIFIED. The default value is DEFAULT.
influenceDistance: A Float specifying the influence distance. The influenceDistance argument applies only when *influenceDistanceMethod*=SPECIFIED. The default value is 0.0.

Tie#

class Tie(name: str, main: Region, secondary: Region, adjust: BooleanType = 1, positionToleranceMethod: SymbolicConstantType = 'COMPUTED', positionTolerance: float = 0, tieRotations: BooleanType = 1, constraintRatioMethod: SymbolicConstantType = 'DEFAULT', constraintRatio: float = 0, constraintEnforcement: SymbolicConstantType = 'SOLVER_DEFAULT', thickness: BooleanType = 1)[source]#

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.

Notes

This object can be accessed by:

import interaction
mdb.models[name].constraints[name]

The corresponding analysis keywords are:

Attributes:

suppressed: Boolean: A Boolean specifying whether the constraint is suppressed or not. The default value is OFF.

Methods

`setValues`([adjust, positionToleranceMethod, ...])	This method modifies the Tie object.
`swapSurfaces`()	This method switches the master and slave surfaces of a tied constraint.

setValues(adjust: BooleanType = 1, positionToleranceMethod: SymbolicConstantType = 'COMPUTED', positionTolerance: float = 0, tieRotations: BooleanType = 1, constraintRatioMethod: SymbolicConstantType = 'DEFAULT', constraintRatio: float = 0, constraintEnforcement: SymbolicConstantType = 'SOLVER_DEFAULT', thickness: BooleanType = 1)[source]#

This method modifies the Tie object.

Parameters:

adjust: A Boolean specifying whether initial positions of tied secondary nodes are adjusted to lie on the main surface. The default value is ON.
positionToleranceMethod: A SymbolicConstant specifying the method used to determine the position tolerance. Possible values are COMPUTED and SPECIFIED. The default value is COMPUTED.
positionTolerance: A Float specifying the position tolerance. The positionTolerance argument applies only when *positionToleranceMethod*=SPECIFIED. The default value is 0.0.
tieRotations: A Boolean specifying whether rotation degrees of freedom should be tied. The default value is ON.
constraintRatioMethod: A SymbolicConstant specifying the method used to determine the constraint ratio. Possible values are DEFAULT and SPECIFIED. The default value is DEFAULT.
constraintRatio: 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: 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: A Boolean specifying whether shell element thickness is considered. The default value is ON.

swapSurfaces()[source]#: This method switches the master and slave surfaces of a tied constraint. This command is valid only during the step in which the interaction is created.