Géométrie zonale (Spatial Analyst)

Niveau de licence :De baseStandardAvancé

Récapitulatif

Calcule, pour chaque zone d'un jeu de données la mesure géométrique spécifiée (superficie, périmètre, épaisseur ou caractéristiques de l'ellipse).

Pour en savoir plus sur l'utilisation de la fonction Géométrie zonale

Illustration

Illustration de l'outil Géométrie zonale
OutRas = ZonalGeometry(InRas1,"VALUE","AREA")

Utilisation

Syntaxe

ZonalGeometry (in_zone_data, zone_field, {geometry_type}, {cell_size})
ParamètreExplicationType 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.

Ce doit être un champ de type entier du jeu de données de zones.

Field
geometry_type
(Facultatif)

Type de géométrie à calculer.

  • AREA Superficie de chaque zone.
  • PERIMETER Périmètre de chaque zone.
  • THICKNESS Point le plus profond (ou épais) à l'intérieur de la zone par rapport aux cellules environnantes.
  • CENTROID Détermine les centroïdes de chaque zone.
String
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

Valeur renvoyée

NomExplicationType de données
out_raster

Raster de géométrie zonale en sortie.

Raster

Exemple de code

Premier exemple d'utilisation de l'outil ZonalGeometry (fenêtre Python)

Cet exemple détermine la surface 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"
outZonalGeometry = ZonalGeometry("zones.shp", "Classes", "AREA", 0.2)
outZonalGeometry.save("C:/sapyexamples/output/zonegeomout3")
Deuxième exemple d'utilisation de l'outil ZonalGeometry (script autonome)

Cet exemple détermine la surface pour chaque zone définie par le fichier de formes surfaciques en entrée.

# Name: ZonalGeometry_Ex_02.py
# Description:Calculates for each zone in a dataset the specified geometry 
#   measure (area, perimeter, thickness, or the characteristics 
#   of ellipse).
# 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"
cellSize = 0.2

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

# Execute ZonalStatistics
outZonalGeometry = ZonalGeometry(inZoneData, zoneField, "AREA", cellSize)  

# Save the output 
outZonalGeometry.save("C:/sapyexamples/output/zonegeomout2")

Environnements

Thèmes connexes

Informations de licence

ArcGIS for Desktop Basic : Requis ArcGIS Spatial Analyst
ArcGIS for Desktop Standard : Requis ArcGIS Spatial Analyst
ArcGIS for Desktop Advanced : Requis ArcGIS Spatial Analyst
9/13/2013