file analysis read
Allows you to read a set of analysis files, which is a set of output files that Adams Solver generates during a simulation. The files include:
■Graphics
■Request
■Results
You can import multiple files if you associate and store the files with a model. Adams View reads and creates all analyses under the specified model. If you do not provide a model name, Adams View reads each analysis into its own model. For request files, when you specify multiple files, the Request IDs button only displays the requests from the first file listed. The list of IDs will, however, be applied to all files.
If you select to associate the files with a particular simulation, you can only import one set of output files generated from the same Adams Solver simulation. Adams View uses the time-date stamp placed at the beginning of each output file to determine if the files were generated by the same simulation run
.
Note: | If you choose to edit the time-date stamps, make sure that the output files came from similar simulations. Otherwise, result processing may lead to erroneous information. |
Format:
file analysis read |
|---|
file_name = | string |
model_name = | new or existing analysis |
analysis_name = | new or existing analysis |
length = | linear_units |
force = | force_units |
mass = | mass_units |
time = | time_units |
Example:
file analysis read& |
|---|
file_name = | “c:\analysis_files\my_analysis_1.gra” & |
model_name = | my_model & |
length = | mm & |
time = | second & |
force = | newton & |
mass = | kg |
Description:
Parameter | Value Type | Description |
|---|
file_name | String | Specifies the name of the file or files to be read. |
model_name | New Model | Enter the model name under which you want to store the analysis files in the modeling database. |
analysis_name | New or Existing Analysis | Specifies the name of the analysis in which to store output files. |
length(optional) | mm, cm, meter, km, inch, foot, mile. | Specifies the length units in the file, if different from the current default. |
force(optional) | newton, knewton, dyne, pound_force, kpound_force, kg_force, ounce_force, millinewton, centinewton, poundal. | Specifies the force units in the file, if different from the current default. |
mass(optional) | kg, gram, pound_mass, kpound_mass, slug, ounce_mass, and tonne. | Specifies the mass units in the file, if different from the current default. |
time(optional) | millisecond, second, minute, and hour. | Specifies the time units in the file, if different from the current default. |
Extended Definition:
1. The proper extension is the default, but you can override it by supplying a different extension. You can only read in multiple files if you associate them with a model.
It is not necessary to enclose the file name in quotes if it only contains alphanumeric 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 file name in quotes.
2. You can enter multiple files in the file_name parameter if you select to store them under a model.
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.
Adams View requires that 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).
4. If you do not specify the length parameter, Adams View reads or writes the file using your default modeling units.
If you want to read or write a file with units other than those you are currently using, you must specify this parameter. Specifying this parameter, however, does not change your default modeling units; it only overrides them during the file read or write operation.
If you want to change your default modeling units, use the defaults units command.