## Map definition

MAP_DEFINITION {
@MAP_NAME {MapName} {
@OBJECT_NAME {ObjectName}
@MAP_TYPE {MapType}
@CHANNEL_NUMBER {ChannelNumber}
@FRAME_NAME {FrameName}
@MAP_FRAME_NAME {MapFrameName}
@MAP_FORMAT_TYPE {MpfType}
@ROTATION_REPRESENTATION {RotationRep}
@START_TIME {ti}
@END_TIME {tf}
}
}

### Notes

1. Maps allow the evaluation of various scalar quantities relating to specific elements of the model. Typically, these various quantities are evaluated after the entire simulation is completed and the results are plotted to illustrate the simulation. Plots of the map outputs will be generated, if requested by the plotting control parameters, see section~\ref{PltCtrl}. The plots associated with a map are three-dimensional graphs. For spatial maps, the x and y coordinates of points along an object are plotted along the x-axis and y-axis, respectively and the quantity evaluated by the map is plotted along the z-axis. For temporal maps, time is plotted along the x-axis, location along an object is plotted along the y-axis and the quantity evaluated by the map is plotted along the z-axis. Maps are processed during the post-processing phase of the analysis.
2. Maps will be processed during the post processing phase of the analysis.
3. The quantities to be evaluated by the map are defined by four input parameters:
• The ObjectName indicates the object to be sensed.
• The MapType and ChannelNumber determine the specific scalar the quantity to be evaluated.
• The MpfType determines the format of the map.
• The FrameName specifies the frame in which the quantity is measured.
4. Maps can be defined for objects ObjectName of the following types: beams, lifting lines
5. The MapType and ChannelNumber determine the nature of the scalar quantity to be evaluated. Refer to the specific object to find the list of supported MapType and associated ChannelNumber.
6. Maps can be presented in two formats, depending on the value of the parameter MpfType, which can take one of the following two values.
1. If MpfType = SPATIAL, a spatial map will be drawn: the x and y coordinates of points along an object, measured in the map frame, MapFrameName, are plotted along the x-axis and y-axis, respectively, and the quantity evaluated by the map is plotted along the z-axis.
2. If MpfType = TEMPORAL, a temporal map will be drawn: time is plotted along the x-axis, location along an object is plotted along the y-axis and the quantity evaluated by the map is plotted along the z-axis.
7. The FrameName specifies the frame in which the quantities are measured. Refer to the specific object to find the list of supported FrameName. The following options can be specified.
• INERTIAL: the quantities are measured in the inertial frame.
• LOCAL: the quantities are measured in a local frame of reference. Note that this option is not valid for all MapType.
• FrameName: the quantities will be measured in a previously defined frame FrameName that can be either a fixed frame, or a moving frame.
8. If the output of the map involves rotations at a node, the parameter RotationRep can be used to select a specific way to represent rotations. The following options are available (Default option: RotationRep = CRV).
1. If RotationRep = CRV, rotations are represented with the Wiener-Milenkovic parameters.
2. If RotationRep = EULER_ANGLES_313, rotations are represented with Euler angles using the 3-1-3 sequence.
3. If RotationRep = EULER_ANGLES_323, rotations are represented with Euler angles using the 3-2-3 sequence.
4. If RotationRep = EULER_ANGLES_321, rotations are represented with Euler angles using the 3-2-1 sequence.
5. If RotationRep = EULER_ANGLES_312, rotations are represented with Euler angles using the 3-1-2 sequence.
9. It is possible to attach comments to the definition of the object; these comments have no effect on its definition.