Preprints
https://doi.org/10.5194/egusphere-2026-868
https://doi.org/10.5194/egusphere-2026-868
27 Feb 2026
 | 27 Feb 2026

Technical note: HydroModPy – a Python toolbox for deploying catchment-scale shallow groundwater models

Alexandre Gauvain, Ronan Abhervé, Bastien Boivin, Clément Roques, Martin Le Mesnil, Alexandre Coche, Tristan Babey, Jean Marçais, Camille Bouchez, Sarah Leray, Etienne Marti, Etienne Bresciani, Ronny Figueroa, Mathias Pélissier, Luca Guillaumot, Théa Touzeau, Imene Issolah, Enzo Maugan, Rock S. Bagagnan, Camille Vautier, June Sallou, Johan Bourcier, Benoit Combemale, Philip Brunner, Laurent Longuevergne, Luc Aquilina, and Jean-Raynald de Dreuzy

Abstract. Despite the widespread use of physically based groundwater models, their deployment at the catchment scale remains challenging and time-consuming. HydroModPy was developed to address this gap by enabling automated and streamlined multi-site developement of hydrogeological models at the catchment scale. This open-source Python toolbox facilitates the construction, execution, calibration, and analysis of unconfined shallow groundwater models. The current version integrates established geospatial such as WhiteboxTools and hydrogeological libraries with FloPy-driven MODFLOW-NWT simulations, along with optional particle-tracking and solute transport modules (MODPATH and MT3DMS), to provide a fully scriptable, end-to-end workflow. Automation is achieved through dedicated functions and classes capable of performing watershed delineation from digital elevation models, preparing spatial and temporal recharge forcings, generating computational meshes and vertical discretization schemes, assigning model parameters, and running simulations in steady or transient state. The overall framework supports systematic and reproducible calibration routines that leverage subsurface data such as groundwater head measurements, as well as surface observations — including stream network maps and stream intermittency patterns — to constrain model estimates of aquifer hydraulic properties. Model outputs and provenance metadata are exported in standard geospatial formats to ensure interoperability and alignment with FAIR data principles. Built-in visualization tools and integration with Jupyter Notebooks support interactive exploration, teaching applications, and fully reproducible analyses. In this technical note, we present the HydroModPy architecture and its core functionalities, demonstrate model deployment across various hydrogeological contexts, and discuss ongoing and planned developments for future versions of this collaborative tool. The code is modular and extensible, making it suitable for adoption by a broad user community. Planned enhancements include tighter coupling with land-surface or ecohydrological models adding new numerical solvers, the integration of advanced calibration and uncertainty quantification algorithms, and improved user interfaces to facilitate application in various environmental settings. HydroModPy contributes to improving the understanding of hydrogeological processes that are often poorly characterized or inadequately represented. It also provides valuable support for multidisciplinary education, particularly for those studying groundwater systems and their interactions with the surface in headwater catchments. Furthermore, this numerical framework can serve as a practical decision-support tool for public policy and water resource management, helping stakeholders address current and future groundwater-related challenges.

Publisher's note: Copernicus Publications remains neutral with regard to jurisdictional claims made in the text, published maps, institutional affiliations, or any other geographical representation in this paper. While Copernicus Publications makes every effort to include appropriate place names, the final responsibility lies with the authors. Views expressed in the text are those of the authors and do not necessarily reflect the views of the publisher.
Share

Journal article(s) based on this preprint

08 Sep 2026
Technical note: HydroModPy (v1.0) – a Python toolbox for deploying catchment-scale shallow groundwater models
Alexandre Gauvain, Ronan Abhervé, Bastien Boivin, Alexandre Coche, Martin Le Mesnil, Tristan Babey, Enzo Maugan, Théa Touzeau, Imene Issolah, Clément Roques, Camille Bouchez, Jean Marçais, Sarah Leray, Etienne Marti, Etienne Bresciani, Ronny Figueroa, Mathias Pélissier, Simon Carlier, Luca Guillaumot, Rock S. Bagagnan, Camille Vautier, Laurent Longuevergne, June Sallou, Johan Bourcier, Benoit Combemale, Philip Brunner, Luc Aquilina, and Jean-Raynald de Dreuzy
Hydrol. Earth Syst. Sci., 30, 5571–5592, https://doi.org/10.5194/hess-30-5571-2026,https://doi.org/10.5194/hess-30-5571-2026, 2026
Short summary
Alexandre Gauvain, Ronan Abhervé, Bastien Boivin, Clément Roques, Martin Le Mesnil, Alexandre Coche, Tristan Babey, Jean Marçais, Camille Bouchez, Sarah Leray, Etienne Marti, Etienne Bresciani, Ronny Figueroa, Mathias Pélissier, Luca Guillaumot, Théa Touzeau, Imene Issolah, Enzo Maugan, Rock S. Bagagnan, Camille Vautier, June Sallou, Johan Bourcier, Benoit Combemale, Philip Brunner, Laurent Longuevergne, Luc Aquilina, and Jean-Raynald de Dreuzy

Interactive discussion

Status: closed

Comment types: AC – author | RC – referee | CC – community | EC – editor | CEC – chief editor | : Report abuse
  • RC1: 'Comment on egusphere-2026-868', Anonymous Referee #1, 18 Apr 2026
    • AC1: 'Reply on RC1', Alexandre Gauvain, 26 Jun 2026
  • RC2: 'Comment on egusphere-2026-868', Anonymous Referee #2, 19 May 2026
    • AC2: 'Reply on RC2', Alexandre Gauvain, 26 Jun 2026
  • RC3: 'Comment on egusphere-2026-868', Anonymous Referee #3, 21 May 2026
    • AC3: 'Reply on RC3', Alexandre Gauvain, 26 Jun 2026

Peer review completion

AR – Author's response | RR – Referee report | ED – Editor decision | EF – Editorial file upload
ED: Submit a revised manuscript (03 Jul 2026) by Yonggen Zhang
AR by Alexandre Gauvain on behalf of the Authors (04 Jul 2026)  Author's response   Author's tracked changes   Manuscript 
ED: Referee Nomination & Report Request started (21 Jul 2026) by Yonggen Zhang
RR by Sacha Ruzzante (25 Jul 2026)
RR by Anonymous Referee #2 (04 Aug 2026)
ED: Publish subject to technical corrections (09 Aug 2026) by Yonggen Zhang
AR by Alexandre Gauvain on behalf of the Authors (21 Aug 2026)  Author's response   Manuscript 

Interactive discussion

Status: closed

Comment types: AC – author | RC – referee | CC – community | EC – editor | CEC – chief editor | : Report abuse
  • RC1: 'Comment on egusphere-2026-868', Anonymous Referee #1, 18 Apr 2026
    • AC1: 'Reply on RC1', Alexandre Gauvain, 26 Jun 2026
  • RC2: 'Comment on egusphere-2026-868', Anonymous Referee #2, 19 May 2026
    • AC2: 'Reply on RC2', Alexandre Gauvain, 26 Jun 2026
  • RC3: 'Comment on egusphere-2026-868', Anonymous Referee #3, 21 May 2026
    • AC3: 'Reply on RC3', Alexandre Gauvain, 26 Jun 2026

Peer review completion

AR – Author's response | RR – Referee report | ED – Editor decision | EF – Editorial file upload
ED: Submit a revised manuscript (03 Jul 2026) by Yonggen Zhang
AR by Alexandre Gauvain on behalf of the Authors (04 Jul 2026)  Author's response   Author's tracked changes   Manuscript 
ED: Referee Nomination & Report Request started (21 Jul 2026) by Yonggen Zhang
RR by Sacha Ruzzante (25 Jul 2026)
RR by Anonymous Referee #2 (04 Aug 2026)
ED: Publish subject to technical corrections (09 Aug 2026) by Yonggen Zhang
AR by Alexandre Gauvain on behalf of the Authors (21 Aug 2026)  Author's response   Manuscript 

Journal article(s) based on this preprint

08 Sep 2026
Technical note: HydroModPy (v1.0) – a Python toolbox for deploying catchment-scale shallow groundwater models
Alexandre Gauvain, Ronan Abhervé, Bastien Boivin, Alexandre Coche, Martin Le Mesnil, Tristan Babey, Enzo Maugan, Théa Touzeau, Imene Issolah, Clément Roques, Camille Bouchez, Jean Marçais, Sarah Leray, Etienne Marti, Etienne Bresciani, Ronny Figueroa, Mathias Pélissier, Simon Carlier, Luca Guillaumot, Rock S. Bagagnan, Camille Vautier, Laurent Longuevergne, June Sallou, Johan Bourcier, Benoit Combemale, Philip Brunner, Luc Aquilina, and Jean-Raynald de Dreuzy
Hydrol. Earth Syst. Sci., 30, 5571–5592, https://doi.org/10.5194/hess-30-5571-2026,https://doi.org/10.5194/hess-30-5571-2026, 2026
Short summary
Alexandre Gauvain, Ronan Abhervé, Bastien Boivin, Clément Roques, Martin Le Mesnil, Alexandre Coche, Tristan Babey, Jean Marçais, Camille Bouchez, Sarah Leray, Etienne Marti, Etienne Bresciani, Ronny Figueroa, Mathias Pélissier, Luca Guillaumot, Théa Touzeau, Imene Issolah, Enzo Maugan, Rock S. Bagagnan, Camille Vautier, June Sallou, Johan Bourcier, Benoit Combemale, Philip Brunner, Laurent Longuevergne, Luc Aquilina, and Jean-Raynald de Dreuzy
Alexandre Gauvain, Ronan Abhervé, Bastien Boivin, Clément Roques, Martin Le Mesnil, Alexandre Coche, Tristan Babey, Jean Marçais, Camille Bouchez, Sarah Leray, Etienne Marti, Etienne Bresciani, Ronny Figueroa, Mathias Pélissier, Luca Guillaumot, Théa Touzeau, Imene Issolah, Enzo Maugan, Rock S. Bagagnan, Camille Vautier, June Sallou, Johan Bourcier, Benoit Combemale, Philip Brunner, Laurent Longuevergne, Luc Aquilina, and Jean-Raynald de Dreuzy

Viewed

Total article views: 2,349 (including HTML, PDF, and XML)
HTML PDF XML Total BibTeX EndNote
1,398 863 88 2,349 74 118
  • HTML: 1,398
  • PDF: 863
  • XML: 88
  • Total: 2,349
  • BibTeX: 74
  • EndNote: 118
Views and downloads (calculated since 27 Feb 2026)
Cumulative views and downloads (calculated since 27 Feb 2026)

Viewed (geographical distribution)

Total article views: 2,296 (including HTML, PDF, and XML) Thereof 2,296 with geography defined and 0 with unknown origin.
Country # Views %
  • 1
1
 
 
 
 

Cited

Saved

Latest update: 15 Sep 2026
Download

The requested preprint has a corresponding peer-reviewed final revised paper. You are encouraged to refer to the final revised version.

Short summary
HydroModPy was developed to make it easier and faster to deploy groundwater models across multiple catchments. Although such models are widely used, setting them up often requires significant time and expertise. HydroModPy automates key steps, from preparing maps and input data to building models and running simulations. It is specifically designed for shallow aquifers and supports transparent, reproducible studies of groundwater. This tool can improve water management, research, and education.
Share