pyGuidos#
pyGuidos is a Python interface to the main modules of GuidosToolbox (GTB), a scientific software suite developed at the European Commission Joint Research Centre (JRC) for the spatial pattern analysis of raster images.
pyGuidos provides programmatic access to GTB analytical tools, enabling reproducible landscape analysis workflows in Python scripts, Jupyter notebooks, and automated pipelines.
Note
This documentation describes pyGuidos version 2.0.0. For older versions, please refer to the legacy documentation branch.
Getting Started#
If you are new to pyGuidos, we recommend following these steps:
Installation: Follow the Installation guide to set up the library and the GTB engines.
Interactive Help: Use the built-in helper to explore available tools:
import pyguidos as pg pg.info()
User Guide: Browse the User Guide for detailed examples of MSPA, Fragmentation, and other analysis tools.
Citation#
If you use pyGuidos in your research, please cite both the software implementation and the underlying scientific methodology:
Important
- Software Implementation
Caudullo G. and Vogt P. (2026). pyGuidos: A cross-platform Python interface to GuidosToolbox for landscape pattern analysis. In press.
- Methodology (GTB)
Vogt P. and Riitters K. (2017). GuidosToolbox: universal digital image object analysis. European Journal of Remote Sensing, 50, 1, pp. 352-361. doi: 10.1080/22797254.2017.1330650
License#
This project is licensed under the European Union Public Licence (EUPL-1.2). The EUPL is a modern, copyleft free software license, providing a legal framework compatible with the laws of the European Union Member States.
For more details, see the official EUPL page.