| Étiquette | Explication | Type de données |
Données raster ou vecteur de zones en entrée | Jeu de données qui définit 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. Ce doit être un champ de type entier du jeu de données de zones. | Field |
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 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 fournie, la sortie est une table INFO. Les tables INFO ne sont pas prises en charge en tant qu’entrée dans ArcGIS AllSource et ne peuvent pas être affichées. | Table |
Taille de cellule de traitement (Facultatif) |
Taille de cellule du raster en sortie à créer. Ce paramètre peut être défini par une valeur numérique ou obtenu à partir d’un jeu de données raster existant. Si la taille de cellule n’est pas explicitement spécifiée en tant que valeur de paramètre, la valeur de taille de cellule de l’environnement est utilisée si elle est spécifiée. Sinon, des règles supplémentaires sont utilisées pour la calculer à partir des autres entrées. Consultez la section Utilisation pour en savoir plus. | Analysis Cell Size |
Synthèse
Calcule les mesures géométriques (surface, périmètre, épaisseur et caractéristiques d’une ellipse) pour chaque zone d’un jeu de données et consigne les résultats dans une table.
Pour en savoir plus sur l'utilisation de la fonction Géométrie zonale
Illustration
VALUE AREA PERIMETER THICKNESS XCENTROID YCENTROID MAJORAXIS MINORAXIS ORIENTATION 0 5.0 14.0 0.5 2.300 2.100 2.338 0.681 60.714 1 5.0 14.0 0.5 1.900 2.100 2.668 0.596 126.061 2 3.0 8.0 0.5 3.167 2.167 1.286 0.743 135.000 4 2.0 6.0 0.5 0.500 1.000 1.128 0.564 90.000
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.
Le paramètre Taille de cellule de traitement peut être défini par une valeur numérique ou obtenu à partir d’un jeu de données raster existant. Si la taille de cellule n’a pas été spécifiée de manière explicite comme étant la valeur du paramètre, elle est dérivée de l’environnement de taille de cellule si celui-ci a été spécifié. Si la taille de cellule du paramètre ou la taille de cellule de l’environnement n’a pas été spécifiée, la taille de cellule en sortie par défaut est déterminée en fonction du type de jeu de données en entrée de la façon suivante :
- Si le jeu de données en entrée est un raster, c’est la taille de cellule du jeu de données qui est utilisée.
- Si le jeu de données en entrée est une entité et que l’environnement de raster de capture a été défini, c’est la taille de cellule du raster de capture qui est utilisée. Si aucun raster de capture n’a été défini, la taille de cellule est calculée à partir de la valeur la plus faible entre la largeur et la hauteur de l’étendue divisée par 250, où l’étendue se trouve dans le système de coordonnées en sortie spécifié dans l’environnement.
Si la taille de cellule est spécifiée à l’aide d’une valeur numérique, l’outil l’utilise directement pour le raster en sortie.
Si la taille de cellule est spécifiée à l’aide d’un jeu de données raster, le paramètre affiche le chemin du jeu de données raster au lieu de la valeur de la taille de cellule. La taille de cellule de ce jeu de données raster sera utilisée directement dans l’analyse, à condition que la référence spatiale du jeu de données soit la même que la référence spatiale en sortie. Si la référence spatiale du jeu de données est différente de la référence spatiale en sortie, elle sera projetée en fonction de la valeur Cell Size Projection Method (Méthode de projection de la taille de cellule) spécifiée.
Les calculs pour chaque zone sont enregistrés dans la table en sortie.
Si la valeur Données raster ou 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 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 la valeur 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.
Dans la table en sortie, le champ de valeur précède toujours les champs qui contiennent les calculs zonaux en sortie. Le champ de valeur contient les valeurs des zones définies par le jeu de données de zone.
Les valeurs pour les calculs zonaux sont à virgule flottante.
Tous les résultats dans la table en sortie sont présentés en unités cartographiques, à l’exception de l’élément ORIENTATION, qui est exprimé en degrés dans une plage allant de 0 à 180. L'orientation est définie sous forme d'un angle entre l'axe des x et le grand axe de l'ellipse. Les valeurs de l'angle d'orientation augmentent dans le sens antihoraire, en commençant par 0 à l'est (horizontal, à droite) et vont jusqu'à 90 lorsque le grand axe est vertical.
Si une zone particulière se compose d'une seule cellule ou d'un seul bloc carré de cellules, l'orientation de l'ellipse (qui est un cercle dans ce cas) est définie sur 90 degrés.
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
ZonalGeometryAsTable(in_zone_data, zone_field, out_table, {processing_cell_size})| Nom | Explication | Type de données |
in_zone_data | Jeu de données qui définit 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. Ce doit être un champ de type entier du jeu de données de zones. | Field |
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 fournie, la sortie est une table INFO. Les tables INFO ne sont pas prises en charge en tant qu’entrée dans ArcGIS AllSource et ne peuvent pas être affichées. | Table |
processing_cell_size (Facultatif) |
Taille de cellule du raster en sortie à créer. Ce paramètre peut être défini par une valeur numérique ou obtenu à partir d’un jeu de données raster existant. Si la taille de cellule n’est pas explicitement spécifiée en tant que valeur de paramètre, la valeur de taille de cellule de l’environnement est utilisée si elle est spécifiée. Sinon, des règles supplémentaires sont utilisées pour la calculer à partir des autres entrées. Consultez la section Utilisation pour en savoir plus. | Analysis Cell Size |
Exemple de code
Cet exemple détermine les mesures de géométrie pour chaque zone définie par le fichier de formes surfaciques en entrée.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outZonalGeometryAsTable = ZonalGeometryAsTable("zones.shp", "Classes", "zonalgeomout", 0.2)Cet exemple détermine les mesures de géométrie pour chaque zone définie par le fichier de formes surfaciques en entrée.
# Name: ZonalGeometryAsTable_Ex_02.py
# Description:Calculates for each zone in a dataset the specified geometry
# measure (area, perimeter, thickness, or the characteristics
# of ellipse) and reports the results as 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"
outTable = "zonalgeomout02.dbf"
processingCellSize = 0.2
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute ZonalGeometryAsTable
outZonalGeometryAsTable = ZonalGeometryAsTable(inZoneData, zoneField, outTable, processingCellSize)Environnements
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?