Croiser les superficies (Outils Spatial Analyst)

Résumé

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 des rasters pour la zone en entrée.
Si l’une des entrées est un raster, son type de données doit être entier.
Si l’un des jeux de données en entrée est une classe d’entités, il est converti en interne en raster avant l’exécution de l’analyse, à l’aide du paramètre 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 sont rééchantillonnées lors de l’analyse. Si l’environnement Snap Raster (Raster de capture) n’a pas été spécifié explicitement, les cellules sont alignées en interne à l’aide du paramètre Input raster or feature class data (Données de classe d’entités ou raster en entrée) (in_class_data en Python). Si les deux rasters ont la même taille de cellule et que les cellules sont alignées, aucun rééchantillonnage n’est effectué.
Si les deux jeux de données en entrée sont des classes d’entités, ils sont convertis en interne en raster avant l’exécution de l’analyse à l’aide du paramètre Processing Cell Size (Taille de cellule de traitement) (processing_cell_size en Python) ou à partir de l’environnement d’analyse raster, le cas échéant.
Si le paramètre Input raster or feature zone data (Données raster ou vecteur de zones en entrée) (in_zone_data en Python) est une entité, pour n’importe quelle entité de zone qui ne chevauche aucun centre de cellule du raster de classe, 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 remédier à ce problème en déterminant une valeur appropriée pour l’environnement Cell Size (Taille de cellule) permettant de conserver le niveau de détail souhaité des zones d’entités, et en le spécifiant 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 en tant que 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 entier ou champ de texte disponible. S’il n’existe aucun autre champ valide, le champ ObjectID (par exemple, OID ou FID) est utilisé par défaut.
Le paramètre Processing Cell Size (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’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 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 est projetée en fonction de la valeur Cell Size Projection Method (Méthode de projection de la taille de cellule) spécifiée.
Le paramètre Classes as rows in output table (Classes en tant que lignes dans la table en sortie) (classes_as_rows en Python) permet de sélectionner le type de structure de table en sortie. Activez ce paramètre (CLASSES_AS_ROWS en Python) pour représenter les lignes des classes ou désactivez-le (CLASSES_AS_FIELDS en Python) pour représenter les classes sous forme de champs.

Lorsque des classes sont représentées sous forme de lignes, la table en sortie peut être associée et interrogée pour extraire des informations sur la superficie par rasters de classes ou de zones.
La sortie de cet outil est une table.

Dans cette table, lorsque le paramètre Classes as rows in output table (Classes en tant que lignes dans la table en sortie) n’est pas activé (CLASSES_AS_FIELDS en Python), les éléments suivants sont vrais :
- 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.
Lorsque le paramètre Classes as rows in output table (Classes en tant que lignes dans la table en sortie) est activé (CLASSES_AS_ROWS en Python), les éléments suivants sont vrais :
- Il y aura un enregistrement pour chaque valeur unique du jeu de données de zone comportant une valeur unique du jeu de données de classe.
- Il y aura des champs individuels qui identifient le champ de zone, le champ de classement, le nombre et la surface de chaque classe dans chaque zone.
Reportez-vous à la rubrique Environnements d’analyse et Spatial Analyst pour plus d’informations sur les environnements de géotraitement qui s’appliquent à cet outil.

Etiqueter	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	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)	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
Classes en tant que lignes dans la table en sortie (Facultatif)	Spécifie la façon dont les valeurs du raster de classes en entrée seront représentées dans la table en sortie. Activé—Les classes sont représentées en tant que lignes. Décoché—Les classes sont représentées en tant que champs. Il s’agit de l’option par défaut.	Boolean

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	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)	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
classes_as_rows (Facultatif)	Spécifie la façon dont les valeurs du raster de classes en entrée seront représentées dans la table en sortie. `CLASSES_AS_ROWS`—Les classes sont représentées en tant que lignes. `CLASSES_AS_FIELDS`—Les classes sont représentées en tant que champs. Il s’agit de l’option par défaut.	Boolean

Exemple de code

TabulateArea Exemple 1 (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)

TabulateArea Exemple 2 (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

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

Environnements

Validation automatique, Taille de cellule, Cell Size Projection Method (Méthode de projection de la taille de cellule), Compression, Espace de travail courant, Etendue, Transformations géographiques, Masque, Mot-clé CONFIG en sortie, Système de coordonnées en sortie, Gérer les noms de champs complets, Espace de travail temporaire, Raster de capture, Taille de tuile, Transférer les descriptions des domaines de champs

Informations de licence

Basic: Nécessite Spatial Analyst
Standard: Nécessite Spatial Analyst
Advanced: Nécessite Spatial Analyst