.. _method-import_points-import_points_file:

""""""""""""""""""
import_points_file
""""""""""""""""""


File containing list of variable and response values to import for analysis.


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

   method-import_points-import_points_file-custom_annotated
   method-import_points-import_points_file-annotated
   method-import_points-import_points_file-freeform
   method-import_points-import_points_file-active_only


**Specification**

- *Alias:* None

- *Arguments:* STRING

- *Default:* A filename must be provided


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

.. __: method-import_points-import_points_file-custom_annotated.html
__ method-import_points-import_points_file-annotated.html
__ method-import_points-import_points_file-freeform.html
__ method-import_points-import_points_file-active_only.html



**Description**


The ``import_points_file`` specifies a file containing a list of variable and
response values.

*Default Behavior*

This argument must be specified for ``import_points_method``.

*Usage Tips*

Dakota parses input files without regard to whitespace, but the
import_points_file must be in one of three formats:

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



**Examples**



.. code-block::

    method
      import_points
        import_points_file = 'all_samples.dat'