Installation#
Version stable (recommandée)#
Ce plugin est publié sur le dépôt officiel des extensions QGIS : https://plugins.qgis.org/plugins/hedge_tools/.
Module LiDAR#
Tous les outils utilisant le LiDAR, à l’exception de Générer les éléments boisés, nécessitent des dépendances supplémentaires. Si ces dépendances ne sont pas disponibles, les algorithmes seront désactivés et n’apparaîtront pas dans la boîte à outils de traitement QGIS.
Installation des dépendances#
Windows
Il est recommandé d’installer les dépendances en utilisant l’installeur OSGeo4W. Lors de la sélection des librairies, assurez-vous de choisir :
python3-scipy.
pdal : PDAL – Point Data Abstraction Library (Executable).
python3-pdal : Point cloud data processing
Assurez-vous également d’avoir :
grass: GRASS GIS
gdal: The GDAL/OGR library and commandline tools
Après le redémarrage de QGIS, les algorithmes LiDAR devraient s’afficher. Sinon, un avertissement apparaîtra dans l’interface QGIS indiquant quelles dépendances sont manquantes.
Linux
Pour installer les dépendances, il est recommandé d’utiliser Anaconda pour installer QGIS et les dépendances LiDAR de HedgeTools. Si Anaconda n’est pas disponible sur votre système, vous pouvez suivre leur procédure d’installation.
Une fois Anaconda installé, il est recommandé de créer un nouvel environnement pour éviter les conflits avec d’autres dépendances :
Dans votre terminal :
conda create --name custom_name
Vous pouvez ensuite activer l’environnement :
conda activate custom_name
Ensuite, installez les dépendances et QGIS LTR dans votre environnement :
conda install -c conda-forge/label/qgis_ltr -c conda-forge qgis scipy pdal
Si vous souhaitez installer une version spécifique de QGIS :
conda install -c conda-forge qgis=3.40 scipy pdal
Enfin, vous pouvez lancer QGIS. Votre profil, vos extensions et vos paramètres par défaut devraient toujours être disponibles :
qgis
Après le démarrage de QGIS, l’algorithme LiDAR devrait s’afficher. Sinon, un avertissement apparaîtra dans l’interface QGIS indiquant quelle dépendance est manquante.
Remarque
Pour les futures utilisations, n’oubliez pas d’activer votre environnement anaconda avant de lancer QGIS.
Remarque
Si vous avez besoin de dépendances supplémentaires pour exécuter d’autres extensions, vous pouvez les installer avec : conda install [-c channel] [package…]
HedgeTools dans Python#
Le plugin fournit une API Python, rendant les algorithmes accessibles directement depuis votre IDE.
Prérequis#
QGIS >= 3.40 ainsi que ses bindings Python
Création d’un environnement virtuel#
Un environnement avec les bindings QGIS est nécessaire. Pour le créer facilement, je recommande d’utiliser qgis-venv-creator de GipsoCoding.
Dans votre terminal, vous pouvez éxécuter les commandes suivantes :
Installation de qgis-venv-creator
Installer avec pipx : pipx install qgis-venv-creator
Ou dans un environnement existant : pip install qgis-venv-creator
Créer votre environnement pyQGIS
create-qgis-venv –venv-name “qgis_bindings.venv”
Si plusieurs installations de QGIS sont détectées, l’invite de commandes vous demandera d’en choisir une.
Activer votre venv
qgis_bindings.venv/Scripts/activate
Vous devriez pouvoir utiliser les bindings Python de QGIS. Et si vous activez cet environnement dans votre IDE, l’autocomplétion devrait être disponible.
Vous pouvez ensuite utiliser HedgeTools dans votre IDE. La documentation est disponible dans la section API Python