Reference: Array

Command ElementModifies an existing Reference_Array element.

Format

<Reference_Array
       id                  = "integer"       
       type                = "IC | RESTART | PRINT"
       num_element         = "integer" > 
!
! The data
!
real real real real real real
real real real real real real
</Reference_Array>

Attributes

id
Element identification number (integer>0). This number is unique among all the Reference_Array elements.
type
The type of Reference_Array element. Choose from IC, RESTART or PRINT. 2
num_element
The number of elements being specified when the Reference_Array is of type IC, RESTART or PRINT.

Example

  • The following example modifies the data for an IC array.
    <Reference_Array
         id           = "102"
         type         = "IC"
         num_element  = "10"> 
         1.0000000E+00   2.0000000E+00 
         3.0000000E+00   4.0000000E+00 
         5.0000000E+00   6.0000000E+00
         7.0000000E+00   8.0000000E+00
         9.0000000E+00   1.0000000E+01
    </Reference_Array>
  • The following example tells MotionSolve to restart the integrator at time t = 15, 24s.
    <Reference_Array
         id            = "7957300"
         type          = "RESTART"
         num_element   = "2">
         1.5000000E+01    2.4000000E+01
    </Reference_Array>
  • The following example tells MotionSolve to write output signals at the specific times defined in the data section.
    <Reference_Array
         id            = "7947300"
         type          = "PRINT"
         num_element   = "8">
         1.4000000E+01    1.4050000E+01    1.4100000E+01    1.4150000E+01    1.4200000E+01
         2.3888889E+01    2.3944444E+01    2.4000000E+01
    </Reference_Array>

Comments

  1. The ID of the Reference_Array command element must match the ID of one of the Reference_Array elements that already exists in the model.
  2. The Reference_Array command element can be of the following types:
    • IC: MotionSolve allows you to change the data defined in a Reference_Array of type IC only. The num_element for the IC array cannot be changed and must match what is defined in the Model section.
    • RESTART: This is a special type of Reference_Array that tells MotionSolve to restart the integrator at the times defined in the data section. When the integrator is restarted, all time integration history is discarded. The number of time steps defined in the data section must match what is defined in the num_element attribute. Note: This array can only be defined in the Command section.
    • PRINT: This is a special type of Reference_Array that tells MotionSolve to write the output signals at the times defined in the data section. Using this array, you can choose to have the output signals printed out at time steps that are not equally spaced. The number of time steps defined in the data section must match what is defined in the num_element attribute. Note: This array can only be defined in the Command section