Полигон разделения (Анализ)

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

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

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

Иллюстрация

Иллюстрация инструмента Полигон разделения
Отображается частичная сумма входных атрибутов в целевом объекте.

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

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

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

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

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

  • Инструмент учитывает параметр среды Коэффициент параллельной обработки. Если параметр среды не задан (по умолчанию), или задано значение, равное 100, будет включена полная параллельная обработка, и инструмент будет пытаться задействовать все логические ядра процессора компьютера. Установка параметры среды равным 0 отключит параллельную обработку. Присвоение коэффициенту значения от 1 до 99 приведет к тому, что инструмент определит процент логических ядер для использования по формуле (Коэффициент параллельной обработки / 100 * Логические ядра), округлив результат до ближайшего целого значения. Если результат равен 0 или 1, параллельная обработка не будет включена.

Параметры

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

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

Feature Layer
Поля для разделения

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

Field
Целевые полигоны

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

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

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

Feature Class
Метод разделения

Задает метод, используемый для разделения полей входных полигонов в целевых полигонах.

  • ПлощадьВеличина, которую каждый входной полигон вносит в суммированные значения для каждого целевого объекта, определяется площадью перекрытия между двумя объектами. Если входной объект перекрывает два целевых объекта на одинаковую величину, разделенные поля будут разделены на две части и будут вносить вклад в оба целевых объекта на половину общего значения. Это значение по умолчанию
  • ДлинаАтрибуты из входных объектов будут разделены на основе процентного соотношения части линии, находящийся в пределах каждого целевого объекта. В вычислениях участвует только линия, пересекающая входной объект. Линия, находящаяся вне его, исключается. Например, если один целевой объект покрывает 750 метров линии, а другой - 250 метров, 75% (750 / 1000) атрибутивных значений входного объекта будут агрегированы с первым целевым объектом, и 25% (250 / 1000) - со вторым.
  • ТочкиАтрибуты из входных объектов будут разделены на основе числа точек внутри каждого целевого объекта, пересекающегося с входным. Точки, находящиеся вне входного объекта, исключаются. Дополнительно можно задать поле веса, таким образом, общий вес всех точек в пределах каждого целевого объекта будет использован для определения способа деления атрибутивных значений входных объектов. Например, если два целевых объекта покрывают один входной, и внутри первого целевого объекта находится две точки, а внутри второго - 8, 20% (2 / 10) атрибутивных значений входного объекта будут агрегированы с первым целевым объектом, и 80% (8 / 10) - со вторым.
String
Объекты оценки
(Дополнительный)

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

Feature Layer
Поле веса
(Дополнительный)

Числовое поле из слоя целевых полигонов, которое используется для настройки того, какие целевые полигоны получают более крупные разделенные значения из полей входных полигонов для разделения. Цели с более высоким весом распределяются с более высоким соотношением значений поля.

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

Field
Поддержка целевой геометрии
(Дополнительный)

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

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

Boolean

arcpy.analysis.ApportionPolygon(in_features, apportion_fields, target_features, out_features, method, {estimation_features}, {weight_field}, {maintain_geometries})
ИмяОписаниеТип данных
in_features

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

Feature Layer
apportion_fields
[apportion_fields,...]

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

Field
target_features

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

Feature Layer
out_features

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

Feature Class
method

Задает метод, используемый для разделения полей входных полигонов в целевых полигонах.

  • AREAВеличина, которую каждый входной полигон вносит в суммированные значения для каждого целевого объекта, определяется площадью перекрытия между двумя объектами. Если входной объект перекрывает два целевых объекта на одинаковую величину, разделенные поля будут разделены на две части и будут вносить вклад в оба целевых объекта на половину общего значения. Это значение по умолчанию
  • LENGTHАтрибуты из входных объектов будут разделены на основе процентного соотношения части линии, находящийся в пределах каждого целевого объекта. В вычислениях участвует только линия, пересекающая входной объект. Линия, находящаяся вне его, исключается. Например, если один целевой объект покрывает 750 метров линии, а другой - 250 метров, 75% (750 / 1000) атрибутивных значений входного объекта будут агрегированы с первым целевым объектом, и 25% (250 / 1000) - со вторым.
  • POINTSАтрибуты из входных объектов будут разделены на основе числа точек внутри каждого целевого объекта, пересекающегося с входным. Точки, находящиеся вне входного объекта, исключаются. Дополнительно можно задать поле веса, таким образом, общий вес всех точек в пределах каждого целевого объекта будет использован для определения способа деления атрибутивных значений входных объектов. Например, если два целевых объекта покрывают один входной, и внутри первого целевого объекта находится две точки, а внутри второго - 8, 20% (2 / 10) атрибутивных значений входного объекта будут агрегированы с первым целевым объектом, и 80% (8 / 10) - со вторым.
String
estimation_features
(Дополнительный)

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

Feature Layer
weight_field
(Дополнительный)

Числовое поле из слоя целевых полигонов, которое используется для настройки того, какие целевые полигоны получают более крупные разделенные значения из полей входных полигонов для разделения. Цели с более высоким весом распределяются с более высоким соотношением значений поля.

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

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

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

  • MAINTAIN_GEOMETRIESВыходной класс пространственных объектов сохранит исходную геометрию целевого полигонального слоя. Это значение по умолчанию
  • INTERSECT_GEOMETRIESВыходной класс пространственных объектов будет геометрическим пересечением целевых полигонов и входных полигонов. В выходные данные будут включены только области целевых полигонов, которые перекрывают входной полигон.
Boolean

Пример кода

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

Пример скрипта в окне Python для использования функции ApportionPolygon.

import arcpy
arcpy.env.workspace = "C:/data/MyAnalysis.gdb"
arcpy.ApportionPolygon_analysis(
        "CensusBlockGroups", "Pop2020", "StoreServiceArea", 
        "StoreServiceArea_w_Population", "AREA", "", "", "MAINTAIN_GEOMETRIES")
ApportionPolygon, пример 2 (автономный скрипт)

Следующий автономный скрипт переносит взвешенное по площади население из слоя групп блоков переписи в полигон области обслуживания магазина.

# Name: Store Service Area Get Population.py
# Description: Use apportionment to transfer population figures to different 
#              geometry.

# Import system modules 
import arcpy

# Set environment settings
arcpy.env.workspace = "C:/data/MyAnalysis.gdb"

# Perform apportionment
inputDataWithPop = "CensusBlockGroups"
popField = "Pop2020"
targetServiceAreas = "Store_ServiceAreas"
outputApp = "Store_ServiceAreas_w_Population"
apportionMethod = "AREA"
keepTargetGeom = "MAINTAIN_GEOMETRIES"
arcpy.ApportionPolygon_analysis(inputDataWithPop, popField, targetServiceAreas, 
                                outputApp, apportionMethod, "", "", 
                                keepTargetGeom)

# Summarize store service area populations by store admin region
outStats = "PopulationPerSalesRegion_tlb"
statsFields = [["Pop2020", "SUM"]]
regionField = "SalesRegion" # Values like North, North-East, etc.
arcpy.Statistics_analysis(outputApp, outStats, statsFields, regionField)

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

  • Basic: Да
  • Standard: Да
  • Advanced: Да

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