Metadata-Version: 2.4
Name: canopy-tools
Version: 0.10.0
Summary: A python package to analyse LSM and DGVM outputs
Author-email: "David M. Belda" <david.belda@kit.edu>, Adrien Damseaux <adrien.damseaux@kit.edu>
License: MPL-2.0
Project-URL: Homepage, https://codebase.helmholtz.cloud/canopy/canopy
Keywords: climate outputs,dgvm,land surface model,visualization
Classifier: Development Status :: 1 - Planning
Classifier: Intended Audience :: Science/Research
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Topic :: Scientific/Engineering
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Typing :: Typed
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pandas>=2.2.0
Requires-Dist: xarray>=2025.3.0
Requires-Dist: numpy>=2.2.0
Requires-Dist: matplotlib>=3.10.0
Requires-Dist: typing_extensions>=4.13.0
Requires-Dist: tqdm>=4.67.0
Requires-Dist: cartopy>=0.24.0
Requires-Dist: seaborn>=0.13.0
Requires-Dist: scipy>=1.15.0
Requires-Dist: jenkspy>=0.4.0
Requires-Dist: regionmask>=0.13.0
Requires-Dist: pyjanitor>=0.31.0
Requires-Dist: numba>=0.61.2
Requires-Dist: geocat-viz>=2025.07.0
Provides-Extra: sphinx
Requires-Dist: sphinx; extra == "sphinx"
Requires-Dist: sphinx-rtd-theme; extra == "sphinx"
Provides-Extra: dev
Requires-Dist: pandas-stubs>=2.2.0; extra == "dev"
Requires-Dist: types-seaborn>=0.13.0; extra == "dev"
Requires-Dist: scipy-stubs>=1.15.0; extra == "dev"
Requires-Dist: types-tqdm>=4.67.0; extra == "dev"
Requires-Dist: xarray-stubs>=2025.3.0; extra == "dev"
Requires-Dist: mypy>=1.0.0; extra == "dev"
Dynamic: license-file

[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.17854845.svg)](https://doi.org/10.5281/zenodo.17854845)

<img src="https://codebase.helmholtz.cloud/canopy/canopy/-/raw/main/docs/_static/canopylogo_small.png" alt="Canopy Logo" width="350" height="auto">

**canopy** is an open source python project designed to support research in the field of vegetation dynamics and land surface modelling by providing tools for **manipulating**, **analysing**, and **visualising** Dynamic Global Vegetation Model (**DGVM**) **outputs**

[![Python Versions](https://img.shields.io/pypi/pyversions/canopy-tools.svg)](https://www.python.org/downloads/release/python-31210/)
[![PyPI Latest Release](https://img.shields.io/pypi/v/canopy-tools.svg)](https://pypi.org/project/canopy-tools/)
[![Conda Version](https://img.shields.io/conda/vn/conda-forge/canopy-tools.svg)](https://anaconda.org/conda-forge/canopy-tools)

[![pipeline status](https://codebase.helmholtz.cloud/canopy/canopy/badges/main/pipeline.svg)](https://codebase.helmholtz.cloud/canopy/canopy/-/pipelines)
[![documentation website](https://img.shields.io/badge/documentation_website-4FCA21)](https://canopy-tools.readthedocs.io/)
[![gallery website](https://img.shields.io/badge/gallery_website-1A79CE)](https://canopy.imk-ifu.kit.edu/)
[![notebooks gitlab](https://img.shields.io/badge/notebooks_gitlab-E24329)](https://codebase.helmholtz.cloud/canopy/notebooks)

# Installation

```bash
# Create a conda environment (optionnal)
conda create --name canopy python=3.12
conda activate canopy

# Use conda-forge to install canopy
conda install canopy-tools --channel conda-forge

# ... or pip
pip install canopy-tools
```

# Documentation

You can find the canopy documentation on [canopy-tools.readthedocs.io](https://canopy-tools.readthedocs.io/en/stable/)

### How to use

You can use canopy in two modes:

- [Interactive mode](https://canopy-tools.readthedocs.io/en/latest/quick_start.html#interactive-mode), an intuitive and flexible mode, to analyse data and generate figures using python functions

- [JSON mode](https://canopy-tools.readthedocs.io/en/latest/quick_start.html#json-mode), a easy-to-use and fast mode, to generate figures using a structured JSON configuration file

# Gallery website

[https://canopy.imk-ifu.kit.edu/](https://canopy.imk-ifu.kit.edu/)

**What is it?** An interactive website showcasing figures created with canopy, where each image links to the code that generated it. Users can also submit their own canopy code (Python and/or JSON) and figure to be featured, helping build a collection of examples that make learning canopy easy and inspiring

# Issue, questions or suggestions

If you find any bug, please report it on our [gitlab issues](https://codebase.helmholtz.cloud/canopy/canopy/-/issues)

If you have any questions or suggestions, you can also reach the **canopy** community through [our mattermost help-desk channel](https://mattermost.imk-ifu.kit.edu/lpj-guess/channels/canopy---help-desk)

# Authors

This project is being developed by David M. Belda & Adrien Damseaux from the [Global Land Ecosystem Modelling Group](https://lemg.imk-ifu.kit.edu/) at the [Karlsruhe Institute of Technology](https://www.kit.edu/)
