Pente (Spatial Analyst)
Récapitulatif
Permet d'identifier la pente (dégradé ou taux de variation maximum de la valeur z) de chaque cellule d'une surface raster.
Illustration
Utilisation
-
La pente est le taux de variation maximum de la valeur z de chaque cellule.
-
L'utilisation d'un facteur Z est indispensable pour effectuer des calculs corrects de la pente lorsque les unités z de surface sont exprimées dans des unités autres que des unités x,y au sol.
-
La plage des valeurs en sortie dépend du type des unités de mesure.
- Pour les degrés, la plage de valeurs de pente s'étend de 0 à 90.
- Pour le pourcentage d'élévation, la plage s'étend de 0 à l'infini. Une surface plane est à 0 pour cent, une surface à 45 degrés est à 100 pour cent, plus la surface devient verticale, plus le pourcentage d'élévation devient de plus en plus grand. Reportez-vous à la rubrique Fonctionnement de l'outil Pente pour en savoir plus sur la plage de valeurs en sortie avec cette option.
-
Si la cellule centrale dans le voisinage immédiat (fenêtre 3 x 3) a une valeur NoData, la valeur en sortie est NoData.
-
Si des cellules du voisinage ont une valeur NoData, la valeur de la cellule centrale leur est tout d'abord affectée, puis la pente est calculée.
Syntaxe
Paramètre | Explication | Type de données |
in_raster |
Raster de surface en entrée. | Raster Layer |
output_measurement (Facultatif) |
Détermine les unités de mesure (degrés ou pourcentages) des données pente en sortie.
| String |
z_factor (Facultatif) | Nombre d'unités x, y au sol dans une unité z de surface. Le facteur z ajuste les unités de mesure des unités z lorsqu'elles sont différentes des unités x,y de la surface en entrée. Les valeurs z de la surface en entrée sont multipliées par le facteur z lors du calcul de la surface finale en sortie. Si les unités x,y et les unités z utilisent les mêmes unités de mesure, le facteur z est égal à 1. Si les valeurs x,y et les valeurs z sont exprimées dans des unités de mesure différentes, le facteur z doit être défini comme approprié, sinon les résultats sont incorrects. Par exemple, si les unités z sont des pieds et les unités x,y sont des mètres, vous devez utiliser un facteur z égal à 0,3048 pour convertir les unités z de pieds en mètres (1 pied = 0,3048 mètre). | Double |
Valeur renvoyée
Nom | Explication | Type de données |
out_raster |
Raster de pente en sortie. | Raster |
Exemple de code
Cet exemple détermine les valeurs de pente du raster de surface en entrée.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outSlope = Slope("elevation", "DEGREE", 0.3043)
outSlope.save("C:/sapyexamples/output/outslope01")
Cet exemple détermine les valeurs de pente du raster de surface en entrée.
# Name: _Ex_02.py
# Description: Identifies the rate of maximum change
# in z-value from each cell.
# Requirements: Spatial Analyst Extension
# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *
# Set environment settings
env.workspace = "C:/sapyexamples/data"
# Set local variables
inRaster = "elevation"
outMeasurement = "DEGREE"
zFactor = 0.3043
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute Slope
outSlope = Slope(inRaster, outMeasurement, zFactor)
# Save the output
outSlope.save("C:/sapyexamples/output/outslope02")