[](https://www.python.org/downloads/release/python-31210/)
[](https://codebase.helmholtz.cloud/canopy/canopy/-/pipelines)
[](https://canopy-tools.readthedocs.io/en/stable/?badge=stable)
[](https://pypi.org/project/canopy-tools/)
[](https://pypi.org/project/canopy-tools/)
<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)
# 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/).
Raw data
{
"_id": null,
"home_page": null,
"name": "canopy-tools",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.12",
"maintainer_email": null,
"keywords": "climate outputs, dgvm, land surface model, visualization",
"author": null,
"author_email": "\"David M. Belda\" <david.belda@kit.edu>, Adrien Damseaux <adrien.damseaux@kit.edu>",
"download_url": "https://files.pythonhosted.org/packages/49/7a/b86766adfea6cf4187c6d249c0d3fa40744dce85353cf739af6e16483466/canopy_tools-0.4.3.tar.gz",
"platform": null,
"description": "[](https://www.python.org/downloads/release/python-31210/)\n[](https://codebase.helmholtz.cloud/canopy/canopy/-/pipelines)\n[](https://canopy-tools.readthedocs.io/en/stable/?badge=stable)\n[](https://pypi.org/project/canopy-tools/)\n[](https://pypi.org/project/canopy-tools/)\n\n<img src=\"https://codebase.helmholtz.cloud/canopy/canopy/-/raw/main/docs/_static/canopylogo_small.png\" alt=\"Canopy Logo\" width=\"300\" height=\"auto\">\n\n**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**. \n\n# Installation\n\n```bash\n# Create a conda environment (optionnal)\nconda create --name canopy python=3.12\nconda activate canopy\n\n# Use conda-forge to install canopy\nconda install canopy-tools --channel conda-forge\n\n# ... or pip\npip install canopy-tools\n```\n\n# Documentation\n\nYou can find the canopy documentation on [canopy-tools.readthedocs.io](https://canopy-tools.readthedocs.io/en/stable/)\n\n### How to use\n\nYou can use canopy in two modes:\n\n- [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.\n\n- [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.\n\n### Technical documentation\n\n- [Spatial Reduction Operations](https://canopy-tools.readthedocs.io/en/latest/technical_documentation.html#spatial-reduction-operations)\n\n# Issue, questions or suggestions\n\nIf you find any bug, please report it on our [github issues](https://codebase.helmholtz.cloud/canopy/canopy/-/issues).\n\nIf 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).\n\n# Authors\n\nThis 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/).\n",
"bugtrack_url": null,
"license": "MPL-2.0",
"summary": "A python package to analyse LSM and DGVM outputs",
"version": "0.4.3",
"project_urls": {
"Homepage": "https://codebase.helmholtz.cloud/canopy/canopy"
},
"split_keywords": [
"climate outputs",
" dgvm",
" land surface model",
" visualization"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "829ffd8b6ec36d0989ba343f326cb6a399c22b9a2c53b07a999ed1a35bea80ab",
"md5": "1fe4a4b6893904bc85918a601fcc7b15",
"sha256": "8f378b20647605f2831ac827bcd6e7fa9c0dbc0f27057c29320606938d24356f"
},
"downloads": -1,
"filename": "canopy_tools-0.4.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "1fe4a4b6893904bc85918a601fcc7b15",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.12",
"size": 395358,
"upload_time": "2025-08-01T11:44:31",
"upload_time_iso_8601": "2025-08-01T11:44:31.921543Z",
"url": "https://files.pythonhosted.org/packages/82/9f/fd8b6ec36d0989ba343f326cb6a399c22b9a2c53b07a999ed1a35bea80ab/canopy_tools-0.4.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "497ab86766adfea6cf4187c6d249c0d3fa40744dce85353cf739af6e16483466",
"md5": "8eac629185aae61fde7d1d4af00832e2",
"sha256": "c45f2e768353315f760d334f0391725b11eb42b053309da30df2990dd740be09"
},
"downloads": -1,
"filename": "canopy_tools-0.4.3.tar.gz",
"has_sig": false,
"md5_digest": "8eac629185aae61fde7d1d4af00832e2",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.12",
"size": 5304637,
"upload_time": "2025-08-01T11:44:34",
"upload_time_iso_8601": "2025-08-01T11:44:34.192656Z",
"url": "https://files.pythonhosted.org/packages/49/7a/b86766adfea6cf4187c6d249c0d3fa40744dce85353cf739af6e16483466/canopy_tools-0.4.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-01 11:44:34",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "canopy-tools"
}
JSON