Croiser les superficies

Disponible avec une licence Spatial Analyst.

Résumé

Calcule les superficies croisées entre deux jeux de données et génère une table en sortie.

Illustration

TabulateArea(ZoneRas, "VALUE", ClassRas, "VALUE", Tabarea1.dbf, 1)

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 jeux de données raster et de classes d'entités pour la zone en entrée.

• Lorsque les classes et les zones en entrée sont deux rasters de même résolution, elles sont utilisées directement.

  Si les résolutions sont différentes, un rééchantillonnage interne est appliqué pour les faire correspondre avant que l'opération zonale soit effectuée.

• Si la zone en entrée est un jeu de données raster, elle doit comporter une table attributaire. La table attributaire est généralement créée automatiquement pour les rasters d'entiers, mais peut ne pas l'être dans certaines circonstances. Vous pouvez utiliser l'outil Créer la table attributaire d'un raster pour en créer une.

• Si la zone en entrée est jeu de données d'entité, une conversion vecteur/raster lui sera appliquée en interne.

  Pour garantir que les résultats de la conversion s'aligneront correctement avec un raster de classes en entrée, il est recommandé de vérifier que l'étendue et le raster de capture sont définis convenablement dans les paramètres d'environnement et dans les paramètres de raster.

• Lorsque vous spécifiez les données de zone ou de classe en entrée, le champ par défaut est le premier champ valide disponible. S'il n'existe aucun autre champ valide, le champ IdObjet (par exemple, OID ou FID) est utilisé par défaut.

• Si un champ réservé (par exemple, OBJECTID, FID ou OID) est sélectionné pour le champ de zone, cela peut causer une certaine ambiguïté dans le résultat. Le résultat inclut le nom du champ réservé particulier nécessaire pour le type de format en sortie particulier, ainsi que le champ de zone spécifié. Si le champ spécifié a le même nom que le champ réservé pour le format en sortie particulier, le nom du champ de zone dans la sortie est modifié de façon à ce que tous les noms de champs dans le résultat soient uniques.

  Remarque :

  Pour créer un champ de valeurs uniques qui n'a pas de nom réservé, utilisez les outils de géotraitement Ajouter un champ et Calculer un champ.

• Si la classe en entrée est un jeu de données d'entité, une conversion vecteur/raster lui sera également appliquée en interne. Les conditions répertoriées dans l'astuce précédente pour une zone d'entités en entrée s'appliquent également à une classe d'entités en entrée.

• Il est recommandé en général d'utiliser uniquement des rasters en tant que classes et zones en entrée. Si vos entrées sont des entités, envisagez de commencer par les convertir en rasters à l'aide des outils de conversion Vers raster. Cela vous offre un plus grand contrôle sur la conversion vecteur/raster et contribue à vous garantir d'obtenir systématiquement les résultats attendus.

• Si un jeu de données ponctuelles ou linéaires est utilisé en tant que données de classe, la surface intersectée par ces entités est consignée.

• La sortie de l'outil Croiser les superficies est une table.

  Dans cette table :

  • 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.

• Reportez-vous à la rubrique Utilisation de l'outil Croiser les superficies pour obtenir des explications concernant certains problèmes qui peuvent se poser avec cet outil, ainsi que des suggestions sur la manière d'y remédier.

• 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

TabulateArea (in_zone_data, zone_field, in_class_data, class_field, out_table, {processing_cell_size})

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_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	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 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
processing_cell_size (Facultatif)	Taille de cellule de traitement pour l'opération zonale. Il s'agit de la valeur contenue dans l'environnement, si spécifiquement définie. Si l'environnement n'est pas défini, la valeur par défaut de la taille de cellule est déterminée par le type des données de zone, comme suit : Si le jeu de données de zones est un raster, la taille de cellule correspond à celle du raster de zones. Si le jeu de données de zones est une entité, la taille de cellule correspond à la valeur la plus faible entre la largeur et la hauteur de l'étendue du jeu de classes d'entités zones dans la référence spatiale en sortie, divisée par 250.	Analysis Cell Size

Exemple de code

Exemple 1 d'utilisation de l'outil TabulateArea (fenêtre Python)

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)

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

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

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

# Execute TabulateArea
TabulateArea(inZoneData, zoneField, inClassData, classField, outTable,
             processingCellSize)

Environnements

• Validation automatique
• Taille de cellule
• Compression
• Espace de travail courant
• Etendue
• Transformations géographiques
• Masque
• Mot-clé de configuration en sortie
• Système de coordonnées en sortie
• Noms de champ qualifiés
• Espace de travail temporaire
• Raster de capture
• Taille de tuile
• Transférer les descriptions des domaines de champs

Informations de licence

• ArcGIS Desktop Basic: Requiert Spatial Analyst
• ArcGIS Desktop Standard: Requiert Spatial Analyst
• ArcGIS Desktop Advanced: Requiert Spatial Analyst