list_info measure
List the distance between a marker and ground, or between two markers. The distance can be listed relative to ground or a third marker.
The magnitude, X component, Y component, and the Z component are listed.
If the J_MARKER_NAME parameter is specified, the distance will be between the I and the J marker, otherwise the distance will be from the I marker to ground.
If the R_MARKER_NAME parameter is specified the data will be relative to it, otherwise the data will be relative to ground.
Because the location of the markers is time dependent, you can specify the time, frame_number, or configuration of the model that the measurements are to be taken.
The information can be sent to the information window, a file, or both.
Format:
list_info measure |
|---|
i_marker_name = | existing marker |
j_marker_name = | existing marker |
r_marker_name = | existing marker |
model_name = | existing model |
analysis_name = | existing analysis |
Configuration = | display_frame |
time = | real |
frame_number = | integer |
brief = | on/off |
write_to_terminal = | on/off |
file_name = | string |
Example:
list_info measure & |
|---|
i_marker_name = | MARKER_5 & |
j_marker_name = | MARKER_6 & |
model_name = | model_1 & |
brief = | off |
This will measure the distance between MARKER_5 and MARKER_6 relative to the ground. The following information will be displayed in the information window.
Measurements for the model:.model_1
The distance between MARKER_5 and MARKER_6 is:
MAG = 492.4428900898 mm
X = -200.0 mm
Y = 450.0 mm
Z = 0.0 mm
The angular offsets between MARKER_5 and MARKER_6 are:
ANG1 = 0.0 deg
ANG2 = 0.0 deg
ANG3 = 0.0 deg
Description:
Parameter | Value Type | Description |
|---|
i_marker_name | Existing marker | To specify the first of a pair of markers that will be involved in the distance calculation. |
j_marker_name | Existing marker | To specify the second of a pair of markers that will be involved in the distance calculation. |
r_marker_name | Existing marker | To specify a marker the distance calculation is to be relative to. |
model_name | Existing model | Specifies an existing model. |
analysis_name | Existing analysis name | Specifies an existing analysis. |
configuration | MODEL_INPUT/EQUILIBRIUM/ FORWARD/ BACKWARD | This parameter is used to specify what output frame, or output time step, of the simulation results is to be displayed for the single_frame_display command. |
Time | Real | The TIME parameter allows you to identify which frame number (ADAMS simulation output time step) at which to configure the model in the SINGLE_FRAME_DISPLAY command. |
frame_number | integer | To specify the frame number (ADAMS simulation output time step) at which to configure a model during the single_frame_display command. |
brief | On/off | Specifies whether to use the brief form (default) or an extended form of the requested information to be displayed. |
write_to_terminal | On/off | Specify if the information requested is to be sent to the informational window or not. |
file_name | String | Specify that the information requested is to be sent to a file with the name specified with the parameter. |
Extended Definition:
1. The I_MARKER_NAME parameter is used with the LIST_INFO MEASURE command to list the distance between two markers. The I_MARKER_NAME is the marker that the measurement is from.
The I_MARKER_NAME parameter is a required parameter and a legal marker name must be entered.
It Specifies an existing marker.
2. The J_MARKER_NAME parameter is used with the LIST_INFO MEASURE command to list the distance between two markers. The J_MARKER_NAME is the marker that the measurement is "to".
The J_MARKER_NAME parameter is a required parameter and a legal marker name must be entered.
It specifies an existing marker.
3. The R_MARKER_NAME parameter is used with the LIST_INFO MEASURE command to list the distance between two markers. This means that the output from the measurement calculations will be in a coordinate system based on the definition (orientation) of the R_MARKER_NAME.
The R_MARKER_NAME parameter is an optional parameter and if not entered the measurement will be relative to the global (ground) coordinate system. If the R_MARKER_NAME parameter is entered a legal marker name must be entered.
It specifies an existing marker.
4. You may identify a marker/model by typing its name or by picking it from the screen.
If the marker/model is not visible on the screen, you must type the name. You may also find it convenient to type the name even if the marker is displayed.
If you created the marker/model by reading an ADAMS data set or graphics file, the marker name is the letters MAR/ANA/MODEL followed by the ADAMS data set marker ID number. The name of ADAMS MARKER/101 is MAR101, for example. If you created the marker/model during preprocessing, you gave it a name at that time.
If a marker/model is available by default, you may identify it by entering its name only. If it is not, you must enter its full name.
You must separate multiple marker/model names by commas.
If the marker/model is visible in one of your views, you may identify it by picking on it.
You need not separate multiple marker picks by commas.
5. An analysis may be picked from the screen if you have read an ADAMS Graphics file, and use the GRAPHIC_RESULTS command to display it. If the analysis is not visible on the screen, you must type the name. You may also find it convenient to type the name even if the analysis is displayed.
You may have explicitly named the analysis when you created it by reading one or more ADAMS output files. By default, the name of the analysis is the root name of the ADAMS output files. If you created the analysis by reading an ADAMS Graphics file, for instance, the analysis name is the name of the graphics file without the '.gra' extension.
You may get a list of analysis by typing a "?" in response to a parameter that requires an analysis name be entered.
You must separate multiple analysis names by commas.
If the analysis is visible in one of your views, you may identify it by picking on any of the graphics associated with it.
You need not separate multiple analysis picks by commas.
6. The legal values for the configuration parameter are:
■MODEL_INPUT, the configuration as input to ADAMS before analysis,
■INITIAL_CONDITIONS, the configuration after initial conditions are met,
■EQUILIBRIUM, the configuration after an equilibrium analysis,
■FORWARD, one frame forward from the current one displayed, and
■BACKWARD, one frame backward from the current one displayed.
Therefore, this parameter is not used to specify a particular time or frame_number. In fact, this parameter is mutually exclusive with the FRAME_NUMBER and TIME parameters. These two parameter are used to specify the time dependent frames of the simulation output.
The CONFIGURATION parameter is optional and if not entered the system will display the 1st time dependent frame in the graphics file (assuming it's mutually exclusive counterparts are not entered either).
7. The frame with the closest time value to the time specified in this parameter will be selected. Adams View will display the last frame if the time entered is greater than the time for the last frame in the simulation.
This parameter is optional and mutually exclusive with the CONFIGURATION and FRAME_NUMBER parameters. If none of the three are entered, the first frame will be displayed.
Special Note: Even if only one view_name is provided, the frame number will be applied to the specified view and any other views that contain the same model (the model indicated by analysis_name parameter). If only analysis_name is provided (view_name parameter is omitted), any views that contain the model indicated by analysis_name will be affected.
8. If entered the frame_number must be a positive integer corresponding to the desired frame (output time step) and the default value is initially 1. If a new value is entered, this value will be remembered and be the default next time the command is used. If a value greater than the last frame number is entered, the system will display the last frame.
This parameter is optional and mutually exclusive with the CONFIGURATION and TIME parameters. If none of the three are entered, the first frame will be displayed.
Cautions:
1. Even if only one view_name is provided, the frame number will be applied to the specified view and any other views that contain the same model (the model indicated by analysis_name parameter). If only analysis_name is provided (view_name parameter is omitted), any views that contain the model indicated by analysis_name will be affected.
Tips:
1. To identify a marker under a different part, for instance, you may need to enter the model and part names as well. For example, you may specify marker 'pivot' from model 'links', part 'lower_arm' by entering ".links.lower_arm.pivot". If you type a "?", Adams View will list the markers available by default.