*SetJointIC() - single joint
Sets the initial conditions of a joint.
Syntax
*SetJointIC(joint_name, [TRANS|ROT],
ic_disp,
ic_vel)
*SetJointIC(joint_name, ic_x_disp, ic_y_disp, ic_z_disp, ic_vel)
*Set(joint_name.use_local_dll, TRUE|FALSE)
*Set(joint.local_dll, "string")
Arguments
- joint_name
- The variable name of an existing joint.
- TRANS|ROT
- Indicates whether the initial condition values are translational or rotational. It is applicable to traditional joints.
- ic_disp
- The initial displacement of an existing joint.
- ic_vel
- The initial velocity of an existing joint (for high pair joints it is in the ICM reference frame).
- ic_x_disp
- The x initial displacement in the ICM reference frame for high-pair joint types, such as a point-to-curve joint.
- ic_y_disp
- The y initial displacement in the ICM reference frame for high-pair joint types, such as a point-to-curve joint.
- ic_z_disp
- The z initial displacement in the ICM reference frame for high-pair joint types, such as a point-to-curve joint.
- joint_name.use_local_dll
- Specifies if a user subroutine DLL is specific to the instance of one coupler entity.
- joint_name.local_dll
- The path and filename for the user subroutine DLL to be used with an instance of the user defined coupler.
Example
*SetJointIC(wheel_revjt, ROT, 5, 1)
Context
Comments
For traditional joints, initial conditions can only be applied to revolute joints, translational joints, and cylindrical joints. TRANS or ROT is required only for cylindrical joints. For all other joints, this argument may be left blank.
For high-pair joints, such as a point-to-curve joint, displacement and velocity initial conditions can be given where displacement is given in terms of x, y, z relative to the ICM marker. Velocity is also in terms of the ICM marker but can be applied only to a *PointToCurveJoint() and a *CurveToCurveJoint().