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

Overview

Particles are started at user-defined locations and tracked through the cell-by-cell flows of a MODFLOW simulation.

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. Alternatively, the SSP&A method tracks on kriged water-level maps.
Integration
Adaptive Runge–Kutta, forward or backward in simulation time, for steady-state and transient models.
Options
Linear retardation; random-walk dispersion (experimental).
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, run 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 (DISU since 2.1.9, with a per-cell layer designation).
  • Adaptive RK4 with optional Dormand–Prince; linear retardation; random-walk dispersion (experimental).
  • No GUI. Up to about 2 million cells. No vertical sub-discretization within a layer.

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

Comparison with an exact solution

The model shown at the top of this page was compared with an image-well solution for the same bounded aquifer.

QuantityMP3DU-RSExact

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.