tipmip-toad 1.0.2__tar.gz

tipmip_toad-1.0.2/LICENSE.txt

@@ -0,0 +1,11 @@
+BSD 2-Clause License
+
+Copyright 2026 TOAD Developers
+
+Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS “AS IS” AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

tipmip_toad-1.0.2/PKG-INFO

@@ -0,0 +1,157 @@
+Metadata-Version: 2.4
+Name: tipmip-toad
+Version: 1.0.2
+Summary: Tipping and Other Abrupt events Detector
+Author-email: Jakob Harteg <jakob.harteg@pik-potsdam.de>, Lukas Roehrich <lukas.roehrich@pik-potsdam.de>, Sina Loriani <sina.loriani@pik-potsdam.de>
+Maintainer-email: Jakob Harteg <jakob.harteg@pik-potsdam.de>
+License-Expression: BSD-2-Clause
+Project-URL: Homepage, https://tipmip.pik-potsdam.de/
+Project-URL: Repository, https://github.com/tipmip-methods/toad
+Keywords: tipping,tipping points,climate,abrupt shifts,earth system
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Topic :: Scientific/Engineering
+Classifier: Topic :: Scientific/Engineering :: Atmospheric Science
+Classifier: Topic :: Scientific/Engineering :: Oceanography
+Classifier: Intended Audience :: Science/Research
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE.txt
+Requires-Dist: numpy<2.3.0,>=2.2.0
+Requires-Dist: matplotlib
+Requires-Dist: scipy<1.17.0,>=1.15.0
+Requires-Dist: scikit-learn<1.8.0,>=1.7.1
+Requires-Dist: xarray
+Requires-Dist: netcdf4
+Requires-Dist: cartopy
+Requires-Dist: pandas
+Requires-Dist: numba
+Requires-Dist: healpix
+Requires-Dist: optuna
+Requires-Dist: cftime
+Requires-Dist: joblib
+Requires-Dist: tqdm-joblib
+Provides-Extra: dev
+Requires-Dist: pre-commit; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Requires-Dist: deptry; extra == "dev"
+Dynamic: license-file
+
+<div align="center">
+
+![TOAD](docs/source/resources/toad.png)
+
+# TOAD: **T**ipping and **O**ther **A**brupt events **D**etector
+
+[![Documentation](https://img.shields.io/badge/docs-toad--docs-blue)](https://toad-docs.pages.dev)
+[![PyPI version](https://img.shields.io/badge/PyPI-coming%20soon-lightgrey)]()
+[![CI](https://github.com/tipmip-methods/toad/actions/workflows/build_and_tests.yml/badge.svg)](https://github.com/tipmip-methods/toad/actions/workflows/build_and_tests.yml)
+[![Python](https://img.shields.io/badge/python-3.10%20%7C%203.12-blue)](https://www.python.org/) [![License](https://img.shields.io/badge/license-BSD--2--Clause-blue)](LICENSE.txt) <br>
+[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.18316437.svg)](https://doi.org/10.5281/zenodo.18316437) 
+[![Code style](https://img.shields.io/badge/code%20style-ruff-black)](https://github.com/astral-sh/ruff)
+
+</div>
+
+TOAD is a **Python** package designed for **detecting and clustering spatio-temporal patterns in gridded Earth-system  datasets**, such as model outputs. The input data should be structured as a 3D array in the format `space` × `space` × `time`, where `time` can represent actual time or some other forcing variable or bifurcation parameter. TOAD provides a streamlined pipeline for identifying and analyzing spatio-temporal regions or clusters that exhibit similar dynamical responses to external forcing.
+
+Currently, TOAD focuses on identifying regions that experience similar abrupt transitions, such as the sudden loss of ice volume in a specific area. The goal, however, is to expand the package's functionality to support broader use cases, enabling the detection and clustering of diverse types of dynamical shifts across a wide range of systems.
+
+The TOAD pipeline consists of three main components:
+
+1. **Shift Detection:** Performs time series analysis at each individual grid cell to identify abrupt transitions or dynamical shifts using configurable detection methods (e.g., ASDETECT) with adjustable sensitivity parameters.
+2. **Clustering:** Groups the detected shifts spatially and temporally (or along a bifurcation parameter) to reveal cohesive patterns using clustering methods (e.g., HDBSCAN) with configurable space/time scaling.
+3. **Aggregation & Synthesis:** Aggregates results across multiple cluster maps from different datasets, models, variables, realisations, or methods to produce consensus clusters and statistics, and generates plots and summaries of the identified clusters for insights and interpretation.
+
+
+![TOAD](docs/source/resources/TOAD_pipeline.png?)
+
+TOAD's core functionality is exposed through the `TOAD` class, which analyzes netCDF files or xarray datasets. The primary methods - `compute_shifts`, `compute_clusters`, and `aggregate.cluster_consensus()` - handle the three main pipeline steps. The pipeline supports aggregation of results across multiple runs, enabling consensus-based analysis. Additional helper functions and visualization tools make it easy to explore and understand the results.
+
+
+## Installation
+
+Until TOAD is published on pip/conda you can install it like this:
+
+```bash
+$ git clone https://github.com/tipmip-methods/toad.git
+$ cd toad
+$ pip install .
+```
+
+### Simple use case
+
+```python
+from toad import TOAD
+from toad.shifts import ASDETECT
+from sklearn.cluster import HDBSCAN
+
+
+# init TOAD object with ice-thickness field and a custom time dimension.
+td = TOAD("ice_thickness.nc", time_dim="GMST")
+
+# Compute shifts for variable 'thk' using the method ASDETECT (Boulton & Lenton, 2019)
+td.compute_shifts("thk", method=ASDETECT())
+
+# Compute clusters using HDBSCAN from scikit-learn (McInnes, 2017)
+td.compute_clusters(
+    var="thk",
+    method=HDBSCAN(min_cluster_size=10),
+    time_weight=1.5,
+)
+
+# Plot largest clusters in ccrs.SouthPolarStereo() projection
+td.plot.overview("thk", map_style={"projection": "south_pole"})
+```
+
+<div align="center">
+    <img src="docs/source/resources/cluster_overview_example.png" width="1000px" alt="Cluster Overview Example">
+</div>
+
+For more details, check out the tutorials.
+
+## Tutorials
+
+- [Basics](https://github.com/tipmip-methods/toad/blob/main/tutorials/basics.ipynb): Learn the core concepts and workflow
+- [Visualization](https://github.com/tipmip-methods/toad/blob/main/tutorials/visualisation_examples.ipynb): Explore the plotting capabilities
+- [Custom Clustering](https://github.com/tipmip-methods/toad/blob/main/tutorials/clustering_methods.ipynb): Implement your own clustering methods
+- [Custom Shift Detection](https://github.com/tipmip-methods/toad/blob/main/tutorials/shift_detection_methods.ipynb): Create new shift detection algorithms
+
+## Development
+
+```bash
+$ git clone https://github.com/tipmip-methods/toad.git
+$ cd toad
+$ pip install -e .[dev]
+```
+
+The `-e` flag installs the package in "editable" mode, which means changes to the source code are immediately reflected without needing to reinstall.
+
+For more information on contributing, code formatting, and our development workflow, see [CONTRIBUTING.md](CONTRIBUTING.md).
+
+## Citation
+
+If you use TOAD in your research, please cite:
+
+**TOAD package:**
+Harteg, J., Roehrich, L., De Maeyer, K., Garbe, J., Sakschewski, B., Klose, A. K., Donges, J., Winkelmann, R., and Loriani, S.: TOAD: Tipping and Other Abrupt events Detector, Zenodo, https://doi.org/10.5281/zenodo.18316437, 2026.
+
+*Note: This DOI always points to the latest release version.*
+
+**TOAD methodology paper (submitted):**
+Harteg, J., Roehrich, L., De Maeyer, K., Garbe, J., Sakschewski, B., Klose, A. K., Donges, J., Winkelmann, R., and Loriani, S.: TOAD v1.0: A Python Framework for Detecting Abrupt Shifts and Coherent Spatial Domains in Earth-System Data, Geosci. Model Dev., submitted, 2026.
+
+## License
+
+TOAD is licensed under the BSD 2-Clause License. See [LICENSE.txt](LICENSE.txt) for details.
+
+## References
+
+- Boulton, C. A., & Lenton, T. M. (2019). A new method for detecting abrupt shifts in time series. F1000Research, 8, 746. [https://doi.org/10.12688/F1000RESEARCH.19310.1](https://doi.org/10.12688/F1000RESEARCH.19310.1)
+- McInnes, L., Healy, J., & Astels, S. (2017). hdbscan: Hierarchical density based clustering. J. Open Source Softw., 2(11), 205. [https://doi.org/10.21105/joss.00205](https://doi.org/10.21105/joss.00205)
+- The scikit-learn developers. (2025). scikit-learn. Zenodo. [https://doi.org/10.5281/zenodo.591564](https://doi.org/10.5281/zenodo.591564)

tipmip_toad-1.0.2/README.md

@@ -0,0 +1,112 @@
+<div align="center">
+
+![TOAD](docs/source/resources/toad.png)
+
+# TOAD: **T**ipping and **O**ther **A**brupt events **D**etector
+
+[![Documentation](https://img.shields.io/badge/docs-toad--docs-blue)](https://toad-docs.pages.dev)
+[![PyPI version](https://img.shields.io/badge/PyPI-coming%20soon-lightgrey)]()
+[![CI](https://github.com/tipmip-methods/toad/actions/workflows/build_and_tests.yml/badge.svg)](https://github.com/tipmip-methods/toad/actions/workflows/build_and_tests.yml)
+[![Python](https://img.shields.io/badge/python-3.10%20%7C%203.12-blue)](https://www.python.org/) [![License](https://img.shields.io/badge/license-BSD--2--Clause-blue)](LICENSE.txt) <br>
+[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.18316437.svg)](https://doi.org/10.5281/zenodo.18316437) 
+[![Code style](https://img.shields.io/badge/code%20style-ruff-black)](https://github.com/astral-sh/ruff)
+
+</div>
+
+TOAD is a **Python** package designed for **detecting and clustering spatio-temporal patterns in gridded Earth-system  datasets**, such as model outputs. The input data should be structured as a 3D array in the format `space` × `space` × `time`, where `time` can represent actual time or some other forcing variable or bifurcation parameter. TOAD provides a streamlined pipeline for identifying and analyzing spatio-temporal regions or clusters that exhibit similar dynamical responses to external forcing.
+
+Currently, TOAD focuses on identifying regions that experience similar abrupt transitions, such as the sudden loss of ice volume in a specific area. The goal, however, is to expand the package's functionality to support broader use cases, enabling the detection and clustering of diverse types of dynamical shifts across a wide range of systems.
+
+The TOAD pipeline consists of three main components:
+
+1. **Shift Detection:** Performs time series analysis at each individual grid cell to identify abrupt transitions or dynamical shifts using configurable detection methods (e.g., ASDETECT) with adjustable sensitivity parameters.
+2. **Clustering:** Groups the detected shifts spatially and temporally (or along a bifurcation parameter) to reveal cohesive patterns using clustering methods (e.g., HDBSCAN) with configurable space/time scaling.
+3. **Aggregation & Synthesis:** Aggregates results across multiple cluster maps from different datasets, models, variables, realisations, or methods to produce consensus clusters and statistics, and generates plots and summaries of the identified clusters for insights and interpretation.
+
+
+![TOAD](docs/source/resources/TOAD_pipeline.png?)
+
+TOAD's core functionality is exposed through the `TOAD` class, which analyzes netCDF files or xarray datasets. The primary methods - `compute_shifts`, `compute_clusters`, and `aggregate.cluster_consensus()` - handle the three main pipeline steps. The pipeline supports aggregation of results across multiple runs, enabling consensus-based analysis. Additional helper functions and visualization tools make it easy to explore and understand the results.
+
+
+## Installation
+
+Until TOAD is published on pip/conda you can install it like this:
+
+```bash
+$ git clone https://github.com/tipmip-methods/toad.git
+$ cd toad
+$ pip install .
+```
+
+### Simple use case
+
+```python
+from toad import TOAD
+from toad.shifts import ASDETECT
+from sklearn.cluster import HDBSCAN
+
+
+# init TOAD object with ice-thickness field and a custom time dimension.
+td = TOAD("ice_thickness.nc", time_dim="GMST")
+
+# Compute shifts for variable 'thk' using the method ASDETECT (Boulton & Lenton, 2019)
+td.compute_shifts("thk", method=ASDETECT())
+
+# Compute clusters using HDBSCAN from scikit-learn (McInnes, 2017)
+td.compute_clusters(
+    var="thk",
+    method=HDBSCAN(min_cluster_size=10),
+    time_weight=1.5,
+)
+
+# Plot largest clusters in ccrs.SouthPolarStereo() projection
+td.plot.overview("thk", map_style={"projection": "south_pole"})
+```
+
+<div align="center">
+    <img src="docs/source/resources/cluster_overview_example.png" width="1000px" alt="Cluster Overview Example">
+</div>
+
+For more details, check out the tutorials.
+
+## Tutorials
+
+- [Basics](https://github.com/tipmip-methods/toad/blob/main/tutorials/basics.ipynb): Learn the core concepts and workflow
+- [Visualization](https://github.com/tipmip-methods/toad/blob/main/tutorials/visualisation_examples.ipynb): Explore the plotting capabilities
+- [Custom Clustering](https://github.com/tipmip-methods/toad/blob/main/tutorials/clustering_methods.ipynb): Implement your own clustering methods
+- [Custom Shift Detection](https://github.com/tipmip-methods/toad/blob/main/tutorials/shift_detection_methods.ipynb): Create new shift detection algorithms
+
+## Development
+
+```bash
+$ git clone https://github.com/tipmip-methods/toad.git
+$ cd toad
+$ pip install -e .[dev]
+```
+
+The `-e` flag installs the package in "editable" mode, which means changes to the source code are immediately reflected without needing to reinstall.
+
+For more information on contributing, code formatting, and our development workflow, see [CONTRIBUTING.md](CONTRIBUTING.md).
+
+## Citation
+
+If you use TOAD in your research, please cite:
+
+**TOAD package:**
+Harteg, J., Roehrich, L., De Maeyer, K., Garbe, J., Sakschewski, B., Klose, A. K., Donges, J., Winkelmann, R., and Loriani, S.: TOAD: Tipping and Other Abrupt events Detector, Zenodo, https://doi.org/10.5281/zenodo.18316437, 2026.
+
+*Note: This DOI always points to the latest release version.*
+
+**TOAD methodology paper (submitted):**
+Harteg, J., Roehrich, L., De Maeyer, K., Garbe, J., Sakschewski, B., Klose, A. K., Donges, J., Winkelmann, R., and Loriani, S.: TOAD v1.0: A Python Framework for Detecting Abrupt Shifts and Coherent Spatial Domains in Earth-System Data, Geosci. Model Dev., submitted, 2026.
+
+## License
+
+TOAD is licensed under the BSD 2-Clause License. See [LICENSE.txt](LICENSE.txt) for details.
+
+## References
+
+- Boulton, C. A., & Lenton, T. M. (2019). A new method for detecting abrupt shifts in time series. F1000Research, 8, 746. [https://doi.org/10.12688/F1000RESEARCH.19310.1](https://doi.org/10.12688/F1000RESEARCH.19310.1)
+- McInnes, L., Healy, J., & Astels, S. (2017). hdbscan: Hierarchical density based clustering. J. Open Source Softw., 2(11), 205. [https://doi.org/10.21105/joss.00205](https://doi.org/10.21105/joss.00205)
+- The scikit-learn developers. (2025). scikit-learn. Zenodo. [https://doi.org/10.5281/zenodo.591564](https://doi.org/10.5281/zenodo.591564)

tipmip_toad-1.0.2/docs/source/conf.py

@@ -0,0 +1,178 @@
+import inspect  # needed in linkcode py-function to connect documentation to source link
+import os
+import sys
+
+module_path = os.path.abspath(os.path.join(os.path.dirname(__file__), "../.."))
+sys.path.insert(0, module_path)
+
+# Configuration file for the Sphinx documentation builder.
+#
+# For the full list of built-in configuration values, see the documentation:
+# https://www.sphinx-doc.org/en/master/usage/configuration.html
+
+# -- Project information -----------------------------------------------------
+# https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information
+
+project = "toad"
+copyright = "2026, TOAD Developers"
+author = "TOAD Developers"
+language = "en"
+
+# -- General configuration ---------------------------------------------------
+# https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration
+
+extensions = [
+    "sphinx.ext.doctest",
+    "sphinx.ext.autodoc",
+    "sphinx.ext.doctest",
+    "sphinx.ext.autosummary",
+    # "sphinx.ext.linkcode",
+    "sphinx.ext.napoleon",  # Support for NumPy and Google style docstrings
+    "sphinx.ext.autodoc.typehints",  # to pull types from function definitions
+    #'sphinx.ext.viewcode',
+    "myst_nb",  # allows to include Jupyter Notebooks and Markdowns
+]
+autodoc_default_options = {
+    "members": True,
+    "undoc-members": True,
+    "private-members": False,
+    "show-inheritance": True,
+    "special-members": False,  # Exclude special methods like __init__, __repr__, etc.
+    "exclude-members": "__weakref__,__dict__,__module__,__doc__,__slots__",  # Exclude problematic attributes
+    "show-signature": True,
+    "show-signature-with-docstring": False,  # Don't show docstring in signature for dataclasses
+}
+autosummary_generate = True
+myst_fence_as_directive = ["mermaid"]
+myst_heading_anchors = 2  # depth of implicit target for cross references -> needed for git_version_control.rst
+
+nb_execution_mode = "off"  # Prevent myst_nb from executing notebooks
+
+# Autodoc type hints settings
+autodoc_typehints = "description"
+autodoc_typehints_format = "short"
+
+# Napoleon settings
+napoleon_google_docstring = True
+napoleon_numpy_docstring = True
+napoleon_include_init_with_doc = False
+napoleon_include_private_with_doc = False
+napoleon_include_special_with_doc = True
+napoleon_use_admonition_for_examples = False
+napoleon_use_admonition_for_notes = False
+napoleon_use_admonition_for_references = False
+napoleon_use_ivar = False
+napoleon_use_param = True
+napoleon_use_keyword = True
+napoleon_use_rtype = True
+napoleon_preprocess_types = True
+napoleon_type_aliases = None
+napoleon_attr_annotations = True
+napoleon_include_ivar_with_doc = False  # Don't show instance variables for dataclasses
+
+templates_path = ["_templates"]
+exclude_patterns = []
+master_doc = "sidebar_main_nav_links"
+modindex_common_prefix = ["toad."]  # ignored prefixes for module index sorting
+
+
+remove_from_toctrees = [
+    "generated/*"
+]  # remove generated files from the table of contents, this folder is created by the sphinx-apidoc command
+
+
+# -- Options for HTML output -------------------------------------------------
+# https://www.sphinx-doc.org/en/master/usage/configuration.html#options-for-html-output
+
+html_theme = "sphinxawesome_theme"
+
+# Other themes to try in the future maybe:
+# html_theme = 'furo'
+# html_theme = 'sphinx_book_theme'
+
+html_static_path = ["_static", "resources"]
+html_css_files = [
+    "custom.css",
+]
+
+# -> Theme Specific HTML ouptut options
+html_sidebars = {"**": ["sidebar_main_nav_links.html", "sidebar_toc.html"]}
+html_logo = "resources/toad.png"
+html_permalinks_icon = "<span>¶</span>"  # change the default anchor icon, paragraph mark only appears when hovering over the heading
+
+# -- Function for sphinx extention linkcode -------------------------------
+
+# Look at xarray documentation for a more elaborate example.
+
+
+def linkcode_resolve(domain, info):
+    """
+    Determine the URL corresponding to Python object.
+    The implementation is based on xarray doc/source/conf.py.
+    """
+    if domain != "py":
+        print(f"\nWARNING: Domain is not 'py'. Object: {domain}")
+        return None
+    if not info["module"]:
+        print(f"\nWARNING: Module is not specified. Object: {info}")
+        return None
+
+    modname = info["module"]
+    fullname = info["fullname"]
+
+    submod = sys.modules.get(modname)
+    if submod is None:
+        print(f"\nWARNING: Could not find module. Object: {submod}")
+        return None
+
+    obj = submod
+    for part in fullname.split("."):
+        try:
+            obj = getattr(obj, part)
+        except AttributeError:
+            print(f"\nWARNING: Could not find attribute. Object: {obj}")
+            return None
+
+    # **Skip properties to avoid the error**
+    if isinstance(obj, property):
+        return None
+
+    # **Skip dataclass instances to avoid the error**
+    if hasattr(obj, "__class__") and hasattr(obj.__class__, "__dataclass_fields__"):
+        return None
+
+    # **Skip Numba JIT-compiled functions to avoid CPUDispatcher error**
+    if hasattr(obj, "__class__") and "CPUDispatcher" in str(type(obj)):
+        return None
+
+    try:
+        # Get the source file and line numbers
+        sourcefile = inspect.getsourcefile(obj)
+        if sourcefile is None:
+            print(f"\nWARNING: No source file found. Object: {sourcefile}")
+            return None
+
+        source, lineno = inspect.getsourcelines(obj)
+    except OSError:
+        lineno = None
+
+    # identify start and end line number of code in source file
+    linespec = f"#L{lineno}-L{lineno + len(source) - 1}" if lineno else ""
+
+    # Check if toad module file exists and is not None
+    toad_module = sys.modules.get("toad")
+    if toad_module is None or toad_module.__file__ is None:
+        print("\nWARNING: Could not find toad module or its __file__ attribute")
+        return None
+
+    # Ensure sourcefile is not None before using it
+    if sourcefile is None:
+        print("\nWARNING: No source file found for object")
+        return None
+
+    # Adjust for objects imported into __init__.py
+    # Use the actual source file instead of relying on the module name
+    relpath = os.path.relpath(sourcefile, start=os.path.dirname(toad_module.__file__))
+
+    # Build the GitHub URL
+    return f"https://github.com/tipmip-methods/toad/tree/main/toad/{relpath}{linespec}"

tipmip_toad-1.0.2/pyproject.toml

@@ -0,0 +1,121 @@
+# toml-file started Feb 2025 by Lukas Röhrich
+#
+# This file acts as a configuration file for the toad package
+# by Potsdam Institute for Climate Impact Research, GER
+#
+# Tutorial on how to setup this config file:
+# https://packaging.python.org/en/latest/guides/writing-pyproject-toml/
+
+# choose build-backend
+[build-system]
+build-backend = "setuptools.build_meta"
+requires = [
+    "setuptools",
+]
+
+# basic metadata
+[project]
+name = "tipmip-toad"
+dynamic = ["version"]
+description = "Tipping and Other Abrupt events Detector"
+readme = "README.md"
+keywords = ["tipping", "tipping points", "climate", "abrupt shifts", "earth system"]
+license = "BSD-2-Clause"
+requires-python = ">=3.10"
+authors = [
+    {name = "Jakob Harteg", email = "jakob.harteg@pik-potsdam.de"},
+    {name = "Lukas Roehrich", email = "lukas.roehrich@pik-potsdam.de"},
+    {name = "Sina Loriani", email = "sina.loriani@pik-potsdam.de"}
+]
+maintainers = [
+    {name = "Jakob Harteg", email = "jakob.harteg@pik-potsdam.de"}
+]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Topic :: Scientific/Engineering",
+    "Topic :: Scientific/Engineering :: Atmospheric Science",
+    "Topic :: Scientific/Engineering :: Oceanography",
+    "Intended Audience :: Science/Research",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Operating System :: OS Independent",
+]
+
+dependencies = [
+    "numpy>=2.2.0,<2.3.0",  # Pin to NumPy 2.2.x to ensure consistent BLAS/LAPACK implementation across platforms
+    "matplotlib",
+    "scipy>=1.15.0,<1.17.0",  # Python 3.10 gets 1.15.x, Python 3.11+ gets 1.16.x
+    "scikit-learn>=1.7.1,<1.8.0",  # Pin to scikit-learn 1.7.x for consistent HDBSCAN clustering results
+    "xarray",
+    "netcdf4",          # pipreqs didn't find this, but needed for xarray as optional dep to read *.nc files
+    "cartopy",
+    "pandas",
+    "numba",
+    "healpix",
+    "optuna",
+    "cftime",
+    "joblib",
+    "tqdm-joblib"
+]
+
+[project.optional-dependencies]
+dev = [
+    "pre-commit",
+    "ruff",
+    "pytest",
+    "pytest-cov",
+    "deptry",
+]
+
+[project.urls]
+Homepage = "https://tipmip.pik-potsdam.de/"
+Repository = "https://github.com/tipmip-methods/toad"
+
+[tool.setuptools]
+packages = {find = {}}
+
+[tool.setuptools.package-data]
+toad = ["py.typed"]
+
+[tool.setuptools.dynamic]
+version = {attr = "toad._version.__version__"}
+
+[tool.deptry.per_rule_ignores]
+DEP002 = ["netcdf4", "pre-commit", "ruff", "pytest", "pytest-cov", "deptry"]
+
+[tool.deptry]
+ignore_notebooks = true
+
+# suppress warning about assuming corresponding module name
+[tool.deptry.package_module_name_map]
+numpy = "numpy"
+matplotlib = "matplotlib"
+scipy = "scipy"
+xarray = "xarray"
+netcdf4 = "netcdf4"
+cartopy = "cartopy"
+pandas = "pandas"
+scikit-learn = "sklearn"
+numba = "numba"
+healpix = "healpix"
+optuna = "optuna"
+cftime = "cftime"
+joblib = "joblib"
+tqdm-joblib = "tqdm_joblib"
+
+[tool.mypy]
+python_version = "3.12"
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = false
+exclude = [
+    "build/",
+    "build/lib/",
+    "toad.egg-info/",
+    "docs/",
+    "tutorials/",
+    "test_artifacts/",
+    ".*",
+]

tipmip_toad-1.0.2/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+