Une zone est définie comme l’ensemble des surfaces en entrée ayant la même valeur. Les surfaces ne sont pas nécessairement contiguës. Vous pouvez utiliser à la fois des entités et des rasters pour la zone en entrée.
Si la valeur du paramètre Input Raster or Feature Zone Data (Données raster ou d’entités de zones en entrée) (in_zone_data dans Python) est un raster, il doit s’agir d’un raster de type entier.
Si la valeur du paramètre Input Raster or Feature Zone Data (Données raster ou d’entités de zones en entrée) est une entité, elle est convertie en raster en interne avec la taille de cellule et l’alignement des cellules du paramètre Input Value Raster (Raster de valeurs en entrée) (in_value_raster dans Python).
Si la taille de cellule, l’alignement des cellules ou la référence spatiale des valeurs des paramètres Input Raster or Feature Zone Data (Données raster ou vecteur de zones en entrée) et Input Value Raster (Raster de valeurs en entrée) sont différents, la valeur Input Value Raster (Raster de valeurs en entrée) est utilisée comme taille de cellule, raster de capture et système de coordonnées en sortie en interne. Ces cas déclenchent un rééchantillonnage interne avant l’exécution de l’opération zonale.
Lorsque la zone ou les valeurs en entrée sont des rasters avec la même taille de cellule et que les cellules sont alignées, elles utilisent directement l’outil et ne sont pas ré-échantillonnées en interne au cours de l’exécution de l’outil.
Si la valeur du paramètre Input Raster or Feature Zone Data (Données raster ou d’entités de zones en entrée) est une entité, pour n’importe quelle entité de zone qui ne chevauche aucun centre de cellule du raster de valeur, ces zones ne sont pas converties en raster de zones interne. Ces zones ne seront par conséquent pas représentées en sortie. Vous pouvez le faire en déterminant une valeur appropriée pour l’environnement de taille de cellule permettant de préserver le niveau de détail souhaité des zones d’entités, et en spécifiant ceci dans l’environnement d’analyse.
Si la valeur Input Raster or Feature Zone Data (Données raster ou vecteur de zones en entrée) est une entité ponctuelle, plusieurs points peuvent être contenus dans toute cellule du raster de valeurs en entrée. Pour de telles cellules, la valeur de zone est déterminée par le point doté du champ ObjectID le plus faible (OID ou FID, par exemple).
Si la valeur Input Raster or Feature Zone Data (Données raster ou de vecteur de zones en entrée) contient des polygones superposés, l’analyse zonale n’est pas effectuée pour chaque polygone individuel. Comme l’entité en entrée est convertie en raster, chaque emplacement ne peut avoir qu’une seule valeur.
Une méthode alternative consiste à traiter l’opération zonale de façon itérative pour chacune des zones de polygone et à assembler les résultats.
Lorsque vous spécifiez la valeur du paramètre Input Raster or Feature Zone Data (Données raster ou d’entités de zones en entrée), le champ de zone par défaut est le premier champ de type entier ou texte disponible. S’il n’existe aucun autre champ valide, le champ ObjectID (par exemple, OID ou FID) est utilisé par défaut.
Le type de statistique pris en charge dépend du type de données de la valeur Input Value Raster (Raster de valeurs en entrée) et du type de calcul de statistiques spécifié par le paramètre Calculate Circular Statistics (Calculer les statistiques circulaires).
Si les données sont de type entier, le calcul de statistiques arithmétiques prend en charge les options Mean (Moyenne), Majority (Majorité), Majority count (Nombre majoritaire), Majority percentage (Pourcentage majoritaire), Maximum, Median (Médiane), Minimum, Minority (Minorité), Minority count (Nombre minoritaire), Minority percentage (Pourcentage minoritaire), Percentile (Centile), Range (Plage), Standard deviation (Écart type), Sum (Somme) et Variety (Variété). Le calcul de statistiques circulaires prend en charge les options Mean (Moyenne), Majority (Majorité), Minority (Minorité), Standard deviation (Écart type) et Variety (Variété).
Si les données sont de type flottant, le calcul de statistiques arithmétiques prend en charge les options Mean (Moyenne), Maximum, Median (Médiane), Minimum, Percentile (Centile), Range (Plage), Standard deviation (Écart type) et Sum (Somme). Le calcul de statistiques circulaires prend en charge les options Mean (Moyenne) et Standard deviation (Écart type).
Pour les calculs de majorité et de minorité, en cas d’égalité, la sortie correspond à la plus faible des valeurs égales.
Pour calculer les statistiques circulaires, sélectionnez le paramètre Calculate Circular Statistics (Calculer les statistiques circulaires) (circular_calculation = "CIRCULAR" dans Python), puis spécifiez une valeur pour le paramètre Circular Wrap Value (Valeur de repli circulaire) (circular_wrap_value dans Python).
Les types de jeu de données raster multidimensionnelles pris en charge incluent la couche raster multidimensionnelle, la mosaïque, le service d’imagerie et le CRF d’Esri.
Le type de données (entier ou à virgule flottante) de la sortie dépend du calcul zonal qui est effectué et du type raster de valeurs en entrée. Reportez-vous à la rubrique Fonctionnement des outils de statistiques zonales pour connaître le comportement spécifique d’une statistique.
Par défaut, cet outil utilise jusqu’à 80 % des processeurs multicœurs.
Dans le cas d’un nombre très élevé de zones, utilisez moins de cœurs pour le traitement. Pour indiquer un nombre de cœurs différent, utilisez le paramètre d’environnement Facteur de traitement parallèle.
Lorsque le format raster en sortie est .crf, cet outil prend en charge l’environnement de stockage raster Pyramide. Des pyramides seront créées dans la sortie par défaut. Pour tout autre format en sortie, cet environnement n’est pas pris en charge et aucune pyramide n’est créée.
|
Etiqueter
|
Explication
|
Type de données
|
|
Données raster ou vecteur de zones en entrée
|
Jeu de données définissant les zones.
Les zones peuvent être définies par un raster d'entiers ou une couche d'entités.
|
Raster Layer; Feature Layer
|
|
Champ de zone
|
Champ contenant les valeurs qui définissent chaque zone.
Il peut s'agir d'un champ de type entier ou chaîne du jeu de données de zones.
|
Field
|
|
Raster de valeurs en entrée
|
Raster qui contient les valeurs pour lesquelles calculer une statistique.
|
Raster Layer
|
|
Type de statistique
(Facultatif)
|
Spécifie le type de statistique à calculer.
Moyenne—La moyenne de toutes les cellules du raster de valeurs appartenant à la même zone que la cellule en sortie sera calculée. Il s’agit de l’option par défaut.
Majorité—La valeur qui se produit le plus souvent parmi toutes les cellules du raster de valeurs qui appartiennent à la même zone que la cellule en sortie est calculée.
Nombre majoritaire—La fréquence de toutes les cellules du raster de valeurs qui contiennent la valeur majoritaire et qui appartiennent à la même zone que la cellule en sortie est calculée.
Pourcentage majoritaire—Le pourcentage de cellules du raster de valeurs qui contiennent la valeur majoritaire et qui appartiennent à la même zone que la cellule en sortie est calculée.
Maximum—La plus grande valeur parmi toutes les cellules du raster de valeurs qui appartiennent à la même zone que la cellule en sortie est calculée.
Médiane—La valeur médiane de toutes les cellules du raster de valeurs qui appartiennent à la même zone que la cellule en sortie est calculée.
Minimum—La plus petite valeur parmi toutes les cellules du raster de valeurs qui appartiennent à la même zone que la cellule en sortie est calculée.
Minorité—La valeur qui se produit le moins souvent parmi toutes les cellules du raster de valeurs qui appartiennent à la même zone que la cellule en sortie est calculée.
Nombre minoritaire—La fréquence de toutes les cellules du raster de valeurs qui contiennent la valeur minoritaire et qui appartiennent à la même zone que la cellule en sortie est calculée.
Pourcentage minoritaire—Le pourcentage de cellules du raster de valeurs qui contiennent la valeur minoritaire et qui appartiennent à la même zone que la cellule en sortie est calculée.
Centile—Le centile de toutes les cellules dans le raster de valeur qui appartiennent à la même zone que la cellule en sortie est calculé. Le 90è centile est calculé par défaut. Vous pouvez spécifier d’autres valeurs (entre 0 et 100) à l’aide du paramètre Percentile Value (Valeur de centile).
Plage—L’écart entre la plus petite valeur et la plus grande valeur parmi toutes les cellules du raster de valeurs qui appartiennent à la même zone que la cellule en sortie est calculé.
Écart type—L’écart type de toutes les cellules du raster de valeurs qui appartiennent à la même zone que la cellule en sortie est calculé.
Somme—La valeur totale de toutes les cellules du raster de valeurs qui appartiennent à la même zone que la cellule en sortie est calculée.
Variété—Le nombre de valeurs uniques pour toutes les cellules du raster de valeurs qui appartiennent à la même zone que la cellule en sortie est calculé.
|
String
|
|
Ignorer NoData dans les calculs
(Facultatif)
|
Indique si les valeurs NoData de la valeur en entrée seront ignorées dans les résultats de la zone dans laquelle elles se trouvent.
Activé—Dans une zone particulière, seules les cellules qui ont une valeur dans le raster de valeurs en entrée seront utilisées pour déterminer la valeur en sortie de cette zone. Les cellules NoData dans le raster de valeurs seront ignorées dans le calcul statistique. Il s’agit de l’option par défaut.
Décoché—Dans une zone particulière, s’il existe des cellules NoData dans le raster de valeurs, elles ne seront pas ignorées et leur existence indique que les informations sont insuffisantes pour exécuter des calculs statistiques pour l’ensemble des cellules de cette zone. Par conséquent, toute la zone reçoit la valeur NoData.
|
Boolean
|
|
Traiter comme multidimensionnel
(Facultatif)
|
Spécifie le mode de calcul des rasters en entrée s’il s’agit de rasters multidimensionnels.
Activé—Les statistiques sont calculées pour toutes les dimensions du jeu de données multidimensionnelles en entrée.
Décoché—Les statistiques sont calculées à partir de la tranche actuelle du jeu de données multidimensionnelles. Il s’agit de l’option par défaut.
|
Boolean
|
|
Valeur du centile
(Facultatif)
|
Centile à calculer. La valeur par défaut est de 90, soit le 90e centile.
Les valeurs peuvent varier entre 0 et 100. Le centile n° 0 est équivalent à la statistique minimale tandis que le 100e centile équivaut au maximum Une valeur de 50 donne le même résultat que la statistique médiane.
Ce paramètre est disponible uniquement si le paramètre Statistics type (Type de statistique) est défini sur Percentile (Centile).
|
Double
|
|
Percentile Interpolation Type (Type d’interpolation en centile)
(Facultatif)
|
Définit la méthode d’interpolation à utiliser lorsque la valeur du centile se situe entre deux valeurs de cellule du raster de valeurs en entrée.
Détection automatique—Si le type de pixel du raster de valeurs en entrée est de type entier, la méthode Nearest (Le plus proche) est utilisée. Si le type de pixel du raster de valeurs en entrée est de type flottant, la méthode Linear (Linéaire) est utilisée. Il s’agit de l’option par défaut.
Les plus proches—La valeur disponible la plus proche du centile souhaité est utilisée. Dans ce cas, le type de pixel en sortie est identique à celui du raster de valeurs en entrée.
Linéaire—La moyenne pondérée des deux valeurs environnantes du centile souhaité est utilisée. Dans ce cas, le type de pixel en sortie est à virgule flottante.
|
String
|
|
Calculer les statistiques circulaires
(Facultatif)
|
Spécifie le mode de traitement du raster en entrée pour les données circulaires.
Activé—Les statistiques des angles ou autres quantités cycliques, telles que la direction de la boussole en degrés, les journées ou la partie décimale des nombres réels, sont calculées.
Décoché—Les statistiques linéaires sont calculées. Il s’agit de l’option par défaut.
|
Boolean
|
|
Circular Wrap Value (Valeur de repli circulaire)
(Facultatif)
|
Valeur à utiliser pour arrondir une valeur linéaire à la plage d’une statistique circulaire donnée. La valeur doit être un entier positif ou un nombre à virgule flottante. La valeur par défaut est 360 degrés.
Ce paramètre est pris en charge uniquement si le paramètre Calculate Circular Statistics (Calculer les statistiques circulaires) est sélectionné.
|
Double
|
Valeur de retour
|
Etiqueter
|
Explication
|
Type de données
|
|
Raster en sortie
|
Raster de statistiques zonales en sortie.
|
Raster
|
ZonalStatistics(in_zone_data, zone_field, in_value_raster, {statistics_type}, {ignore_nodata}, {process_as_multidimensional}, {percentile_value}, {percentile_interpolation_type}, {circular_calculation}, {circular_wrap_value})
|
Nom
|
Explication
|
Type de données
|
|
in_zone_data
|
Jeu de données définissant les zones.
Les zones peuvent être définies par un raster d'entiers ou une couche d'entités.
|
Raster Layer; Feature Layer
|
|
zone_field
|
Champ contenant les valeurs qui définissent chaque zone.
Il peut s'agir d'un champ de type entier ou chaîne du jeu de données de zones.
|
Field
|
|
in_value_raster
|
Raster qui contient les valeurs pour lesquelles calculer une statistique.
|
Raster Layer
|
|
statistics_type
(Facultatif)
|
Spécifie le type de statistique à calculer.
MEAN—La moyenne de toutes les cellules du raster de valeurs appartenant à la même zone que la cellule en sortie sera calculée. Il s’agit de l’option par défaut.
MAJORITY—La valeur qui se produit le plus souvent parmi toutes les cellules du raster de valeurs qui appartiennent à la même zone que la cellule en sortie est calculée.
MAJORITY_COUNT—La fréquence de toutes les cellules du raster de valeurs qui contiennent la valeur majoritaire et qui appartiennent à la même zone que la cellule en sortie est calculée.
MAJORITY_PERCENT—Le pourcentage de cellules du raster de valeurs qui contiennent la valeur majoritaire et qui appartiennent à la même zone que la cellule en sortie est calculée.
MAXIMUM—La plus grande valeur parmi toutes les cellules du raster de valeurs qui appartiennent à la même zone que la cellule en sortie est calculée.
MEDIAN—La valeur médiane de toutes les cellules du raster de valeurs qui appartiennent à la même zone que la cellule en sortie est calculée.
MINIMUM—La plus petite valeur parmi toutes les cellules du raster de valeurs qui appartiennent à la même zone que la cellule en sortie est calculée.
MINORITY—La valeur qui se produit le moins souvent parmi toutes les cellules du raster de valeurs qui appartiennent à la même zone que la cellule en sortie est calculée.
MINORITY_COUNT—La fréquence de toutes les cellules du raster de valeurs qui contiennent la valeur minoritaire et qui appartiennent à la même zone que la cellule en sortie est calculée.
MINORITY_PERCENT—Le pourcentage de cellules du raster de valeurs qui contiennent la valeur minoritaire et qui appartiennent à la même zone que la cellule en sortie est calculée.
PERCENTILE—Le centile de toutes les cellules dans le raster de valeur qui appartiennent à la même zone que la cellule en sortie est calculé. Le 90è centile est calculé par défaut. Vous pouvez spécifier d’autres valeurs (entre 0 et 100) à l’aide du paramètre percentile_value.
RANGE—L’écart entre la plus petite valeur et la plus grande valeur parmi toutes les cellules du raster de valeurs qui appartiennent à la même zone que la cellule en sortie est calculé.
STD—L’écart type de toutes les cellules du raster de valeurs qui appartiennent à la même zone que la cellule en sortie est calculé.
SUM—La valeur totale de toutes les cellules du raster de valeurs qui appartiennent à la même zone que la cellule en sortie est calculée.
VARIETY—Le nombre de valeurs uniques pour toutes les cellules du raster de valeurs qui appartiennent à la même zone que la cellule en sortie est calculé.
|
String
|
|
ignore_nodata
(Facultatif)
|
Indique si les valeurs NoData de la valeur en entrée seront ignorées dans les résultats de la zone dans laquelle elles se trouvent.
DATA—Dans une zone particulière, seules les cellules qui ont une valeur dans le raster de valeurs en entrée seront utilisées pour déterminer la valeur en sortie de cette zone. Les cellules NoData dans le raster de valeurs seront ignorées dans le calcul statistique. Il s’agit de l’option par défaut.
NODATA—Dans une zone particulière, s’il existe des cellules NoData dans le raster de valeurs, elles ne seront pas ignorées et leur existence indique que les informations sont insuffisantes pour exécuter des calculs statistiques pour l’ensemble des cellules de cette zone. Par conséquent, toute la zone reçoit la valeur NoData.
|
Boolean
|
|
process_as_multidimensional
(Facultatif)
|
Spécifie le mode de calcul des rasters en entrée s’il s’agit de rasters multidimensionnels.
ALL_SLICES—Les statistiques sont calculées pour toutes les dimensions du jeu de données multidimensionnelles en entrée.
CURRENT_SLICE—Les statistiques sont calculées à partir de la tranche actuelle du jeu de données multidimensionnelles. Il s’agit de l’option par défaut.
|
Boolean
|
|
percentile_value
(Facultatif)
|
Centile à calculer. La valeur par défaut est de 90, soit le 90e centile.
Les valeurs peuvent varier entre 0 et 100. Le centile n° 0 est équivalent à la statistique minimale tandis que le 100e centile équivaut au maximum Une valeur de 50 donne le même résultat que la statistique médiane.
Ce paramètre est pris en charge uniquement si le paramètre statistics_type est défini sur PERCENTILE.
|
Double
|
|
percentile_interpolation_type
(Facultatif)
|
Définit la méthode d’interpolation à utiliser lorsque la valeur du centile se situe entre deux valeurs de cellule du raster de valeurs en entrée.
AUTO_DETECT—Si le type de pixel du raster de valeurs en entrée est de type entier, la méthode NEAREST est utilisée. Si le type de pixel du raster de valeurs en entrée est de type flottant, la méthode LINEAR est utilisée. Il s’agit de l’option par défaut.
NEAREST—La valeur disponible la plus proche du centile souhaité est utilisée. Dans ce cas, le type de pixel en sortie est identique à celui du raster de valeurs en entrée.
LINEAR—La moyenne pondérée des deux valeurs environnantes du centile souhaité est utilisée. Dans ce cas, le type de pixel en sortie est à virgule flottante.
|
String
|
|
circular_calculation
(Facultatif)
|
Spécifie le mode de traitement du raster en entrée pour les données circulaires.
CIRCULAR—Les statistiques des angles ou autres quantités cycliques, telles que la direction de la boussole en degrés, les journées ou la partie décimale des nombres réels, sont calculées.
ARITHMETIC—Les statistiques linéaires sont calculées. Il s’agit de l’option par défaut.
|
Boolean
|
|
circular_wrap_value
(Facultatif)
|
Valeur à utiliser pour arrondir une valeur linéaire à la plage d’une statistique circulaire donnée. La valeur doit être un entier positif ou un nombre à virgule flottante. La valeur par défaut est 360 degrés.
Ce paramètre est pris en charge uniquement si le paramètre circular_calculation est défini sur CIRCULAR.
|
Double
|
Valeur de retour
|
Nom
|
Explication
|
Type de données
|
|
out_raster
|
Raster de statistiques zonales en sortie.
|
Raster
|
Exemple de code
Exemple 1 d’utilisation de la fonction ZonalStatistics (fenêtre Python)
Cet exemple détermine pour chaque zone la plage de valeurs de cellule dans le raster de valeurs en entrée.
import arcpy
from arcpy import env
from arcpy.ia import *
env.workspace = "C://data"
outZonalStats = ZonalStatistics("zone", "value", "valueraster", "RANGE",
"NODATA")
outZonalStats.save("C:/output/zonestatout")
Exemple 2 d’utilisation de la fonction ZonalStatistics (script autonome)
Cet exemple crée une sortie zonale multidimensionnelle en calculant la valeur maximale du raster de valeurs multidimensionnelle en entrée pour chaque zone.
# Name: ZonalStatistics_Ex_standalone.py
# Description: Summarizes values of a multidimensional raster within the zones
# of another dataset.
# Requirements: Image Analyst extension
# Import system modules
import arcpy
from arcpy.ia import *
# Set the analysis environments
arcpy.env.workspace = "C:/sapyexamples/data"
# Set the local variables
inZoneData = "zones.shp"
zoneField = "sampleID"
inValueRaster = "multidimensional_valueraster.crf"
# Run ZonalStatistics
outZonalStatistics = ZonalStatistics(inZoneData, zoneField, inValueRaster,
"MAXIMUM", "NODATA", "ALL_SLICES")
# Save the output
outZonalStatistics.save("C:/sapyexamples/output/zonestatout2.crf")
