| Étiquette | 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 |
Données raster ou vecteur de classe en entrée | Jeu de données définissant les classes dont les superficies seront récapitulées dans chaque zone. La classe en entrée peut être une couche raster d'entiers ou une couche d'entités. | Raster Layer; Feature Layer |
Champ de classement | Champ contenant les valeurs de classe. Il peut s'agir d'un champ de type entier ou chaîne des données de classes en entrée. | Field |
Table en sortie (Facultatif) | Table en sortie contenant le récapitulatif des superficies de chaque classe dans 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 |
Taille de cellule de traitement (Facultatif) | La taille de cellule du jeu de données raster en sortie sera créée. Ce paramètre peut être défini par une valeur numérique ou obtenu à partir d’un jeu de données raster. Si la taille de cellule n’est pas explicitement spécifiée en tant que valeur de paramètre, la valeur de la taille de cellule de l’environnement sera utilisée dans la mesure où elle est définie. Dans le cas contraire, le calcul fera appel à des règles supplémentaires pour la déterminer à partir d’autres données en entrée. Pour en savoir plus, consultez la section relative à l’utilisation. | Analysis Cell Size |
Classes as rows in output table (Classes en tant que lignes dans la table en sortie) (Facultatif) | Spécifie le mode de représentation des valeurs du raster de classe en entrée dans la table en sortie.
| Boolean |
Disponible avec une licence Spatial Analyst.
Synthèse
Calcule les superficies croisées entre deux jeux de données et génère une table en sortie.
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 l’une des entrées correspond à un raster, ce dernier doit être de type entier.
Si l’un des jeux de données en entrée est une classe d’entités, il est converti au préalable en interne avant que l’analyse ne soit effectuée, à l’aide de la Cell Size (Taille de cellule) et de l’alignement de cellules de l’autre raster en entrée.
Si les deux entrées sont des rasters et que leurs cellules ne sont pas alignées, les entrées seront rééchantillonnées pendant l’analyse. Si l’environnement Raster de capture n’a pas été spécifié de manière explicite, les cellules sont alignées en interne à l’aide des Input raster or feature class data (Données raster ou de classe d'entités en entrée) (in_class_data dans Python). Si les deux rasters ont la même taille de cellule et que les cellules sont alignées, il n’y aura pas de rééchantillonnage.
Si les deux jeux de données en entrée sont des classes d’entités, ils sont convertis en interne en un raster avant que l’analyse ne soit effectuée à l’aide de la Processing Cell Size (Taille de cellule de traitement) (processing_cell_size dans Python) ou à partir de l’environnement d’analyse raster, si ce dernier est spécifié.
Si Input raster or feature zone data (Données raster ou vecteur de zones en entrée) (in_zone_data dans Python) est une entité, pour l’une des entités de zone ne recouvrant aucun centre de cellule du raster de classe, ces zones ne sont pas converties dans le raster de zone 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 Cell Size (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 les entrées contiennent des entités superposées, l’analyse zonale est effectuée pour chaque entité individuelle.
Si des données ponctuelles ou linéaires sont utilisées comme classe d’entités en entrée, la surface intersectée par ces entités est consignée.
Lorsque vous spécifiez les données de zone ou de classe en entrée, le champ par défaut est le premier champ d’entier ou de texte disponible. S’il n’existe aucun autre champ valide, le champ ObjectID (par exemple, OID ou FID) est utilisé par défaut.
La Processing cell size (Taille de cellule de traitement) peut être définie par une valeur numérique ou obtenue à 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, elle est dérivée de l’environnement Cell Size (Taille de cellule), s’il est 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, la taille de cellule du jeu de données est utilisée.
- Si le jeu de données en entrée est une entité en entrée et si l’environnement Snap Raster (Raster de capture) est défini, la taille de cellule du raster de capture est utilisée. Si aucun raster de capture n’est défini, la taille de cellule résulte de la division par 250 de la largeur ou de la hauteur la plus petite (parmi les deux) de l’étendue spécifiée dans le système de coordonnées en sortie de 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 identique à la référence spatiale en sortie. Si la référence spatiale du jeu de données diffère de la référence spatiale en sortie, elle sera projetée d’après la valeur du champ Cell Size Projection Method (Méthode de projection de la taille de cellule).
Le paramètre Classes as rows in output table (Classes en tant que lignes dans la table en sortie) (classes_as_rows dans Python) vous permet de sélectionner le type de structure de table en sortie. Cochez ce paramètre (CLASSES_AS_ROWS dans Python) pour représenter les lignes des classes ou désélectionnez-le (CLASSES_AS_FIELDS dans Python) pour représenter les classes comme champs.
Si les classes sont représentées dans des lignes, la sortie de la table peut être associée et interrogée pour extraire les informations sur les zones par rasters de zone ou de classe.
La sortie de cet outil est une table.
Dans cette table, si le paramètre Classes as rows in output table (Classes en tant que lignes dans la table en sortie) est désélectionné (CLASSES_AS_FIELDS dans Python), les conditions suivantes sont remplies :
- Il y aura un enregistrement pour chaque valeur unique du jeu de données de zone.
- Il y aura un champ pour chaque valeur unique du jeu de données de classe.
- Chaque enregistrement stockera la surface de chaque classe dans chaque zone.
Si le paramètre Classes as rows in output table (Classes en tant que lignes dans la table en sortie) est coché (CLASSES_AS_ROWS dans Python), les conditions suivantes sont remplies :
- Il existe un enregistrement pour chaque valeur unique du jeu de données de zone qui possède une valeur unique du jeu de données de classe.
- Des champs individuels identifient le champ de zone, le champ de classe, le nombre et la superficie de chaque classe dans chaque zone.
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
TabulateArea(in_zone_data, zone_field, in_class_data, class_field, {out_table}, {processing_cell_size}, {classes_as_rows})| 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_class_data | Jeu de données définissant les classes dont les superficies seront récapitulées dans chaque zone. La classe en entrée peut être une couche raster d'entiers ou une couche d'entités. | Raster Layer; Feature Layer |
class_field | Champ contenant les valeurs de classe. Il peut s'agir d'un champ de type entier ou chaîne des données de classes en entrée. | Field |
out_table (Facultatif) | Table en sortie contenant le récapitulatif des superficies de chaque classe dans 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 |
processing_cell_size (Facultatif) | La taille de cellule du jeu de données raster en sortie sera créée. Ce paramètre peut être défini par une valeur numérique ou obtenu à partir d’un jeu de données raster. Si la taille de cellule n’est pas explicitement spécifiée en tant que valeur de paramètre, la valeur de la taille de cellule de l’environnement sera utilisée dans la mesure où elle est définie. Dans le cas contraire, le calcul fera appel à des règles supplémentaires pour la déterminer à partir d’autres données en entrée. Pour en savoir plus, consultez la section relative à l’utilisation. | Analysis Cell Size |
classes_as_rows (Facultatif) | Spécifie le mode de représentation des valeurs du raster de classe en entrée dans la table en sortie.
| Boolean |
Exemple de code
Cet exemple retourne une table avec la surface de chaque valeur de classe contenue dans chaque zone.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
TabulateArea("zonedata.shp", "IDStr", "valueraster", "VALUE",
"C:/sapyexamples/output/areatable.dbf", 2)Cet exemple retourne une table avec la surface de chaque valeur de classe contenue dans chaque zone.
# Name: TabulateArea_Ex_02.py
# Description: Calculates cross tabulated areas between two datasets.
# 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"
env.extent = "classgrid"
env.snapRaster = "classgrid"
# Set local variables
inZoneData = "zonedata.shp"
zoneField = "IDStr"
inClassData = "valueraster"
classField = "VALUE"
outTable = "C:/sapyexamples/output/areatable02.dbf"
processingCellSize = 2
# Execute TabulateArea
TabulateArea(inZoneData, zoneField, inClassData, classField, outTable,
processingCellSize)Environnements
Cas particuliers
Informations de licence
- Basic: Nécessite Spatial Analyst
- Standard: Nécessite Spatial Analyst
- Advanced: Nécessite Spatial Analyst
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?