Installation#

Note

Dépendances : QGIS et GDAL doivent être installés sur votre système avant d’utiliser le plugin deforisk. Sur les systèmes Unix-like, vous devez également installer osmconvert et osmfilter. Sur les systèmes Windows, ces dépendances sont déjà incluses dans le plugin sous forme de fichiers binaires .exe, vous n’avez donc pas besoin de les installer. Ensuite, les paquets Python forestatrisk et riskmapjnr doivent être installés sur votre système. Suivez les instructions ci-dessous pour installer ces dépendances.

Note

Installation : Nous décrivons ici deux façons d’installer le plugin deforisk :

  • La première option consiste à installer QGIS et GDAL sur votre système, puis à installer les paquets Python forestatrisk et riskmapjnr. Cette procédure d’installation dépend du système.

  • Une autre option consiste à utiliser conda/miniconda/mamba (l’un des trois) pour installer QGIS, GDAL, forestatrisk et riskmapjnr dans un environnement dédié. Cette procédure d’installation est indépendante du système.

Sous Windows#

Installer QGIS et GDAL sous Windows#

Pour installer QGIS et GDAL sur Windows, utilisez l’installateur réseau OSGeo4W. OSGeo4W est une distribution binaire d’un large ensemble de logiciels géomatiques libres pour les environnements Windows (Windows 11 à 7). Sélectionnez Express Install et installez QGIS et GDAL. Plusieurs Go d’espace disque seront nécessaires pour installer ces programmes. Ceci installera également OSGeo4W Shell pour exécuter les lignes de commande.

Installer les paquets Python forestatrisk et riskmapjnr sous Windows#

Pour installer les paquets Python forestatrisk et riskmapjnr, ouvrez OSGeo4W Shell, et utilisez pip.

python3.exe -m pip install --upgrade forestatrisk riskmapjnr

Note : En cas de problème, vous pouvez vérifier la version de Python utilisée par OSGeo4W en utilisant OSGeo Shell et que les roues des paquets pour forestatrisk et riskmapjnr sont bien disponibles sur PyPI pour vos versions de Windows et de Python. Actuellement, PyPI fournit des roues pour Python >= 3.9 pour Windows, Linux, et macOS en 64-bit.

python3.exe --version

Sur les systèmes de type Unix (Linux et macOS)#

Installer QGIS et GDAL sur des systèmes de type Unix#

Installez QGIS et GDAL sur votre système, par exemple en utilisant apt-get pour les distributions Linux Debian/Ubuntu.

sudo apt-get update
sudo apt-get install qgis gdal-bin libgdal-dev

Pour macOS, vous pouvez utiliser l’installateur disponible sur le site web de QGIS et installer GDAL en utilisant brew.

Après avoir installé GDAL, vous pouvez tester l’installation en lançant gdalinfo --version dans l’invite de commande ou le terminal, ce qui devrait afficher la version de GDAL installée.

Installez osmconvert et osmfilter.#

Sur les systèmes de type Unix, vous devez également installer osmconvert et osmfilter avant d’utiliser le plugin deforisk. osmconvert peut être utilisé pour convertir et traiter les fichiers OpenStreetMap tandis que osmfilter est un outil en ligne de commande utilisé pour filtrer les fichiers de données OpenStreetMap pour des balises spécifiques. Pour les installer sur votre système, suivez les instructions des pages web osmconvert et osmfilter.

Installer les paquets Python forestatrisk et riskmapjnr sur les systèmes de type Unix#

Sur les systèmes récents, vous ne pouvez pas utiliser pip pour installer les paquets Python sur l’ensemble du système. En conséquence, nous devons créer un environnement virtuel et y installer les paquets forestatrisk et riskmapjnr. Assurez-vous également d’installer les liens GDAL appropriés en utilisant gdal==$(gdal-config --version). Une fois que le paquet et ses dépendances ont été installés, vous pouvez désactiver l’environnement virtuel.

python3 -m venv /path/to/venv
source  /path/to/venv/bin/activate
python3 -m pip install --upgrade forestatrisk riskmapjnr gdal==$(gdal-config --version)
deactivate

Ensuite, dans le fichier Python startup.py, ajoutez les deux lignes suivantes, en adaptant le chemin à votre cas spécifique (vérifiez la version de Python). Ces deux lignes seront exécutées au démarrage de QGIS et ajouteront le chemin des paquets installés dans l’environnement virtuel au sys.path.

import sys
sys.path.append("/path/to/venv/lib/python3.11/site-packages/")

Utilisation de conda/miniconda (tous les systèmes d’exploitation)#

Cette méthode alternative présente l’avantage d’installer QGIS et GDAL ainsi que les paquets Python forestatrisk et riskmapjnr dans un environnement isolé et dédié, avec une version allégée de QGIS. Cependant, les inconvénients sont qu’il n’y a pas d’icônes de bureau QGIS ou d’association de fichiers, et que cette installation n’inclut pas GRASS et SAGA par exemple (bien qu’ils puissent être facilement installés avec conda par la suite).

Installer miniconda#

Conda (ou sa version minimale miniconda) est un gestionnaire de paquets et d’environnements. Pour installer miniconda, téléchargez l’installateur depuis le site miniconda et suivez les instructions pour votre système.

Installer QGIS et ses dépendances dans un nouvel environnement#

Dans un terminal, créez un nouvel environnement (nommé ici deforisk) et installez-y QGIS (via les paquets conda), forestatrisk et riskmapjnr. Attention, osmconvert et osmfilter doivent toujours être installés séparément sur les systèmes Linux et macOS (cf. section ci-dessus).

conda create -c conda-forge -n deforisk qgis  # create environment and install QGIS (and GDAL embedded)
conda activate deforisk        # activate the newly created environment
pip install --upgrade forestatrisk riskmapjnr # install additional Python packages

Vous pouvez maintenant lancer QGIS depuis le terminal en utilisant la commande qgis.

Désactiver et supprimer l’environnement#

Si vous souhaitez désactiver et supprimer l’environnement :

conda deactivate
conda env remove --name deforisk

Accès à GEE et WDPA#

Le plugin télécharge les données forestières de Google Earth Engine (GEE) en utilisant le paquet Python geefcc et les données sur les aires protégées de la World Database on Protected Areas (WDPA) en utilisant le paquet Python pywdpa. Vous aurez besoin d’un accès à GEE et WDPA pour pouvoir utiliser le plugin.

Accès à GEE#

Pour pouvoir utiliser GEE, vous aurez besoin soit (i) d’un compte Google et d’un projet Google Cloud enregistré pour utiliser Earth Engine, soit (ii) d’un compte de service vous permettant d’utiliser Google Earth Engine par l’intermédiaire d’un projet Google Cloud enregistré (dans ce cas, vous n’avez pas besoin de compte Google). Veuillez suivre ce lien si vous souhaitez enregistrer un projet pour utiliser Earth Engine.

Dans le plugin deforisk, pour l’argument Earth Engine access disponible dans l’onglet « Get variables », vous devez indiquer soit le nom d’un projet Google Cloud enregistré pour utiliser Earth Engine (et pour lequel vous êtes identifié en tant qu’utilisateur), soit un chemin vers un fichier de clé privée JSON vous autorisant à accéder à Earth Engine via un compte de service.

Accès à Earth Engine

Accès à WDPA#

Pour utiliser l’API de Protected Planet afin d’accéder aux données sur les aires protégées dans le monde, vous devez d’abord avoir obtenu une clé d’API personnelle en remplissant le formulaire disponible sur Protected Planet.

Dans le plugin deforisk, pour l’argument WDPA access disponible dans l’onglet « Get variables », vous devez indiquer soit votre clé d’API personnelle (une série de lettres et de chiffres comme ca4703ffba6b9a26b2db73f78e56e088 qui est une fausse clé) ou un chemin vers un fichier texte spécifiant la valeur de la variable d’environnement « WDPA_KEY » (par exemple, un simple fichier texte comprenant une ligne WDPA_KEY="ca4703ffba6b9a26b2db73f78e56e088").

Accès à WDPA

Installation du plugin deforisk dans QGIS#

  • Téléchargez le fichier zip deforisk depuis GitHub.

  • Ouvrir QGIS.

  • Dans la barre de menu de QGIS, allez dans Extensions > Installer/Gérer des extensions > Installer depuis un ZIP.

  • Sélectionnez le fichier zip qui a été téléchargé.