Dakota Reference Manual: custom_annotated

| Dakota Reference Manual Version 6.15 Explore and Predict with Confidence

- Main Page
- Related Pages

All Pages
custom_annotated

Selects custom-annotated tabular file format for experiment data

## Topics

This keyword is related to the topics:

- file_formats

## Specification

Alias: none

Argument(s): 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