1Blurb::
2Selects annotated tabular file format for experiment data
3
4Description::
5
6An annotated tabular file is a whitespace-separated text file with one
7leading header row of comments/column labels.  For experiment data
8files, each subsequent row contains an experiment ID, followed by data
9for configuration variables, observations, and/or observation errors,
10depending on context.
11
12<b> Default Behavior </b>
13
14By default, Dakota imports tabular experiment data files in annotated
15format.  The \c annotated keyword can be used to explicitly specify
16this.
17
18<b> Usage Tips </b>
19
20\li Prior to October 2011, calibration and surrogate data files were
21in free-form format. They now default to \c annotated format, though \c
22freeform remains an option.
23
24\li When importing tabular data, a warning will be generated if a
25specific number of data are expected, but extra is found and an error
26generated when there is insufficient data.
27
28Topics::	file_formats
29Examples::
30
31Import an annotated experimental data file containing a header row, leading
32exp_id column, and experiment data in a calibration study
33
34\verbatim
35responses
36  ...
37  scalar_data_file 'shock_experiment.dat'
38    annotated
39\endverbatim
40
41Example data file with two measured quantities, three experiments:
42\verbatim
43%exp_id		velocity	stress
441		18.23		83.21
452		34.14		93.24
463		22.41		88.92
47\endverbatim
48
49
50Theory::
51Faq::
52See_Also::
53