Model Documentation Report: --------------------------- Masterson, J.P., Pope, J.P., Fienen, M.N., Monti, Jack, Jr., Nardi, M.R., and Finkelstein, J.S., 2016a, Documentation of a groundwater flow model developed to assess groundwater availability in the Northern Atlantic Coastal Plain aquifer system from Long Island, New York, to North Carolina: U.S. Geological Survey Scientific Investigations Report 2016-5076, xx p., http://dx.doi.org/10.3133/sir20165076. Model Results Report: --------------------- Masterson, J.P., Pope, J.P., Fienen, M.N., Monti, Jack, Jr., Nardi, M.R., and Finkelstein, J.S., 2016b, Groundwater availability of the northern Atlantic Coastal Plain aquifer system from Long Island, New York, to North Carolina: U.S. Geological Survey Professional Paper 1829, xx p., http://dx.doi.org/10.3133/pp1829. ---------------------------------------------------------------------------------------------------- Archive Revision History: ------------------------ 05/27/2016 Model archive created 06/24/2016 Model archive update based on Watt, M.K. review of archive 12/20/2016 Model archive updated: revised BAS package, changes to ibounds in layers 14 and 15 and the GHB file as shown in figures 7_N-O in SIR2016-5076 ----------------------------------------------------------------------------------------------------- SIR2016-5076/ DESCRIPTION: ----------- The underlying directories contain all of the input and output files for the simulations described in the report, MODFLOW-NWT (v1.0.8)source code, PEST source code and associated input data files for history matching, ZONEBUDGET source code and input files for the scenarios runs, and . Descriptions of the data in each subdirectory are given to facilitate understanding of this model archive. Files descriptions are provided for select files to provide additional information that may be of use for understanding this model archive. 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/sir20165076) to understand the purpose, construction, and limitations of this model. The analysis based on the scenario simulations are described in USGS Professional Paper 1829: (http://dx.doi.org/10.3133/pp1829) ----------------------------------------------------------------------------------------------------- Reconstructing the data release from the online data release: ------------------------------------------------------------- This data release is available from: http://dx.doi.org/10.5066/[to be completed] 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: \SIR2016-5076\ \ancillary\ Contains source 'calibration' and 'zonebud' subdirectories \bin\ Contains binary executeable files for MODFLOW-NWT, PEST, and ZONEBUD \georef\ Contains ArcGIS shapefile and exchange file of model grid \model\ Contains MODFLOW-NWT input files for the base case and 11 scenario models \output\ Contains MODFLOW-NWT output files for the base case and 11 scenario models \source\ Contains the source code files for MODFLOW-NWT_v1.08 and PEST_v13 The full directory structure of the data release and the files within each subdirectory are listed below. System requirements: -------------------- 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 Running the model(s): --------------------- MODFLOW-NWT MODELS: ------------------ To run the MODFLOW-NWT model, the user should copy the executable file 'MODFLOW-NWT.exe' from the 'bin' directory to the desired model input subdirectories of 'model' and open the '.exe', by double-clicking the file icon in Windows Explorer or by typing 'MODFLOW-NWT.exe' and pressing Enter/Return in a DOS window. A MODFLOW-NWT window will open and the user should enter the name file of the simulation to run, for example 'base.nam', and press Enter/Return. The models will run successfully only if the original directory structure is correctly restored. The model archive is broken into several pieces to reduce the likelihood 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 "model" subdirectory are zipped into a zip file named "model.zip". All zip files should be unzipped into a directory with the same name as the zip file name without the ".zip" extension. PEST: ----- PEST is run in a DOS window by entering "PEST NACP_final.pst". The output from the history-matching used in this analysis will be created in the 'calibration' subdirectory of 'ancillary'. ZONEBUDGET: ---------- ZONEBUDGET can be run by by opening a command line/terminal in the model directory of interest and typing: "Zonbud.exe Zonebudget_input_file". The "Zonebudget_input_file" must be inserted into each model directory of interest. Files: ----- readme.txt : This file which documents the structure of the data release. modelgeoref.txt : ASCII file with the four corners of the model domain. Model data files are in an Albers Equal Area Conic Projection with custom attributes (see file for details). ancillary/ Description: ----------- This directory contains the 'calibration' and 'zonebud' subdirectories. The 'calibration' subdirectory contains all the necessary files need to run PEST for the history-matching simulation and the 'zonebud' subdirectory includes all necessary files to run ZONEBUDGET in order to generate the information used in the analysis presented in Masterson and others (2016b) Content ancillary subdirectories ---------- ------------------------ PEST input files ancillary_calibration ZONEBUD input files ancillary_zonebud ZIP Files: --------- ancillary.zip ancillary_calibration Description: ----------- This subdirectory includes the final PEST calibration files used to develop the calibrated model datasets used in the final analysis. The PEST control file is "NACP_final.pst". PEST is run in a DOS window by entering "PEST NACP_final.pst" ZIP Files: --------- None ancillary_zonebud Description: ----------- This subdirectry includes the files required to generate the hydrologic budget charts and figures presented in Masterson and others (2016b). This subdirectory includes the following: (1) subdirectory: 'Zonbud_3_01', which includes the executable file, source code, and documentation for the Zone Budget computer program (Harbaugh, 1990, (2) Zonebudget_input_file: Input file required for Zonbud.exe, and (3)a Read_Me_Codes.txt file that provides an explanation of codes included in the "Zonebudget_input_file". ZIP Files: --------- None bin/ Description: ----------- This directory contains binary executeable files for MODFLOW-NWT, PEST, and ZONEBUD that were used for all of the analyses documented in the report (doi: 10.3133/sir20165076). ZIP Files: --------- bin.zip georef/ Description: ----------- This directory contains an ArcGIS shapefile defining the active and inactive areas of the model documented in the report. doi: 10.3133/sir20165076 ZIP Files: --------- georef.zip model/ Description: ----------- This directory contains contains all of the input files for the 'base' run and the 11 scenario runs documented in the report. doi: 10.3133/pp1829 Content Model subdirectories ---------- -------------------- calibrated model model_base scenario_1: no pumping/no wastewater returnflow model_ scen01 scenario_2: drought analysis (part a) model_scen02 scenario_3: drought analysis (part b) model_scen03 scenario_4: drought analysis (part c) model_scen04 scenario_5: constant recharge: SP13-35 model_scen05 scenario_6: sea-level rise analysis (part a) model_scen06 scenario_7: sea-level rise analysis (part b) model_scen07 scenario_8: wastewater returnflow analysis model_scen08 scenario_9: southern boundary analysis (part a) model_scen09 scenario_10: southern boundary analysis (part b) model_scen10 scenario_11: southern boundary analysis (part b) model_scen11 external_files: files common to all simulations model_external_files ZIP Files: --------- model.zip model_base Description: ----------- This directory contains the input files for the final calibrated model documented in the report. doi: 10.3133/sir20165076 ZIP Files: --------- None model_scen01 Description: ----------- This directory contains input files for no pumping and no wastewater returnflow. 'scen01' was compared to 'base' to analyze the effects of pumping on the changes to the hydrologic budget. The results of this analysis are documented in the report. doi: 10.3133/pp1829. ZIP Files: --------- None model_scen02 Description: ----------- This directory contains input files for drought analysis(a). The files in this subdirectory provided the base-line conditions for the drought analysis in the Delmarva area. The 8-yr period of interest was represented by stress periods 36-43. The results of this analysis are documented in the report. doi: 10.3133/pp1829. ZIP Files: --------- None model_scen03 Description: ----------- This directory contains input files for drought analysis(b). The files in this subdirectory provide the drought recharge with average pumping conditions for the drought analysis in the Delmarva area. The 8-yr period of interest was represented by stress periods 36-43. A comparison of the output from 'scen02' and 'scen03' is used to assess the effects of drought recharge on water levels and the hydrologic budget components. The results of this analysis are documented in the report. doi: 10.3133/pp1829. ZIP Files: --------- None model_scen04 Description: ----------- This directory contains input files for drought analysis(c). The files in this subdirectory provide the drought recharge with drought pumping conditions for the drought analysis in the Delmarva area. The 8-yr period of interest was represented by stress periods 36-43. A comparison of the output from 'scen03' and 'scen04' is used to assess the effects of increased pumping for irrigation during drought conditions on water levels and the hydrologic budget components. The results of this analysis are documented in the report. doi: 10.3133/pp1829. ZIP Files: --------- None model_scen05 Description: ----------- This directory contains input files that were used to examine the effects of changes in recharge on water levels throughout the aquifer system. The simulation included in this directory has an average annual recharge rate for the 1986-2013 period specified for stress periods 13-35. A comparison of water levels for these stress periods was made with the water levels calculated with annual varying recharge in the final calibrated model in the 'base' directory. The results of this analysis are documented in the report. doi: 10.3133/pp1829. ZIP Files: --------- None model_scen06 Description: ----------- This directory contains input files that were used for the analysis of the effects of changes in the sea-level boundary condition on water levels and the hydrologic budget throughout the aquifer system. This directory provides the base-line conditions (Part A) for a comparison of 100 yrs of an increased sea-level position. Stress period 45 was used for this comparison. The results of this analysis are documented in the report. doi: 10.3133/pp1829. ZIP Files: --------- None model_scen07 Description: ----------- This directory contains input files that were used for the analysis of the effects of changes in the sea-level boundary condition on water levels and the hydrologic budget throughout the aquifer system. This directory provides the increased sea-level position conditions (Part B) for comparison with the base-line conditions provided in the 'scen06'(Part A)directory. The results of this analysis are documented in the report. doi: 10.3133/pp1829. ZIP Files: --------- None model_scen08 Description: ----------- This directory contains input files for the pumping without wastewater returnflow condition. This scenario was compared to the 'base' condition to analyze the effects of removing wastewater returnflow (i.e. sewering)on changes to water levels and the hydrologic budget components. The results of this analysis are documented in the report. doi: 10.3133/pp1829. ZIP Files: --------- None model_scen09 Description: ----------- This directory contains input files for the analysis of the southern boundary condition(Part A). This analysis was conducted to determine the effects of the southern boundary in North Carolina has on model results in southern Virginia. Two boundary conditions were considered - a no-flow boundary which is used in the final calibrated('base')model and a specified-head boundary based on the model developed by Campbell and Coes (2010) for the Southern Atlantic Coastal Plain. This directory includes the files for the simulation of the no-flow boundary for a 50-yr long stress period (modified stress Period 27, year 2050) to be compared to the specified- head condition for the same duration ('scen11'). The results of this analysis are documented in the report doi: 10.3133/sir20165076. ZIP Files: --------- None model_scen10 Description: ----------- This directory contains input files for the analysis of the southern boundary condition(Part B). This analysis was conducted to determine the effects of the southern boundary in North Carolina has on model results in southern Virginia. This directory includes the files for the simulation of the specified-head boundary for the year 2000 (stress period 27)based on the model developed by Campbell and Coes (2010) for the Southern Atlantic Coastal Plain. Ouptut from this simulation was compared to that of the 'base' condition to determine the effects of the southern boundary condition on water levels in Virginia. The results of this analysis are documented in the report. doi: 10.3133/sir20165076. ZIP Files: --------- None model_scen11/ Description: ----------- This directory contains input files for the analysis of the southern boundary condition(Part C). This analysis was conducted to determine the effects of the southern boundary in North Carolina has on model results in southern Virginia. This directory includes the files for the simulation of the specified-head boundary based on the model developed by Campbell and Coes (2010) for the Southern Atlantic Coastal Plain.for a 50-yr long stress period (modified stress period 27, year 2050) to be compared to the no-flow condition for the same duration ('scen09') to determine the effects of the southern boundary condition on water levels in Virginia. The results of this analysis are documented in the report doi: 10.3133/sir20165076. ZIP Files: --------- None external_files Description: ----------- This directory contains contains external files used by the models documented in the report doi: 10.3133/sir20165076 ZIP Files: ---------- None output/ Description: ----------- This directory contains all of the output files for the 'base' simulation and the 11 scenario documented in reports doi: 10.3133/sir20165076 and doi: 10.3133/pp1829 Content output subdirectory ---------- ------------------ calibrated model output/output_base/ scenario_1: no pumping/no wastewater returnflow output/output_ scen01/ scenario_2: drought analysis (part a) output/output_scen02/ scenario_3: drought analysis (part b) output/output_scen03/ scenario_4: drought analysis (part c) output/output_scen04/ scenario_5: constant recharge: SP13-35 output/output_scen05/ scenario_6: sea-level rise analysis (part a) output/output_scen06/ scenario_7: sea-level rise analysis (part b) output/output_scen07/ scenario_8: wastewater returnflow analysis output/output_scen08/ scenario_9: southern boundary analysis (part a) output/output_scen09/ scenario_10: southern boundary analysis (part b) output/output_scen10/ scenario_11: southern boundary analysis (part b) output/output_scen11/ ZIP Files: ---------- None output_base/ Description: ----------- This directory contains the output files for the final calibrated model documented in the report. doi: 10.3133/sir20165076 ZIP Files: --------- output_base.zip output_scen01/ Description: ----------- This directory contains the output files for the scen01 simulation described above in 'model' ZIP Files: --------- output_scen01.zip output_scen02/ Description: ----------- This directory contains the output files for the scen02 simulation described above in 'model' ZIP Files: --------- output_scen02.zip output_scen03/ Description: ----------- This directory contains the output files for the scen03 simulation described above in 'model' ZIP Files: --------- output_scen03.zip output_scen04/ Description: ----------- This directory contains the output files for the scen04 simulation described above in 'Model' ZIP Files: --------- output_scen04.zip output_scen05/ Description: ----------- This directory contains the output files for the scen05 simulation described above in 'model' ZIP Files: --------- output_scen05.zip output_scen06/ Description: ----------- This directory contains the output files for the scen06 simulation described above in 'model' ZIP Files: --------- output_scen06.zip output_scen07/ Description: ----------- This directory contains the output files for the scen07 simulation described above in 'model' ZIP Files: --------- output_scen07.zip output_scen08/ Description: ----------- This directory contains the output files for the scen08 simulation described above in 'model' ZIP Files: --------- output_scen08.zip output_scen09/ Description: ----------- This directory contains the output files for the scen09 simulation described above in 'model' ZIP Files: --------- output_scen09.zip output_scen10/ Description: ----------- This directory contains the output files for the scen10 simulation described above in 'model' ZIP Files: --------- output_scen10.zip output_scen11/ Description: ----------- This directory contains the output files for the scen11 simulation described above in 'model' ZIP Files: --------- output_scen11.zip source/ Description: ----------- This directory contains the source code files for MODFLOW-NWT_v1.08 and PEST_v13 ZIP Files: --------- source.zip