.. _responses-calibration_terms-calibration_data_file-custom_annotated:

""""""""""""""""
custom_annotated
""""""""""""""""


Selects custom-annotated tabular file format for experiment data



**Topics**


file_formats


.. toctree::
   :hidden:
   :maxdepth: 1

   responses-calibration_terms-calibration_data_file-custom_annotated-header
   responses-calibration_terms-calibration_data_file-custom_annotated-exp_id


**Specification**

- *Alias:* None

- *Arguments:* None

- *Default:* annotated format


**Child Keywords:**

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

.. __: responses-calibration_terms-calibration_data_file-custom_annotated-header.html
__ responses-calibration_terms-calibration_data_file-custom_annotated-exp_id.html



**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


.. code-block::

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


Example data file with two measured quantities, three experiments:

.. code-block::

    % velocity stress
     18.23  83.21
     34.14  93.24
     22.41  88.92