.. _gen_conus1_domain:

Inputs for baseline CONUS1 ParFlow Simulations
^^^^^^^^^^^^^^^^^^

The ParFlow CONUS1 model is the first generation national ParFlow model. You can learn more about the domain and the model  on the `HydroFrame Website <https://hydroframe.org/parflow-conus1/>`_.  

For datasets that are 3 dimensional, the ParFlow CONUS1 model consists of 5 layers with a total depth of about 102 m.  The layers have variable thicknesses of 100, 1, 0.6, 0.3, and 0.1 m from bottom to top. Note that  indexing layers is also done from bottom to top, so the layer associated with Python index 0 is the bottom (deepest)  layer and the layer associated with Python index 4 is the top layer closest to the surface.  

This dataset contains all of the input  fields for the model as well as additional pre and post processing files that can be useful for data analysis. If you are  interested in building a ParFlow model off of this national template the  `SubsetTools Python package <https://hydroframesubsettools.readthedocs.io/en/latest/>`_ can help you do that. 


**Dataset Name**: conus1_domain

**Data Source**: hydroframe

**Citations:**

Please refer to the following citations for more information on this dataset and cite them if you use the data

* https://doi.org/10.5194/gmd-8-923-2015;

* https://doi.org/10.1016/j.advwatres.2015.04.008;

* https://doi.org/10.1002/2014WR016774;

* https://doi.org/10.1002/2015GL066916

**Extent and Resolution**:

* Available Date Range: 

* Grid: conus1

  - Spacial Resolution:  1000 meters

  - XY Grid Spacial Extent:  3342 x 1888

  - LatLon Spacial Exent:  -121.47939483437318, 31.651836025255015,  -76.09875469594509, 50.49802132270979

  - Origin (meters): -1885055.4995, -604957.0654

  - Projection: +proj=lcc +lat_1=33 +lat_2=45 +lon_0=-96.0 +lat_0=39 +a=6378137.0 +b=6356752.31

Variables
^^^^^^^^^^^^^^^^^^

This describes the available variables of the dataset.
Use the dataset, variables and temporal_resolution in python access functions as described in the Working with Gridded Data, and Working with Point Observations.

.. list-table:: Climate Variables
    :widths: 25 60 30 20 20 20
    :header-rows: 1

    * - variable
      - description
      - temporal_resolution
      - units
      - grid
      - 3D
    * - aridity_index
      - Aridity index precipitation/ (precipitaiton -evaporaiton)
      - static
      - unitless
      - conus1
      - no
    * - pme
      - Recharge forcing used for parflow spinups
      - static
      - m/h
      - conus1
      - yes


.. list-table:: Hydrogeology Variables
    :widths: 25 60 30 20 20 20
    :header-rows: 1

    * - variable
      - description
      - temporal_resolution
      - units
      - grid
      - 3D
    * - pf_indicator
      - Indicator file for subsufrace units in parflow
      - static
      - unitless
      - conus1
      - yes
    * - van_genuchten_alpha
      - Alpha parameter for van genucten curve
      - static
      - unitless
      - conus1
      - yes
    * - porosity
      - Porosity
      - static
      - unitless
      - conus1
      - yes
    * - permeability
      - Permeability
      - static
      - m/h
      - conus1
      - yes
    * - van_genuchten_n
      - N parameter for van genuchten curve
      - static
      - unitless
      - conus1
      - yes


.. list-table:: Land Surface Variables
    :widths: 25 60 30 20 20 20
    :header-rows: 1

    * - variable
      - description
      - temporal_resolution
      - units
      - grid
      - 3D
    * - veg_type_IGBP
      - Vegetation type using igbp classifications
      - static
      - unitless
      - conus1
      - yes


.. list-table:: Location Variables
    :widths: 25 60 30 20 20 20
    :header-rows: 1

    * - variable
      - description
      - temporal_resolution
      - units
      - grid
      - 3D
    * - latitude
      - Map grid points to latitude
      - static
      - degrees_north
      - conus1
      - no
    * - longitude
      - Map grid points to longitude
      - static
      - degrees_east
      - conus1
      - no


.. list-table:: Stream Network Variables
    :widths: 25 60 30 20 20 20
    :header-rows: 1

    * - variable
      - description
      - temporal_resolution
      - units
      - grid
      - 3D
    * - stream_order
      - Strahler stream order
      - static
      - unitless
      - conus1
      - no
    * - flow_direction
      - D4 flow direcitons with the following numbering: 1=down, 2=left, 3=up, 4=right
      - static
      - unitless
      - conus1
      - no
    * - flow_direction_grass
      - D4 flow directions with grass numbering (2=up, 4=left, 6=down, 8=right)
      - static
      - unitless
      - conus1
      - no
    * - stream_segments
      - Stream segment id numbers (0 values outside of stream)
      - static
      - unitless
      - conus1
      - no


.. list-table:: Subsurface Variables
    :widths: 25 60 30 20 20 20
    :header-rows: 1

    * - variable
      - description
      - temporal_resolution
      - units
      - grid
      - 3D
    * - ss_pressure_head
      - Presssure head at the end of spinup
      - static
      - m
      - conus1
      - yes


.. list-table:: Topography Variables
    :widths: 25 60 30 20 20 20
    :header-rows: 1

    * - variable
      - description
      - temporal_resolution
      - units
      - grid
      - 3D
    * - slope_x
      - Slope in the x direciton (grid centered)
      - static
      - unitless
      - conus1
      - no
    * - elevation
      - Digital elevation model (dem)
      - static
      - m
      - conus1
      - no
    * - slope_y
      - Slope in the y direction (grid centered)
      - static
      - unitless
      - conus1
      - no
    * - drainage_area
      - Drainage area
      - static
      - km2
      - conus1
      - no
    * - topographic_index
      - Topographic index
      - static
      - unitless
      - conus1
      - no