Isolignes selon des valeurs (centile) (Outils Spatial Analyst)

Résumé

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 centiles peuvent être n’importe quelle valeur comprise 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 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 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.

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 des valeurs (centile). Activé—Les valeurs négatives sont ignorées dans le calcul de centile. Décoché—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
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

ValuePercentileContours(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 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
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

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

ValuePercentileContours Exemple 2 (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 *

### 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"
smooth_outputs="SMOOTH"
out_volueP_contour = "ValueP_CrimeDensity_Out.shp"

## Run: Create Value Percentile Contours
ValueP_out_contours = ValuePercentileContours(in_surface_raster,
                                              out_volueP_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