Syntaxe et composants d’algèbre spatiale

Disponible avec une licence Spatial Analyst.

Comme tous les langages, l’algèbre spatiale comporte des règles spécifiques pour combiner les composants linguistiques.

La structure générale d’une instruction d’algèbre spatiale est un opérateur d’affectation (=), qui est utilisé pour séparer l’action, sur sa droite, du nom de la sortie (un objet raster), sur sa gauche. Une instruction prend la forme algébrique suivante :

Output_Name = Action

Composants d’algèbre spatiale

Les expressions d'algèbre spatiale comportent cinq composants : outils et fonctions, opérateurs, entrées, paramètres d’outil et données en sortie.

Outils et fonctions

Les outils de géotraitement et les fonctions (tels que Sin, Pente et Reclassification) sont utilisés dans des expressions d’algèbre spatiale.

Par exemple, pour calculer l'exposition de chaque cellule dans un raster, utilisez l'outil Exposition :

outRas = Aspect("C:/Data/inraster.tif")

• En savoir plus sur l’exécution des outils en algèbre spatiale

Opérateurs

Les opérateurs sont des symboles utilisés pour représenter les opérations mathématiques à appliquer à l'entrée.

Par exemple, ce qui suit est utilisé pour ajouter deux rasters :

outRas = Raster("inraster1.tif") + Raster("inraster2.tif")

De nombreux opérateurs sont utilisés en algèbre spatiale et dans Python ; les opérateurs sont surchargés. Lorsque vous appliquez des opérateurs aux jeux de données raster, vous devez redéfinir le jeu de données à l’aide de Raster, comme illustré ci-dessus. La redéfinition du raster indique que l’opération doit être appliquée aux rasters, comme appeler l’implémentation Spatial Analyst de l’opérateur, ce qui génère un objet raster en sortie.

Si seuls des nombres sont entrés dans une instruction, l’implémentation Python de l’opérateur est utilisée, ce qui génère un nombre en sortie. Consultez l’exemple ci-dessous :

# In the following statement outVar will be set to 15
outVar = 6 + 9

Reportez-vous à la rubrique Vue d’ensemble des opérateurs d’algèbre spatiale pour voir la liste complète des opérateurs disponibles pour Spatial Analyst.

• Pour en savoir plus sur l'utilisation des opérateurs

Éléments en entrée

Les éléments en entrée, tels que les rasters, entités, nombres, constantes, objets et variables, sont les composants sur lesquels s’appuie l’instruction.

Par exemple, utilisez ce qui suit pour appliquer le calcul du sinus à chaque cellule dans un raster en entrée :

outRas = Sin("inraster.tif")

• Apprendre des méthodes pour spécifier les données en entrée

Paramètres d'outil

Les paramètres d’outil définissent la façon dont l’outil doit être exécuté. Chaque outil comporte un ensemble unique de paramètres. Certains paramètres sont obligatoires et doivent comporter des valeurs pour que l’outil puisse s’exécuter. D'autres paramètres sont facultatifs, ce qui signifie que vous pouvez les laisser vides ou accepter les valeurs par défaut.

Par exemple, pour calculer la pente d’un raster, définissez le paramètre facultatif de mesure en sortie avec le mot-clé PERCENT_RISE :

outRas = Slope("inraster.tif", "PERCENT_RISE")

• En savoir plus sur la spécification des paramètres d’outil d’algèbre spatiale

Données en sortie

La sortie d’une expression d’algèbre spatiale est un objet Raster référençant des données raster temporaires.

Par exemple, l’expression suivante stocke les résultats des calculs de pente sous forme d’un objet Raster nommé outRas :

outRas = Slope("inraster.tif")

Remarque :

Comme avec tous les outils de géotraitement, les instructions d’algèbre spatiale respectent les paramètres d’environnement et l’ensemble de sélection.

Comme dans Python, les virgules sont obligatoires entre chaque paramètre en entrée. Les espaces sont facultatifs entre les arguments, mais ils sont recommandés pour des raisons de lisibilité. Vous pouvez ajouter des commentaires à votre script en commençant une ligne par le symbole dièse (#) :

# The following statement takes the slope of the input elevation in degrees.
outRas = Slope("elevation.tif", "DEGREE", 0.3043)

• Pour en savoir plus sur la création de résultat