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.
En général, la première région analysée reçoit la valeur un, la deuxième, la valeur deux et ainsi de suite 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 gèrent la façon dont la connectivité est établie 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é. Celui-ci crée un champ LINK dans la table attributaire du raster en sortie, qui conserve la valeur de la 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). S’il est défini sur Cross (À travers), la table attributaire du raster en sortie contient uniquement les champs habituels Value et Count.
Lorsqu’il est disponible, le champ LINK permet de retracer l’ascendance de chaque région récemment créée par rapport aux valeurs de zone en entrée d’origine, en vue d’une analyse supplémentaire.
Par exemple, la table attributaire associée au raster en sortie de l'illustration ci-dessus est la suivante :
Si l’environnement Masque est défini, 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 qu’une autre valeur.
Raster en entrée pour lesquelles les régions de cellules connectées uniques seront identifiées.
Il doit être de type entier.
Raster Layer
Nombre de voisins à utiliser
(Facultatif)
Spécifie le nombre de cellules voisines à utiliser afin d’évaluer la connectivité entre les cellules qui définissent une région.
Four—La connectivité est évaluée pour les quatre voisins les plus proches (direction orthogonale) de chaque cellule en entrée. Seules les cellules de même valeur qui partagent au moins un côté contribueront à une région donnée. 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.
Eight—La connectivité est évaluée pour les huit voisins les plus proches (directions orthogonale et diagonale) de chaque cellule en entrée. Les cellules de même valeur qui sont connectées par un bord ou un coin commun contribueront à une région donnée.
String
Méthode de regroupement de zones
(Facultatif)
Définit les valeurs de cellules qui doivent être prises en compte dans le cadre des tests de connectivité.
Dans—La 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 qui répondent aux exigences spatiales de connectivité spécifiées par le paramètre Number of neighbors to use (Nombre de voisins à utiliser) (quatre ou huit). Il s’agit de l’option par défaut.
À travers—La 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 (Valeur exclue), et soumise aux exigences spatiales spécifiées par le paramètre Number of neighbors to use (Nombre de voisins à utiliser). Le regroupement de régions de l’entrée qui sont séparées des autres regroupements par une zone tampon de cellules NoData seront traités indépendamment les uns des autres.
String
Ajouter un champ de liaison en sortie
(Facultatif)
Spécifie si un champ de lien est ajouté à la table de la sortie lorsque le paramètre Zone grouping method (Méthode de regroupement de zones) est défini sur Within (Dans). Il est ignoré si ce paramètre est défini sur Cross (À travers).
Activé—Un 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 of neighbors to use (Nombre de voisins à utiliser). Il s’agit de l’option par défaut.
Décoché—Un champ LINK n’est pas ajouté. La table attributaire du raster en sortie contiendra uniquement les champs Value et Count.
Boolean
Valeur exclue
(Facultatif)
Une valeur qui exclut de l’évaluation de connectivité toutes les cellules de cette zone. Si un emplacement de cellule contient la valeur, aucune connectivité spatiale ne pourra être évaluée, quel que soit le nombre de voisins spécifié.
Les cellules contenant la valeur exclue seront traitées comme les cellules NoData et ne sont pas prises en compte par 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. La valeur exclue repose sur le même concept qu’une 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.
Raster en entrée pour lesquelles 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 afin d’évaluer la connectivité entre les cellules qui définissent une région.
FOUR—La connectivité est évaluée pour les quatre voisins les plus proches (direction orthogonale) de chaque cellule en entrée. Seules les cellules de même valeur qui partagent au moins un côté contribueront à une région donnée. 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.
EIGHT—La connectivité est évaluée pour les huit voisins les plus proches (directions orthogonale et diagonale) de chaque cellule en entrée. Les cellules de même valeur qui sont connectées par un bord ou un coin commun contribueront à une région donnée.
String
zone_connectivity
(Facultatif)
Définit les valeurs de cellules qui doivent être prises en compte dans le cadre des tests de connectivité.
WITHIN—La 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 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.
CROSS—La 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. Le regroupement de régions de l’entrée qui sont séparées 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. Il est ignoré si ce paramètre est défini sur CROSS.
ADD_LINK—Un 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_LINK—Un champ LINK n’est pas 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 la valeur, aucune connectivité spatiale ne pourra être évaluée, quel que soit le nombre de voisins spécifié.
Les cellules contenant la valeur exclue seront traitées comme les cellules NoData et ne sont pas prises en compte par 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. La valeur exclue repose sur le même concept qu’une 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 de retour
Nom
Explication
Type 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
RegionGroup Exemple 1 (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.
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
# Run RegionGroup
outRegionGrp = RegionGroup(inRaster, "EIGHT", "CROSS",
"NO_LINK", valToIgnore)
# Save the output
outRegionGrp.save("C:/sapyexamples/output/reggrpout")
