| É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 90e 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.
| String |
Ignorer les valeurs négatives (Facultatif) | Indique si les valeurs négatives seront ignorées dans le calcul de volume (centile).
| Boolean |
Disponible avec une licence Spatial Analyst.
Synthèse
Crée des isolignes qui délimitent la zone la plus petite comprenant les p % de la magnitude totale (valeur × surface de cellule) en accumulant les cellules classées au seuil de volume.
En savoir plus sur le fonctionnement de l’outil Isolignes selon un volume (centile)
Illustration
Utilisation
Les valeurs de centiles peuvent être n’importe quelle valeur comprise entre 0 et 100. La valeur 0 peut entraîner un résultat vide ou insignifiant. Une valeur de 100 renvoie l’intégralité de l’emprise valide.
L’outil classe les cellules selon leurs valeurs par ordre décroissant et cumule le volume par cellule (volume x surface de cellule) jusqu’à ce que le total cumulé atteigne p pourcent du volume total du raster. La surface est calculée par la valeur du paramètre Méthode Planaire ou Géodésique. Le seuil du volume (centile) est la valeur au niveau de la limite. La sortie sélectionne les cellules qui atteignent ou dépassent ce seuil.
La zone se trouvant à l’intérieur du polygone d’isolignes en sortie indique la zone englobée par le pourcentage de la somme totale du volume calculé à l’aide des valeurs centiles. La surface des polygones en sortie correspond à l’emprise physique, elle n’est pas égale au volume, mais il s’agit de la surface comprenant p pourcent du volume.
S’il existe des valeurs identiques au seuil du volume, l’outil inclut toutes les valeurs se trouvant à ce seuil. Par conséquent, le volume en sortie ne sera pas inférieur au centile spécifié. Il en résulte que des centiles adjacents peuvent être similaires.
Lorsque plusieurs valeurs de centiles 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.
La surface de la forme du polygone indique la proportion de terrain se trouvant dans cette bande extrême.
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 sélectionné, l’outil inclut les valeurs négatives des cellules en entrée dans l’analyse. Ceci peut avoir une incidence sur la somme cumulée du calcul du volume.
Le raster de surface en entrée doit être un raster monobande.
Si l’objectif est de créer des polygones basés sur les valeurs des cellules classées, utilisez l’outil Isolignes selon des valeurs (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
VolumePercentileContours(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 90e 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.
| String |
ignore_negative_values (Facultatif) | Indique si les valeurs négatives seront ignorées dans le calcul de volume (centile).
| Boolean |
Exemple de code
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"
VolumePercentileContours("CrimeEventsDensity.tif", "VolP_CrimeDensity_Out.shp",
[50, 75, 90, 95, 99], method = "Planar",
ignore_negative_values = "USE_ALL_VALUES")L’exemple suivant illustre l’utilisation de cet outil dans un script Python autonome.
## Name: VolumePercentileContours_Ex_standalone.py
## Description: Delineate areas of different magnitudes 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 = [25, 50, 75, 90, 95, 99]
method = "Planar"
ignore_negative_values = "USE_ALL_VALUES"
out_volP_contour = "VolumeP_CrimeDensity_Out.shp"
## Execute: Create Volume Percentile Contours
VolumP_out_contours = VolumePercentileContours(in_surface_raster,
out_volP_contour,
percentile_values, method,
ignore_negative_values)Environnements
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 ?