Полигон разделения (Инструменты Анализа)

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

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

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

Примечание:

Инструмент Обогатить слой использует настройки агрегирования и распределения для суммирования данных.
Инструмент Полигон разделения аналогичен инструменту Обогатить слой. Однако инструмент Полигон разделения использует заданное разделение, а Обогатить слой использует точки U.S. Census Block или глобальные точки населенных пунктов для распределения. Для получения дополнительной информации см. Распределение данных.

Иллюстрация

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

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

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

Подпись	Объяснение	Тип данных
Входные полигоны	Полигональные объекты, имеющие числовые атрибуты, которые будут суммироваться в целевую полигональную геометрию.	Feature Layer
Поля для разделения	Числовые поля входных полигонов, которые будут суммированы по каждому целевому полигону и записаны в выходной класс пространственных объектов. Столбцы таблицы значений: Apportion Field–The apportioned field attribute values that will be used to calculate the specified statistic. Statistic Method–The statistic method that will be used on the apportioned values. Sum–The values for the specified field will be added together. Use this statistic for count-based attributes. This is the default. Mean–The average for the specified field will be calculated. Use this statistic for rate-based attributes, such as population percentages. This option is only valid when the Apportion Method parameter is set to Area. Median–The median of the specified field will be calculated. Use this statistic for rate-based attributes, such as population percentages. This option is only valid when the Apportion Method parameter is set to Area.	Value Table
Целевые полигоны	Полигональные объекты и их разделяемые поля, которые будут скопированы в выходной класс пространственных объектов.	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 [[field, {statistic_type}],...]	Числовые поля входных полигонов, которые будут суммированы по каждому целевому полигону и записаны в выходной класс пространственных объектов. Столбцы таблицы значений: `Apportion Field`–The apportioned field attribute values that will be used to calculate the specified statistic. `Statistic Method`–The statistic method that will be used on the apportioned values. `SUM`–The values for the specified field will be added together. Use this statistic for count-based attributes. This is the default. `MEAN`–The average for the specified field will be calculated. Use this statistic for rate-based attributes, such as population percentages. This option is only valid when the Apportion Method parameter is set to Area. `MEDIAN`–The median of the specified field will be calculated. Use this statistic for rate-based attributes, such as population percentages. This option is only valid when the Apportion Method parameter is set to Area.	Value Table
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.analysis.ApportionPolygon(
        "CensusBlockGroups", "Pop2020", "StoreServiceArea",
        "StoreServiceArea_w_Population", "AREA", "", "", "MAINTAIN_GEOMETRIES")

ApportionPolygon, пример 2 (автономный скрипт)

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

# 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.analysis.ApportionPolygon(inputDataWithPop, popField, targetServiceAreas,
                                outputApp, apportionMethod, "", "",
                                keepTargetGeom)

# Summarize store service area populations by store admin region
outStats = "PopulationPerSalesRegion_tlb"
statsFields = [["Pop2020", "SUM"]]
regionField = "SalesRegion"  # Values such as North, North-East, etc.

arcpy.analysis.Statistics(outputApp, outStats, statsFields, regionField)

ApportionPolygon, пример 3 (автономный скрипт)

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

# Import system modules
import arcpy

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

# Perform apportionment
inputDataWithPop = "CensusBlockGroups"
popField = [["POP2000", "MEAN"], ["SUM_Incide", "MEDIAN"]]
targetServiceAreas = "Store_ServiceAreas"
outputApp = "Store_ServiceAreas_w_Population"
apportionMethod = "AREA"
keepTargetGeom = "MAINTAIN_GEOMETRIES"

arcpy.analysis.ApportionPolygon(inputDataWithPop, popField, targetServiceAreas,
                                outputApp, apportionMethod, "", "",
                                keepTargetGeom)

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

Текущая рабочая область, Временная рабочая область, Выходная система координат, Экстент, Коэффициент параллельной обработки

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

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