Motion: Marked Based

Command ElementModifies a marker motion element.

Format


<Motion_Marker
       id                  = "integer"       
       i_marker_id         = "integer"       
       j_marker_id         = "integer"       
       direction           = { "X" | "Y" | "Z" | "B1" | "B2" | "B3" }  
  {           
       val_type            = "D"
     | 
       val_type            = "V"
       ic_disp             = "real"     
     | 
       val_type            = "A"
       ic_disp             = "real"       
       ic_vel              = "real"  
  }      
  {       
       type                = "EXPRESSION"
       expr                = "motionsolve_expression" >
     | 
       type                = "USERSUB" 
       usrsub_dll_name     = "valid_path_name"
       usrsub_param_string = "USER( [[par_1[,...][,par_n]])" 
       usrsub_fnc_name     = "valid_fnc_name"
  }
/>

Attributes

id
Element identification number (integer>0). This number is unique among all Motion_Marker elements.
type
Select from "EXPRESSION" and "USERSUB". Specifies how the motion expression is defined. The "EXPRESSION" option specifies that the motion value is a MotionSolve expression that can be evaluated at run-time. The "USERSUB" option indicates that the value of the motion is specified in a user defined subroutine. The parameters usrsub_param_string, usrsub_dll_name and usrsub_fnc_name are used to provide more information about the user defined subroutine.
val_type
Modifies whether the motion applies a displacement input (D), a velocity input (V), or an acceleration input (A). You must select one option from "D", "V" or "A".
expr
Modifies the expression that defines the motion value. Use this parameter only when type = "EXPRESSION". Any valid run-time MotionSolve expression can be provided as input.
usrsub_param_string
Modifies the list of parameters that are passed from the data file to the user defined subroutine. Use this keyword only when type = "USERSUB" is selected.
usrsub_dll_name
Modifies the path and name of the DLL or shared library containing the user subroutine. MotionSolve uses this information to load the user subroutine in the DLL at run time.
usrsub_fnc_name
Modifies an alternative name for the user subroutine MOTSUB.
i_marker_id
Modifies the Reference_Marker ID at which the motion input is applied.
j_marker_id
Modifies the Reference_Marker ID from which the motion input is applied.
direction
Modifies the direction of the input. Select one from "X", "Y", "Z", "B1", "B2", and "B3".
"X", "Y", and "Z" specify the direction for the translational motion.
"B1", "B2", "B3" specify the direction for the rotational motion.
ic_disp
Modifies the displacement initial condition that is required when val_type = "V" or val_type = "A".
ic_vel
Modifies the velocity initial condition that is required when val_type = "A".

Example

<Motion_Marker
     id                  = "301001"
     type                = "EXPRESSION"
     val_type            = "D"
     expr                = "0.1*SIN(3*TIME)"
     i_marker_id         = "30105071"
     j_marker_id         = "30101070"
     direction           = "Y"
  />
  <Motion_Marker
     id                  = "301001"
     type                = "USERSUB"
     val_type            = "D"
     usrsub_param_string = "USER(5,2)"
     usrsub_dll_name     = "NULL"
     i_marker_id         = "30105071"
     j_marker_id         = "30101070"
     direction           = "Y"
/>