| Подпись | Описание | Тип данных |
Входные полигоны | Полигоны, использующиеся для суммирования объектов или части объектов во входном суммируемом слое. | Feature Layer |
Входные суммируемые объекты | Точечные, линейные или полигональные объекты, которые будут суммироваться для каждого входного полигона. | Feature Layer |
Выходной класс пространственных объектов | Выходной класс полигональных объектов с идентичными входным полигонам геометрией и атрибутами, а также новыми атрибутами, содержащими информацию о числе точек, длине линий, площади полигонов внутри каждой зоны и статистическим данными этих объектов. | Feature Class |
Сохранить все входные полигоны (Дополнительный) | Определяет, будут ли скопированы в выходной класс объектов все входные полигоны либо только пересекающие или содержащие как минимум один из входных суммированных объектов.
| Boolean |
Поля суммирования (Дополнительный) | Список имен атрибутивных полей входных суммируемых объектов и типы статистического суммирования, которые будут выполняться для этих полей – для всех точек в каждом полигоне. Поля суммирования должны быть числовыми. Текстовые поля и поля других типов не поддерживаются. Есть следующие типы статистики:
| Value Table |
Добавить суммированные атрибуты объекта (Дополнительный) | Определяет, будут ли такие атрибуты, как число точек, длина линий и площадь полигонов, суммированные для каждого входного полигона, добавляться в выходной класс.
| Boolean |
Единицы измерения объекта (Дополнительный) | Единицы, в которых будут вычисляться суммированные атрибуты объекта. Если входными данными являются точки, единицы не обязательны, поскольку в этом случае добавляется только число точек в каждом входном полигоне. Если входными данными являются линии, укажите единицу измерения длины. Если входными данными являются полигоны, укажите единицу измерения площади.
| String |
Поле группы (Дополнительный) | Атрибутивное поле входных суммируемых объектов, используемое для группировки. Объекты, имеющие одинаковые значения поля группы, комбинируются и суммируются с другими объектами с теми же значениями поля группы. При задании группы необходим параметр Выходная таблица группировки. | Field |
Добавить атрибуты меньшинства и большинства (Дополнительный) | Определяет, будут ли добавляться к выходным данным поля меньшинства и большинства. Этот параметр позволит вам определить, какое значение поля группы относится к меньшинству (редко встречается), а какое – к большинству (часто встречается) для каждого входного полигона. Этот параметр активен, если вы задаете значение параметра Поле группировки.
| Boolean |
Добавить проценты в группе (Дополнительный) | Определяет, будет ли атрибутивное поле процентов добавляться к выходным данным. Этот параметр позволит вам вычислить процент для каждого значения атрибута в каждой группе. Этот параметр активен, если вы задаете значение параметра Поле группировки.
| Boolean |
Выходная таблица группировки (Дополнительный) | Выходная таблица, содержащая поля суммирования для каждой группы суммированных объектов для каждого входного полигона. Таблица будет содержать следующие поля атрибутов:
Этот параметр необходим, если задано значение параметра Поле группировки. | Table |
Краткая информация
Выполняет наложение полигонального слоя на другой слой для суммирования числа точек, длин линий и площадей полигонов, а также вычисляющий статистику атрибутивных полей объектов внутри полигонов.
Примеры использования инструмента Суммировать в пределах:
- Используя слой границ водоразделов и слой с границами типов землепользования, можно определить общую площадь земель различных типов для каждого водораздела.
- Используя слой земельных участков в округе и слой с границами городов, можно вычислить среднюю стоимость свободных участков в границах городов.
- Имеется слой округов и слой дорог, вычисляется общая протяженность дорог каждого типа в пределах округов.
Иллюстрация
Использование
Инструмент Суммировать в пределах можно использовать, если у вас есть два слоя: входные полигоны и входные объекты суммирования, и вы накладываете их друг на друга. После наложения этих слоев посмотрите на нижележащие и посчитайте число входных суммируемых объектов, попадающих внутрь входных полигонов. Вы можете не только посчитать число объектов, но и вычислить несложную статистику атрибутов входных объектов, которые суммируются: сумму, среднее значение, максимум, минимум и т.д.
Инструменты Суммировать в пределах и Суммировать близлежащие очень похожи. С помощью инструмента Суммировать в пределах вы суммируете объекты в пределах существующих полигонов. С помощью инструмента Суммировать близлежащие вы создаете области вокруг точек, линий и полигонов, а затем суммируете объекты в пределах этих вычисленных областей.
Вы можете создавать группы, задав для входных точек поле группы. К примеру, при суммировании преступлений, совершенных в пределах соседних границ, можно выбрать атрибут Crime_type, который может содержать пять разных видов преступлений. Каждая группа представляет уникальный тип преступления, и выбранный вами тип статистики может быть вычислен для каждого уникального значения в поле Crime_type.
Параметры
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: Да