Adams Basic Package > Adams View > View Command Language > file > file testdata read measures

file testdata read measures

Allows you to import test data as measures

Format:

 
file testdata read measures
model_name =
a new or existing model
analysis_name =
a new or existing analysis
use_file_column_labels =
boolean
units =
string
independent_column_index =
integer
file_name =
string

Example:

 
file testdata read measures &
model_name =
model_1 &
use_file_column_labels =
yes

Description:

 
Parameter
Value Type
Description
model_name
A New or Existing Model
Specifies an existing model
analysis_name
A New or Existing Analysis
Specifies an existing analysis
use_file_column_labels
Boolean
Specifies how to define the names of the measures
units
String
Allows you to specify the type of units to be used for this object.
independent_column_index
Integer
Specifies which column in the data file contains the x-axis data.
file_name
String
Specifies the name of the file that is to be read, written, or executed

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. You may identify an analysis by typing its name or by picking it from the screen.
An analysis may be picked from the screen if you have read an Adams Graphics file, and use the GRAPHIC_RESULTS command to display it. If the analysis is not visible on the screen, you must type the name. You may also find it convenient to type the name even if the analysis is displayed.
You may have explicitly named the analysis when you created it by reading one or more Adams output files. By default, the name of the analysis is the root name of the Adams output files. If you created the analysis by reading an Adams Graphics file, for instance, the analysis name is the name of the graphics file without the .gra extension.
You may get a list of analysis by typing a "?" in response to a parameter that requires an analysis name be entered.
You must separate multiple analysis names by commas.
If the analysis 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 analysis picks by commas.
See Also getting_started - for naming syntax and wildcards.
3. If there are textual column headers in the file, select yes. Adams uses the column header text as the names of each measure. Values are: yes and no.
4. Since this object can be used in a variety ov contexts, Adams View cannot determine what type of units it should have. By telling Adams View what the unit type for this object is Adams View can perform the proper conversions on the values you specify.
5. Enter the column number. Adams uses all other columns as the y-axis data. It is used as the independent data for the measure.
6. The proper extension 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.