Centile de surface multi-échelle (Outils Spatial Analyst)

Résumé

Calcule le centile le plus extrême sur une plage d’échelles spatiales.

En savoir plus sur le fonctionnement de l’outil Centile de surface multi-échelle

Utilisation

• La valeur du paramètre Input Surface Raster (Raster de surface en entrée) (in_raster dans Python) peut correspondre à n’importe quel type de raster de surface. En cas d’utilisation d’un raster de surface autre qu’une surface d’élévation, cet outil calcule le centile des valeurs de cellule du raster.

• Si vous utilisez une surface d’élévation en entrée, le centile d’élévation (EP) correspond au centile calculé. EP est une mesure de la Position Topographique Locale (LTP). Elle exprime la position verticale d’une cellule sous forme d’un centile de distribution de l’élévation au sein d’une fenêtre de filtrage ou voisinage. Le centile d’élévation multi-échelle varie fortement à des petites échelles et change plus progressivement aux échelles plus grandes. Il est également relativement peu affecté par des distributions d’élévation de forme irrégulière et des valeurs aberrantes, ce qui fait de lui une mesure robuste de la position topographique locale.

• Que vous utilisiez une surface d’élévation ou un autre type de surface en entrée, le centile est calculé pour les différentes échelles. Ces échelles correspondent à la valeur de distance de voisinage utilisée pour le calcul. Il s’agit des distances depuis le centre de la cellule cible, ce qui crée un carré de cellules autour de la cellule cible. Par exemple, une échelle de 4 cellules correspond à un voisinage de 9 cellules par 9.

• Le paramètre Output Percentile Raster (Raster de centile en sortie) (out_percentile_raster dans Python) constitue la sortie principale. Il s’agit d’un raster contenant les centiles les plus extrêmes pour chaque cellule sur une plage d’échelles spatiales. Les valeurs peuvent varier entre 0 et 100. La valeur la plus extrême est le centile le plus éloigné de 50 (les centiles les plus proches de 0 ou de 100, par exemple).

• Le paramètre Output Scale Raster (Raster d’échelle en sortie) (out_scale_raster dans Python) fournit davantage d’informations sur la sortie principale. Il comporte l’échelle à laquelle le centile le plus extrême a été trouvé pour chaque cellule. L’échelle correspond à la valeur de distance de voisinage, c’est-à-dire la distance à partir du centre de cellule cible, ce qui crée un carré de cellules autour de la cellule cible.

• Les options des unités anglo-saxonnes pour le paramètre Distance Units (Unités de distance) (distance_units dans Python) sont les versions internationales des unités. Les unités d’arpentage américaines anglo-saxonnes ne sont actuellement pas prises en charge. Si l’unité cartographique de la référence spatiale pour la valeur Input Surface Raster (Raster de surface en entrée) est l’arpentage américain, la valeur par défaut utilisée pour ce paramètre est Cells (Cellules).

• Les paramètres Minimum Neighborhood Distance (Distance de voisinage minimale) (min_scale dans Python) et Maximum Neighborhood Distance (Distance de voisinage maximale) (max_scale dans Python) définissent les tailles de voisinage, ou échelles, minimale et maximale pour lesquelles le centile est calculé. Ces valeurs représentent la distance la plus courte et la plus longue à partir de la cellule cible. Par exemple, une valeur de 1 crée un voisinage de 3 x 3 cellules, et une valeur de 2 crée un voisinage de 5 x 5 cellules.

  Ces valeurs ne peuvent pas être inférieures à la taille de cellule raster en entrée ou à 1 cellule.

  La valeur du paramètre Minimum Neighborhood Distance (Distance de voisinage minimale) doit être inférieure ou égale à la valeur du paramètre Maximum Neighborhood Distance (Distance de voisinage maximale).

• Le paramètre Base Distance Increment (Incrément de distance de base) (base_increment dans Python) correspond à l’augmentation initiale de la distance de voisinage entre les échelles. Cette augmentation se modifie lors de l’utilisation d’une valeur supérieure à 1 pour le paramètre Nonlinearity Factor (Facteur de non-linéarité) (nonlinearity dans Python).

  La valeur de ce paramètre ne peut pas être inférieure à la taille de cellule raster en entrée ou à 1 cellule. La valeur par défaut est la taille de cellule raster en entrée.

• Le paramètre Nonlinearity Factor (Facteur de non-linéarité) gère l’augmentation de la distance de voisinage (ou échelle). Une valeur de 1,0 génère une augmentation linéaire de l’échelle dans laquelle l’incrément entre les échelles reste identique (la valeur du paramètre Base Distance Increment (Incrément de distance de base)). Élever cette valeur a pour effet d’augmenter l’échelle plus rapidement et de diminuer le nombre d’échelles pour une échelle minimale et maximale données.

  Utilisez une valeur supérieure à 1,0 pour ce paramètre si vous voulez une forte densité d’échantillonnage pour les plus petites échelles et une faible densité d’échantillonnage pour les plus grandes échelles.

  Ce paramètre accepte les valeurs supérieures ou égales à 1,0. En général, les valeurs comprises entre 1,0 et 2,0 sont le plus souvent utilisées pour ce paramètre lorsque l’on recherche une augmentation non linéaire de la distance de voisinage.

  En savoir plus sur le fonctionnement de l’outil Centile de surface multi-échelle

• Les cellules NoData dans la valeur Input Surface Raster (Raster de surface en entrée) sont ignorées et sont associées à la valeur NoData dans les valeurs des paramètres Output Percentile Raster (Raster de centile en sortie) et Output Scale Raster (Raster d’échelle en sortie).

• S'il est installé sur votre système, le processeur graphique compatible peut accélérer cet outil et améliorer ses performances. Utilisez le paramètre Target device for analysis (Périphérique cible pour analyse) (analysis_target_device dans Python) pour indiquer si l’outil doit être exécuté sur le GPU ou l’UC.

  Reportez-vous à la rubrique Traitement GPU avec Spatial Analyst pour obtenir des détails sur les GPU compatibles, pour apprendre à configurer et à utiliser les périphériques GPU et pour des conseils de dépannage.

• Cet outil prend en charge le traitement parallèle. Il est possible d’obtenir de meilleures performances, en particulier sur les jeux de données volumineux, si votre ordinateur est doté de plusieurs processeurs ou de processeurs multicœurs. La rubrique d’aide Traitement parallèle avec Spatial Analyst comporte des informations concernant cette fonctionnalité et sa configuration.

  Par défaut, cet outil utilise 50 pour cent des cœurs disponibles. Vous pouvez contrôler le nombre de cœurs que l’outil utilise à l’aide de l’environnement Facteur de traitement parallèle.

• 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.

• Reportez-vous à la rubrique Environnements d’analyse et Spatial Analyst pour plus d’informations sur les environnements de géotraitement qui s’appliquent à cet outil.

Paramètres

• Dialog
• Python

Etiqueter	Explication	Type de données
Raster de surface en entrée	Raster de surface en entrée.	Raster Layer
Raster d’échelle en sortie (Facultatif)	Raster en sortie contenant l’échelle à laquelle le centile le plus extrême a été trouvé pour chaque cellule. Les échelles sont représentées par leurs valeurs de distance de voisinage. Il sera de type virgule flottante.	Raster Dataset
Unités de distance (Facultatif)	Détermine l’unité de distance à utiliser pour les paramètres Minimum Neighborhood Distance (Distance de voisinage minimale), Maximum Neighborhood Distance (Distance de voisinage maximale) et Base Distance Increment (Incrément de distance de base). La distance est exprimée par un nombre de cellules ou dans l’unité spécifiée. Par défaut, l’unité utilisée est l’unité cartographique de la référence spatiale pour la valeur Input Surface Raster (Raster de surface en entrée). Cellules—Unité de distance : cellules. Mètres—Unité de distance : mètres. Centimètres—Unité de distance : centimètres. Kilomètres—Unité de distance : kilomètres. Pouces—Les pouces internationaux sont l’unité de distance. Pieds—Les pieds internationaux sont l’unité de distance. Yard—Les yards internationaux sont l’unité de distance. Milles—Les miles internationaux sont l’unité de distance.	String
Distance de voisinage minimale (Facultatif)	Distance qui détermine l’échelle de voisinage minimale pour laquelle le centile d’élévation est calculé. Il s’agit de la distance à partir du centre de cellule cible, ce qui crée un carré de cellules autour de la cellule cible. Cette valeur doit être inférieure ou égale à la valeur du paramètre Maximum Neighborhood Distance (Distance de voisinage maximale) et supérieure ou égale à la taille de cellule raster en entrée ou à une cellule. La valeur par défaut est 4 fois la taille de cellule de la valeur du paramètre Input Surface Raster (Raster de surface en entrée), soit un voisinage de cellule de 9 par 9.	Double
Distance de voisinage maximale (Facultatif)	Distance qui détermine l’échelle de voisinage maximale pour laquelle le centile d’élévation est calculé. Il s’agit de la distance à partir du centre de cellule cible, ce qui crée un carré de cellules autour de la cellule cible. Cette valeur doit être supérieure ou égale à la valeur du paramètre Minimum Neighborhood Distance (Distance de voisinage minimale) et à la taille de cellule raster en entrée ou à une cellule. La valeur par défaut est 13 fois la taille de cellule de la valeur du paramètre Input Surface Raster (Raster de surface en entrée), soit un voisinage de cellule de 27 par 27.	Double
Incrément de distance de base (Facultatif)	Augmentation initiale de la distance de voisinage entre les échelles. La valeur de ce paramètre ne peut pas être inférieure à la taille de cellule Input Surface Raster (Raster de surface en entrée) ou à 1 cellule. La valeur par défaut est la taille de cellule de la valeur du paramètre Input Surface Raster (Raster de surface en entrée).	Double
Facteur de non-linéarité (Facultatif)	Facteur qui peut introduire une non-linéarité dans l’augmentation de l’échelle à chaque incrément. De ce fait, l’incrément augmente entre les échelles au lieu de rester constant. Les valeurs utilisées sont généralement comprises entre 1,0 et 2,0. Ce paramètre doit être supérieur ou égal à 1. La valeur par défaut est définie sur 1, ce qui génère une augmentation linéaire des distances de voisinage (l’incrément entre les échelles reste constant).	Double
Périphérique cible pour l’analyse (Facultatif)	Spécifie le périphérique utilisé pour procéder au calcul. GPU, puis CPU—Si un GPU compatible est trouvé, celui-ci sera utilisé pour effectuer le calcul ; sinon, l’UC sera utilisée. Il s’agit de l’option par défaut. CPU uniquement—Le calcul n’est réalisé que sur le CPU. GPU uniquement—Le calcul n’est réalisé que sur le GPU.	String

Valeur de retour

Etiqueter	Explication	Type de données
Raster de centile en sortie	Raster en sortie contenant la valeur de centile la plus extrême pour chaque cellule. La valeur la plus extrême est le centile le plus éloigné de 50 (les centiles les plus proches de 0 ou de 100, par exemple). Il sera de type virgule flottante.	Raster

Environnements

Validation automatique, Taille de cellule, Cell Size Projection Method (Méthode de projection de la taille de cellule), Espace de travail courant, Etendue, Transformations géographiques, ID GPU, Masque, Mot-clé CONFIG en sortie, Système de coordonnées en sortie, Facteur de traitement parallèle, Type de processeur, Pyramide, 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

Rubriques connexes

• Vue d’ensemble du jeu d’outils Surface
• Rechercher un outil de géotraitement
• Écart de surface multiéchelle