Merge pull request #26 from tbohn/feature/findley_lake

Added Findley Lake dataset

README.md

@@ -4,8 +4,10 @@ Sample datasets for the Variable Infiltration Capacity (VIC) model.
 The following datasets are currently available:
 - [Stehekin](docs/Stehekin.md)
 - [WalnutGulch](docs/WalnutGulch.md)
+- [FindleyLake](docs/FindleyLake.md)
 
 ## Directory Structure (for dataset `$DATASET`)
+- `obs/$DATASET/` - observations for dataset `$DATASET`
 - `docs/$DATASET.md` - documentation describing dataset `$DATASET`
 - `classic/$DATASET/` - classic-driver data for dataset `$DATASET`
   - `forcings/` - ascii-format meteorological forcing files

classic/FindleyLake/parameters/global_param.FindleyLake.txt

@@ -0,0 +1,102 @@
+MODEL_STEPS_PER_DAY   24
+SNOW_STEPS_PER_DAY	  24
+RUNOFF_STEPS_PER_DAY  24
+
+STARTYEAR	1970
+STARTMONTH	1
+STARTDAY	1
+ENDYEAR 	1979
+ENDMONTH	12
+ENDDAY		31
+CALENDAR    PROLEPTIC_GREGORIAN
+
+NODES                 3      # number of soil thermal nodes
+FULL_ENERGY TRUE
+FROZEN_SOIL	FALSE
+AERO_RESIST_CANSNOW AR_406
+
+#INIT_STATE  ${VIC_SAMPLE_DATA}/classic/FindleyLake/state/state.FindleyLake.19800101
+STATENAME   ${VIC_SAMPLE_DATA}/classic/FindleyLake/state/state.FindleyLake
+STATEYEAR   1980
+STATEMONTH  1
+STATEDAY    1
+
+FORCING1      ${VIC_SAMPLE_DATA}/classic/FindleyLake/forcings/livneh_NAmerExt_15Oct2014.FindleyLake_
+FORCE_FORMAT ASCII
+FORCE_TYPE    PREC 	   prec
+FORCE_TYPE    AIR_TEMP 	   temp
+FORCE_TYPE    SWDOWN       shortwave
+FORCE_TYPE    LWDOWN 	   longwave
+FORCE_TYPE    PRESSURE 	   air_pressure
+FORCE_TYPE    VP           vapor_pressure
+FORCE_TYPE    WIND         wind
+FORCE_STEPS_PER_DAY  24
+FORCEYEAR  1970
+FORCEMONTH 1
+FORCEDAY   1
+GRID_DECIMAL 4
+WIND_H        10.0
+
+SOIL            ${VIC_SAMPLE_DATA}/classic/FindleyLake/params/soil_param.FindleyLake
+VEGLIB          ${VIC_SAMPLE_DATA}/classic/FindleyLake/params/veg_lib_IGBP
+VEGPARAM        ${VIC_SAMPLE_DATA}/classic/FindleyLake/params/veg_param.FindleyLake
+ROOT_ZONES      3
+VEGLIB_FCAN     FALSE
+VEGPARAM_LAI    TRUE
+VEGPARAM_FCAN   TRUE
+VEGPARAM_ALB    TRUE
+LAI_SRC         FROM_VEGPARAM
+FCAN_SRC        FROM_VEGPARAM
+ALB_SRC         FROM_VEGPARAM
+LAKES           ${VIC_SAMPLE_DATA}/classic/FindleyLake/params/lake_param.FindleyLake
+LAKE_PROFILE    TRUE
+EQUAL_AREA      TRUE
+RESOLUTION      1.29
+SNOW_BAND       1
+
+RESULT_DIR  ${VIC_SAMPLE_RESULTS}/sample_classic
+OUTFILE     fluxes
+COMPRESS    FALSE
+OUT_FORMAT  ASCII
+AGGFREQ     NDAYS   1
+OUTVAR OUT_PREC
+OUTVAR OUT_EVAP
+OUTVAR OUT_RUNOFF
+OUTVAR OUT_BASEFLOW
+OUTVAR OUT_WDEW
+OUTVAR OUT_SNOW_CANOPY
+OUTVAR OUT_SWE
+OUTVAR OUT_SOIL_MOIST
+OUTVAR OUT_SOIL_TEMP
+OUTVAR OUT_SURF_TEMP
+OUTVAR OUT_AIR_TEMP
+OUTVAR OUT_PET
+OUTVAR OUT_LAI
+OUTVAR OUT_FCANOPY
+OUTVAR OUT_ALBEDO
+OUTVAR OUT_SWNET
+OUTVAR OUT_LWNET
+OUTVAR OUT_SENSIBLE
+OUTVAR OUT_LATENT
+OUTVAR OUT_GRND_FLUX
+OUTVAR OUT_SNOW_FLUX
+OUTVAR OUT_LAKE_DEPTH
+OUTVAR OUT_LAKE_SURF_AREA
+OUTVAR OUT_LAKE_ICE_FRACT
+OUTVAR OUT_LAKE_ICE_HEIGHT
+OUTVAR OUT_LAKE_ICE
+OUTVAR OUT_LAKE_MOIST
+OUTVAR OUT_LAKE_VOLUME
+OUTVAR OUT_LAKE_SWE_V
+OUTVAR OUT_LAKE_PREC_V
+OUTVAR OUT_LAKE_EVAP_V
+OUTVAR OUT_LAKE_RO_IN_V
+OUTVAR OUT_LAKE_BF_IN_V
+OUTVAR OUT_LAKE_CHAN_OUT_V
+OUTVAR OUT_LAKE_BF_OUT_V
+OUTVAR OUT_LAKE_DSTOR_V
+OUTVAR OUT_LAKE_DSWE_V
+OUTVAR OUT_LAKE_RCHRG_V
+OUTVAR OUT_LAKE_VAPFLX_V
+OUTVAR OUT_LAKE_SURF_TEMP
+

classic/FindleyLake/parameters/lake_param.FindleyLake

@@ -0,0 +1,2 @@
+13099 0 10 23.4 0.001671 23.4 1.0
+24.4 0.0885 23.4 0.0884 20.8 0.0698 18.2 0.0535 15.6 0.0393 13.0 0.0273 10.4 0.0175 7.8 0.0098 5.2 0.0044 2.6 0.0011

classic/FindleyLake/parameters/soil_param.FindleyLake

@@ -0,0 +1 @@
+1 13099 47.3188 -121.5853 0.3197 0.1 1 0.75 2 11.402 11.402 11.402 2270.064 2270.064 2270.064 -99 -99 -99 12.281 36.844 122.812 1240 0.10 0.30 0.20 4 4 10.182 10.182 10.182 0.812 0.812 0.812 1532.28 1532.28 1532.28 2622.32 2622.32 2622.32 -8 0.24 0.24 0.24 0.13 0.13 0.13 0.01 0.03 -99 0 0 0 0

classic/FindleyLake/parameters/veg_lib_IGBP

@@ -0,0 +1,18 @@
+#Class OvrStry Rarc Rmin JAN-LAI FEB-LAI MAR-LAI APR-LAI MAY-LAI JUN-LAI JUL-LAI AUG-LAI SEP-LAI OCT-LAI NOV-LAI DEC-LAI JAN-ALB FEB_ALB MAR-ALB APR-ALB MAY-ALB JUN-ALB JUL-ALB AUG-ALB SEP-ALB OCT-ALB NOV-ALB DEC-ALB JAN-ROU FEB-ROU MAR-ROU APR-ROU MAY-ROU JUN-ROU JUL-ROU AUG-ROU SEP-ROU OCT-ROU NOV-ROU DEC-ROU JAN-DIS FEB-DIS MAR-DIS APR-DIS MAY-DIS JUN-DIS JUL-DIS AUG-DIS SEP-DIS OCT-DIS NOV-DIS DEC-DIS WIND_H RGL SolAtn WndAtn Trunk COMMENT
+0 0 5.0 50.0 0.200 0.200 0.200 0.200 0.200 0.200 0.200 0.200 0.200 0.200 0.200 0.200 0.20 0.20 0.20 0.20 0.20 0.20 0.20 0.20 0.20 0.20 0.20 0.20 0.0738 0.0738 0.0738 0.0738 0.0738 0.0738 0.0738 0.0738 0.0738 0.0738 0.0738 0.0738 0.402 0.402 0.402 0.402 0.402 0.402 0.402 0.402 0.402 0.402 0.402 0.402 5 100 0.5 0.5 0.2 Open Water
+1 1 60.0 150. 3.400 3.400 3.500 3.700 4.000 4.400 4.400 4.300 4.200 3.700 3.500 3.400 0.12 0.12 0.12 0.12 0.12 0.12 0.12 0.12 0.12 0.12 0.12 0.12 1.476 1.476 1.476 1.476 1.476 1.476 1.476 1.476 1.476 1.476 1.476 1.476 8.04 8.04 8.04 8.04 8.04 8.04 8.04 8.04 8.04 8.04 8.04 8.04 50.0 30 0.5 0.5 0.2 Evergreen Needleleaf forest
+2 1 60.0 150. 3.400 3.400 3.500 3.700 4.000 4.400 4.400 4.300 4.200 3.700 3.500 3.400 0.12 0.12 0.12 0.12 0.12 0.12 0.12 0.12 0.12 0.12 0.12 0.12 1.476 1.476 1.476 1.476 1.476 1.476 1.476 1.476 1.476 1.476 1.476 1.476 8.04 8.04 8.04 8.04 8.04 8.04 8.04 8.04 8.04 8.04 8.04 8.04 50.0 30 0.5 0.5 0.2 Evergreen Broadleaf forest
+3 1 60.0 150. 1.680 1.520 1.680 2.900 4.900 5.000 5.000 4.600 3.440 3.040 2.160 2.000 0.18 0.18 0.18 0.18 0.18 0.18 0.18 0.18 0.18 0.18 0.18 0.18 1.230 1.230 1.230 1.230 1.230 1.230 1.230 1.230 1.230 1.230 1.230 1.230 6.70 6.70 6.70 6.70 6.70 6.70 6.70 6.70 6.70 6.70 6.70 6.70 50.0 30 0.5 0.5 0.2 Deciduous Needleleaf forest
+4 1 60.0 150. 1.680 1.520 1.680 2.900 4.900 5.000 5.000 4.600 3.440 3.040 2.160 2.000 0.18 0.18 0.18 0.18 0.18 0.18 0.18 0.18 0.18 0.18 0.18 0.18 1.230 1.230 1.230 1.230 1.230 1.230 1.230 1.230 1.230 1.230 1.230 1.230 6.70 6.70 6.70 6.70 6.70 6.70 6.70 6.70 6.70 6.70 6.70 6.70 50.0 30 0.5 0.5 0.2 Deciduous Broadleaf forest
+5 1 60.0 140. 1.680 1.520 1.680 2.900 4.900 5.000 5.000 4.600 3.440 3.040 2.160 2.000 0.18 0.18 0.18 0.18 0.18 0.18 0.18 0.18 0.18 0.18 0.18 0.18 1.230 1.230 1.230 1.230 1.230 1.230 1.230 1.230 1.230 1.230 1.230 1.230 6.70 6.70 6.70 6.70 6.70 6.70 6.70 6.70 6.70 6.70 6.70 6.70 50.0 50 0.5 0.5 0.2 Mixed forest
+6 0 50.0 135. 2.000 2.250 2.950 3.850 3.750 3.500 3.550 3.200 3.300 2.850 2.600 2.200 0.19 0.19 0.19 0.19 0.19 0.19 0.19 0.19 0.19 0.19 0.19 0.19 0.495 0.495 0.495 0.495 0.495 0.495 0.495 0.495 0.495 0.495 0.495 0.495 1.00 1.00 1.00 1.00 1.00 1.00 1.00 1.00 1.00 1.00 1.00 1.00 5 75. 0.5 0.5 0.2 Closed Shrublands
+7 0 50.0 135. 2.000 2.250 2.950 3.850 3.750 3.500 3.550 3.200 3.300 2.850 2.600 2.200 0.19 0.19 0.19 0.19 0.19 0.19 0.19 0.19 0.19 0.19 0.19 0.19 0.495 0.495 0.495 0.495 0.495 0.495 0.495 0.495 0.495 0.495 0.495 0.495 1.00 1.00 1.00 1.00 1.00 1.00 1.00 1.00 1.00 1.00 1.00 1.00 5 75. 0.5 0.5 0.2 Open Shrublands
+8 1 60.0 125. 1.680 1.520 1.680 2.900 4.900 5.000 5.000 4.600 3.440 3.040 2.160 2.000 0.18 0.18 0.18 0.18 0.18 0.18 0.18 0.18 0.18 0.18 0.18 0.18 1.230 1.230 1.230 1.230 1.230 1.230 1.230 1.230 1.230 1.230 1.230 1.230 6.70 6.70 6.70 6.70 6.70 6.70 6.70 6.70 6.70 6.70 6.70 6.70 50.0 50 0.5 0.5 0.2 Woody Savannas (40-60% tree cover)
+9 0 40.0 125. 2.000 2.250 2.950 3.850 3.750 3.500 3.550 3.200 3.300 2.850 2.600 2.200 0.19 0.19 0.19 0.19 0.19 0.19 0.19 0.19 0.19 0.19 0.19 0.19 0.495 0.495 0.495 0.495 0.495 0.495 0.495 0.495 0.495 0.495 0.495 0.495 1.00 1.00 1.00 1.00 1.00 1.00 1.00 1.00 1.00 1.00 1.00 1.00 5 75. 0.5 0.5 0.2 Savannas (10-40% tree cover)
+10 0 25.0 50.0 2.000 2.250 2.950 3.850 3.750 3.500 3.550 3.200 3.300 2.850 2.600 2.200 0.20 0.20 0.20 0.20 0.20 0.20 0.20 0.20 0.20 0.20 0.20 0.20 0.0738 0.0738 0.0738 0.0738 0.0738 0.0738 0.0738 0.0738 0.0738 0.0738 0.0738 0.0738 0.402 0.402 0.402 0.402 0.402 0.402 0.402 0.402 0.402 0.402 0.402 0.402 5 100 0.5 0.5 0.2 Grasslands
+11 0 25.0 50.0 2.000 2.250 2.950 3.850 3.750 3.500 3.550 3.200 3.300 2.850 2.600 2.200 0.20 0.20 0.20 0.20 0.20 0.20 0.20 0.20 0.20 0.20 0.20 0.20 0.0738 0.0738 0.0738 0.0738 0.0738 0.0738 0.0738 0.0738 0.0738 0.0738 0.0738 0.0738 0.402 0.402 0.402 0.402 0.402 0.402 0.402 0.402 0.402 0.402 0.402 0.402 5 100 0.5 0.5 0.2 Permanent wetlands
+12 0 40.0 100. 0.500 0.500 0.500 0.500 1.500 3.0000 4.500 5.0000 2.5000 0.500 0.500 0.500 0.10 0.10 0.10 0.10 0.20 0.20 0.20 0.20 0.20 0.10 0.10 0.10 0.215 0.215 0.215 0.215 0.215 0.215 0.215 0.215 0.215 0.215 0.215 0.215 1.166 1.166 1.166 1.166 1.166 1.166 1.166 1.166 1.166 1.166 1.166 1.166 5 100 0.5 0.5 0.2 Croplands (rainfed corn 1.75 m tall)
+13 0 25.0 50.0 0.200 0.200 0.200 0.200 0.200 0.200 0.200 0.200 0.200 0.200 0.200 0.200 0.20 0.20 0.20 0.20 0.20 0.20 0.20 0.20 0.20 0.20 0.20 0.20 0.0738 0.0738 0.0738 0.0738 0.0738 0.0738 0.0738 0.0738 0.0738 0.0738 0.0738 0.0738 0.402 0.402 0.402 0.402 0.402 0.402 0.402 0.402 0.402 0.402 0.402 0.402 5 100 0.5 0.5 0.2 Urban and built-up
+14 0 40.0 125. 2.000 2.250 2.950 3.850 3.750 3.500 3.550 3.200 3.300 2.850 2.600 2.200 0.19 0.19 0.19 0.19 0.19 0.19 0.19 0.19 0.19 0.19 0.19 0.19 0.495 0.495 0.495 0.495 0.495 0.495 0.495 0.495 0.495 0.495 0.495 0.495 1.00 1.00 1.00 1.00 1.00 1.00 1.00 1.00 1.00 1.00 1.00 1.00 5 75. 0.5 0.5 0.2 Cropland/Natural vegetation mosaic
+15 0 5.0 50.0 0.200 0.200 0.200 0.200 0.200 0.200 0.200 0.200 0.200 0.200 0.200 0.200 0.60 0.60 0.60 0.60 0.60 0.60 0.60 0.60 0.60 0.60 0.60 0.60 0.0738 0.0738 0.0738 0.0738 0.0738 0.0738 0.0738 0.0738 0.0738 0.0738 0.0738 0.0738 0.402 0.402 0.402 0.402 0.402 0.402 0.402 0.402 0.402 0.402 0.402 0.402 5 100 0.5 0.5 0.2 Snow and ice
+16 0 5.0 50.0 0.200 0.200 0.200 0.200 0.200 0.200 0.200 0.200 0.200 0.200 0.200 0.200 0.20 0.20 0.20 0.20 0.20 0.20 0.20 0.20 0.20 0.20 0.20 0.20 0.0738 0.0738 0.0738 0.0738 0.0738 0.0738 0.0738 0.0738 0.0738 0.0738 0.0738 0.0738 0.402 0.402 0.402 0.402 0.402 0.402 0.402 0.402 0.402 0.402 0.402 0.402 5 100 0.5 0.5 0.2 Barren or sparsely vegetated

classic/FindleyLake/parameters/veg_param.FindleyLake

@@ -0,0 +1,13 @@
+13099 3
+0 0.0885 0.10 0.20 0.30 0.75 0.20 0.05
+0.0000 0.0000 0.0000 0.0000 0.0000 0.0000 0.0000 0.0000 0.0000 0.0000 0.0000 0.0000
+0.0000 0.0000 0.0000 0.0000 0.0000 0.0000 0.0000 0.0000 0.0000 0.0000 0.0000 0.0000
+0.2000 0.2000 0.2000 0.2000 0.2000 0.2000 0.2000 0.2000 0.2000 0.2000 0.2000 0.2000
+1 0.8231 0.10 0.05 1.00 0.45 5.00 0.50
+1.3662 1.8304 1.9195 2.1085 2.6123 3.1965 3.9445 4.1322 3.7623 2.4844 1.7725 0.9589
+0.7174 0.7240 0.6250 0.6512 0.7738 0.9028 0.9616 0.9644 0.9606 0.8839 0.7458 0.6419
+0.1110 0.1081 0.1086 0.1177 0.1133 0.1078 0.1056 0.1027 0.0947 0.0915 0.1006 0.1096
+16 0.0884 0.10 0.20 0.30 0.75 0.20 0.05
+0.0000 0.0000 0.0000 0.0000 0.0000 0.0000 0.0000 0.0000 0.0000 0.0000 0.0000 0.0000
+0.0000 0.0000 0.0000 0.0000 0.0000 0.0000 0.0000 0.0000 0.0000 0.0000 0.0000 0.0000
+0.2000 0.2000 0.2000 0.2000 0.2000 0.2000 0.2000 0.2000 0.2000 0.2000 0.2000 0.2000

classic/Stehekin/parameters/global_param.STEHE.txt

@@ -19,6 +19,17 @@ ENDDAY                10     # day model simulation ends
 FULL_ENERGY           FALSE  # TRUE = calculate full energy balance; FALSE = compute water balance only
 FROZEN_SOIL           FALSE  # TRUE = calculate frozen soils
 
+######################################################################
+## State Files
+########################################################################
+##INIT_STATE ${VIC_STATE_DIR}/classic/Stehekin/states_YYYYMMDD_SSSSS # Initial state path/file, where YYYY = year, MM = month, DD = day, SSSSS = seconds, for example 19490111_00000
+#STATENAME ${VIC_STATE_DIR}/classic/Stehekin/states  # Output state file path/prefix. The time (STATEYEAR,STATEMONTH,STATEDAY,STATESEC) will be appended to the prefix automatically in the format yyyymmdd.
+#STATEYEAR   1949    # year to save model state
+#STATEMONTH  1  # month to save model state
+#STATEDAY    11  # day to save model state
+#STATESEC    0  # second to save model state
+#STATE_FORMAT ASCII  # State file format, valid options: ASCII, BINARY
+
 #######################################################################
 # Forcing Files
 #######################################################################
@@ -56,8 +67,7 @@ SNOW_BAND           5  ${VIC_SAMPLE_DATA}/classic/Stehekin/Stehekin_snowbands.tx
 #######################################################################
 # Output Files and Parameters
 #######################################################################
-RESULT_DIR     ${VIC_SAMPLE_RESULTS}/sample_classic/  # Results directory path
-
+RESULT_DIR     ${VIC_SAMPLE_RESULTS}/sample_classic  # Results directory path
 OUTFILE     fluxes
 AGGFREQ     NDAYS   1  # Write output every 1 day
 COMPRESS    FALSE  # TRUE = compress input and output files when done

docs/FindleyLake.md

@@ -0,0 +1,87 @@
+# FindleyLake Sample Dataset
+
+## Documentation
+For details on Findley Lake, explanation of how parameters were estimated, illustration of example simulations, and ideas for future improvements, see: [Preparation_of_VIC_Parameters_for_Findley_Lake.pdf](Preparation_of_VIC_Parameters_for_Findley_Lake.pdf).
+
+## Files
+
+### Observations
+
+- `obs/FindleyLake/FindleyLakeHydrology.cvs` - observations of water balance terms from Richey and Wissmar (1979)
+
+### Image Driver
+
+- `image/FindleyLake/parameters/` - parameter files
+    - Global Parameter Files:
+        - `global_param.FindleyLake.txt`
+            - Domain File: `domain.FindleyLake.nc`
+            - Parameter File: `params.FindleyLake.nc`
+            - Forcings: `livneh_NAmerExt_15Oct2014.FindleyLake.*.nc`
+            - fcanopy is used 
+            - Default initial state is used
+        - `global_param.FindleyLake.txt`
+            - Domain File: `domain.FindleyLake.nc`
+            - Parameter File: `params.FindleyLake.nc`
+            - Forcings: `livneh_NAmerExt_15Oct2014.FindleyLake.*.nc`
+            - Initial State File: `state.FindleyLake.19740101_00000nc`
+            - fcanopy is used 
+    - Domain Files:
+        - `domain.FindleyLake.nc`
+            - 0.0625 degree resolution
+            - Taken from Bohn et al. (2018)
+    - Parameter Files:
+        - `params.FindleyLake.nc`
+            - 0.0625 degree resolution
+            - MOD-LSP MOD_IGBP parameters (Bohn and Vivoni, 2019)
+            - Soils and snowbands from NLDAS
+            - Land cover, LAI, fcanopy, and albedo from MODIS
+
+- `image/FindleyLake/forcings/` - meteorological forcing files
+    - `livneh_NAmerExt_15Oct2014.FindleyLake.*.nc` where `*` = years 1970-1979
+        - Yearly files
+        - 1-hour time step
+        - From Livneh et al. (2015)
+        - Disaggregated to hourly via MetSim (Bennett et al., 2018) v2.0.0 using "mix" precipitation option and parameters from Bohn et al. (2018)
+
+- `image/FindleyLake/state/` - initial and final state files
+    - `state.FindleyLake.19740101_00000.nc`
+        - Final state file from a 5-year simulation starting from a default initial state
+        - This can be used as the initial (spun-up) state file for a simulation
+
+### Classic Driver
+
+- `classic/FindleyLake/parameters/` - parameter files
+    - Global Parameter Files:
+        - `global_param.FindleyLake.txt`
+            - Soil Parameter File: `soil_param.FindleyLake`
+            - Snowband Parameter File: none
+            - Veg Library File: `veg_lib_IGBP`
+            - Veg Parameter File: `veg_param.FindleyLake`
+            - Lake Parameter File: `lake_param.FindleyLake`
+            - Forcings: `livneh_NAmerExt_15Oct2014.FindleyLake_47.3188_-121.5853`
+            - Fcanopy is used
+    - Soil Parameters:
+        - `soil_param.FindleyLake`
+            - 1 grid cell
+            - MOD-LSP MOD_IGBP parameters (Bohn and Vivoni, 2019)
+    - Vegetation Library:
+        - `veg_lib_IGBP`
+            - MOD-LSP MOD_IGBP veglib parameters (Bohn and Vivoni, 2019)
+    - Vegetation Parameters:
+        - `veg_param.FindleyLake`
+            - MOD-LSP MOD_IGBP veg parameters (Bohn and Vivoni, 2019)
+            - Contains fcanopy
+
+- `classic/FindleyLake/forcings/` - meteorological forcing files
+    - `livneh_NAmerExt_15Oct2014.FindleyLake_47.3188_-121.5853`
+        - 10 years of data, 1970-1979
+        - 1-hour time step
+        - From Livneh et al. (2015)
+        - Disaggregated to hourly via MetSim (Bennett et al., 2018) v2.0.0 using "mix" precipitation option and parameters from Bohn et al. (2018)
+
+## References
+ - Bennett, A., J. J. Hamman, B. Nijssen, E. A. Clark, and K. M. Andreadis, 2018: UW-Hydro/MetSim: Version 1.1.0 (version 1.1.0). Zenodo, doi:10.5281/zenodo.1256120. http://doi.org/10.5281/zenodo.1256120 (Accessed June 7, 2018).
+ - Bohn, T. J, and E. R. Vivoni, 2019: MOD-LSP: MODIS-Based Parameters for Variable Infiltration Capacity (VIC) Model over the Continental US, Mexico, and Southern Canada (Version 1.0) [Data set]. Zenodo, doi:10.5281/zenodo.2612560. https://zenodo.org/record/2612560.
+ - Bohn, T. J., K. M. Whitney, G. Mascaro, and E. R. Vivoni, 2018: Parameters for PITRI Precipitation Temporal Disaggregation over continental US, Mexico, and southern Canada, 1981-2013 (Version 1.1) [Data set]. Zenodo, doi:10.5281/zenodo.2564019. http://zenodo.org/record/2564019.
+ - Livneh, B., T. J. Bohn, D. W. Pierce, F. Munoz-Arriola, B. Nijssen, R. Vose, D. R. Cayan, and L. Brekke, 2015: A spatially comprehensive, hydrometeorological data set for Mexico, the U.S., and southern Canada 1950–2013. Nat. Sci. Data, 2, 150042, doi:10.1038/sdata.2015.42.
+ - Richey, J. E., and R. C. Wissmar, 1979: Sources and influences of allochthonous inputs on the productivity of a subalpine lake. Ecology, 60, 318–328.

docs/Stehekin.md

@@ -1,5 +1,7 @@
 # Stehekin Sample Dataset
 
+## Files
+
 ### Image Driver
 
 - `image/Stehekin/parameters/` - parameter files
@@ -47,6 +49,7 @@
         - `stehekin_parameters_01.rvic.prm.Stehekin.20150727.nc`
 
 - `image/Stehekin/forcings/` - meteorological forcing files
+    - (All from Livneh et al. (2015))
     - `Stehekin_image_test.forcings_10days.1949.nc`
         - 0.125 degree resolution
         - 1-hour time step
@@ -86,6 +89,7 @@
             - NLDAS veg parameters
 
 - `classic/Stehekin/forcings/` - meteorological forcing files
+    - (All from Livneh et al. (2015))
     - `forcings_*`
         - 0.125 degree resolution
         - 1-hour time step

docs/WalnutGulch.md

@@ -1,5 +1,7 @@
 # WalnutGulch Sample Dataset
 
+## Files
+
 ### Image Driver
 
 - `image/WalnutGulch/parameters/` - parameter files
@@ -38,6 +40,7 @@
         - 0.0625 degree resolution
         - 3-hour time step
         - 366 days of records
+        - From Livneh et al. (2015)
 
 ### Classic Driver