Konvertiert Ereignisdaten, z. B. Daten zu Verbrechen oder Krankheiten, in gewichtete Punktdaten.
Mit diesem Werkzeug werden lagegleiche Punkte kombiniert. Dabei wird ein neuer Wert für Ausgabe-Feature-Class erstellt, der die im Wert Eingabe-Feature-Class gefundenen eindeutigen Positionen enthält. Dann wird das Feld ICOUNT hinzugefügt, das für jede eindeutige Position die Summe aller Ereignisse enthält.
Dieses Werkzeug kann nur Features kombinieren, die über exakt die gleichen X- und Y-Schwerpunktkoordinaten verfügen. Sie können vor der Ausführung dieses Werkzeugs das Werkzeug Integrieren verwenden, um nahegelegene Features aneinander zu fangen.
Mit dem Werkzeug Integrieren wird die Feature-Geometrie dauerhaft geändert; erstellen Sie daher vor der Verwendung von Integrieren immer eine Sicherungskopie der Feature-Class.
Die Werkzeuge Hot-Spot-Analyse (Getis-Ord Gi*), Cluster- und Ausreißeranalyse (Anselin Local Morans I) und Räumliche Autokorrelation (Morans I) erfordern beispielsweise gewichtete Punkte anstatt einzelne Ereignisse. Sie können mit diesem Werkzeug Gewichtungen erstellen, wenn die Eingabe-Feature-Class lagegleiche Features enthält.
Obwohl dieses Werkzeug mit Polygon- oder Liniendaten ausgeführt werden kann, wurde es nur für Ereignisdaten und andere Punkt-Feature-Daten konzipiert. Bei Linien- und Polygon-Features basiert die Feature-Übereinstimmung auf den echten geometrischen Schwerpunkten der Features. Bei Multipoints, Polylinien oder mehrteiligen Polygonen wird der Schwerpunkt mithilfe des gewichteten arithmetischen Mittelpunktes aller Feature-Teile berechnet. Die Gewichtung für Punkt-Features ist 1, für Linien-Features "Länge" und für Polygon-Features "Fläche".
Wenn die einzelnen Punkte oder Teilelemente von Multipoint- oder Multipart-Daten als Singlepart-Features behandelt werden sollen, führen Sie das Werkzeug Multipart in Singlepart aus. Führen Sie dann für die Singlepart-Feature-Class das Werkzeug Ereignisse erfassen aus. Unter Verarbeiten von Multipoint-Daten erhalten Sie weitere Informationen.
Zusätzlich zum Wert unter Ausgabe-Weighted-Point-Feature-Class übergibt dieses Werkzeug für jede Position den Namen des Zählfeldes und den maximalen Zählwert als abgeleitete Ausgabewerte. Diese abgeleiteten Ausgabewerte sind hilfreich, wenn Sie dieses Werkzeug in Modellen oder Skripten einsetzen.
| Beschriftung | Erläuterung | Datentyp |
Eingabe-Ereignis-Features | Die Features, die Ereignisdaten darstellen. | Feature Layer |
Ausgabe-Weighted-Point-Feature-Class | Die Ausgabe-Feature-Class, die die gewichteten Punktdaten enthalten soll. | Feature Class |
| Beschriftung | Erläuterung | Datentyp |
| Ergebnisfeld | Der Name des Zählfeldes | Field |
| Z Max-Wert | Der Wert der maximalen Anzahl für eine beliebige Position. | Double |
arcpy.stats.CollectEvents(Input_Incident_Features, Output_Weighted_Point_Feature_Class)
| Name | Erläuterung | Datentyp |
Input_Incident_Features | Die Features, die Ereignisdaten darstellen. | Feature Layer |
Output_Weighted_Point_Feature_Class | Die Ausgabe-Feature-Class, die die gewichteten Punktdaten enthalten soll. | Feature Class |
| Name | Erläuterung | Datentyp |
| Results_Field | Der Name des Zählfeldes | Field |
| Z_Max_Value | Der Wert der maximalen Anzahl für eine beliebige Position. | Double |
Das folgende Skript für das Python-Fenster veranschaulicht, wie Sie die Funktion CollectEvents verwenden.
import arcpy
arcpy.env.workspace = "C:/Data"
arcpy.stats.CollectEvents("911Copied.shp", "911Count.shp")Im folgenden eigenständigen Python-Skript wird veranschaulicht, wie Sie die Funktion CollectEvents verwenden.
# Analyze the spatial distribution of 911 calls in a metropolitan area
# using the Hot-Spot Analysis Tool (Local Gi*)
# Import system modules
import arcpy
# Set property to overwrite existing output, by default
arcpy.env.overwriteOutput = True
# Local variables...
workspace = "C:/Data"
try:
# Set the current workspace (to avoid having to specify the full
# path to the feature classes each time)
arcpy.env.workspace = workspace
# Copy the input feature class and integrate the points to snap
# together at 500 feet
# Process: Copy Features and Integrate
cf = arcpy.management.CopyFeatures("911Calls.shp", "911Copied.shp")
integrate = arcpy.management.Integrate("911Copied.shp #", "500 Feet")
# Use Collect Events to count the number of calls at each location
# Process: Collect Events
ce = arcpy.stats.CollectEvents("911Copied.shp", "911Count.shp")
# Add a unique ID field to the count feature class
# Process: Add Field and Calculate Field
af = arcpy.management.AddField("911Count.shp", "MyID", "LONG", "#",
"#", "#", "#", "NON_NULLABLE", "NON_REQUIRED", "#",
"911Count.shp")
cf = arcpy.management.CalculateField("911Count.shp", "MyID",
"!FID!", "PYTHON")
# Create Spatial Weights Matrix for Calculations
# Process: Generate Spatial Weights Matrix...
swm = arcpy.stats.GenerateSpatialWeightsMatrix("911Count.shp", "MYID",
"euclidean6Neighs.swm",
"K_NEAREST_NEIGHBORS",
"#", "#", "#", 6,
"NO_STANDARDIZATION")
# Hot Spot Analysis of 911 Calls
# Process: Hot Spot Analysis (Getis-Ord Gi*)
hs = arcpy.stats.HotSpots("911Count.shp", "ICOUNT", "911HotSpots.shp",
"GET_SPATIAL_WEIGHTS_FROM_FILE",
"EUCLIDEAN_DISTANCE", "NONE",
"#", "#", "euclidean6Neighs.swm")
except arcpy.ExecuteError:
# If an error occurred when running the tool, print the error message.
print(arcpy.GetMessages())Die Feature-Geometrie wird vor der Analyse auf das Ausgabe-Koordinatensystem projiziert. Alle mathematischen Berechnungen basieren auf dem Raumbezug des Ausgabe-Koordinatensystems.