| Подпись | Описание | Тип данных |
Суммированный слой |
Точечные, линейные или полигональные объекты, которые будут суммироваться по полигонам или бинам. | Feature Layer |
Выходной класс объектов | Имя сервиса выходных полигональных объектов, которые содержат пересекающиеся геометрии и атрибуты. | Feature Class |
Полигон или Бин | Показывает, будет ли значение Суммируемый слой суммироваться по полигонам или по бинам.
| String |
Тип бина | Указывает форму бинов, образующуюся для суммирования объектов.
| String |
Размер бина (Дополнительный) | Интервал расстояния, определяющий размер бинов, и единицы измерения, в которых будут суммированы входные объекты. | Linear Unit |
Полигоны для суммирования (Дополнительный) | Полигоны, которые будут использоваться для суммирования объектов во входном суммируемом слое. | Feature Layer |
Добавить суммированные атрибуты объектов | Указывает, будет ли вычислена длина линий или площадь полигонов в слое для суммирования (полигон или бин). Количество точек, линий и полигонов, пересекающих форму суммирования, всегда будет включено.
| Boolean |
Единицы измерения объектов (Дополнительный) | Указывает единицу измерения, которая будет использоваться для вычисления суммированных атрибутов объектов. Если входными объектами для суммирования являются точки, единицы измерения объектов не обязательны, поскольку в этом случае добавляется только число точек в пределах каждого входного полигона. Если входными данными являются линии, укажите единицу измерения длины. Если входными данными являются полигоны, укажите единицу измерения площади.
| String |
Стандартные поля суммирования (Дополнительный) | Статистика, которая будет рассчитываться по определенным полям. Задает, будет ли поле представлять число или долю.
| Value Table |
Взвешенные поля суммирования (Дополнительный) | Указывает взвешенную статистику, которая будет рассчитываться по определенным полям. Задает, будет ли поле представлять число или долю.
| Value Table |
Группировать по полю (Дополнительный) | Поле из входных объектов суммирования, которое будет использоваться для вычисления статистики отдельно для каждого уникального значения атрибута. В качестве примера предположим, что входные объекты суммирования содержат точечные местоположения коммерческих предприятий, на которых хранятся опасные материалы, и одно из полей HazardClass, содержащее коды с описанием типа хранящегося опасного материала. Для расчета итогов по каждому уникальному значению HazardClass используйте его, как поле Группировать по. | Field |
Добавить атрибуты меньшинства и большинства (Дополнительный) | Показывает, какое из атрибутивных значений будет добавлено для каждого поля группы в пределах границы – меньшинство (менее доминирующие) или большинство (более доминирующие). Если этот параметр отмечен, в выходной слой будут добавлены два новых поля с префиксами Majority_ и Minority_. Этот параметр применяется только если задано значение параметра Группировать по полю.
| Boolean |
Добавить проценты в группе (Дополнительный) | Показывает, будут ли добавлены поля процентов. Если этот параметр отмечен, будет вычислена доля в процентах каждого уникального значения группы для каждого входного полигона. Этот параметр применяется только в том случае, если указано значение параметра Группировать по полю и указано значение для параметра Добавить атрибуты меньшинства и большинства.
| Boolean |
Таблица Группировать по суммированию (Дополнительный) | Выходная таблица, которая будет содержать данные Группировать по суммированию. | Table |
Краткая информация
Выполняет наложение полигонального слоя на другой слой для суммирования числа точек, длин линий и площадей полигонов, а также вычисляющий статистику атрибутивных полей этих объектов внутри полигонов.
Пример использования инструмента Суммировать в пределах:
- Зная границы водоразделов и границы землепользования по типам землепользования, можно определить общую площадь земель по типам землепользования в акрах для каждой водосборной области.
- Имея земельные участки в округе и границы городов, можно вычислить среднюю стоимость свободных участков в черте каждого города.
- Имея данные об округах и дорогах, можно вычислить общую протяженность дорог в милях по типам дорожного покрытия в каждом округе.
Иллюстрация
Использование
Проще говоря, инструмент Суммировать в пределах берёт два слоя: входные полигоны и входные объекты суммирования, и накладывает их друг на друга (создает стек). Вы можете просмотреть стек и подсчитать число входных суммируемых объектов, попадающих внутрь входных полигонов. Вы также можете вычислить простую статистику по атрибутам входного слоя суммирования, такую как сумму, среднее, минимум, максимум и т.д.
Используйте Суммировать в пределах, чтобы вычислять стандартную статистику и географически взвешенную статистику. Стандартная статистика суммирует значения статистики без взвешивания. Взвешенная статистика вычисляет значения, используя географически взвешенные атрибуты линий в пределах полигона или атрибуты полигонов в полигоне. Взвешенная статистика не применима по отношению к точкам в полигоне.
Стандартная статистика и географически взвешенная статистика может быть вычислена для атрибутов, которые представляют либо числа, либо доли. Они определяются следующим образом:
- Числа - атрибуты, которые представляют сумму или количество чего-либо в точке местоположения, вдоль линии или в полигоне. Пример числовых атрибутов включает население страны, количество вызовов такси в квартале или количество дамб вдоль реки. Для линейных и полигональных объектов числа нормируются перед вычислением стандартной или взвешенной статистики.
- Доли - атрибуты, которые показывает соотношение или индекс точке местоположения, вдоль линии или в полигоне. Примеры атрибутов долей включают плотность населения страны, ограничение скорости для дороги или уровень пешей доступности для квартала. Доли не нормализуются.
Для числовых атрибутов значения нормализуются в соответствии с числом линий внутри полигона или числом полигонов внутри общего полигона перед вычислением статистики. Статистика вычисляется одинаково для числовых и относительных атрибутов, когда объекты статистики - точки.
Вы можете вычислить длины и площади на суммируемых слоях в каждом полигоне, используя опции из таблицы ниже. Опции основаны на геометрии суммируемого слоя.
Входной объект Описание Опция Точки
Число суммируемых точек внутри каждого полигона
Нет
Линии
Длина суммируемых линий внутри каждого полигона
- Сухопутные мили
- Международные ярды
- Международные футы
- Геодезические мили США
- Геодезические ярды США
- Геодезические футы США
- Километры
- Метры
Площади
Площади суммируемых полигонов внутри каждого полигона
- Квадратные сухопутные мили
- Международные квадратные ярды
- Квадратные международные футы
- Квадратные километры
- Квадратные метры
- Гектары
- Международные акры
- Квадратные геодезические мили США
- Квадратные геодезические ярды США
- Квадратные геодезические футы США
- Геодезические акры США
Для линий и площадей вычисляется любая взвешенная статистика. И стандартная статистика, и взвешенная статистика применяется к данным для объектов Суммируемого слоя, пересекающих слой Суммируемые полигоны. Взвешиваемые поля статистики будут умножены на вес на основе пропорции объектов Области суммирования, пересекающей каждый объект из параметра Суммируемые полигоны.
Для стандартной статистики есть восемь вариантов: количество, сумма, среднее, минимум, максимум, диапазон, стандартное отклонение и дисперсия. Есть два варианта статистики для текста: количество и любой. Есть три взвешенных статистик, вычисляемых при суммировании числовых полей слоя: среднее, среднеквадратичное отклонение и дисперсия.
Взвешенная статистика не вычисляется для текстовых данных. При каждом задании Поля и Статистики, на панель инструмента добавляется строка, таки образом можно вычислить более одного типа статистики. Можно просмотреть суммированные данные в итоговой таблице слоя или во всплывающих окнах. По умолчанию, число объектов, пересекающих Суммируемые полигоны, вычисляется всегда.
Для анализа с бинами надо, чтобы входные данные были спроецированы или чтобы выходная система координат была задана как система координат проекции. Если данные не используют систему координат проекции, и вы не задали ее, проекция будет выбрана на основе экстента анализируемых данных.
Можно ввести значение Группировать по полю, чтобы статистика вычислялась отдельно для каждого уникального значения атрибута. При задании значения Группировать по полю также будет создана итоговая таблица с каждым объектом и статистикой по значению в поле Группировать по полю.
Опции Добавить атрибуты меньшинства и большинства и Добавить проценты в группе активны в том случае, если указано значение Группировать по полю. Меньшинство и большинство – наименее и наиболее часто встречающееся значение в поле Группировать по полю, причем частота определяется с использованием числа точек, общей длины или общей площади – для каждого значения.
Если отмечен параметр Добавить атрибуты меньшинства и большинства, большинство, в итоговый слой будут добавлены два поля. В полях будут перечислены значения Группировать по полю, являющиеся меньшинством и большинством для каждого итогового объекта.
Параметр Добавить проценты в группе доступен только при выборе Добавить атрибуты меньшинства и большинства. Если отмечен параметр Добавить проценты в группе, в итоговый слой будут добавлены два поля с процентами от числа точек, общей длины или общей площади, относящиеся к значениям меньшинства и большинства для каждого объекта. В итоговую таблицу будет также добавлено поле процентов с процентами от числа точек, общей длины или общей площади, относящиеся ко всем значениям параметра Группировать по полю для каждого объекта.
Выходной векторный слой всегда является полигональным. Будут возвращены только полигоны, пересекающие суммируемый слой. Другие полигоны будут полностью удалены из итогового слоя.
Входные точечные и полигональные объекты (слева) и полученные полигональные объекты (справа). В выходные полигональные объекты будут добавлены следующие поля:
Имя поля Описание 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, значение поля majority_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.
Вы можете повысить производительность инструмента Суммировать в пределах, используя следующие действия:
- Установите параметр среды Экстент, чтобы анализировались только интересующие вас данные.
- Более крупные бины повышают производительность, по сравнению с более мелкими. Если вы используете бины и не уверены относительно начального размера, выберите более крупный бин.
- Используйте локальные данные там, где запускается анализ.
Этот инструмент геообработки работает от Spark. Анализ выполняется на настольном компьютере с использованием нескольких ядер параллельно. См. Информация по инструментами GeoAnalytics Desktop, чтобы узнать больше о выполнении анализа.
При запуске инструментов GeoAnalytics Desktop анализ выполняется на настольном компьютере. Для оптимальной производительности данные должны быть доступны на настольном компьютере. Если используется размещенный векторный слой, рекомендуется применить ArcGIS GeoAnalytics Server. Если данные находятся не на жестком диске, для запуска инструмента потребуется больше времени. Чтобы использовать ArcGIS GeoAnalytics Server для выполнения анализа, см. GeoAnalytics Tools.
Аналогичный анализ можно выполнить при помощи инструмента Суммировать в пределах из набора инструментов Стандартный анализ объектов в ArcGIS Pro.
Параметры
arcpy.gapro.SummarizeWithin(summarized_layer, out_feature_class, polygon_or_bin, bin_type, {bin_size}, {summary_polygons}, sum_shape, {shape_units}, {standard_summary_fields}, {weighted_summary_fields}, {group_by_field}, {add_minority_majority}, {add_percentages}, {group_by_summary})| Имя | Описание | Тип данных |
summarized_layer |
Точечные, линейные или полигональные объекты, которые будут суммироваться по полигонам или бинам. | Feature Layer |
out_feature_class | Имя сервиса выходных полигональных объектов, которые содержат пересекающиеся геометрии и атрибуты. | Feature Class |
polygon_or_bin | Указать, будет ли summarized_layer суммироваться по полигонам или по бинам.
| String |
bin_type | Указывает форму бинов, образующуюся для суммирования объектов.
| String |
bin_size (Дополнительный) | Интервал расстояния, определяющий размер бинов, и единицы измерения, в которых будут суммированы входные объекты. | Linear Unit |
summary_polygons (Дополнительный) | Полигоны, которые будут использоваться для суммирования объектов во входном суммируемом слое. | Feature Layer |
sum_shape | Указывает, будет ли вычислена длина линий или площадь полигонов в слое для суммирования (полигон или бин). Количество точек, линий и полигонов, пересекающих форму суммирования, всегда будет включено.
| Boolean |
shape_units (Дополнительный) | Указывает единицу измерения, которая будет использоваться для вычисления суммированных атрибутов объектов. Если в параметре summarized_layer заданы точки, единицы измерения объектов не обязательны, поскольку в этом случае добавляется только число точек в пределах каждого входного полигона. Если входными данными являются линии, укажите единицу измерения длины. Если входными данными являются полигоны, укажите единицу измерения площади.
| String |
standard_summary_fields [standard_summary_fields,...] (Дополнительный) | Статистика, которая будет рассчитываться по определенным полям.
Задает, будет ли поле представлять число или долю.
| Value Table |
weighted_summary_fields [weighted_summary_fields,...] (Дополнительный) | Указывает взвешенную статистику, которая будет рассчитываться по определенным полям.
Задает, будет ли поле представлять число или долю.
| Value Table |
group_by_field (Дополнительный) | Поле из входных объектов суммирования, которое будет использоваться для вычисления статистики отдельно для каждого уникального значения атрибута. В качестве примера предположим, что входные объекты суммирования содержат точечные местоположения коммерческих предприятий, на которых хранятся опасные материалы, и одно из полей HazardClass, содержащее коды с описанием типа хранящегося опасного материала. Для расчета итогов по каждому уникальному значению HazardClass используйте его, как поле Группировать по. | Field |
add_minority_majority (Дополнительный) | Показывает, какое из атрибутивных значений будет добавлено для каждого поля группы в пределах границы – меньшинство (менее доминирующие) или большинство (более доминирующие). Если значение этого параметра - ADD_MIN_MAJ, в выходной слой будут добавлены два новых поля с префиксами Majority_ и Minority_. Этот параметр применяется только если задано значение параметра group_by_field.
| Boolean |
add_percentages (Дополнительный) | Показывает, будут ли добавлены поля процентов. Если значение этого параметра - ADD_PERCENT, будет вычислена доля в процентах каждого уникального значения группы для каждого входного полигона. Этот параметр применяется только если задано значение параметра group_by_field и для параметра add_minority_majority задано значение.
| Boolean |
group_by_summary (Дополнительный) | Выходная таблица, которая будет содержать данные Группировать по суммированию. | Table |
Пример кода
Пример скрипта в окне Python для использования функции SummarizeWithin.
# Name: SummarizeWithin.py
# Description: Summarize river polylines by counties.
# Import system modules
import arcpy
arcpy.env.workspace = "C:/data/RedRiver_basin.gdb"
# Set local variables
summarizedLayer = "Rivers"
summaryPolys = "Basins"
summaryStatistics = [["Width", "MEAN", "RATE"]]
weightedSummaryStatistics = [["DOC", "STDDEV", "COUNT"]]
out = 'SummarizedRivers'
# Run SummarizeWithin
arcpy.gapro.SummarizeWithin(summarizedLayer, out, "POLYGON", None,
None, summaryPolys, "ADD_SUMMARY",
"KILOMETERS", summaryStatistics,
weightedSummaryStatistics)Параметры среды
Информация о лицензиях
- Basic: Нет
- Standard: Нет
- Advanced: Да