Différence de surface multi-échelle (Spatial Analyst)

Disponible avec une licence Spatial Analyst.

Synthèse

Calcule la différence maximale par rapport à l’élévation moyenne sur une plage d’échelles spatiales.

En savoir plus sur le fonctionnement de l’outil Multiscale Surface Difference (Différence de surface multi-échelle).

Utilisation

• La différence maximale par rapport à l’élévation moyenne est calculée aux différentes échelles. Cela signifie que pour chaque échelle, l’élévation moyenne est déterminée, puis la différence entre la valeur du centre de la cellule et l’élévation moyenne à cette échelle est calculée. La différence est conservée pour comparaiso avec les valeurs à différentes échelles. Ces échelles correspondent à la valeur de distance de voisinage utilisée pour le calcul (la distance à partir du centre de cellule cible, ce qui crée un carré de cellules autour de la cellule cible). Par exemple, une échelle de deux cellules est un voisinage de 5 x 5 cellules.

• La valeur du paramètre Input Surface Raster (Raster de surface en entrée) (in_raster en Python) peut être n’importe quel type de raster de surface.

• Le paramètre Output Difference Raster (Raster de différence en sortie) (out_difference_raster en Python) est la sortie principale. Il s’agit du raster contenant la différence maximale par rapport à l’élévation moyenne sur une plage d’échelles spatiales.

• Le paramètre Output Scale Raster (Raster d’échelle en sortie) (out_scale_raster en Python) fournit davantage d’informations sur la sortie principale. Il inclut l’échelle à laquelle la différence maximale par rapport à l’élévation moyenne a été trouvée 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 paramètres Minimum Neighborhood Distance (Distance de voisinage minimale) (min_scale en Python) et Maximum Neighborhood Distance (Distance de voisinage maximale) (max_scale en Python) définissent les tailles de voisinage, ou échelles, minimale et maximale pour lesquelles la différence est calculée. 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 Distance de voisinage minimale doit être inférieure ou égale à la valeur du paramètre Distance de voisinage maximale.

• Le paramètre Distance Increment (Incrément de distance) (increment en Python) correspond à l’augmentation de la distance de voisinage entre les échelles.

  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.

• Les cellules NoData dans la valeur Input Surface Raster (Raster de surface en entrée) sont ignorées et les paramètres Output Difference Raster (Raster de différence en sortie) et Output Scale Raster (Raster de surface en sortie) reçoivent la valeur NoData.

• Si votre système dispose d’un processeur graphique (GPU) compatible, celui-ci peut accélérer cet outil et améliorer ses performances. Utilisez le paramètre Périphérique cible pour analyse (analysis_target_device dans Python) pour définir si c’est le GPU ou le CPU qui sera utilisé pour exécuter l’outil.

  Consultez la rubrique Traitement GPU avec Spatial Analyst pour plus d’informations sur les GPU compatibles, sur la configuration et l’utilisation des périphériques GPU et pour obtenir des conseils de dépannage.

• L’exécution avec des périphériques GPU génère des résultats plus précis qu’avec des UC.

• 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. Pour plus d’informations concernant cette fonctionnalité et sa configuration, consultez la rubrique d’aide Traitement parallèle avec Spatial Analyst.

  Par défaut, cet outil utilise 50 pourcent 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.

• 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

Boîte de dialogue

Étiquette	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 la différence la plus grande a été trouvée 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)	Spécifie l’unité de distance utilisée pour les paramètres Minimum Neighborhood Distance (Distance de voisinage minimale), Maximum Neighborhood Distance (Distance de voisinage maximale) et Distance Increment (Incrément de distance). 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—Les cellules sont l’unité de distance. Mètres—Les mètres sont l’unité de distance. Centimètres—Les centimètres sont l’unité de distance. Kilomètres—Les kilomètres sont l’unité de distance. Pouces—Les pouces sont l’unité de distance. Pieds—Les pieds sont l’unité de distance. Yard—Les yards sont l’unité de distance. Miles—Les miles sont l’unité de distance.	String
Distance de voisinage minimale (Facultatif)	Distance qui définit l’échelle de voisinage minimale pour laquelle la différence d’élévation est calculée. 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 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 Raster de surface en entrée, soit un voisinage de cellule de 9 par 9.	Double
Distance de voisinage maximale (Facultatif)	Distance qui définit l’échelle de voisinage maximale pour laquelle la différence d’élévation est calculée. 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 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 Raster de surface en entrée, soit un voisinage de cellule de 27 par 27.	Double
Incrément de distance (Facultatif)	Augmentation 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
Périphérique cible pour l’analyse (Facultatif)	Spécifie le périphérique qui sera utilisé pour effectuer le calcul. GPU puis CPU—Si un GPU compatible est trouvé, celui-ci sera utilisé pour effectuer le calcul. Autrement, le CPU sera utilisé. Il s’agit de l’option par défaut. CPU uniquement—Le calcul sera uniquement exécuté sur le CPU. GPU uniquement—Le calcul sera uniquement exécuté sur le GPU.	String

Valeur renvoyée

Étiquette	Explication	Type de données
Raster de différence en sortie	Raster en sortie contenant la différence maximale par rapport à l’élévation moyenne pour chaque cellule. Il sera de type virgule flottante.	Raster

Python

MultiscaleSurfaceDifference(in_raster, {out_scale_raster}, {distance_units}, {min_scale}, {max_scale}, {increment}, {analysis_target_device})

Nom	Explication	Type de données
in_raster	Raster de surface en entrée.	Raster Layer
out_scale_raster (Facultatif)	Raster en sortie contenant l’échelle à laquelle la différence la plus grande a été trouvée pour chaque cellule. Les échelles sont représentées par leurs valeurs de distance de voisinage. Il sera de type virgule flottante.	Raster Dataset
distance_units (Facultatif)	Spécifie l’unité de distance utilisée pour les paramètres min_scale, max_scale et increment. 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 in_raster. CELLS—Les cellules sont l’unité de distance. METERS—Les mètres sont l’unité de distance. CENTIMETERS—Les centimètres sont l’unité de distance. KILOMETERS—Les kilomètres sont l’unité de distance. INCHES—Les pouces sont l’unité de distance. FEET—Les pieds sont l’unité de distance. YARDS—Les yards sont l’unité de distance. MILES—Les miles sont l’unité de distance.	String
min_scale (Facultatif)	Distance qui définit l’échelle de voisinage minimale pour laquelle la différence d’élévation est calculée. 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 max_scale 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 in_raster, soit un voisinage de cellule de 9 par 9.	Double
max_scale (Facultatif)	Distance qui définit l’échelle de voisinage maximale pour laquelle la différence d’élévation est calculée. 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 min_scale 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 in_raster, soit un voisinage de cellule de 27 par 27.	Double
increment (Facultatif)	Augmentation de la distance de voisinage entre les échelles. La valeur de ce paramètre ne peut pas être inférieure à la taille de cellule in_raster ou à 1 cellule. La valeur par défaut est la taille de cellule de la valeur du paramètre in_raster.	Double
analysis_target_device (Facultatif)	Spécifie le périphérique qui sera utilisé pour effectuer le calcul. GPU_THEN_CPU—Si un GPU compatible est trouvé, celui-ci sera utilisé pour effectuer le calcul. Autrement, le CPU sera utilisé. Il s’agit de l’option par défaut. CPU_ONLY—Le calcul sera uniquement exécuté sur le CPU. GPU_ONLY—Le calcul sera uniquement exécuté sur le GPU.	String

Valeur renvoyée

Nom	Explication	Type de données
out_difference_raster	Raster en sortie contenant la différence maximale par rapport à l’élévation moyenne pour chaque cellule. Il sera de type virgule flottante.	Raster

Exemple de code

Exemple 1 d’utilisation de l’outil MultiscaleSurfaceDifference (fenêtre Python)

L’exemple suivant illustre l’utilisation de cet outil dans la fenêtre Python.

Cet exemple génère le raster de différence en sortie à partir d’un raster de surface en entrée en utilisant les valeurs par défaut pour tous les paramètres facultatifs.

from arcpy.sa import *
outMaxDifferences = MultiscaleSurfaceDifference("elevation.tif", "", "", "", "", "", "")
outMaxDifferences.save("C:/sapyexamples/output/outmaxdifferencs01.tif")

Exemple 2 d’utilisation de l’outil MultiscaleSurfaceDifference (script autonome)

L’exemple suivant illustre l’utilisation de cet outil dans un script Python autonome.

Cet exemple génère un raster de différence pour les échelles allant de 10 mètres à 100 mètres par incrément d’un mètre entre chaque échelle.

# Name: MultiscaleSurfaceDifference_standalone.py
# Description: Calculates the maximum difference for each cell from the mean
# over a range of spatial scales.
# 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"
inDistanceUnits = "METERS"
inMinScale = 10
inMaxScale = 100
inIncrement = 1

# Execute the tool
outMaxDifferences = MultiscaleSurfaceDifference(inRaster, "", inDistanceUnits, inMinScale,
                                                inMaxScale, inIncrement, "")

# Save the output 
outMaxDifference.save("C:/sapyexamples/output/outmaxdifferences02.tif")

Environnements

Validation automatique, Taille de cellule, Méthode de projection de la taille de cellule, Espace de travail courant, Étendue, Transformations géographiques, Masque, Mot-clé CONFIG en sortie, Système de coordonnées en sortie, Pyramide, Facteur de traitement parallèle, 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