Fonction de groupes par régions

Enregistre, pour chaque cellule en sortie, l’identité de la région connectée à laquelle appartient cette cellule. Un numéro unique est attribué à chaque région.

Il s’agit d’une fonction raster globale.

Remarques

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 Neighbor Cells (Nombre de cellules voisines) détermine la géométrie de la connectivité, soit de manière orthogonale (dans quatre sens) seulement, soit de manière diagonale et orthogonale (dans huit sens). Le paramètre Zone Connectivity (Connectivité de zone) détermine les valeurs des cellules prises en compte lors de l’évaluation de la connectivité.

Par défaut, le paramètre Add Link (Ajouter un lien) 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 si le paramètre Zone Connectivity (Connectivité de zone) est défini sur Within (Dans). S’il est défini sur Cross (Croiser), 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.

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.

Paramètres

Nom de paramètre	Description
Raster de zones (Requis)	Raster en entrée pour lesquelles les régions de cellules connectées uniques seront identifiées. Il doit être de type entier.
Nombre de cellules voisines	Spécifie le nombre de cellules voisines à utiliser afin d’évaluer la connectivité entre les cellules qui définissent une région. Four (Quatre) : la connectivité est évaluée pour les quatre voisins les plus proches (orthogonaux) 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 (Huit) : la connectivité est évaluée pour les huit voisins les plus proches (orthogonaux et diagonaux) 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.
Connectivité de zone	Définit les valeurs de cellules qui doivent être prises en compte dans le cadre des tests de connectivité. Within (Dans) : la connectivité d’une région est évaluée pour les cellules en entrée qui font 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 of Neighbor Cells (Nombre de cellules voisines) (quatre ou huit). Il s’agit de l’option par défaut. Cross (Croiser) : la connectivité d’une région est évaluée entre les cellules de valeurs quelconques, à l’exception des cellules de zone identifiées comme étant à exclure par le paramètre Excluded value (Valeur exclue) et soumises aux exigences spatiales spécifiées par le paramètre Number of Neighbor Cells (Nombre de cellules voisines). 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.
Ajouter un lien	Spécifie si un champ de lien est ajouté à la table en sortie lorsque le paramètre Zone Connectivity (Connectivité de zone) est défini sur Within (Dans). Il est ignoré si ce paramètre est défini sur Cross (Croiser). Add Link (Ajouter un lien) : 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 en sortie sur la base de la règle de connectivité définie par le paramètre Number of Neighbor Cells (Nombre de cellules voisines). Il s’agit de l’option par défaut. No Link (Aucun lien) : un champ LINK n’est pas ajouté. La table attributaire du raster en sortie contiendra uniquement les champs Value et Count.
Valeur exclue	Valeur qui exclut toutes les cellules de cette valeur de zone d’après l’évaluation de la connectivité. 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. Lorsqu’une zone dans le raster en entrée a la valeur 0 et que vous voulez inclure cette zone dans l’opération, spécifiez une valeur pour ce paramètre qui n’est pas présent en entrée. Si, par exemple, un raster en entrée comporte les valeurs 0, 1, 2 et 3, spécifiez une valeur exclue (Excluded Value) égale à 99. Si vous ne le faites pas, toutes les cellules de valeur 0 de l’entrée seront égales à 0 en sortie et leurs régions individuelles ne seront pas déterminées.