Агрегировать точки (GeoAnalytics)

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

Агрегирует точечные объекты в полигональные объекты или бины. Полигон возвращается с количеством точек, а также необязательной статистикой во всех местоположениях, где существуют точки.

Более подробно о работе пошагового временного анализа

Иллюстрация

Инструмент Агрегировать точки
Показаны примеры агрегирования точек в полигоны (первая строка), точки с включенным временем в полигоны с пошаговым временем (вторая строка), точки в бины (третья строка) и точки в бины с пошаговым временем (четвертая строка).

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

  • Вы можете указать области, в которых будут агрегироваться точки, любым из следующих способов:

    • Использовать полигональный слой.
    • Использовать бины регулярной, шестиугольной или H3 сетки, которая создается при выполнении анализа.

    Для анализа можно использовать полигональный слой или создать бины определенного размера и формы (шестиугольник, квадрат или H3), в пределах которых будет происходить агрегация точек. Размер бина определяет величину квадратных и шестиугольных бинов.

    • Если агрегация выполняется по гексагональной сетке, размером является высота каждого шестиугольника, а ширина полученного шестиугольника будет равна 2 высотам, деленным на квадратный корень из 3.
    • Если агрегирование выполняется в квадраты, размером бина будет высота квадрата, которая равна ширине.
    • Если вы выполняете агрегирование в бины H3, размер бина определяется заданным разрешением бина H3. Разрешение бина H3 может быть значением от 0 до 15, при котором 0 создает самые большие, а 15 - самые маленькие бины.

    Шестиугольные и квадратные бины

  • Для Агрегировать точки требуется, чтобы значение параметра Точечный слой было спроецировано или чтобы для выходной системы координат была задана система координат проекции при агрегировании в шестиугольные или квадратные бины. Если данные не используют систему координат проекции при агрегировании в шестиугольные или квадратные бины, и вы не задали систему координат проекции для обработки, проекция будет выбрана на основе экстента анализируемых данных. При агрегации в бины H3 значение параметра Точечный слой должно быть в системе координат World Geodetic System 1984 (WKID 4326), при необходимости будет выполнено преобразование.

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

    Возвращаемые полигоны с точечными объектами
    Входные точечные и полигональные объекты показаны на первом изображении, а полученные с помощью инструмента Агрегировать точки полигональные объекты показаны на втором изображении.

  • В самом простом варианте при агрегации будет подсчитано количество точек в каждом полигоне. Данные статистики (количество, минимум, максимум, диапазон, среднее, стандартное отклонение и дисперсия) могут также вычисляться для числовых полей, а данные статистики (количество, любые другие) могут вычисляться для текстовых полей. Для каждой области статистика будет вычислена отдельно. Если вы зададите неверную статистику (например, среднее значение строкового поля), она будет пропущена.

    Примечание:

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

  • Если для входных данных активировано время, вы можете применить в анализе пошаговый временной интервал. Каждый временной шаг анализируется независимо от объектов вне этого шага. Чтобы использовать временной шаг, входные данные должны содержать информацию о времени и представлять момент времени. Когда применяются временные шаги, выходными объектами выступают интервалы времени, представленные полями START_DATETIME и END_DATETIME.

    Более подробно о пошаговом временном анализе

  • Если вы зададите интервал временного шага, интервал повторения временного шага или базовое время, а время для данных не включено, возникнет ошибка.

  • Для параметра Базовый временной шаг может быть указана дата и время или только дата; только значение времени не может быть указано.

  • В выходные объекты будут добавлены следующие поля:

    Имя поляОписание

    count

    Количество объектов внутри каждого полигона.

    statistic_fieldname

    Каждая заданная статистика создает поле атрибута с именем в следующем формате: statistics_fieldname. Например, максимальное значение и стандартное отклонение поля id будет MAX_id и SD_id, соответственно.

    start_date

    Если задан временной шаг, выходные полигоны будут иметь временной интервал. Это поле представляет время начала.

    end_date

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

    bin_id

    Числовой ID бина H3. Это поле включается только при агрегировании в бины H3.

  • Вы можете повысить производительность инструмента Агрегировать точки, выполнив одно или несколько из следующих действий:

    • Установите параметр среды экстента таким образом, чтобы анализировались только интересующие вас данные.
    • Бины большего размера будут работать лучше, чем меньшего размера. Если вы не уверены, какой размер использовать, начните с контейнера большего размера для создания прототипа.
    • Подобно бинам, большие временные шаги будут работать лучше, чем меньшие.
    • Используйте локальные данные, относительно места выполнения анализа.

  • Этот инструмент геообработки работает на 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

  • Аналогичный анализ можно выполнить, используя инструмент Агрегировать точки из набора инструментов Стандартный анализ объектов.

Параметры

ПодписьОписаниеТип данных
Точечный слой

Точечные объекты, которые будут агрегированы в полигоны или бины.

Feature Set
Выходное имя

Имя выходного сервиса пространственных объектов.

String
Полигон или Бин

Задает, как будет агрегироваться значение параметра Точечный слой.

  • ПолигонТочечный слой будет агрегирован в набор полигональных объектов.
  • БинТочечный слой будет агрегирован в бины регулярной или гексагональной сетки, которая создается при запуске инструмента.
String
Полигональный слой
(Дополнительный)

Класс полигональных объектов, в пределах которых будут агрегированы входные точки.

Feature Set
Тип бина
(Дополнительный)

Задает форму бинов, сгенерированных для хранения агрегированных точек.

  • КвадратБудут построены квадратные бины, для которых значение Размер бина соответствует высоте квадрата. Используется по умолчанию.
  • ШестиугольникБудут построены шестиугольные бины, для которых Размер бина соответствует высоте между двумя параллельными сторонами.
  • H3Будут построены бины H3. Размер бина будет определяться значением параметра Разрешение бина.
String
Размер бина
(Дополнительный)

Единицы измерения и интервал расстояния, определяющий размер бинов в границах которых будет агрегирован Точечный слой. Интервал расстояния указывается в линейных единицах.

Единицы измерения и интервал расстояния, определяющий Размер бинов, в границах которых будет агрегирован Точечный слой. Интервал расстояния указывается в линейных единицах.

Linear Unit
Интервал временного шага
(Дополнительный)

Значение длительности временного шага. Этот параметр доступен только если у входных точек активировано время и представлено определённое время.

Временные шаги могут применяться, только если во входных данных используется время.

Time Unit
Повтор временного шага
(Дополнительный)

Значение, задающее частоту интервалов временного шага. Этот параметр доступен только если у входных точек активировано время и представлено определённое время.

Time Unit
Базовый временной шаг
(Дополнительный)

Дата, задающая базовое время, по которому выравниваются временные шаги. По умолчанию это 1 января 1970, 00:00 часов. Этот параметр доступен только если у входных точек активировано время и представлено определенное время.

Date
Поля суммирования
(Дополнительный)

Статистика, которая будет рассчитываться по определенным полям.

Value Table
Хранилище данных
(Дополнительный)

Задает ArcGIS Data Store, где будут сохраняться выходные данные. По умолчанию это Хранилище больших пространственно-временных данных. Все результаты, находящиеся в хранилище пространственно-временных больших данных, будут храниться в системе WGS84. Результаты в реляционном хранилище данных сохраняют свои систему координат.

  • Хранилище пространственно-временных больших данныхРезультаты будут храниться в хранилище больших пространственно-временных данных. Это значение по умолчанию
  • Реляционное хранилище данныхРезультаты будут храниться в хранилище реляционных данных.
String
Разрешение бина
(Дополнительный)

Разрешение бина H3. Это значение от 0 до 15, при котором 0 создает самые большие, а 15 - самые маленькие бины H3.

Long

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

ПодписьОписаниеТип данных
Выходной векторный слой

Агрегированные полигональные объекты или бины.

Feature Set

arcpy.geoanalytics.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}, {bin_resolution})
ИмяОписаниеТип данных
point_layer

Точечные объекты, которые будут агрегированы в полигоны или бины.

Feature Set
output_name

Имя выходного сервиса пространственных объектов.

String
polygon_or_bin

Задает, как будет агрегироваться значение параметра point_layer.

  • POLYGONТочечный слой будет агрегирован в набор полигональных объектов.
  • BINТочечный слой будет агрегирован в бины регулярной или гексагональной сетки, которая создается при запуске инструмента.
String
polygon_layer
(Дополнительный)

Класс полигональных объектов, в пределах которых будут агрегированы входные точки.

Feature Set
bin_type
(Дополнительный)

Задает форму бинов, построенных для хранения агрегированных точек.

  • SQUAREБудут построены квадратные бины, для которых значение bin_size соответствует высоте квадрата. Используется по умолчанию.
  • HEXAGONБудут построены шестиугольные бины, для которых bin_size соответствует высоте между двумя параллельными сторонами.
  • H3Будут построены бины H3. Размер бина будет определяться значением параметра bin_resolution.
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,...]
(Дополнительный)

Статистика, которая будет рассчитываться по определенным полям.

  • COUNT – количество ненулевых значений. Может использоваться с числовыми или текстовыми полями. Количество [null, 0, 2] равно 2.
  • SUM – сумма числовых значений в поле. Сумма [null, null, 3] равна 3.
  • MEAN – среднее арифметическое числовых значений. Среднее [0,2, null] равно 1.
  • MIN – минимальное значение числового поля. Минимум [0, 2, null] равен 0.
  • MAX – максимальное значение числового поля. Максимальное значение [0, 2, null] равно 2.
  • STDDEV – среднеквадратическое отклонение числового поля. Среднеквадратическое отклонение [1] равно null. Среднеквадратическое отклонение [null, 1,1,1] равно null.
  • VAR – дисперсия по числовому полю в треке. Дисперсия [1] равна null. Дисперсия [null, 1,1,1] равна null.
  • RANGE – диапазон числового поля. Он вычисляется вычитанием минимального значения из максимального. Диапазон [0, null, 1] равен 1. Диапазон [null, 4] равен 0.
  • ANY – пример строки из текстового поля.

Value Table
data_store
(Дополнительный)

Задает ArcGIS Data Store, где будут сохраняться выходные данные. По умолчанию – SPATIOTEMPORAL_DATA_STORE. Все результаты, находящиеся в хранилище пространственно-временных больших данных, будут храниться в системе WGS84. Результаты в реляционном хранилище данных сохраняют свои систему координат.

  • SPATIOTEMPORAL_DATA_STOREРезультаты будут храниться в хранилище больших пространственно-временных данных. Это значение по умолчанию
  • RELATIONAL_DATA_STOREРезультаты будут храниться в хранилище реляционных данных.
String
bin_resolution
(Дополнительный)

Разрешение бина H3. Это значение от 0 до 15, при котором 0 создает самые большие, а 15 - самые маленькие бины H3.

Long

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

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

Агрегированные полигональные объекты или бины.

Feature Set

Пример кода

AggregatePoints (окно Python)

Следующий скрипт окна 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"

# Run Aggregate Points
arcpy.geoanalytics.AggregatePoints(inFeatures, outFS, "BIN", None, "HEXAGON", 
                                   "1 Kilometers", None, None, None, None, 
                                   dataStore)

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

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

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

Система координат, используемая при анализе. Если данный параметр не указан, анализ будет выполнен во входной системе координат. Для GeoAnalytics Tools готовые результаты будут храниться в пространственно-временном хранилище данных в WGS84.

Информация о лицензиях

  • Basic: Обязательно ArcGIS GeoAnalytics Server
  • Standard: Обязательно ArcGIS GeoAnalytics Server
  • Advanced: Обязательно ArcGIS GeoAnalytics Server

Связанные разделы