\sir2017-5141\readme.txt ========================================================================================== Citation for this data release: Sepulveda, Nicasio and Painter, Jaime, 2017, MODFLOW-2005 Simulation of Groundwater-Flow Budget for the Lower Apalachicola-Chattahoochee-Flint River Basin in Southwestern Georgia and Parts of Florida and Alabama, 2008–12: U.S. Geological Survey data release, available at https://doi.org/10.5066/F7DV1HCG. Citation for associated U.S. Geological Survey (USGS) information product: Jones, L.E., Painter, Jaime, LaFontaine, Jacob, Sepulveda, Nicasio, and Sifuentes, D.F., 2017, Groundwater-flow budget for the lower Apalachicola-Chattahoochee-Flint River Basin in southwestern Georgia and parts of Florida and Alabama, 2008–12: U.S. Geological Survey Scientific Investigations Report 2017–5141, 76 p., https://doi.org/10.3133/sir20175141. ========================================================================================== 08/01/17 Model archive updated 08/05/17 Sent for OGW review 08/28/2017 Sent to Water Science Field Team for Review The underlying directories contain the report, all of the input and output files for the simulations described in the scientific investigations report, model source code, and the model executable. ================================================================================ Background Information: o This archive includes data sets for a transient, groundwater flow model of the Lower Apalachicola-Chattahoochee-Flint (LACF) River Basin in Southwestern Georgia and Parts of Florida and Alabama, 2008-12. o This investigation was completed for the National Water Census and Water Availability and Use Science Program. o The model was simulated using the USGS Office of Groundwater compiled version of MODFLOW_2005 version 1.11.0. o The River (RIV) package of MODFLOW-2005 was used to simulate the major perennial rivers in the LACF River Basin. A shapefile of these streams was included as an arc shapefile. o The archive is available as a data release from https://doi.org/10.5066/F7DV1HCG. o This archive does contain some pre-processing or post-processing tools in the ancillary/ subdirectory. o Simulations will execute as described if the folder structure described in this readme file is replicated. 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/sir2017-5141) 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 (mf2005.exe). The simulations were conducted using mf2005.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 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 t60mo3lay.nam input file. Simulation inputs and limitations are documented in USGS SIR 2017-5141 (https://doi.org/10.3133/sir20175141). Formats of simulation input and output are documented in USGS Techniques and Methods 6-A16 (Harbaugh, A.W., 2005, MODFLOW-2005, The U.S. Geological Survey Modular Ground-Water Model - The Ground-Water Flow Process, Chapter 16 of Book 6. Modeling techniques, Section A. Ground Water). ================================================================================ Reconstructing the data release from the online data release files: ------------------------------------------------------------- This data release is available from: https://doi.org/10.5066/F7DV1HCG 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 the recharge rates used for the model and derived from the PRMS model by Jacob LaFontaine. In addition, three shapefiles (for Wells, for Rivers, and for grid center cell points) are under GIS, a subdirectory under ancillary/. Files used to generate the model input file types lpf and rch are under subdirectory external_files/. Files used to conduct the zonebudget analysis (for the model water budget) are in subdirectory ancillary/Post-Processing/ZONEBUDGET. Files used to conduct the sensitivity runs are in subdirectory ancillary/Post-Processing/SENSITIVITY_RUNS. bin/ -- The zipped directory contains the executable for MODFLOW-2005 Version 1.11.0, compiled by USGS for use on 64 bit personal computer running Windows 10 (mf2005.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 sir2017_5141.shp, a polygon of the union of the contiguous active areas in the model, the same active area for layers 1, 2, and 3. model/ -- The zipped directory contains the MODFLOW-2005 model input files required for the groundwater simulation, all under the sub-directory calibrated_model/: o The calibrated run for the transient 2008-2012 LACF run includes o the following input and output files. The model can be run by o executing the batch file. o o 1 batch file to execute Modflow: o Run_LACF.bat o o 1 name file: o t60mo3lay.nam o o 11 input files: o bas - basic package - lay3l1unc.bas o dis - discretization file - lay3l1uncelk72mo.dis o lpf - layer-property flow package - lay3l1unc.lpf o rch - recharge array (from PRMS) - t72mo3lay.rch o wel – agricultural, municipal, and industrial pumping wells - t72moelk3lay.wel o drn - ephemeral streams and swamps - t72mo3lay.drn o ghb - regional boundary and lakes - t72mo3lay.ghb o riv - major streams - t72mo3lay.riv o pcgn - nonlinear pre-conditioned conjugate-gradient solver - lay3l1unc.pcgn o oc - output control - t72mo10ts.oc o hob - head observations - t72moelk3lay.hob o usgs.model.reference which contains the following information: xul -95341.63 # x-coordinate of the northernmost-westernmost corner of the simulation grid yul 1004539.90 # y-coordinate of the northernmost-westernmost corner of the simulation rotation 0.0000 # 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/2008 # 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-2005 # model type: MODFLOW-2005 Version 1.11.00 08/08/2013 proj4 +proj=aea +lat_1=29.5 +lat_2=45.0 +lat_0=23.0 +lon_0=-84.5 +x_0=0.0 +y_0=0 +ellps=WGS_1984 +units=ft +no_defs output/ -- The zipped directory contains the model output for the groundwater flow simulation, in the subdirectory output.calibrated_model/ with MODFLOW output files: o t60mo3lay.ddn - file with simulated drawdown printed at each of the 60 stress periods o t60mo3lay.hds - file with simulated heads o t60mo3lay.cbc - cell by cell flow terms o t60mo3lay.hob_out - simulated heads at observation sites o lay3l1unc72mo.lst - list output file source/ -- The zipped directory source\ contains Fortran and C source files used for the MODFLOW-2005 version 1.11.0 used in this study. In addition, sub-directories bin/, doc/, src/, test-out/, and test-run/ as documented by the USGS Office of Groundwater have been added for the benefit of the user. All source files are listed under sub-directory src/. ================================================================================ Running the model: o The folders should be uncompressed and organized as described above in a Windows-based computer o The model can be run using the included Run_LACF.bat file in the model\calibrated_model\ subdirectory which uses the executable mf2005.exe in the bin/ directory. o Model output will be produced within the same model folder as the Run_LACF.bat file being executed. Model output files have been placed under subdirectory output\output.calibrated_model\. o The batch file uses the t60mo3lay.nam file provided in model\ directory (folder).