Суммировать в пределах (Стандартный анализ объектов)

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

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

Ниже приведены примеры сценариев использования этого инструмента:

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

Иллюстрация

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

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

  • Этот инструмент можно представить себе как два слоя, наложенные друг на друга. Например, все объекты в одном из слоев, входном слое полигонов, покрашены красным цветом. В другом слое входные объекты для суммирования могут быть любого типа – точки, линии или полигоны. После наложения этих слоев один на другой всмотритесь и сосчитайте, сколько объектов во входном векторном слое для суммирования попадает внутрь полигонов с красными границами (входные полигоны). Вы можете не только посчитать число объектов, но и вычислить простую статистику об атрибутах объектов входного суммируемого векторного слоя, например: сумму, среднее значение, максимум, минимум и т.д.

Параметры

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

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

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

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

Feature Set
Выходное имя

Имя выходного слоя, который будет создано на вашем портале.

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

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

  • Отмечено – статистика будет рассчитана на основе суммированных атрибутов объекта. Это значение по умолчанию
  • Не отмечено – статистика не будет рассчитана на основе суммированных атрибутов объекта.

Boolean
Единицы измерения объекта
(Дополнительный)

Указывает единицы измерения, которые будут использоваться для суммирования геометрии.

Если объекты суммирования – полигоны, то допустимыми вариантами являются акры, гектары, квадратные метры, квадратные километры, квадратные футы, квадратные ярды и квадратные мили.

Если объекты суммирования – линии, то допустимыми вариантами являются мили, футы, километры, метры и ярды.

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

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

Поддерживаются следующие типы статистики:

  • Сумма – будет вычислено суммарное значение.
  • Минимум – будет определено наименьшее значение.
  • Максимум – будет определено наибольшее значение.
  • Среднее – будет вычислено среднее или среднее арифметическое значение.
  • Среднеквадратическое отклонение – будет вычислено среднеквадратическое отклонение.

Value Table
Группировать по полю
(Дополнительный)

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

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

Определяет, будут ли добавляться к выходным данным поля меньшинства и большинства.

Этот параметр применяется только при использовании параметра Группировать по полю.

  • Не отмечено – поля меньшинства и большинства не будут добавляться к выходным данным. Это значение по умолчанию
  • Отмечено — будет вычислено меньшинство (наиболее редко встречающиеся) или большинство (наиболее часто встречающиеся) среди атрибутивных значений для каждого поля группы в пределах каждой границы, а в выходные данные будут добавлены два новых поля с префиксом Minority_ и Majority_.

Boolean
Добавить проценты в группе
(Дополнительный)

Задает, будут ли добавлены поля процентов в группе в выходные данные.

Этот параметр применяется только при использовании параметра Группировать по полю.

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

Boolean

Производные выходные данные

ПодписьОписаниеТип данных
Выходной сервис пространственных объектов

Выходной суммированный слой.

Feature Set
Выходная таблица группировки

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

Record Set

arcpy.sfa.SummarizeWithin(sumWithinLayer, summaryLayer, outputName, {sumShape}, {shapeUnits}, {summaryFields}, {groupByField}, {minorityMajority}, {percentShape})
ИмяОписаниеТип данных
sumWithinLayer

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

Feature Set
summaryLayer

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

Feature Set
outputName

Имя выходного слоя, который будет создано на вашем портале.

String
sumShape
(Дополнительный)

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

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

Указывает единицы измерения, которые будут использоваться для суммирования геометрии.

Если объекты суммирования – полигоны, то допустимыми вариантами являются акры, гектары, квадратные метры, квадратные километры, квадратные футы, квадратные ярды и квадратные мили.

Если объекты суммирования – линии, то допустимыми вариантами являются мили, футы, километры, метры и ярды.

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

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

Поддерживаются следующие типы статистики:

  • SUM – будет вычислено суммарное значение.
  • MIN – будет определено наименьшее значение.
  • MAX – будет определено наибольшее значение.
  • MEAN – будет вычислено среднее или среднее арифметическое значение.
  • STD – будет вычислено среднеквадратическое отклонение.

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

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

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

Определяет, будут ли добавляться к выходным данным поля меньшинства и большинства.

Этот параметр применяется только при использовании параметра groupByField.

  • NO_MIN_MAJПоля меньшинства и большинства не будут добавляться к выходным данным. Это значение по умолчанию
  • ADD_MIN_MAJБудет вычислено меньшинство (наиболее редко встречающиеся) или большинство (наиболее часто встречающиеся) среди атрибутивных значений для каждого поля группы в пределах каждой границы, а в выходные данные будут добавлены два новых поля с префиксом Minority_ и Majority_.
Boolean
percentShape
(Дополнительный)

Задает, будут ли добавлены поля процентов в группе в выходные данные.

Этот параметр применяется только при использовании параметра groupByField.

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

Производные выходные данные

ИмяОписаниеТип данных
outputLayer

Выходной суммированный слой.

Feature Set
groupBySummaryLayer

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

Record Set

Параметры среды

Информация о лицензиях

  • Basic: Обязательно Ваша учетная запись в ArcGIS Enterprise содержит права доступа на Выполнение анализа
  • Standard: Обязательно Ваша учетная запись в ArcGIS Enterprise содержит права доступа на Выполнение анализа
  • Advanced: Обязательно Ваша учетная запись в ArcGIS Enterprise содержит права доступа на Выполнение анализа

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