| Étiquette | Explication | Type de données |
Entités ponctuelles 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 Prédiction de la régression EBK, vous devez préserver la cohérence entre ce paramètre et l’environnement Points coïncidents de l’outil Prédiction de la régression EBK. Si ce paramètre est désactivé, il se peut que les polygones de la classe d’entités en sortie se superposent.
| Boolean |
Disponible avec une licence Geostatistical Analyst.
Synthèse
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 minimum et maximum 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
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 Prédiction de la régression EBK. L’algorithme de sous-ensembles par défaut de 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 Agrégation de la boîte à outils 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 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 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 É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ême 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.
Paramètres
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 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 Points coïncidents de l’outil Prédiction de la régression EBK. Si COINCIDENT_ALL est sélectionné, vos polygones Out_feature_class peuvent se superposer.
| Boolean |
Exemple de code
Regroupe un ensemble de points dans des sous-ensembles surfaciques.
arcpy.ga.GenerateSubsetPolygons("myPoints","polygonSubsets",20,30,"COINCIDENT_SINGLE")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
# Author: Esri
# 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"
# Check out the ArcGIS Geostatistical Analyst extension license
arcpy.CheckOutExtension("GeoStats")
# Execute GenerateSubsetPolygons
arcpy.ga.GenerateSubsetPolygons(inPoints, outFeatureClass, minPoints, maxPoints, coincidentPoints)Environnements
Informations de licence
- Basic: Nécessite Geostatistical Analyst
- Standard: Nécessite Geostatistical Analyst
- Advanced: Nécessite Geostatistical Analyst
Rubriques connexes
Vous avez un commentaire à formuler concernant cette rubrique ?