Вычислить доли (Пространственная статистика)

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

Рассчитывает общие или сглаженные доли. Метод вычисления доли Глобальный эмпирический байес сглаживает доли в направлении глобальной базовой доли. Методы вычисления доли Локальный эмпирический байес, Локального средневзвешенный и Локальный взвешенный медианный используют локальных соседей для пространственного сглаживания долей.

Подробнее о том, как работает инструмент Вычислить доли

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

• Если значением параметра Входные объекты или таблица является таблица, опции параметра Метод вычисления доли будут ограничены вариантами Общая доля и Глобальный эмпирический байес. Методы Локальный эмпирический байес, Локальный средневзвешенный и Локальный взвешенный медианный корректны только для пространственных данных.

• Инструмент предоставляет несколько опций параметра Тип окрестности. Однако для дальнейшей настройки окрестностей используйте Проводник окрестности для настройки окрестностей и экспорта файла .swm. Используйте файл .swm в качестве значения параметра Матрица пространственных весов.

• Если значения долей малы, их может быть трудно интерпретировать. Используйте параметр Множитель долей, чтобы масштабировать доли или представить доли на конкретную единицу населения. Например, если значение Множитель долей равно 10 000, показатели будут представлены в виде числа на 10 000 человек.

• Если выбран метод пространственного сглаживания, каждый фокальный объект будет включен в свою собственную окрестность. Например, если значение параметра Тип окрестности равно Ближайшая окрестность K, а значение параметра Количество соседей равно 7, каждый объект будет иметь соседство с 8 объектами. Для расчета доли фокального объекта используется вся окрестность.

• Если для параметра Метод вычисления доли задан метод Локальный эмпирический байес, Локальный средневзвешенный или Локальный взвешенный медианный, в выходных данных будет присутствовать поле Number of Non-Null Neighbors. Это поле содержит количество соседей, включая фокальный объект, у которых значения параметров Поле генеральной совокупности и Поле количества не были отрицательными или пустыми.

• Объекты со значением 0 в поле Поле генеральной совокупности получат значение общей доли null.

• Если для параметра Метод вычисления доли задан Локальный средневзвешенный или Локальный взвешенный медианный, в выходных данных будет присутствовать поле Fill Missing Value. Это поле показывает, была ли вычислена доля для объекта с отрицательным или пустым значением в Поле количества или Поле генеральной совокупности.

Параметры

Диалог

Подпись	Описание	Тип данных
Входная таблица или объекты	Таблица или объекты, содержащие поля количества и поля генеральной совокупности для расчета долей.	Table View
Поля доли	Поле количества и поле генеральной совокупности, которые будут использованы для расчета долей.	Value Table
Присоединение полей к входным данным (Дополнительный)	Задает, будут ли поля добавлены к входному набору данных или сохранены в выходной таблице или классе объектов. Отмечено — поля будут добавлены к входным объектам. Это изменяет входные значения. Не отмечено — будет создана выходная таблица или класс объектов, содержащие поля. Используется по умолчанию.	Boolean
Выходные объекты или Таблица (Дополнительный)	Выходная таблица или класс объектов, содержащие доли и дополнительные поля для оценки долей.	Feature Class; Table
Метод вычисления доли (Дополнительный)	Определяет метод, который будет использован для вычисления долей. Общая доля—Доли будут вычислены путем деления значений из поля количества на значения из поля генеральной совокупности. Используется по умолчанию. Глобальный эмпирический байес—Доли будут представлять собой средневзвешенное значение общей доли и глобальной средней доли. Вес будет зависеть от размера совокупности объекта. Локальный эмпирический байес—Доли будут представлять собой средневзвешенное значение общей доли основного объекта и средневзвешенной доли по его окрестностям. Локальный средневзвешенный—Доли будут представлять собой пространственно взвешенные средние доли для каждого объекта и его окрестностей. Локальный взвешенный медианный—Доли будут представлять собой пространственно взвешенную медианную долю для каждого объекта и его окрестностей.	String
Распределение вероятностей	Определяет распределение вероятности для поля количества. Пуассона—Предполагается, что поле количества соответствует распределению Пуассона. Используется по умолчанию. Биномиальный—Предполагается, что поле количества соответствует биномиальному распределению.	String
Тип окрестности (Дополнительный)	Указывает метод, который будет использоваться для определения соседей каждого объекта. Диапазон расстояний—Применяется пороговое расстояние для идентификации соседей. Каждый объект, находящийся в пределах порогового расстояния фокусного объекта, считается соседом. Если входные данные содержат точечные или линейные элементы, это используется по умолчанию. Только совпадающие ребра—Полигональные объекты, имеющие общее ребро или перекрывающие объект, становятся соседями этого объекта. Углы соприкасающихся ребер—Объекты, которые перекрываются, имеют общее ребро или имеют общую вершину с объектом, являются соседями этого объекта. Если входные данные содержат полигональные объекты, это используется по умолчанию. K ближайших соседей—Каждому объекту назначается одинаковое количество соседей - k. K объектов, ближайших к объекту, становятся его соседями. Триангуляция Делоне—Создается сеть неперекрывающихся треугольников на основе центроидов объектов. Каждый объект – это узел треугольника, а узлы с общими ребрами считаются соседями. Получить пространственные веса из файла—Пространственные отношения между объектами определяются в файле матрицы пространственных весов (.swm).	String
Диапазон расстояний (Дополнительный)	Расстояние от каждого объекта, которое будет использоваться для поиска соседей. Все объекты в пределах этого расстояния будут считаться соседними.	Linear Unit
Число соседей (Дополнительный)	Количество соседей, которые будут включены в окрестности объекта.	Long
Матрица пространственных весов (Дополнительный)	Путь и имя файла матрицы пространственных весов, определяющей пространственные отношения между объектами.	File
Локальная схема весов (Дополнительный)	Указывает схему весов, которая будет применяться к соседям при подсчете локальной статистики. Невзвешенный—Соседи не будут иметь веса. Используется по умолчанию. Биквадратная—Соседям будет присвоен вес с использованием схемы биквадратного ядра. Гауссова—Соседям будет присвоен вес с использованием схемы Гауссова ядра.	String
Ширина полосы ядра (Дополнительный)	Ширина полосы биквадратной или гауссовой локальной схемы весов. Если значение не указано, оно будет рассчитано в процессе обработки и включено в сообщение о геообработке.	Linear Unit
Множитель долей	Постоянное значение, на которое будут умножены доли. Этот параметр можно использовать, чтобы масштабировать доли или представить доли на конкретную единицу населения. Например, если значение установлено на 10 000, показатели будут представлены в виде числа на 10 000 человек.	Long

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

Подпись	Описание	Тип данных
Обновленная входная таблица	Обновленная входная таблица.	Table View
Выходной составной слой	Если для параметра Входные объекты или таблица указан класс объектов, на выходе получается составной слой со слоем для каждой доли, указанной в параметре Поля доли.	Group Layer

Python

arcpy.stats.CalculateRates(in_table, rate_fields, {append_to_input}, {out_table}, {rate_method}, probability_distribution, {neighborhood_type}, {distance_band}, {number_of_neighbors}, {weights_matrix_file}, {local_weighting_scheme}, {kernel_bandwidth}, rate_multiplier)

Имя	Описание	Тип данных
in_table	Таблица или объекты, содержащие поля количества и поля генеральной совокупности для расчета долей.	Table View
rate_fields [[count_field, population_field],...]	Поле количества и поле генеральной совокупности, которые будут использованы для расчета долей.	Value Table
append_to_input (Дополнительный)	Задает, будут ли поля добавлены к входному набору данных или сохранены в выходной таблице или классе объектов. APPEND—Поля будут добавлены к входным объектам. Это изменяет входные значения. NO_APPEND—Будет создана выходная таблица или класс объектов, содержащие поля. Используется по умолчанию.	Boolean
out_table (Дополнительный)	Выходная таблица или класс объектов, содержащие доли и дополнительные поля для оценки долей.	Feature Class; Table
rate_method (Дополнительный)	Определяет метод, который будет использован для вычисления долей. CRUDE_RATE—Доли будут вычислены путем деления значений из поля количества на значения из поля генеральной совокупности. Используется по умолчанию. GLOBAL_EMPIRICAL_BAYES—Доли будут представлять собой средневзвешенное значение общей доли и глобальной средней доли. Вес будет зависеть от размера совокупности объекта. LOCAL_EMPIRICAL_BAYES—Доли будут представлять собой средневзвешенное значение общей доли основного объекта и средневзвешенной доли по его окрестностям. LOCALLY_WEIGHTED_AVERAGE—Доли будут представлять собой пространственно взвешенные средние доли для каждого объекта и его окрестностей. LOCALLY_WEIGHTED_MEDIAN—Доли будут представлять собой пространственно взвешенную медианную долю для каждого объекта и его окрестностей.	String
probability_distribution	Определяет распределение вероятности для поля количества. POISSON—Предполагается, что поле количества соответствует распределению Пуассона. Используется по умолчанию. BINOMIAL—Предполагается, что поле количества соответствует биномиальному распределению.	String
neighborhood_type (Дополнительный)	Указывает метод, который будет использоваться для определения соседей каждого объекта. DISTANCE_BAND—Применяется пороговое расстояние для идентификации соседей. Каждый объект, находящийся в пределах порогового расстояния фокусного объекта, считается соседом. Если входные данные содержат точечные или линейные элементы, это используется по умолчанию. CONTIGUITY_EDGES_ONLY—Полигональные объекты, имеющие общее ребро или перекрывающие объект, становятся соседями этого объекта. CONTIGUITY_EDGES_CORNERS—Объекты, которые перекрываются, имеют общее ребро или имеют общую вершину с объектом, являются соседями этого объекта. Если входные данные содержат полигональные объекты, это используется по умолчанию. K_NEAREST_NEIGHBORS—Каждому объекту назначается одинаковое количество соседей - k. K объектов, ближайших к объекту, становятся его соседями. DELAUNAY_TRIANGULATION—Создается сеть неперекрывающихся треугольников на основе центроидов объектов. Каждый объект – это узел треугольника, а узлы с общими ребрами считаются соседями. GET_SPATIAL_WEIGHTS_FROM_FILE—Пространственные отношения между объектами определяются в файле матрицы пространственных весов (.swm).	String
distance_band (Дополнительный)	Расстояние от каждого объекта, которое будет использоваться для поиска соседей. Все объекты в пределах этого расстояния будут считаться соседними.	Linear Unit
number_of_neighbors (Дополнительный)	Количество соседей, которые будут включены в окрестности объекта.	Long
weights_matrix_file (Дополнительный)	Путь и имя файла матрицы пространственных весов, определяющей пространственные отношения между объектами.	File
local_weighting_scheme (Дополнительный)	Указывает схему весов, которая будет применяться к соседям при подсчете локальной статистики. UNWEIGHTED—Соседи не будут иметь веса. Используется по умолчанию. BISQUARE—Соседям будет присвоен вес с использованием схемы биквадратного ядра. GAUSSIAN—Соседям будет присвоен вес с использованием схемы Гауссова ядра.	String
kernel_bandwidth (Дополнительный)	Ширина полосы биквадратной или гауссовой локальной схемы весов. Если значение не указано, оно будет рассчитано в процессе обработки и включено в сообщение о геообработке.	Linear Unit
rate_multiplier	Постоянное значение, на которое будут умножены доли. Этот параметр можно использовать, чтобы масштабировать доли или представить доли на конкретную единицу населения. Например, если значение установлено на 10 000, показатели будут представлены в виде числа на 10 000 человек.	Long

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

Имя	Описание	Тип данных
updated_table	Обновленная входная таблица.	Table View
output_layer_group	Если для параметра in_table указан класс объектов, на выходе получается составной слой со слоем для каждой доли, указанной в параметре rate_fields.	Group Layer

Пример кода

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

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

import arcpy
in_features = r"C:\Health.gdb\cancer_deaths"
out_features = r"C:\Health.gdb\cancer_rate"
rate_fields = "deaths_2024 population_2024; deaths_2023 population_2023"
rate_method = "Global Empirical Bayes"
distribution = "Poisson"
scaling_factor = 100000

arcpy.stats.CalculateRates(
    in_features, rate_fields, "NO_APPEND", out_features, rate_method,
    distribution, None, None, None, None, None, None, scaling_factor)

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

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

import arcpy

arcpy.env.workspace = r"C:\Health.gdb"

in_features = "cancer_deaths"
out_features = "cancer_rate"
rate_fields = "deaths_2024 population_2024; deaths_2023 population_2023"
rate_method = "RAW_RATE"
scaling_factor = 100000

arcpy.stats.CalculateRates(
    in_features, rate_fields,"NO_APPEND", out_features, rate_method, None, 
    None, None, None, None, None, None, scaling_factor)

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

Выходная система координат

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

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