Localiser les régions (Spatial Analyst)

Synthèse

Identifie les meilleures régions, ou groupes de cellules contiguës, à partir d'un raster d'utilité (aptitude) en entrée satisfaisant un critère d'évaluation spécifié et correspondant aux contraintes identifiées en matière de forme, taille, nombre et distance interrégion.

Cet outil utilise un algorithme de croissance de région paramétrée (PRG) pour faire grandir des régions candidates à partir de cellules initiales en ajoutant des cellules voisines à la région qui permet de mieux conserver la forme spécifiée mais également d’optimiser l’utilité de la région. Grâce à un algorithme de sélection et à un critère d’évaluation, tel que la valeur moyenne la plus élevée, la ou les meilleures régions sont sélectionnées à partir des régions candidates répondant aux contraintes spatiales et de taille spécifiées. Un exemple de contrainte spatiale est la conservation d’une distance minimale donnée entre les régions.

Pour en savoir plus sur le fonctionnement de l’outil Localiser les régions

Utilisation

• Le raster d’utilité en entrée est souvent la sortie d’un modèle d’aptitude. Le modèle d’aptitude identifie le niveau d’adaptation de chaque emplacement en fonction des attributs souhaités figurant dans cet emplacement. La modélisation d’aptitude est l’une des applications les plus courantes de Spatial Analyst. Pour plus d'informations sur la modélisation d'aptitude, reportez-vous à la rubrique Présentation de l'analyse de superposition.

• Plus les valeurs en entrée du raster d'utilité sont élevées, plus grande est l'utilité.

• Les paramètres Distance minimale entre les régions et Distance maximale entre les régions sont prioritaires sur le paramètre Surface totale. Par exemple, si la zone doit contenir cinq régions, mais qu’en raison des distances minimale et maximale spécifiées seules quatre régions peuvent être localisées, quatre régions seulement sont sélectionnées. Par conséquent, la surface totale n'est pas obtenue. Lorsque cela est possible, un avertissement est émis, mais ce n'est pas toujours le cas.

• L’algorithme de croissance de région paramétrée (PRG) grandit en fonction des valeurs d’utilité du raster en entrée. Les cellules aux valeurs les plus élevées sont préférées pour la croissance. La méthode d'évaluation détermine les régions candidates sélectionnées. Elle n'a aucune influence sur la croissance des régions.

• L'outil Localiser les régions sollicite un grand nombre de ressources. De façon à jouer sur le temps de traitement, vous pouvez prendre des mesures sur la façon dont vous configurez les données en entrée et sur les réglages de certains paramètres.

• Pour accélérer le traitement, les emplacements ne devant pas être pris en compte dans le processus de sélection doivent être définis sur NoData lors d'une étape de prétraitement ou être supprimés à l'aide du masque. Aucune région ne se développe à partir de ces emplacements exclus, ni n'est attribuée au cours du processus de sélection. Contrairement à l’option Input raster or feature of existing regions (Entité ou raster en entrée des régions existantes), les zones exclues n’ont pas d’effet sur les paramètres Minimum distance between regions (Distance minimale entre les régions) et Maximum distance between regions (Distance maximale entre les régions) dans l’algorithme de croissance de région paramétrée (PRG) ou dans la sélection des régions candidates.

• Les options sélectionnées pour les paramètres Nombre à partir duquel augmenter les valeurs initiales et Résolution de la croissance peuvent avoir un impact important sur le temps de traitement.

  Pour optimiser les performances, sélectionnez les options Small et Low respectivement pour ces deux paramètres. Si vous choisissez Small, Medium ou Large pour Number of seeds to grow from (Nombre à partir duquel augmenter les valeurs initiales), et Low, Medium ou High pour Resolution of the growth (Résolution de la croissance), vous obtenez les résultats les plus fiables dans un temps raisonnable.

• Si le paramètre Number of seeds to grow from (Nombre à partir duquel augmenter les valeurs initiales) ou Resolution of the growth (Résolution de la croissance) comporte une valeur autre que Maximum, des données sont perdues, car des régions ne sont pas développées à partir de chaque cellule et un rééchantillonnage a lieu avec une résolution plus grossière. Cependant, en fonction de la taille du raster en entrée, l’option Maximum risque de s’exécuter très lentement. Par conséquent, les autres options peuvent s’avérer plus pratiques.

• En fonction de la taille du raster en entrée, choisir Maximum pour Number of seeds to grow from (Nombre à partir duquel augmenter les valeurs initiales) ou Resolution of the growth (Résolution de la croissance) peut entraîner un traitement long. L'algorithme Localiser les régions implémente un processus en deux étapes. Il commence par faire grandir des régions candidates, puis il sélectionne les meilleures régions à partir de ces régions candidates. La croissance des régions de grands rasters en entrée peut s'avérer longue. Cependant, au cours de l'étape de sélection des régions, une matrice de distances est tout d'abord chargée. Si la matrice ne peut pas être chargée en raison de limitations de mémoire, l’outil arrête le traitement. Dans ce cas, sélectionnez un nombre plus réduit à partir duquel augmenter les valeurs initiales ou indiquez une résolution de la croissance plus grossière.

• Les valeurs par défaut de Number of seeds to grow from (Nombre à partir duquel augmenter les valeurs initiales) et Resolution of the growth (Résolution de la croissance) dépendent du nombre de cellules dans le raster en entrée. Plus le raster en entrée compte de cellules, plus l'exécution de l'outil est longue. Pour éviter les durées d'exécution extrêmement longues, ces valeurs par défaut sont définies en conséquence.

  Nombre de cellules en entrée	Nombre à partir duquel augmenter les valeurs initiales	Résolution de la croissance
  <= 100 000	Maximum	Maximum
  100 000 - 500 000	Petite	Maximum
  > 500 000	Petite	Faible

• Lorsque la valeur de Number of regions (Nombre de régions) est supérieure à huit, il est recommandé d’utiliser l’option Sequential pour Region selection method (Méthode de sélection des régions). Utiliser la méthode Combinatorial avec plus de huit régions sélectionnées peut ralentir les performances.

• La valeur Nombre à partir duquel augmenter les valeurs initiales a généralement un impact important sur la vitesse de traitement. Plus le nombre de valeurs initiales est élevé, plus l'exécution de l'outil est longue. Cependant, dans la plupart des cas, les résultats sont similaires, quelle que soit la valeur spécifiée.

• Le nombre à partir duquel augmenter les valeurs initiales est distribué au sein du raster en entrée en fonction des valeurs d'utilité. Les zones comportant les valeurs d'utilité les plus élevées reçoivent plus de valeurs initiales. La Méthode d'évaluation n'a pas d'influence sur leur distribution.

• La résolution de la croissance définit la résolution à laquelle la région paramétrée va grandir. Le raster en entrée est rééchantillonné sur la résolution définie à l’aide de la méthode de rééchantillonnage bilinéaire. Une fois les régions sélectionnées, avant la création du raster en sortie final, les résultats sont rééchantillonnés en fonction de la taille de cellule de l’environnement, à l’aide de la méthode de rééchantillonnage du plus proche voisin.

• La forme des régions se trouvant à la limite du raster en entrée est ajustée. Si au moins une cellule doit figurer en dehors de la limite du raster en entrée pour conserver la forme, l’utilité de la région est réduite de 50 %. En raison de cette réduction de l'utilité, la région a moins de chances d'être sélectionnée, mais elle n'est pas éliminée du processus de sélection.

• La surface sélectionnée peut être supérieure à la surface totale spécifiée si l'option Ilots non autorisés dans les régions est sélectionnée. Pour déterminer si la différence entre la surface sélectionnée et la surface totale spécifiée repose sur le paramètre d’absence d’îlots, exécutez à nouveau l’outil après avoir désactivé ce paramètre. Ajoutez le nombre de cellules de COUNT dans la table attributaire du raster en sortie de l’exécution d’origine, puis réexécutez l’outil, multipliez la somme de chaque par la surface d’une cellule et comparez les résultats à la surface spécifiée.

• Si la valeur de la zone Resolution of the growth (Résolution de la croissance) est spécifiée sur une option autre que Maximum, via un post-traitement, les valeurs d’utilité d’origine de chaque région peuvent être identifiées à l’aide de l’outil Statistiques zonales. Indiquez le raster en sortie de Localiser les régions en tant que raster de zones et le raster d'utilité en entrée en tant que raster de valeurs.

• 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.

Paramètres

Boîte de dialogue

Étiquette	Explication	Type de données
Raster en entrée	Raster d'utilité en entrée à partir duquel les régions sont créées. Plus la valeur du raster en entrée est élevée, plus grande est l'utilité. Le raster peut être de type entier ou à virgule flottante.	Raster Layer
Surface totale (Facultatif)	Surface totale de toutes les régions. La valeur par défaut est fixée à 10 % des cellules en entrée de l'étendue de traitement.	Double
Unités de surface (Facultatif)	Définit les unités de surface utilisées pour les paramètres Total area (Surface totale), Region minimum area (Zone minimale de la région) et Region maximum area (Zone maximale de la région). Les options disponibles et leurs unités correspondantes sont les suivantes : La valeur par défaut est basée sur le jeu de données raster en entrée. Si le raster en entrée est en pieds, yards, miles ou une autre unité de mesure anglo-saxonne, la valeur utilisée est Square miles. Si le raster en entrée est en mètres, kilomètres ou une autre unité du système métrique, la valeur utilisée est Square kilometers. Unité de carte au carré—Pour le carré des unités linéaires de la référence spatiale en sortie Miles carrés—Pour les miles Kilomètres carrés—Pour les kilomètres Hectares—Pour les hectares Ares—Pour les acres Mètres carrés—Pour les mètres Yards carrés—Pour les yards Pieds carrés—Pour les pieds	String
Nombre de régions (Facultatif)	Détermine le nombre de régions sur lesquelles la surface totale est distribuée. Le nombre maximal de régions pouvant être spécifiées est de 30. La valeur par défaut est 1.	Long
Forme de région (Facultatif)	Définit les caractéristiques de forme des régions en sortie. Les régions sont créées à partir d'emplacements de cellules initiales et grandissent vers l'extérieur en donnant la préférence aux cellules permettant de conserver la forme souhaitée. Les options de forme disponibles sont les suivantes : Cercle—Les cellules qui préservent les régions circulaires bénéficient d'une plus grande pondération. Il s’agit de l’option par défaut. Ellipse—Les cellules qui préservent les régions elliptiques bénéficient d'une plus grande pondération. Triangle équilatéral—Les cellules qui préservent les régions en forme de triangle équilatéral bénéficient d'une plus grande pondération. Carré—Les cellules qui préservent les régions carrées bénéficient d'une plus grande pondération. Pentagone—Les cellules qui préservent les régions en forme de pentagone bénéficient d'une plus grande pondération. Hexagone—Les cellules qui préservent les régions en forme d'hexagone bénéficient d'une plus grande pondération. Octogone—Les cellules qui préservent les régions en forme d'octogone bénéficient d'une plus grande pondération.	String
Orientation des régions (Facultatif)	Définit l’orientation de la forme définie. Les régions grandissent vers l'extérieur à partir des emplacements initiaux, avec une préférence pour les cellules permettant de conserver l'orientation souhaitée des formes des régions. Les valeurs d'orientation sont exprimées en degrés d'une boussole, entre 0 et 360, et elles augmentent dans le sens horaire à partir du nord. La valeur par défaut est 0. La valeur par défaut 0 oriente les formes de la façon suivante : Cercle (pas d’effet), Ellipse (le petit axe est orienté nord-sud), Triangle et Pentagone (un point tout droit vers le haut) et Carré, Hexagone et Octogone (un côté plat est orienté est-ouest). Si l’option Region shape (Forme de région) est définie sur Circle, le paramètre Region orientation (Orientation des régions) n’est pas disponible.	Double
Compromis forme/distribution (%) (Facultatif)	Identifie la pondération des cellules lors de la croissance des régions candidates dans l'algorithme de croissance de région paramétrée. Le choix de la pondération repose sur un compromis entre la contribution d'une cellule à la préservation de la forme de la région et l'utilité de la valeur attributaire de la cellule. Les valeurs les plus élevées indiquent que la préservation de la forme de la région est plus importante que la sélection des valeurs d'utilité les plus élevées. Les valeurs de pourcentage acceptables vont de 0 à 100 (inclus). La valeur par défaut est 50. Ce paramètre permet d’identifier les régions candidates réalisables. Les régions candidates sélectionnées par l'algorithme sont contrôlées par le paramètre Méthode d'évaluation.	Double
Méthode d’évaluation (Facultatif)	Critères d’évaluation à utiliser pour déterminer quelles sont les régions candidates préférées parmi celles identifiées par l’algorithme de croissance de région paramétrée. La préférence peut reposer sur une statistique spécifique des valeurs d'utilité ou sur la disposition spatiale des cellules au sein des régions. Les options disponibles sont les suivantes : Valeur moyenne la plus élevée—Sélectionne les régions en fonction de la valeur moyenne la plus élevée. Il s’agit de l’option par défaut. Somme la plus élevée—Sélectionne les régions en fonction de la somme la plus élevée. Valeur médiane la plus élevée—Sélectionne les régions en fonction de la valeur médiane la plus élevée. Valeur la plus élevée—Sélectionne les régions en fonction de la valeur de cellule individuelle la plus élevée contenue dans la région. Cette option permet de s'assurer que les meilleures cellules individuelles sont sélectionnées. Valeur la plus faible—Sélectionne les régions en fonction de la valeur de cellule individuelle la plus faible contenue dans la région. Cette option permet de s’assurer que les régions sélectionnées contiennent des cellules ayant une utilité réellement faible. Plus grande zone principale—Sélectionne les régions en fonction de la plus grande zone principale.Toute cellule éloignée de plus d’une cellule de la limite de la région est considérée comme faisant partie de la zone principale. La distance de la limite peut être contrôlée par la taille de cellule d'analyse. Définir une taille de cellule moins élevée permet d'augmenter la zone principale. Somme la plus élevée de valeurs d'utilité de la zone principale—Sélectionne les régions en fonction de la somme cumulée la plus élevée des valeurs d'utilité de la zone principale. La distance de la limite peut être contrôlée par la taille de cellule d'analyse. Plus grande limite—Sélectionne les régions en fonction de la plus grande quantité de limites à l'aide du rapport P1, qui est le rapport entre le périmètre de la forme et le périmètre d'un cercle de la même surface. Le rapport P1 d'un cercle est de 1.	String
Zone minimale de la région (Facultatif)	Définit la surface minimale autorisée pour chaque région. Les unités utilisées sont celles spécifiées par le paramètre Unités de surface.	Double
Zone maximale de la région (Facultatif)	Définit la surface maximale autorisée pour chaque région. Les unités utilisées sont celles spécifiées par le paramètre Unités de surface.	Double
Distance minimale entre les régions (Facultatif)	Définit la distance minimale autorisée entre les régions. Deux régions ne peuvent pas se trouver à cette distance l’une de l’autre. Ce paramètre influence l'algorithme de croissance de région paramétrée (PRG). Si une cellule a le potentiel pour être ajoutée à une région candidate, mais qu'elle se trouve à l'intérieur de cette distance à partir d'une région individuelle du jeu de données spécifié par le paramètre Entité ou raster en entrée des régions existantes, elle n'est pas prise en compte pour la région candidate. Le paramètre de distance minimale ne s'applique pas aux emplacements exclus (cellules NoData). Les unités utilisées sont celles spécifiées par le paramètre Unités de distance.	Double
Distance maximale entre les régions (Facultatif)	Définit la distance maximale autorisée entre les régions. Aucune région ne peut se trouver plus loin que cette distance à partir d'au moins une autre région. Lorsque vous sélectionnez des régions de façon séquentielle, si la meilleure région suivante se trouve à plus de cette distance d’une autre région déjà sélectionnée, elle n’est pas prise en compte pour le moment, mais elle peut être sélectionnée ultérieurement lorsque plus de régions sont sélectionnées. La distance maximale est appliquée au jeu de données spécifié dans le paramètre Entité ou raster en entrée des régions existantes. Au moins l'une des régions sélectionnées doit se trouver à l'intérieur de la distance maximale à partir des régions existantes. Le paramètre de distance maximale ne s'applique pas aux zones exclues (cellules NoData) et n'a pas d'effet sur l'algorithme PRG. Les unités utilisées sont celles spécifiées par le paramètre Unités de distance.	Double
Unités de distance (Facultatif)	Définit les unités de distance qui vont être utilisées pour les paramètres Minimum distance between regions (Distance minimale entre les régions) et Maximum distance between regions (Distance maximale entre les régions). Les options disponibles et leurs unités correspondantes sont les suivantes : La valeur par défaut est basée sur le jeu de données raster en entrée. Si le raster en entrée est en pieds, yards, miles ou une autre unité de mesure anglo-saxonne, la valeur utilisée est Miles. Si le raster en entrée est en mètres, kilomètres ou une autre unité du système métrique, la valeur utilisée est Kilometers. Unités cartographiques—Pour les unités linéaires de la référence spatiale en sortie Milles—Pour les miles Kilomètres—Pour les kilomètres Mètres—Pour les mètres Yards—Pour les yards Pieds—Pour les pieds	String
Entité ou raster en entrée des régions existantes (Facultatif)	Jeu de données identifiant l'emplacement où des régions existent déjà. L'entrée peut être un raster ou un jeu de données d'entité. Si l'entrée est un raster, tout emplacement du raster ayant une valeur valide est considéré comme étant déjà attribué. Tous les autres emplacements sont définis sur NoData. Dans l'algorithme de croissance de région paramétrée, aucune région ne grandit à partir d'un emplacement identifié en tant que région existante. Les régions existantes sont utilisées pour la croissance et l'évaluation des paramètres Distance minimale entre les régions et Distance maximale entre les régions, comme décrit dans les descriptions correspondantes ci-dessus.	Raster Layer; Feature Layer
Nombre de voisins à utiliser dans la croissance (Facultatif)	Définit quelles cellules voisines utiliser pour la croissance des régions. Les options disponibles sont les suivantes : Four—Seuls les quatre voisins directs (orthogonaux) de la région sont pris en compte pour la croissance de la région. Eight—Les huit voisins les plus proches (orthogonaux et en diagonale) sont pris en compte pour la croissance de la région. Il s’agit de l’option par défaut.	String
Ilots non autorisés dans les régions (Facultatif)	Indique si des îlots sont autorisés ou non dans les régions potentielles. Activé : l'algorithme de croissance de région paramétrée garantit que les régions ne contiennent pas d'îlot. Il s’agit de l’option par défaut. Un algorithme de remplissage par diffusion est implémenté en post-traitement, une fois les régions créées, mais avant leur sélection. Si une région contient des îlots, ceux-ci sont remplis et leurs cellules rejoignent la région. Étant donné que l’opération de remplissage se produit avant le processus de sélection, l’utilité des cellules des îlots est ajoutée à la région et leurs valeurs sont incluses dans le processus de sélection des régions et dans les statistiques des régions en sortie. Suite au processus de remplissage, il est probable que la surface totale allouée dépasse la valeur spécifiée par le paramètre Surface totale. Désactivé : les îlots sont autorisés.	Boolean
Nombre à partir duquel augmenter les valeurs initiales (Facultatif)	Définit le nombre de valeurs initiales à partir desquelles faire grandir les régions potentielles. Les options disponibles sont les suivantes : En fonction de l'entrée—Le nombre de valeurs initiales repose sur le nombre de cellules du raster en entrée. Lorsque le raster en entrée compte 100 000 cellules ou moins, la valeur par défaut est Maximum. Lorsque le raster en entrée compte plus de 100 000 cellules, la valeur par défaut est Small. Il s’agit de l’option par défaut. Petite—Le nombre de valeurs initiales est égal à 10 % du nombre de cellules dans le raster en entrée, une fois les cellules NoData exclues, mais il ne doit pas dépasser 1 600. Moyenne—Le nombre de valeurs initiales est égal à 20 % du nombre de cellules dans le raster en entrée, une fois les cellules NoData exclues, mais il ne doit pas dépasser 2 500. Grande—Le nombre de valeurs initiales est égal à 30 % du nombre de cellules dans le raster en entrée, une fois les cellules NoData exclues, mais il ne doit pas dépasser 3 600. Maximum—La croissance des régions a lieu au niveau de chaque cellule disponible du raster en entrée. Les cellules disponibles sont toutes les cellules qui ne sont pas NoData et qui ne sont pas identifiées en tant que région existante.	String
Résolution de la croissance (Facultatif)	Définit la résolution à laquelle la région grandit. Le raster en entrée est rééchantillonné en fonction de la résolution déterminée par le nombre de cellules identifiées par ce paramètre (voir ci-dessous). Par exemple, pour la valeur LOW, le raster en entrée est rééchantillonné sur 147 356 cellules. L'algorithme de croissance de région paramétrée grandit sur le raster intermédiaire rééchantillonné. Une fois les régions sélectionnées à partir du raster intermédiaire rééchantillonné, les régions sélectionnées sont rééchantillonnées sur la taille de cellule Environnement. Les résolutions cibles identifiées ci-dessous peuvent être ajustées si le nombre de cellules de la taille de région moyenne souhaitée est trop petit ou trop grand. Cet ajustement permet de s’assurer que chaque région souhaitée contient suffisamment de cellules ou qu’un traitement inutile n’a pas lieu. En conséquence, le nombre total de cellules du raster rééchantillonné intermédiaire pour chaque résolution spécifiée ci-dessous peut être inférieur ou supérieur au nombre cible de cellules. Si l’entrée comporte moins de 147 356 cellules ou si la valeur Maximum est sélectionnée, aucun rééchantillonnage n’a lieu et la croissance des régions se produit sur toutes les cellules du raster en entrée. Si le raster en entrée comporte moins de 147 356 cellules, les options Low, Medium et High n’ont aucun effet. Les options disponibles sont les suivantes : En fonction de l'entrée—La résolution repose sur le nombre de cellules du raster en entrée. Lorsque le raster en entrée compte 500 000 cellules ou moins, la valeur par défaut est Maximum. Lorsque le raster en entrée compte plus de 500 000 cellules, la valeur par défaut est Low. Il s’agit de l’option par défaut. Faible—L’analyse est effectuée sur un raster intermédiaire contenant 147 356 (384 x 384) cellules distribuées selon le même rapport de x et y que le raster en entrée. Moyenne—L'analyse est effectuée sur un raster intermédiaire contenant 262 144 (512 x 512) cellules distribuées selon le même rapport de x et y que le raster en entrée. Elevée—L’analyse est effectuée sur un raster intermédiaire contenant 589 824 (768 x 768) cellules distribuées selon le même rapport de x et y que le raster en entrée. Maximum—L'analyse porte sur toutes les cellules du raster en entrée.	String
Méthode de sélection des régions (Facultatif)	Identifie la façon dont les régions sont sélectionnées. Les options disponibles sont les suivantes : En fonction du nombre de régions—La méthode de sélection est basée sur le paramètre Nombre de régions. Si le paramètre Number of regions (Nombre de régions) est de huit ou moins, la méthode de sélection utilisée est la méthode Combinatorial. Si le paramètre Number of regions (Nombre de régions) est supérieur à huit, la méthode de sélection utilisée est la méthode Sequential. Il s’agit de l’option par défaut. Combinatoire—Sélectionne les meilleures régions en fonction de la méthode d’évaluation spécifiée, tout en respectant les contraintes spatiales, en testant toutes les combinaisons du nombre de régions spatiales souhaitées au sein des régions candidates à partir de l’algorithme de croissance de région paramétrée. Séquentiel—Sélectionne de façon séquentielle les meilleures régions en fonction de la méthode d'évaluation et qui répondent aux contraintes spatiales jusqu'à ce que le nombre souhaité de régions soit atteint.	String

Valeur renvoyée

Étiquette	Explication	Type de données
Raster en sortie	Raster de régions en sortie. Chaque région est numérotée de manière unique avec des valeurs supérieures à zéro. Les cellules n'appartenant pas à une région sont définies sur zéro. La sortie est toujours un raster de type entier. D'autres champs sont calculés pour chaque région stockant des statistiques sur les régions sélectionnées. Ces champs sont les suivants : AVERAGE—Valeur d'utilité moyenne de la région. TOTAL—Somme totale des valeurs d'utilité de la région. MEDIAN—Valeur d'utilité médiane de la région. HIGHEST—Valeur de cellule individuelle la plus élevée contenue dans la région. LOWEST—Valeur de cellule individuelle la plus faible contenue dans la région. COREAREA—Zone principale. Toute cellule éloignée de plus d’une cellule de la limite de la région est considérée comme faisant partie de la zone principale. CORESUM—Somme cumulée des valeurs d'utilité de la zone principale. EDGE—Quantité de limites avec le rapport P1, qui est le rapport entre le périmètre de la forme et le périmètre d'un cercle de la même surface. Le rapport P1 d'un cercle est de 1.	Raster

Python

LocateRegions(in_raster, {total_area}, {area_units}, {number_of_regions}, {region_shape}, {region_orientation}, {shape_tradeoff}, {evaluation_method}, {minimum_area}, {maximum_area}, {minimum_distance}, {maximum_distance}, {distance_units}, {in_existing_regions}, {number_of_neighbors}, {no_islands}, {region_seeds}, {region_resolution}, {selection_method})

Nom	Explication	Type de données
in_raster	Raster d'utilité en entrée à partir duquel les régions sont créées. Plus la valeur du raster en entrée est élevée, plus grande est l'utilité. Le raster peut être de type entier ou à virgule flottante.	Raster Layer
total_area (Facultatif)	Surface totale de toutes les régions. La valeur par défaut est fixée à 10 % des cellules en entrée de l'étendue de traitement.	Double
area_units (Facultatif)	Définit les unités de surface utilisées pour les paramètres total_area, minimum_area et maximum_area. Les options disponibles et leurs unités correspondantes sont les suivantes : SQUARE_MAP_UNITS—Pour le carré des unités linéaires de la référence spatiale en sortie SQUARE_MILES—Pour les miles SQUARE_KILOMETERS—Pour les kilomètres HECTARES—Pour les hectares ACRES—Pour les acres SQUARE_METERS—Pour les mètres SQUARE_YARDS—Pour les yards SQUARE_FEET—Pour les pieds La valeur par défaut est basée sur le jeu de données raster en entrée. Si le raster en entrée est en pieds, yards, miles ou une autre unité de mesure anglo-saxonne, la valeur utilisée est Square miles. Si le raster en entrée est en mètres, kilomètres ou une autre unité du système métrique, la valeur utilisée est Square kilometers.	String
number_of_regions (Facultatif)	Détermine le nombre de régions sur lesquelles la total_area est distribuée. Le nombre maximal de régions pouvant être spécifiées est de 30. La valeur par défaut est 1.	Long
region_shape (Facultatif)	Définit les caractéristiques de forme des régions en sortie. Les régions sont créées à partir d'emplacements de cellules initiales et grandissent vers l'extérieur en donnant la préférence aux cellules permettant de conserver la forme souhaitée. Les options de forme disponibles sont les suivantes : CIRCLE—Les cellules qui préservent les régions circulaires bénéficient d'une plus grande pondération. Il s’agit de l’option par défaut. ELLIPSE—Les cellules qui préservent les régions elliptiques bénéficient d'une plus grande pondération. TRIANGLE—Les cellules qui préservent les régions en forme de triangle équilatéral bénéficient d'une plus grande pondération. SQUARE—Les cellules qui préservent les régions carrées bénéficient d'une plus grande pondération. PENTAGON—Les cellules qui préservent les régions en forme de pentagone bénéficient d'une plus grande pondération. HEXAGON—Les cellules qui préservent les régions en forme d'hexagone bénéficient d'une plus grande pondération. OCTAGON—Les cellules qui préservent les régions en forme d'octogone bénéficient d'une plus grande pondération.	String
region_orientation (Facultatif)	Définit l’orientation de la forme définie. Les régions grandissent vers l'extérieur à partir des emplacements initiaux, avec une préférence pour les cellules permettant de conserver l'orientation souhaitée des formes des régions. Les valeurs d'orientation sont exprimées en degrés d'une boussole, entre 0 et 360, et elles augmentent dans le sens horaire à partir du nord. La valeur par défaut est 0. La valeur par défaut 0 oriente les formes de la façon suivante : Cercle (pas d’effet), Ellipse (le petit axe est orienté nord-sud), Triangle et Pentagone (un point tout droit vers le haut) et Carré, Hexagone et Octogone (un côté plat est orienté est-ouest).	Double
shape_tradeoff (Facultatif)	Identifie la pondération des cellules lors de la croissance des régions candidates dans l'algorithme de croissance de région paramétrée. Le choix de la pondération repose sur un compromis entre la contribution d'une cellule à la préservation de la forme de la région et l'utilité de la valeur attributaire de la cellule. Les valeurs les plus élevées indiquent que la préservation de la forme de la région est plus importante que la sélection des valeurs d'utilité les plus élevées. Les valeurs de pourcentage acceptables vont de 0 à 100 (inclus). La valeur par défaut est 50. Ce paramètre permet d’identifier les régions candidates réalisables. Les régions candidates sélectionnées sont contrôlées par le paramètre evaluation_method.	Double
evaluation_method (Facultatif)	Critères d’évaluation à utiliser pour déterminer quelles sont les régions candidates préférées parmi celles identifiées par l’algorithme de croissance de région paramétrée. La préférence peut reposer sur une statistique spécifique des valeurs d'utilité ou sur la disposition spatiale des cellules au sein des régions. Les options disponibles sont les suivantes : HIGHEST_AVERAGE_VALUE—Sélectionne les régions en fonction de la valeur moyenne la plus élevée. Il s’agit de l’option par défaut. HIGHEST_SUM—Sélectionne les régions en fonction de la somme la plus élevée. HIGHEST_MEDIAN_VALUE—Sélectionne les régions en fonction de la valeur médiane la plus élevée. HIGHEST_VALUE—Sélectionne les régions en fonction de la valeur de cellule individuelle la plus élevée contenue dans la région. Cette option permet de s'assurer que les meilleures cellules individuelles sont sélectionnées. LOWEST_VALUE—Sélectionne les régions en fonction de la valeur de cellule individuelle la plus faible contenue dans la région. Cette option permet de s’assurer que les régions sélectionnées contiennent des cellules ayant une utilité réellement faible. GREATEST_CORE_AREA—Sélectionne les régions en fonction de la plus grande zone principale.Toute cellule éloignée de plus d’une cellule de la limite de la région est considérée comme faisant partie de la zone principale. La distance de la limite peut être contrôlée par la taille de cellule d'analyse. Définir une taille de cellule moins élevée permet d'augmenter la zone principale. HIGHEST_CORE_SUM—Sélectionne les régions en fonction de la somme cumulée la plus élevée des valeurs d'utilité de la zone principale. La distance de la limite peut être contrôlée par la taille de cellule d'analyse. GREATEST_EDGE—Sélectionne les régions en fonction de la plus grande quantité de limites à l'aide du rapport P1, qui est le rapport entre le périmètre de la forme et le périmètre d'un cercle de la même surface. Le rapport P1 d'un cercle est de 1.	String
minimum_area (Facultatif)	Définit la surface minimale autorisée pour chaque région. Les unités utilisées sont celles spécifiées par les area_units. Pour en savoir plus sur la façon dont les régions sont créées lorsque des zones minimale et maximale sont définies, reportez-vous à la rubrique Détermination des régions lorsqu'une zone minimale et maximale sont spécifiées.	Double
maximum_area (Facultatif)	Définit la surface maximale autorisée pour chaque région. Les unités utilisées sont celles spécifiées par les area_units. Pour en savoir plus sur la façon dont les régions sont créées lorsque des zones minimale et maximale sont définies, reportez-vous à la rubrique Détermination des régions lorsqu'une zone minimale et maximale sont spécifiées.	Double
minimum_distance (Facultatif)	Définit la distance minimale autorisée entre les régions. Deux régions ne peuvent pas se trouver à cette distance l’une de l’autre. Ce paramètre influence l'algorithme de croissance de région paramétrée (PRG). Si une cellule a le potentiel pour être ajoutée à une région candidate, mais qu’elle se trouve à l’intérieur de cette distance à partir d’une région individuelle des in_existing_regions, elle n’est pas prise en compte pour la région candidate. Le paramètre de distance minimale ne s'applique pas aux emplacements exclus (cellules NoData). Les unités utilisées sont celles spécifiées par les distance_units.	Double
maximum_distance (Facultatif)	Définit la distance maximale autorisée entre les régions. Aucune région ne peut se trouver plus loin que cette distance à partir d'au moins une autre région. Lorsque vous sélectionnez des régions de façon séquentielle, si la meilleure région suivante se trouve à plus de cette distance d’une autre région déjà sélectionnée, elle n’est pas prise en compte pour le moment, mais elle peut être sélectionnée ultérieurement lorsque plus de régions sont sélectionnées. La distance maximale est appliquée aux in_existing_regions. Au moins l’une des régions sélectionnées doit se trouver à l’intérieur de la distance maximale à partir des régions existantes. Le paramètre de distance maximale ne s'applique pas aux zones exclues (cellules NoData) et n'a pas d'effet sur l'algorithme PRG. Les unités utilisées sont celles spécifiées par les distance_units.	Double
distance_units (Facultatif)	Définit les unités de distance qui vont être utilisées pour les paramètres minimum_distance et maximum_distance. Les options disponibles et leurs unités correspondantes sont les suivantes : MAP_UNITS—Pour les unités linéaires de la référence spatiale en sortie MILES—Pour les miles KILOMETERS—Pour les kilomètres METERS—Pour les mètres YARDS—Pour les yards FEET—Pour les pieds La valeur par défaut est basée sur le jeu de données raster en entrée. Si le raster en entrée est en pieds, yards, miles ou une autre unité de mesure anglo-saxonne, la valeur utilisée est Miles. Si le raster en entrée est en mètres, kilomètres ou une autre unité du système métrique, la valeur utilisée est Kilometers.	String
in_existing_regions (Facultatif)	Jeu de données identifiant l'emplacement où des régions existent déjà. L'entrée peut être un raster ou un jeu de données d'entité. Si l'entrée est un raster, tout emplacement du raster ayant une valeur valide est considéré comme étant déjà attribué. Tous les autres emplacements sont définis sur NoData. Dans l'algorithme de croissance de région paramétrée, aucune région ne grandit à partir d'un emplacement contenant une région existante. Les régions existantes sont utilisées pour la croissance et l’évaluation des paramètres minimum_distance et maximum_distance, comme décrit dans les descriptions correspondantes ci-dessus.	Raster Layer; Feature Layer
number_of_neighbors (Facultatif)	Définit quelles cellules voisines utiliser pour la croissance des régions. Les options disponibles sont les suivantes : FOUR—Seuls les quatre voisins directs (orthogonaux) de la région sont pris en compte pour la croissance de la région. EIGHT—Les huit voisins les plus proches (orthogonaux et en diagonale) sont pris en compte pour la croissance de la région. Il s’agit de l’option par défaut.	String
no_islands (Facultatif)	Indique si des îlots sont autorisés dans les régions potentielles. NO_ISLANDS—L'algorithme de croissance de région paramétrée garantit que les régions ne contiennent pas d'îlot.Un algorithme de remplissage par diffusion est implémenté en post-traitement, une fois les régions créées, mais avant leur sélection. Si une région contient des îlots, ceux-ci sont remplis et leurs cellules rejoignent la région. Étant donné que l’opération de remplissage se produit avant le processus de sélection, l’utilité des cellules des îlots est ajoutée à la région et leurs valeurs sont incluses dans le processus de sélection des régions et dans les statistiques des régions en sortie. Suite au processus de remplissage, il est probable que la surface totale allouée dépasse la valeur total_area cible.Il s’agit de l’option par défaut. ISLANDS_ALLOWED—Les îlots sont autorisés.	Boolean
region_seeds (Facultatif)	Définit le nombre de valeurs initiales à partir desquelles faire grandir les régions potentielles. Pour en savoir plus sur la façon dont les valeurs initiales influencent l’algorithme de croissances des régions, reportez-vous à la rubrique Distribution des valeurs initiales. Les options disponibles sont les suivantes : AUTO—Le nombre de valeurs initiales repose sur le nombre de cellules du raster en entrée. Lorsque le raster en entrée compte 100 000 cellules ou moins, la valeur par défaut est Maximum. Lorsque le raster en entrée compte plus de 100 000 cellules, la valeur par défaut est Small. Il s’agit de l’option par défaut. SMALL—Le nombre de valeurs initiales est égal à 10 % du nombre de cellules dans le raster en entrée, une fois les cellules NoData exclues, mais il ne doit pas dépasser 1 600. MEDIUM—Le nombre de valeurs initiales est égal à 20 % du nombre de cellules dans le raster en entrée, une fois les cellules NoData exclues, mais il ne doit pas dépasser 2 500. LARGE—Le nombre de valeurs initiales est égal à 30 % du nombre de cellules dans le raster en entrée, une fois les cellules NoData exclues, mais il ne doit pas dépasser 3 600. MAXIMUM—La croissance des régions a lieu au niveau de chaque cellule disponible du raster en entrée. Les cellules disponibles sont toutes les cellules qui ne sont pas NoData et qui ne sont pas identifiées en tant que région existante.	String
region_resolution (Facultatif)	Définit la résolution à laquelle la région grandit. Le raster en entrée est rééchantillonné en fonction de la résolution déterminée par le nombre de cellules identifiées par ce paramètre (voir ci-dessous). Par exemple, pour la valeur Low, le raster en entrée est rééchantillonné sur 147 356 cellules. L'algorithme de croissance de région paramétrée grandit sur le raster intermédiaire rééchantillonné. Une fois les régions sélectionnées à partir du raster intermédiaire rééchantillonné, les régions sélectionnées sont rééchantillonnées sur la taille de cellule. Les résolutions cibles identifiées ci-dessous peuvent être ajustées si le nombre de cellules de la taille de région moyenne souhaitée est trop petit ou trop grand. Cet ajustement permet de s’assurer que chaque région souhaitée contient suffisamment de cellules ou qu’un traitement inutile n’a pas lieu. En conséquence, le nombre total de cellules du raster rééchantillonné intermédiaire pour chaque résolution spécifiée ci-dessous peut être inférieur ou supérieur au nombre cible de cellules. Pour plus d'informations sur cet ajustement et sur les seuils utilisés, reportez-vous à la rubrique Ajustement de la résolution de croissance des régions en fonction de la taille des régions souhaitées. Si l’entrée comporte moins de 147 356 cellules ou si la valeur Maximum est sélectionnée, aucun rééchantillonnage n’a lieu et la croissance des régions se produit sur toutes les cellules du raster en entrée. Si le raster en entrée comporte moins de 147 356 cellules, les options Low, Medium et High n’ont aucun effet. Les options disponibles sont les suivantes : AUTO—La résolution repose sur le nombre de cellules du raster en entrée. Lorsque le raster en entrée compte 500 000 cellules ou moins, la valeur par défaut est Maximum. Lorsque le raster en entrée compte plus de 500 000 cellules, la valeur par défaut est Low. Il s’agit de l’option par défaut. LOW—L’analyse est effectuée sur un raster intermédiaire contenant 147 356 (384 x 384) cellules distribuées selon le même rapport de x et y que le raster en entrée. MEDIUM—L'analyse est effectuée sur un raster intermédiaire contenant 262 144 (512 x 512) cellules distribuées selon le même rapport de x et y que le raster en entrée. HIGH—L’analyse est effectuée sur un raster intermédiaire contenant 589 824 (768 x 768) cellules distribuées selon le même rapport de x et y que le raster en entrée. MAXIMUM—L'analyse porte sur toutes les cellules du raster en entrée.	String
selection_method (Facultatif)	Identifie la façon dont les régions sont sélectionnées. Les options disponibles sont les suivantes : AUTO—La méthode de sélection est basée sur le paramètre Nombre de régions. Si le paramètre Number of regions (Nombre de régions) est de huit ou moins, la méthode de sélection utilisée est la méthode Combinatorial. Si le paramètre Number of regions (Nombre de régions) est supérieur à huit, la méthode de sélection utilisée est la méthode Sequential. Il s’agit de l’option par défaut. COMBINATORIAL—Sélectionne les meilleures régions en fonction de la méthode d’évaluation spécifiée, tout en respectant les contraintes spatiales, en testant toutes les combinaisons du nombre de régions spatiales souhaitées au sein des régions candidates à partir de l’algorithme de croissance de région paramétrée. SEQUENTIAL—Sélectionne de façon séquentielle les meilleures régions en fonction de la méthode d'évaluation et qui répondent aux contraintes spatiales jusqu'à ce que le nombre souhaité de régions soit atteint.	String

Valeur renvoyée

Nom	Explication	Type de données
out_raster	Raster de régions en sortie. Chaque région est numérotée de manière unique avec des valeurs supérieures à zéro. Les cellules n'appartenant pas à une région sont définies sur zéro. La sortie est toujours un raster de type entier. D'autres champs sont calculés pour chaque région stockant des statistiques sur les régions sélectionnées. Ces champs sont les suivants : AVERAGE—Valeur d'utilité moyenne de la région. TOTAL—Somme totale des valeurs d'utilité de la région. MEDIAN—Valeur d'utilité médiane de la région. HIGHEST—Valeur de cellule individuelle la plus élevée contenue dans la région. LOWEST—Valeur de cellule individuelle la plus faible contenue dans la région. COREAREA—Zone principale. Toute cellule éloignée de plus d’une cellule de la limite de la région est considérée comme faisant partie de la zone principale. CORESUM—Somme cumulée des valeurs d'utilité de la zone principale. EDGE—Quantité de limites avec le rapport P1, qui est le rapport entre le périmètre de la forme et le périmètre d'un cercle de la même surface. Le rapport P1 d'un cercle est de 1.	Raster

Exemple de code

Exemple 1 d'utilisation de l'outil Localiser les régions (fenêtre Python)

Le script de fenêtre Python ci-dessous illustre l’utilisation de l’outil LocateRegions.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outRegions = LocateRegions("suitsurface", 13.5, "SQUARE_MILES", 5, "CIRCLE",
                           0, 50, "HIGHEST_AVERAGE_VALUE", 2, 5, 1, 3, "MILES",
                           "existingreg.shp", "EIGHT", "NO_ISLANDS", "SMALL", 
                           "LOW", "COMBINATORIAL")
outRegions.save("C:/sapyexamples/output/outregions")

Exemple 2 d'utilisation de l'outil Localiser les régions (script autonome)

Identifie les huit meilleures régions d'une surface d'aptitude qui respectent les exigences spatiales.

# Name: LocateRegions_Ex_02.py
# Description: Selects the best specified number of regions
# 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
InRaster1 = "suitsurface"
InTotalArea2 = 13.5
InAreaUnits3 = "SQUARE_MILES"
InNumberofRegions4 = 5
InRegionShape5 = "CIRCLE"
InRegionOrientation6 = 0
InShapeTradeoff7 = 50
InEvaluationMethod8 = "HIGHEST_AVERAGE_VALUE"
InMinimumArea9 = 2
InMaximumArea10 = 5
InMinimumDistance11 = 1
InMaximumDistance12 = 3
InDistanceUnits13 = "MILES"
InExistingRegions14 = "existingreg.shp"
InRegionofNeighbors15 = "EIGHT"
InRegionNoIslands16 = "NO_ISLANDS"
InRegionSeeds17 = "SMALL"
InRegionResolution18 = "LOW"
InCombinatorialThreshold19 = "COMBINATORIAL"

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

# Execute Locate Regions
outRegions = LocateRegions(InRaster1, InTotalArea2, InAreaUnits3, InNumberofRegions4,
                           InRegionShape5, InRegionOrientation6, InShapeTradeoff7,
                           InEvaluationMethod8, InMinimumArea9, InMaximumArea10,
                           InMinimumDistance11, InMaximumDistance12, InDistanceUnits13,
                           InExistingRegions14, InRegionofNeighbors15, InRegionNoIslands16,
                           InRegionSeeds17, InRegionResolution18, InCombinatorialThreshold19)

# Save the output
outRegions.save("C:/sapyexamples/output/outregions")

Environnements

Validation automatique, Taille de cellule, Méthode de projection de la taille de cellule, Compression, Espace de travail courant, Étendue, Transformations géographiques, Masque, Mot-clé CONFIG en sortie, Système de coordonnées en sortie, Statistiques raster, Espace de travail temporaire, Raster de capture, Taille de tuile