.. _method-sampling-sample_type-low_discrepancy-rank_1_lattice-generating_vector-file:

""""
file
""""


Specify a generating vector read from file



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



**Specification**

- *Alias:* None

- *Arguments:* STRING


**Description**


The generating vector will be read from an external file. 
The file format is

.. code-block::

      1
      12543
      9523
      15043
      2937
      5231
      ... # number of rows = maximum number of dimensions

The number of entries determines the maximum dimension of the lattice rule. 
When this keyword is specified, the user must also specify the ``log2`` of the maximum number 
of points in the lattice using the keyword :dakkw:`method-sampling-sample_type-low_discrepancy-rank_1_lattice-m_max`.




**Examples**



.. code-block::

    environment
      tabular_data
        tabular_data_file = 'samples.dat'
        freeform

    method
      sampling
        samples 16
        sample_type
          low_discrepancy
            rank_1_lattice
              generating_vector file 'z.txt'

    variables
      uniform_uncertain = 2
        lower_bounds 0.0 0.0
        upper_bounds 1.0 1.0

    interface
      analysis_drivers = 'genz'
      analysis_components = 'cp1'
      direct

    responses
      response_functions = 1
      no_gradients
      no_hessians



