Publication containing results from models in this data release: --------------------------- Essaid, H. I., and Caldwell, R. R., 2017, Evaluating the impact of irrigated agriculture on surface water – groundwater interaction and stream temperature in an agricultural watershed: Science of the Total Environment, v. 599-600, pp. 581-596, https://doi.org/10.1016/j.scitotenv.2017.04.205. Data Release: --------------------- Essaid, H. I., 2017, GSFLOW model simulations used to evaluate the impact of irrigated agriculture on surface water – groundwater interaction, https://dx.doi.org/10.5066/F79W0CM0. ---------------------------------------------------------------------------------------------------- Archive Revision History: ------------------------ 02/10/2017 Model archive created to conform to the structure specified for public release of groundwater flow and transport models. 04/10/2017 Model archive update based on Claire Tiedeman's review of model archive. 05/08/2017 Model archive update with final information for Essaid2017_STotEn --------------------------------------------------------------------------------- Essaid2017_STotEn/ Description: ----------- The underlying directories contain all of the input and output files for the simulations described in the journal article and the GSFLOW (v 1.2.0) source code and executable used to run the model simulations. Descriptions of the data in each subdirectory are given to facilitate understanding of this model archive. Files descriptions are provided for select files to provide additional information that may be of use for understanding this data model archive. Support is provided for correcting errors in the data release and clarification of the modeling conducted by the U.S. Geological Survey. Users are encouraged to review the complete manuscript of Essaid and Caldwell (2017) (https://doi.org/10.1016/j.scitotenv.2017.04.205) to understand the purpose, construction, and limitations of this model. Reconstructing the data release from the online data release: ------------------------------------------------------------- This data release is available from: https://dx.doi.org/10.5066/F79W0CM0 The models will run successfully only if the original directory structure is correctly restored. The data release is broken into several pieces to reduce the likelyhood of download timeouts. Small files (readme.txt and modelgeoref.txt) are available as uncompressed files. All other files are zipped at the subdirectory level. For example, the files in the "georef" subdirectory are zipped into a zip file named "georef.zip". All zip files should be unzipped into a directory with the same name as the zip file name without the .zip extension. All zip files with names starting with "output" should be unzipped in the same manner as other zip files but should be placed within an "output" subdirectory created at the same level as the "georef" subdirectory created from "georef.zip". The highest-level directory structure of the original data release is: Essaid2017_STotEn\ \ancillary\ \bin\ \georef\ \model\ \output\ \source\ To reconstruct the data release on the user's computer running the Windows operating system: Create a directory Essaid2017_STotEn\. Download ancillary.zip, bin.zip, georef.zip, model.zip, output.modelPreIrr.zip, output.modelIrrCurrent.zip, output.modelIrrGW.zip, and source.zip from https://dx.doi.org/10.5066/F79W0CM0. Unzip ancillary.zip, bin.zip, georef.zip, model.zip and source.zip in the directory Essaid2017_STotEn\ so that this directory contains the subdirectories ancillary\, bin\, georef\, model\ and source\. Create subdirectory output\ in the directory Essaid2017_STotEn\. Unzip output.modelPreIrr.zip, output.modelIrrCurrent.zip and output.modelIrrGW.zip in the output\ subdirectory. The full directory structure of the data release and the zip files associated with each subdirectory are listed below. System requirements: -------------------- The models contained in this data release were run using the gsflow_dbl.exe executable in the bin zip file in this data release. gsflow_dbl.exe was compiled using the Microsoft Visual Studio 2013 Version 12.0.21005.1 development environment and the Intel® Parallel Studio XE 2015 Composer Edition for Fortran Windows* Update 1 Integration for Microsoft Visual Studio* 2013, Version 15.0.0115.1 and Microsoft Visual C++ 2013 06177-004-0047006-02828 compilers. Each model requires approximately 13 GB of available Random Access Memory (RAM). The models have been run successfully on computers running the 64-bit Windows 7 Enterprise OS (Service Pack 1) Windows operating systems (OS). Running the model(s): --------------------- The simulations can be run by double clicking the batch file: USR_gsflow.bat in the subdirectory of model\ that contains the input files of interest. This will open a command line (terminal) window and execute the model. For example, for the PreIrr simulation go to the model\modelPreIrr\ subdirectory and double-click: USR_gsflow.bat to run the PreIrr scenario simulation. The output from the simulation will be created in the same subdirectory containing the input files. For example, PreIrr scenario simulation results are saved to the model\modelPreIrr subdirectory. These files can be compared to the output files given in the output\output.modelPreIrr subdirectory. Files: ----- readme.txt : This file documents the structure, directories and files, and instructions on how to run the model for this data release. modelgeoref.txt : ASCII file with the four corners of the model domain. ancillary\ Description and Content: ----------- This directory contains GIS data used to develop the model in subdirectories: grid\ This subdirectory contains a shapefile for the model grid with parameter values used to develop the model. A readme.txt file describes the field headings in the attribute table of USRcells200.shp. stream\ This subdirectory contains the shapefile for the model stream network. and GSFLOW documentation in subdirectory: gsflow_doc\ ZIP Files: ---------- ancillary.zip bin\ Description: ----------- GSFLOW (v 1.2.0) executable file used to run the scenarios documented in Essaid and Caldwell (2017) (doi: https://doi.org/10.1016/j.scitotenv.2017.04.205). The executable was compiled for the 64-bit Windows 7 Operating System. ZIP Files: ---------- bin.zip georef\ Description: ----------- This directory contains a shapefile defining the active and inactive areas of the model documented in Essaid and Caldwell (2017) (doi: https://doi.org/10.1016/j.scitotenv.2017.04.205). ZIP Files: ---------- georef.zip model\ Description: ----------- This directory contains three subdirectories corresponding to the three simulated scenarios documented in Essaid and Caldwell (2017) (doi: https://doi.org/10.1016/j.scitotenv.2017.04.205). Each subdirectory contains all of the model scenario input files necessary to run the simulation. Input files with the USR prefix contain input parameters for the PRMS portion of GSFLOW. Input files with the USRMF prefix contain input parameters for the MODFLOW portion of GSFLOW. Input parameters are described in Appendix 1 of ancillary\gsflow_doc\tm6d1_GSFLOW.pdf. The files in the subdirectories are: usgs.model.reference ASCII text file containing data to register the model in space and time USR.canopy.param PRMS input related to plant canopy USR.cascade.param PRMS input for cascade module USR.DATA PRMS data file with observed streamflow, and temperature and precipitation USR.dims.param PRMS dimensions USR.disc.param PRMS discretization information USR.gsflow.param GSFLOW parameters USR.potET.param PRMS parameters for potential evapotranspiration USR.precipT.param PRMS paramters for precipitation and temperature USR.prmsOP.param PRMS output control USR.rain_adj.param PRMS parameters for rain distribution USR.runoff.param PRMS parameters for runoff USR.snow.param PRMS parameters for snow USR.snow_adj.param PRMS parameters for snow distribution USR.soilzone.param PRMS soil zone parameters USR.solar.param PRMS solar radiation paramters USR_gsflow.bat batch file for executing model USR_gsflow.control GSFLOW control file USRMF.bas MODFLOW basic input file USRMF.dis MODFLOW discretization input file USRMF.gag MODFLOW gage input file USRMF.nam MODFLOW name input file USRMF.NWT MODFLOW NWT input file USRMF.oc MODFLOW output control file USRMF.sfr MODFLOW stream (SFR) input file USRMF.upw MODFLOW hydraulic properties input file USRMF.uzf MODFLOW unsaturated zone properties input file USRMF.wel MODFLOW pumping input file (only used in IrrCurrent and IrrGW models) Scenario Model subdirectory -------------- -------------------- PreIrr natural conditions modelPreIrr\ IrrCurrent current irrigation modelIrrCurrent\ IrrGW hypothetical groundwater irrigation modelIrrGW\ ZIP Files: ---------- model.zip modelPreIrr\ Description: ----------- This directory contains the GSFLOW input files used for the pre-irrigation (PreIrr) natural conditions scenario documented in Essaid and Caldwell (2017) (doi: https://doi.org/10.1016/j.scitotenv.2017.04.205). modelIrrCurrent\ Description: ----------- This directory contains the GSFLOW input files used for the current irrigation practices (IrrCurrent) scenario documented in Essaid and Caldwell (2017) (doi: https://doi.org/10.1016/j.scitotenv.2017.04.205). modelIrrGW\ Description: ----------- This directory contains the GSFLOW input files used for the hypothetical groundwater irrigation (IrrGW) scenario documented in Essaid and Caldwell (2017) (doi: https://doi.org/10.1016/j.scitotenv.2017.04.205). output\ Description: ----------- This directory contains the output files for the three scenarios documented in Essaid and Caldwell (2017) (doi: https://doi.org/10.1016/j.scitotenv.2017.04.205). The files are: gsflow.csv GSFLOW comma-separated-values file reporting flows and volumes of various flow components (see Table 12 in ancillary\gsflow_doc\tm6d1_GSFLOW.pdf for explanation) gsflow.log GSFLOW run information gsflow.out GSFLOW budget prms_ic.out PRMS output of select variables USR_prms.out PRMS output file USRMF.bsf2 MODFLOW stream network output USRMF.bud MODFLOW cell-by-cell budget file USRMF.fhd MODFLOW GW head output USRMF.lst MODFLOW output file USRMFNF1.ggo MODFLOW gage output at NF1 (see Figure 1 of Essaid and Caldwell (2017) for location) USRMFo1.uzf MODFLOW unsaturated zone mass balance USRMFout.ggo MODFLOW gage output at the model outflow (see Figure 1 of Essaid and Caldwell (2017) for location) USRMFSF1.ggo MODFLOW gage output at SF1 (see Figure 1 of Essaid and Caldwell (2017) for location) USRMFSF2.ggo MODFLOW gage output at SF2 (see Figure 1 of Essaid and Caldwell (2017) for location) USRMFSF3.ggo MODFLOW gage output at SF3 (see Figure 1 of Essaid and Caldwell (2017) for location) USRMFSR1.ggo MODFLOW gage output at SR1 (see Figure 1 of Essaid and Caldwell (2017) for location) USRMFSR2.ggo MODFLOW gage output at SR2 (see Figure 1 of Essaid and Caldwell (2017) for location) Scenario Output subdirectory -------------- -------------------- PreIrr natural conditions output\output.modelPreIrr\ IrrCurrent current irrigation output\output.modelIrrCurrent\ IrrGW hypothetical groundwater irrigation output\output.modelIrrGW\ ZIP Files: ---------- None output.modelPreIrr\ Description: ----------- Simulation results for the PreIrr scenario. ZIP Files: ---------- output.modelPreIrr.zip output.modelIrrCurrent\ Description: ----------- Simulation results for the IrrCurrent scenario. ZIP Files: ---------- output.modelIrrCurrent.zip output.IrrGW\ Description: ----------- Simulation results for the IrrGW scenario. ZIP Files: ---------- output.modelIrrGw.zip source\ Description: ----------- Source files for GSFLOW (v 1.2.0). ZIP Files: ---------- source.zip