*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.; Data type: varname
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.; Data type: real
ic_vel: The initial velocity of an existing joint (for high pair joints it is in the ICM reference frame).; Data type: real
ic_x_disp: The x initial displacement in the ICM reference frame for high-pair joint types, such as a point-to-curve joint.; Data type: real
ic_y_disp: The y initial displacement in the ICM reference frame for high-pair joint types, such as a point-to-curve joint.; Data type: real
ic_z_disp: The z initial displacement in the ICM reference frame for high-pair joint types, such as a point-to-curve joint.; Data type: real
joint_name.use_local_dll: Specifies if a user subroutine DLL is specific to the instance of one coupler entity.; Data type: boolean
joint_name.local_dll: The path and filename for the user subroutine DLL to be used with an instance of the user defined coupler.; Data type: string

Example

*SetJointIC(wheel_revjt, ROT, 5, 1)

Context

*BeginMdl()

*DefineAnalysis()

*DefineSystem()

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().