HydroTrixi.jl is an adaptive discontinuous spectral-element solver for hydrologic problems. It builds upon the parabolic spatial discretization capabilities in Trixi.jl (Ranocha et al. 2022) and the time integration methods in SciML, adding the following technical features to support the solution of the Richards equation in one spatial dimension:
- Mixed and pressure-head formulations of the Richards equation, including constitutive constraints and capacity-weighted temporal operators
- Flexible parabolic boundary conditions allowing penalty-type numerical fluxes that depend on the inner and outer solution and flux values
- Solver flux output method (SFOM) diagnostics for time-integrated boundary fluxes, following Ireson et al. (2023)
- Tools to facilitate problem setup and visualization, with examples for standard hydrologic benchmark cases
If you have not yet installed Julia, please follow the instructions for your operating system. HydroTrixi.jl works with Julia v1.10 and newer. We recommend using the latest stable release.
Install and run HydroTrixi.jl from a local clone:
git clone https://github.com/uofs-simlab/HydroTrixi.jl.git
cd HydroTrixi.jl
julia --project=.Then instantiate dependencies in the Julia REPL:
julia> using Pkg
julia> Pkg.instantiate()Optional sanity check:
julia> Pkg.test()Visualization is optional. Loading CairoMakie and LaTeXStrings activates
the plotting extension.
Worked examples and tutorials are provided in the documentation.
- Ranocha, H., Schlottke-Lakemper, M., Winters, A. R., Faulhaber, E., Chan, J., and Gassner, G. J. (2022). Adaptive numerical simulations with Trixi.jl: A case study of Julia for scientific computing. Proceedings of the JuliaCon Conferences, 1(1), 77.
- Ireson, A. M., Spiteri, R. J., Clark, M. P., and Mathias, S. A. (2023). A simple, efficient, mass-conservative approach to solving the Richards equation (openRE, v1.0). Geoscientific Model Development, 16, 659-677.
The developers of this package acknowledge funding support from the Cooperative Institute for Research to Operations in Hydrology (CIROH).