Metadata-Version: 2.4
Name: esbmtk
Version: 0.14.3.1.post0
Summary: The Earth Science Box Modeling Toolkit
Home-page: https://github.com/uliw/esbmtk
Author: Ulrich G. Wortmann
Author-email: uli.wortmann@utoronto.ca
License: GPL-3.0-or-later
Project-URL: Documentation, https://esbmtk.readthedocs.io/en/latest/
Project-URL: Source, https://github.com/uliw/esbmtk
Project-URL: Changelog, https://github.com/uliw/esbmtk/blob/master/CHANGELOG.rst
Platform: any
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Classifier: Intended Audience :: Education
Classifier: Intended Audience :: Science/Research
Classifier: Topic :: Scientific/Engineering :: Chemistry
Requires-Python: >=3.12
Description-Content-Type: text/markdown; charset=UTF-8
License-File: LICENSE.txt
Requires-Dist: PyCO2SYS>=1.8.3.3
Requires-Dist: numpy
Requires-Dist: pandas
Requires-Dist: matplotlib
Requires-Dist: numba
Requires-Dist: pint
Requires-Dist: psutil
Requires-Dist: scipy
Requires-Dist: cachetools
Requires-Dist: setuptools
Requires-Dist: importlib-metadata
Provides-Extra: testing
Requires-Dist: setuptools; extra == "testing"
Requires-Dist: pytest; extra == "testing"
Dynamic: license-file

<a href="https://pypi.org/project/esbmtk/">
<img alt="Documentation Status" src="https://img.shields.io/pypi/v/esbmtk.svg"/>
</a>
<a href="https://pyscaffold.org">
<img alt="Project generated with PyScaffold" src="https://img.shields.io/badge/-PyScaffold-005CA0?logo=pyscaffold"/>
</a>
<a href="https://esbmtk.readthedocs.io/en/latest/?badge=latest">
<img alt="Documentation Status" src="https://readthedocs.org/projects/esbmtk/badge/?version=latest" />
</a>
<a href="https://www.python.org/doc/versions/">
  <img alt="Python 3.12 ready" src="https://img.shields.io/badge/python-3.12-blue" />
</a>
<a href="https://doi.org/10.5281/zenodo.14549407"><img src="https://zenodo.org/badge/DOI/10.5281/zenodo.14549407.svg" alt="DOI"></a>
<a href="https://anaconda.org/conda-forge/scores"> <img src="https://anaconda.org/conda-forge/scores/badges/version.svg" /> </a>
<a href="https://anaconda.org/conda-forge/scores"> <img src="https://anaconda.org/conda-forge/scores/badges/latest_release_relative_date.svg" /> </a>


# ESBMTK - The  Earth Sciences Box Modeling Toolkit:  A Python Library for Research and Teaching

<img src="https://raw.githubusercontent.com/uliw/esbmtk/staging/mpc.png" width="600px" align="center">"

The Earth Science Box Modeling Toolkit (ESBMTK) is a user-friendly Python library that simplifies the creation of models to study Earth system processes, such as the carbon cycle and ocean chemistry. It enhances learning by emphasizing concepts over programming and is accessible to students and researchers alike. By abstracting complex calculations and promoting code clarity, ESBMTK accelerates model development while improving reproducibility and the usability of scientific research. It uses an object oriented declarative approach to describe models, and encapsulated typical modeling tasks like gas-exchange and carbonate dissolution through python classes. See Wortmann et al. 2025 <https://gmd.copernicus.org/articles/18/1155/2025/> as well as the manual at <https://esbmtk.readthedocs.io/> for installation instructions, usage, and example code.

Note: ESBMTK 0.14.3.x is a major update that now requires python 3.14.

-   ESBMTK now has an excel interface that provides an easy way to define reservoirs, and transport matrix connections.
-   ESBMTK now supports Nitrogen species and isotopes
-   added a new carbonate chemistry module that supports fractional fluxes
-   Implemented native support for particulate species.
-   Reworked signal isotope calculations, added sanity checks for scaled connections, and added tests for species-to-species signal scaling.

ESBMTK is available via

-   GitHub `git clone https://github.com/uliw/esbmtk.git`
-   pypi <https://pypi.org/project/esbmtk/>
-   conda-forge <https://anaconda.org/conda-forge/esbmtk>
-   sample code is available at <https://github.com/uliw/ESBMTK-Examples>
-   See the documentation at <https://esbmtk.readthedocs.io/> and <https://gmd.copernicus.org/articles/18/1155/2025/>

ESBMTK is under active development, before updating, please check the [Changelog](https://esbmtk.readthedocs.io/en/latest/changelog.html)
