Суммировать в пределах (Анализ)

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

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

Вот примеры использования инструмента Суммировать в пределах:

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

Иллюстрация

Инструмент Суммировать в пределах; иллюстрация

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

  • Инструмент Суммировать в пределах можно использовать, если у вас есть два слоя: входные полигоны и входные объекты суммирования, и вы накладываете их друг на друга. После наложения этих слоев можно посмотреть на нижележащие и посчитать число входных суммируемых объектов, попадающих внутрь входных полигонов. Можно также вычислить несложную статистику атрибутов входных объектов, которые суммируются: сумму, среднее значение, минимум, максимум и т.д.

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

  • Вы можете создавать группы, задав для входных точек поле группы. Например, при суммировании преступлений, совершенных в пределах соседних границ, можно выбрать атрибут Crime_type, который может содержать пять видов преступлений. Каждая группа представляет уникальный тип преступления, и выбранный вами тип статистики может быть вычислен для каждого уникального значения в поле Crime_type.

  • Пустые значения не включаются в расчет статистики. Например, среднее 10, 5 и null будет 7.5 ((10+5) / 2).

Параметры

ПодписьОписаниеТип данных
Входные полигоны

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

Feature Layer
Входные суммируемые объекты

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

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

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

Feature Class
Сохранить все входные полигоны
(Дополнительный)

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

  • Отмечено – в выходной класс объектов будут скопированы все входные полигоны. Используется по умолчанию.
  • Не отмечено – в выходной класс объектов будут скопированы только полигоны, пересекающие или содержащие как минимум один из входных суммированных объектов.
Boolean
Поля суммирования
(Дополнительный)

Список имен атрибутивных полей входных суммируемых объектов и типы статистического суммирования, которые будут выполняться для этих полей – для всех точек в каждом полигоне.

Поля суммирования должны быть числовыми. Текстовые поля и поля других типов не поддерживаются.

Есть следующие типы статистики:

  • Сумма – вычисляется итоговое значение для всех точек в каждом полигоне.
  • Среднее – вычисляется среднее значение для всех точек в каждом полигоне.
  • Минимум – находится минимальное значение среди всех точек в каждом полигоне.
  • Максимум – находится максимальное значение среди всех точек в каждом полигоне.
  • Ср. кв. откл. – вычисляется среднеквадратическое отклонение для всех точек в каждом полигоне.

Value Table
Добавить суммированные атрибуты объекта
(Дополнительный)

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

  • Отмечено – суммированные атрибуты объекта будут добавляться в выходной класс объектов. Используется по умолчанию.
  • Не отмечено – суммированные атрибуты объекта не будут добавляться в выходной класс объектов.
Boolean
Единицы измерения объекта
(Дополнительный)

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

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

  • МетрыЕдиницами измерения будут метры.
  • KilometersЕдиницами измерения будут километры.
  • ФутыЕдиницами измерения будут футы.
  • ЯрдыЕдиницами измерения будут ярды.
  • МилиЕдиницами измерения будут мили.
  • АкрыЕдиницами измерения будут акры.
  • ГектарыЕдиницами измерения будут гектары.
  • Квадратные метрыЕдиницами измерения будут квадратные метры.
  • Квадратные километрыЕдиницами измерения будут квадратные километры.
  • Квадратные футыЕдиницами измерения будут квадратные футы.
  • Квадратные ярдыЕдиницами измерения будут квадратные ярды.
  • Квадратные милиЕдиницами измерения будут квадратные мили.
String
Поле группы
(Дополнительный)

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

При задании группы необходим параметр Выходная таблица группировки.

Field
Добавить атрибуты меньшинства и большинства
(Дополнительный)

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

Этот параметр активен, если вы задаете значение параметра Поле группировки.

  • Не отмечено – поля меньшинства и большинства не будут добавляться к выходным данным. Используется по умолчанию.
  • Отмечено – поля меньшинства и большинства будут добавляться к выходным данным.
Boolean
Добавить проценты в группе
(Дополнительный)

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

Этот параметр активен, если вы задаете значение параметра Поле группировки.

  • Не отмечено – атрибутивное поле процентов не будет добавляться к выходным данным. Используется по умолчанию.
  • Отмечено – атрибутивное поле процентов будет добавляться к выходным данным.
Boolean
Выходная таблица группировки
(Дополнительный)

Выходная таблица, содержащая поля суммирования для каждой группы суммированных объектов для каждого входного полигона.

Таблица будет содержать следующие поля атрибутов:

  • Join_ID– Идентификатор, соответствующий полю ID, добавленному в выходной класс объектов.
  • Поле группы
  • Поле суммирования геометрии
  • Одно поле для каждого суммируемого поля.
  • Поле процента

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

Table

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
(Дополнительный)

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

  • KEEP_ALLВ выходной класс объектов будут скопированы все входные полигоны. Используется по умолчанию.
  • ONLY_INTERSECTINGВ выходной класс объектов будут скопированы только полигоны, пересекающие или содержащие как минимум один из входных суммированных объектов.
Boolean
sum_fields
[[summary_field, statistic_type],...]
(Дополнительный)

Список имен атрибутивных полей входных суммируемых объектов и типы статистического суммирования, которые будут выполняться для этих полей – для всех точек в каждом полигоне.

Поля суммирования должны быть числовыми. Текстовые поля и поля других типов не поддерживаются.

Есть следующие типы статистики:

  • Сумма – вычисляется итоговое значение для всех точек в каждом полигоне.
  • Среднее – вычисляется среднее значение для всех точек в каждом полигоне.
  • Минимум – находится минимальное значение среди всех точек в каждом полигоне.
  • Максимум – находится максимальное значение среди всех точек в каждом полигоне.
  • Ср. кв. откл. – вычисляется среднеквадратическое отклонение для всех точек в каждом полигоне.

Value Table
sum_shape
(Дополнительный)

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

  • ADD_SHAPE_SUMСуммированные атрибуты объекта будут добавляться в выходной класс объектов. Используется по умолчанию.
  • NO_SHAPE_SUMСуммированные атрибуты объекта не будут добавляться в выходной класс объектов.
Boolean
shape_unit
(Дополнительный)

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

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

  • METERSЕдиницами измерения будут метры.
  • KILOMETERSЕдиницами измерения будут километры.
  • FEETЕдиницами измерения будут футы.
  • YARDSЕдиницами измерения будут ярды.
  • MILESЕдиницами измерения будут мили.
  • ACRESЕдиницами измерения будут акры.
  • HECTARESЕдиницами измерения будут гектары.
  • SQUAREMETERSЕдиницами измерения будут квадратные метры.
  • SQUAREKILOMETERSЕдиницами измерения будут квадратные километры.
  • SQUAREFEETЕдиницами измерения будут квадратные футы.
  • SQUAREYARDSЕдиницами измерения будут квадратные ярды.
  • SQUAREMILESЕдиницами измерения будут квадратные мили.
String
group_field
(Дополнительный)

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

При задании группы необходим параметр out_grouped_table.

Field
add_min_maj
(Дополнительный)

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

Этот параметр включен, если вы задаете значение параметра group_field.

  • NO_MIN_MAJПоля меньшинства и большинства не будут добавляться к выходным данным. Используется по умолчанию.
  • ADD_MIN_MAJПоля меньшинства и большинства будут добавляться к выходным данным.
Boolean
add_group_percent
(Дополнительный)

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

Этот параметр включен, если вы задаете значение параметра group_field.

  • NO_PERCENTАтрибутивное поле процентов не будет добавляться к выходным данным. Используется по умолчанию.
  • ADD_PERCENTАтрибутивное поле процентов будет добавляться к выходным данным.
Boolean
out_group_table
(Дополнительный)

Выходная таблица, содержащая поля суммирования для каждой группы суммированных объектов для каждого входного полигона.

Таблица будет содержать следующие поля атрибутов:

  • Join_ID– Идентификатор, соответствующий полю ID, добавленному в выходной класс объектов.
  • Поле группы
  • Поле суммирования геометрии
  • Одно поле для каждого суммируемого поля.
  • Поле процента

Этот параметр необходим, если задано значение параметра group_field.

Table

Пример кода

SummarizeWithin, пример 1 (окно Python)

Следующий скрипт окна Python демонстрирует использование функции SummarizeWithin.

import arcpy
arcpy.env.workspace = 'C:/data/city.gdb'
arcpy.analysis.SummarizeWithin('neighborhoods', 'crimes', 'neighborhood_crimes')
SummarizeWithin, пример 2 (автономный скрипт)

Следующий автономный скрипт – пример использования функции 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: Да

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