.. _method-list_parameter_study-import_points_file:

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


File containing list of variable values to evaluate in a list parameter study


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

   method-list_parameter_study-import_points_file-custom_annotated
   method-list_parameter_study-import_points_file-annotated
   method-list_parameter_study-import_points_file-freeform
   method-list_parameter_study-import_points_file-active_only


**Specification**

- *Alias:* None

- *Arguments:* STRING

- *Default:* no point import from a file


**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-list_parameter_study-import_points_file-custom_annotated.html
__ method-list_parameter_study-import_points_file-annotated.html
__ method-list_parameter_study-import_points_file-freeform.html
__ method-list_parameter_study-import_points_file-active_only.html



**Description**


The ``import_points_file`` specifies a file containing a list of variable
values at which to compute a model response.

*Default Behavior*

By default, methods do not import points from a file.

*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
      list_parameter_study
        import_points_file = 'dakota_pstudy.3.dat'