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

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

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

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

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

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

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

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

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

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

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

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

Параметры

Диалог

Подпись	Описание	Тип данных
Входная таблица или объекты	Таблица или объекты, содержащие поля количества и генеральной совокупности для вычисления долей.	Table View
Поля долей	Поля количества и генеральной совокупности, которые будут использоваться для вычисления долей.	Value Table
Присоединить поля к входным данным (Дополнительный)	Определяет, будут ли поля присоединяться к входному набору данных или сохраняться в выходной таблице или классе объектов. Отмечено — поля будут присоединены к входным объектам. Это изменяет входные данные. Не отмечено — будет создана выходная таблица или класс пространственных объектов, содержащие поля. Это значение по умолчанию	Boolean
Выходная таблица или объекты (Дополнительный)	Выходная таблица или класс объектов, содержащие доли и дополнительные поля, помогающие оценить значения долей.	Feature Class; Table
Метод вычисления долей (Дополнительный)	Определяет метод, который будет использоваться для расчета долей. Общая доля—Доли будут вычисляться путем деления значений поля количества на значения поля генеральной совокупности. Это значение по умолчанию Глобальный эмпирический байес—Доли будут представлять собой средневзвешенное значение общей доли и средней глобальной доли. Вес будет зависеть от размера генеральной совокупности объектов. Локальный эмпирический байес—Доли будут представлять собой средневзвешенное значение общей доли фокального объекта и средневзвешенное значение доли по его окрестности. Локально взвешенное среднее—Доли будут представлять пространственно-взвешенную среднюю долю каждого объекта и его окрестности. Локально взвешенная медиана—Доли будут представлять пространственно-взвешенную медианную долю каждого объекта и его окрестности.	String
Распределение вероятностей	Определяет распределение вероятностей по полю количества. Пуассон—Предполагается, что поле количества соответствует распределению Пуассона. Это значение по умолчанию Биномиальный—Предполагается, что поле количества соответствует биномиальному распределению.	String
Тип окрестности (Дополнительный)	Указывает метод, который будет использоваться для определения соседей каждого объекта. Диапазон расстояний—Для идентификации соседей применяется пороговое расстояние. Каждый объект, находящийся в пределах порогового расстояния фокального объекта, считается соседом. Если входные данные содержат точечные или линейные объекты, это используется по умолчанию. Только совпадающие ребра—Полигональные объекты, имеющие общее ребро или перекрывающие объект, становятся соседями этого объекта. Углы соприкасающихся ребер—Объекты, которые перекрываются, имеют общее ребро или имеют общую вершину с объектом, являются соседями этого объекта. Если входные данные содержат полигональные объекты, это используется по умолчанию. К- ближайшие соседи—Каждому объекту присваивается одинаковое количество соседей, 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: Да