Command Element

Description

Modifies 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"

/>