\sir2018-5055\readme.txt ================================================================================ Citation for this data release: Sepúlveda, N., 2018, MODFLOW-NWT Data Sets for Simulation of Effects of Surface-Water and Groundwater Inflows and Outflows on the Hydrology of the Tsala Apopka Lake Basin in Citrus County, Florida: U.S. Geological Survey data release, available at https://doi.org/10.5066/F7QF8RS2. Citation for associated U.S. Geological Survey (USGS) information product: Sepúlveda, N., Fulkerson, M., Basso, R., and Ryan, P.J., 2018, Effects of Surface-Water and Groundwater Inflows and Outflows on the Hydrology of the Tsala Apopka Lake Basin in Citrus County, Florida: U.S. Geological Survey Scientific Investigations Report 2018–5055, 137 p., https://doi.org/10.3133/sir20185055. ================================================================================ 08/21/17 Model archive created 08/28/17 Sent for OGW review 08/28/17 Sent to Water Science Field Team for Review ================================================================================ SIR2018-5055/ Description: A surface-water/groundwater flow model for the Tsala Apopka Lake Basin was developed by the U.S. Geological Survey (https://doi.org/10.3133/sir20185055) to assess the effects that inflows and outflows in the Basin have on lake water levels, spring flows, and stream flows. One model data set is archived for this surface-water and groundwater flow model. Specified flows through the 8 water-control structures of the Tsala Apopka lake Basin, as estimated by SWFWMD, were used as input to simulate the flow through these 8 structures. MODFLOW-NWT, version 1.1.2, was the code used to run the calibrated model. MODFLOW-NWT computer code files can be downloaded from the following U.S. Geological Survey-Office of Groundwater website: https://water.usgs.gov/software/ground_water.html or found in or found in the ‘source’ directory. The underlying directories contain the report, all of the input and output files for the simulations described in the Scientific Investigations Report 2018-5055, model source code, the model executable, pre-processing files to generate model input files, running instructions, and post-processing files to analyze output. ================================================================================ Background Information: o This archive includes data sets for a transient, surface-water/groundwater flow model of the Tsala Apopka Lake Basin in Citrus County, Florida. o This investigation was completed for the Southwest Florida Water Management District. o The model was simulated using the USGS Office of Groundwater compiled version of MODFLOW-NWT Version 1.1.2 06/15/2017. o The LAKE (Lak7) package of MODFLOW-NWT was used to simulate the lakes in the Tsala Apopka Lake Basin in Citrus County, Florida. A shapefile of these lakes was included as an ArcGIS shapefile. o This archive does contain post-processing tools. The post-processing files are in two subdirectories: first, in the output/ directories to generate files ready to plot hydrographs for spring flows, stream flows and stages, well water levels, and lake stages, and second, in the ancillary/ZoneBudget directories to generate water budget flows for calibrated model and scenarios. 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.3133/sir2018-5055) to understand the purpose, construction, and limitations of this model. This archive is platform independent. However, the binary compiled version of the program in the bin folder is machine dependent (MF_NWT.exe). The simulations were conducted using MF_NWT.exe on a Dell Precision M6800 with Intel Xeon processors running Windows 10 Enterprise 64-bit operating system. Use of trade names are for descriptive purposes only and does not imply endorsement by the U.S. Government. The USGS is not obligated to provide executable code for all possible computational platforms. If the executable provided in this archive does not run on a specific platform, it is the obligation of the archive user to compile an executable from the provided source code, or to change input files in a manner that is necessary to execute, such as change relative path references in the TAL.nam input file. Simulation inputs and limitations are documented in USGS SIR 2018-5055 (https://doi.org/10.3133/sir20185055). Formats of simulation input and output are documented in USGS Techniques and Methods 6-A37 (Niswonger, R.G., Panday, S., and Ibaraki, M., 2011, MODFLOW-NWT, A Newton Formulation for MODFLOW-2005, Chapter 37 of Book 6. Modeling techniques, Section A. Groundwater). ================================================================================ Reconstructing the data release from the online data release files: ------------------------------------------------------------- This data release is available from: https://doi.org/10.5066/F7QF8RS2 The models 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 readme.txt and modelgeoref.txt are available as uncompressed files. All other files are zipped at the subdirectory level. The highest-level folder structure of the archive is: ancillary/ bin/ georef/ model/ output/ source/ with top level files: readme.txt is an ASCII .txt file that documents the archive structure and includes instructions to execute simulations. modelgeoref.txt is an ASCII .txt file that includes decimal degree latitude and longitude coordinates for simulation grid corners. ===================================================================================== ancillary/ -- The zipped directory has four subdirectories: /gis/ This subdirectory contains the shapefiles for (1) drainage delineation, (2) general-head boundaries, (3) lake cells, (4) lakes, (5) streams, (6) stream segments, (7) numerical grid of cells (polygons), and (8) numerical grid of center of cells (points). /excel_files/ This subdirectory contains the excel files associated with each one of the 8 dbf files for the shapefiles listed above. /pest/ has the input and output files for the code PEST (Parameter Estimation) that were used to calibrate the hydraulic parameters of the model. /ZoneBudget/ has the post-processing files needed to generate the water budget flows from output files TAL.cbc and TAL.uzfcbc. These two cbc files are not included in this data release because these two files have a combined size of over 110 GB. However, these two files can be generated by running the calibrated model and the scenarios. Post-processing file TAL_ZoneBudget.exe reads output ZoneBudget.dat, generated by zonbud.exe after reading TAL.cbc. TAL_ZoneBudget.exe tabulates the inflows and outflows for the three model layers using data from file ZoneBudget.dat. File readme.ZB_calibrated_model.txt has the instructions to complete the water budget calculations for the calibrated model, referred to in the report by the acronym HSIMU. /pre_processing_scripts/ has the pre-processing files needed to generate MODFLOW-NWT input files. Reading files from subdirectory model/externalfiles/, this subdirectory prints the following files in the same subdirectory model/externalfiles/: TAL.dis - discretization package TAL.bas - basic package TAL.oc - output control TAL.ghb - general-head boundary package TAL.drn - drain package (to simulate spring flow) TAL.lak7 - lake package TAL.lak7D - lake package file used when rainfall is decreased by 10 percent. TAL.lak7I - lake package file used when rainfall is increased by 10 percent. TAL.lknces - lake leakances by cell TAL.uzf1 - unsaturated zone flow package TAL.uzf1D - unsaturated zone flow package used when rainfall is decreased by 10 percent. TAL.uzf1I - unsaturated zone flow package used when rainfall is increased by 10 percent. TAL.sfr2 - streamflow routing package TAL.sfr2D - streamflow routing package used when rainfall is decreased by 10 percent. TAL.sfr2I - streamflow routing package used when rainfall is increased by 10 percent. bin/ -- The zipped directory contains the executable for MODFLOW-NWT Version 1.1.2, 06/15/2017, compiled by USGS for use on 64 bit personal computer running Windows 10 (MF_NWT.exe). georef/ --The zipped directory contains one shapefile with polygons showing the active and inactive extent of the model domain. Active and inactive areas are contained in shapefile sir20185055.shp, a polygon of the union of the contiguous active areas in layer 3. model/ -- The zipped directory contains the MODFLOW-NWT model input files required to run the calibrated model and the scenarios. Many of the input files are common to model and scenarios and thus were placed in subdirectory externalfiles/. o The calibrated run for the transient surface-water/groundwater flow simulation of the Tsala Apopka Lake Basin from 2004 to 2012 run requires the following input files: o RunMod.bat - batch file to run MODFLOW-NWT. This is a simple batch file that lists the executable and the nam file. o TAL.nam - This files lists the input files, most of them being referenced to subdirectory externalfiles/. o externalfiles/ In addition to the files listed above, which were generated in ancillary/pre-Processing_scripts, this directory contains: TAL.upw - upstream weighting package TAL.wel - well package TAL.nwt - Newton solver TAL.gag - relation between file units and gaging stations TAL.hob - head observations (measured heads and well grid coordinates) TAL.drob - measured spring flows TAL_ALL.drob - file that causes TAL.drobpr to print all simulated flows, including all stress periods for which there was no measured spring flow. LAKENO01.prn - This and the next files are lake stage, surface area, and volume tables, one for each of the 15 simulated lakes in the model. LAKENO02.prn LAKENO03.prn LAKENO04.prn LAKENO05.prn LAKENO06.prn LAKENO07.prn LAKENO08.prn LAKENO09.prn LAKENO10.prn LAKENO11.prn LAKENO12.prn LAKENO13.prn LAKENO14.prn LAKENO15.prn Q02312558.prn - This and the following files are specified flows through gages or simulated stations or structures in the model. QSEG06.prn QSEG08.prn Q02312772.prn Q02312786.prn Q02312815.prn Q02312827.prn QBryantSl.prn Q02312915.prn QS353.prn QVan_Ness.prn Q02312720.prn Q02312764.prn Q02313100.prn Q02313230.prn Q02313250.prn Q02312700.prn QSEG23.prn QSEG38.prn QSEG40.prn o NEXRAD/CELLRATES contains 3,288 daily rainfall rate files, in feet per day, for each day from January 1, 2004 to December 31, 2012. Each file has the daily rainfall rates for each grid cell. o RET/ with subdirectory CELLRATES with 3,288 daily reference evapotranspiration rate files, in feet per day, for each day from January 1, 2004 to December 31, 2012. Each file has the reference evapotranspiration rates for each grid cell. o Files used in the post-processing of files from output/ subdirectories and in the processing of water budget flows from directories ancillary/ZoneBudget: o DATES.prn - List of simulated dates and sequential day numbers o RAIN_2004.prn - Rainfall rates per cell for all days in 2004 to 2012 RAIN_2005.prn RAIN_2006.prn RAIN_2007.prn RAIN_2008.prn RAIN_2009.prn RAIN_2010.prn RAIN_2011.prn RAIN_2012.prn o RET_2004.prn - reference evapotranspiration rates per cell for all days in 2004 to 2012 RET_2005.prn RET_2006.prn RET_2007.prn RET_2008.prn RET_2009.prn RET_2010.prn RET_2011.prn RET_2012.prn o SpringPools.dat - Spring pool altitudes for each stress period o Springs.prn - Spring parameters for all springs o TAL.drob2 - Measured spring flows o TAL.hob2 - Measured water levels o TAL2025.wel - Projected groundwater pumping rates for 2025 o TAL2035.wel - Projected groundwater pumping rates for 2035 o TAL_KH1.ref - Array of calibrated hydraulic conductivities TAL_KH2.ref TAL_KH3.ref TAL_KZ1.ref TAL_KZ2.ref o TAL_Drainagepts.prn - Files read by output files for either calculating water budgets or post-preocessing output files in the output\ directories TAL_GHBpol.prn TAL_Lakecells.prn TAL_Lakes.prn TAL_Streams.prn TAL_Streamsegs.prn TAL_Wells.prn TALpol_KHKZ.prn TALpts.prn o usgs.model.reference which contains the following information: xul 268582.825238 # x-coordinate of the northernmost-westernmost corner of the simulation grid yul 1865027.10158 # y-coordinate of the northernmost-westernmost corner of the simulation rotation 15.00 # rotation of the simulation grid in degrees (positive clockwise) length_units feet # length unit of the simulation grid time_units days # time unit of the simulation: transient simulation start_date 01/01/2004 # state date of the simulation: transient simulation from 2008 to 2012 start_time 00:00:00.000 # start time of the simulation: transient simulation model MODFLOW-NWT # model type: MODFLOW-NWT Version 1.1.3 06/15/2017 epsg ESRI: 102659 # NAD 1983 StatePlane Florida West FIPS 0902 Feet o Subdirectories /model_NFCS, /model_NING, /model_P2025, /model_P2035, /model_RAIND, /model_RAINI have similar structure as the one in /calibrated_model and are the scenarios simulated using most of the calibrated model input files. output/ -- The zipped directory contains the model output for the groundwater flow simulation, in the subdirectory output_calibrated_model with MODFLOW output files: o TAL.heads - file with simulated heads in the three layers, printed at the end of each of the 108 months in the 2004 to 2012 period. o TAL.cbc - cell by cell flow term file - not included because of size limitations o TAL.hobpr - simulated heads at observation sites o TAL.drobpr - simulated spring flows at measured sites o TAL.lst - list output file source/ -- The zipped directory source\ contains Fortran source files used for the MODFLOW-NWT version 1.1.2 used in this study. In addition, ZoneBudget source files are included in subdirectory Zone_Budget/. ================================================================================