Ereignisse erfassen (Spatial Statistics Tools)

Zusammenfassung

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

Abbildung

Abbildung zum Werkzeug "Ereignisse erfassen"

Verwendung

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.

Achtung:

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

Abgeleitete Ausgabe

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

Abgeleitete Ausgabe

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

Codebeispiel

CollectEvents Beispiel 1 (Python-Fenster)

Das folgende Skript im Python-Fenster veranschaulicht, wie Sie die Funktion CollectEvents verwenden.

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

CollectEvents Beispiel 2 (eigenständiges Skript)

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())

Umgebungen

Ausgabe-Koordinatensystem, Geographische Transformationen, Aktueller Workspace, Scratch-Workspace, Ausgabe hat M-Werte, M-Auflösung, M-Toleranz, Ausgabe hat Z-Werte, Standard-Ausgabe-Z-Werte, Z-Auflösung, Z-Toleranz, XY-Auflösung, XY-Toleranz

Sonderfälle

Ausgabe-Koordinatensystem: Feature geometry is projected to the Output Coordinate System prior to analysis. All mathematical computations are based on the Output Coordinate System spatial reference.

Lizenzierungsinformationen

Basic: Ja
Standard: Ja
Advanced: Ja

Ereignisse erfassen (Spatial Statistics Tools)

Zusammenfassung

Abbildung

Verwendung

Achtung:

Parameter

Abgeleitete Ausgabe

Umgebungen

Sonderfälle

Lizenzierungsinformationen

Verwandte Themen