.. _model-surrogate-global-import_challenge_points_file:

""""""""""""""""""""""""""""
import_challenge_points_file
""""""""""""""""""""""""""""


Datafile of points to assess surrogate quality


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

   model-surrogate-global-import_challenge_points_file-custom_annotated
   model-surrogate-global-import_challenge_points_file-annotated
   model-surrogate-global-import_challenge_points_file-freeform
   model-surrogate-global-import_challenge_points_file-active_only


**Specification**

- *Alias:* challenge_points_file 

- *Arguments:* STRING

- *Default:* no user challenge data


**Child Keywords:**

+-------------------------+--------------------+----------------------+---------------------------------------------+
| Required/Optional       | Description of     | Dakota Keyword       | Dakota Keyword Description                  |
|                         | Group              |                      |                                             |
+=========================+====================+======================+=============================================+
| Optional (Choose One)   | Tabular Format     | `custom_annotated`__ | Selects custom-annotated tabular file       |
|                         |                    |                      | format                                      |
|                         |                    +----------------------+---------------------------------------------+
|                         |                    | `annotated`__        | Selects annotated tabular file format       |
|                         |                    +----------------------+---------------------------------------------+
|                         |                    | `freeform`__         | Selects freeform file format                |
+-------------------------+--------------------+----------------------+---------------------------------------------+
| Optional                                     | `active_only`__      | Import only active variables from tabular   |
|                                              |                      | data file                                   |
+----------------------------------------------+----------------------+---------------------------------------------+

.. __: model-surrogate-global-import_challenge_points_file-custom_annotated.html
__ model-surrogate-global-import_challenge_points_file-annotated.html
__ model-surrogate-global-import_challenge_points_file-freeform.html
__ model-surrogate-global-import_challenge_points_file-active_only.html



**Description**


Specifies a data file containing variable and response (truth) values,
in one of three formats:

- ``annotated`` (default)
- ``custom_annotated``
- ``freeform``

The surrogate is evaluated at the points in the file, and the
surrogate (approximate) responses are compared against the truth
results from the file.  All metrics specified with
:dakkw:`model-surrogate-global-metrics` will be computed for the challenge
data.