USGS - science for a changing world

MODFLOW-OWHM: One Water Hydrologic Flow Model

Diagram showing the interdependencies of flows within a hydrologic system simulated by MF-OWHM (modified from Schmid and Hanson, 2009).

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."

Program History

Version Highlights

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."

Version Information and Notes

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

Downloads and Documentation

General Information

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 modflow_owhm@usgs.gov with the word "add" in the title.

Software Downloads

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.

Documentation of MF-OWHM

  • Report: One-Water Hydrologic Flow Model (MODFLOW-OWHM) is the official USGS report that describes the theory and input instructions at the time the distribution was first released. If you use of this software please cite the "MF_OWHM_tm6-a51.pdf" report in any associated publications and reports.

    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)

  • Online MODFLOW-OWHM User's Guide:
    Packages and processes often evolve over time. The User's Guide includes the most up-to-date input instructions and related details.

Example Problem Description

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".

MODFLOW-OWHM Process and Packages Support

The table below provides quick access to the key documentation for MODFLOW-OWHM processes and packages:

  • Report: The official USGS report describes the theory and input instructions at the time the package or process was first released.
  • Online Guide: Packages and processes often evolve over time. The Online User's Guide includes the most up-to-date input instructions and related details.

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

CHOB

Constant Head Observation Package

CHOB Online Help

GBOB General-Head-Boundary Observation Package GBOB Online Help
DROB Drain Observation Package DROB Online Help
RVOB River Observation Package RVOB Online Help

Published USGS Reports and Articles Describing an Application of MF-OWHM


image of report cover

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.


image of fact sheet cover

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.


image of first page of journal article

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.

Current USGS Projects using MF-OWHM

Region Project
California Central Valley, San Joaquin Valley, Borrego Valley, Pajaro Valley, Cuyama Valley, Modesto Irrigation District, Joshua Tree Valley, San Gorgornio
New Mexico Lower Rio Gande Valley
Oklahoma Osage Nation
Mexico Mexico City Valley
Australia Perth

Superseded Versions

The following software is not actively supported by the USGS. Software listed below have been categorized as:

  • Superseded: software has been replaced by newer software

The software is provided online for historical reference only, and the pages may contain outdated information or broken links.

Point of Contact

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
U.S. Geological Survey
California Water Science Center
4165 Spruance Road, Suite 200
San Diego, CA 92101
seboyce@usgs.gov

MODFLOW-OWHM Email List for Updates

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 modflow_owhm@usgs.gov.

USGS Publications

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.


Disclaimers and Notices

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.

See also, USGS policy on linking to non-Federal web sites.

New to MODFLOW?
Start here!


OWHM & GSFLOW Comparison


[Image: Cover of software documentation report. ]

One-Water Hydrologic Flow Model (MODFLOW-OWHM)
U.S. Geological Survey Techniques and Methods


USGS Water Resources Software

The USGS develops water-resources software for use by the USGS in fulfilling its mission. Most of this software is available online for download at no charge.

Groundwater

Water Quality & Chemistry

Surface Water

Statistics & Graphics

General Use


Get Adobe Reader

Note: Some or all of this information is presented in Portable Document Format (PDF); the latest version of Adobe Reader or similar software is required to view it. Download the latest version of the free Adobe Reader from the Adobe web site.  Visit http://www.adobe.com/accessibility/  for free tools that allow visually impaired users to read PDF files.


California Water Conditions

Real-Time California Streamflow Conditions
Real-Time Data
Streamflow Condidtiona
WaterWatch
USGS Data Mapper

Groundwater
Data
Groundwater Watch
Current Groundwater Conditions

Surface Water
Data
Surface-Water Watch
Runoff Estimates for California

Water-Quality
Data
Watch
Current Water Quality Conditions

Historical Water Data for California
Water Years 1961 through 2013

USGS WaterNow
Current-conditions directly to your mobile phone or email.
All California Data >>