Hughes, J.D., and White, J.T., 2014, Hydrologic conditions in urban Miami- Dade County, Florida, and the effect of groundwater pumpage and increased sea level on canal leakage and regional groundwater flow: U.S. Geological Survey Scientific Investigations Report 2014–5162, 175 p., http://dx.doi.org/10.3133/sir20145162. 07/28/2014 Model archive created 08/11/2014 Model archive update based on Swain, E.D. review of model archive. 09/24/2014 Model archive update with final information for SIR (2014-5162) 05/03/2014 Model archive updated to conform to the structure specified for public release of groundwater flow and transport models. --------------------------------------------------------------------------------- SIR2014-5162/ Description: ----------- The underlying directories contain all of the input and output files for the simulations described in the report, preprocessing python scripts, cluster_repo source code, MODFLOW-NWT (v 1.0.8) source code with the General Finite-Difference (GFD) boundary condition package, and ZONEBUDGET (v 3.01) source code. Descriptions of the data in each subdirectory are given to facilitate understanding of this data release. Files 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 a modified version of MODFLOW-NWT (v 1.0.8). Modifications were limited to the addition of the General Finite Difference (GFD) Package that is used to apply rainfall, irrigation, and septic returns in the model. ZONEBUDGET (v 3.01) has been modified to facilitate use of the python post-processing script provided in the ancillary/python subdirectory. The source code for both MODFLOW-NWT and ZONEBUDGET has been included in 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/sir20145162) 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/F79P2ZRH 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 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 starting with "model" should be unzipped in the same manner as the other zip files but should be placed within a "model" subdirectory created at the same level as the "georef" subdirectory. Similarly, the zip files with names starting with "output" should be unzipped in the same manner as other zip files but should be placed within a "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: SIR2014-5162/ ancillary/ bin/ georef/ model/ output/ source/ 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 MD_mfnwt_x64.exe executable in the bin zip file in this data release. MD_mfnwt_x64.exe was compiled using the Intel(R) Visual Fortran 64-bit compiler (version 14.0.0092.11) for Windows and the Visual C++ 2012 compiler. The models requires approximately 60 MB of available Random Access Memory (RAM). The models have been run successfully on computers running the following Windows operating systems (OS): o 64-bit Windows 7 OS (Service Pack 1) o 64-bit Windows Server 2008 HPC OS (Service Pack 1) o 64-bit Windows Server 2012 R2 Standard The source code has also been successfully compiled using the gfortran compiler and run on computers using the Mac OS X Mavericks (10.9) and SUSE Linux operating systems. Optional system requirements: ----------------------------- Python 2.7 or 3.4 and the Numpy, Scipy, matplotlib, ElementTree, and the cluster_repo packages need to be installed in order to use the post- processing scripts included in the python\ subdirectory in the ancillary directory. The cluster_repo package is a custom package and has been included in code\cluster_repo. The python post-processing scripts have been included for convenience and are not required to post-process model results. The calibration model and 4 scenarios can be post-processed using standard MODFLOW or 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: ../../bin/MD_mfnwt_x64.exe model.nam For example, the calibration/verification simulation can be run by opening a terminal in the model/calibration/ subdirectory and typing ../../bin/MD_mfnwt_x64.exe UMD_fb.nam to run the calibration/verification simulation. The other simulations can be run in a similar fashion by replacing "UMD_fb.nam" with the appropriate scenario simulation MODFLOW-NWT name files and running from the appropriate subdirectory in the model/ subdirectory (for example, run the current sea level scenario (UMD_Current.nam) from the model/currentsl/ subdirectory). Possible name files are: 1. UMD_fb.nam 2. UMD_Current.nam 3. UMD_Current_SCEN01.nam 4. UMD_High.nam 5. UMD_High_SCEN01.nam The output from the calibration/verification and scenario simulations all have the same name but are created in the appropriate output directory. For example, calibration/verification model results are saved to the output/output.calibration directory. ZONEBUDGET can be run by opening a command line/terminal in the model directory of interest and typing: ../../bin/ZoneBud_x64.exe < zbg.in ZONEBUDGET output is created in the appropriate output directory. For example, ZONEBUDET results for calibration/verification model are saved to the output/output.calibration directory. NOTE1: The models must be run using the MD_mfnwt_x64.exe executable in the bin directory created using the bin.zip file in this data release. The ZoneBud_x64.exe executable must be used to use the zone budget post-processing routines included in this data release. NOTE2: The files in the model\externalfiles\ directory contained in the model.externalfiles zip file are required to run the models. NOTE3: Python 2.7 to 3.5 and the Numpy, Scipy, matplotlib, ElementTree, and the cluster_repo packages need to be installed in order to use the post-processing scripts included in the python\ subdirectory in ancillary.zip. The cluster_repo package is a custom package and has been included in code\cluster_repo directory in source.zip. The python post-processing scripts have been included for convenience and are not required to post-process model results. Model results in this data release can be post-processed using standard MODFLOW or user- preferred post-processing utilities. 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: ----------- This directory contains a ancillary data including a directory with python scripts for post-processing model input and output along with resulting postprocessed results. The directory also includes GIS data used to generate figures and sensitivity and scenario datasets. ZIP Files: ---------- ancillary.zip bin/ Description: ----------- Executable files used to run the calibration/verification model and all scenarios documented in the report (doi: 10.3133/sir20145162). These executables were compiled for the 64-bit Windows 7 and Windows Server 2008 HPC Operating Systems. See README.txt in bin\ directory for more information. ZIP Files: ---------- bin.zip georef/ Description: ----------- This directory contains a shapefile defining the active and inactive areas of the model documented in the report. doi: 10.3133/sir20145162 ZIP Files: ---------- georef.zip model/ Description: ----------- This directory contains all of the input files for the calibration/verification run and the 4 scenario runs documented in the report. doi: 10.3133/sir20145162 Scenario Model subdirectory -------------- -------------------- base future conditions currentsl\ increased pumpage currentsl_scen01\ increased sea level highsl\ increased pumpage and sea level highsl_scen01\ ZIP Files: ---------- None calibration/ Description: ----------- This directory contains the calibration/verification name file and several MODFLOW input files used to make the calibration/verification run documented in the report. doi: 10.3133/sir20145162 ZIP Files: ---------- model.calibration.zip currentsl/ Description: ----------- This directory contains the current sea level scenario name file used to make the current sea level run documented in the report. doi: 10.3133/sir20145162 ZIP Files: ---------- model.currentsl.zip currentsl_scen01/ Description: ----------- This directory contains the current sea level with modified pumpage scenario name file used to make the current sea level with modified pumpage run documented in the report. doi: 10.3133/sir20145162 ZIP Files: ---------- model.currentsl_scen01.zip externalfiles/ Description: ----------- This directory contains external files used by the models documented in the report. doi: 10.3133/sir20145162 ZIP Files: ---------- model.externalfiles.zip highsl/ Description: ----------- This directory contains the high sea level scenario name file used to make the high sea level run documented in the report. doi: 10.3133/sir20145162 ZIP Files: ---------- model.highsl.zip highsl_scen01/ Description: ----------- This directory contains the high sea level with modified pumpage scenario name file used to make the high sea level with modified pumpage run documented in the report. doi: 10.3133/sir20145162 ZIP Files: ---------- model.highsl_scen01.zip output/ Description: ----------- This directory contains all of the output files for the calibration/verification run and the 4 scenario runs documented in the report. doi: 10.3133/sir20145162 Scenario Output subdirectory -------------- -------------------- base future conditions output\output.currentsl\ increased pumpage output\output.currentsl_scen01\ increased sea level output\output.highsl\ increased pumpage and sea level output\output.highsl_scen01\ ZIP Files: ---------- None output.calibration/ Description: ----------- Simulated results for the calibration/verification simulation. ZIP Files: ---------- output.calibration.gwfcbc.zip output.calibration.gwfhds.zip output.calibration.swizta.zip output.calibration.swrqaq.zip output.calibration.zip output.currentsl/ Description: ----------- Simulated results for the current sea level scenario. ZIP Files: ---------- output.currentsl.gwfcbc.zip output.currentsl.gwfhds.zip output.currentsl.swizta.zip output.currentsl.zip output.currentsl_scen01/ Description: ----------- Simulated results for the current sea level with modified pumpage scenario. ZIP Files: ---------- output.currentsl_scen01.gwfcbc.zip output.currentsl_scen01.gwfhds.zip output.currentsl_scen01.swizta.zip output.currentsl_scen01.zip output.highsl/ Description: ----------- Simulated results for the high sea level scenario. ZIP Files: ---------- output.highsl.gwfcbc.zip output.highsl.gwfhds.zip output.highsl.swizta.zip output.highsl.zip output.highsl_scen01/ Description: ----------- Simulated results for the high sea level with modified pumpage scenario. ZIP Files: ---------- output.highsl_scen01.gwfcbc.zip output.highsl_scen01.gwfhds.zip output.highsl_scen01.swizta.zip output.highsl_scen01.zip source/ Description: ----------- Source files for non-standard code versions used to run model simulations included in the model data release. The cluster_repo python package has also been included because several of the python post-processing scripts use the functionality in cluster_repo classes and methods. In particular, the classes and methods in shapefile.py and pestUtil.py are used. cluster_repo requires NumPy 1.9 or higher and pandas 0.15.2 or higher. ZIP Files: ---------- source.zip