Isolignes selon un volume (centile) (Outils Spatial Analyst)

Résumé

Crée des isolignes qui délimitent la zone la plus petite comprenant les premiers p % de la grandeur 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 * 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 Planar (Planaire) ou Geodesic (Géodésique) du paramètre Method (Méthode). 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 Planar (Planaire) du paramètre Method (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 Geodesic (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 Ignore Negative Values (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 uniquement 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.

Etiqueter	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 si le calcul repose sur 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 de plus petits états d’une zone. La méthode géodésique produit un résultat plus précis, mais peut nécessiter un temps de traitement supplémentaire. plane—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 de volume (centile). Activé—Les valeurs négatives seront ignorées dans le calcul de volume (centile). Décoché—Les valeurs négatives ne seront pas ignorées dans le calcul de volume (centile) ; elles seront incluses. Il s’agit de l’option par défaut.	Boolean
Lisser les sorties (Facultatif)	Détermine si les polygones en sortie doivent être lissés pour donner des formes plus simples ou s’ils respectent les bordures des cellules du raster en entrée. Activé—Les polygones sont lissés pour donner des formes plus simples. Le lissage est effectué de sorte que les polygones contiennent un nombre minimal de segments, tout en restant aussi proches que possible des bordures des cellules du raster d’origine. Il s’agit de l’option par défaut. Décoché—Le segment des polygones respecte exactement les bordures des cellules du raster en entrée. Avec cette option, lorsque la classe d’entités surfaciques produite est reconvertie en raster, le raster généré est identique au raster d’origine.	Boolean

VolumePercentileContours(in_surface_raster, out_contour_polygons, {percentile_values}, {method}, {ignore_negative_values}, {smooth_outputs})

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 si le calcul repose sur 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 de plus petits états d’une zone. 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 de volume (centile). `IGNORE_NEGATIVE_VALUES`—Les valeurs négatives seront ignorées dans le calcul de volume (centile). `USE_ALL_VALUES`—Les valeurs négatives ne seront pas ignorées dans le calcul de volume (centile) ; elles seront incluses. Il s’agit de l’option par défaut.	Boolean
smooth_outputs (Facultatif)	Détermine si les polygones en sortie doivent être lissés pour donner des formes plus simples ou s’ils respectent les bordures des cellules du raster en entrée. `SMOOTH`—Les polygones sont lissés pour donner des formes plus simples. Le lissage est effectué de sorte que les polygones contiennent un nombre minimal de segments, tout en restant aussi proches que possible des bordures des cellules du raster d’origine. Il s’agit de l’option par défaut. `NO_SMOOTH`—Le segment des polygones respecte exactement les bordures des cellules du raster en entrée. Avec cette option, lorsque la classe d’entités surfaciques produite est reconvertie en raster, le raster généré est identique au raster d’origine.	Boolean

Exemple de code

VolumePercentileContours Exemple 1 (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"
VolumePercentileContours("CrimeEventsDensity.tif", "VolP_CrimeDensity_Out.shp",
                         [50, 75, 90, 95, 99], method = "Planar",
                         ignore_negative_values = "USE_ALL_VALUES",
                         smooth_outputs="SMOOTH")

VolumePercentileContours Exemple 2 (script autonome)

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 *

## 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"
smooth_outputs="SMOOTH"
out_volP_contour = "VolumeP_CrimeDensity_Out.shp"

## Run: Create Volume Percentile Contours
VolumP_out_contours = VolumePercentileContours(in_surface_raster,
                                               out_volP_contour,
                                               percentile_values, method,
                                               ignore_negative_values, smooth_outputs)

Environnements

Validation automatique, Espace de travail courant, Valeur Z en sortie par défaut, Etendue, Transformations géographiques, Résolution M, Tolérance M, Facteur de traitement parallèle, Mot-clé CONFIG en sortie, Système de coordonnées en sortie, Valeurs M en sortie, Valeurs Z en sortie, Domaine M en sortie, Domaine XY en sortie, Domaine Z en sortie, Espace de travail temporaire, Résolution XY, Tolérance XY, Résolution Z, Tolérance Z

Informations de licence

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