file graphics read

Allows you to read a graphics file into Adams View, so the information contained may be animated, manipulated or viewed. When specifying the name of the graphics file to be read, the extension .GRA will be appended by default. This may be overridden by specifying a different extension.

Format:

 
file graphics read
model_name =
an existing model
analysis_name =
an existing analysis
file_name =
string
length =
linear_units
mass =
mass_units
time =
time_units
force =
force_units

Example:

 
file graphics read &
file_name =
"c:\model_1.gra" &
analysis_name =
last_run &
disk_based_results =
yes

Description:

 
Parameter
Value Type
Description
model_name
An Existing Model
Specifies an existing model
analysis_name
An Existing Analysis
Specifies the name of the analysis to store the Adams output in.
file_name
String
Specifies the name of the file that is to be read, written, or executed.
length
Linear_units
Specifies the length units in the file, if different from the current default.
mass
Mass_units
Specifies the mass units in the file, if different from the current default.
time
Time_units
Specifies the time units in the file, if different from the current default.
force
Force_units
Specifies the force units in the file, if different from the current default.

Extended Definition:

1. You may identify a model by typing its name or by picking it from the screen.
If the 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 model is displayed.
You must separate multiple model names by commas.
If the model 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 model picks by commas.
2. When Adams View reads a graphics file (.GRA), a request file (.REQ), a results file (.RES), or all three with the FILE ANALYSIS READ, it stores them in an analysis. By default, the name of the analysis is the file name excluding the extension.
Adams View requires that Adams simulations have unique names, therefore, if an analysis already exists with the same name as your files, use this parameter to assign a unique name at the time of reading the file(s).
3. The proper extension for the file is the default but can be overridden by simply supplying a different extension.
You do not need to enclose the file name in quotes if it only contains alpha-numeric characters and starts with a letter. If you want to include other characters, such as a '.' for an extension or '/' or '[]' for directory paths, you must enclose the name in quotes.
4. If you do not use the length/mass/time parameter, Adams View will read or write the file using your default modeling units. You only need to enter this parameter when you wish to read or write a file with different units than those you are currently using.
Specifying this parameter does not change your default modeling units, it only overrides them during the file read or write operation. Use the DEFAULT UNITS command if you wish to change your default modeling units.