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/