Выполняет наложение полигонального слоя на другой слой для суммирования числа точек, длин линий и площадей полигонов, а также вычисляющий статистику атрибутивных полей этих объектов внутри полигонов.
Пример использования инструмента Суммировать в пределах:
Зная границы водоразделов и границы землепользования по типам землепользования, можно определить общую площадь земель по типам землепользования в акрах для каждой водосборной области.
Имея земельные участки в округе и границы городов, можно вычислить среднюю стоимость свободных участков в черте каждого города.
Имея данные об округах и дорогах, можно вычислить общую протяженность дорог в милях по типам дорожного покрытия в каждом округе.
Иллюстрация
Показаны примеры суммирования точек в пределах полигонов (первый ряд), линий в полигонах (второй ряд) и полигонов в пределах полигонов (третий ряд).
Использование
Проще говоря, инструмент Суммировать в пределах берёт два слоя: входные полигоны и входные объекты суммирования, и накладывает их друг на друга (создает стек). После наложения этих слоев вы можете посмотреть сквозь стек и посчитать число входных суммируемых объектов, попадающих внутрь входных полигонов. Вы также можете вычислить простую статистику по атрибутам входного слоя суммирования, такую как сумму, среднее, минимум, максимум и т.д.
Используйте Суммировать в пределах, чтобы вычислять стандартную статистику и географически взвешенную статистику. Стандартная статистика суммирует значения статистики без взвешивания. Взвешенная статистика вычисляет значения, используя географически взвешенные значения пропорции линий в пределах полигона или пропорции полигонов в полигоне. Взвешенная статистика не применима по отношению к точкам в полигоне.
Вы можете вычислить длины и площади на суммируемых слоях в каждом полигоне, используя опции из таблицы ниже. Опции основаны на геометрии суммируемого слоя.
Входной объект
Описание
Опция
Точки
Число суммируемых точек внутри каждого полигона.
Нет
Линии
Длина суммируемых линий внутри каждого полигона.
Мили
Ярды
Футы
Километры
Метры
Площади
Площади суммируемых полигонов внутри каждого полигона.
Квадратные мили
Квадратные ярды
Квадратные футы
Квадратные километры
Квадратные метры
Гектары
Акры
При необходимости можно вычислить стандартную статистику. Для линий и площадей вычисляется любая взвешенная статистика. И стандартная статистика, и взвешенная статистика применяется к данным для объектов Суммируемого слоя, пересекающих слой Суммируемые полигоны. Взвешиваемые поля статистики умножаются на вес на основе пропорции Области суммирования, пересекающей каждый объект из Суммируемых полигонов.
Для стандартной статистики есть восемь вариантов: количество, сумма, среднее, минимум, максимум, диапазон, стандартное отклонение и дисперсия. Есть два варианта статистики для текста: количество и любой. Есть шесть суммируемых взвешенных статистик, вычисляемых для числовых полей слоя: количество, сумма, среднее, минимум, максимум и диапазон.
Взвешенная статистика не вычисляется для текстовых данных. При каждом задании Поля и Статистики, на панель инструмента добавляется строка, таки образом можно вычислить более одного типа статистики. Можно просмотреть суммированные данные в итоговой таблице слоя или во всплывающих окнах. По умолчанию, число объектов, пересекающих Суммируемые полигоны, вычисляется всегда.
В версии ArcGIS Enterprise 10.6.1 и выше, при необходимости можно вычислить группу с помощью параметра Группировать по полю. Это создаст табличные выходные данные в дополнение к вашему суммированному полигональному слою.
Опции Добавить атрибуты меньшинства и большинства и Добавить проценты в группе активны в том случае, если выбрано Группировать по полю. Меньшинство и большинство – наименее и наиболее часто встречающееся значение в Группировать по полю, причем частота определяется с использованием числа точек, общей длины или общей площади – для каждого значения.
Если отмечен параметр Добавить атрибуты меньшинства и большинства, большинство, в итоговый слой будут добавлены два поля. В полях будут перечислены значения Группировать по полю, являющиеся меньшинством и большинством для каждого итогового объекта.
Параметр Добавить проценты в группе доступен только при выборе Добавить атрибуты меньшинства и большинства. Если отмечен параметр Добавить проценты в группе, в итоговый слой будут добавлены два поля с процентами от числа точек, общей длины или общей площади, относящиеся к значениям меньшинства и большинства для каждого объекта. В итоговую таблицу будет также добавлено поле процентов с процентами от числа точек, общей длины или общей площади, относящиеся ко всем значениям параметра Группировать по полю для каждого объекта.
Для взвешенной статистики линейные слои суммируются только с помощью пропорций линейных объектов, находящихся внутри Суммируемых полигонов. Стандартная (не взвешенная) статистика суммирует все линии, пересекающие Суммируемые полигоны. При суммировании линий с помощью взвешенной статистики используйте количества (а не отношения и индексы), чтобы вычисления пропорций вашего анализа были логичны.
Взвешенная статистика для суммируемых площадных слоев основывается на частях объектов Суммируемых полигонов, находящихся внутри Слоя суммирования. При суммировании областей используйте количества (а не отношения и индексы), чтобы вычисления пропорций вашего анализа были логичны.
Выходной векторный слой всегда является полигональным. Будут возвращены только полигоны, пересекающие суммируемый слой. Другие полигоны будут полностью удалены из итогового слоя. Входные точечные и полигональные объекты (слева) и полученные полигональные объекты (справа).
В выходные полигональные объекты будут добавлены следующие поля:
Имя поля
Описание
count
Число суммируемых объектов, которые пересекаются с каждым слоем суммирования.
sum_length_<linearunit> или sum_area_<areaunit>
Общая длина линий внутри полигона или общая площадь суммируемых полигонов в пределах каждого полигона. Эти значения возвращаются с использованием заданных единиц измерения при выборе Добавить суммированные атрибуты объекта.
statistic_<fieldname>
Для каждой заданной статистики создается атрибутивное поле с именем в следующем формате: <statistic>_<fieldname>. Например, максимум и стандартное отклонение для поля id являются MAX_id и SD_id.
pstatistic_<fieldname>
Для каждой заданной взвешенной статистики создается атрибутивное поле с именем в следующем формате: p<statistic>_<fieldname>. Например, взвешенный максимум поля id - это pMAX_id.
minority_<fieldname>
Это значение возвращается, если вы создаете таблицу группировки и выбираете Добавить атрибуты меньшинства и большинства. Оно представляет значения указанного поля, которые являются меньшинством в каждом полигоне. Например, в полигоне имеется пять точек с полем color и значениями red, blue, blue, green, green. Если вы создаете группу по полю color, значение поля minority_color равняется red.
majority_<fieldname>
Это значение возвращается, если вы создаете таблицу группировки и выбираете Добавить атрибуты меньшинства и большинства. Оно представляет значения указанного поля, которые являются большинством в каждом полигоне. Например, в полигоне имеется пять точек с полем color и значениями red, blue, blue, green, green. Если вы создаете группу по полю color, значение поля minority_color равняется blue;green.
minority_<fieldname>_percent
Это значение возвращается, если вы создаете таблицу группировки и выбираете Добавить проценты в группе. Оно представляет процент числа для указанного поля, которые являются меньшинством в каждом полигоне. Например, в полигоне имеется пять точек с полем color и значениями red, blue, blue, green, green. Если вы создаете группу по полю color, значение поля minority_color_percent равняется 20 (вычисленное как соотношение 1/5).
majority_<fieldname>_percent
Это значение возвращается, если вы создаете таблицу группировки и выбираете Добавить проценты в группе. Оно представляет процент числа для указанного поля, которые являются большинством в каждом полигоне. Например, в полигоне имеется пять точек с полем color и значениями red, blue, blue, green, green. Если вы создаете группу по полю color, значение поля majority_color_percent равняется 40 (вычисленное как соотношение 2/5).
join_id
Это значение возвращается когда вы создаете таблицу группировки. Это ID для связывания объектов с таблицей группировки. Каждое поле join_id соответствует одной или нескольким строкам в таблице группировки.
В выходную таблицу группировки включаются следующие поля:
Имя поля
Описание
join_id
Это ID для связывания объектов с полигональным слоем. В каждом полигоне будет находиться один или несколько объектов с одинаковым ID, который все значения группировки. Например, в полигоне имеется пять точек с полем color и значениями red, blue, blue, green, green. В таблице группировки будет три строки, представляющих этот полигон (такой же join ID), по одной для каждого из цветов red, blue и green.
count
Номер указанной группы в объединенном полигоне. Например, red в выбранном полигоне - это 1.
<statistic>_<fieldname>
Любая заданная статистика, вычисленная для каждой группы.
p<statistic>_<fieldname>
Любая заданная взвешенная статистика, вычисленная для каждой группы.
percentcount
Процент, который каждая группа вносит в общее число полигонов. В примере выше, red дает 1/5 = 20, blue - 2/5 = 40, а green - 2/5 = 20.
Вы можете повысить производительность инструмента Суммировать в пределах, используя следующие советы:
Установите параметр среды Экстент так, чтобы вы анализировали только интересующие вас данные.
Если используются бины, более крупные бины повышают производительность, по сравнению с более мелкими. Если вы не уверены относительно начального размера, выберите более крупный бин.
Этот инструмент геообработки работает на ArcGIS GeoAnalytics Server. Анализ выполняется на вашем GeoAnalytics Server, а результаты сохраняются в ресурсы на вашем ArcGIS Enterprise.
При работе инструментов GeoAnalytics Server, анализ выполняется на GeoAnalytics Server. Для оптимальной производительности сделайте данные доступными для GeoAnalytics Server через векторные слои, размещенные на вашем портале ArcGIS Enterprise или через файловое хранилище больших данных. Данные, которые не являются локальными для GeoAnalytics Server, будут перемещены на GeoAnalytics Server до начала анализа. Это означает, что для запуска инструмента потребуется больше времени, а в некоторых случаях перемещение данных с ArcGIS Pro на GeoAnalytics Server может завершиться ошибкой. Порог сбоя зависит от скорости сети, а также от размера и сложности данных. Соответственно рекомендуется всегда предоставлять доступ к данным или создавать файловое хранилище больших данных.
Аналогичный анализ можно выполнить при помощи инструмента Суммировать в пределах из набора инструментов Стандартный анализ объектов в ArcGIS Pro.
Параметры
Подпись
Описание
Тип данных
Суммированный слой
Точечные, линейные или полигональные объекты, которые будут суммироваться по полигонам или бинам.
Feature Set
Выходное имя
Имя сервиса выходных полигональных объектов, которые содержат пересекающиеся геометрии и атрибуты.
String
Полигон или Бин
Показывает, будет ли Суммируемый слой суммироваться по полигонам или по бинам.
Полигон—Суммированный слой будет агрегирован в набор полигональных объектов.
Бин—Суммированный слой будет агрегирован в квадратные или шестиугольные бины, образующиеся во время работы этого инструмента.
String
Тип бина
Указывает форму бинов, образующуюся для суммирования объектов.
Квадрат—Размер бина указывается в виде стороны квадрата. Это значение по умолчанию Короткое целое.
Шестиугольник—Размер бина соответствует высоте между двумя параллельными сторонами.
String
Размер бина
(Дополнительный)
Интервал расстояния, определяющий размер бинов, и единицы измерения, в которых будут суммированы входные объекты.
Linear Unit
Полигоны для суммирования
(Дополнительный)
Полигоны, использующиеся для суммирования объектов во входном суммируемом слое.
Feature Set
Добавить суммированные атрибуты объекта
Указывает, будет ли вычислена длина линий или площадь полигонов в слое для суммирования (полигон или бин). Количество точек, линий и полигонов, пересекающих форму суммирования, всегда будет включено.
Отмечено – будут вычислены значения в пределах формы суммирования. Это значение по умолчанию Короткое целое.
Не отмечено – значения в пределах формы суммирования не будут вычислены.
Boolean
Единицы измерения объектов
(Дополнительный)
Указывает единицу измерения, которая используется для вычисления суммированных атрибутов объектов. Если входными объектами для суммирования являются точки, единицы измерения объектов не обязательны, поскольку в этом случае добавляется только число точек в пределах каждого входного полигона. Если входными данными являются линии, укажите единицу измерения длины. Если входными данными являются полигоны, укажите единицу измерения площади.
Метры—Единицами измерения геометрии будут метры.
Километры—Единицами измерения геометрии будут километры.
Футы—Единицами измерения геометрии будут футы.
Ярды—Единицами измерения геометрии будут ярды.
Мили—Единицами измерения геометрии будут мили.
Акры—Единицами измерения геометрии будут акры.
Гектары—Единицами измерения геометрии будут гектары.
Квадратные метры—Единицами измерения геометрии будут кв. метры.
Квадратные километры—Единицами измерения геометрии будут кв. километры.
Квадратные футы—Единицами измерения геометрии будут кв. футы.
Квадратные ярды—Единицами измерения геометрии будут кв. ярды.
Квадратные мили—Единицами измерения геометрии будут кв. мили.
String
Стандартные поля суммирования
(Дополнительный)
Статистика, которая будет рассчитываться по определенным полям.
Value Table
Взвешенные поля суммирования
(Дополнительный)
Указывает взвешенную статистику, которая будет рассчитываться по определенным полям.
Число—Вычисляется количество всех полей, умноженное на долю суммированного слоя в пределах полигонов.
Сумма—Вычисляется сумма взвешенных значений в каждом поле, где примененный вес – это доля суммированного слоя внутри полигонов.
Среднее—Вычисляется среднее взвешенных значений в каждом поле, где примененный вес – это доля суммированного слоя внутри полигонов.
Минимум—Вычисляется минимум взвешенных значений в каждом поле, где примененный вес – это доля суммированного слоя внутри полигонов.
Максимум—Вычисляется максимум взвешенных значений в каждом поле, где примененный вес – это доля суммированного слоя внутри полигонов.
Радиус действия—Вычисляется разница между Минимумом и Максимумом.
Value Table
Хранилище данных
(Дополнительный)
Задает ArcGIS Data Store, где будут сохраняться выходные данные. По умолчанию это Хранилище больших пространственно-временных данных. Все результаты, находящиеся в хранилище пространственно-временных больших данных, будут храниться в системе WGS84. Результаты в реляционном хранилище данных сохраняют свои систему координат.
Хранилище пространственно-временных больших данных—Результаты будут храниться в хранилище больших пространственно-временных данных. Это значение по умолчанию.
Реляционное хранилище данных—Результаты будут храниться в хранилище реляционных данных.
String
Группировать по полю
(Дополнительный)
Поле из входных объектов суммирования, которое будет использоваться для вычисления статистики отдельно для каждого уникального значения атрибута. В качестве примера предположим, что входные объекты суммирования содержат точечные местоположения коммерческих предприятий, на которых хранятся опасные материалы, и одно из полей HazardClass (класс опасности), содержащее коды с описанием типа хранящегося опасного материала. Для расчета итогов по каждому уникальному значению HazardClass (класса опасности) используйте его, как поле группировать по.
Field
Добавить атрибуты меньшинства и большинства
(Дополнительный)
Показывает, какое из атрибутивных значений будет добавлено для каждого поля группы в пределах границы – меньшинство (менее доминирующие) или большинство (более доминирующие). Если таковые имеются, то в выходной слой будут добавлены два новых поля с префиксами Majority_ и Minority_. Этот параметр применяется только при использовании параметра Группировать по полю.
Не отмечено – поля Minority и Majority не добавляются. Это значение по умолчанию Короткое целое.
Отмечено – поля Minority и Majority добавляются.
Boolean
Добавить проценты в группе
(Дополнительный)
Показывает, будут ли добавлены поля процентов. Если будут, то для каждого входного полигона вычисляются проценты для каждого уникального значения группы. Этот параметр применяется только при использовании параметров Группировать по полю и Добавить атрибуты меньшинства и большинства.
Не отмечено — поля процентов не добавляются. Это значение по умолчанию Короткое целое.
Отмечено будут добавлены поля процентов.
Boolean
Производные выходные данные
Подпись
Описание
Тип данных
Выходной векторный слой
Сумма точек, длин линий или площадей полигонов в каждом полигоне.
Набор объектов
Группировать по суммированию
Если указано группировать по суммированию, инструмент выведет таблицу, содержащую вычисленную статистику для каждой уникальной группы.
Точечные, линейные или полигональные объекты, которые будут суммироваться по полигонам или бинам.
Feature Set
output_name
Имя сервиса выходных полигональных объектов, которые содержат пересекающиеся геометрии и атрибуты.
String
polygon_or_bin
Указать, будет ли summarized_layer суммироваться по полигонам или по бинам.
POLYGON—Суммированный слой будет агрегирован в набор полигональных объектов.
BIN—Суммированный слой будет агрегирован в квадратные или шестиугольные бины.
String
bin_type
Указывает форму бинов, образующуюся для суммирования объектов.
SQUARE—bin_size указывается в виде стороны квадрата. Это значение по умолчанию Короткое целое.
HEXAGON—bin_size соответствует высоте между двумя параллельными сторонами.
String
bin_size
(Дополнительный)
Интервал расстояния, определяющий размер бинов, и единицы измерения, в которых будут суммированы входные объекты.
Linear Unit
summary_polygons
(Дополнительный)
Полигоны, использующиеся для суммирования объектов во входном суммируемом слое.
Feature Set
sum_shape
Указывает, будет ли вычислена длина линий или площадь полигонов в слое для суммирования (полигон или бин). Количество точек, линий и полигонов, пересекающих форму суммирования, всегда будет включено.
ADD_SUMMARY—Значения в пределах формы суммирования будут вычислены. Это значение по умолчанию Короткое целое.
NO_SUMMARY—Значения в пределах формы суммирования не будут вычислены.
Boolean
shape_units
(Дополнительный)
Указывает единицу измерения, которая используется для вычисления суммированных атрибутов объектов. Если summarized_layer являются точки, единицы измерения объектов не обязательны, поскольку в этом случае добавляется только число точек в пределах каждого входного полигона. Если входными данными являются линии, укажите единицу измерения длины. Если входными данными являются полигоны, укажите единицу измерения площади.
METERS—Единицами измерения геометрии будут метры.
KILOMETERS—Единицами измерения геометрии будут километры.
FEET—Единицами измерения геометрии будут футы.
YARDS—Единицами измерения геометрии будут ярды.
MILES—Единицами измерения геометрии будут мили.
ACRES—Единицами измерения геометрии будут акры.
HECTARES—Единицами измерения геометрии будут гектары.
SQUARE_METERS—Единицами измерения геометрии будут кв. метры.
SQUARE_KILOMETERS—Единицами измерения геометрии будут кв. километры.
SQUARE_FEET—Единицами измерения геометрии будут кв. футы.
SQUARE_YARDS—Единицами измерения геометрии будут кв. ярды.
SQUARE_MILES—Единицами измерения геометрии будут кв. мили.
String
standard_summary_fields
[standard_summary_fields,...]
(Дополнительный)
Статистика, которая будет рассчитываться по определенным полям.
COUNT – количество ненулевых значений. Может использоваться с числовыми или текстовыми полями. Число [null, 0, 2] равняется 2.
SUM – сумма числовых значений в поле. Сумма [null, null, 3] равняется 3.
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
weighted_summary_fields
[weighted_summary_fields,...]
(Дополнительный)
Указывает взвешенную статистику, которая будет рассчитываться по определенным полям.
COUNT—Вычисляется количество всех полей, умноженное на долю суммированного слоя в пределах полигонов.
SUM—Вычисляется сумма взвешенных значений в каждом поле, где примененный вес – это доля суммированного слоя внутри полигонов.
MEAN—Вычисляется среднее взвешенных значений в каждом поле, где примененный вес – это доля суммированного слоя внутри полигонов.
MIN—Вычисляется минимум взвешенных значений в каждом поле, где примененный вес – это доля суммированного слоя внутри полигонов.
MAX—Вычисляется максимум взвешенных значений в каждом поле, где примененный вес – это доля суммированного слоя внутри полигонов.
RANGE—Вычисляется разница между MIN и MAX.
Value Table
data_store
(Дополнительный)
Задает ArcGIS Data Store, где будут сохраняться выходные данные. По умолчанию – SPATIOTEMPORAL_DATA_STORE. Все результаты, находящиеся в хранилище пространственно-временных больших данных, будут храниться в системе WGS84. Результаты в реляционном хранилище данных сохраняют свои систему координат.
SPATIOTEMPORAL_DATA_STORE—Результаты будут храниться в хранилище больших пространственно-временных данных. Это значение по умолчанию.
RELATIONAL_DATA_STORE—Результаты будут храниться в хранилище реляционных данных.
String
group_by_field
(Дополнительный)
Поле из входных объектов суммирования, которое будет использоваться для вычисления статистики отдельно для каждого уникального значения атрибута. В качестве примера предположим, что входные объекты суммирования содержат точечные местоположения коммерческих предприятий, на которых хранятся опасные материалы, и одно из полей HazardClass (класс опасности), содержащее коды с описанием типа хранящегося опасного материала. Для расчета итогов по каждому уникальному значению HazardClass (класса опасности) используйте его, как поле группировать по.
Field
add_minority_majority
(Дополнительный)
Показывает, какое из атрибутивных значений будет добавлено для каждого поля группы в пределах границы – меньшинство (менее доминирующие) или большинство (более доминирующие). Если таковые имеются, то в выходной слой будут добавлены два новых поля с префиксами Majority_ и Minority_. Этот параметр используется только если используется параметр group_by_field.
NO_MIN_MAJ—Поля Minority и Majority не добавляются. Это значение по умолчанию Короткое целое.
ADD_MIN_MAJ—Поля Minority и Majority добавляются.
Boolean
add_percentages
(Дополнительный)
Показывает, будут ли добавлены поля процентов. Если будут, то для каждого входного полигона вычисляются проценты для каждого уникального значения группы. Этот параметр используется только если используются параметры group_by_field и add_minority_majority.
NO_PERCENT—Поля процентов не добавляются. Это значение по умолчанию Короткое целое.
ADD_PERCENT—Будут добавлены поля процентов.
Boolean
Производные выходные данные
Имя
Описание
Тип данных
output
Сумма точек, длин линий или площадей полигонов в каждом полигоне.
Набор объектов
group_by_summary
Если указано группировать по суммированию, инструмент выведет таблицу, содержащую вычисленную статистику для каждой уникальной группы.
Набор записей
Пример кода
Пример инструмента Суммировать в пределах (SummarizeWithin) (окно Python)
В следующем скрипте окна Python показано, как используется инструмент SummarizeWithin.
# Name: SummarizeWithin.py
# Description: Summarize river polylines by counties.
#
# Requirements: ArcGIS GeoAnalytics Server
# Import system modules
import arcpy
# Set local variables
summarizedLayer = "https://MyGeoAnalyticsMachine.domain.com/geoanalytics/rest/services/DataStoreCatalogs/bigDataFileShares_Water/BigDataCatalogServer/Rivers"
summaryPolys = "https://MyGeoAnalyticsMachine.domain.com/geoanalytics/rest/services/DataStoreCatalogs/bigDataFileShares_Boundaries/BigDataCatalogServer/Counties"
summaryStatistics = ["Width", "MEAN"]
weighedSummaryStatistics = ["DOC", "SUM"]
outFS = 'SummarizedRivers'
dataStore = "SPATIOTEMPORAL_DATA_STORE"
# Execute SummarizeWithin
arcpy.geoanalytics.SummarizeWithin(summarizedLayer, outFS, "POLYGON", None,
None, summaryPolys,"ADD_SUMMARY",
"KILOMETERS", summaryStatistics,
weightedSummaryStatistics, dataStore)
Система координат, используемая при анализе. Если данный параметр не указан, анализ будет выполнен во входной системе координат. Для GeoAnalytics Tools готовые результаты будут храниться в пространственно-временном хранилище данных в системе координат WGS84.
