Gingerich, S.B., Voss, C.I, and Johnson, A.D., 2017, Seawater-flooding events and impact on freshwater lenses of low-lying islands: controlling factors, basic management and mitigation https://dx.doi.org/10.1016/j.jhydrol.2017.03.001 02/14/2017 Model archive created --------------------------------------------------------------------------------- / Description: ----------- The underlying directories contain all of the input and output files for the simulations described in the paper, post-processing python scripts, and SUTRA 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. The model simulations were run with two versions of SUTRA (v 2.2). Modifications were limited adding the ability to read tides as a time-varying boundary condition and to include the use of a water table without unsaturated flow calculations The source codes for both versions have been included in this data release. Users are encouraged to review the paper (https://dx.doi.org/10.1016/j.jhydrol.2017.03.001) 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/F7736P3Q The models, along with 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 likelihood of download timeouts. Small files (including, readme.txt and modelgeoref.txt) are available as uncompressed files. All other files are zipped at the file level. All zip files should be unzipped into a directory with the same name as the zip file name without the .7z extension. The highest-level directory structure of the original data release is: Gingerich_others_JofHyd_2017/ bin/ georef/ model/ output/ source/ webrelease/ The full directory structure of the data release and the zip files associated with each subdirectory are listed below. You must create this directory structure on your computer in order for file paths to work correctly. Otherwise, you will need to change the paths in the .bat and SUTRA.FIL files to the directory structure you prefer. System requirements: -------------------- The models contained in this data release were run using the sutratide.exe or sutrawt_2_2.exe executable in the bin file in this data release. The .exe programs were compiled using the Intel(R) Visual Fortran 64-bit compiler for Windows. Optional system requirements: ----------------------------- Python 2.7 or 3.4 and Numpy and matplotlib need to be installed in order to use the post- processing script included in the source\PostProcessing\Python_Script subdirectory. The python post- processing scripts have been included for convenience and are not required to post-process model results. The calibration model and scenarios can be post-processed using user-preferred post-processing utilities. Running the model(s): --------------------- The simulations can be run by opening a command line/terminal in the model directory of interest and typing: runsutra.bat The output from the calibration and scenario simulations are created in the appropriate output directory. For example, calibration/verification model results are saved to the corresponding output/ directory. 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. bin/ SUTRA_tides/ SUTRA_WT/ This directory contains the compiled executables for the numerical models used in the study georef/ This directory contains one shapefile with polygons showing the active extent of the model domain. model/ The SUTRA model input data set is broken up into files described below: 1. RUNSUTRA.BAT batch file to run sutratide.exe (or sutrawt_2_2.exe) 2. SUTRA.FIL control file for all input and output file names 3. XXX.inp main input file for SUTRA 4. XXX.ics or XXX.rst initial conditions of pressure and concentration 5. XXX.mmb file In some cases this is the file used in ARGUS ONE with SUTRAGui to generate the input files. Disclaimer: Links and other references to non-USGS products and services are provided for information only and do not constitute endorsement or warranty, express or implied, by the USGS, U.S. Department of the Interior (USDOI), or U.S. Government, as to their suitability, content, products, or services, whether they are governmental, educational, or commercial. SS_Calibrated/ usgs.model.reference roi_ss.inp roi_ss.ics SUTRA.FIL RUNSUTRA.BAT roi_ss.mmb Washover/ usgs.model.reference roi_sourcewashover_dec08.inp roi_sourcewashover_dec08.ics SUTRA.FIL RUNSUTRA.BAT Roi_sourcewashover_dec08.mmb Recovery_calibrated/ (called managed recovery in paper) usgs.model.reference recovery_calibrated.inp roi_sourcewashover_dec08.rst 2009_1linewells.bcs SUTRA.FIL RUNSUTRA.BAT roi_basecase.mmb Average_stress/ usgs.model.reference average.inp roi_sourcewashover_dec08.rst 2009_average.bcs SUTRA.FIL RUNSUTRA.BAT Undisturbed_recovery/ usgs.model.reference 2009_nosources.inp roi_sourcewashover_dec08.rst SUTRA.FIL RUNSUTRA.BAT Recovery_wout_artificial_recharge/ usgs.model.reference recovery_noart.inp roi_sourcewashover_dec08.rst 2009_noArt.bcs SUTRA.FIL RUNSUTRA.BAT Recovery_wout_withdrawal/ usgs.model.reference recovery_nowithdrawal.inp roi_sourcewashover_dec08.rst 2009_NoPump.bcs SUTRA.FIL RUNSUTRA.BAT Recovery_after_wetseason/ usgs.model.reference recovery_wet.inp roi_sourcewashover_dec08.rst 2009_july.bcs SUTRA.FIL RUNSUTRA.BAT No_washover/ usgs.model.reference nowash.inp roi_sourcewashover_dec08.ics 2009_1linewells.bcs SUTRA.FIL RUNSUTRA.BAT No_wash_No_art/ usgs.model.reference nowash_noart.inp roi_sourcewashover.dec08.ics 2009_noArt.bcs SUTRA.FIL RUNSUTRA.BAT output/ contains SUTRA output files. The following output files were generated: 1. XXX.lst main SUTRA output file 2. XXX.nod ascii file of nodewise pressure, concentration, and saturation at selected time steps 3. XXX.ele ascii file of elementwise velocities at selected time steps 4. XXX.smy ascii file of iteration data for each time step 5. XXX_Timed_Obs.obs ascii file of observation well data (note that this filename is changed slightly from that specified in the SUTRA.FIL 6. XXX.rst ascii file of pressure and concentration data available for restart 7. cl_time.dat ascii file of time and concentration data for plotting, this is output from python script "SUTRA_node_extractor.py" which extracts from XXX.nod file SS_Calibrated/ roi_ss.lst roi_ss.nod roi_ss.ele roi_ss.rst roi_ss.smy roi_ss_Timed_Obs.obs Washover/ roi_sourcewashover_dec08.lst roi_sourcewashover_dec08.nod roi_sourcewashover_dec08.ele roi_sourcewashover_dec08.rst roi_sourcewashover_dec08.smy roi_sourcewashover_dec08_Timed_Obs.obs cl_time.dat Recovery_calibrated/ roi_sourcewashover_2yr.lst roi_sourcewashover_2yr.nod roi_sourcewashover_2yr.ele roi_sourcewashover_2yr.rst roi_sourcewashover_2yr.smy roi_sourcewashover_2yr_Timed_Obs.obs cl_time.dat Average_stress/ roi_sourcewashover_2yr.lst roi_sourcewashover_2yr.nod roi_sourcewashover_2yr.ele roi_sourcewashover_2yr.rst roi_sourcewashover_2yr.smy roi_sourcewashover_2yr_Timed_Obs.obs cl_time.dat Undisturbed_recovery/ roi_sourcewashover_2yr.lst roi_sourcewashover_2yr.nod roi_sourcewashover_2yr.ele roi_sourcewashover_2yr.rst roi_sourcewashover_2yr.smy roi_sourcewashover_2yr_Timed_Obs.obs cl_time.dat Recovery_wout_artificial_recharge/ roi_sourcewashover_2yr.lst roi_sourcewashover_2yr.nod roi_sourcewashover_2yr.ele roi_sourcewashover_2yr.rst roi_sourcewashover_2yr.smy roi_sourcewashover_2yr_Timed_Obs.obs cl_time.dat Recovery_wout_withdrawal/ roi_sourcewashover_2yr.lst roi_sourcewashover_2yr.nod roi_sourcewashover_2yr.ele roi_sourcewashover_2yr.rst roi_sourcewashover_2yr.smy roi_sourcewashover_2yr_Timed_Obs.obs cl_time.dat Recovery_after_wetseason/ roi_sourcewashover_2yr.lst roi_sourcewashover_2yr.nod roi_sourcewashover_2yr.ele roi_sourcewashover_2yr.rst roi_sourcewashover_2yr.smy roi_sourcewashover_2yr_Timed_Obs.obs cl_time.dat No_washover/ roi_sourcewashover_2yr.lst roi_sourcewashover_2yr.nod roi_sourcewashover_2yr.ele roi_sourcewashover_2yr.rst roi_sourcewashover_2yr.smy roi_sourcewashover_2yr_Timed_Obs.obs cl_time.dat No_wash_No_art/ roi_sourcewashover_2yr.lst roi_sourcewashover_2yr.nod roi_sourcewashover_2yr.ele roi_sourcewashover_2yr.rst roi_sourcewashover_2yr.smy roi_sourcewashover_2yr_Timed_Obs.obs cl_time.dat source/ SUTRA_tides/ contains fortran files for SUTRA with modifications for reading tide data externally at specified time steps and for an unsaturated condition with linear functions of saturation and permeability with pressure SUTRA_WT/ contains fortran files for SUTRA modified for a water-table condition by William R. Souza (modified code marked with WRS05052016) GW-chart/ contains executable USGS program for reading observation well data Python_Script/ contains python script to read the XXX.nod file and produce a plot of equivalent chloride concentration over time for the nodes representing the airfield skimming well webrelease/ This directory contains the FGDC XML metadata file which describes the whole model archive and the browse graphic used for display