Конвертирует данные о событиях, такие как преступления или случаи заболеваний, во взвешенные точечные данные.
Этот инструмент комбинирует совпадающие точки. Он создает новое значение Выходного класса объектов, который содержит уникальные местоположения, найденные в значении Входного класса объектов. Затем он добавляет поле с именем 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 |
Пример скрипта в окне Python для использования функции CollectEvents.
import arcpy
arcpy.env.workspace = "C:/Data"
arcpy.stats.CollectEvents("911Copied.shp", "911Count.shp")Следующий автономный 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())До начала анализа геометрия пространственных объектов проецируется в Выходную систему координат. Во всех математических вычислениях учитывается пространственная привязка Выходной системы координат.