graphic_results single_frame_display
Allows you to display the model geometry based on Adams simulation results, one frame at a time. These frames correspond to "simulation output time steps".
Format:
graphic_results single_frame_display |
|---|
analysis_name = | an existing analysis |
view_name = | an existing view |
rame_number = | f integer |
time = | time |
configuration = | display_frame |
base_marker = | an existing marker |
camera_ref_marker = | an existing marker |
colors = | an existing color |
offset = | location |
contour_plots = | on |
Example:
graphic_results single_frame_display & |
|---|
analysis_name = | last_run & |
frame_number = | 10 & |
base_marker = | mar_3 & |
camera_ref_marker = | psmar & |
colors = | pink & |
offset = | 10 , 10 , 10 & |
contour_plots = | on |
Description:
Parameter | Value Type | Description |
|---|
analysis_name | An Existing Analysys | This parameter specifies the name of an analysis name. |
view_name | An Existing View | Specifies the view for the display |
frame_number | Integer | The FRAME_NUMBER parameter is used to specify the frame number (Adams simulation output time step) at which to configure a model during the single_frame_display command. |
Time | Time | The TIME parameter allows you to identify the frame number (Adams simulation output time step) at which to configure the model in the SINGLE_FRAME_DISPLAY command. |
Configuration | Display_Frame | 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. |
Base_marker | An Existing Marker | This parameter is used to specify a marker whose position will be frozen in the view as the model animates. |
Camera_ref_marker | An Existing Marker | This parameter is used to identify a marker which specifies the viewing direction as the model animates. |
Offset | Location | Specifies the offset of the axis line from the plot border. |
Colors | An Existing Color | Modifies the red, green, and blue components of existing colors. |
contour_plots | on/off |
Extended Definition:
1. Options are provided to control the single-frame-at-a-time display mode. The options effect what model configuration is to be displayed. They include, specifying the Adams output FRAME_NUMBER, TIME, or CONFIGURATION (CONFIGURATION options include: model_input, initial_conditions, equilibrium, forward, and backward). This command also allows the user to view the results of multiple models simultaneously. Each simulation result is read and associated to an analysis name.
This ANALYSIS_NAME can be viewed in any number of views at one time.
2. When Adams View reads a graphics file (.GRA), a request file (.REQ), or a results file (.RES) an analysis name is created. By default, the name of the analysis is the file name excluding the extension. Adams View requires that Adams simulations have unique names and the default name of an analysis may be overridden when reading the file(s) using the file_name parameter. When referring to an analysis name that already exists, quotes are not necessary. When processing any command that requires an analysis name, the system will default to the default analysis name. The default analysis name is set to the last analysis file read in (.GRA, .REQ, .RES, or all three). To change the default analysis name without reading in an analysis file use, the "defaults analysis" command.
3. Each view created has a name associated with it. The view_name parameter is used to identify a view for a particular operation. In most cases, view_name=all is also a valid entry. The all option indicates "all displayed views". There are eight standard views available when the Adams View is started. These views are: front, top, right, iso, bottom, left, and back. The first four of these standard views are displayed by default when Adams View is started. The user may create new views using the 'VIEW MANAGEMENT CREATE' command, and save/restore their attributes.
4. 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.
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. |
5. The frame with the closest time value to the time specified in the TIME 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.
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
• 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 parameters 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 first time dependent frame in the graphics file (assuming its mutually exclusive counterparts are not entered either).
7. The base_marker parameter is used to specify a marker whose position will be frozen in the view as the model animates. This is particularly useful when a relatively small object undergoes both small configuration changes as well as large overall gross motion. For example, the flight path of a jet is very large over time relative to the motion of the control surfaces on the jet. In this case selecting the BASE_MARKER to be on the jet would be appropriate. This parameter can be used with the CAMERA_REF_MARKER to create a different effect on the viewing direction. When the CAMERA_REF_MARKER and the BASE_MARKER are specified together, the viewing direction is "from" the CAMERA_REF_MARKER position "to" the BASE_MARKER position. In addition the "up" direction of the view is computed based on the direction of the CAMERA_REF_MARKER "y" axis (i.e. the y axis is projected into a direction perpendicular to the viewing direction defined by the two markers). This viewing direction is recomputed between each frame of the animation. This feature allows the effect of watching an object come from a distance, pass by, and proceed into the distance.
8. You may identify a marker by typing its name or by picking it from the screen.If the marker 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 by reading an Adams data set or graphics file, the marker name is the letters MAR followed by the Adams data set marker ID number. For example, the name of Adams MARKER/101 is MAR101. If you created the marker during preprocessing, you will have given it a name at that time. If a marker is available by default, you may identify it by entering only its name. If it is not, you must enter its full name. 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. You must separate multiple marker names by commas. If the marker is visible in one of your views, you may identify it by picking on it. You need not separate multiple marker picks by commas.
9. The camera_ref_marker parameter connects the viewing camera to the "z" axis of a marker. The animation is then viewed from the moving location of that marker in the "z" direction. This is particularly useful when a "driver’s eye" or "pilot’s eye" viewing perspective is desired. This parameter can be used with the BASE_MARKER to create a different effect on the viewing direction. When the CAMERA_REF_MARKER and the BASE_MARKER are specified together, the viewing direction is "from" the CAMERA_REF_MARKER position "to" the BASE_MARKER position. In addition the "up" direction of the view is computed based on the direction of the CAMERA_REF_MARKER "y" axis (that is, the y axis is projected into a direction perpendicular to the viewing direction defined by the two markers). This viewing direction is recomputed between each frame of the animation. This feature allows the effect of watching an object come from a distance, pass by, and proceed into the distance.
Cautions:
■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. f the VIEW_NAME parameter is used, the desired view can be identified by picking in the window or entering the name from the keyboard. Typing the name is the only way to identify a stored view that is not displayed.
2. ". If you type a "?", Adams View will list the markers available by default.