Allows you to modify an existing model Format:
Example:
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
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 &
Adams/View Commands
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
animation modify &
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
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.
Parameter Value type Description
Adams/View Commands animation modify
16
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 (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.
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.
Adams/View Commands