file results read
Allows you to read a results file into Adams View so the information contained may be plotted, manipulated or viewed. When specifying the name of the results file to be read the extension RES will be appended by default. This may be overridden by specifying a different extension.
Format:
file results 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 |
Skip_time_interval = | integer |
Skip_contact_interval = | integer |
Example:
file results read & |
|---|
file_name = | "c:\model_1.res" & |
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. |
Skip_time_interval | Integer | Specifies whether or not to skip time steps by specifying a pattern of time steps to skip in the result file. This should be greater than or equal to 0. |
Skip_contact_interval | Integer | Specifies whether or not to skip contact steps by specifying a pattern of time steps to skip in the result file. This should be greater than or equal to 0. |
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.
5. If you have a large result file with unnecessary fine time resolution, specifying a skip_time_interval and skip_contact_interval can significantly reduce the amount of memory used to store the data as well as reduce the reading time.
If the skip_time_interval and skip_contact_interval are not provided or if their values are both 1 then the entire result file is read as usual. If the skip_time_interval is for example 3, and the skip_contact_interval is 4 for a result file with the name test.res, then every 3rd step (not including initialCondition, input and contact step) and every fourth contact step is included in the new results file with the name test_3_4.res. This file after shrinking is read into Adams View instead of the original file. This file is stored in the same location as the original result file.