Ereignisse erfassen (Räumliche Statistiken)

Zusammenfassung

Konvertiert Ereignisdaten, z. B. Daten zu Verbrechen oder Krankheiten, in gewichtete Punktdaten.

Bild

Verwendung

• Mit "Ereignisse erfassen" werden zwei lagegleiche Punkte kombiniert: Es wird eine neue Ausgabe-Feature-Class erstellt, die alle eindeutigen, in der Eingabe-Feature-Class gefundenen Positionen enthält. Dann wird das Feld ICOUNT hinzugefügt, das die Summe aller Ereignisse an jeder eindeutigen Position enthält.

• Dieses Werkzeug kann nur Features kombinieren, die über exakt die gleichen X- und Y-Schwerpunktkoordinaten verfügen. Sie haben daher die Möglichkeit, vor der Ausführung des Werkzeugs "Ereignisse erfassen" nahegelegene Features mit dem Werkzeug Integrieren aneinander zu fangen.

  Achtung:

  Mit dem Werkzeug Integrieren wird die Feature-Geometrie dauerhaft geändert; erstellen Sie daher vor der Verwendung von Integrieren immer eine Sicherungskopie Ihrer 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. Mit "Ereignisse erfassen" können Gewichtungen erstellt werden, wenn die Eingabe-Feature-Class lagegleiche Features enthält.

• Dieses Werkzeug wurde eigentlich speziell für Ereignisdaten oder andere Feature-Daten mit festen Punkten konzipiert; es kann jedoch auch für Polygon- oder Liniendaten eingesetzt werden. 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 jeder einzelne Punkt/jedes einzelne Teil von Multipoint-/Multipart-Daten als Singlepart-Feature behandelt werden soll, führen Sie das Werkzeug Multipart in Singlepart aus und dann für die Singlepart-Feature-Class das Werkzeug Ereignisse erfassen. Unter Verarbeiten von Multipoint-Daten erhalten Sie weitere Informationen.

• Zusätzlich zur Ausgabe-Feature-Class übergibt diese Funktion 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.

• Wenn dieses Werkzeug in ArcMap ausgeführt wird, wird dem Inhaltsverzeichnis die Ausgabe-Feature-Class mit Standard-Rendering für das ICOUNT-Feld automatisch hinzugefügt. Das Schema für das abgestufte Kreis-Rendering wird durch eine Layer-Datei in <ArcGIS>/ArcToolbox/Templates/Layers definiert. Sie können das Standard-Rendering nach Bedarf erneut anwenden, indem Sie die Vorlagen-Layer-Symbologie importieren.

Syntax

CollectEvents_stats (Input_Incident_Features, Output_Weighted_Point_Feature_Class)

Parameter	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

Codebeispiel

Ereignisse erfassen – Beispiel (Python-Fenster)

Das folgende Skript im Python-Fenster veranschaulicht, wie das Werkzeug "Ereignisse erfassen" verwendet wird.

import arcpy
arcpy.env.workspace = "C:/Data"
arcpy.CollectEvents_stats("911Copied.shp", "911Count.shp", "Count", "#")

Ereignisse erfassen – Beispiel (eigenständiges Python-Skript)

Das folgende eigenständige Python-Skript veranschaulicht, wie das Werkzeug "Ereignisse erfassen" verwendet wird.

# 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 geoprocessor object property to overwrite existing output, by default
arcpy.gp.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.CopyFeatures_management("911Calls.shp", "911Copied.shp",
                         "#", 0, 0, 0)

    integrate = arcpy.Integrate_management("911Copied.shp #", "500 Feet")

    # Use Collect Events to count the number of calls at each location
    # Process: Collect Events
    ce = arcpy.CollectEvents_stats("911Copied.shp", "911Count.shp", "Count", "#")

    # Add a unique ID field to the count feature class
    # Process: Add Field and Calculate Field
    af = arcpy.AddField_management("911Count.shp", "MyID", "LONG", "#", "#", "#", "#",
                     "NON_NULLABLE", "NON_REQUIRED", "#",
                     "911Count.shp")
    
    cf = arcpy.CalculateField_management("911Count.shp", "MyID", "[FID]", "VB")

    # Create Spatial Weights Matrix for Calculations
    # Process: Generate Spatial Weights Matrix... 
    swm = arcpy.GenerateSpatialWeightsMatrix_stats("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.HotSpots_stats("911Count.shp", "ICOUNT", "911HotSpots.shp", 
                     "GET_SPATIAL_WEIGHTS_FROM_FILE",
                     "EUCLIDEAN_DISTANCE", "NONE",
                     "#", "#", "euclidean6Neighs.swm")

except:
    # If an error occurred when running the tool, print out the error message.
    print arcpy.GetMessages()

Umgebung

Current Workspace, Scratch Workspace, Output Coordinate System, Output has Z values, Default Output Z Value, Output has M values

Lizenzierungsinformationen

ArcGIS for Desktop Basic: Ja

ArcGIS for Desktop Standard: Ja

ArcGIS for Desktop Advanced: Ja