Fisher, J.C., Bartolino, J.R., Wylie, A.H., Sukow, Jennifer, and McVay,
 Michael, 2016, Groundwater-flow model of the Wood River Valley aquifer system,
 south-central Idaho: U.S. Geological Survey Scientific Investigations Report
 2016-5080, 71 p., http://dx.doi.org/10.3133/sir20165080.

   05/25/2016 Model archive created.
   06/16/2016 Model archive update based on Watt, M.K. review of model archive.

--------------------------------------------------------------------------------

    SIR2016-5080/
        Description:
        -----------
        The underlying directories contain all of the input and output files for
        the simulation described in the report, processing scripts and datasets
        are bundled together in an R-package wrv, included in the package is the
        MODFLOW-USG (v 1.2.00) source code.

        Descriptions of the data in each subdirectory are given to facilitate
        understanding of this data release. File descriptions are provided for
        select files to provide additional information that may be of use for
        understanding this data release.

        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 model documentation report
        (http://dx.doi.org/10.3133/sir20165080) 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:

            http://dx.doi.org/10.5066/F7C827DT

        The model, along with pre- and post-processing tools, 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 text files. All other files
        are compressed into ZIP files at the subdirectory level. Decompress
        the ZIP files in the highest-level directory.

        File and folder structure
        -------------------------
        SIR2016-5080
        +-- ancillary
        |   +-- calibrated
        |       +-- animation (depth to water table)
        |           +-- css
        |               +-- *.css
        |           +-- images
        |               +-- *.png
        |           +-- js
        |               +-- *.js
        |           +-- water-table.html
        |       +-- model (raster data within the model extent)
        |           +-- csv
        |               +-- *.csv
        |           +-- kml
        |               +-- rasters.kmz
        |           +-- png
        |               +-- *.png
        |           +-- RDA
        |               +-- rasters.rda
        |           +-- tif
        |               +-- *.tif
        |   +-- modelgrid (shapefile showing active and inactive model cells)
        |       +-- grid.dbf
        |       +-- grid.prj
        |       +-- grid.shp
        |       +-- grid.shx
        |   +-- pest
        |       +-- wrv_mfusg.pst (PEST input control file)
        |   +-- uncalibrated
        |       +-- animation (depth to water table)
        |           +-- css
        |               +-- *.css
        |           +-- images
        |               +-- *.png
        |           +-- js
        |               +-- *.js
        |           +-- water-table.html
        |       +-- data (raster data within the aquifer system extent)
        |           +-- csv
        |               +-- *.csv
        |           +-- kml
        |               +-- rasters.kmz
        |           +-- png
        |               +-- *.png
        |           +-- rda
        |               +-- rasters.rda
        |           +-- tif
        |               +-- *.tif
        |       +-- model (raster data within the model extent)
        |           +-- csv
        |               +-- *.csv
        |           +-- kml
        |               +-- rasters.kmz
        |           +-- png
        |               +-- *.png
        |           +-- rda
        |               +-- rasters.rda
        |           +-- tif
        |               +-- *.tif
        +-- bin (compiled code used in study)
        |   +-- mfusg.exe (MODFLOW-USG 64-bit executable)
        |   +-- wrv_1.0.0.zip (Windows binary installer for the R-package wrv)
        +-- georef (polygon shapefile showing the maxiumum model extent,
        |           active and inactive model domains.)
        |   +-- sir2016_5080.dbf
        |   +-- sir2016_5080.prj
        |   +-- sir2016_5080.shp
        |   +-- sir2016_5080.shx
        +-- model (model input files)
        |   +-- model1
        |       +-- hk1.ref (hydraulic conductivity in model layer 1)
        |       +-- hk2.ref (hydraulic conductivity in model layer 2)
        |       +-- hk3.ref (hydraulic conductivity in model layer 3)
        |       +-- ss1.ref (storage coefficient in model layer 1)
        |       +-- ss2.ref (storage coefficient in model layer 2)
        |       +-- ss3.ref (storage coefficient in model layer 3)
        |       +-- usgs.model.reference (data to register the model in
        |                                 space and time)
        |       +-- wrv_mfusg.ba6 (MODFLOW basic package)
        |       +-- wrv_mfusg.dis (MODFLOW discretization data)
        |       +-- wrv_mfusg.drn (MODFLOW drain package)
        |       +-- wrv_mfusg.lpf (MODFLOW layer-property flow package)
        |       +-- wrv_mfusg.nam (MODFLOW names of model input and output files)
        |       +-- wrv_mfusg.oc  (MODFLOW output control options)
        |       +-- wrv_mfusg.riv (MODFLOW river package)
        |       +-- wrv_mfusg.sms (MODFLOW sparse-matrix solver package)
        |       +-- wrv_mfusg.wel (MODFLOW well package)
        +-- output (model output files)
        |   +-- output.model1
        |       +-- wrv_mfusg.bud (MODFLOW budget data)
        |       +-- wrv_mfusg.hds (MODFLOW hydraulic head data)
        |       +-- wrv_mfusg.lst (MODFLOW run listing)
        +-- source (source code used in this study)
        |   +-- wrv_1.0.0.tar.gz (R-package wrv source code)
        +-- modelgeoref (model geo-reference information)
        +-- readme.txt

        File Formats
        ------------
        All digital data are stored using open file formats. "An open format is
        one that is platform independent, machine readable, and made available
        to the public without restrictions that would impede the re-use of that
        information" (Open Government Directive, M10-06).

        |Extension |Type   |Description                                |
        |----------|-------|-------------------------------------------|
        |          |text   |Plain text                                 |
        |.ba6      |text   |MODFLOW                                    |
        |.bat      |text   |Script file containing commands to execute |
        |.bud      |binary |MODFLOW                                    |
        |.css      |text   |Cascading Style Sheets                     |
        |.csv      |text   |Comma-Separated Values                     |
        |.dis      |text   |MODFLOW                                    |
        |.dbf      |binary |Shapefile                                  |
        |.drn      |text   |MODFLOW                                    |
        |.exe      |binary |Windows executable file                    |
        |.hds      |binary |MODFLOW                                    |
        |.html     |text   |Hyper Text Markup Language                 |
        |.js       |text   |Javascript Language                        |
        |.kml      |text   |Keyhole Markup Language                    |
        |.lpf      |text   |MODFLOW                                    |
        |.lst      |text   |MODFLOW                                    |
        |.nam      |text   |MODFLOW                                    |
        |.oc       |text   |MODFLOW                                    |
        |.png      |binary |Portable Network Graphics                  |
        |.prj      |text   |Shapefile                                  |
        |.pst      |text   |PEST input control file                    |
        |.rda      |binary |Serialized versions of R objects           |
        |.ref      |text   |Reference data                             |
        |.riv      |text   |MODFLOW                                    |
        |.shp      |binary |Shapefile                                  |
        |.shx      |binary |Shapefile                                  |
        |.sms      |text   |MODFLOW                                    |
        |.tar.gz   |binary |R-package source code and datasets         |
        |.tif      |binary |Geo-referenced Tagged Image File Format    |
        |.txt      |text   |Plain text                                 |
        |.wel      |text   |MODFLOW                                    |
        |.zip      |binary |Compiled R package for Windows             |

        System requirements
        -------------------
        MODFLOW-USG 1.2.00 (2014-03-21)
        PEST 13.0 (2013-05-01)

        R version 3.3.0 (2016-05-03)
        Platform: x86_64-w64-mingw32/x64 (64-bit)
        Running under: Windows 10 x64 (build 10586)

        locale:
        [1] LC_COLLATE=English_United States.1252
        [2] LC_CTYPE=English_United States.1252
        [3] LC_MONETARY=English_United States.1252
        [4] LC_NUMERIC=C
        [5] LC_TIME=English_United States.1252

        attached base packages:
        [1] stats     graphics  grDevices utils     datasets  methods
        [7] base

        other attached packages:
        [1] wrv_1.0.0    raster_2.5-8 rgdal_1.1-10 sp_1.2-3

        loaded via a namespace (and not attached):
         [1] Rcpp_0.12.5      lattice_0.20-33  dplyr_0.4.3
         [4] assertthat_0.1   grid_3.3.0       R6_2.1.2
         [7] xtable_1.8-2     DBI_0.4-1        magrittr_1.5
        [10] lazyeval_0.2.0   tools_3.3.0      igraph_1.0.1
        [13] sfsmisc_1.1-0    parallel_3.3.0   colorspace_1.2-6
        [16] rgeos_0.3-19     animation_2.4    knitr_1.13

        Running the model:
        ------------------
        On a Windows 10 x64 OS (or similar build), open a command-prompt
        window in the ./model/model1 folder. Run the groundwater-flow model by
        initiating MODFLOW-USG from the command prompt using the following
        command:

            ../../bin/mfusg.exe "wrv_mfusg.nam"

        Be forewarned that this command will overwrite any existing model output
        files.

        Instructions for processing (optional)
        --------------------------------------
        The set of instructions for processing the groundwater flow model can be
        run on multiple platforms (Windows, OS X, Linux). All processing
        programs are classified as Free and Open-Source Software (FOSS). With
        the exception of "model calibration", processing instructions are
        implemented in R, a programming language and computing environment.
        In R, the primary mechanism for sharing with others is the package.
        A package bundles together computer code, data, and documentation using
        a common format. While R comes with a set of default packages, model
        processing requires that many other packages be added to extend the
        capabilities of R. Because packages get updated all the time, it may be
        necessary to recreate an identical R environment where all your packages
        are consistent with package versions documented in this README file. To
        recreate the R environment as it existed when this model archive was
        built, first download and install R version 3.3.0 (2016-05-03) from a
        snapshot of the Comprehensive R Archive Network (CRAN).

        Open an R session and install user-contributed R packages from the CRAN
        snapshot by typing the following commands:

            repo <- "https://mran.revolutionanalytics.com/snapshot/2016-06-15/"
            pkgs <- c("sp", "rgdal", "raster", "methods", "rgeos", "igraph",
                    "dplyr", "RCurl", "knitr", "xtable", "sfsmisc",
                    "animation", "viridis", "colorspace")
            install.packages(pkgs, repos = repo, type = "both")

        Install the R-package wrv from a distribution file contained within
        the data release. Specify the absolute path to the model archive folder
        below (change "path" as needed).

            path <- ""  # construct using forward slash separators
            if (.Platform$OS.type == "windows") {
              file <- file.path(path, "bin/wrv_1.0.0.zip")
            } else {
              file <- file.path(path, "source/wrv_1.0.0.tar.gz")
            }
            install.packages(file, repos = NULL)

        Load the wrv package into the current R session:

            library(wrv)

        Access the wrv package documentation:

            help(package = "wrv")

        Open appendix A and follow the step-by-step instructions.

            vignette("package-introduction", package = "wrv")

        Web-based data storage
        ----------------------
        Source code and datasets are stored in the wrv-package repository; its
        contents are available on GitHub from:

            https://github.com/USGS-R/wrv

        GitHub is a web-based distributed revision control system. The only
        dataset not included in the wrv-package repository is the pre-processed
        topographic base map data for the study area. These data are part of the
        National Elevation Dataset and accessible through the National Map
        Viewer from:

            http://viewer.nationalmap.gov/viewer/