Recopilar eventos (Estadística espacial)

Resumen

Convierte datos de eventos, como incidentes de delitos o enfermedades, en datos de punto ponderado.

Ilustración

Ilustración de herramienta Recopilar eventos

Uso

  • Esta herramienta combina los puntos coincidentes. Crea un nuevo valor de Clase de entidad de salida que contiene las ubicaciones únicas que se encuentran en el valor Clase de entidad de entrada. A continuación, agrega un campo ICOUNT para guardar la suma de todos los incidentes en cada ubicación única.

  • Esta herramienta solo combina entidades que tienen exactamente las mismas coordenadas x e y del centroide. Puede utilizar la herramienta Integrar para alinear entre sí entidades cercanas antes de ejecutar esta herramienta.

    Precaución:

    La herramienta Integrar altera permanentemente la geometría de la entidad; haga siempre una copia de seguridad de la clase de entidad antes de utilizar la herramienta Integrar.

  • Las herramientas Análisis de punto caliente (Gi* de Getis-Ord), Análisis de clúster y de valor atípico (I de Moran local) y Autocorrelación espacial (I de Moran), por ejemplo, requieren puntos ponderados en lugar de incidentes individuales. Puede utilizar esta herramienta para crear ponderaciones cuando la clase de entidad de entrada contiene entidades coincidentes.

  • Si bien esta herramienta funciona con datos de polígonos o líneas, solo es adecuada para eventos, incidentes u otros datos de entidad de puntos. Para las entidades de línea y de polígono, la coincidencia de entidades se basa en los centroides geométricos verdaderos de entidad. Para multipunto, polilínea o polígonos con múltiples partes, el centroide se calcula utilizando el centro medio ponderado de todas las partes de entidad. La ponderación para las entidades de punto es 1, para las entidades de línea es longitud y para las entidades de polígono es área.

  • Si desea que cada punto individual o parte de datos multipunto o multiparte se trate como entidades de parte simple, ejecute la herramienta De multiparte a parte simple. A continuación, ejecute Capturar eventos en la clase de entidad de parte simple. Para obtener mas información, consulte Procesar datos de multipunto.

  • Además del valor de Clase de entidad de puntos ponderados de salida, esta herramienta pasa, como valores de salida derivados, el nombre del campo de recuento y el valor de recuento máximo que se encuentra para cualquier ubicación. Estos valores de salida derivados son útiles cuando utiliza esta herramienta en modelos o scripts.

Parámetros

EtiquetaExplicaciónTipo de datos
Entidades de incidentes de entrada

Las entidades que representan datos de eventos o incidentes.

Feature Layer
Clase de entidad de puntos ponderados de salida

La clase de entidad de salida que contendrá los datos de puntos ponderados.

Feature Class

Salida derivada

EtiquetaExplicaciónTipo de datos
Campo de resultados

El nombre del campo de recuento

Field
Valor Z máx.

El valor de recuento máximo que se encuentra para cualquier ubicación.

Double

arcpy.stats.CollectEvents(Input_Incident_Features, Output_Weighted_Point_Feature_Class)
NombreExplicaciónTipo de datos
Input_Incident_Features

Las entidades que representan datos de eventos o incidentes.

Feature Layer
Output_Weighted_Point_Feature_Class

La clase de entidad de salida que contendrá los datos de puntos ponderados.

Feature Class

Salida derivada

NombreExplicaciónTipo de datos
Results_Field

El nombre del campo de recuento

Field
Z_Max_Value

El valor de recuento máximo que se encuentra para cualquier ubicación.

Double

Muestra de código

Ejemplo 1 de CollectEvents (ventana de Python)

El siguiente script de la ventana de Python muestra cómo utilizar la función CollectEvents.

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

El siguiente script independiente de Python muestra cómo utilizar la función CollectEvents.


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

Entornos

Casos especiales

Sistema de coordenadas de salida

La geometría de entidades se proyecta al Sistema de coordenadas de salida antes del análisis. Todos los cálculos matemáticos se basan en la referencia espacial del Sistema de coordenadas de salida.