animation modify
Allows you to modify an existing model
Format:
animation modify |
|---|
animation_name = | a new animation |
analysis_name = | an existing analysis |
view_name = | an existing view |
number_of_cycles = | integer |
time_range = | time |
frame_range = | integer |
frame_number = | integer |
time = | time |
configuration = | display_frame |
increment_frame_by = | integer |
superimposed = | on_off |
base_marker = | an existing marker |
camera_ref_marker = | an existing marker |
point_trace_marker = | an existing marker |
icon_visibility = | on_off |
offset = | location |
colors = | an existing color |
Example:
animation modify & |
|---|
analysis_name = | Hood_1 & |
view_name = | View_1 & |
component = | Plot_1 & |
number_of_cycles = | 10 & |
animation_name = | Animation__1 & |
time = | 50 & |
configuration = | Model_input & |
point_trace_marker = | Marker_71 & |
icon_visibility = | On |
Description:
Parameter | Value type | Description |
|---|
animation_name | A New Animation | Specifies the name of a new animation |
analysis_name | An Existing Analysis | Specifies the name of an existing analysis |
view_name | An Existing View | Specifies the name of the view that you would like to view the animation from |
number_of_cycles | Integer | Specifies the number of complete cycles to animate |
time_range | Time | Specifies the analysis output Adams simulation output time steps at which to start and stop the animation (in that order). |
frame_range | Integer | Specifies the analysis frame number (output time step) at which to start and stop the animation (in that order). |
frame_number | Integer | Specifies the frame number (Adams simulation output time step) at which to configure a model during the single_frame_display command. |
time | Time | Specifies the time as a real number greater than or equal to zero |
configuration | Display_frame | Specifies what output frame, or output time step, of the simulation results is to be displayed for the single_frame_display command |
increment_frame_by | Integer | Specifies the number of frames to skip between each animation step |
superimposed | On_off | Parameter used with the animation command to specify whether or not to show each frame of the animation individually or superimposed on top of another |
base_marker | An Existing Marker | Specifies a marker whose position will be frozen in the view as the model gets animated |
camera_ref_marker | An Existing Marker | Identifies a marker which specifies the viewing direction as the model animates |
point_trace_marker | An Existing Marker | Specifies marker(s) whose position will be traced in the view as the model gets animated |
icon_visibility | On_off | Specifies whether or not to display icons during an animation |
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. |
Extended Definition:
1. You must enter the name of the model you wish to modify either by picking it from the screen or specifying the full name.
2. You may reverse this modification at a later time with an UNDO command.
3. When Adams View reads a request, graphics, and results files (.req, .gra, and .res, respectively) with the file analysis read command, it stores it in an analysis. By default, the name of the analysis is the file name, excluding the extension.
4. 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.
If the VIEW_NAME parameter is used, the desired view can be identified by picking in the window or entering the name from the keyboard.
5. This means, based on number_of_cycles parameter, the animation will continuously run through all the specified frames the specified number of times.
If entered, the NUMBER_OF_CYCLES parameter must be a positive integer.
This value will be remembered and will be the default the next time an animation is performed. This parameter is optional and if not entered, will default initially to 1 (until updated by the user).
6. If entered, time_range parameter must be two real numbers (separated by commas) where the second is greater than the first and the default values are initially 0.0,1000.0. If new values are entered, these values will be remembered and be the default next time the parameter is used. If a value greater than the simulation endint time is entered for the second value, the system will stop at the last frame.
These time values will be rounded to the nearest simulation output time step value.
This parameter is optional and mutually exclusive with the FRAME_RANGE parameter. If neither is entered, the previous values to TIME_RANGE will be used (0,0,1000.0, if they have not been changed by the user)
Special Note: Even if only one view_name is provided, the time range 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
7. If entered, this parameter must be two positive integers (separated by commas) where the second is greater than the first and the default values are initially 1,10000. If new values are entered, these values will be remembered and be the default next time the parameter is used.
If a value greater than the last frame number is entered for the second value, the system will stop at the last frame.
This parameter is optional and mutually exclusive of the TIME_RANGE parameter. If neither is entered, the previous values to FRAME_RANGE will be used (1,10000, if they have not been changed by the user)
Special Note: Even if only one view_name is provided, the frame range 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.
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
9. The legal values for this 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).
10. This allows the user to speed up the viewing of motions that take many frames to develop (that move slowly). If a negative value is entered, the animation will play in reverse.
If entered, the INCREMENT_FRAMES_BY parameter must have an absolute value less than the maximum number of frames in the analysis. This parameter is optional and if not entered, will default to 1.
11. The superimposed view is sometimes referred to as a fan diagram. Superimposing frames is useful to show the relationship of the models parts between frames but often obscures the view of the motion.
This is an optional parameter and if not entered then no superimposed frames will be drawn. The legal values of this parameter are ON and OFF. ON indicates that frames will be superimpose during the animation. OFF, the default, indicates that frames will not be superimpose during the animation.
12. 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 (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.
13. camera_ref_marker parameter is used to identify a marker which specifies the viewing direction as the model gets animated.
14. point_trace_marker parameter is particularly useful when a marker undergoes complicated motion, or has motion that is easily obscured by other model graphics. For example, the path of a chain link being whipped, or a car wheel center's 3D motion. In this case, selecting the BASE_MARKER to be on the wheel center would be appropriate.
15. Entering 'ON' will cause Adams View to display the icons during animation. This will cause slower animation times. For this reason, 'OFF' is the default value.
Cautions:
1. Typing the name is the only way to identify a stored view that is not displayed.
2. The model graphics need not be displayed to trace the path of a marker in a view. Up to 10 markers can be traced simultaneously.