Groupes par régions (Spatial Analyst)

Disponible avec une licence Spatial Analyst.

Résumé

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, FOUR, WITHIN, #, #)

Utilisation

  • En général, la première région analysée reçoit la valeur un, la deuxième région, la valeur deux, etc., jusqu'à ce qu'une valeur soit affectée à toutes les régions. Le balayage s'effectue de gauche à droite, de haut en bas. Les valeurs affectées aux zones en sortie dépendent du moment où elles sont détectées par le processus d'analyse.

  • Deux paramètres contrôlent de quelle façon est établie la connectivité entre les régions. Le paramètre Number of neighbors to use (Nombre de voisins à utiliser) détermine la géométrie de la connectivité, soit comme uniquement orthogonale (quatre directions), soit comme diagonale et orthogonale (huit directions). Le paramètre Zone grouping method (Méthode de regroupement de zones) détermine quelles valeurs de cellule sont prises en compte pour évaluer la connectivité.

  • Par défaut, le paramètre Add link field to output (Ajouter un champ de liaison en sortie) (ADD_LINK dans Python) est activé. Ceci crée un champ LINK dans la table attributaire du raster en sortie, qui conserve la valeur de zone d’origine pour chaque cellule du raster en entrée.

    Ce paramètre ne s’applique que lorsque le paramètre Zone grouping method (Méthode de regroupement de zones) (zone_connectivity dans Python) est défini sur Within (Dans). Lorsqu’il est défini sur Cross (Transversal) : la table attributaire du raster en sortie contient uniquement les champs Value et Count.

  • Lorsqu'il est disponible, le champ LINK vous permet de tracer l’ascendance de chaque région nouvellement créée pour remonter aux valeurs d’origine de zone en entrée, à utiliser pour une analyse supplémentaire.

    Par exemple, la table attributaire associée au raster en sortie de l'illustration ci-dessus est la suivante :

    Exemple du champ LINK dans la table attributaire

  • Lorsque l'environnement est défini sur Masque, la configuration spatiale et le nombre de régions peuvent être modifiés dans le raster en sortie.

  • Les emplacements de cellule qui contiennent la valeur exclue prennent la valeur zéro en sortie, afin que ces zones ne soient pas confondues avec les emplacements de cellule NoData existants. Puisque la numérotation débute à la valeur 1, les cellules qui sont exclues du regroupement sont considérés comme constituant l’arrière-plan. Ces cellules d'arrière-plan peuvent être reclassées ou manipulées de la même façon que n’importe quelle autre valeur.

  • 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

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 de cellules connectées uniques seront identifiées.

Il doit être de type entier.

Raster Layer
number_neighbors
(Facultatif)

Spécifie le nombre de cellules voisines à utiliser pour évaluer la connectivité entre les cellules qui définissent une région.

  • FOURLa connectivité est évaluée pour les quatre voisins les plus proches (direction orthogonale) de chaque cellule en entrée. Seules les cellules ayant la même valeur qui partagent au moins un côté forment une région individuelle. Si deux cellules de même valeur forment une diagonale, elles ne sont pas considérées comme étant connectées. Il s’agit de l’option par défaut.
  • EIGHTLa connectivité est évaluée pour les huit voisins les plus proches (directions orthogonale et diagonale) de chaque cellule en entrée. Les cellules ayant la même valeur qui sont connectées entre elles par un tronçon ou un angle commun forment une région individuelle.
String
zone_connectivity
(Facultatif)

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

  • WITHINLa connectivité d'une région est évaluée pour les cellules en entrée faisant partie de la même zone (valeur de cellule). Les seules cellules qui peuvent être regroupées sont des cellules de la même zone et qui répondent aux exigences spatiales de connectivité spécifiées par le paramètre number_neighbors (quatre ou huit). Il s’agit de l’option par défaut.
  • CROSSLa connectivité d’une région est évaluée entre les cellules de n’importe quelle valeur, à l’exception des cellules des zones identifiées comme devant être exclues par le paramètre excluded_value, et soumise aux exigences spatiales spécifiées par le paramètre number_neighbors. Les regroupements de régions dans l’entrée qui sont séparés des autres regroupements par une zone tampon de cellules NoData seront traités indépendamment les uns des autres.
String
add_link
(Facultatif)

Spécifie si un champ de lien est ajouté à la table de la sortie lorsque le paramètre zone_connectivity est défini sur WITHIN. Ignoré si ce paramètre est défini sur CROSS.

  • ADD_LINKUn champ LINK est ajouté à la table du raster en sortie. Ce champ stocke la valeur de la zone à laquelle appartiennent les cellules de chaque région dans la sortie conformément à la règle de connectivité définie dans le paramètre number_neighbors. Il s’agit de l’option par défaut.
  • NO_LINKAucun champ LINK n'est ajouté. La table attributaire du raster en sortie contiendra uniquement les champs Value et Count.
Boolean
excluded_value
(Facultatif)

Une valeur qui exclut de l’évaluation de connectivité toutes les cellules de cette zone. Si un emplacement de cellule contient cette valeur, aucune connectivité spatiale ne pourra être évaluée, indépendamment de la façon dont le nombre de voisins est spécifié.

Les cellules comportant la valeur exclue seront traitées de la même façon que les cellules NoData, et ne seront pas prises en compte dans l’opération. Dans le raster en sortie, la valeur zéro est attribuée aux cellules en entrée qui contiennent la valeur exclue. Le concept de valeur exclue est similaire à celui de valeur d’arrière-plan.

Par défaut, aucune valeur n’est définie pour ce paramètre, ce qui signifie que toutes les cellules en entrée seront prises en compte dans cette opération.

Long

Valeur renvoyée

NomExplicationType de données
out_raster

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

La sortie est toujours de type 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

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

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

Informations de licence

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

Rubriques connexes