------------------------------------------------------------- Publication: ------------------------------------------------------------- # Neff, B.P., and Rosenberry, D.O., 2018, Groundwater Connectivity of Upland-Embedded Wetlands in the Prairie Pothole Region: Wetlands: v. 38, no. 1, p. 51-63 https://doi.org/10.1007/s13157-017-0956-7 Data release: Neff, B.P., 2017, VS2DI model used to evaluate groundwater connectivity of wetlands in the Prairie Pothole Region, North Dakota: U.S. Geological Survey data release, https://doi.org/10.5066/F7K936FF 8/18/2017 Model archive created 8/25/2017 Model archive update based on internal USGS review 3/22/2018 Model archive updated to conform to the structure specified for public release of groundwater flow model ------------------------------------------------------------- Description: ------------------------------------------------------------- The underlying directories contain all of the input and output files for the simulations described in the report, the VS2DI (v 1.3) program, and the VS2DI (v 1.3) source code not including the graphical user interface (GUI). Descriptions of the data in each subdirectory are given below 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. The model simulations were run with the computer program VS2DI (v 1.3). 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 model documentation report (https://doi.org/10.1007/s13157-017-0956-7/) to understand the purpose, construction, and limitations of this model. ------------------------------------------------------------- Reconstructing the data release (groundwater flow models) from the online data release: ------------------------------------------------------------- This data release is available from: https://doi.org/10.5066/F7K936FF Two (2) small files are available as uncompressed files: readme.txt (this file) modelgeoref.txt All other files are contained in five (5) zipped directories: bin georef model output source ------------------------------------------------------------- Before you begin: ------------------------------------------------------------- The models will run from within the VS2DI (v 1.3) software, included in this distribution. As described in the corresponding publication (Neff and Rosenberry, 2018, https://doi.org/10.1007/s13157-017-0956-7/), four (4) model domains included in this data release are of 2D cross sections and do not depict a 3D area. The first two model domains used in this project are conceptual in nature and do not represent actual landscapes, the coordinates provided are of the USGS National Research Program offices in Lakewood, CO. The third landscape is intended to represent an idealized landscape common to the study area. The coordinates provided are of the entire study area. The fourth model is intended to duplicate a model domain first presented in Winter and Carr (1980), also occuring in our study area. According to Winter and Carr (1980) the transect extends from Robinson, ND eastward to the James River, crossing through the town of Woodworth, ND, through the modern-day Cottonwood Lake Study Area and terminating at the James River. Coordinates for that transect were not provided in Winter and Carr (1980), and most of the transect was depicted on Figure 3 in that publication. Coordinates given are the corners of the study area. Sources Cited Neff, B.P., and Rosenberry, D.O., 2018, Groundwater Connectivity of Upland-Embedded Wetlands in the Prairie Pothole Region: Wetlands: v. 38, no. 1, p. 51-63 https://doi.org/10.1007/s13157-017-0956-7 Winter, T. C. and M. R. Carr, 1980, Hydrologic setting of wetlands in the Cottonwood Lake area, Stutsman County, North Dakota: Geological Survey Water-Resources Investigations 80-99 1980: 42 p., 17 Fig., 3 Tab., 29 Ref. https://pubs.er.usgs.gov/publication/wri8099 ------------------------------------------------------------- System requirements ------------------------------------------------------------- The models contained in this data release were run using 64-bit Windows 7 (Service Pack 1) with VS2DI (v 1.3) installed, provided in the bin directory as described below. Other operating systems and versions of VS2DI may be acceptable. ------------------------------------------------------------- Working with zip files ------------------------------------------------------------- All zip files should be unzipped into a directory with the same name as the zip file name without the .zip extension. ------------------------------------------------------------- Running the model ------------------------------------------------------------- The model(s) must be run from within the VS2DI software, provided in this release. 1) Locate the VS2DI (v 1.3) software, vs2di_1_3_setup.exe, in the bin directory. Relocate this file to your machine. 2) Install VS2DI (v 1.3) on your machine by double clicking the vs2di_1_3_setup.exe file and following the prompts in the installer. 3) Locate the VS2DI software or a shortcut to open the VS2DI software on your computer. You may see links installed to open VS2DTI, VS2DHI, ReadMe, Postprocessor, and Uninstall. Open VS2DTI. 4) When you open the VS2DI software, the VS2DI preprocessor GUI opens automatically. 5) Open a model of your choosing by selecting file->open->navigate to and select desired model file->open 6) All aspects of the model setup can be viewed in the pre-processor. See the VS2DI (v 1.3) documentation for details, URL provided below. 7) Run the model: - select show->postprocessor [this will open the post processor in a new window and the model domain may appear in the GUI] - click on the 'play' button at the top-left of the postprocessor window to run the model. NOTE: When the model runs, it writes output files to the directory where the model file is located. You may want to first relocate the model file to a new, empty directory, and then run the model. 8) Model results may be viewed in the postprocessor GUI or by viewing the output files generated by the model. These will be located in the same directory where the model file is located. Description of these files is provided below. These files should also be identical to the files in the zipped output directory. Additional information on using the VS2DI (v 1.3) program can be accessed at: https://wwwbrr.cr.usgs.gov/projects/GW_Unsat/vs2di1.3/index.html. It is strongly recommended users familiarize themselves with using the VS2DI (v 1.3) program before attempting to work with the model files provided in this data release. ------------------------------------------------------------- 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. ------------------------------------------------------------- bin.zip ------------------------------------------------------------- This directory contains the executable file (VS2DI v 3.1 program) used to run the model and all scenarios documented in the report (Neff and Rosenberry, 2018; https://doi.org/10.1007/s13157-017-0956-7/). ------------------------------------------------------------- georef.zip ------------------------------------------------------------- This directory contains a shapefile defining the active areas of the model(s) documented in the report (Neff and Rosenberry, 2018; https://doi.org/10.1007/s13157-017-0956-7/). ------------------------------------------------------------- model.zip ------------------------------------------------------------- This directory contains 21 subdirectories, named to reflect the domain numbers and scenarios described in the report (Neff and Rosenberry, 2018; https://doi.org/10.1007/s13157-017-0956-7/). Within each subdirectory are two files: usgs.model.reference describes the model name and version, spatial and temporal orientation of the model and the units of measure used in the model. The other file is the VS2DI model file, named to match the subdirectory name. This file can only be opened from within the VS2DI program. ------------------------------------------------------------- output.zip ------------------------------------------------------------- This directory contains 21 subdirectories, named with the prefix 'Output." followed by the domain number and scenario described in the report (Neff and Rosenberry, 2018; https://doi.org/10.1007/s13157-017-0956-7/). When VS2DI runs, it automatically generates eight (8) output files, plus additional log files if an error is encountered and places them in the same directory as the model file. The 21 output subdirectories contain those output files for each of the 21 models. The 8 files are: fort.12 - file size 0, not used in this analysis. vs2dt.dat - model data file, which contains input data to the numerical model but is generated in the model output for future reference. vs2dt.fil - the namelist file, which contains the names of input and output files that to be opened by the numerical model. balance.out - the mass balance output file, which contains summaries of total flows and fluid balance for the simulation. file07.out - file size 0, not used in this analysis. obsPoints.out - file size 0, not used in this analysis. variables.out - contains limited and miscelaneous data on the simulation. vs2dt.out - primary 'output file,' which contains numerical data describing the results of the simulation. The function of these files and a description of their contents is contained in the VS2DI (v 1.3) documentation, available at: https://wwwbrr.cr.usgs.gov/projects/GW_Unsat/vs2di1.3/index.html. ------------------------------------------------------------- source.zip ------------------------------------------------------------- This directory contains the source code files for VS2DI (v 1.3). Note: The Java source code that implements the graphical interface is not included in this distribution. To obtain the Java source code, please contact Richard Healy by sending email to rwhealy@usgs.gov.