.. _gen_conus2_domain:
Inputs for baseline CONUS2 ParFlow Simulations
^^^^^^^^^^^^^^^^^^
The ParFlow CONUS2 model is the second generation national ParFlow model. The CONUS2 domain covers the entire contiguous US and areas draining to it. The domain extent and projection are based off of the National Water Model Grid. Manual corrections were made along the coastline to get rid of cells that were water and to prune any orphan cells (i.e. cells attached to the domain only by a corner). You can learn more about the domain and the model on the `HydroFrame Website `_.
For datasets that are 3 dimensional, the ParFlow CONUS2 model consists of 10 layers with a total depth of about 392 m. The layers have variable thicknesses of 200, 100, 50, 25, 10, 5, 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 9 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 `_ can help you do that.
**Dataset Name**: conus2_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://essd.copernicus.org/articles/13/3263/2021/
**Extent and Resolution**:
* Available Date Range:
* Grid: conus2
- Spacial Resolution: 1000 meters
- XY Grid Spacial Extent: 4442 x 3256
- LatLon Spacial Exent: -126.88755692881833, 21.8170599154073, -64.7677149695924, 53.20274381640737
- Origin (meters): -2208000.30881173, -1668999.65483222
- Projection: +proj=lcc +lat_1=30 +lat_2=60 +lon_0=-97.0 +lat_0=40.0000076294444 +a=6370000.0 +b=6370000
* Grid: conus2.250
- Spacial Resolution: 250 meters
- XY Grid Spacial Extent: 4442 x 3256
- LatLon Spacial Exent: -126.88755692881833, 21.8170599154073, -64.7677149695924, 53.20274381640737
- Origin (meters): -2208000.30881173, -1668999.65483222
- Projection:
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
* - pme
- Recharge forcing used for parflow spinups
- static
- m/h
- conus2
- yes
.. list-table:: Hydrogeology Variables
:widths: 25 60 30 20 20 20
:header-rows: 1
* - variable
- description
- temporal_resolution
- units
- grid
- 3D
* - ln_k
- Natural log of hydraulic conductivity (lnk), where k is the average over the ten subsurface layers of parflow
- static
- m/h
- conus2
- no
* - pf_indicator
- Indicator file for subsufrace units in parflow
- static
- unitless
- conus2
- yes
* - pf_flowbarrier
- File defining the depth to flow barier
- static
- unitless
- conus2
- yes
* - vg_n
- N parameter for the van genuchten curves related to the pore-size distribution
- static
- unitless
- conus2
- yes
* - vg_alpha
- Alpha parameter for the van genuchten curves related to the air entry suction
- static
- 1/m
- conus2
- yes
* - specific_storage
- Compressible storage of the porous media
- static
- 1/m
- conus2
- yes
* - sres
- Lower limit of water saturation for the van genuchten curves (often varies by soil type)
- static
- unitless
- conus2
- yes
* - ssat
- Upper limit of water saturation for the van genuchten curves (usually set to 1)
- static
- unitless
- conus2
- yes
* - top_patch
- Index numbers for different land surface boundaries applied to the top surface of a parflow model (for the conus2 domain: -1=cells outside the active domain, 2=regular land cells on the top boundary where we apply overlandkinematic boundary condition, 3=lake cells where we apply seepage face boundary condition, 4=sinks where we apply seepage face boundary condition)
- static
- unitless
- conus2
- no
* - porosity
- Porosity
- static
- unitless
- conus2
- yes
* - permeability_x
- Permeability in the x direction
- static
- m/h
- conus2
- yes
* - permeability_y
- Permeability in the y direction
- static
- m/h
- conus2
- yes
* - permeability_z
- Permeability in the z direction
- static
- m/h
- conus2
- 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
- conus2
- yes
.. list-table:: Location Variables
:widths: 25 60 30 20 20 20
:header-rows: 1
* - variable
- description
- temporal_resolution
- units
- grid
- 3D
* - longitude
- Map grid points to longitude
- static
- degrees_east
- conus2
- no
* - latitude
- Map grid points to latitude
- static
- degrees_north
- conus2
- no
* - lat_lon
- Latitude/longitude in z dimension
- static
- unitless
- conus2
- yes
.. list-table:: Run File Variables
:widths: 25 60 30 20 20 20
:header-rows: 1
* - variable
- description
- temporal_resolution
- units
- grid
- 3D
* - clm_run
- No description
- static
- unitless
- conus2
- yes
* - pf_solid
- File to define a domain shape for parflow
- static
- unitless
- conus2
- no
.. list-table:: Stream Network Variables
:widths: 25 60 30 20 20 20
:header-rows: 1
* - variable
- description
- temporal_resolution
- units
- grid
- 3D
* - distance_stream_lin
- Shortest linear distance to streams
- static
- km
- conus2, conus2.250
- no
* - flow_direction
- D4 flow direcitons with the following numbering: 1=down, 2=left, 3=up, 4=right
- static
- unitless
- conus2, conus2.250
- no
* - stream_segments
- Stream segment id numbers (0 values outside of stream)
- static
- unitless
- conus2, conus2.250
- no
* - stream_order
- Strahler stream order
- static
- unitless
- conus2, conus2.250
- 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
- conus2
- yes
* - ss_water_table_depth
- Water table depth at the end of spinup
- static
- unitless
- conus2
- no
.. list-table:: Surface Water Variables
:widths: 25 60 30 20 20 20
:header-rows: 1
* - variable
- description
- temporal_resolution
- units
- grid
- 3D
* - mannings
- Mannings roughness coefficient
- static
- unitless
- conus2
- no
.. list-table:: Topography Variables
:widths: 25 60 30 20 20 20
:header-rows: 1
* - variable
- description
- temporal_resolution
- units
- grid
- 3D
* - slope_y
- Slope in the y direction (grid centered)
- static
- unitless
- conus2
- no
* - slope_x
- Slope in the x direciton (grid centered)
- static
- unitless
- conus2
- no
* - drainage_area
- Drainage area
- static
- km2
- conus2, conus2.250
- no
* - border_type
- 0=interior,1=ocean border,2=land border
- static
- unitless
- conus2
- no
* - mask_back
- Mask int values defining patch types for points on grid.
- static
- unitless
- conus2
- no
* - mask_top
- Mask int values defining patch types for points on grid.
- static
- unitless
- conus2
- no
* - mask_bottom
- Mask int values defining patch types for points on grid.
- static
- unitless
- conus2
- no
* - mask_left
- Mask int values defining patch types for points on grid.
- static
- unitless
- conus2
- no
* - mask_right
- Mask int values defining patch types for points on grid.
- static
- unitless
- conus2
- no
* - mask_front
- Mask int values defining patch types for points on grid.
- static
- unitless
- conus2
- no
* - river_mask
- Mask values 1 or 0 for points on grid that are part of a river network.
- static
- unitless
- conus2
- no
* - elevation
- Digital elevation model (dem)
- static
- m
- conus2, conus2.250
- no
* - mask
- Mask showing active domain
- static
- unitless
- conus2
- no