Preprints
https://doi.org/10.5194/egusphere-2026-2478
https://doi.org/10.5194/egusphere-2026-2478
26 May 2026
 | 26 May 2026
Status: this preprint is open for discussion and under review for Earth Surface Dynamics (ESurf).

TopoToolbox 3, a laboratory for quantitative geomorphology

William Kearney, Gina Arnau, Theophil Bringezu, Michael Dietze, Boris Gailleton, Anna-Lena Lamprecht, Kilian Lenz, Richard Ott, Dirk Scherler, Philippe Steer, and Wolfgang Schwanghart

Abstract. TopoToolbox has been widely used to analyze and model landscapes across geomorphology and other geospatial disciplines for the past 15 years. Its documentation and accessible interfaces have made it a valuable resource for teaching and learning quantitative geomorphology while its customizability and efficiency have allowed researchers to use it as a platform for experimentation and implementation of their own analyses and models. Its third version, TopoToolbox 3, builds on these developments by improving access to the software, integrating with a larger ecosystem of geomorphology software, and establishing sustainable research software engineering practices. TopoToolbox, previously available only on the MATLAB platform, is now also available to users of Python, and an R interface is under development. The redesigned architecture of TopoToolbox 3 is based on a shared library of core computational routines that makes these and other integrations possible while maintaining the MATLAB interface for existing users of the software. We illustrate the power of this design with examples of how users can integrate TopoToolbox into their workflows. First, we compare the implementation of a basic application, $\chi$ maps, in MATLAB and Python. Second, we use the GraphFlood hydraulic model, now available in TopoToolbox, to showcase the potential of integrating simulation tools and analyzing their output in one computational environment. Third, we demonstrate a two-way coupling between TopoToolbox and the Python-based Landlab landscape evolution modeling framework. Finally, we show how property-based testing can successfully identify bugs in the absence of known solutions to test cases. We conclude by discussing how improved quality assurance and community-driven development practices ensure that TopoToolbox continues to serve the evolving needs of the geomorphology community.

Competing interests: Some authors are members of the editorial board of journal Earth Surface Dynamics.

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
William Kearney, Gina Arnau, Theophil Bringezu, Michael Dietze, Boris Gailleton, Anna-Lena Lamprecht, Kilian Lenz, Richard Ott, Dirk Scherler, Philippe Steer, and Wolfgang Schwanghart

Status: open (until 07 Jul 2026)

Comment types: AC – author | RC – referee | CC – community | EC – editor | CEC – chief editor | : Report abuse
William Kearney, Gina Arnau, Theophil Bringezu, Michael Dietze, Boris Gailleton, Anna-Lena Lamprecht, Kilian Lenz, Richard Ott, Dirk Scherler, Philippe Steer, and Wolfgang Schwanghart

Model code and software

topotoolbox3 William Kearney, Wolfgang Schwanghart, Dirk Scherler, Richard Ott, Gina Arnau https://doi.org/10.5281/zenodo.20322894

libtopotoolbox William Kearney, Boris Gailleton, Gina Arnau, Theophil Bringezu, Florian Katerndahl, Kilian Lenz, Wolfgang Schwanghart https://doi.org/10.5281/zenodo.20269315

pytopotoolbox William Kearney, Boris Gailleton, Theophil Bringezu, Gina Arnau, Luca Malatesta, François Faure, Xiaochuan Ye https://doi.org/10.5281/zenodo.20209621

Interactive computing environment

TopoToolbox Gallery William Kearney, Wolfgang Schwanghart, Boris Gailleton https://doi.org/10.5281/zenodo.20270725

William Kearney, Gina Arnau, Theophil Bringezu, Michael Dietze, Boris Gailleton, Anna-Lena Lamprecht, Kilian Lenz, Richard Ott, Dirk Scherler, Philippe Steer, and Wolfgang Schwanghart
Metrics will be available soon.
Latest update: 27 May 2026
Download
Short summary
TopoToolbox is a software package that enables users to analyze maps of the Earth's surface. The newest version of TopoToolbox makes it accessible to more users, makes it easier to integrate TopoToolbox with other software used to study the Earth's surface and establishes a new development process to ensure that TopoToolbox continues to meet the needs of its community of users. We present a series of examples to demonstrate how users can incorporate the new TopoToolbox version into their work.
Share