Étiquette | Explication | Type de données |
Données de raster ou de 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 |
Table en sortie | Table en sortie récapitulant les valeurs de chaque zone. Le format de la table est déterminé par l'emplacement et le chemin d'accès en sortie. Par défaut, la sortie sera une table de géodatabase si elle se trouve dans un espace de travail Géodatabase, et une table dBASE si elle se trouve dans un espace de travail de fichier. | Table |
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.
| Boolean |
Type de statistique (Facultatif) | Spécifie le type de statistique à calculer.
| String |
Process as Multidimensional (Traiter comme multidimensionnel) (Facultatif) | Spécifie le mode de calcul des rasters en entrée s’il s’agit de rasters multidimensionnels.
| Boolean |
Valeurs de 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 n’est disponible que si le paramètre Statistics type (Type de statistique) est défini sur Percentile (Centile) ou All (Tout). | Double |
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.
| String |
Calculer les statistiques circulaires (Facultatif) | Spécifie le mode de traitement du raster en entrée pour les données circulaires.
| 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. Cette valeur doit être un entier positif ou un nombre à virgule flottante. La valeur par défaut est 360 degrés. Ce paramètre n’est pris en charge que si le paramètre Calculate Circular Statistics (Calculer les statistiques circulaires) est sélectionné. | Double |
Couche de jointure en sortie (Facultatif) | Couche en sortie qui est créée en associant la table en sortie aux données de zone en entrée. | Raster Layer; Feature Layer |
Synthèse
Récapitule les valeurs d’un raster dans chaque zone d’un autre jeu de données et affiche les résultats sous forme de table.
En savoir plus sur le fonctionnement des outils de statistiques zonales
Illustration

Utilisation
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 Input Raster or Feature Zone Data (Données raster ou vecteur de zones en entrée) (in_zone_data dans Python) constitue un raster, elle doit être un raster d’entiers.
Si la valeur Input Raster or Feature Zone Data (Données raster ou vecteur de zones en entrée) forme une entité, ces données sont converties en raster en interne, à l’aide de la taille de cellule et de 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 la cellule ou l’alignement de la cellule 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 et raster de capture en interne. L’une de ces cases déclenche 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 les données Input Raster or Feature Zone Data (Données raster ou vecteur de zones en entrée) sont 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 cela 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).
S'il existe des entités superposées pour Données de raster ou de vecteur de zones en entrée, l’analyse zonale est effectuée pour chaque entité individuelle.
Lorsque vous spécifiez la valeur Input Raster or Feature Zone Data (Données raster ou vecteur de zones en entrée), le champ de zone par défaut est le premier champ 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 de majorité), Maximum, Median (Médiane), Minimum, Minority (Minorité), Minority count (Nombre minoritaire), Minority percentage (Pourcentage de minorité), 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 la majorité et de la minorité, lorsqu’il existe une association, la sortie est la plus faible des valeurs associées.
Pour calculer les statistiques circulaires, cochez le paramètre Calculate Circular Statistics (Calculer les statistiques circulaires) (circular_calculation = "CIRCULAR" dans Python) et définissez 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 de Esri.
Un champ ou une série de champs est créé dans la table en sortie en fonction de la valeur du paramètre Type de statistique (statisticType dans Python).
Le nom de ce champ correspond à celui du Type de statistique pour le calcul des statistiques arithmétiques. Il s’agit de l’option par défaut.
Toutefois, pour les statistiques circulaires, le nom de ce champ est composé de C_, suivi de la statistique spécifiée. Par exemple, le nom de ce champ est Median pour la statistique arithmétique médiane et C_Median pour la statistique circulaire médiane.
Le type de données de chaque valeur des éléments de la table en sortie dépend du calcul zonal effectué. Reportez-vous à la rubrique Fonctionnement de l’outil Statistiques zonales pour connaître le comportement spécifique d’une statistique.
Le nombre de lignes dans la table en sortie correspond au nombre de zones.
Par défaut, cet outil utilise des processeurs à plusieurs cœurs. Le nombre maximal de cœurs pouvant être utilisés s’élève à quatre.
Pour utiliser moins de cœurs, utilisez le paramètre d’environnement Parallel Processing Factor (Facteur de traitement parallèle).
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
ZonalStatisticsAsTable(in_zone_data, zone_field, in_value_raster, out_table, {ignore_nodata}, {statistics_type}, {process_as_multidimensional}, {percentile_values}, {percentile_interpolation_type}, {circular_calculation}, {circular_wrap_value}, {out_join_layer})
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 |
out_table | Table en sortie récapitulant les valeurs de chaque zone. Le format de la table est déterminé par l'emplacement et le chemin d'accès en sortie. Par défaut, la sortie sera une table de géodatabase si elle se trouve dans un espace de travail Géodatabase, et une table dBASE si elle se trouve dans un espace de travail de fichier. | Table |
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.
| Boolean |
statistics_type (Facultatif) | Spécifie le type de statistique à calculer.
| String |
process_as_multidimensional (Facultatif) | Spécifie le mode de calcul des rasters en entrée s’il s’agit de rasters multidimensionnels.
| Boolean |
percentile_values [percentile_values,...] (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 n’est pris en charge que si le paramètre statistics_type est défini sur PERCENTILE ou ALL. | 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.
| String |
circular_calculation (Facultatif) | Spécifie le mode de traitement du raster en entrée pour les données circulaires.
| Boolean |
circular_wrap_value (Facultatif) | Valeur à utiliser pour arrondir une valeur linéaire à la plage d’une statistique circulaire donnée. Cette valeur doit être un entier positif ou un nombre à virgule flottante. La valeur par défaut est 360 degrés. Ce paramètre n’est pris en charge que si le paramètre circular_calculation est défini sur CIRCULAR. | Double |
out_join_layer (Facultatif) | Couche en sortie qui est créée en associant la table en sortie aux données de zone en entrée. | Raster Layer; Feature Layer |
Exemple de code
Cet exemple récapitule les valeurs d'un raster dans les zones définies par un fichier de formes surfaciques et enregistre les résultats dans une table.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outZSaT = ZonalStatisticsAsTable("zones.shp", "Classes", "valueforzone",
"zonalstattblout", "NODATA", "SUM")
Cet exemple récapitule les valeurs d'un raster dans les zones définies par un fichier de formes surfaciques et enregistre les résultats dans une table.
# Name: ZonalStatisticsAsTable_Ex_standalone.py
# Description: Summarizes values of a multidimensional raster within the zones
# of another dataset and reports the results to a table.
# Requirements: Spatial Analyst Extension
# Import system modules
import arcpy
from arcpy.sa import *
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Set the analysis environments
arcpy.env.workspace = "C:/sapyexamples/data"
# Set the local variables
inZoneData = "zones.shp"
zoneField = "sampleID"
inValueRaster = "multidimensional_valueraster.crf"
outTable = "zonalstattblout02.dbf"
# Execute ZonalStatisticsAsTable
outZSaT = ZonalStatisticsAsTable(inZoneData, zoneField, inValueRaster,
outTable, "NODATA", "MAXIMUM", "ALL_SLICES")
Cet exemple récapitule les valeurs d'un raster dans les zones définies par un fichier de formes surfaciques et enregistre les résultats dans une table.
import arcpy
from arcpy import env
from arcpy.ia import *
env.workspace = "C:/sapyexamples/data"
outZSaT = ZonalStatisticsAsTable("zones.shp", "Classes", "valueforzone",
"zonalstattblout", "NODATA", "SUM")
Cet exemple récapitule les valeurs d'un raster dans les zones définies par un fichier de formes surfaciques et enregistre les résultats dans une table.
# Name: ZonalStatisticsAsTable_Ex_standalone.py
# Description: Summarizes values of a multidimensional raster within the zones
# of another dataset and reports the results to a table.
# Requirements: Image Analyst Extension
# Import system modules
import arcpy
from arcpy.ia import *
# Check out the ArcGIS Image Analyst extension license
arcpy.CheckOutExtension("ImageAnalyst")
# Set the analysis environments
arcpy.env.workspace = "C:/sapyexamples/data"
# Set the local variables
inZoneData = "zones.shp"
zoneField = "sampleID"
inValueRaster = "multidimensional_valueraster.crf"
outTable = "zonalstattblout02.dbf"
# Execute ZonalStatisticsAsTable
outZSaT = ZonalStatisticsAsTable(inZoneData, zoneField, inValueRaster,
outTable, "NODATA", "MAXIMUM", "ALL_SLICES")
Environnements
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?