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

Boîte de dialogue

Étiquette	Explication	Type 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 locaux—Les pics locaux sont détectés. Il s’agit de l’option par défaut. Vallées locales—Les 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

Python

arcpy.defense.FindLocalPeaksValleys(in_surface, out_feature_class, peak_valley_op_type, num_peaks_valleys, {in_feature})

Nom	Explication	Type 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. PEAKS—Les pics locaux sont détectés. Il s’agit de l’option par défaut. VALLEYS—Les 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)

Environnements

Système de coordonnées en sortie, Étendue, Espace de travail courant, Espace de travail temporaire