Le cours précédent de ce chapitre était consacré à l'ouverture de couche vecteur dans PyQGIS, ce cours permet d'apprendre à ouvrir un fichier raster.

Le dossier "SCAN", contenant les données utilisées dans ce cours, est téléchargeable via ce lien.

On commence par ouvrir la console Python dans Qgis et afficher l'éditeur (se référer à ce cours pour comprendre le fonctionnement de l'éditeur).

On saisit cette ligne de code:

• iface.addRasterLayer("D:/SCAN/SCAN_100/SC100_0440_6750_L93.tif","couche_raster", "gdal")

Information: remplacer "D:/SCAN" par le chemin vers le dossier SCAN téléchargé.

Explication du code:

• iface: un objet de la classe "QgisInterface" permettant d'accéder à l'interface Qgis pour utiliser les données qui y sont affichées, y afficher des données ou utiliser les fonctions natives de Qgis.
• AddRasterLayer: une fonction permettant d’ouvrir une couche raster dans Qgis .

Fonction addRasterLayer

Cette fonction permet d'ajouter des couches matricielles (raster) dans QGis.

Pour qu'elle fonctionne, et comme pour toutes les fonctions, elle a besoin d'un ensemble d'arguments.

Comme pour une recette ayant besoin d'un ensemble d'ingrédients pour qu'elle soit réussie, une fonction a besoin d'une ensemble d'arguments pour donner ses résultats.

Les éléments écrits entre guillemets et séparés par des virgules sont ces arguments.

La fonction addRasterLayer a cette syntaxe: addRasterLayer(data_source, layer_name, provider_name).

• data_source (source de données): le chemin d'accès aux données;
• Layer_name (nome de la couche): le nom qui sera affiché dans Qgis pour cette couche;
• provider_name (fournisseur de données) : c'est la bibliothèque permettant la lecture du format des données, pour les fichiers raster, avec extension "tif" par exemple, c'est la bibliothèque "gdal".

On lance le script.

La couche est affichée avec le nom "couche_raster".

Information:

Les arguments doivent être séparés avec des virgules;

Le chemin vers les données doit être construit avec des slashs (/);

Les arguments de type "text" doivent être mis entre double guillemets.