Groupes par régions (Spatial Analyst)

Niveau de licence :BasicStandardAdvanced

Récapitulatif

Pour chaque cellule en sortie, l'identité de la région connectée à laquelle appartient la cellule est enregistrée. Un numéro unique est attribué à chaque région.

Pour en savoir plus sur la création de zones individuelles à l'aide de l'outil Groupes par régions

Illustration

Illustration de l'outil Groupes par régions
OutRas = RegionGroup (InRas1)

Utilisation

Syntaxe

RegionGroup (in_raster, {number_neighbors}, {zone_connectivity}, {add_link}, {excluded_value})
ParamètreExplicationType de données
in_raster

Raster en entrée dont les régions connectées uniques seront identifiées.

Il doit être de type entier.

Raster Layer
number_neighbors
(Facultatif)

Nombre de cellules voisines à utiliser afin d'évaluer la connectivité entre les cellules.

  • FOUR Définit la connectivité entre les cellules d'une même valeur uniquement si elles se trouvent directement à gauche, à droite, au-dessus ou en dessous des quatre voisins les plus proches. Si deux cellules de même valeur forment une diagonale, elles ne sont pas considérées comme étant connectées.
  • EIGHT Définit la connectivité entre des cellules de même valeur si elles se trouvent dans le voisinage immédiat de huit cellules (les huit voisins les plus proches). Elles peuvent se situer à droite, à gauche, au-dessus ou en diagonale.
String
zone_connectivity
(Facultatif)

Définit les valeurs de cellules qui doivent être prises en compte dans le cadre des tests de connectivité.

  • WITHIN Teste la connectivité entre des valeurs identiques en entrée au sein de la même zone.Les seules cellules qui peuvent être regroupées sont des cellules de la même zone (valeur) et qui répondent aux exigences spatiales de connectivité spécifiées par les mots-clés FOUR et EIGHT.
  • CROSS Teste la connectivité sur la base des exigences spatiales spécifiées par les mots clés FOUR ou EIGHT entre les cellules dotées de valeurs quelconques, à l'exception de la valeur identifiée à exclure.Lorsque CROSS est utilisé, une valeur doit être fournie pour l'argument {excluded_value}.
String
add_link
(Facultatif)

Spécifie si un champ LINK est ajouté à la table du résultat en sortie.

  • ADD_LINK Un élément ADD_LINK sera ajouté à la table du raster en sortie. Pour chaque zone nouvellement créée, cet élément stocke les valeurs originales des régions déconnectées ou du raster en entrée, avant qu'elles ne soient regroupées. Il s'agit de l'option par défaut.
  • NO_LINK La table attributaire du raster en sortie contiendra uniquement les éléments Valeur et Total.
Boolean
excluded_value
(Facultatif)

Identifie une valeur telle que si un emplacement de cellule contient cette valeur, aucune connectivité spatiale ne pourra être évaluée, quel que soit le nombre de voisin spécifié (FOUR ou EIGHT).

Les cellules dotées de la valeur exclue sont traitées en NoData et sont éliminées de tout calcul. Dans le raster en sortie, la valeur zéro est attribuée aux emplacements de cellule qui contiennent la valeur exclue.

La logique de valeur exclue est similaire à celle de valeur d'arrière-plan ou revient à définir un masque dans l'environnement pour une exécution unique de l'outil. Une valeur doit être spécifiée pour ce paramètre, si vous spécifiez le mot-clé CROSS.

Long

Valeur renvoyée

NomExplicationType de données
out_raster

Raster en sortie de l'outil Groupes par régions.

Le raster en sortie est toujours un entier.

Raster

Exemple de code

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

Cet exemple affecte un numéro unique à chaque région du raster en entrée à l'aide de la connectivité de type huit voisins.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outRgnGrp = RegionGroup("land", "EIGHT", "", "", 5)
outRgnGrp.save("c:/sapyexamples/output/reggrp_ex5")
Exemple 2 d'utilisation de l'outil RegionGroup (script autonome)

Cet exemple affecte un numéro unique à chaque région du raster en entrée à l'aide de la connectivité de type huit voisins, avec une valeur exclue.

# Name: RegionGroup_Ex_02.py
# Description: Records, for each cell in the output, the
#              identity of the connected region to which 
#              it belongs within the Analysis window. A 
#              unique number is assigned to each region.
# 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
inRaster = "land"
valToIgnore = 5

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

# Execute RegionGroup
outRegionGrp = RegionGroup(inRaster, "EIGHT", "CROSS", 
                           "NO_LINK", valToIgnore)

# Save the output 
outRegionGrp.save("C:/sapyexamples/output/reggrpout")

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
5/10/2014