Сводка
Агрегирует точечные объекты в полигональные объекты или бины. Полигон возвращается с количеством точек, а также необязательной статистикой во всех местоположениях, где существуют точки.
Иллюстрация
Использование
Ниже приведены два способа указания областей, в которые будут агрегироваться точки:
- Использовать полигональный слой.
- Использовать бины регулярной или гексагональной сетки, которая создается при запуске инструмента.
Для анализа можно использовать полигональный слой или создать бины определенного размера и формы (шестиугольник или квадрат), в пределах которых будет происходить агрегирование. Размер бина определяет величину бинов. Если агрегация выполняется по гексагональной сетке, размером является высота каждого шестиугольника, а ширина полученного шестиугольника будет равна 2 высотам, деленным на квадратный корень из 3. Если агрегирование выполняется в квадраты, размером бина будет высота квадрата, которая равна ширине.
Для инструмента Агрегировать точки необходим Точечный слой в системе координат проекции, или в параметре среды Выходная система координат должна быть задано система координат проекции. Если данные не используют систему координат проекции и вы не задали систему координат проекции для обработки, проекция будет присвоена на основе экстента анализируемых данных.
Выходной векторный слой всегда является полигональным. Будут возвращены только полигоны, содержащие точки, и полученные в итоге полигоны будут полностью удалены из слоя результата.
Входные точечные и полигональные объекты (слева) и полученные в результате работы инструмента Агрегировать точки полигональные объекты (справа). В самом простом варианте при агрегации будет подсчитано количество точек в каждом полигоне. Данные статистики (количество, минимум, максимум, диапазон, среднее, стандартное отклонение и дисперсия) могут также вычисляться для числовых полей, а данные статистики (количество, любые другие) могут вычисляться для текстовых полей. Для каждой области статистика будет вычислена отдельно. Если задана недопустимая статистика (среднее по строковому полю), она будет пропущена.
Примечание:
Когда к полю применяется количество, в нем отображается число ненулевых значений, имеющихся в данном поле. Когда к текстовому полю применяется любые, в нем отображается единственная строка, присутствующая в данном поле.
Если для входных данных активировано время, вы можете применить пошаговый временной анализ к вашим данным. Каждый временной шаг анализируется независимо от объектов вне этого шага. Чтобы использовать временной шаг, входные данные должны содержать информацию о времени и представлять момент времени. Когда применяются временные шаги, выходными объектами выступают интервалы времени, представленные полями START_DATETIME и END_DATETIME.
Если вы указываете временной шаг, повтор временного шага или базовое время, но время не включено для ваших данных, инструмент возвращает ошибку.
Для параметра Базовый временной шаг может быть указана дата и время или только дата; только значение времени не может быть указано.
В выходные объекты будут добавлены следующие поля:
Имя поля Описание count
Число объектов внутри каждого полигона.
statistic_fieldname
Для каждой заданной статистики создается атрибутивное поле с именем в следующем формате: statistic_fieldname. Например, максимум и стандартное отклонение поля id соответствуют полям MAX_id и SD_id, соответственно.
start_date
При задании временного шага, выходные полигоны будут содержать временной интервал. Это поле представляет время начала.
end_date
При задании временного шага, выходные полигоны будут содержать временной интервал. Это поле представляет время окончания.
Вы можете повысить производительность инструмента Агрегировать точки, используя следующие советы:
- Задайте параметр среды экстента, чтобы анализировать только данные области интереса.
- Более крупные бины повышают производительность, по сравнению с более мелкими. Если вы не уверены относительно начального размера, выберите более крупный бин.
- Так же, как с бинами, более крупные временные интервалы повышают производительность, по сравнению с более мелкими.
- Используйте локальные данные там, где выполняется анализ.
Этот инструмент геообработки работает на ArcGIS GeoAnalytics Server. Анализ выполняется на вашем GeoAnalytics Server, а результаты сохраняются в ресурсы на вашем ArcGIS Enterprise.
При запуске инструментов GeoAnalytics Server анализ завершается на GeoAnalytics Server. Для оптимальной производительности сделайте данные доступными для GeoAnalytics Server через векторные слои, размещенные на вашем портале ArcGIS Enterprise или через файловое хранилище больших данных. Данные, которые не являются локальными для GeoAnalytics Server, будут перемещены на GeoAnalytics Server до начала анализа. Это означает, что для запуска инструмента потребуется больше времени, а в некоторых случаях перемещение данных с ArcGIS Pro на GeoAnalytics Server может завершиться ошибкой. Порог сбоя зависит от скорости сети, а также от размера и сложности данных. Соответственно рекомендуется всегда предоставлять доступ к данным или создавать файловое хранилище больших данных.
Более подробно о публикации локаторов на портале
Более подробно о создании файловых хранилищ больших данных в Server Manager
Аналогичный анализ можно выполнить при помощи инструмента Агрегировать точки из набора инструментов Стандартный анализ объектов.
Синтаксис
AggregatePoints(point_layer, output_name, polygon_or_bin, {polygon_layer}, {bin_type}, {bin_size}, {time_step_interval}, {time_step_repeat}, {time_step_reference}, {summary_fields}, {data_store})| Parameter | Объяснение | Тип данных |
point_layer | Точечные объекты, которые будут агрегированы в полигоны или бины. | Feature Set |
output_name | Имя выходного сервиса пространственных объектов. | String |
polygon_or_bin | Задает, как будет агрегирован point_layer.
| String |
polygon_layer (Дополнительный) | Класс полигональных объектов, в пределах которых будут агрегированы входные точки. | Feature Set |
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 |
data_store (Дополнительный) | Задает ArcGIS Data Store, где будут сохраняться выходные данные. По умолчанию – SPATIOTEMPORAL_DATA_STORE. Все результаты из SPATIOTEMPORAL_DATA_STORE будут сохранены в WGS84. Результаты, сохраненные в RELATIONAL_DATA_STORE сохранят собственную систему координат.
| String |
Производные выходные данные
| Name | Объяснение | Тип данных |
| output | Агрегированные полигональные объекты или бины. | Набор объектов |
Пример кода
В следующем скрипте окна Python показано, как используется инструмент AggregatePoints.
#-------------------------------------------------------------------------------
# Name: AggregatePoints.py
# Description: Aggregate 311 events into 1 KM Bins.
#
# Requirements: ArcGIS GeoAnalytics Server
# Import system modules
import arcpy
# Set local variables
inFeatures = "https://sampleserver6.arcgisonline.com/arcgis/rest/services/SF311/FeatureServer/0"
summaryFields = ["Year", "Beat"]
summaryStatistics = [["Arrest", "COUNT"], ["District", "COUNT"]]
outFS = "AggregateWildfires"
dataStore = "SPATIOTEMPORAL_DATA_STORE"
# Execute Aggregate Points
arcpy.geoanalytics.AggregatePoints(inFeatures, outFS, "BIN", None, "HEXAGON",
"1 Kilometers", None, None, None, None,
dataStore)Environments
- Выходная система координат
Система координат, используемая при анализе. Если данный параметр не указан, анализ будет выполнен во входной системе координат. Для Инструменты геоаналитики готовые результаты будут храниться в пространственно-временном хранилище данных в привязке WGS84.
Информация о лицензиях
- Basic: Требуется ArcGIS GeoAnalytics Server
- Standard: Требуется ArcGIS GeoAnalytics Server
- Advanced: Требуется ArcGIS GeoAnalytics Server