Rechercher les sommets ou vallées locaux (Défense)

Disponible avec une licence Advanced.

Disponible avec une licence Spatial Analyst.

Synthèse

Recherche les sommets ou vallées à l’intérieur d’une zone définie.

Utilisation

  • Le nombre d’entités ponctuelles les plus élevées ou les plus basses renvoyé peut être inférieur à celui demandé dans le paramètre Number of Peaks or Valleys (Nombre de sommets ou vallées). L’outil ne renvoie que le nombre de sommets ou vallées locaux qui peuvent être identifiés en fonction de la surface en entrée.

  • Les sommets sont recherchés en inversant la surface, puis en recherchant les cuvettes dans la surface. Ces points sont utilisés pour extraire les valeurs d’altitude de la surface d'origine et sont triés en fonction de l’altitude.

  • L’altitude de la Input Surface (Surface en entrée) permet de classer les points, mais le nombre renvoyé est basé sur l’ordre trié des valeurs d’altitude. Si vous choisissez les 10 points les plus élevés et que les points 10, 11 et 12 possèdent la même altitude, l’outil exclut les deux derniers.

  • Cet outil recherche les valeurs minimales ou maximales d’une zone (par exemple, le sommet d’une petite colline au milieu d’une vallée entourée de hautes montagnes est identifié comme un sommet local).

  • La sortie contient un champ Elevation avec la valeur d’altitude des sommets ou vallées. Les unités des sommets ou vallées correspondent aux unités z (altitude) de la surface en entrée. Recherchez cette unité dans les métadonnées de la surface en entrée.

Paramètres

ÉtiquetteExplicationType de données
Surface en entrée

Surface raster d’altitude en entrée.

Raster Layer; Mosaic Dataset; Mosaic Layer
Classe d’entités en sortie

Classe d’entités ponctuelles en sortie contenant les sommets ou vallées locaux.

Feature Class
Sommets ou vallées

Spécifie le type d’opération effectuée par l’outil.

  • Pics locauxLes pics locaux sont détectés. Il s’agit de l’option par défaut.
  • Vallées localesLes vallées locales sont détectées.
String
Nombre de sommets ou vallées

Nombre de sommets ou vallées à rechercher.

Long
Zone en entrée
(Facultatif)

Classe d'entités surfaciques en entrée dans laquelle se trouveront les sommets ou vallées locaux.

Feature Set

arcpy.defense.FindLocalPeaksValleys(in_surface, out_feature_class, peak_valley_op_type, num_peaks_valleys, {in_feature})
NomExplicationType de données
in_surface

Surface raster d’altitude en entrée.

Raster Layer; Mosaic Dataset; Mosaic Layer
out_feature_class

Classe d’entités ponctuelles en sortie contenant les sommets ou vallées locaux.

Feature Class
peak_valley_op_type

Spécifie le type d’opération effectuée par l’outil.

  • PEAKSLes pics locaux sont détectés. Il s’agit de l’option par défaut.
  • VALLEYSLes vallées locales sont détectées.
String
num_peaks_valleys

Nombre de sommets ou vallées à rechercher.

Long
in_feature
(Facultatif)

Classe d'entités surfaciques en entrée dans laquelle se trouveront les sommets ou vallées locaux.

Feature Set

Exemple de code

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

Le script suivant pour la fenêtre Python illustre l’utilisation de la fonction FindLocalPeaksValleys.

import arcpy
arcpy.env.workspace = r"C:/Data.gdb"
arcpy.defense.FindLocalPeaksValleys("n36.dt2",
                                    "n36_FindLocalPeaksValleys",
                                    "PEAKS",
                                    10,
                                    "SelectedAOI")
Exemple 2 d’utilisation de l’outil FindLocalPeaksValleys (script autonome)

L’exemple suivant utilise la fonction FindLocalPeaksValleys dans un script de processus d’exemple.

# Description: Find the highest peak in Crowders State Park.

# Import system modules
import arcpy

# Set environment settings
arcpy.env.workspace = r"C:/Data.gdb"

# Select state park
state_parks = "NCStateParks"
whereClause = "st_park_name = 'Crowders Mountain State Park'"
aoi_layer = arcpy.management.SelectLayerByAttribute(state_parks,
                                                    "NEW_SELECTION",
                                                    whereClause)

# Inputs
input_surface = "n36.dt2"

# Find highest peak 
arcpy.defense.FindLocalPeaksValleys(input_surface,
                                    "PeaksCrowdersMtn",
                                    "PEAKS",
                                    10,
                                    aoi_layer)