Générer des sous-ensembles de polygones (Outils Geostatistical Analyst)

Résumé

Génère un sous-ensemble d’entités surfaciques non superposées à partir d’un ensemble de points en entrée. Cela permet de diviser les points en sous-ensembles compacts non superposés et de créer des régions surfaciques autour de chaque sous-ensemble de points. Il est possible de contrôler les nombres minimal et maximal de points de chaque sous-ensemble.

Le processus de génération des sous-ensembles d’entités surfaciques commence par la connexion de tous les points à une courbe linéaire et le découpage de cette courbe en segments. Ces segments sont sélectionnés pour minimiser la distance au carré totale séparant le centre du segment de chaque point du segment en tenant compte des nombres minimum et maximum de points autorisés dans chaque sous-ensemble. Toute superposition de segments est ensuite retirée et de nouveaux segments sont créés. Après plusieurs itérations de segmentation et de retrait des superpositions, aucune superposition ne subsiste. Tous les points de chaque segment est reconnu comme faisant partie du même sous-ensemble. Des polygones de Thiessen sont ensuite générés à partir des points en entrée. Tous les polygones de Thiessen appartenant au même sous-ensemble sont ensuite fusionnés en une seule entité surfacique.

Illustration

Points (à gauche) regroupés en sous-ensembles surfaciques de taille similaire (à droite)

Utilisation

L’objectif principal de cet outil consiste à créer des polygones destinés à être utilisés comme sous-ensembles d’entités surfaciques dans l’outil EBK Regression Prediction (Prédiction de la régression EBK). L’algorithme de sous-ensembles par défaut de EBK Regression Prediction (Prédiction de la régression EBK) crée des sous-ensembles qui se superposent les uns aux autres. Néanmoins, s’il est nécessaire que les sous-ensembles ne se superposent pas, cet outil est capable de les créer.
D’un point de vue conceptuel, cet outil est similaire aux outils Clustering (Agrégation) de la boîte à outils Space Time Pattern Mining (Exploration des modèles spatio-temporels). La principale différence réside dans le fait que ces outils créent des agrégats de points en attribuant des valeurs d’identifiant unique à chaque membre de l’agrégat alors que le présent outil définit les sous-ensembles en créant des régions de sous-ensembles surfaciques autour des points de chaque sous-ensemble. Cette différence s’explique par le fait que l’outil EBK Regression Prediction (Prédiction de la régression EBK) a besoin que des sous-ensembles soient définis par les régions surfaciques.
Tenez compte du nombre d’entités ponctuelles en entrée lors de la sélection du nombre minimal de points par sous-ensemble et du nombre maximal de points par sous-ensemble. Si le nombre de points en entrée ne parvient pas à respecter le nombre minimal et le nombre maximal, une erreur est générée lors de l’exécution de l’outil. Si, par exemple, vous possédez dix points et que vous demandez un minimum de six points par sous-ensemble et un maximum de sept points par sous-ensemble, vous recevrez une erreur. En effet, il est impossible de diviser dix points en sous-ensembles de six ou sept points.
L’étendue en sortie par défaut de la classe d’entités en sortie correspond à l’étendue des entités ponctuelles en entrée avec une zone tampon de 10 pour cent. La création de cette zone tampon assure que tous les points en entrée se trouveront à l’intérieur des polygones en sortie par défaut. Si un environnement Output extent (Étendue en sortie) est fourni, il n’est pas assorti d’une zone tampon.
Le calcul des entités ponctuelles en entrée figurant dans un système de coordonnées géographiques (GCS) est plus long que le calcul pour ces mêmes points dans un système de coordonnées projetées (PCS). Cela s’explique par le fait que les données avec des coordonnées géographiques sont regroupées en fonction de leur localisation terrestre plutôt que leur emplacement sur une carte plane projetée. Si vos points en entrée sont compris dans une petite zone, il est recommandé de projeter vos données avant d’utiliser cet outil.

Etiqueter	Explication	Type de données
Entités points en entrée	Points qui seront regroupés en sous-ensembles.	Feature Layer
Classe d'entités en sortie	Polygones définissant la région de chaque sous-ensemble. Tous les points se trouvant dans une entité surfacique donnée sont considérés comme faisant partie du même sous-ensemble. La classe d’entités surfaciques contiendra un champ nommé `PointCount` qui stockera le nombre de points contenus dans chaque sous-ensemble surfacique.	Feature Class
Nombre minimal de points par sous-ensemble (Facultatif)	Nombre minimal de points pouvant être rassemblés dans un sous-ensemble. Tous les sous-ensembles de polygones contiennent au moins autant de points.	Long
Nombre maximal de points par sous-ensemble (Facultatif)	Nombre maximal de points pouvant être rassemblés dans un sous-ensemble. Chaque sous-ensemble contient toujours moins de deux fois le nombre minimal de points par sous-ensemble quel que soit le nombre maximal indiqué. En effet, si un sous-ensemble contient, au moins, deux fois le nombre minimal de points, il sera toujours divisé en deux sous-ensembles, voire davantage.	Long
Traiter les points coïncidents comme un point unique (Facultatif)	Spécifie si les points coïncidents (points situés à la même localisation) sont traités comme un point unique ou comme des points individuels. Si vous avez l’intension d’utiliser les sous-ensembles de polygones en tant que sous-ensemble d’entités surfaciques dans l’outil EBK Regression Prediction (Prédiction de la régression EBK), vous devez préserver la cohérence entre ce paramètre et votre choix en matière d’environnement Coincident points (Points coïncidents) de l’outil EBK Regression Prediction (Prédiction de la régression EBK). Si ce paramètre est activé, il se peut que les polygones en sortie se superposent. Activé—Les points coïncidents sont traités comme un point unique lors de la création des sous-ensembles. Il s’agit de l’option par défaut. Décoché—Les points coïncidents sont traités comme des points différents lors de la création des sous-ensembles.	Boolean

arcpy.ga.GenerateSubsetPolygons(in_point_features, out_feature_class, {min_points_per_subset}, {max_points_per_subset}, {coincident_points})

Nom	Explication	Type de données
in_point_features	Points qui seront regroupés en sous-ensembles.	Feature Layer
out_feature_class	Polygones définissant la région de chaque sous-ensemble. Tous les points se trouvant dans une entité surfacique donnée sont considérés comme faisant partie du même sous-ensemble. La classe d’entités surfaciques contiendra un champ nommé `PointCount` qui stockera le nombre de points contenus dans chaque sous-ensemble surfacique.	Feature Class
min_points_per_subset (Facultatif)	Nombre minimal de points pouvant être rassemblés dans un sous-ensemble. Tous les sous-ensembles de polygones contiennent au moins autant de points.	Long
max_points_per_subset (Facultatif)	Nombre maximal de points pouvant être rassemblés dans un sous-ensemble. Chaque sous-ensemble contient toujours moins de deux fois le `min_points_per_subset` quel que soit le nombre maximal indiqué. En effet, si un sous-ensemble contient, au moins, deux fois le nombre minimal de points, il sera toujours divisé en deux sous-ensembles, voire davantage.	Long
coincident_points (Facultatif)	Spécifie si les points coïncidents (points situés à la même localisation) sont traités comme un point unique ou comme des points individuels. Si vous avez l’intension d’utiliser les sous-ensembles de polygones en tant que sous-ensemble d’entités surfaciques dans l’outil EBK Regression Prediction (Prédiction de la régression EBK), vous devez préserver la cohérence entre ce paramètre et votre choix en matière d’environnement Coincident points (Points coïncidents) de l’outil EBK Regression Prediction (Prédiction de la régression EBK). Si `COINCIDENT_ALL` est choisi, il se peut que les polygones en sortie se superposent. `COINCIDENT_SINGLE`—Les points coïncidents sont traités comme un point unique lors de la création des sous-ensembles. Il s’agit de l’option par défaut. `COINCIDENT_ALL`—Les points coïncidents sont traités comme des points différents lors de la création des sous-ensembles.	Boolean

Exemple de code

Exemple 1 d’utilisation de l’outil GenerateSubsetPolygons (fenêtre Python)

Regroupe un ensemble de points dans des sous-ensembles surfaciques.

arcpy.ga.GenerateSubsetPolygons("myPoints", "polygonSubsets", 20, 30, "COINCIDENT_SINGLE")

Exemple 2 d’utilisation de l’outil GenerateSubsetPolygons (script autonome)

Regroupe un ensemble de points dans des sous-ensembles surfaciques.

# Name: GenerateSubsetPolygons_Example_02.py
# Description: Groups points into polygon subsets of a similar size.
# Requirements: Geostatistical Analyst extension

# Import system modules
import arcpy

# Set local variables
inPoints = "C:/gapyexamples/input/myPoints.shp"
outFeatureClass = "C:/gapyexamples/output/myPolygons.shp"
minPoints = 50
maxPoints = 75
coincidentPoints = "COINCIDENT_ALL"

# Run GenerateSubsetPolygons
arcpy.ga.GenerateSubsetPolygons(inPoints, outFeatureClass, minPoints, maxPoints, coincidentPoints)

Environnements

Espace de travail courant, Etendue, Transformations géographiques, Système de coordonnées en sortie, Facteur de traitement parallèle, Espace de travail temporaire

Informations de licence

Basic: Nécessite Geostatistical Analyst
Standard: Nécessite Geostatistical Analyst
Advanced: Nécessite Geostatistical Analyst