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

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

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

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

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

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

  • Инструмент предоставляет несколько вариантов параметра Тип окрестности. Для дальнейшей настройки окрестностей и экспорта в файл .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 объектов, ближайших к объекту, становятся его соседями.
    K ближайших соседей
  • Триангуляция ДелонеСеть неперекрывающихся треугольников создается на основе центроидов объектов. Каждый объект – это узел треугольника, а узлы с общими ребрами считаются соседями.
    Сокращенная триангуляция Делоне
  • Получить пространственные веса из файлаПространственные отношения между объектами определены в файле матрицы пространственных весов (.swm).
String
Диапазон расстояний
(Дополнительный)

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

Linear Unit
Число соседей
(Дополнительный)

Количество соседей, которые будут включены в окрестность объектов.

Long
Матрица пространственных весов
(Дополнительный)

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

File
Локальная схема весов
(Дополнительный)

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

  • Не взвешеннаяСоседи взвешиваться не будут. Это значение по умолчанию
  • БиквадратнаяСоседи будут взвешены с использованием схемы биквадратного ядра.
  • ГауссоваСоседи будут взвешены с использованием схемы Гауссова ядра.
String
Ширина ядра
(Дополнительный)

Ширина биквадратной или Гауссовой схем локального взвешивания. Если значение не будет задано, оно будет получено в процессе обработки и показано в сообщении геообработки.

Linear Unit
Множитель долей

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

Long

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

ПодписьОписаниеТип данных
Обновленная входная таблица

Обновленная входная таблица.

Table View
Выходной составной слой

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

Group Layer

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 объектов, ближайших к объекту, становятся его соседями.
    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: Да

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