Model:DPFEHM

DPFEHM

This code has been community reviewed and published in the open access Journal of Open Source Software (JOSS)

Also known as
Model type	Single
Model part of larger framework
Note on status model
Date note status model

Incorporated models or components:

Spatial dimensions	2D, 3D
Spatial extent	Landscape-Scale
Model domain	Terrestrial
One-line model description	DPFEHM is a differentiable Julia simulator for subsurface flow and transport, built for gradient-based inverse modeling and ML integration.
Extended model description	DPFEHM is a differentiable Julia simulator for subsurface flow and transport (groundwater flow, Richards equation, advection-dispersion, and wave propagation) that supports automatic differentiation via Zygote for gradient-based inverse modeling and machine learning integration.

Keywords:	Differentiable simulation, Subsurface flow, Inverse modeling,

Name	Daniel O’Malley
Type of contact	Model developer
Institute / Organization	Los Alamos National Laboratory
Postal address 1
Postal address 2
Town / City	Santa Fe
Postal code	87544
State	New Mexico
Country	United States
Email address	omalled@gmail.com
Phone
Fax

Supported platforms	Unix, Linux, Mac OS, Windows
Other platform
Programming language
Other program language	Julia
Code optimized	Single Processor
Multiple processors implemented
Nr of distributed processors
Nr of shared processors
Start year development	2021
Does model development still take place?	Yes
If above answer is no, provide end year model development
Code development status	Active
When did you indicate the 'code development status'?	2026
Model availability	As code
Source code availability (Or provide future intension)	Through web repository
Source web address	https://github.com/OrchardLANL/DPFEHM.jl
Source csdms web address
Program license type	BSD or MIT X11
Program license type other
Memory requirements	--
Typical run time	--

Describe input parameters	grid geometry (coords, neighbors, areasoverlengths, volumes, built via functions like regulargrid2d/regulargrid3d), material/hydraulic properties (conductivity/permeability Ks or logKs, specific storage, van Genuchten parameters alphas and Ns for Richards equation), sources and sinks (Qs), and boundary conditions (dirichletnodes and dirichleths, the fixed-pressure/head nodes and their values).
Input format
Other input format
Describe output parameters	The solvers (e.g., groundwater_steadystate, richards_residuals) return arrays of the solved field values — head/pressure (h) at each grid node, or saturation/psi for Richards equation — plus, when using Zygote for automatic differentiation, gradient arrays of the same shape.
Output format
Other output format
Pre-processing software needed?	No
Describe pre-processing software
Post-processing software needed?	No
Describe post-processing software
Visualization software needed?	No
If above answer is yes
Other visualization software

Describe processes represented by the model	--
Describe key physical parameters and equations	--
Describe length scale and resolution constraints	--
Describe time scale and resolution constraints	--
Describe any numerical limitations and issues	--

Describe available calibration data sets
Upload calibration data sets if available:
Describe available test data sets
Upload test data sets if available:
Describe ideal data for testing

Do you have current or future plans for collaborating with other researchers?

Is there a manual available?	No
Upload manual if available:
Model website if any
Model forum / discussion board

Comments

This part will be filled out by CSDMS staff

Can be coupled with:

Model info

Authors

Daniel O’Malley

Source code

DOI

Model citations

QR-code

Link to this page

Other models by author

Featured reference(s)	Open Access Status	Year	Type of Reference	Cited
O’Malley, Daniel; Greer, Sarah Y.; Pachalieva, Aleksandra; Hao, Wu; Harp, Dylan; Vesselinov, Velimir V.; 2023. DPFEHM: a differentiable subsurface physics simulator. Journal of Open Source Software, 84560. 10.21105/joss.04560	cc-by · publishedVersion	2023	a module overview describing a module	2