mod-PATH3DU Get mod-PATH3DU

S.S. Papadopulos & Associates · University of Waterloo

mod-PATH3DU

A groundwater path and travel-time simulator

mod-PATH3DU computes the pathlines and travel times of particles in MODFLOW flow solutions, on structured and unstructured grids, and on water-level maps interpolated from well data. It is multithreaded, and is distributed as a Windows executable and as a Python package.

Both are free. The executable is downloaded from the SSP&A software portal, which requires a free account. Documentation: User's Guide.

MP3DU-RS results for a synthetic MODFLOW 6 model. Details

Overview

Particles are started at user-defined locations and tracked through the cell-by-cell flows of a MODFLOW simulation, or across interpolated water-level maps.

Results
Pathlines, endpoints, points in time and travel times.
Velocity
The Waterloo method: a semi-analytical reconstruction of velocity inside each cell, for arbitrary cell shapes. Pumping wells are represented explicitly, so weak sinks need no special designation.
Water-level maps
Particles can also be tracked without a flow model, on water-level maps interpolated from well data, using the SSP&A method. Velocity follows from the mapped gradient by Darcy’s law, pumping wells capture particles, and random-walk dispersion is available on the maps too. mod-PATH3DU 2.1.9 also captures particles at line sinks, and tracks through a sequence of maps, each for its own duration, to follow changing conditions. See Examples.
Integration
Adaptive Runge–Kutta, forward or backward in simulation time, for steady-state and transient models.
Multithreaded
Particles are tracked on several threads at once. mod-PATH3DU 2.1.9 also reads the MODFLOW budget file on several threads, which shortens runs on transient models.
Options
Linear retardation; random-walk dispersion (experimental).
Limitations
No vertical sub-discretization within a layer. MODFLOW 6 DISU grids do not assign cells to layers, but mod-PATH3DU needs a layer designation to move particles from one layer to the next owing to the local-z tracking within a cell. The layers currently must be supplied via a grid specification file, which most GUIs export. writeP3DGSF.exe combines it with the cell connections in the MODFLOW 6 binary grid file (GRB).
Method
Craig, Ramadhan and Muffels (2020), Groundwater 58(1). See Citation.

Distributions

mod-PATH3DU is available as a Windows executable and as a Python package with a Rust core. Both are free.

mod-PATH3DU

2.1.9
StableWindows command line

The production program. It is supported by several MODFLOW GUIs, including Groundwater Desktop, and runs from the command line with a JSON input file.

  • MODFLOW-2000, MODFLOW-2005 (including NWT), MODFLOW-USG (v1.4 and later) and MODFLOW 6.
  • Regular, quadtree, quadpatch, nested and Voronoi grids; MODFLOW 6 DIS, DISV and DISU.
  • Adaptive RK4 with optional Dormand–Prince; linear retardation; random-walk dispersion (experimental).
  • Particles start from a point shapefile, each with its own release time. Its other attributes can be carried through to the output, for example to color pathlines by well.

Workflow

  1. writeP3DGSF.exe
  2. GSF + JSON + start points
  3. mp3du.exe
  4. binary output
  5. writeP3DOutput.exe
  6. SHP · DBF · ASCII

Free. Downloading requires a free SSP&A account (register).

MP3DU-RS

0.1.1
BetaPython 3.8+ · Windows x64

A Rust implementation with a Python API (PyO3). Ships llms.txt and .pyi type stubs for AI coding tools.

  • Structured, DISV and USG grids (layer-conforming). DISU is not supported.
  • Euler, RK4 (step doubling), Dormand–Prince, Cash–Karp and Verner solvers; GSDE or Itô dispersion; per-cell retardation.
  • Early release, not yet validated to the level of 2.1.9. Freeware (EULA).

Workflow

  1. build_grid
  2. hydrate_cell_properties
  3. hydrate_cell_flows
  4. fit_waterloo
  5. run_simulation
Install
pip install https://github.com/sspa-inc/mp3du-rs/releases/download/v0.1.1/mp3du_py-0.1.1-cp38-abi3-win_amd64.whl

Free. Public repository.

Verification and citation

Verification

Each example on this page is compared with an independent solution: an exact solution for the capture zone, and MT3D for transport. See Examples, below.

The User's Guide documents further verification problems: analytical capture zones, MODPATH 7 Example 2, a quadpatch case from Pollock (2015) and comparisons with MT3D.

Citation

Craig, J.R., Ramadhan, M., and Muffels, C. (2020). A particle tracking algorithm for arbitrary unstructured grids. Groundwater 58(1): 19–26. doi:10.1111/gwat.12894

BibTeX
@article{craig2020particle,
  author  = {Craig, James R. and Ramadhan, Muhammad
             and Muffels, Christopher},
  title   = {A Particle Tracking Algorithm for
             Arbitrary Unstructured Grids},
  journal = {Groundwater},
  volume  = {58}, number = {1}, pages = {19--26},
  year    = {2020}, doi = {10.1111/gwat.12894}
}

User's Guide: Muffels, C., Scantlebury, L., Wang, X., Tonkin, M., Neville, C., Ramadhan, M., and Craig, J.R. User's Guide for mod-PATH3DU, a Groundwater Path and Travel-Time Simulator. S.S. Papadopulos & Associates, Inc. and University of Waterloo.

Examples

Worked problems, each run with MP3DU-RS and compared with an independent solution.

Capture zone of a pumping well in regional flow

A synthetic MODFLOW 6 model of one pumping well in uniform regional flow, on 2,288 Voronoi cells. MP3DU-RS traced pathlines backward from the well and forward through the regional flow, and the capture zone was compared with an image-well solution for the same bounded aquifer.

Comparison with an exact solution

Capture zone: MP3DU-RS against the exact solution
QuantityMP3DU-RSExact