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

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

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

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

Иллюстрация

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

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

  • Ниже приведены два способа указания областей, в которые будут агрегироваться точки:

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

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

    Шестиугольные и квадратные бины
  • Для анализа с бинами надо, чтобы входные данные были спроецированы или чтобы выходная система координат была задана как система координат проекции. Если данные не используют систему координат проекции, и вы не задали ее, проекция будет выбрана на основе экстента анализируемых данных.

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

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

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

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

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

    Примечание:

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

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

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

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

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

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

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

    count

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

    statistic_fieldname

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

    start_date

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

    end_date

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

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

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

  • Этот инструмент геообработки работает на Spark. Анализ выполняется на настольном компьютере с использованием параллельно работающих ядер. Чтобы узнать больше о выполнении анализа см. раздел Информация по инструментами GeoAnalytics Desktop.

  • При запуске инструментов GeoAnalytics Desktop аналитика выполняется на настольном компьютере. Для оптимальной производительности, данные должны быть доступны на настольном ПК. Если используется размещенный векторный слой, рекомендуется применить ArcGIS GeoAnalytics Server. Если данные не являются локальными, инструмент будет работать дольше. Чтобы использовать ArcGIS GeoAnalytics Server для выполнения анализа, см. GeoAnalytics Tools.

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

Параметры

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

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

Feature Layer
Выходной класс пространственных объектов

Новый класс пространственных объектов с полученными агрегированными полигонами.

Feature Class
Полигон или Бин

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Value Table

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

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

Feature Layer
out_feature_class

Новый класс пространственных объектов с полученными агрегированными полигонами.

Feature Class
polygon_or_bin

Задает, как будет агрегирован point_layer.

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

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

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

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

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

Пример кода

AggregatePoints (окно Python)

Пример скрипта в окне 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")

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

  • Basic: Нет
  • Standard: Нет
  • Advanced: Да

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