file request read
Allows you to read a request file into Adams View so the information contained may be plotted, manipulated or viewed. When specifying the name of the request file to be read, the extension .REQ will be appended by default. This may be overridden by specifying a different extension.
You can import multiple files if you associate and store the files with a model. Adams View reads and creates all analysis files under the specified model. If you do not provide a model name, Adams View reads each analysis file into its own model.
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.
When Adams View reads a request file, it creates a new analysis. Each block of data in the request file that corresponds to a request statement in the Adams View input data is stored as result set in the analysis. The default name of the analysis will be the name of the request file, excluding the extension.
You can overwrite the default analysis name using the file_name parameter. The name of each result set will be req with the request statement ID appended to it. For example, request/1508 would produce a result set name of req1508.
Format:
file request read |
|---|
file_name = | string |
model_name = | new or existing model |
analysis_name = | new or existing analysis |
length = | linear_units |
force = | force_units |
mass = | mass_units |
time = | time_units |
request_ids = | integer |
disk_based_results = | boolean |
Example:
file request read & |
|---|
file_name = | "c:\\my documents\last_run.req" & |
model_name = | model_1 & |
disk_based_results = | yes & |
request_ids = | 5 & |
time_step_skip = | 1 & |
length = | meter & |
mass = | kg & |
time = | millisecond & |
force = | newton |
Description:
Parameter | Value Type | Description |
|---|
file_name(required) | String | Specifies the name of the file that is to be read. |
model_name(optional) | New or Existing Model | Specifies a new or an existing model. |
analysis_name(optional) | 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 than 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. |
disk_based_results (optional) | Yes/No | Specifies whether or not to store data on disk. Enter either yes or no. |
request_ids(optional) | Integer | Specifies a list of integers corresponding to the Adams IDs of the requests you want read from the file. If blank, then Adams reads all requests from the file. |
time_step_skip (optional) | Integer | Specifies whether or not to skip time steps by specifying a pattern of time steps to skip. |
Extended Definition:
1. For the filename parameter, The .req extension is the default, but you can override it by supplying a different extension.
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 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 find it convenient to type the name even if the model is visible). You must separate multiple model names with commas.
If the model is visible in one of your views, you can identify it by picking on any of the graphics associated with it. It is not necessary to separate multiple model picks with commas.
3. When Adams View reads a request, graphics, and results file (.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”,”mass”,“time” or “force” 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.
5. If you specify yes for the “disk_based_results” parameter, only the header information from the file is made memory resident, the bulk of the data remains on disk. This can significantly slow down operations for small files where leaving on disk merely adds overhead, but for very large files, it can have the opposite effect and improve performance due to the reduced memory footprint.
6. If you have a large request file with unnecessary fine time resolution, specifying a time_step_skip can significantly reduce the amount of memory used to store the data.
For example, if you specify time_step_skip = 1, the pattern starts at 1, skips one, takes step 3, and so on: 1,3,5,7,... A value of 2 would result in 1,4,7,10,13,...