Подпись | Описание | Тип данных |
Точечный слой | Точечные объекты, которые будут агрегированы в полигоны или бины. | Feature Layer |
Выходной класс пространственных объектов | Новый класс пространственных объектов с агрегированными полигонами. | Feature Class |
Полигон или Бин | Задает, как будет агрегироваться значение параметра Точечный слой.
| String |
Полигональный слой (Дополнительный) | Класс полигональных объектов, в пределах которых будут агрегированы входные точки. | Feature Layer |
Тип бина (Дополнительный) | Задает форму бинов, сгенерированных для хранения агрегированных точек.
| String |
Размер бина (Дополнительный) | Единицы измерения и интервал расстояния, определяющий размер бинов в границах которых будет агрегирован Точечный слой. Интервал расстояния указывается в линейных единицах. | Linear Unit |
Интервал шкалы времени (Дополнительный) | Значение длительности временного шага. Этот параметр доступен только если у входных точек активировано время и представлено определённое время. Временные шаги могут применяться, только если во входных данных используется время. | Time Unit |
Повтор временного шага (Дополнительный) | Значение, задающее частоту интервалов временного шага. Этот параметр доступен только если у входных точек активировано время и представлено определённое время. | Time Unit |
Базовый временной шаг (Дополнительный) | Дата, задающая базовое время, по которому выравниваются временные шаги. По умолчанию это 1 января 1970, 00:00 часов. Этот параметр доступен только если у входных точек активировано время и представлено определенное время. | Date |
Поля суммирования (Дополнительный) | Статистика, которая будет рассчитываться по определенным полям. | Value Table |
Разрешение бина (Дополнительный) | Разрешение бина H3. Это значение от 0 до 15, при котором 0 создает самые большие, а 15 - самые маленькие бины H3. | Long |
Краткая информация
Агрегирует точечные объекты в полигональные объекты или бины. Полигон возвращается с количеством точек, а также необязательной статистикой во всех местоположениях, где существуют точки.
Иллюстрация
Использование
Вы можете указать области, в которых будут агрегироваться точки, любым из следующих способов:
- Использовать полигональный слой.
- Использовать бины регулярной, шестиугольной или H3 сетки, которая создается при выполнении анализа.
Для анализа можно использовать полигональный слой или создать бины определенного размера и формы (шестиугольник, квадрат или H3), в пределах которых будет происходить агрегация точек. Размер бина определяет величину квадратных и шестиугольных бинов.
- Если агрегация выполняется по гексагональной сетке, размером является высота каждого шестиугольника, а ширина полученного шестиугольника будет равна 2 высотам, деленным на квадратный корень из 3.
- Если агрегирование выполняется в квадраты, размером бина будет высота квадрата, которая равна ширине.
- Если вы выполняете агрегирование в бины H3, размер бина определяется заданным разрешением бина H3. Разрешение бина H3 может быть значением от 0 до 15, при котором 0 создает самые большие, а 15 - самые маленькие бины.
Для анализа с бинами надо, чтобы входные данные были спроецированы или чтобы выходная система координат была задана как система координат проекции. Если данные не используют систему координат проекции, и вы не задали ее, проекция будет выбрана на основе экстента анализируемых данных.
Выходной слой объектов всегда является полигональным. Будут возвращены только те полигоны, которые содержат точки, а полученные в итоге полигоны будут полностью удалены из слоя результата.
Если для входных данных активировано время, вы можете применить в анализе пошаговый временной интервал. Каждый временной шаг анализируется независимо от объектов вне этого шага. Чтобы использовать временной шаг, входные данные должны содержать информацию о времени и представлять момент времени. Когда применяются временные шаги, выходными объектами выступают интервалы времени, представленные полями START_DATETIME и END_DATETIME.
В самом простом варианте при агрегации будет подсчитано количество точек в каждом полигоне. Данные статистики (количество, минимум, максимум, диапазон, среднее, стандартное отклонение и дисперсия) могут также вычисляться для числовых полей, а данные статистики (количество, любые другие) могут вычисляться для текстовых полей. Для каждой области статистика будет вычислена отдельно. Если вы зададите неверную статистику (например, среднее значение строкового поля), она будет пропущена.
Примечание:
Когда к полю применяется количество, в нем отображается число ненулевых значений, имеющихся в данном поле. Когда к текстовому полю применяется любые, в нем отображается единственная строка, присутствующая в данном поле.
Если для входных данных активировано время, вы можете применить в анализе пошаговый временной интервал. Каждый временной шаг анализируется независимо от объектов вне этого шага. Чтобы использовать временной шаг, входные данные должны содержать информацию о времени и представлять момент времени. Когда применяются временные шаги, выходными объектами выступают интервалы времени, представленные полями START_DATETIME и END_DATETIME.
Если вы зададите интервал временного шага, интервал повторения временного шага или базовое время, а время для данных не включено, возникнет ошибка.
Для параметра Базовый временной шаг может быть указана дата и время или только дата; только значение времени не может быть указано.
В выходные объекты будут добавлены следующие поля:
Имя поля Описание count
Количество объектов внутри каждого полигона.
statistic_fieldname
Каждая заданная статистика создает поле атрибута с именем в следующем формате: statistics_fieldname. Например, максимальное значение и стандартное отклонение поля id будет MAX_id и SD_id, соответственно.
start_date
Если задан временной шаг, выходные полигоны будут иметь временной интервал. Это поле представляет время начала.
end_date
Если задан временной шаг, выходные полигоны будут иметь временной интервал. Это поле представляет время окончания.
bin_id
Числовой ID бина H3. Это поле включается только при агрегировании в бины H3.
Вы можете повысить производительность инструмента Агрегировать точки, выполнив одно или несколько из следующих действий:
- Установите параметр среды экстента таким образом, чтобы анализировались только интересующие вас данные.
- Бины большего размера будут работать лучше, чем меньшего размера. Если вы не уверены, какой размер использовать, начните с контейнера большего размера для создания прототипа.
- Подобно бинам, большие временные шаги будут работать лучше, чем меньшие.
- Используйте локальные данные, относительно места выполнения анализа.
Этот инструмент геообработки работает на Spark. Анализ выполняется на настольном компьютере с использованием параллельно работающих ядер. Чтобы узнать больше о выполнении анализа см. раздел Информация по инструментами GeoAnalytics Desktop.
При запуске инструментов GeoAnalytics Desktop аналитика выполняется на настольном компьютере. Для оптимальной производительности, данные должны быть доступны на настольном ПК. Если используется размещенный векторный слой, рекомендуется применить ArcGIS GeoAnalytics Server. Если данные не являются локальными, инструмент будет работать дольше. Чтобы использовать ArcGIS GeoAnalytics Server для выполнения анализа, см. GeoAnalytics Tools.
Аналогичный анализ можно выполнить, используя инструмент Агрегировать точки из набора инструментов Стандартный анализ объектов.
Параметры
arcpy.geoanalytics.AggregatePoints(point_layer, out_feature_class, polygon_or_bin, {polygon_layer}, {bin_type}, {bin_size}, {time_step_interval}, {time_step_repeat}, {time_step_reference}, {summary_fields}, {bin_resolution})
Имя | Описание | Тип данных |
point_layer | Точечные объекты, которые будут агрегированы в полигоны или бины. | Feature Layer |
out_feature_class | Новый класс пространственных объектов с агрегированными полигонами. | Feature Class |
polygon_or_bin | Задает, как будет агрегироваться значение параметра point_layer.
| String |
polygon_layer (Дополнительный) | Класс полигональных объектов, в пределах которых будут агрегированы входные точки. | Feature Layer |
bin_type (Дополнительный) | Задает форму бинов, построенных для хранения агрегированных точек.
| String |
bin_size (Дополнительный) | Единицы измерения и интервал расстояния, определяющий размер бинов, в которые будет агрегирован point_layer. Интервал расстояния указывается в линейных единицах. | Linear Unit |
time_step_interval (Дополнительный) | Значение длительности временного шага. Этот параметр доступен только если у входных точек активировано время и представлено определённое время. Временные шаги могут применяться, только если во входных данных используется время. | Time Unit |
time_step_repeat (Дополнительный) | Значение, задающее частоту интервалов временного шага. Этот параметр доступен только если у входных точек активировано время и представлено определённое время. | Time Unit |
time_step_reference (Дополнительный) | Дата, задающая базовое время, по которому выравниваются временные шаги. По умолчанию это 1 января 1970, 00:00 часов. Этот параметр доступен только если у входных точек активировано время и представлено определенное время. | Date |
summary_fields [summary_fields,...] (Дополнительный) | Статистика, которая будет рассчитываться по определенным полям.
| Value Table |
bin_resolution (Дополнительный) | Разрешение бина H3. Это значение от 0 до 15, при котором 0 создает самые большие, а 15 - самые маленькие бины H3. | Long |
Пример кода
Следующий скрипт окна Python демонстрирует использование функции AggregatePoints.
# Name: AggregatePoints.py
# Description: Aggregate 311 events into 1 KM Bins.
# Import system modules
import arcpy
arcpy.env.workspace = "C:/data/CityData.gdb"
# Set local variables
inFeatures = "SF311"
summaryFields = ["Year", "Beat"]
summaryStatistics = [["Arrest", "COUNT"], ["District", "COUNT"]]
out = "AggregateWildfires"
# Run Aggregate Points
arcpy.gapro.AggregatePoints(inFeatures, out, "BIN", None, "HEXAGON",
"1 Kilometers")