| Подпись | Описание | Тип данных |
Входные полигоны | Полигоны, которые будут использоваться для суммирования объектов или части объектов во входном суммируемом слое. | Feature Layer |
Входные суммируемые объекты | Точечные, линейные или полигональные объекты, которые будут суммироваться для каждого входного полигона. | Feature Layer |
Выходной класс пространственных объектов | Выходной класс полигональных объектов с идентичными входным полигонам геометрией и атрибутами. Класс объектов будет содержать новые атрибуты, содержащие информацию о числе точек, длине линий, площади полигонов внутри каждой зоны и статистическим данными этих объектов. | Feature Class |
Сохранить все входные полигоны (Дополнительный) | Определяет, будут ли скопированы в выходной класс объектов все входные полигоны либо только пересекающие или содержащие как минимум один из входных суммированных объектов.
| Boolean |
Поля суммирования (Дополнительный) | Список имен атрибутивных полей входных суммируемых объектов и типы статистического суммирования, которые будут выполняться для этих полей – для всех точек в каждом полигоне. Поля суммирования должны быть числовыми. Текстовые поля и поля других типов не поддерживаются. Есть следующие типы статистики:
| Value Table |
Добавить суммированные атрибуты объекта (Дополнительный) | Определяет, будут ли такие атрибуты, как число точек, длина линий и площадь полигонов, суммированные для каждого входного полигона, добавляться в выходной класс объектов.
| Boolean |
Единицы измерения объекта (Дополнительный) | Указывает единицы, в которых будут вычисляться суммированные атрибуты объекта. Если входными данными являются точки, единицы не обязательны, поскольку в этом случае добавляется только число точек в каждом входном полигоне. Если входными данными являются линии, укажите единицу измерения длины. Если входными данными являются полигоны, укажите единицу измерения площади.
| String |
Поле группы (Дополнительный) | Атрибутивное поле входных суммируемых объектов, используемое для группирования. Объекты, имеющие одинаковые значения поля группы, комбинируются и суммируются с другими объектами с теми же значениями поля группы. При задании поля группировки необходимо значение параметра Выходная таблица группировки. | Field |
Добавить атрибуты меньшинства и большинства (Дополнительный) | Определяет, будут ли добавляться к выходным данным поля меньшинства и большинства. Этот параметр позволит вам определить, какое значение поля группы относится к меньшинству (редко встречается), а какое – к большинству (часто встречается) для каждого входного полигона. Этот параметр активен, если вы задаете значение параметра Поле группировки.
| Boolean |
Добавить проценты в группе (Дополнительный) | Определяет, будет ли атрибутивное поле процентов добавляться к выходным данным. Этот параметр позволит вам вычислить процент для каждого значения атрибута в каждой группе. Этот параметр активен, если вы задаете значение параметра Поле группировки.
| Boolean |
Выходная таблица группировки (Дополнительный) | Выходная таблица, содержащая поля суммирования для каждой группы суммированных объектов для каждого входного полигона. Таблица будет содержать следующие поля атрибутов:
Этот параметр необходим, если задано значение параметра Поле группировки. | Table |
Краткая информация
Выполняет наложение полигонального слоя на другой слой для суммирования числа точек, длин линий и площадей полигонов, а также вычисляющий статистику атрибутивных полей объектов внутри полигонов.
Вот примеры использования инструмента Суммировать в пределах:
- Используя слой границ водоразделов и слой с границами типов землепользования, можно определить общую площадь земель различных типов для каждого водораздела.
- При наличии слоя земельных участков в округе и слоя с границами городов, можно вычислить среднюю стоимость свободных участков в черте каждого города.
- Имеется слой округов и слой дорог, вычисляется общая протяженность дорог каждого типа в пределах округов.
Иллюстрация
Использование
Инструмент Суммировать в пределах можно использовать, если у вас есть два слоя: входные полигоны и входные объекты суммирования, и вы накладываете их друг на друга. После наложения этих слоев можно посмотреть на нижележащие и посчитать число входных суммируемых объектов, попадающих внутрь входных полигонов. Можно также вычислить несложную статистику атрибутов входных объектов, которые суммируются: сумму, среднее значение, минимум, максимум и т.д.
Инструменты Суммировать в пределах и Суммировать близлежащие очень похожи. С помощью инструмента Суммировать в пределах вы суммируете объекты в пределах существующих полигонов. С помощью инструмента Суммировать близлежащие вы создаете области вокруг точек, линий и полигонов, а затем суммируете объекты в пределах этих вычисленных областей.
Суммированные объекты полигонов суммируются в соответствии с площадями входных объектов. Возьмем входной полигон, который перекрывает полигон суммирования на 1 квадратный километр. Если площадь полигона суммирования составляет 100 квадратных километров, инструмент просуммирует 1/100 числовых значений полигона суммирования. Чтобы расчеты пропорций были корректными, используйте поля с числами и количествами, а не с коэффициентами или соотношениями.
Вы можете создавать группы, задав для входных точек поле группы. Например, при суммировании преступлений, совершенных в пределах соседних границ, можно выбрать атрибут Crime_type, который может содержать пять видов преступлений. Каждый уникальный тип преступления формирует группу, и выбранный вами тип статистики может быть вычислен для каждого уникального значения в поле Crime_type.
Пустые значения не включаются в расчет статистики. Например, среднее 10, 5 и null будет 7.5 ((10+5) / 2).
Параметры
arcpy.analysis.SummarizeWithin(in_polygons, in_sum_features, out_feature_class, {keep_all_polygons}, {sum_fields}, {sum_shape}, {shape_unit}, {group_field}, {add_min_maj}, {add_group_percent}, {out_group_table})| Имя | Описание | Тип данных |
in_polygons | Полигоны, которые будут использоваться для суммирования объектов или части объектов во входном суммируемом слое. | Feature Layer |
in_sum_features | Точечные, линейные или полигональные объекты, которые будут суммироваться для каждого входного полигона. | Feature Layer |
out_feature_class | Выходной класс полигональных объектов с идентичными входным полигонам геометрией и атрибутами. Класс объектов будет содержать новые атрибуты, содержащие информацию о числе точек, длине линий, площади полигонов внутри каждой зоны и статистическим данными этих объектов. | Feature Class |
keep_all_polygons (Дополнительный) | Определяет, будут ли скопированы в выходной класс объектов все входные полигоны либо только пересекающие или содержащие как минимум один из входных суммированных объектов.
| Boolean |
sum_fields [[summary_field, statistic_type],...] (Дополнительный) | Список имен атрибутивных полей входных суммируемых объектов и типы статистического суммирования, которые будут выполняться для этих полей – для всех точек в каждом полигоне. Поля суммирования должны быть числовыми. Текстовые поля и поля других типов не поддерживаются. Есть следующие типы статистики:
| Value Table |
sum_shape (Дополнительный) | Определяет, будут ли такие атрибуты, как число точек, длина линий и площадь полигонов, суммированные для каждого входного полигона, добавляться в выходной класс объектов.
| Boolean |
shape_unit (Дополнительный) | Указывает единицы, в которых будут вычисляться суммированные атрибуты объекта. Если входными данными являются точки, единицы не обязательны, поскольку в этом случае добавляется только число точек в каждом входном полигоне. Если входными данными являются линии, укажите единицу измерения длины. Если входными данными являются полигоны, укажите единицу измерения площади.
| String |
group_field (Дополнительный) | Атрибутивное поле входных суммируемых объектов, используемое для группирования. Объекты, имеющие одинаковые значения поля группы, комбинируются и суммируются с другими объектами с теми же значениями поля группы. При задании поля группировки необходимо значение параметра out_grouped_table. | Field |
add_min_maj (Дополнительный) | Определяет, будут ли добавляться к выходным данным поля меньшинства и большинства. Этот параметр позволит вам определить, какое значение поля группы относится к меньшинству (редко встречается), а какое – к большинству (часто встречается) для каждого входного полигона. Этот параметр включен, если вы задаете значение параметра group_field.
| Boolean |
add_group_percent (Дополнительный) | Определяет, будет ли атрибутивное поле процентов добавляться к выходным данным. Этот параметр позволит вам вычислить процент для каждого значения атрибута в каждой группе. Этот параметр включен, если вы задаете значение параметра group_field.
| Boolean |
out_group_table (Дополнительный) | Выходная таблица, содержащая поля суммирования для каждой группы суммированных объектов для каждого входного полигона. Таблица будет содержать следующие поля атрибутов:
Этот параметр необходим, если задано значение параметра group_field. | Table |
Пример кода
Следующий скрипт окна Python демонстрирует использование функции SummarizeWithin.
import arcpy
arcpy.env.workspace = 'C:/data/city.gdb'
arcpy.analysis.SummarizeWithin('neighborhoods', 'crimes', 'neighborhood_crimes')Следующий автономный скрипт – пример использования функции SummarizeWithin.
# Description: Use SummarizeWithin to summarize the crimes in each city neighborhood
# import system modules
import arcpy
# Set environment settings
arcpy.env.workspace = 'C:/data/city.gdb'
# Set local variables
polys = 'neighborhoods'
points = 'crimes'
outFeatureClass = 'crimes_aggregated'
keepAll = 'KEEP_ALL'
sumFields = [['Damages', 'SUM'], ['VICTIM_AGE', 'MEAN']]
addShapeSum = 'ADD_SHAPE_SUM'
groupField = 'Crime_type'
addMinMaj = 'ADD_MIN_MAJ'
addPercents = 'ADD_PERCENT'
outTable = 'crimes_aggregated_groups'
arcpy.analysis.SummarizeWithin(polys, points, outFeatureClass, keepAll,
sumFields, addShapeSum, '', groupField,
addMinMaj, addPercents, outTable)Параметры среды
Информация о лицензиях
- Basic: Да
- Standard: Да
- Advanced: Да