CSDMS3.0 - Bridging Boundaries

Hands-on with the Python Modeling Toolkit

Eric Hutton

CSDMS, United States

PyMT is the “Python Modeling Toolkit”. It is an Open Source Python package, developed by the Community Surface Dynamics Modeling System, that provides tools used to couple models that expose the Basic Model Interface (BMI). PyMT is:
  • a toolbox for coupling models of disparate time and space scales,
  • a collection of Earth-surface models, and
  • an extensible plug-in framework for user-contributed models.

In this hands-on clinic we will use Jupyter Notebooks to explore how to run standalone models within PyMT. Since all PyMT models are based on the BMI, they all share the same user interface and so if you know how to run one model, you know how to run all PyMT models. We will then look at some of the model-coupling tools packaged with PyMT and how they can be used for more complex couplings. We will then run through examples that use these tools to couple models to data as well as to other PyMT models.

We highly recommend that clinic attendees come with a laptop with the Anaconda Python distribution installed.

Please acknowledge the original contributors when you are using this material. If there are any copyright issues, please let us know ( and we will respond as soon as possible.

Of interest for:
  • Terrestrial Working Group
  • Coastal Working Group
  • Marine Working Group
  • Education and Knowledge Transfer (EKT) Working Group
  • Cyberinformatics and Numerics Working Group
  • Hydrology Focus Research Group
  • Carbonates and Biogenics Focus Research Group