Собрать события (Пространственная статистика)

Краткая информация

Конвертирует данные о событиях, такие как преступления или случаи заболеваний, во взвешенные точечные данные.

Иллюстрация

Иллюстрация инструмента Собрать события

Использование

  • Этот инструмент комбинирует совпадающие точки. Он создает новое значение Выходного класса объектов, который содержит уникальные местоположения, найденные в значении Входного класса объектов. Затем он добавляет поле с именем ICOUNT, чтобы хранить сумму всех инцидентов в каждом уникальном местоположении.

  • Инструмент объединяет только те объекты, которые имеют в точности одинаковые координаты X и Y центроида. Можно использовать инструмент Интегрировать для замыкания ближайших объектов друг на друга перед запуском этого инструмента.

    Внимание:

    Инструмент Интегрировать навсегда изменяет геометрию объектов; следует всегда делать резервную копию класса пространственных объектов перед запуском инструмента Интегрировать.

  • Инструменты Анализ горячих точек (Getis-Ord Gi*), Анализ кластеров и выбросов (Локальный индекс I Морана) и Пространственная автокорреляция (Общий индекс I Морана), например, требуют взвешенные точки, а не точки отдельных инцидентов. Этот инструмент можно использовать для создания весов, когда входной класс объектов содержит совпадающие объекты.

  • Хотя этот инструмент работает с полигональными или линейными данными, он подходит только для событий, случаев и других точечных данных. Для линейных и полигональных объектов, совпадение объектов основано для совпадения геометрических центроидов объектов. Для мультиточек, полилиний или полигонов, состоящих их нескольких частей, центроиды рассчитываются как средневзвешенное среднее значение центра всех частей объекта. При определении весов точечные объекты имеют равный вес (1). Для линейных объектов это длина сегмента. Для полигональных – площадь.

  • Если вы хотите, чтобы каждая отдельная точка или часть мультиточечных или составные данных рассматривались как простой объект (из одной части), запустите инструмент Составной в простые. Затем запустите инструмент Собрать события для класса простых объектов. Дополнительная информация приведена в разделе Обработка данных мультиточек.

  • В дополнение к значению Выходной класс объектов взвешенных точек, этот инструмент выводит, как производные выходные значения, имя поля количества и значение максимального количества на одно местоположение. Эти полученные выходные значения очень применяются, когда вы используете этот инструмент в моделях или скриптах.

Параметры

ПодписьОписаниеТип данных
Входные объекты событий

Объекты, отражающие данные о событиях или случайные данные.

Feature Layer
Выходной класс взвешенных точечных объектов

Выходной класс объектов, который содержит взвешенные точечные данные.

Feature Class

Производные выходные данные

ПодписьОписаниеТип данных
Поле результатов

Имя поля количества

Field
Значение Z Max

Значение максимального количества, возможного для одной локации.

Double

arcpy.stats.CollectEvents(Input_Incident_Features, Output_Weighted_Point_Feature_Class)
ИмяОписаниеТип данных
Input_Incident_Features

Объекты, отражающие данные о событиях или случайные данные.

Feature Layer
Output_Weighted_Point_Feature_Class

Выходной класс объектов, который содержит взвешенные точечные данные.

Feature Class

Производные выходные данные

ИмяОписаниеТип данных
Results_Field

Имя поля количества

Field
Z_Max_Value

Значение максимального количества, возможного для одной локации.

Double

Пример кода

CollectEvents, пример 1 (окно Python)

Пример скрипта в окне Python для использования функции CollectEvents.

import arcpy
arcpy.env.workspace = "C:/Data"
arcpy.stats.CollectEvents("911Copied.shp", "911Count.shp")
CollectEvents, пример 2 (автономный скрипт)

Следующий автономный Python скрипт демонстрирует, как использовать функцию 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())

Параметры среды

Особые случаи

Выходная система координат

До начала анализа геометрия пространственных объектов проецируется в Выходную систему координат. Во всех математических вычислениях учитывается пространственная привязка Выходной системы координат.