custom_annotated

Selects custom-annotated tabular file format for experiment data

Topics

file_formats

Specification

• Alias: None

• Arguments: None

• Default: annotated format

Child Keywords:

Required/Optional	Description of Group	Dakota Keyword	Dakota Keyword Description
Optional		header	Enable header row in custom-annotated tabular file
Optional		exp_id	Enable experiment ID column in custom-annotated tabular file

Description

A custom-annotated tabular file is a whitespace-separated text file containing experiment data, including configuration variables, observatiions, and/or observation errors, depending on context. For experiment import, custom-annotated allows user options for whether header row and exp_id column appear in the tabular file, thus bridging freeform and (fully) annotated.

Default Behavior

By default, Dakota imports tabular experiment data files in annotated format. The custom_annotated keyword, followed by options can be used to select other formats.

Usage Tips

• Prior to October 2011, calibration and surrogate data files were in free-form format. They now default to annotated format, though freeform remains an option.

• When importing tabular data, a warning will be generated if a specific number of data are expected, but extra is found and an error generated when there is insufficient data.

Examples

Import an experimental data file containing a header row, no leading exp_id column, and experiment data in a calibration study

responses
  ...
  scalar_data_file 'shock_experiment.dat'
    custom_annotated header

Example data file with two measured quantities, three experiments:

% velocity stress
 18.23  83.21
 34.14  93.24
 22.41  88.92