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