Isolignes selon des valeurs (centile) (Spatial Analyst)—ArcGIS Pro

Disponible avec une licence Spatial Analyst.

Synthèse

Crée des isolignes qui délimitent les p % supérieurs d’un raster en classant les valeurs de cellule, en sélectionnant les cellules au seuil du centile et en produisant des emprises aux zones extrêmes.

En savoir plus sur le fonctionnement de l’outil Isolignes selon des valeurs (centile)

Illustration

Utilisation

Les valeurs de centile peuvent être n’importe quelles valeurs comprises entre 0 et 100. La valeur 100 peut entraîner un résultat vide ou insignifiant. La valeur 0 renvoie la totalité de l’emprise valide.
L’outil classe les cellules selon leurs valeurs dans l’ordre croissant et renvoie les p % supérieurs des cellules raster. Le seuil de centile est calculé à partir des valeurs de cellule classées. La sortie sélectionne les cellules qui atteignent ou dépassent la valeur du seuil.
L’emprise du polygone d’isolignes en sortie indique la zone englobée par le pourcentage de la somme totale des valeurs extrêmes au-dessus du centile spécifié.
S’il existe des valeurs répétées au seuil, toutes les valeurs répétées sont sélectionnées. Ainsi, les centiles adjacents peuvent produire un seuil et un polygone d’isolignes en sortie identiques. Toutefois, l’outil ne sous-sélectionne pas les valeurs relatives au centile spécifié.
Lorsque plusieurs valeurs de centile sont spécifiées, les polygones en sortie sont imbriqués. Le polygone le plus à l’intérieur correspond aux valeurs les plus élevées et le polygone le plus à l’extérieur couvre les valeurs les plus basses.
L’option Planaire du paramètre Méthode convient si l’analyse est effectuée à une échelle locale avec une projection qui garantit avec précision le maintien des distances et surfaces correctes.
Utilisez l’option Géodésique pour effectuer l’analyse à une échelle régionale ou étendue (par exemple, à l’aide de Web Mercator ou d’un système de coordonnées géographiques). Cette option tient compte de la courbure du sphéroïde et gère correctement les données situées près des pôles et de la ligne de changement de date internationale.
Si le paramètre Ignorer les valeurs négatives n’est pas activé, l’outil inclut les valeurs négatives des cellules en entrée dans le calcul.
Le raster de surface en entrée doit être un raster monobande.
Si l’objectif est de créer des polygones basés sur la magnitude cumulée des valeurs de cellule, utilisez l’outil Isolignes selon un volume (centile) à la place.
Pour plus d’informations sur les environnements de géotraitement qui s’appliquent à cet outil, reportez-vous à la rubrique Environnements d’analyse et Spatial Analyst.

Paramètres

Étiquette	Explication	Type de données
Raster de surface en entrée	Raster en entrée pour lequel les polygones d’isolignes sont calculés. Il doit s’agir d’un raster continu. Les données du raster en entrée peuvent être de type entier ou à virgule flottante.	Raster Layer
Polygones d’isolignes en sortie	Entités surfaciques des isolignes en sortie. La sortie comprend les polygones d’isolignes de toutes les valeurs de centile spécifiées.	Feature Class
Valeurs de centile (Facultatif)	Valeurs de centile pour lesquelles les isolignes sont calculées. La valeur par défaut est 90, soit le 90^e centile. Les valeurs peuvent varier entre 0 et 100.	Double
Méthode (Facultatif)	Spécifie le calcul selon 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 les États les plus petits. La méthode géodésique produit un résultat plus précis, mais peut nécessiter un temps de traitement supplémentaire. Planaire—Le calcul est effectué sur une surface plane projetée à l’aide d’un système de coordonnées cartésien 2D. Il s’agit de l’option par défaut. Géodésique—Le calcul est effectué dans un système de coordonnées cartésiennes 3D en considérant la forme de la Terre comme une ellipsoïde.	String
Ignorer les valeurs négatives (Facultatif)	Indique si les valeurs négatives seront ignorées dans le calcul des valeurs (centile). Activé : les valeurs négatives seront ignorées dans le calcul de centile. Désactivé : les valeurs négatives ne sont pas ignorées dans le calcul de centile ; elles sont incluses. Il s’agit de l’option par défaut.	Boolean

ValuePercentileContours(in_surface_raster, out_contour_polygons, {percentile_values}, {method}, {ignore_negative_values})

Nom	Explication	Type de données
in_surface_raster	Raster en entrée pour lequel les polygones d’isolignes sont calculés. Il doit s’agir d’un raster continu. Les données du raster en entrée peuvent être de type entier ou à virgule flottante.	Raster Layer
out_contour_polygons	Entités surfaciques des isolignes en sortie. La sortie comprend les polygones d’isolignes de toutes les valeurs de centile spécifiées.	Feature Class
percentile_values [percentile_values,...] (Facultatif)	Valeurs de centile pour lesquelles les isolignes sont calculées. La valeur par défaut est 90, soit le 90^e centile. Les valeurs peuvent varier entre 0 et 100.	Double
method (Facultatif)	Spécifie le calcul selon 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 les États les plus petits. La méthode géodésique produit un résultat plus précis, mais peut nécessiter un temps de traitement supplémentaire. PLANAR—Le calcul est effectué sur une surface plane projetée à l’aide d’un système de coordonnées cartésien 2D. Il s’agit de l’option par défaut. GEODESIC—Le calcul est effectué dans un système de coordonnées cartésiennes 3D en considérant la forme de la Terre comme une ellipsoïde.	String
ignore_negative_values (Facultatif)	Indique si les valeurs négatives seront ignorées dans le calcul des valeurs (centile). IGNORE_NEGATIVE_VALUES—Les valeurs négatives sont ignorées dans le calcul de centile. USE_ALL_VALUES—Les valeurs négatives ne seront pas ignorées dans le calcul de centile ; elles sont incluses. Il s’agit de l’option par défaut.	Boolean

Exemple de code

Exemple 1 d’utilisation de la fonction ValuePercentileContours (fenêtre Python)

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

import arcpy
from arcpy import env
from arcpy.sa import *

env.workspace = "C:/sapyexamples/data"
ValuePercentileContours("CrimeEventsDensity.tif", "ValP_CrimeDensity_Out.shp",
                        [50, 75, 90, 95, 99], method = "Planar", 
                        ignore_negative_values = "USE_ALL_VALUES")

Exemple 2 d’utilisation de la fonction ValuePercentileContours (script autonome)

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

## Name: ValuePercentileContours_Ex_standalone.py  
## Description: Identify different local intensity zones from density surface
## Requirements: Spatial Analyst Extension 
 
## Import system modules 
import arcpy  
from arcpy import env   
from arcpy.sa import *

## Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
 
## Set environment settings 
env.workspace = "C:/sapyexamples/data"
# To allow overwriting outputs change overwriteOutput option to True. 
env.overwriteOutput = False 
  
## Set local variables 
in_surface_raster = "CrimeEventsDensity.tif"
percentile_values = [50, 75, 90, 95, 99]
method = "Planar"
ignore_negative_values = "USE_ALL_VALUES"
out_volueP_contour = "ValueP_CrimeDensity_Out.shp"
  
## Execute: Create Volume Percentile Contours  
ValueP_out_contours = ValuePercentileContours(in_surface_raster, 
                                              out_volueP_contour, 
                                              percentile_values,
                                              method, ignore_negative_values)

Informations de licence

Basic: Nécessite Spatial Analyst
Standard: Nécessite Spatial Analyst
Advanced: Nécessite Spatial Analyst

Rubriques connexes

Vous avez un commentaire à formuler concernant cette rubrique ?