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 l’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.
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 :
Annulus (Anneau), Inner radius (Rayon intérieur), Outer radius (Rayon extérieur), Units type (Type d’unité)
Voisinage en forme de boucle ou 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 maximale 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.
Circle (Cercle), Radius (Rayon), Units (Type d’unité)
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, Height (Hauteur), Width (Largeur), Units (Type d’unité)
Voisinage rectangulaire défini par la hauteur et la largeur. La valeur minimale pour la largeur ou la hauteur est d’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.
Wedge (Secteur), Radius (Rayon), Start angle (Angle de départ), End angle (Angle de fin), Units type (Type d’unité)
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.
Irregular (Irrégulier), Kernel file (Fichier de noyau)
Voisinage personnalisé avec des spécifications définies par le fichier texte du noyau identifié. La valeur minimale pour la largeur ou la hauteur du noyau est d’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 (Cell [Cellule]) ou de carte (Map [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 de retour
Etiqueter
Explication
Type de données
Raster en sortie
Raster d’indice de position topographique en sortie.
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 :
NbrAnnulus({innerRadius}, {outerRadius}, {units})
Voisinage en forme de boucle ou 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 maximale 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 pour la largeur ou la hauteur est d’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.
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 pour la largeur ou la hauteur du noyau est d’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 de retour
Nom
Explication
Type de données
out_raster
Raster d’indice de position topographique en sortie.
Raster
Exemple de code
TopographicPositionIndex Exemple 1 (fenêtre Python)
Cet exemple calcule les valeurs TPI à l’aide d’un voisinage en anneau autour de chaque cellule du raster en entrée.