Metadata-Version: 2.4
Name: canopy-tools
Version: 0.8.1
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"
Dynamic: license-file

[![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)
[![Docs Status](https://readthedocs.org/projects/canopy-tools/badge/?version=stable)](https://canopy-tools.readthedocs.io/)
[![PyPI Downloads](https://img.shields.io/pypi/dm/canopy-tools.svg?label=PyPI%20downloads)](https://pypi.org/project/canopy-tools/)
[![Conda Downloads](https://img.shields.io/conda/dn/conda-forge/canopy-tools.svg)](https://anaconda.org/conda-forge/canopy-tools)

[![documentation website](https://img.shields.io/badge/documentation_website-4FCA21)](https://canopy-tools.readthedocs.io/)
[![mattermost channel](https://img.shields.io/badge/mattermost_channel-182339)](https://mattermost.imk-ifu.kit.edu/lpj-guess/channels/canopy---help-desk)
[![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)

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

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

# 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.

### Technical documentation

- [Spatial Reduction Operations](https://canopy-tools.readthedocs.io/en/latest/technical_documentation.html#spatial-reduction-operations)

# 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 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 [github issues](https://codebase.helmholtz.cloud/canopy/canopy/-/issues).

If you have any questions or suggestions, you can also reach the cano**py** community through [our mattermost](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/).
