PyQGIS developer cookbook

PyQGIS developer cookbook
Version 2.14
QGIS Project
16 April 2017

Contents
1 Introduction 1
1.1 Exécuter un programme Python au démarrage de QGIS ...................... 2
1.2 La Console Python .......................................... 2
1.3 Extensions Python .......................................... 3
1.4 Applications Python ......................................... 3
2 Chargement de projets 7
3 Chargement de couches 9
3.1 Couches vectorielles ......................................... 9
3.2 Couches raster ............................................ 11
3.3 Registre de couches cartographiques ................................. 11
4 Utiliser des couches raster 13
4.1 Détails d’une couche ......................................... 13
4.2 Moteur de rendu ........................................... 13
4.3 Rafraîchir les couches ........................................ 15
4.4 Interrogation des données ...................................... 15
5 Utilisation de couches vectorielles 17
5.1 Récupérer les informations relatives aux attributs .......................... 17
5.2 Sélection des entités ......................................... 18
5.3 Itérer sur une couche vecteur ..................................... 18
5.4 Modifier des couches vecteur .................................... 20
5.5 Modifier des couches vecteur à l’aide d’un tampon d’édition .................... 21
5.6 Utilisation des index spatiaux .................................... 23
5.7 Ecrire dans des couches vecteur ................................... 23
5.8 Fournisseur de données en mémoire ................................. 24
5.9 Apparence (Symbologie) des couches vecteur ............................ 25
5.10 Sujets complémentaires ....................................... 33
6 Manipulation de la géométrie 35
6.1 Construction de géométrie ...................................... 35
6.2 Accéder à la Géométrie ....................................... 36
6.3 Prédicats et opérations géométriques ................................ 36
7 Support de projections 39
7.1 Système de coordonnées de référence ................................ 39
7.2 Projections .............................................. 40
8 Utiliser le Canevas de carte 41
8.1 Intégrer un canevas de carte ..................................... 41
8.2 Utiliser les outils cartographiques avec le canevas .......................... 42
i

8.3 Contour d’édition et symboles de sommets ............................. 43
8.4 Ecrire des outils cartographiques personnalisés ........................... 44
8.5 Ecrire des éléments de canevas de carte personnalisés ....................... 45
9 Rendu cartographique et Impression 47
9.1 Rendu simple ............................................. 47
9.2 Rendu des couches ayant différents SCR .............................. 48
9.3 Sortie utilisant un composeur de carte ................................ 48
10 Expressions, Filtrage et Calcul de valeurs 51
10.1 Analyse syntaxique d’expressions .................................. 52
10.2 Évaluation des expressions ...................................... 52
10.3 Exemples ............................................... 53
11 Lecture et sauvegarde de configurations 55
12 Communiquer avec l’utilisateur 57
12.1 Afficher des messages: La classe QgsMessageBar ........................ 57
12.2 Afficher la progression ........................................ 58
12.3 Journal ................................................ 59
13 Développer des extensions Python 61
13.1 Écriture d’une extension ....................................... 62
13.2 Contenu de l’extension ........................................ 63
13.3 Documentation ............................................ 67
13.4 Traduction .............................................. 67
14 Paramétrage de l’EDI pour la création et le débogage d’extensions 69
14.1 Note sur la configuration de l’EDI sous Windows .......................... 69
14.2 Débogage à l’aide d’Eclipse et PyDev ................................ 70
14.3 Débogage à l’aide de PDB ...................................... 74
15 Utiliser une extension de couches 75
15.1 Héritage de QgsPluginLayer ..................................... 75
16 Compatibilité avec les versions précédentes de QGIS 77
16.1 Menu Extension ........................................... 77
17 Publier votre extension 79
17.1 Métadonnées et noms ........................................ 79
17.2 Code et aide ............................................. 80
17.3 Dépôt officiel des extensions Python ................................. 80
18 Extraits de code 83
18.1 Comment appeler une méthode à l’aide d’un raccourci clavier ................... 83
18.2 Comment activer des couches: .................................... 83
18.3 Comment accéder à la table attributaire des entités sélectionnées .................. 84
19 Créer une extensions Processing 85
19.1 Créer une extension qui ajoute un fournisseur d’algorithmes .................... 85
19.2 Créer une extension qui contient un jeu de scripts de traitements .................. 85
20 Bibliothèque d’analyse de réseau 87
20.1 Information générale ......................................... 87
20.2 Construire un graphe ......................................... 87
20.3 Analyse de graphe .......................................... 89
21 Extensions Python pour QGIS Server 95
21.1 Architecture des extensions de filtre serveur ............................. 95
21.2 Raising exception from a plugin ................................... 97
ii

21.3 Écriture d’une extension serveur ................................... 97
21.4 Extension de contrôle d’accès ....................................100
Index 103
iii