constraints

Unless otherwise specified, data names are accessible in level 3 only.

alpha
The field to specify the thermal expansion coefficient. Applicable for config 301.
Type: double array
ALPHA1
The scaling factor alpha1. Applicable for config 101.
Type: double
ALPHA1_FID
The curve ID for scaling factor. Applicable for config 101.
Type: entity
ALPHA2
The plastic initiation displacement scaling factor. Applicable for config 101.
Type: double
ALPHA3
The plastic rupture displacement scaling factor. Applicable for config 101.
Type: double
alpha_option
Option to turn on the alpha entry field.
Type: Boolean
activesuppressed
Returns non-zero if the entity is set inactive, 0 otherwise.
Type: integer
attributesmax
The number of attributes owned by this entity.
Type: unsigned integer
BETA1
The exponent for plastic potential. Applicable for config 101.
Type: double
BETA1_FID
The curve ID for exponent for plastic potential. Applicable for config 101.
Type: entity
BETA2
The exponent for plastic initiation displacement. Applicable for config 101.
Type: double
BETA3
The exponent for plastic rupture displacement. Applicable for config 101.
Type: double
CIDA
Coordinate ID for rigid body A.
Type: entity
CIDB
Coordinate ID for rigid body B.
Type: entity
color
The 1-64 color of the entity.
Type: integer
color_rgb
The RGB color of the entity.
Type: string
config
The configuration of the entity.
101 - *CONSTRAINED_INTERPOLATION_SPOTWELD in LS-DYNA
102 - *CONSTRAINED_JOINT_STIFFNESS in LS-DYNA
103 - * CONSTRAINED_ADAPTIVITY in LS-DYNA
104 - * CONSTRAINED_SPR2 in LS-DYNA
201 - Radioss MERGE_RBODY
202 - Radioss MERGE_RBODY_NODES
203 - Radioss MERGE_RBODY_GRNODS
301 – Abaqus Coupling kinematic
302 – Abaqus Coupling distributing
Type: unsigned integer
coupling_option
Option to turn on the coupling selector. Applicable for config 302
Type: Boolean
coupling_value
The option to pick coupling value. Applicable for config 302
0 – CONTINUUM
1 – STRUCTURAL
D
The rivet diameter.
Type: double
definedentity
True if the entity is defined, false otherwise.
Type: Boolean
DENS
The spotweld density. Applicable for config 101.
Type: double
distribution_type
Specified the distribution type for the weights at the coupling nodes. Applicable for config 302.
0 – UNIFORM
1 – NON-UNIFORM
DLCIDAL
Load curve ID for alpha-damping moment as a function of rate of rotation in radians per unit time.
Type: entity
DLCIDBT
Load curve ID for beta-damping torque as a function of rate of twist.
Type: entity
DLCIDG
Load curve ID for gamma-damping scale factor as a function of rate of rotation in radians per unit time.
Type: entity
DLCIDP
Load curve or table ID for p-damping force as a function of rate of p-distance per unit time and optionally p-distance (if table) between the origins of CIDA and CIDB.
Type: entity
DLCIDPH
Load curve ID for phi-damping moment as a function of rate of rotation in radians per unit time.
Type: entity
DLCIDPS
Load curve ID for psi-damping torque as a function of rate of rotation in radians per unit time.
Type: entity
DLCIDR
Load curve or table ID for r-damping force as a function of rate of r-distance per unit time and optionally r-distance (if table) between the origins of CIDA and CIDB.
Type: entity
DLCIDT
Load curve ID for theta-damping moment as a function of rate of rotation in radians per unit time.
Type: entity
DLCIDX
Load curve ID for x-damping force as a function of rate of x-translational displacement per unit time between the origins of CIDA and CIDB based on the x-direction of CIDB.
Type: entity
DLCIDY
Load curve ID for y-damping force as a function of rate of y-translational displacement per unit time between the origins of CIDA and CIDB based on the y-direction of CIDB.
Type: entity
DLCIDZ
Load curve ID for z-damping force as a function of rate of z-translational displacement per unit time between the origins of CIDA and CIDB based on the z-direction of CIDB.
Type: entity
DN
The failure displacement in normal direction.
Type: double
DNID
The dependent node.
Type: entity
dof1
Select first degree of freedom.
Type: Boolean
dof2
Select second degree of freedom.
Type: Boolean
dof3
Select third degree of freedom.
Type: Boolean
dof4
Select fourth degree of freedom.
Type: Boolean
dof5
Select fifth degree of freedom.
Type: Boolean
dof6
Select sixth degree of freedom.
Type: Boolean
DT
The failure displacement in tangential direction.
Type: double
ESAL
Elastic stiffness per unit radian for friction and stop angles for alpha rotation.
Type: double
ESBT
Elastic stiffness per unit radian for friction and stop angles for beta twist.
Type: double
ESPH
Elastic stiffness per unit radian for friction and stop angles for phi rotation.
Type: double
ESPS
Elastic stiffness per unit radian for friction and stop angles for psi rotation.
Type: double
ESR
Elastic stiffness for friction and stop displacement for r-translation.
Type: double
EST
Elastic stiffness per unit radian for friction and stop angles for theta rotation.
Type: double
ESX
Elastic stiffness for friction and stop displacement for x-translation.
Type: double
ESY
Elastic stiffness for friction and stop displacement for y-translation.
Type: double
ESZ
Elastic stiffness for friction and stop displacement for z-translation.
Type: double
EXPN
The exponent value for load function in normal direction.
Type: double
EXPT
The exponent value for load function in tangential direction.
Type: double
FFR
Frictional force limiting value for r-translation.
Type: double
FFR_CURVE
The load curve ID defining the yield force as a function r-translation
Type: entity
FFR_CURVE_OPT
FFR curve option.
Type: Boolean
FFX
Frictional force limiting value for x-translation.
Type: double
FFX_CURVE
FFX is the load curve ID defining the yield force as a function of x-translation.
Type: entity
FFX_CURVE_OPT
FFX curve option.
Type: Boolean
FFY
Frictional force limiting value for y-translation.
Type: double
FFY_CURVE
The load curve ID defining the yield force as a function of y-translation.
Type: entity
FFY_CURVE_OPT
FFY curve option.
Type: Boolean
FFZ
Frictional force limiting value for z-translation.
Type: double
FFZ_CURVE
The load curve ID defining the yield force as a function of z-translation.
Type: entity
FFZ_CURVE_OPT
FFZ curve option.
Type: Boolean
FMAL
Frictional moment limiting value for alpha rotation.
Type: double
FMAL_CURVE
The load curve or table ID defining the yield moment as a function of alpha rotation.
Type: entity
FMAL_CURVE_OPT
FMAL curve option.
Type: Boolean
FMBT
Frictional moment limiting value for beta twist.
Type: double
FMBT_CURVE
The load curve or table ID defining the yield moment as a function of beta rotation.
Type: entity
FMBT_CURVE_OPT
FMBT curve option.
Type: Boolean
FMPH
Frictional moment limiting value for phi rotation.
Type: double
FMPH_CURVE
The load curve or table ID defining the yield moment as a function of phi rotation.
Type: entity
FMPH_CURVE_OPT
FMPH curve option.
Type: Boolean
FMPS
Frictional moment limiting value for psi rotation.
Type: double
FMPS_CURVE
The load curve or table ID defining the yield moment as a function of psi rotation.
Type: entity
FMPS_CURVE_OPT
FMPS curve option.
Type: Boolean
FMT
Frictional moment limiting value for theta rotation.
Type: double
FMT_CURVE
The load curve or table ID defining the yield moment as a function of theta rotation.
Type: entity
FMT_CURVE_OPT
FMT curve option.
Type: Boolean
FN
The rivet strength in tension.
Type: double
FN_Flag
The flag for material ID.
Type: Boolean
FNMID
The material data from instantiation of *MAT_CONSTRAINED_ SPR2.
Type: entity
free_nodes_option
Option to turn on the free nodes selector. Applicable for config 302.
Type: Boolean
free_nodes_value
The option to setup treatment method for nodes. Applicable for config 302.
0 – ALLOW
1 - ERROR
2 - REMOVE
FT
The rivet strength in pure shear.
Type: double
GAMMA
The scaling factor. Applicable for config 101.
Type: double
id
The ID of the entity.
Type: unsigned integer
iflag
The merge option flag.
Type: integer
include
The ID of the include file the entity is organized in.
Type: entity
includeid
The ID of the include file the entity is organized in.
Type: unsigned integer
influence_radius
The field to enter influence radius.
Type: double
influence_radius_option
Option to turn on the influence radius entry field.
Type: Boolean
internalid
The ID of the entity.
Type: unsigned integer
internalname
The internal name of the entity.
Type: string
INTP
The interpolation flag. Applicable for config 101.
0 - Linear (default)
1 - Uniform
2 - Inverse distance weighting
Type: double
JID
Joint ID for the joint reaction forces.
Type: entity
LCDEXP
The load curve for damage exponent as a function of mode mixity. Applicable for config 101.
Type: entity
LCF
The load curve ID or table ID. Applicable for config 101.
Type: entity
LCIDAL
Load curve ID for alpha-moment as a function of rotation in radians.
Type: entity
LCIDBT
Load curve ID for beta-torsion moment as a function of twist in radians.
Type: entity
LCIDG
Load curve ID for gamma as a function of a scale factor which scales the bending moment due to the alpha rotation.
Type: entity
LCIDPH
Load curve ID for phi-moment as a function of rotation in radians.
Type: entity
LCIDPS
Load curve ID for psi-moment as a function of rotation in radians.
Type: entity
LCIDR
Load curve ID for r-force as a function of r-distance between the origins of CIDA and CIDB.
Type: entity
LCIDT
Load curve ID for theta-moment as a function of rotation in radians.
Type: entity
LCIDX
Load curve ID for x-force as a function of x-distance between the origins of CIDA and CIDB based on the x-direction of CIDB.
Type: entity
LCIDY
Load curve ID for y-force as a function of y-distance between the origins of CIDA and CIDB based on the y-direction of CIDB.
Type: entity
LCIDZ
Load curve ID for z-force as a function of z-distance between the origins of CIDA and CIDB based on the z-direction of CIDB.
Type: entity
LCUPF
The load curve ID describing plastic initiation displacement as a function of mode mixity. Applicable for config 101.
Type: entity
LCUPR
The load curve ID describing plastic rupture displacement as a function of mode mixity. Applicable for config 101.
Type: entity
location_unit_node
The coupling nodes on which the weight distribution is specified. Applicable for config 302.
Type: entity array
LPID
The lower sheet part ID.
Type: entity
mainid
The main rigid body identifier.
Type: entity
MODEL
The material behavior and damage model. Applicable for config 101.
Type: double
moduleid
The module ID of the entity.
Type: integer
MRN
The proportionality factor for dependency. Applicable for config 101.
Type: double
MRS
The proportionality factor for dependency. Applicable for config 101.
Type: double
mtype
The main rigid body type flag.
Type: integer
name
The name of the entity.
Type: string
NID1
The node at one end of an element edge.
Type: entity
NID2
The node at the other end of that same element edge.
Type: entity
NSABT
Stop angle in degrees for negative beta rotation.
Type: double
NSAPH
Stop angle in degrees for negative phi rotation.
Type: double
NSAPS
Stop angle in degrees for negative psi rotation.
Type: double
NSAT
Stop angle in degrees for negative theta rotation.
Type: double
NSDX
Stop displacement for negative x-translation.
Type: double
NSDY
Stop displacement for negative y-translation.
Type: double
NSDZ
Stop displacement for negative z-translation.
Type: double
NSID
The node set ID of spotweld location nodes. Applicable for config 101.
Type: entity
numgrnodes
The number of secondary node sets.
Type: integer
numnodes
The number of secondary nodes.
Type: integer
numrbodies
The number of secondary rigid bodies.
Type: integer
optionalcard
The option to enable optional fields when MODEL is set to 1, 11, or 21. Applicable for config 101.
Type: Boolean
orientation
The system entity that specifies the initial orientation.
Type: entity
orientation_option
Option to turn on the orientation entity selector.
Type: Boolean
outputsuppressed
Returns non-zero if the entity is set "do not export", 0 otherwise.
Type: integer
PID1
The part ID of the first sheet. Applicable for config 101.
Type: entity
PID2
The part ID of the second sheet. Applicable for config 101.
Type: entity
PIDA
Part ID for rigid body A.
Type: entity
PIDB
Part ID for rigid body B.
Type: entity
PIDVB
Part ID for visualization beams representing SPR2/SPR3 in post-processing.
Type: double
poolid
The pool number of the entity.
Type: integer
poolname
The pool name of the entity.
Type: string
PSABT
Stop angle in degrees for positive beta rotation.
Type: double
PSAPH
Stop angle in degrees for positive phi rotation.
Type: double
PSAPS
Stop angle in degrees for positive psi rotation.
Type: double
PSAT
Stop angle in degrees for positive theta rotation.
Type: double
PSDR
Stop displacement for r-translation.
Type: double
PSDX
Stop displacement for positive x-translation.
Type: double
PSDY
Stop displacement for positive y-translation.
Type: double
PSDZ
Stop displacement for positive z-translation.
Type: double
R
The spotweld radius. Applicable for config 101.
Type: double
RAD1
Radius of pin.
Type: double
RAD2
Radius of hole.
Type: double
reference_entity
The entity for setting the reference node or the node set containing reference nodes.
Type: entity
reference_coupling_option
Option to turn on rotational coupling selector. Applicable for config 302.
Type: Boolean
reference_coupling_value
The minimum diameter for finding a hole when findhole is 1.
Type: double
RN
The tensile strength factor. Applicable for config 101.
Type: double
RN_FID
The curve ID for tensile strength factor. Applicable for config 101.
Type: entity
RS
The shear strength factor. Applicable for config 101.
Type: double
RS_FID
The curve ID for shear strength factor. Applicable for config 101.
Type: entity
SAAL
Stop angle in degrees for alpha rotation.
Type: double
secondarygrnodids
The secondary node sets identifier.
Type: entity array
secondarynodeids
The secondary nodes identifier.
Type: entity array
secondarybodyids
The secondary rigid bodies identifier.
Type: entity array
solver_id
The solver ID of the entity.
Type: integer
solverkeyword
The name of the solver keyword.
Type: string
solvername
The solver name of the entity for entities enabled for name pool, otherwise the internal name of the entity.
Type: string
SROPT
The shear rotation option that defines local kinematics system. Applicable for config 101.
Type: double
STIFF
The elastic stiffness. Applicable for config 101.
Type: double
STIFF_FID
The curve ID for elastic stiffness. Applicable for config 101.
Type: entity
STIFF_MID
The material ID in *MAT_CONSTRAINED_SPR3 (*MAT_265). Applicable for config 101.
Type: entity
STIFF_Negative
The flag to define material data for STIFF. Applicable for config 101.
Type: Boolean
STIFF2
The elastic shear stiffness. Applicable for config 101.
Type: double
STIFF3
The elastic bending stiffness. Applicable for config 101.
Type: double
STIFF4
The elastic torsional stiffness. Applicable for config 101.
Type: double
stype
The secondary rigid body type flag.
Type: integer
surface
The surface set on which coupling nodes are located.
Type: entity
surface
The surface set on which coupling nodes are located.
Type: entity
THICK
The total thickness of both sheets. Applicable for config 101.
Type: double
TITLE
The rigid body merge title.
Type: string
Type
1 – FLEXION-TORSION
2 – GENERALIZED
3 – TRANSLATIONAL
4 – CYLINDRICAL
Type: integer
UPFN
The plastic initiation displacement in normal direction. Applicable for config 101.
Type: double
UPFS
The plastic initiation displacement in shear direction. Applicable for config 101.
Type: double
UPID
The upper sheet part ID.
Type: entity
UPRN
The plastic rupture displacement in normal direction. Applicable for config 101.
Type: double
UPRS
The plastic rupture displacement in shear direction. Applicable for config 101.
Type: double
weight_distribution_row_count
The number of rows for non-uniform distributing couplings. Applicable for config 302.
Type: unsigned integer
weighting_method_option
Option to turn on the weighting method selector. Applicable for config 302.
Type: Boolean
weighting_method_value
The option to modify the default weight distribution at coupling nodes.
0 – UNIFORM
1 – LINEAR
2 – QUADRATIC
3 – CUBIC
weights
The option to enter the weight values. Applicable for config 302.
Type: double
XIN
The fraction of failure displacement at maximum normal force.
Type: double
XIT
The fraction of failure displacement at maximum tangential force.
Type: double
XPID1
The extra part ID 1 for multi-sheet connection.
Type: entity
XPID2
The extra part ID 2 for multi-sheet connection.
Type: entity
XPID3
The extra part ID 3 for multi-sheet connection.
Type: entity
XPID4
The extra part ID 4 for multi-sheet connection.
Type: entity

The following data names are available for LS-DYNA engineering loads:

tolerance
The distance tolerance value within which the nodes on the deformable part will be constrained.
Type: double
dyna_boundary_set_option
The flag to switch between a Set and a Part.
Type: Boolean

Version History

2022

2022.1 - Added new data names ALPHA1, ALPHA1_FID, ALPHA2, ALPHA3, BETA1, BETA1_FID, BETA2, BETA3, DENS, GAMMA, iflag, INTP, LCDEXP, LCF, LCUPF, LCUPR, mainid, MODEL, MRN, MRS, mtype, NSID, numgrnodes, numnodes, numrbodies, optionalcard, PID1, PID2, PIDVB, R, RN, RN_FID, RS, RS_FID, secondarygrnodids, secondarynodeids, secondaryrbodyids, SROPT, STIFF, STIFF_FID, STIFF_MID, STIFF_Negative, STIFF2, STIFF3, STIFF4, stype, THICK, TITLE, UPFN, UPFS, UPRN, and UPRS.

2022.3 - Added new data names CIDA, CIDB, DLCIDAL, DLCIDBT, DLCIDG, DLCIDP, DLCIDPH, DLCIDPS, DLCIDR, DLCIDT, DLCIDX, DLCIDY, DLCIDZ, ESAL, ESBT, ESPH, ESPS, ESR, EST, ESX, ESY, ESZ, FFR, FFR_CURVE, FFR_CURVE_OPT, FFX, FFX_CURVE, FFX_CURVE_OPT, FFY, FFY_CURVE, FFY_CURVE_OPT, FFZ, FFZ_CURVE, FFZ_CURVE_OPT, FMAL, FMAL_CURVE, FMAL_CURVE_OPT, FMBT, FMBT_CURVE, FMBT_CURVE_OPT, FMPH, FMPH_CURVE, FMPH_CURVE_OPT, FMPS, FMPS_CURVE, FMPS_CURVE_OPT, FMT, FMT_CURVE, FMT_CURVE_OPT, JID, LCIDAL, LCIDBT, LCIDG, LCIDPH, LCIDPS, LCIDR, LCIDT, LCIDX, LCIDY, LCIDZ, NSABT, NSAPH, NSAPS, NSAT, NSDX, NSDY, NSDZ, PIDA, PIDB, PSABT, PSAPH, PSAPS, PSAT, PSDR, PSDX, PSDY, PSDZ, RAD1, RAD2, SAAL, and Type. Added new config value 102.

2023 - Added new config values 103, 104. Added new data names: D, DN, DNID, DT, EXPN, EXPT, FN, FN_Flag, FNMID, FT, NID1, NID2, LPID, PIDVB, UPID, XIN, XIT, XPID1, XPID2, XPID3, and XPID4.

2024 - Added new data names for LS-DYNA engineering loads tolerance and dyna_boundary_set_option.