Diagram showing the interdependencies of flows within a hydrologic system simulated by MF-OWHM (modified from Schmid and Hanson, 2009). Click for a larger, detailed figure.
The One-Water Hydrologic Flow Model (MF-OWHM) (Hanson and others, 2014) is a MODFLOW-based integrated hydrologic flow model (IHM) that is the most complete version, to date, of the MODFLOW family of hydrologic simulators needed for the analysis of a broad range of conjunctive-use issues. Conjunctive use is the combined use of groundwater and surface water. MF-OWHM allows the simulation, analysis, and management of nearly all components of human and natural water movement and its use in a physically-based supply-and-demand framework.
MF-OWHM is based on the Farm Process for MODFLOW-2005 (MF-FMP2, Schmid and Hanson, 2009) that is now combined with Local Grid Refinement (LGR, Mehl and Hill, 2013) for embedded models to allow use of the Farm Process (FMP) and Streamflow Routing (SFR) within embedded grids. MF-OWHM also now includes new features such as the Surface-water Routing Process (SWR, Hughes and others, 2012), Seawater Intrusion (SWI, Bakker and others, 2013), and Riparian Evapotranspiration (RIP-ET, Maddock III and others, 2012). MF-OWHM contains all the previously available solvers and the new solvers such as Newton-Raphson (NWT, Niswonger and others, 2011) and the nonlinear preconditioned conjugate gradient (PCGN, Naff and Banta, 2008).
What makes MF-OWHM unique is that it allows the simulation of head-dependent flows, flow-dependent flows, and deformation dependent flows that collectively affect conjunctive use of water resources. The supply-constrained and demand-driven framework combined with the linkages between packages and processes provides relations of water use and movement, and helps to prevent mass loss to an open system thus facilitating the accounting for "all of the water everywhere and all of the time."
MF-OWHM v1.00 is the first release and version of MF-OWHM that is a unification of the many separate versions of MODFLOW that have evolved for various classes of hydrologic issues. While this is the first version of MF-OWHM it is built primarily on the previous versions of MODFLOW-FMP2 with the Farm Process with supplementary structure from the second version of Local Grid Refinement (LGR2), and the latest version of NWT. In addition to this, modifications were made to the MF2005 source code that improve stability, accuracy and make the resulting software more "user friendly."
MF-OWHM v1.00.00 11/05/2014 is the initial release.
Note: Users are encouraged to read the documents that are provided in the 'doc' directory of this software distribution.
Also see contents of the separate files: readme.txt, release.txt, MF_OWHM.txt, Mf2005.txt, Stack Overflow or Segmentation Fault Info.txt, and Examples_Description.txt
Current Release: v.1.0.12, 10/01/2016
The MF-OWHM release comes in a variety of different installation options that depend on your platform or desired level of information included (i.e. full documentation or just the executable). Within the distribution the word Win and Nix are used to delineate between MS Windows and GNU Unix, respectively. At a minimum all downloads include the MF-OWHM report, a compiled executable, a GNU Makefile, and the release/readme notes. Compiled binaries for GNU Unix and Linux distributions are provided as a convenience (they depend on glibc/libc6 to use GLIBC_2.14) and may require recompilation to work on your system. A user friendly makefile is provided, only requires setting 4 variables, to make recompilation easy with either the Intel (ifort/icc) or GNU (gfortran/gcc) compilers.
The general structure is "MF_OWHM_X_X", where X_X is the version number, as the main folder and within that are: a "bin" folder, which contains the executables, a “doc” folder, which contains all documentation, an "examples" folder, which contains example problems from MF2005, SWR, NWT, etc. and scripts to run them, a "src" folder, which contains all source code, and lastly, a "src_Postprocessors", which is the source code for HydFmt and Zonebudget.
If you wish to be included in our email list to be notified when updates occur, please send an email to firstname.lastname@example.org with the word "add" in the title.
Users are highly encouraged to read through the documentation located in the "doc" folder. If you use of this software please cite the USGS Techniques and Methods 6-A51 One-Water Hydrologic Flow Model (MODFLOW-OWHM) report in any associated publications and reports.
Please Note: Pre-compiled unix/linux binaries may not work on all unix systems. If you are having issues, try useing the makefile and compile OWHM.
The suggested citation is as follows:
Hanson, R.T., Boyce, S.E., Schmid, Wolfgang, Hughes, J.D., Mehl, S.M., Leake, S.A., Maddock, Thomas, III, and Niswonger, R.G., 2014, One-Water Hydrologic Flow Model (MODFLOW-OWHM): U.S. Geological Survey Techniques and Methods 6-A51, 120 p., http://dx.doi.org/10.3133/tm6A51.
ISSN 2328-7055 (online)
Downloads that include the "examples" folder contain the example problems from the MODFLOW-2005, SWR, NWT, RIP-ET, SWI, FMP, and LGR releases as well as new example problems to illustrate MF-OWHM features.
The input files have been modified to work on either MS Windows or GNU Unix and only require invoking the appropriate executable/binary. For MS Windows a series of Batch scripts are provided to facilitate running the example problems. For GNU Unix a series of BASH scripts are provided for running the example problems. No user configuration is required, unless a different executable/binary is required. This is set for MS Windows and GNU Unix in the files 0_SelectProgramUsedByBATCH.bat and/or 0_SelectProgramUsedByBASH.sh by setting the "OWHM", "HYDFMT", and "ZONBUD3" variables.
All the input files are located in folders that follow the name "test-run-XXX" where XXX indicates where the example set originated from (e.g. FMP). The only deviation from this is for the MODFLOW-2005 example problems are located in "test-run". After running the example problems the results are placed in the "test-out-XXX" folders. To compare the results that are obtained on your machine a set of "true" results are provided n the folders named "test-out-true-TXXX".
The table below provides quick access to the key documentation for MODFLOW-OWHM processes and packages:
|Functionality||Package or Process Name||Online Guide|
|BAS||Basic Package||BAS Online Help|
|DIS||Discretization Package||DIS Online Help|
|BCF||Block-Centered Flow Package||BCF Online Help|
|LPF||Layer-Property Flow Package||LPF Online Help|
|HFB||Horizontal Flow Barrier Package||HFB Online Help|
|CHD||Time-Variant Specified-Head Option||CHD Online Help|
|RIV||River Package||RIV Online Help|
|DRN||Drain Package||DRN Online Help|
|DRT||Drains with Return Flow Package||DRN Online Help|
|WEL||Well Package||WEL Online Help|
|GHB||General Head Boundary Package||GHB Online Help|
|RCH||Recharge Package||RCH Online Help|
|EVT||Evapotranspiration Package||EVT Online Help|
|SIP||Strongly Implicit Procedure Package||SIP Online Help|
|PCG||Preconditioned-Conjugate Gradient Package||PCG Online Help|
|DE4||Direct Solver||DE4 Online Help|
|PVAL||Parameter Value Package||PVAL Online Help|
|ZONE||Zone Package||ZONE Online Help|
|MULT||Multiplier Package||MULT Online Help|
|OC||Output Control||OC Online Help|
|FMP||Farm Process||FMP Online Help|
|SWR||Surface Water Routing||SWR Online Help|
|SWI2||Seawater Intrusion Package||SWI2 Online Help|
|UPW||Upstream Weight Package||UPW Online Help|
|MNW1||Version 1 of Multi-Node Well Package||MNW1 Online Help|
|MNW2||Version 2 of the Multi-Node Well Package||MNW2 Online Help|
|MNWI||Multi-Node Well Information Package||MNWI Online Help|
|LGR||Local Grid Refinement Package||LGR Online Help|
|BFH||Boundary Flow and Head Package||BFH Online Help|
|GMG||Geometric MultiGrid Solver Package||GMG Online Help|
|PCGN||Preconditioned Conjugate Gradient solver with improved nonlinear control||PCGN Online Help|
|NWT||Newton Solver||NWT Online Help|
|RIP||Riparian Evapotranspiration||RIP Online Help|
|STR||Stream Package||STR Online Help|
|FHB||Flow and Head Boundary Package||FHB Online Help|
|HUF||Hydrogeologic-Unit Flow Package||HUF Online Help|
|KDEP||Hydraulic-Conductivity Depth-Dependence Capability||KDEP Online Help|
|LVDA||Model-Layer Variable-Direction Horizontal Anisotropy Package||LVDA Online Help|
|ETS||Evapotranspiration with a Segmented Function Package||ETS Online Help|
|RES||Reservoir Package||RES Online Help|
|IBS||Interbed Storage Package||IBS Online Help|
|SUB||Subsidence Package||SUB Online Help|
|SWT||Subsidence and Aquifer-System Compaction Package for Water-Table Aquifers||SWT Online Help|
|SFR||Streamflow-Routing Package||SFR Online Help|
|LAK||Lake Package||LAK Online Help|
|UZF||Unsaturated Zone Package||UZF Online Help|
|LMT||Link to the MT3DMS contaminant-transport model||LMT Online Help|
|HYD||HYDMOD Hydrograph capability for groundwater, surface-water, and subsidence time-series data||HYDMOD Online Help|
|GAGE||Gage Package||GAG Online Help|
|OBS||Observation Process||OBS Online Help|
|HOB||Head Observation Package||HOB Online Help|
|Constant Head Observation Package|
|GBOB||General-Head-Boundary Observation Package||GBOB Online Help|
|DROB||Drain Observation Package||DROB Online Help|
|RVOB||River Observation Package||RVOB Online Help|
Hanson, R.T., Flint, L.E., Faunt, C.C., Gibbs, D.R., and Schmid, W., 2014, Hydrologic models and analysis of water availability in Cuyama Valley, California: U.S Geological Survey Scientific Investigations Report 2014-5150, 150 p., http://dx.doi.org/10.3133/sir20145150.
Hanson, Randall T., and Sweetkind, Donald, 2014, Cuyama Valley, California hydrologic study -- An assessment of water availability: U.S. Geological Survey Fact Sheet 2014-3075, 4 p., http://dx.doi.org/10.3133/fs20143075.
Schmid, Wolfgang, Hanson, R.T., Hughes, J., Leake, S.A., and Niswonger, R., 2014, Feedback of land subsidence on the movement and conjunctive use of water resources: Environmental Modelling and Software, vol. 62, pp. 253-270, http://dx.doi.org/10.1016/j.envsoft.2014.08.006.
The following software is not actively supported by the USGS. Software listed below have been categorized as:
The software is provided online for historical reference only, and the pages may contain outdated information or broken links.
The following links are to USGS internal-only training resources
Support is provided for correcting bugs and clarification of how MODFLOW-OWHM is intended to work. Only limited assistance can be provided for MODFLOW-OWHM to specific problems.Scott Boyce
To be notified by the Integrated Hydrologic Model Development Team that supports MF-OWHM of updates/new versions, please send an email with the subject ADD to email@example.com.
Visit the USGS Publications Warehouse to search for reports by subject, author, date, USGS series or publication series number. Many of these reports will be available in .DJVU format. There is also information on obtaining printed copies of reports.
Visit the Water-Resources Reports page to browse for selected USGS Online Water-Resources reports. Most of these reports will be available in Adobe PDF or HTML format.
Please refer to the USGS Water Resources Software User Rights Notice for complete use, copyright, and distribution information. This software has been approved for release by the U.S. Geological Survey (USGS). Although the software has been subjected to rigorous review, the USGS reserves the right to update the software as needed pursuant to further analysis and review. No warranty, expressed or implied, is made by the USGS or the U.S. Government as to the functionality of the software and related material nor shall the fact of release constitute any such warranty. Furthermore, the software is released on condition that neither the USGS nor the U.S. Government shall be held liable for any damages resulting from its authorized or unauthorized use.