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 Constraint object.
import interaction mdb.models[name].constraints[name]
This method creates a Coupling object.
mdb.models[name].Coupling
Required arguments
A String specifying the constraint repository key.
A Region object specifying the surface on which the coupling nodes are located.
A Region object specifying the constraint control point.
The SymbolicConstant WHOLE_SURFACE or a Float specifying the influence radius.
A SymbolicConstant specifying the coupling constraint type. Possible values are KINEMATIC, DISTRIBUTING, and STRUCTURAL.
Optional arguments
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.
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.
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.
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.
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.
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.
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.
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.
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.
Return value
A Coupling object.
Exceptions
This method modifies the Coupling object.
Required arguments
Optional arguments
The optional arguments to setValues are the same as the arguments to the Coupling method, except for the name argument.
Return value
Exceptions
The Coupling object has members with the same names and descriptions as the arguments to the Coupling method.
In addition, the Coupling object has the following member:
A Boolean specifying whether the constraint is suppressed or not. The default value is OFF.