Indice de position topographique (Spatial Analyst)—ArcGIS Pro

Synthèse

Calcule la valeur d’indice de position topographique pour chaque cellule dans le voisinage spécifié.

En savoir plus sur le fonctionnement de l’outil Indice de position topographique

Utilisation

Le raster en sortie de cet outil contient des valeurs d’indice de position topographique (TPI) pour chaque cellule. Une valeur TPI représente l’écart entre la valeur de la cellule actuelle et la valeur moyenne de toutes les cellules de son voisinage.
Les formes de voisinage disponibles sont l’anneau, le cercle, le rectangle et le secteur. Une forme de voisinage personnalisée peut être définie à l’aide d’un fichier de noyau.
Lorsqu’un voisinage circulaire, en anneau ou en secteur est spécifié, certaines cellules diagonales ne sont pas toujours prises en compte dans les calculs, car le centre d’une cellule doit figurer dans le voisinage.
Le type de voisinage irrégulier exige qu’une valeur de fichier de noyau soit spécifiée. Un fichier de noyau est un fichier texte ASCII qui définit les valeurs et la forme du voisinage. Le fichier peut être créé à l’aide de n’importe quel éditeur de texte brut. Le fichier doit avoir une extension .txt et son nom ne doit comporter aucun espace.
Lorsque le format raster en sortie est .crf, cet outil prend en charge l’environnement de stockage raster Pyramide. Des pyramides seront créées dans la sortie par défaut. Pour tout autre format en sortie, cet environnement n’est pas pris en charge et aucune pyramide n’est créée.
Pour plus d’informations sur les environnements de géotraitement qui s’appliquent à cet outil, reportez-vous à la rubrique Environnements d’analyse et Spatial Analyst.

Paramètres

Étiquette	Explication	Type de données
Raster de surface en entrée	Raster de surface en entrée.	Raster Layer
Quartier (Facultatif)	Cellules qui entourent une cellule de traitement utilisées dans le calcul des valeurs TPI. Vous avez le choix entre plusieurs types de voisinage prédéfinis, ou vous pouvez définir un noyau personnalisé. Une fois le type de voisinage sélectionné, d’autres paramètres peuvent être configurés pour définir entièrement la forme, la taille et les unités de mesure. Le voisinage par défaut est un voisinage en anneau qui présente un rayon intérieur d’une cellule et un rayon extérieur de trois cellules. Voici les formes des types de voisinage pris en charge : Anneau, Rayon intérieur, Rayon extérieur, Unités Voisinage en forme d’anneau défini par un rayon intérieur et un rayon extérieur. La valeur minimale du rayon est égale à 1 cellule et le rayon extérieur doit être supérieur au rayon intérieur. Le rayon intérieur maximal est de 2 046 cellules et le rayon extérieur maximal est de 2 047 cellules. L’anneau par défaut possède un rayon intérieur égal à 1 cellule et un rayon extérieur de 3 cellules. Cercle, Rayon, Unités Voisinage circulaire doté d'un rayon donné. La valeur minimale du rayon est égale à 1 cellule et sa valeur maximale est de 2 047 cellules. Le rayon par défaut est de 3 cellules. Rectangle, Hauteur, Largeur, Unités Voisinage rectangulaire défini par la hauteur et la largeur. La valeur minimale de la largeur ou de la hauteur est égale à 1 cellule et la valeur maximale est de 4 096 cellules. Le voisinage par défaut est un voisinage carré d’une largeur et d’une hauteur de 3 cellules. Secteur, Rayon, Angle de départ, Angle de fin, Unités Voisinage en forme de secteur défini par un rayon, un angle de départ et un angle de fin. La valeur minimale du rayon est égale à 1 cellule et sa valeur maximale est de 2 047 cellules. Il s’étend dans le sens anti-horaire, de l’angle de départ vers l’angle d’arrivée. Les angles sont précisés en degrés, 0 ou 360 représentant l'Est. Vous pouvez utiliser des angles négatifs. Le secteur par défaut s’étend de 0 à 90 degrés, avec un rayon de 3 cellules. Irrégulier, Fichier de noyau Voisinage personnalisé avec des spécifications définies par le fichier texte du noyau identifié. La valeur minimale de la largeur ou de la hauteur du noyau est égale à 1 cellule et la valeur maximale est de 4 096 cellules. Pour les voisinages de type Anneau, Cercle, Rectangle et Secteur, les unités de distance des paramètres peuvent être spécifiées en unités de cellule ou de Carte. Les unités de cellule sont privilégiées par défaut. Pour le voisinage de type irrégulier, la première ligne du fichier de noyau définit la largeur et la hauteur du voisinage en nombre de cellules. La ligne suivante indique le mode de traitement de la valeur en entrée qui correspond à cet emplacement dans le noyau. Une valeur 0 dans le fichier de noyau indique que l’emplacement correspondant n’est pas inclus dans le calcul. Une valeur 1 dans le fichier de noyau indique que la cellule en entrée correspondante est incluse dans l’opération.	Neighborhood

Étiquette

Explication

Type de données

Raster de surface en entrée

Raster de surface en entrée.

Raster Layer

Quartier

(Facultatif)

Cellules qui entourent une cellule de traitement utilisées dans le calcul des valeurs TPI. Vous avez le choix entre plusieurs types de voisinage prédéfinis, ou vous pouvez définir un noyau personnalisé.

Une fois le type de voisinage sélectionné, d’autres paramètres peuvent être configurés pour définir entièrement la forme, la taille et les unités de mesure. Le voisinage par défaut est un voisinage en anneau qui présente un rayon intérieur d’une cellule et un rayon extérieur de trois cellules.

Voici les formes des types de voisinage pris en charge :

Anneau, Rayon intérieur, Rayon extérieur, Unités
Voisinage en forme d’anneau défini par un rayon intérieur et un rayon extérieur. La valeur minimale du rayon est égale à 1 cellule et le rayon extérieur doit être supérieur au rayon intérieur. Le rayon intérieur maximal est de 2 046 cellules et le rayon extérieur maximal est de 2 047 cellules. L’anneau par défaut possède un rayon intérieur égal à 1 cellule et un rayon extérieur de 3 cellules.
Cercle, Rayon, Unités
Voisinage circulaire doté d'un rayon donné. La valeur minimale du rayon est égale à 1 cellule et sa valeur maximale est de 2 047 cellules. Le rayon par défaut est de 3 cellules.
Rectangle, Hauteur, Largeur, Unités
Voisinage rectangulaire défini par la hauteur et la largeur. La valeur minimale de la largeur ou de la hauteur est égale à 1 cellule et la valeur maximale est de 4 096 cellules. Le voisinage par défaut est un voisinage carré d’une largeur et d’une hauteur de 3 cellules.
Secteur, Rayon, Angle de départ, Angle de fin, Unités
Voisinage en forme de secteur défini par un rayon, un angle de départ et un angle de fin. La valeur minimale du rayon est égale à 1 cellule et sa valeur maximale est de 2 047 cellules. Il s’étend dans le sens anti-horaire, de l’angle de départ vers l’angle d’arrivée. Les angles sont précisés en degrés, 0 ou 360 représentant l'Est. Vous pouvez utiliser des angles négatifs. Le secteur par défaut s’étend de 0 à 90 degrés, avec un rayon de 3 cellules.
Irrégulier, Fichier de noyau
Voisinage personnalisé avec des spécifications définies par le fichier texte du noyau identifié. La valeur minimale de la largeur ou de la hauteur du noyau est égale à 1 cellule et la valeur maximale est de 4 096 cellules.

Pour les voisinages de type Anneau, Cercle, Rectangle et Secteur, les unités de distance des paramètres peuvent être spécifiées en unités de cellule ou de Carte. Les unités de cellule sont privilégiées par défaut.

Pour le voisinage de type irrégulier, la première ligne du fichier de noyau définit la largeur et la hauteur du voisinage en nombre de cellules. La ligne suivante indique le mode de traitement de la valeur en entrée qui correspond à cet emplacement dans le noyau. Une valeur 0 dans le fichier de noyau indique que l’emplacement correspondant n’est pas inclus dans le calcul. Une valeur 1 dans le fichier de noyau indique que la cellule en entrée correspondante est incluse dans l’opération.

Neighborhood

Valeur renvoyée

Étiquette	Explication	Type de données
Raster en sortie	Raster d’indice de position topographique en sortie.	Raster

TopographicPositionIndex(in_raster, {neighborhood})

Nom	Explication	Type de données
in_raster	Raster de surface en entrée.	Raster Layer
neighborhood (Facultatif)	Cellules qui entourent une cellule de traitement utilisées dans le calcul des valeurs TPI. Vous avez le choix entre plusieurs types de voisinage prédéfinis, ou vous pouvez définir un noyau personnalisé. Une fois le type de voisinage sélectionné, d’autres paramètres peuvent être configurés pour définir entièrement la forme, la taille et les unités de mesure. Le voisinage par défaut est un voisinage en anneau qui présente un rayon intérieur d’une cellule et un rayon extérieur de trois cellules. La forme des voisinages est définie par la classe Neighborhood. Les types de voisinage pris en charge sont NbrAnnulus, NbrCircle, NbrRectangle, NbrWedge et NbrIrregular. Voici les formes des types de voisinage pris en charge : NbrAnnulus({innerRadius}, {outerRadius}, {units}) Voisinage en forme d’anneau défini par un rayon intérieur et un rayon extérieur. La valeur minimale du rayon est égale à 1 cellule et le rayon extérieur doit être supérieur au rayon intérieur. Le rayon intérieur maximal est de 2 046 cellules et le rayon extérieur maximal est de 2 047 cellules. L’anneau par défaut possède un rayon intérieur égal à 1 cellule et un rayon extérieur de 3 cellules. NbrCircle({radius}, {units} Voisinage circulaire doté d'un rayon donné. La valeur minimale du rayon est égale à 1 cellule et sa valeur maximale est de 2 047 cellules. Le rayon par défaut est de 3 cellules. NbrRectangle({width}, {height}, {units}) Voisinage rectangulaire défini par la hauteur et la largeur. La valeur minimale de la largeur ou de la hauteur est égale à 1 cellule et la valeur maximale est de 4 096 cellules. Le voisinage par défaut est un voisinage carré d’une largeur et d’une hauteur de 3 cellules. NbrWedge({radius}, {startAngle}, {endAngle}, {units}) Voisinage en forme de secteur défini par un rayon, un angle de départ et un angle de fin. La valeur minimale du rayon est égale à 1 cellule et sa valeur maximale est de 2 047 cellules. Il s’étend dans le sens anti-horaire, de l’angle de départ vers l’angle d’arrivée. Les angles sont précisés en degrés, 0 ou 360 représentant l'Est. Vous pouvez utiliser des angles négatifs. Le secteur par défaut s’étend de 0 à 90 degrés, avec un rayon de 3 cellules. NbrIrregular(inKernelFile) Voisinage personnalisé avec des spécifications définies par le fichier texte du noyau identifié. La valeur minimale de la largeur ou de la hauteur du noyau est égale à 1 cellule et la valeur maximale est de 4 096 cellules. Pour le voisinage de type irrégulier, la première ligne du fichier de noyau définit la largeur et la hauteur du voisinage en nombre de cellules. La ligne suivante indique le mode de traitement de la valeur en entrée qui correspond à cet emplacement dans le noyau. Une valeur 0 dans le fichier de noyau indique que l’emplacement correspondant n’est pas inclus dans le calcul. Une valeur 1 dans le fichier de noyau indique que la cellule en entrée correspondante est incluse dans l’opération.	Neighborhood

Nom

Explication

Type de données

in_raster

Raster de surface en entrée.

Raster Layer

neighborhood

(Facultatif)

Cellules qui entourent une cellule de traitement utilisées dans le calcul des valeurs TPI. Vous avez le choix entre plusieurs types de voisinage prédéfinis, ou vous pouvez définir un noyau personnalisé.

Une fois le type de voisinage sélectionné, d’autres paramètres peuvent être configurés pour définir entièrement la forme, la taille et les unités de mesure. Le voisinage par défaut est un voisinage en anneau qui présente un rayon intérieur d’une cellule et un rayon extérieur de trois cellules.

La forme des voisinages est définie par la classe Neighborhood. Les types de voisinage pris en charge sont NbrAnnulus, NbrCircle, NbrRectangle, NbrWedge et NbrIrregular.

Voici les formes des types de voisinage pris en charge :

NbrAnnulus({innerRadius}, {outerRadius}, {units})
Voisinage en forme d’anneau défini par un rayon intérieur et un rayon extérieur. La valeur minimale du rayon est égale à 1 cellule et le rayon extérieur doit être supérieur au rayon intérieur. Le rayon intérieur maximal est de 2 046 cellules et le rayon extérieur maximal est de 2 047 cellules. L’anneau par défaut possède un rayon intérieur égal à 1 cellule et un rayon extérieur de 3 cellules.
NbrCircle({radius}, {units}
Voisinage circulaire doté d'un rayon donné. La valeur minimale du rayon est égale à 1 cellule et sa valeur maximale est de 2 047 cellules. Le rayon par défaut est de 3 cellules.
NbrRectangle({width}, {height}, {units})
Voisinage rectangulaire défini par la hauteur et la largeur. La valeur minimale de la largeur ou de la hauteur est égale à 1 cellule et la valeur maximale est de 4 096 cellules. Le voisinage par défaut est un voisinage carré d’une largeur et d’une hauteur de 3 cellules.
NbrWedge({radius}, {startAngle}, {endAngle}, {units})
Voisinage en forme de secteur défini par un rayon, un angle de départ et un angle de fin. La valeur minimale du rayon est égale à 1 cellule et sa valeur maximale est de 2 047 cellules. Il s’étend dans le sens anti-horaire, de l’angle de départ vers l’angle d’arrivée. Les angles sont précisés en degrés, 0 ou 360 représentant l'Est. Vous pouvez utiliser des angles négatifs. Le secteur par défaut s’étend de 0 à 90 degrés, avec un rayon de 3 cellules.
NbrIrregular(inKernelFile)
Voisinage personnalisé avec des spécifications définies par le fichier texte du noyau identifié. La valeur minimale de la largeur ou de la hauteur du noyau est égale à 1 cellule et la valeur maximale est de 4 096 cellules.

Pour le voisinage de type irrégulier, la première ligne du fichier de noyau définit la largeur et la hauteur du voisinage en nombre de cellules. La ligne suivante indique le mode de traitement de la valeur en entrée qui correspond à cet emplacement dans le noyau. Une valeur 0 dans le fichier de noyau indique que l’emplacement correspondant n’est pas inclus dans le calcul. Une valeur 1 dans le fichier de noyau indique que la cellule en entrée correspondante est incluse dans l’opération.

Neighborhood

Valeur renvoyée

Nom	Explication	Type de données
out_raster	Raster d’indice de position topographique en sortie.	Raster

Exemple de code

Exemple 1 d’utilisation de la fonction TopographicPositionIndex (fenêtre Python)

Cet exemple décrit le calcul de la valeur la moins récurrente dans un voisinage en anneau autour de chaque cellule du raster en entrée.

from arcpy.sa import *
outTPI = TopographicPositionIndex("elevation.tif", "Annulus 1 3 CELL")
outTPI.save("C:/sapyexamples/output/tpiout01.tif")

Exemple 2 d’utilisation de la fonction TopographicPositionIndex (script autonome)

Dans cet exemple, on définit la valeur la moins récurrente dans un voisinage de 10 x 10 autour de chaque cellule dans le raster en entrée.

# Name: TopographicPositionIndex_standalone.py
# Description: Calculates the TPI.
# Requirements: Spatial Analyst Extension

# Import system modules
import arcpy
from arcpy.sa import *

# Set environment settings
arcpy.env.workspace = "C:/sapyexamples/data"

# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

# Set local variables
inRaster = "elevation.tif"
inNeighborhood = "Circle 90 Map"

# Execute the tool
outTPI = TopographicPositionIndex(inRaster, inNeighborhood)

# Save the output 
outTPI.save("C:/sapyexamples/output/tpiout02.tif")

Environnements

Validation automatique, Taille de cellule, Méthode de projection de la taille de cellule, Compression, Espace de travail courant, Étendue, Transformations géographiques, Masque, Mot-clé CONFIG en sortie, Système de coordonnées en sortie, Espace de travail temporaire, Raster de capture, Taille de tuile

Informations de licence

Basic: Nécessite Spatial Analyst
Standard: Nécessite Spatial Analyst
Advanced: Nécessite Spatial Analyst

Synthèse

Utilisation

Paramètres

Valeur renvoyée

Valeur renvoyée

Exemple de code

Environnements

Informations de licence

Dans cette rubrique