Exposition (Outils 3D Analyst)

Résumé

Déduit l'exposition à partir de chaque cellule d'une surface raster.

L'exposition identifie la direction de la boussole à laquelle fait face la pente descendante pour chaque emplacement.

L’outil Paramètres de surface fournit une nouvelle implémentation et des fonctionnalités améliorées.

En savoir plus sur le fonctionnement d’Exposition

Illustration

Utilisation

L’outil Paramètres de surface propose une implémentation plus récente de l’outil Exposition et il est recommandé de l’utiliser à la place de ce dernier. L’outil Exposition ajuste un plan aux neuf cellules locales, mais un plan peut ne pas être un bon descripteur du paysage et peut masquer ou exagérer les variations naturelles présentant un intérêt. L’outil Paramètres de surface ajuste une surface au voisinage des cellules au lieu d’un plan, ce qui permet d’obtenir un ajustement plus naturel au terrain.

L’outil Exposition utilise une fenêtre de 3 cellules par 3 pour calculer la valeur, tandis que l’outil Paramètres de surface prend en charge des tailles de fenêtre allant de 3 cellules par 3 à 15 cellules par 15. Des tailles de fenêtre plus importantes sont utiles avec des données d’élévation de résolution plus élevée pour capturer les processus de surface terrestre à une échelle appropriée. L’outil Paramètres de surface propose également une option de fenêtre adaptative qui évalue la variabilité locale du terrain et identifie la taille de voisinage appropriée la plus grande pour chaque cellule. Cela peut s’avérer utile avec les terrains homogènes graduels interrompus par des cours d’eau, des routes ou des failles abruptes dans une pente.

Vous pouvez continuer à utiliser l’approche traditionnelle de l’outil Exposition si les résultats doivent correspondre exactement aux exécutions précédentes de l’outil ou si la rapidité du traitement est plus importante que la qualité de l’algorithme.
Cet outil utilise une fenêtre mobile de cellules 3 sur 3 pour traiter les données. Si la cellule de traitement est égale à NoData, la sortie pour cet emplacement est également égale à NoData.
Sur les huit cellules voisines de la cellule de traitement, cet outil requiert qu'au moins sept d'entre elles possèdent une valeur valide. Si le nombre de cellules valides est inférieur à sept, le calcul ne sera pas réalisé et la sortie à cette cellule de traitement sera égale à NoData.
Les cellules dans les lignes et colonnes les plus éloignées du raster en sortie seront égales à NoData. Cela s'explique par le fait que le long de la limite du jeu de données en entrée, ces cellules n'ont pas assez de voisins valides.
L'exposition est exprimée en degrés positifs compris entre 0 et 360, mesurés dans le sens horaire, à partir du nord.
Cells in the input raster that are flat—avec pente nulle - attribution de l’exposition -1.
Pour la méthode géodésique, la spécification de l'unité z de la surface assure l’exactitude de la sortie. Le paramètre Z unit (Unité Z) est activé uniquement lorsque la méthode géodésique est sélectionnée.
Si une unité z est disponible dans le système de coordonnées verticales du raster en entrée, elle est automatiquement appliquée. Il est recommandé de définir une unité z pour le raster en entrée s’il n’en existe pas. Vous pouvez utiliser l’outil Définir une projection(../data-management/define-projection.yml) pour spécifier une unité z. Si vous n'en définissez pas, le mètre est utilisé par défaut.
Le paramètre Projeter les azimuts géodésiques (project_geodesic_azimuths dans Python) est disponible uniquement lorsque le paramètre Method (Méthode) est défini sur Geodesic (Géodésique).

Pour la méthode Geodesic (Géodésique), si le paramètre Project geodesic azimuths (Projeter des azimuts géodésiques) est sélectionné (project_geodesic_azimuths est défini sur PROJECT_GEODESIC_AZIMUTHS dans Python), les affirmations suivantes sont vraies :
- Le nord est toujours représenté par 360 degrés.
- Les azimuts seront projetés de façon à corriger la distorsion provoquée par une valeur d’environnement Système de coordonnées en sortie non conforme. Ces angles peuvent être utilisés pour localiser précisément les points le long de la pente descendante la plus raide.
Si le raster en entrée doit être ré-échantillonné, la technique bilinéaire sera utilisée. Un raster en entrée peut être ré-échantillonné par exemple lorsque le système de coordonnées en sortie, l’étendue ou la taille de cellule est différent(e) de celui ou celle en entrée.
Si la valeur du paramètre Input raster (Raster en entrée) correspond à la haute résolution avec une taille de cellule inférieure à quelques mètres, ou particulièrement bruyante, envisagez d’utiliser l’outil Paramètres de surface et l’option de distance de voisinage définie par l’utilisateur plutôt que le voisinage immédiat de 3 cellules par 3 de cet outil. L’utilisation d’un voisinage plus important peut limiter l’effet des surfaces bruyantes. L’utilisation d’un voisinage plus important peut également améliorer la représentation des caractéristiques des reliefs et des surfaces si des surfaces haute résolution sont utilisées.
Lorsque le raster en entrée comporte des cellules rectangulaires, il est traité de telle sorte que les cellules du raster en sortie soient carrées avec des côtés égaux à la moyenne de la longueur et de la largeur des cellules rectangulaires.
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 en Python) pour indiquer si l’outil doit être exécuté sur le GPU ou l’UC.

Consultez la rubrique Traitement GPU avec Spatial Analyst dans l’aide de l’extension 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.

Etiqueter	Explication	Type de données
Raster en entrée	Raster de surface en entrée.	Raster Layer
Raster en sortie	Raster d'exposition en sortie. Il sera de type virgule flottante.	Raster Dataset
Méthode (Facultatif)	Spécifie si le calcul repose sur une méthode plane (terre plate) ou géodésique (ellipsoïde). L'utilisation de la méthode plane est appropriée pour les surfaces locales d'une projection conservant la distance et la surface correctes. Elle est adaptée aux analyses qui couvrent des zones telles que des villes, des comtés ou de plus petits états d’une zone. La méthode géodésique produit un résultat plus précis, mais peut nécessiter un temps de traitement supplémentaire. Planar—The calculation will be performed on a projected flat plane using a 2D Cartesian coordinate system. This is the default. Geodesic—The calculation will be performed in a 3D Cartesian coordinate system by considering the shape of the earth as an ellipsoid.	String
Unité Z (Facultatif)	Spécifie l’unité linéaire utilisée pour des valeurs z verticales. Elle est définie par un système de coordonnées verticales s'il en existe un. En l’absence d’un système de coordonnées verticales, définissez l’unité z à l’aide de la liste d’unités pour garantir un calcul géodésique correct. L’unité par défaut est le mètre. Inch—The linear unit will be inches. Foot—The linear unit will be feet. US Foot—The linear unit will be US survey feet. Yard—The linear unit will be yards. US Mile—The linear unit will be US survey miles. Nautical mile—The linear unit will be nautical miles. Millimeter—The linear unit will be millimeters. Centimeter—The linear unit will be centimeters. Meter—The linear unit will be meters. Kilometer—The linear unit will be kilometers. Decimeter—The linear unit will be decimeters.	String
Projeter des azimuts géodésiques (Facultatif)	Spécifie si les azimuts géodésiques seront projetés afin de corriger la distorsion de l’angle provoquée par la référence spatiale en sortie. Activé—Geodesic azimuths will be projected. Décoché—Geodesic azimuths will not be projected. This is the default.	Boolean
Périphérique cible pour l’analyse (Facultatif)	Spécifie le périphérique utilisé pour procéder au calcul. GPU then CPU—If a compatible GPU is found, it will be used to perform the calculation; otherwise, the CPU will be used. This is the default. CPU only—The calculation will only be performed on the CPU. GPU only—The calculation will only be performed on the GPU.	String

arcpy.3d.Aspect(in_raster, out_raster, {method}, {z_unit}, {project_geodesic_azimuths}, {analysis_target_device})

Nom	Explication	Type de données
in_raster	Raster de surface en entrée.	Raster Layer
out_raster	Raster d'exposition en sortie. Il sera de type virgule flottante.	Raster Dataset
method (Facultatif)	Spécifie si le calcul repose sur une méthode plane (terre plate) ou géodésique (ellipsoïde). L'utilisation de la méthode plane est appropriée pour les surfaces locales d'une projection conservant la distance et la surface correctes. Elle est adaptée aux analyses qui couvrent des zones telles que des villes, des comtés ou de plus petits états d’une zone. La méthode géodésique produit un résultat plus précis, mais peut nécessiter un temps de traitement supplémentaire. `PLANAR`—The calculation will be performed on a projected flat plane using a 2D Cartesian coordinate system. This is the default. `GEODESIC`—The calculation will be performed in a 3D Cartesian coordinate system by considering the shape of the earth as an ellipsoid.	String
z_unit (Facultatif)	Spécifie l’unité linéaire utilisée pour des valeurs z verticales. Elle est définie par un système de coordonnées verticales s'il en existe un. En l’absence d’un système de coordonnées verticales, définissez l’unité z à l’aide de la liste d’unités pour garantir un calcul géodésique correct. L’unité par défaut est le mètre. `INCH`—The linear unit will be inches. `FOOT`—The linear unit will be feet. `FOOT_US`—The linear unit will be US survey feet. `YARD`—The linear unit will be yards. `MILE_US`—The linear unit will be US survey miles. `NAUTICAL_MILE`—The linear unit will be nautical miles. `MILLIMETER`—The linear unit will be millimeters. `CENTIMETER`—The linear unit will be centimeters. `METER`—The linear unit will be meters. `KILOMETER`—The linear unit will be kilometers. `DECIMETER`—The linear unit will be decimeters.	String
project_geodesic_azimuths (Facultatif)	Spécifie si les azimuts géodésiques seront projetés afin de corriger la distorsion de l’angle provoquée par la référence spatiale en sortie. `PROJECT_GEODESIC_AZIMUTHS`—Geodesic azimuths will be projected. `GEODESIC_AZIMUTHS`—Geodesic azimuths will not be projected. This is the default.	Boolean
analysis_target_device (Facultatif)	Spécifie le périphérique utilisé pour procéder au calcul. `GPU_THEN_CPU`—If a compatible GPU is found, it will be used to perform the calculation; otherwise, the CPU will be used. This is the default. `CPU_ONLY`—The calculation will only be performed on the CPU. `GPU_ONLY`—The calculation will only be performed on the GPU.	String

Exemple de code

Exemple 1 d’utilisation de Aspect (fenêtre Python)

Cet exemple crée un raster d'exposition à partir d'un raster de surface en entrée.

import arcpy
from arcpy import env
env.workspace = "C:/data"
arcpy.ddd.Aspect("elevation", "C:/output/outaspect.img")

Exemple 2 d’utilisation de Aspect (script autonome)

Cet exemple crée un raster d'exposition à partir d'un raster de surface en entrée.

# Name: Aspect_3d_Ex_02.py
# Description: Derives aspect from a raster surface.
# Requirements: 3D Analyst extension

# Import system modules
import arcpy
from arcpy import env

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

# Set local variables
inRaster = "elevation"
outAspect = "C:/output/outaspect2"
method = "GEODESIC"
zUnit = "FOOT"

# Run Aspect
arcpy.ddd.Aspect(inRaster, outAspect, method, zUnit)

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, Type de processeur, Espace de travail temporaire, Raster de capture, Taille de tuile

Informations de licence

Basic: Nécessite 3D Analyst ou Spatial Analyst
Standard: Nécessite 3D Analyst ou Spatial Analyst
Advanced: Nécessite 3D Analyst ou Spatial Analyst