计算比率 (空间统计)

摘要

计算粗率或平滑率。 全局经验贝叶斯率方法的平滑率至全局参考率。 局部经验贝叶斯、局部加权平均值和局部加权中位数率方法使用局部邻域来对空间进行平滑率操作。

了解有关计算比率工作的方法的详细信息

使用情况

• 如果输入表或要素参数值是表，则比率方法参数的选项将仅限于粗率和全局经验贝叶斯。 局部经验贝叶斯、局部加权平均值和局部加权中位数选项仅对空间数据有效。

• 工具提供了多个邻域类型参数选项。 但是，要进一步自定义邻域，请使用邻域浏览器配置邻域并导出 .swm 文件。 使用 .swm 文件作为空间权重矩阵参数值。

• 如果比率值很小，则可能难以解释。 使用比率乘数参数可缩放比率或报告每个特定人口单位的比率。 例如，如比率乘数值为 10,000，则比率将报告为每 10,000 人的数字。

• 如果选择空间平滑率方法，则每个焦点要素将包含在其自己的邻域中。 例如，如果邻域类型参数值为 K 个最近邻域，邻域数目参数值为 7，则每个要素将有一个包含 8 个要素的邻域。 整个邻域用于计算焦点要素的比率。

• 如果比率方法参数设置为局部经验贝叶斯、局部加权平均值或局部加权中位数，则输出将包含 Number of Non-Null Neighbors 字段。 此字段包含 Population 字段和计数字段参数值中没有负值或空值的相邻要素的数目（包括焦点要素）。

• Population 字段值中值为 0 的要素将收到空的粗率值。

• 如果比率方法参数设置为局部加权平均值或局部加权中位数，则输出将包含 Fill Missing Value 字段。 此字段指示是否为具有负数或空计数字段或 Population 字段值的要素插补了比率。

参数

对话框

标注	说明	数据类型
输入表或要素	包含用于计算比率的计数字段和 population 字段的表或要素。	Table View
比率字段	用于计算比率的计数和 population 字段。	Value Table
将字段追加到输入 (可选)	指定字段是追加到输入数据集还是保存到输出表或要素类。 选中 - 字段将追加到输入要素。 这会修改输入数据。 未选中 - 将创建包含字段的输出表或要素类。 这是默认设置。	Boolean
输出表或要素 (可选)	包含比率和有助于评估比率的附加字段的输出表或要素类。	Feature Class; Table
比率方法 (可选)	指定用于计算比率的方法。 粗率—比率将通过计数字段值除以 population 字段值来计算。 这是默认设置。 全局经验贝叶斯—比率将是粗率和全局平均速率的加权平均值。 权重取决于要素的人口规模。 局部经验贝叶斯—该比率将是焦点要素粗率与其邻域加权平均比率的加权平均值。 局部加权平均—比率将是每个要素及其邻域的空间加权平均率。 局部加权中位数—比率将是每个要素及其邻域的空间加权中位数率。	String
概率分布	指定计数字段的概率分布。 泊松—假设计数字段遵循泊松分布。 这是默认设置。 二项式—假设计数字段遵循二项分布。	String
邻域类型 (可选)	指定将用于识别每个要素的相邻要素的方法。 距离范围—应用阈值距离以识别相邻要素。 位于焦点要素阈值距离内的所有要素均被视为相邻要素。 如果输入包含点或线要素，则这是默认值。 仅限邻接边—共享边或与要素重叠的面要素将成为该要素的相邻要素。 邻接边拐角—与某个要素重叠、共享边或共享顶点的要素是该要素的邻域。 如果输入包括面要素，则这是默认值。 k 最近邻—每个要素都分配有相同数量的邻域 k。 要素的 k 个最近要素成为其邻域。 Delaunay 三角测量—非重叠的三角形网格根据要素质心创建。 每个要素是一个三角形结点，具有公共边的结点被视为邻域。 通过文件获取空间权重—要素之间的空间关系在空间权重矩阵 (.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	包含用于计算比率的计数字段和 population 字段的表或要素。	Table View
rate_fields [[count_field, population_field],...]	用于计算比率的计数和 population 字段。	Value Table
append_to_input (可选)	指定字段是追加到输入数据集还是保存到输出表或要素类。 APPEND—字段将追加到输入要素。 这会修改输入数据。 NO_APPEND—将创建包含字段的输出表或要素类。 这是默认设置。	Boolean
out_table (可选)	包含比率和有助于评估比率的附加字段的输出表或要素类。	Feature Class; Table
rate_method (可选)	指定用于计算比率的方法。 CRUDE_RATE—比率将通过计数字段值除以 population 字段值来计算。 这是默认设置。 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: 是