Statistiques zonales (table)—Aide

Disponible avec une licence Spatial Analyst.

Résumé
Illustration
Utilisation
Syntaxe
Exemple de code
Environnements
Informations de licence

Résumé

Récapitule les valeurs d'un raster dans chaque zone d'un autre jeu de données et affiche les résultats dans une table.

Pour en savoir plus sur l'utilisation de la fonction 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 un raster pour la zone en entrée.
Si la taille de cellule est différente de Input raster or feature zone data (Données raster ou vecteur de zones en entrée) (in_zone_data dans Python) et que Input value raster (Raster de valeurs en entrée) (in_value_raster dans Python) est différent, la taille de cellule en sortie correspond au maximum des entrées (option Maximum Of Inputs) et le raster de valeurs en entrée (Input value raster) sera utilisé comme raster de capture en interne. Si la taille de cellule est identique, mais que les cellules ne sont pas alignées, le raster de valeurs en entrée (Input value raster) sert de 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 utiliseront directement l’outil et ne seront pas ré-échantillonnées en interne au cours de l’exécution de l’outil.
Si les données raster ou vecteur de zones en entrée (Input raster or feature zone data) (in_zone_data dans Python) constituent un raster, ils doivent être un raster d’entiers.
Si les données raster ou vecteur de zones en entrée (Input raster or feature zone data) (in_zone_data dans Python) forment 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 raster de valeurs en entrée (option Input value raster) (in_value_raster dans Python).
Si les données raster ou vecteur de zones en entrée (Input raster or feature zone data) (in_zone_data dans Python) est une entité ponctuelle, il est possible d’avoir plusieurs points 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 les données raster ou vecteur de zones en entrée (Input raster or feature zone data) (in_zone_data dans Python) 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 peut avoir 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 les données raster ou vecteur de zones en entrée (Input raster or feature zone data) (in_zone_data dans Python), 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 raster de valeurs en entrée (Input value raster) (in_value_raster dans Python) peut être de type entier ou à virgule flottante. Toutefois, lorsque son type est à virgule flottante, les options de calcul de la majorité, de la médiane, de la minorité et de la variété ne sont pas disponibles.
Pour les calculs de majorité et de minorité, lorsqu’il existe un rattachement, la sortie pour la zone est basée sur la plus faible des valeurs associées. Reportez-vous à la rubrique Fonctionnement de l'outil Statistiques zonales pour plus d'informations.
Un champ ou une série de champs sera créé dans la table en sortie, selon le paramètre Statistics type (Type de statistique). Lorsque la valeur en entrée est un nombre entier, toutes les statistiques (Minimum, Maximum, Plage, Moyenne, Ecart type, Somme, Variété, Majorité, Minorité et Médiane) peuvent être calculées. Si la valeur en entrée est à virgule flottante, les statistiques majorité, minorité, médiane et variété ne sont pas calculées.
Le type de données pour chaque valeur sous les éléments de la table en sortie dépend du calcul zonal qui est effectué. Reportez-vous à la rubrique Fonctionnement de l'outil Statistiques zonales pour connaître le comportement spécifique des statistiques.
Le nombre de lignes dans la table en sortie correspond au nombre de zones.
Par défaut, cet outil tire parti des processeurs à plusieurs cœurs. Le nombre maximal de cœurs pouvant être utilisés est limité à quatre.
Si vous souhaitez que l'outil utilise moins de cœurs, utilisez le paramètre d'environnement 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.

Syntaxe

ZonalStatisticsAsTable (in_zone_data, zone_field, in_value_raster, out_table, {ignore_nodata}, {statistics_type})

Paramètre	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 contenant les valeurs sur lesquelles vous voulez 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 le chemin ne se trouve pas dans une géodatabase, le format est déterminé par l'extension. Si l'extension est .dbf, le format est dBASE. Si aucune extension n'est spécifiée, la sortie sera une table INFO.	Table
ignore_nodata (Facultatif)	Indique si les valeurs NoData de la valeur en entrée influenceront 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, on considère que les informations sont insuffisantes pour exécuter des calculs statistiques pour l'ensemble des cellules de cette zone. Par conséquent, la zone entière recevra la valeur NoData sur le raster en sortie.	Boolean
statistics_type (Facultatif)	Type de statistique à calculer. ALL —Toutes les statistiques sont calculées. Il s’agit de l’option par défaut. MEAN —Calcule la moyenne de toutes les cellules du raster de valeurs qui appartiennent à la même zone que la cellule en sortie. MAJORITY —Détermine 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. MAXIMUM —Détermine la plus grande valeur parmi toutes les cellules du raster de valeurs qui appartiennent à la même zone que la cellule en sortie. MEDIAN —Détermine la valeur médiane de toutes les cellules du raster de valeurs qui appartiennent à la même zone que la cellule en sortie. MINIMUM —Détermine la plus petite valeur parmi toutes les cellules du raster de valeurs qui appartiennent à la même zone que la cellule en sortie. MINORITY —Détermine 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. RANGE —Calcule 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. STD —Calcule l'écart type de toutes les cellules du raster de valeurs qui appartiennent à la même zone que la cellule en sortie. SUM —Calcule la valeur totale de toutes les cellules du raster de valeurs qui appartiennent à la même zone que la cellule en sortie. VARIETY —Calcule le nombre de valeurs uniques pour toutes les cellules du raster de valeurs qui appartiennent à la même zone que la cellule en sortie. MIN_MAX —Les statistiques minimum et maximum sont calculées. MEAN_STD —Les statistiques de moyenne et d’écart type sont toutes les deux calculées. MIN_MAX_MEAN —Les statistiques minimum, maximum et de moyenne sont calculées.	String

Exemple de code

Premier exemple d'utilisation de l'outil ZonalStatisticsAsTable (fenêtre Python)

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")

Deuxième exemple d'utilisation de l'outil ZonalStatisticsAsTable (script autonome)

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 un fichier .dbf.

# Name: ZonalStatisticsAsTable_Ex_02.py
# Description: Summarizes values of a 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 import env
from arcpy.sa import *

# Set environment settings
env.workspace = "C:/sapyexamples/data"

# Set local variables
inZoneData = "zones.shp"
zoneField = "Classes"
inValueRaster = "valueforzone"
outTable = "zonalstattblout02.dbf"


# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

# Execute ZonalStatisticsAsTable
outZSaT = ZonalStatisticsAsTable(inZoneData, zoneField, inValueRaster, 
                                 outTable, "NODATA", "MEAN")

ArcMap

Statistiques zonales (table)