Dakota Reference Manual: freeform

| Dakota Reference Manual Version 6.15 Explore and Predict with Confidence

- Main Page
- Related Pages

All Pages
freeform

Selects freeform file format

## Topics

This keyword is related to the topics:

- file_formats

## Specification

Alias: none

Argument(s): none

Default: annotated format

## Description

A freeform tabular file is whitespace-separated text file with no leading header row and no leading columns. Most commonly, each row contains data for variables, or variables followed by responses, though the format is used for other tabular exports/imports as well.

Default Behavior

The `annotated` format is the default for tabular export/import. To change this behavior, specify `freeform` in the relevant export/import context.

Usage Tips

- Prior to October 2011, calibration and surrogate data files were 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.

- In `freeform`, the num_rows x num_cols total data entries may be separated with any whitespace including spaces, tabs, and newlines. In this format, vectors may therefore appear as a single row or single column (or mixture; entries will populate the vector in order).

- Some TPLs like SCOLIB and JEGA manage their own file I/O and only support the `freeform` option.

## Examples

Export a freeform tabular file containing only data for variables and responses. Input file fragment:

    environment
      tabular_data
        tabular_data_file = 'dakota_summary.dat'
        freeform

Resulting tabular file:

                0.9            1.1         0.0002           0.26           0.76
            0.90009            1.1 0.0001996404857   0.2601620081       0.759955
            0.89991            1.1 0.0002003604863   0.2598380081       0.760045
    ...