Paramètres de surface (3D Analyst)

Synthèse

Détermine les paramètres d’une surface raster tels qu’une exposition, une pente et des courbures.

En savoir plus sur le fonctionnement de l’outil Paramètres de surfaceEn savoir plus sur le fonctionnement de l’outil Paramètres de surface

Utilisation

  • Les paramètres en sortie sont calculés cellule par cellule en ajustant une surface locale autour d’une cellule cible. Les options de paramètre de surface disponibles pour le paramètre Parameter type (Type de paramètre) (parameter_type en Python) sont Slope (Pente), Aspect (Exposition), Mean curvature (Courbure moyenne), Tangential (normal contour) curvature (Courbure tangentielle (isoligne normale)), Profile (normal slope line) curvature (Courbure longitudinale (ligne de pente normale)), Plan (projected contour) curvature (Courbure transversale (isoligne projetée)), Contour geodesic torsion (Torsion géodésique des isolignes), Gaussian curvature (Courbure gaussienne) et Casorati curvature (Courbure Casorati).

  • Tous les paramètres en sortie sont calculés à l’aide de coordonnées et d’équations géodésiques.

  • Lorsque l’option Slope (Pente) (SLOPE en Python) est spécifiée pour Parameter type (Type de paramètre), la sortie représente le taux de changement d’élévation pour chaque cellule du modèle numérique d’élévation (MNE). Il s’agit de la première dérivée d’un MNE. La plage des valeurs de la pente en sortie dépend du type des unités de mesure.

  • Lorsque l’option Aspect (Exposition) (ASPECT en Python) est spécifiée pour Parameter type (Type de paramètre), la sortie identifie la direction de la boussole à laquelle fait face la pente descendante pour chaque emplacement. Elle est exprimée en degrés positifs compris entre 0 et 360, mesurés dans le sens horaire, à partir du nord.

  • La courbure permet de décrire la forme d’une surface. Appliquée aux sciences de la terre, elle permet de mieux comprendre les impacts de la gravité, de l’érosion et d’autres facteurs sur la surface. Elle est utilisée conjointement avec les autres paramètres de surface pour identifier et classer les reliefs.

    • Mean curvature (Courbure moyenne) (MEAN_CURVATURE en Python) : courbure moyenne de la surface. Elle est calculée comme étant la moyenne des courbures maximale et minimale. Lorsque cette option est spécifiée pour Parameter type (Type de paramètre), la sortie est équivalente à la moyenne des courbures longitudinale (ligne de pente normale) et tangentielle (isoligne normale). Son signe, positif ou négatif, n’est pas un indicateur définitif, sauf à des valeurs extrêmes. Des valeurs positives élevées indiquent des zones de dénudation maximale, et des valeurs négatives élevées indiquent des zones d’accumulation maximale (Minár et al., 2020).
    • Profile (normal slope line) curvature (Courbure longitudinale (ligne de pente normale)) (PROFILE_CURVATURE en Python) : courbure normale géométrique le long de la ligne de pente. Des valeurs positives indiquent des zones d’accélération d’écoulement de surface et d’érosion. Une courbure longitudinale négative indique des zones d’écoulement de surface et de dépôt ralentissant. Une courbure longitudinale (ligne de pente normale) positive indique que la surface est convexe à cette cellule dans la direction de la pente. Une courbure négative indique que la surface est concave à cette cellule dans cette même direction. Une valeur nulle signifie que la surface est plane.
    • Tangential (normal contour) curvature (Courbure tangentielle (isoligne normale)) (TANGENTIAL_CURVATURE en Python) : courbure normale géométrique perpendiculaire à la ligne de pente, tangente à l’isoligne. Des valeurs positives indiquent des zones d’écoulement de surface divergeant. Les courbures tangentielles négatives indiquent des zones d’écoulement de surface convergent. Une courbure tangentielle (isoligne normale) positive indique que la surface est convexe à cette cellule perpendiculaire à la direction de la pente. Une courbure négative indique que la surface est concave à cette cellule dans la direction perpendiculaire à la pente. Une valeur nulle signifie que la surface est plane.
    • Plan (projected contour) curvature (Courbure transversale (isoligne projetée)) (CONTOUR_CURVATURE en Python) : courbure le long des isolignes.
    • Contour geodesic torsion (Torsion géodésique des isolignes) (CONTOUR_GEODESIC_TORSION en Python) : taux de variation de l’angle de pente le long des isolignes.
    • Gaussian curvature (Courbure gaussienne) (GAUSSIAN_CURVATURE en Python) : courbure générale d’une surface. Elle est calculée comme le produit des courbures maximale et minimale, et peut avoir des valeurs positives et négatives. Des valeurs positives indiquent que la surface est convexe à cette cellule, tandis que des valeurs négatives qu’elle est concave. Une valeur nulle signifie que la surface est plane.
    • Casorati curvature (Courbure Casorati) (CASORATI_CURVATURE en Python) : courbure générale de la surface. Elle peut être égale à zéro ou à un nombre positif. Des valeurs positives élevées indiquent des zones de courbe brusque dans plusieurs directions.

    Les unités de toutes les sorties du type de courbure sont la réciproque (le carré de la réciproque du paramètre Gaussian curvature (Courbure gaussienne)) des unités x,y de l’environnement Système de coordonnées en sortie.

  • L’option Quadratic (Quadratique) du paramètre Local surface type (Type de surface locale) (local_surface_type = "QUADRATIC" en Python) ne correspond pas exactement aux cellules de voisinage. Il s’agit de l’option par défaut, qui est recommandée pour la plupart des données et applications.

    • La surface quadratique réduit l’effet des données surfaciques bruyantes, comme une surface lidar haute résolution, ce qui est particulièrement important lors du calcul de la courbure.
    • Utilisez la surface quadratique lorsque vous spécifiez une taille de voisinage supérieure à la taille de cellule et lorsque vous utilisez l’option de voisinage adaptatif.
  • L’option Biquadratic (Biquadratique) du paramètre Local surface type (Type de surface locale) (local_surface_type = "BIQUADRATIC" en Python) correspond exactement aux données des cellules de voisinage.

    • Cette option convient à une surface en entrée hautement précise.
    • Si la distance de voisinage est supérieure à la taille de la cellule raster en entrée, les avantages en termes de précision liés au type de surface biquadratique sont perdus. Conservez le paramètre de distance de voisinage comme paramètre par défaut (égal à la taille de cellule).
  • Le paramètre Neighborhood distance (Distance de voisinage) (neighborhood_distance en Python) détermine la taille du voisinage et calcule le paramètre de surface sur cette distance à partir du centre de cellule cible.

    • Elle ne peut pas être inférieure à la taille de cellule raster en entrée.
    • Une distance de voisinage plus courte permet de saisir une plus grande variabilité locale du paysage, comme la caractéristique des petites entités du paysage. Avec des données d’altitude haute résolution, des distances plus grandes peuvent être plus appropriées.
  • Si le paramètre Use adaptive neighborhood (Utiliser le voisinage adaptatif) est activé (use_adaptive_neighborhood = "ADAPTIVE_NEIGHBORHOOD" en Python), la distance de voisinage varie avec la variabilité du MNE. La distance de voisinage diminue si la fenêtre de calcul présente une trop grande variabilité.

  • La spécification de la valeur du paramètre de surface Z unit (Unité Z) (z_unit en Python) garantit le calcul correct de la pente en sortie.

    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 pour spécifier une unité z. Si vous n'en définissez pas, le mètre est utilisé par défaut.

  • La plage des valeurs de la pente en sortie dépend des unités de mesure du paramètre Slope measurement (Mesure de pente) (output_slope_measurement en Python) :

    • Degree (Degré) (DEGREE en Python) : la plage des valeurs de pente s’étend de 0 à 90.
    • Percent rise (Pourcentage d’élévation) (PERCENT_RISE en Python) : la plage s’étend de 0 à l’infini. Une surface plane est à 0 % et une surface à 45 degrés est à 100 %. Plus la surface est verticale, plus le pourcentage d’élévation grandit.
  • Si le paramètre Project geodesic azimuths (Projeter des azimuts géodésiques) est sélectionné (project_geodesic_azimuths = "PROJECT_GEODESIC_AZIMUTHS" en Python), les éléments suivants sont vrais :

    • Le Nord est 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 paramètre Use equatorial aspect (Utiliser l’aspect équatorial) est coché (project_geodesic_azimuths = "USE_EQUATORIAL_ASPECT" en Python), l’exposition est mesurée à partir d’un point sur l’équateur pour corriger la déformation de la direction se produisant à l’approche des pôles. Avec ce paramètre, les axes nord-sud et est-ouest sont perpendiculaires l’un à l’autre.

    Cochez le paramètre Use equatorial aspect (Utiliser l’aspect équatorial) si le terrain se trouve à proximité du pôle Nord ou Sud.

  • Utilisez le paramètre Input analysis mask (Masque d’analyse en entrée) (in_analysis_mask en Python) pour limiter l’analyse à des lieux d’intérêt spécifiques dans le raster de surface en entrée. Les lieux peuvent être définis par des données d’entités ou raster. Le paramètre Input analysis mask (Masque d’analyse en entrée) a priorité sur le paramètre d’environnement Masque.

  • Lorsque la valeur Input surface raster (Raster de surface en entrée) (in_raster en Python) et les données raster Input analysis mask (Masque d’analyse en entrée) (in_analysis_mask en Python) ont la même taille de cellule et que les cellules sont alignées, elles seront utilisées directement dans l’outil. Elles ne seront pas rééchantillonnées en interne pendant l’exécution de l’outil.

    Si la taille de cellule est différente, la taille de cellule en sortie correspond au maximum des entrées et la valeur Input surface raster (Raster de surface en entrée) sera utilisée en interne comme raster de capture. Si la taille de cellule est identique, mais que les cellules ne sont pas alignées, la valeur Input surface raster (Raster de surface en entrée) sert de raster de capture en interne. L’un de ces cas déclenche un rééchantillonnage interne avant l’exécution de l’extraction.

    Pour plus d’informations, consultez les rubriques d’environnement Taille de cellule et Raster de capture.

  • Bibliographie :

    • James, D. E., Tomer, M. D., and Porter, S. A. Trans-scalar landform segmentation from high-resolution digital elevation models. Affiche présentée à la conférence annuelle des utilisateurs ESRI, juillet 2014, San Diego, Californie.
    • Minár, J., Evans, I. S., and Jenčo, M. A comprehensive system of definitions of land surface (topographic) curvatures, with implications for their application in geoscience modelling and prediction. Earth-Science Reviews, 103414, 2020. https://doi.org/10.1016/j.earscirev.2020.103414

Paramètres

ÉtiquetteExplicationType de données
Raster de surface en entrée

Raster de surface en entrée.

Raster Layer
Raster en sortie

Raster en sortie.

Il sera de type virgule flottante.

Raster Dataset
Type de paramètre
(Facultatif)

Spécifie le type de paramètre de surface en sortie à calculer.

  • PenteLe taux de variation de l’élévation est calculé. Il s’agit de l’option par défaut.
  • ExpositionLa direction de la pente descendante du taux de variation maximal pour chaque cellule est calculée.
  • Courbure moyenneLa courbure globale de la surface est mesurée. Elle est calculée comme étant la moyenne des courbures maximale et minimale. Cette courbure décrit la convexité ou la concavité intrinsèque de la surface, indépendamment de la direction ou de l’influence de la gravité.
  • Courbure tangentielle (isoligne normale)La courbure normale géométrique perpendiculaire à la ligne de pente, tangente à l’isoligne, est mesurée. Cette courbure est généralement appliquée pour caractériser la convergence ou la divergence de l’écoulement sur la surface.
  • Courbure longitudinale (ligne de pente normale)La courbure normale géométrique le long de la ligne de pente est mesurée. Cette courbure est généralement appliquée pour caractériser l’accélération et la décélération de l’écoulement sur la surface.
  • Courbure transversale (isoligne projetée)La courbure le long des isolignes est mesurée.
  • Torsion géodésique des isolignesLe taux de variation de l’angle de pente le long des isolignes est mesuré.
  • Courbure gaussienneLa courbure globale de la surface est mesurée. Elle est calculée comme le produit des courbures maximale et minimale.
  • Courbure CasoratiLa courbure générale de la surface est mesurée. Elle peut être égale à zéro ou à un autre nombre positif quelconque.
String
Type de surface locale
(Facultatif)

Spécifie le type de fonction de surface qui sera ajusté autour de la cellule cible.

  • QuadratiqueUne fonction de surface quadratique est ajustée aux cellules du voisinage. Il s’agit de l’option par défaut.
  • BiquadratiqueUne fonction de surface biquadratique est ajustée aux cellules du voisinage.
String
Distance du voisinage
(Facultatif)

La sortie sera calculée sur cette distance à partir du centre de la cellule cible. Elle détermine la taille du voisinage.

La valeur par défaut est la taille de cellule du raster en entrée, soit un voisinage de 3 par 3.

Linear Unit
Utiliser le voisinage adaptatif
(Facultatif)

Spécifie si la distance de voisinage varie selon les changements (variations) du paysage. La distance maximale est déterminée par la distance de voisinage. La distance minimale correspond à la taille de cellule du raster en entrée.

  • Désactivé : une distance de voisinage unique (fixe) sera utilisée en tout emplacement. Il s’agit de l’option par défaut.
  • Activé : une distance de voisinage adaptative sera utilisée en tout emplacement.
Boolean
Unité Z
(Facultatif)

Spécifie l’unité linéaire qui sera utilisée pour les 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. Le mètre est la valeur par défaut.

  • PouceLes unités linéaires sont les pouces.
  • PiedLes unités linéaires sont les pieds.
  • YardLes unités linéaires sont les yards.
  • Mile USLes unités linéaires sont les milles.
  • Mille nautiqueLes unités linéaires sont les milles nautiques.
  • MillimètreLes unités linéaires sont les millimètres.
  • CentimètreLes unités linéaires sont les centimètres.
  • MètreLes unités linéaires sont les mètres.
  • KilomètreLes unités linéaires sont les kilomètres.
  • DécimètreLes unités linéaires sont les décimètres.
String
Mesure de pente
(Facultatif)

Unités de mesure (degrés ou pourcentages) qui seront utilisées pour le raster de pente en sortie.

Ce paramètre n’est disponible que si le paramètre Parameter type (Type de paramètre) est défini sur Slope (Pente).

  • DegréL'inclinaison de la pente est calculée en degrés.
  • Pourcentage d’élévationL'inclinaison de la pente est calculée en pourcentage d'élévation, également désigné sous le nom de pourcentage de pente.
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.

  • Non sélectionné : les azimuts géodésiques ne seront pas projetés. Il s’agit de l’option par défaut.
  • Sélectionné : les azimuts géodésiques seront projetés.

Ce paramètre est disponible uniquement si le paramètre Type de paramètre est défini sur Exposition.

Boolean
Utiliser l’aspect équatorial
(Facultatif)

Spécifie si l’exposition est mesurée à partir d’un point sur l’équateur ou à partir du pôle Nord.

  • Désactivé : l’exposition est mesurée à partir du pôle Nord. Il s’agit de l’option par défaut.
  • Activé : l’exposition est mesurée à partir d’un point sur l’équateur.

Ce paramètre est disponible uniquement si le paramètre Type de paramètre est défini sur Exposition.

Boolean
Masque d’analyse en entrée
(Facultatif)

Données en entrée définissant les localisations où a lieu l’analyse.

Il peut s'agir d'un raster ou d'un jeu de données d'entité. Si l’entrée est un raster, elle peut être de type entier ou à virgule flottante. Si l’entrée correspond à des données d’entités, elle peut être de type ponctuel, linéaire ou surfacique.

Lorsque les données de masque en entrée correspondent à un raster, l’analyse a lieu à des emplacements ayant une valeur valide, zéro compris. Les cellules NoData dans l’entrée du masque auront une valeur NoData dans la sortie.

Composite Geodataset

Valeur renvoyée

ÉtiquetteExplicationType de données
Raster en sortie

Raster en sortie.

Raster

arcpy.ddd.SurfaceParameters(in_raster, out_raster, {parameter_type}, {local_surface_type}, {neighborhood_distance}, {use_adaptive_neighborhood}, {z_unit}, {output_slope_measurement}, {project_geodesic_azimuths}, {use_equatorial_aspect}, {in_analysis_mask})
NomExplicationType de données
in_raster

Raster de surface en entrée.

Raster Layer
out_raster

Raster en sortie.

Il sera de type virgule flottante.

Raster Dataset
parameter_type
(Facultatif)

Spécifie le type de paramètre de surface en sortie à calculer.

  • SLOPELe taux de variation de l’élévation est calculé. Il s’agit de l’option par défaut.
  • ASPECTLa direction de la pente descendante du taux de variation maximal pour chaque cellule est calculée.
  • MEAN_CURVATURELa courbure globale de la surface est mesurée. Elle est calculée comme étant la moyenne des courbures maximale et minimale. Cette courbure décrit la convexité ou la concavité intrinsèque de la surface, indépendamment de la direction ou de l’influence de la gravité.
  • TANGENTIAL_CURVATURELa courbure normale géométrique perpendiculaire à la ligne de pente, tangente à l’isoligne, est mesurée. Cette courbure est généralement appliquée pour caractériser la convergence ou la divergence de l’écoulement sur la surface.
  • PROFILE_CURVATURELa courbure normale géométrique le long de la ligne de pente est mesurée. Cette courbure est généralement appliquée pour caractériser l’accélération et la décélération de l’écoulement sur la surface.
  • CONTOUR_CURVATURELa courbure le long des isolignes est mesurée.
  • CONTOUR_GEODESIC_TORSIONLe taux de variation de l’angle de pente le long des isolignes est mesuré.
  • GAUSSIAN_CURVATURELa courbure globale de la surface est mesurée. Elle est calculée comme le produit des courbures maximale et minimale.
  • CASORATI_CURVATURELa courbure générale de la surface est mesurée. Elle peut être égale à zéro ou à un autre nombre positif quelconque.
String
local_surface_type
(Facultatif)

Spécifie le type de fonction de surface qui sera ajusté autour de la cellule cible.

  • QUADRATICUne fonction de surface quadratique est ajustée aux cellules du voisinage. Il s’agit de l’option par défaut.
  • BIQUADRATICUne fonction de surface biquadratique est ajustée aux cellules du voisinage.
String
neighborhood_distance
(Facultatif)

La sortie sera calculée sur cette distance à partir du centre de la cellule cible. Elle détermine la taille du voisinage.

La valeur par défaut est la taille de cellule du raster en entrée, soit un voisinage de 3 par 3.

Linear Unit
use_adaptive_neighborhood
(Facultatif)

Spécifie si la distance de voisinage varie selon les changements (variations) du paysage. La distance maximale est déterminée par la distance de voisinage. La distance minimale correspond à la taille de cellule du raster en entrée.

  • FIXED_NEIGHBORHOODUne distance de voisinage unique (fixe) sera utilisée dans tous les emplacements. Il s’agit de l’option par défaut.
  • ADAPTIVE_NEIGHBORHOODUne distance de voisinage adaptatif sera utilisée dans tous les emplacements.
Boolean
z_unit
(Facultatif)

Spécifie l’unité linéaire qui sera utilisée pour les 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. Le mètre est la valeur par défaut.

  • INCHLes unités linéaires sont les pouces.
  • FOOTLes unités linéaires sont les pieds.
  • YARDLes unités linéaires sont les yards.
  • MILE_USLes unités linéaires sont les milles.
  • NAUTICAL_MILELes unités linéaires sont les milles nautiques.
  • MILLIMETERLes unités linéaires sont les millimètres.
  • CENTIMETERLes unités linéaires sont les centimètres.
  • METERLes unités linéaires sont les mètres.
  • KILOMETERLes unités linéaires sont les kilomètres.
  • DECIMETERLes unités linéaires sont les décimètres.
String
output_slope_measurement
(Facultatif)

Unités de mesure (degrés ou pourcentages) qui seront utilisées pour le raster de pente en sortie.

  • DEGREEL'inclinaison de la pente est calculée en degrés.
  • PERCENT_RISEL'inclinaison de la pente est calculée en pourcentage d'élévation, également désigné sous le nom de pourcentage de pente.

Ce paramètre n’est pris en charge que si le paramètre parameter_type est défini sur SLOPE.

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.

  • GEODESIC_AZIMUTHSLes azimuts géodésiques ne seront pas projetés. Il s’agit de l’option par défaut.
  • PROJECT_GEODESIC_AZIMUTHSLes azimuts géodésiques seront projetés.

Ce paramètre est pris en charge uniquement lorsque le paramètre parameter_type est défini sur ASPECT.

Boolean
use_equatorial_aspect
(Facultatif)

Spécifie si l’exposition est mesurée à partir d’un point sur l’équateur ou à partir du pôle Nord.

  • NORTH_POLE_ASPECTL’exposition est mesurée à partir du pôle Nord. Il s’agit de l’option par défaut.
  • EQUATORIAL_ASPECTL’exposition est mesurée à partir d’un point sur l’équateur.

Ce paramètre est pris en charge uniquement lorsque le paramètre parameter_type est défini sur ASPECT.

Boolean
in_analysis_mask
(Facultatif)

Données en entrée définissant les localisations où a lieu l’analyse.

Il peut s'agir d'un raster ou d'un jeu de données d'entité. Si l’entrée est un raster, elle peut être de type entier ou à virgule flottante. Si l’entrée correspond à des données d’entités, elle peut être de type ponctuel, linéaire ou surfacique.

Lorsque les données de masque en entrée correspondent à un raster, l’analyse a lieu à des emplacements ayant une valeur valide, zéro compris. Les cellules NoData dans l’entrée du masque auront une valeur NoData dans la sortie.

Composite Geodataset

Valeur renvoyée

NomExplicationType de données
out_raster

Raster en sortie.

Raster

Exemple de code

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

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

Cet exemple génère un raster de pente avec des valeurs en sortie en pourcentages en utilisant une méthode de voisinage adaptatif. La distance de voisinage maximale est 5 mètres.

from arcpy.sa import *
outSurfaceParameters = SurfaceParameters("elevation_1m.tif", "", "", "5 METERS",
                                         "ADAPTIVE_NEIGHBORHOOD", "", "PERCENT_RISE")
outSurfaceParameters.save("C:/sapyexamples/output/outsurfaceparameters01.tif")
Exemple 2 d’utilisation de l’outil SurfaceParameters (script autonome)

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

Cet exemple génère un raster de courbure longitudinale (ligne de pente normale) en utilisant une méthode de voisinage adaptatif. La distance de voisinage maximale est 10 mètres.

# Name: SurfaceParameters_Ex_02.py
# Description: Derive profile (normal slope line) curvature for a 1m resolution
# elevation raster over an adaptive neighborhood distance of maximum 10m. 
# 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_1m.tif"
inParameterType = "PROFILE_CURVATURE"
inNeighborhoodDistance = "10 METERS"
inUseAdaptiveNeighborhood = "ADAPTIVE_NEIGHBORHOOD"

# Execute the tool
outSurfaceParameters = SurfaceParameters(inRaster, inParameterType, "",
                                         inNeighborhoodDistance, inUseAdaptiveNeighborhood)

# Save the output 
outSurfaceParameters.save("C:/sapyexamples/output/outsurfaceparameters02.tif")
Exemple 3 d’utilisation de l’outil SurfaceParameters (script autonome)

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

Cet exemple génère un raster d’exposition en utilisant une distance de voisinage de 5 mètres. Corrigez les distorsions de direction pour les empêcher d’utiliser une projection non conforme.

# Name: SurfaceParameters_Ex_03.py
# Description: Derive aspect for an elevation surface over a distance of 5m, correct
# for direction distortion from non-conformal projection system. 
# 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_1m.tif"
inParameterType = "ASPECT"
inNeighborhoodDistance = "5 METERS"
inProjectGeodesicAzimuths = "PROJECT_GEODESIC_AZIMUTHS"

# Execute the tool
outSurfaceParameters = SurfaceParameters(inRaster, inParameterType, "",
                                         inNeighborhoodDistance, "", "", "",
                                         inProjectGeodesicAzimuths)

# Save the output 
outSurfaceParameters.save("C:/sapyexamples/output/outsurfaceparameters03.tif")
Exemple 1 d’utilisation de l’outil SurfaceParameters (fenêtre Python)

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

Cet exemple génère un raster de pente avec des valeurs en sortie en pourcentages en utilisant une méthode de voisinage adaptatif. La distance de voisinage maximale est 5 mètres.

from arcpy.ddd import *
SurfaceParameters("elevation_1m.tif", "C:/data/output/outsurfaceparameters01.tif",
                  "", "", "5 METERS", "ADAPTIVE_NEIGHBORHOOD", "", "PERCENT_RISE")
Exemple 2 d’utilisation de l’outil SurfaceParameters (script autonome)

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

Cet exemple génère un raster de courbure longitudinale (ligne de pente normale) en utilisant une méthode de voisinage adaptatif. La distance de voisinage maximale est 10 mètres.

# Name: SurfaceParameters_Ex_02.py
# Description: Derive profile (normal slope line) curvature for a 1m
# resolution elevation raster over an adaptive neighborhood distance of maximum 10m. 
# Requirements: 3D Analyst Extension

# Import system modules
import arcpy
from arcpy.ddd import *

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

# Check out the ArcGIS 3D Analyst extension license
arcpy.CheckOutExtension("3D")

# Set local variables
inRaster = "elevation_1m.tif"
outRaster = "C:/data/output/outsurfaceparameters02.tif"
inParameterType = "PROFILE_CURVATURE"
inNeighborhoodDistance = "10 METERS"
inUseAdaptiveNeighborhood = "ADAPTIVE_NEIGHBORHOOD"

# Execute the tool
SurfaceParameters(inRaster, outRaster, inParameterType, "",
                  inNeighborhoodDistance, inUseAdaptiveNeighborhood)
Exemple 3 d’utilisation de l’outil SurfaceParameters (script autonome)

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

Cet exemple génère un raster d’exposition en utilisant une distance de voisinage de 5 mètres. Corrigez les distorsions de direction pour les empêcher d’utiliser une projection non conforme.

# Name: SurfaceParameters_Ex_03.py
# Description: Derive aspect for an elevation surface over a distance of 5m, correct
# for direction distortion from non-conformal projection system. 
# Requirements: 3D Analyst Extension

# Import system modules
import arcpy
from arcpy.ddd import *

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

# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("3D")

# Set local variables
inRaster = "elevation_1m.tif"
outRaster = "C:/data/output/outsurfaceparameters03.tif"
inParameterType = "ASPECT"
inNeighborhoodDistance = "5 METERS"
inProjectGeodesicAzimuths = "PROJECT_GEODESIC_AZIMUTHS"

# Execute the tool
SurfaceParameters(inRaster, outRaster, inParameterType, "", inNeighborhoodDistance,
                  "", "", "", inProjectGeodesicAzimuths)

Rubriques connexes