Croiser les superficies (Spatial Analyst)

Synthèse

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

Illustration

Illustration de l’outil Croiser les superficies
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 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 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 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 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.

  • 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. Cochez ce paramètre (CLASSES_AS_ROWS en Python) pour représenter les lignes des classes ou décochez-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 coché (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 coché (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.

  • 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

ÉtiquetteExplicationType 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.

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 dans un espace de travail de géodatabase, et une table dBASE 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.

  • Désactivé : les classes sont représentées en tant que champs. Il s’agit de l’option par défaut.
  • Activé : les classes sont représentées en tant que lignes.
Boolean

TabulateArea(in_zone_data, zone_field, in_class_data, class_field, {out_table}, {processing_cell_size}, {classes_as_rows})
NomExplicationType 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.

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 dans un espace de travail de géodatabase, et une table dBASE 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_FIELDSLes classes sont représentées en tant que champs. Il s’agit de l’option par défaut.
  • CLASSES_AS_ROWSLes classes sont représentées en tant que lignes.
Boolean

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)
Exemple 2 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

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

Rubriques connexes