| Beschriftung | Erläuterung | Datentyp |
Eingabe-Punkt-Features | Die Punkte, die in Teilmengen gruppiert werden sollen. | Feature Layer |
Ausgabe-Feature-Class | Die Polygone, die die Region einer Teilmenge definieren. Alle Punkte innerhalb eines Polygon-Features werden als Teil derselben Teilmenge behandelt. Die Polygon-Feature-Class enthält ein Feld mit dem Namen PointCount, in dem die Anzahl der Punkte, die in jeder Polygon-Teilmenge enthalten sind, gespeichert wird. | Feature Class |
Minimale Anzahl von Punkten pro Teilmenge (optional) | Die minimale Anzahl der Punkte, die in eine Teilmenge gruppiert betrachtet können. Alle Teilmengen-Polygone enthalten dann Punkte in mindestens dieser Anzahl. | Long |
Maximale Anzahl von Punkten pro Teilmenge (optional) | Die maximale Anzahl der Punkte, die in eine Teilmenge gruppiert betrachtet können. Ungeachtet der angegebenen maximalen Anzahl enthält jede Teilmenge immer weniger als das Zweifache der in Minimale Anzahl von Punkten pro Teilmenge angegebenen Anzahl. Dies ist die Folge der Tatsache, dass eine Teilmenge, die das Zweifache der minimalen Anzahl der Punkte oder mehr enthält, immer in zwei oder mehr neue Teilmengen geteilt wird. | Long |
Lagegleiche Punkte als einen Punkt behandeln (optional) | Gibt an, ob lagegleiche Punkte (Punkte, die sich an derselben Position befinden) wie ein Einzelpunkt oder als mehrere einzelne Punkte behandelt werden. Wenn Sie die Teilmengen-Polygone als Teilmengenpolygon-Features in Regressionsvorhersage mit EBK verwenden möchten, dann sollten Sie unbedingt auf Konsistenz zwischen diesem Parameter und der Umgebung Lagegleiche Punkte in Regressionsvorhersage mit EBK achten. Wenn dieser Parameter deaktiviert ist, dann können Ihre Ausgabe-Feature-Class-Polygone einander überlappen.
| Boolean |
Mit der Geostatistical Analyst-Lizenz verfügbar.
Zusammenfassung
Generiert aus Eingabepunkten einander nicht überlappende Teilmengenpolygon-Features. Das Ziel besteht darin, die Punkte in kompakte, nicht überlappende Teile aufzuteilen und Polygon-Regionen um jede Teilmenge aus Punkten zu erstellen. Die minimale und die maximale Anzahl der Punkte in jeder Teilmenge kann gesteuert werden.
Der Prozess zum Generieren von Teilmengenpolygon-Features beginnt, indem alle Punkte mit einer linearen Kurve verbunden werden und diese Kurve in Segmente zerschnitten wird. Diese Segmente werden so ausgewählt, dass die Gesamtsumme der Quadrate der einzelnen Entfernungen vom Mittelpunkt des Segments zu jedem Punkt im Segment minimal ist und die minimale und die maximale Anzahl der Punkte, die in jeder Teilmenge enthalten sein dürfen, eingehalten werden. Danach werden alle Überlappungen zwischen den Segmenten entfernt und neue Segmente erstellt. Segmentierung und Entfernung der Überlappungen werden wiederholt, bis keine Überlappung mehr vorhanden ist. Danach sind alle Punkte in einem Segment Bestandteil derselben Teilmenge. Danach werden Thiessen-Polygone für die Eingabepunkte generiert und alle Thiessen-Polygone, die derselben Teilmenge angehören, in ein einzelnes Polygon-Feature zusammengeführt.
Abbildung
Verwendung
Hauptsächlich dient dieses Werkzeug zum Erstellen von Polygonen, die als Teilmengenpolygon-Features in Regressionsvorhersage mit EBK verwendet werden können. Der Standardalgorithmus der Teilmengenbildung in Regressionsvorhersage mit EBK erstellt Teilmengen, die einander überlappen. Wenn Sie jedoch Teilmengen benötigen, die einander nicht überlappen, dann können Sie diese Teilmengen mit diesem Werkzeug erstellen.
Dieses Werkzeug ähnelt konzeptionell den Werkzeugen im Toolset Cluster-Bildung der Toolbox Space Time Pattern Mining. Der Hauptunterschied besteht darin, dass die dortigen Werkzeuge Punkt-Cluster erstellen, indem jedem Mitglied eines Clusters eindeutige ID-Werte zugewiesen werden, während dieses Werkzeug Teilmengen definiert, indem Polygon-Teilmengenregionen um die Punkte in jeder Teilmenge erstellt werden. Dieser Unterschied liegt darin begründet, dass Regressionsvorhersage mit EBK Teilmengen benötigt, die nach Polygonregionen definiert wurden.
Berücksichtigen Sie die Anzahl der Eingabe-Punkt-Features, wenn Sie die Minimale Anzahl von Punkten pro Teilmenge und die Maximale Anzahl von Punkten pro Teilmenge auswählen. Wenn die angegebene minimale und maximale Anzahl der Punkte durch die Anzahl der Eingabepunkte nicht berücksichtigt werden kann, dann wird während der Werkzeugausführung ein Fehler ausgegeben. Wenn zum Beispiel zehn Punkte vorhanden sind und Sie ein Minimum von sechs Punkten und ein Maximum von sieben Punkten pro Teilmenge anfordern, dann erhalten Sie eine Fehlermeldung. Der Grund dafür liegt darin, dass es keine Möglichkeit gibt, zehn Punkte in Teilmengen der Größe sechs oder sieben zu teilen.
Als Standard-Ausgabeausdehnung der Ausgabe-Feature-Class wird die Ausdehnung der Eingabe-Punkt-Features mit einem 10-Prozent-Puffer verwendet. Mit diesem Puffer wird sichergestellt, dass standardmäßig alle Eingabepunkte innerhalb der Ausgabe-Polygone liegen. Wenn eine Umgebung für die Ausgabeausdehnung angegeben wurde, wird sie nicht gepuffert.
Die Berechnung von Eingabe-Punkt-Features in einem geographischen Koordinatensystem (GCS) dauert um ein Mehrfaches länger als die Berechnung derselben Punkte in einem projizierten Koordinatensystem (PCS). Das liegt daran, dass Daten in geographischen Koordinaten basierend auf ihren Positionen auf der Erdoberfläche gruppiert werden und nicht basierend auf ihren Positionen auf einer Karte, die auf eine Ebene projiziert wurde. Wenn Ihre Eingabepunkte in einem kleinen Bereich enthalten sind, dann sollten Sie Ihre Daten projizieren, bevor Sie dieses Werkzeug verwenden.
Parameter
arcpy.ga.GenerateSubsetPolygons(in_point_features, out_feature_class, {min_points_per_subset}, {max_points_per_subset}, {coincident_points})| Name | Erläuterung | Datentyp |
in_point_features | Die Punkte, die in Teilmengen gruppiert werden sollen. | Feature Layer |
out_feature_class | Die Polygone, die die Region einer Teilmenge definieren. Alle Punkte innerhalb eines Polygon-Features werden als Teil derselben Teilmenge behandelt. Die Polygon-Feature-Class enthält ein Feld mit dem Namen PointCount, in dem die Anzahl der Punkte, die in jeder Polygon-Teilmenge enthalten sind, gespeichert wird. | Feature Class |
min_points_per_subset (optional) | Die minimale Anzahl der Punkte, die in eine Teilmenge gruppiert betrachtet können. Alle Teilmengen-Polygone enthalten dann Punkte in mindestens dieser Anzahl. | Long |
max_points_per_subset (optional) | Die maximale Anzahl der Punkte, die in eine Teilmenge gruppiert betrachtet können. Ungeachtet der angegebenen maximalen Anzahl enthält jede Teilmenge immer weniger als das Zweifache der in min_points_per_subset angegebenen Anzahl. Dies ist die Folge der Tatsache, dass eine Teilmenge, die das Zweifache der minimalen Anzahl der Punkte oder mehr enthält, immer in zwei oder mehr neue Teilmengen geteilt wird. | Long |
coincident_points (optional) | Gibt an, ob lagegleiche Punkte (Punkte, die sich an derselben Position befinden) wie ein Einzelpunkt oder als mehrere einzelne Punkte behandelt werden. Wenn Sie die Teilmengen-Polygone als Teilmengenpolygon-Features in Regressionsvorhersage mit EBK verwenden möchten, dann sollten Sie unbedingt auf Konsistenz zwischen diesem Parameter und Ihrer Auswahl für die Umgebung Lagegleiche Punkte in Regressionsvorhersage mit EBK achten. Wenn COINCIDENT_ALL ausgewählt ist, dann können Ihre Out_feature_class-Polygone einander überlappen.
| Boolean |
Codebeispiel
Gruppieren von Punkten in Polygon-Teilmengen.
arcpy.ga.GenerateSubsetPolygons("myPoints","polygonSubsets",20,30,"COINCIDENT_SINGLE")Gruppieren von Punkten in Polygon-Teilmengen.
# 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)Umgebungen
Lizenzinformationen
- Basic: Erfordert Geostatistical Analyst
- Standard: Erfordert Geostatistical Analyst
- Advanced: Erfordert Geostatistical Analyst