<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE article PUBLIC "-//NLM//DTD Journal Publishing DTD v3.0 20080202//EN" "https://jats.nlm.nih.gov/nlm-dtd/publishing/3.0/journalpublishing3.dtd">
<article xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:xlink="http://www.w3.org/1999/xlink" article-type="methods-article" specific-use="SMUR" dtd-version="3.0" xml:lang="en">
<front>
<journal-meta>
<journal-id journal-id-type="publisher">EGUsphere</journal-id>
<journal-title-group>
<journal-title>EGUsphere</journal-title>
<abbrev-journal-title abbrev-type="publisher">EGUsphere</abbrev-journal-title>
<abbrev-journal-title abbrev-type="nlm-ta">EGUsphere</abbrev-journal-title>
</journal-title-group>
<issn pub-type="epub"></issn>
<publisher><publisher-name>Copernicus Publications</publisher-name>
<publisher-loc>Göttingen, Germany</publisher-loc>
</publisher>
</journal-meta>
<article-meta>
<article-id pub-id-type="doi">10.5194/egusphere-2026-868</article-id>
<title-group>
<article-title>Technical note: HydroModPy &amp;ndash; a Python toolbox for deploying catchment-scale shallow groundwater models</article-title>
</title-group>
<contrib-group><contrib contrib-type="author" xlink:type="simple"><name name-style="western"><surname>Gauvain</surname>
<given-names>Alexandre</given-names>
<ext-link>https://orcid.org/0000-0002-9473-1108</ext-link>
</name>
<xref ref-type="aff" rid="aff1">
<sup>1</sup>
</xref>
<xref ref-type="aff" rid="aff2">
<sup>2</sup>
</xref>
</contrib>
<contrib contrib-type="author" xlink:type="simple"><name name-style="western"><surname>Abhervé</surname>
<given-names>Ronan</given-names>
<ext-link>https://orcid.org/0000-0001-7085-5272</ext-link>
</name>
<xref ref-type="aff" rid="aff1">
<sup>1</sup>
</xref>
<xref ref-type="aff" rid="aff3">
<sup>3</sup>
</xref>
<xref ref-type="aff" rid="aff4">
<sup>4</sup>
</xref>
</contrib>
<contrib contrib-type="author" xlink:type="simple"><name name-style="western"><surname>Boivin</surname>
<given-names>Bastien</given-names>
<ext-link>https://orcid.org/0009-0001-5738-3503</ext-link>
</name>
<xref ref-type="aff" rid="aff1">
<sup>1</sup>
</xref>
</contrib>
<contrib contrib-type="author" xlink:type="simple"><name name-style="western"><surname>Roques</surname>
<given-names>Clément</given-names>
<ext-link>https://orcid.org/0000-0002-5021-6008</ext-link>
</name>
<xref ref-type="aff" rid="aff3">
<sup>3</sup>
</xref>
</contrib>
<contrib contrib-type="author" xlink:type="simple"><name name-style="western"><surname>Le Mesnil</surname>
<given-names>Martin</given-names>
</name>
<xref ref-type="aff" rid="aff1">
<sup>1</sup>
</xref>
</contrib>
<contrib contrib-type="author" xlink:type="simple"><name name-style="western"><surname>Coche</surname>
<given-names>Alexandre</given-names>
</name>
<xref ref-type="aff" rid="aff1">
<sup>1</sup>
</xref>
</contrib>
<contrib contrib-type="author" xlink:type="simple"><name name-style="western"><surname>Babey</surname>
<given-names>Tristan</given-names>
</name>
<xref ref-type="aff" rid="aff1">
<sup>1</sup>
</xref>
</contrib>
<contrib contrib-type="author" xlink:type="simple"><name name-style="western"><surname>Marçais</surname>
<given-names>Jean</given-names>
<ext-link>https://orcid.org/0000-0002-1729-9964</ext-link>
</name>
<xref ref-type="aff" rid="aff5">
<sup>5</sup>
</xref>
</contrib>
<contrib contrib-type="author" xlink:type="simple"><name name-style="western"><surname>Bouchez</surname>
<given-names>Camille</given-names>
</name>
<xref ref-type="aff" rid="aff1">
<sup>1</sup>
</xref>
</contrib>
<contrib contrib-type="author" xlink:type="simple"><name name-style="western"><surname>Leray</surname>
<given-names>Sarah</given-names>
</name>
<xref ref-type="aff" rid="aff6">
<sup>6</sup>
</xref>
</contrib>
<contrib contrib-type="author" xlink:type="simple"><name name-style="western"><surname>Marti</surname>
<given-names>Etienne</given-names>
<ext-link>https://orcid.org/0000-0002-6007-3282</ext-link>
</name>
<xref ref-type="aff" rid="aff6">
<sup>6</sup>
</xref>
</contrib>
<contrib contrib-type="author" xlink:type="simple"><name name-style="western"><surname>Bresciani</surname>
<given-names>Etienne</given-names>
<ext-link>https://orcid.org/0000-0002-6295-2176</ext-link>
</name>
<xref ref-type="aff" rid="aff7">
<sup>7</sup>
</xref>
</contrib>
<contrib contrib-type="author" xlink:type="simple"><name name-style="western"><surname>Figueroa</surname>
<given-names>Ronny</given-names>
</name>
<xref ref-type="aff" rid="aff3">
<sup>3</sup>
</xref>
</contrib>
<contrib contrib-type="author" xlink:type="simple"><name name-style="western"><surname>Pélissier</surname>
<given-names>Mathias</given-names>
</name>
<xref ref-type="aff" rid="aff3">
<sup>3</sup>
</xref>
</contrib>
<contrib contrib-type="author" xlink:type="simple"><name name-style="western"><surname>Guillaumot</surname>
<given-names>Luca</given-names>
</name>
<xref ref-type="aff" rid="aff8">
<sup>8</sup>
</xref>
</contrib>
<contrib contrib-type="author" xlink:type="simple"><name name-style="western"><surname>Touzeau</surname>
<given-names>Théa</given-names>
</name>
<xref ref-type="aff" rid="aff1">
<sup>1</sup>
</xref>
</contrib>
<contrib contrib-type="author" xlink:type="simple"><name name-style="western"><surname>Issolah</surname>
<given-names>Imene</given-names>
<ext-link>https://orcid.org/0009-0001-2903-4971</ext-link>
</name>
<xref ref-type="aff" rid="aff11">
<sup>11</sup>
</xref>
</contrib>
<contrib contrib-type="author" xlink:type="simple"><name name-style="western"><surname>Maugan</surname>
<given-names>Enzo</given-names>
</name>
<xref ref-type="aff" rid="aff1">
<sup>1</sup>
</xref>
</contrib>
<contrib contrib-type="author" xlink:type="simple"><name name-style="western"><surname>Bagagnan</surname>
<given-names>Rock S.</given-names>
</name>
<xref ref-type="aff" rid="aff1">
<sup>1</sup>
</xref>
</contrib>
<contrib contrib-type="author" xlink:type="simple"><name name-style="western"><surname>Vautier</surname>
<given-names>Camille</given-names>
<ext-link>https://orcid.org/0000-0002-9358-7271</ext-link>
</name>
<xref ref-type="aff" rid="aff1">
<sup>1</sup>
</xref>
</contrib>
<contrib contrib-type="author" xlink:type="simple"><name name-style="western"><surname>Sallou</surname>
<given-names>June</given-names>
</name>
<xref ref-type="aff" rid="aff9">
<sup>9</sup>
</xref>
</contrib>
<contrib contrib-type="author" xlink:type="simple"><name name-style="western"><surname>Bourcier</surname>
<given-names>Johan</given-names>
<ext-link>https://orcid.org/0000-0003-2947-9150</ext-link>
</name>
<xref ref-type="aff" rid="aff10">
<sup>10</sup>
</xref>
</contrib>
<contrib contrib-type="author" xlink:type="simple"><name name-style="western"><surname>Combemale</surname>
<given-names>Benoit</given-names>
</name>
<xref ref-type="aff" rid="aff11">
<sup>11</sup>
</xref>
</contrib>
<contrib contrib-type="author" xlink:type="simple"><name name-style="western"><surname>Brunner</surname>
<given-names>Philip</given-names>
<ext-link>https://orcid.org/0000-0001-6304-6274</ext-link>
</name>
<xref ref-type="aff" rid="aff3">
<sup>3</sup>
</xref>
</contrib>
<contrib contrib-type="author" xlink:type="simple"><name name-style="western"><surname>Longuevergne</surname>
<given-names>Laurent</given-names>
</name>
<xref ref-type="aff" rid="aff1">
<sup>1</sup>
</xref>
</contrib>
<contrib contrib-type="author" xlink:type="simple"><name name-style="western"><surname>Aquilina</surname>
<given-names>Luc</given-names>
</name>
<xref ref-type="aff" rid="aff1">
<sup>1</sup>
</xref>
</contrib>
<contrib contrib-type="author" xlink:type="simple"><name name-style="western"><surname>de Dreuzy</surname>
<given-names>Jean-Raynald</given-names>
</name>
<xref ref-type="aff" rid="aff1">
<sup>1</sup>
</xref>
</contrib>
</contrib-group><aff id="aff1">
<label>1</label>
<addr-line>Geosciences Rennes – UMR 6118, CNRS, Université de Rennes, Rennes, France</addr-line>
</aff>
<aff id="aff2">
<label>2</label>
<addr-line>Laboratoire de Météorologie Dynamique (LMD), CNRS, Sorbonne Université, Paris, France</addr-line>
</aff>
<aff id="aff3">
<label>3</label>
<addr-line>Centre for Hydrogeology and Geothermics (CHYN), Université de Neuchâtel, Neuchâtel, Switzerland</addr-line>
</aff>
<aff id="aff4">
<label>4</label>
<addr-line>UMR SAS 1069, INRAE, Centre Bretagne-Normandie, Rennes, France</addr-line>
</aff>
<aff id="aff5">
<label>5</label>
<addr-line>UR RiverLy, INRAE, Centre Lyon-Grenoble Auvergne-Rhône-Alpes, Villeurbanne, France</addr-line>
</aff>
<aff id="aff6">
<label>6</label>
<addr-line>Pontificia Universidad Católica de Chile, Santiago, Chile</addr-line>
</aff>
<aff id="aff7">
<label>7</label>
<addr-line>Instituto de Ciencias de la Ingeniería, Universidad de O’Higgins, Rancagua, Chile</addr-line>
</aff>
<aff id="aff8">
<label>8</label>
<addr-line>BRGM, F-45060 Orléans, France</addr-line>
</aff>
<aff id="aff9">
<label>9</label>
<addr-line>INF, Wageningen University &amp; Research, Wageningen, Netherlands</addr-line>
</aff>
<aff id="aff10">
<label>10</label>
<addr-line>ISA/LIUPPA, Université de Pau et des Pays de l’Adour, Pau, France</addr-line>
</aff>
<aff id="aff11">
<label>11</label>
<addr-line>Inria, IRISA, CNRS, Université de Rennes, Rennes, France</addr-line>
</aff>
<pub-date pub-type="epub">
<day>27</day>
<month>02</month>
<year>2026</year>
</pub-date>
<volume>2026</volume>
<fpage>1</fpage>
<lpage>31</lpage>
<permissions>
<copyright-statement>Copyright: &#x000a9; 2026 Alexandre Gauvain et al.</copyright-statement>
<copyright-year>2026</copyright-year>
<license license-type="open-access">
<license-p>This work is licensed under the Creative Commons Attribution 4.0 International License. To view a copy of this licence, visit <ext-link ext-link-type="uri"  xlink:href="https://creativecommons.org/licenses/by/4.0/">https://creativecommons.org/licenses/by/4.0/</ext-link></license-p>
</license>
</permissions>
<self-uri xlink:href="https://egusphere.copernicus.org/preprints/2026/egusphere-2026-868/">This article is available from https://egusphere.copernicus.org/preprints/2026/egusphere-2026-868/</self-uri>
<self-uri xlink:href="https://egusphere.copernicus.org/preprints/2026/egusphere-2026-868/egusphere-2026-868.pdf">The full text article is available as a PDF file from https://egusphere.copernicus.org/preprints/2026/egusphere-2026-868/egusphere-2026-868.pdf</self-uri>
<abstract>
<p>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 &amp;mdash; including stream network maps and stream intermittency patterns &amp;mdash; 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.</p>
</abstract>
<counts><page-count count="31"/></counts>
</article-meta>
</front>
<body/>
<back>
</back>
</article>