描述
用于计算与点要素相对应的要素的变化，这些点要素表示两个相等的比较时间段。
使用方法
通过在较大的数据集上执行日期和时间选择，并将选择保存到新图层，可以创建输入当前时间段点要素和输入上一个时间段点要素。
以下字段将添加到输出中：
- CUR_CNT - 与输入要素参数值重合的输入当前时间段点要素参数值的点数。
- PREV_CNT - 与输入要素参数值重合的输入上一个时间段点要素参数值的点数。
- DIFF_CNT - CUR_CNT 和 PREV_CNT 字段之间的差值。
- PERC - CUR_CNT 和 PREV_CNT 字段之间的变化百分比。可以使用公式进行计算。
其中 C 为当前计数，P 为上一个计数。如果当前计数为 0，则百分比变化值为空。当百分比变化值为空时，将在输出符号系统分类中指定这些要素没有百分比。((C - P) / P) * 100
语法
arcpy.ca.SummarizePercentChange(in_features, in_current_features, in_previous_features, out_feature_class, {search_radius})| 参数 | 说明 | 数据类型 |
in_features | 将对其中的比较时间段进行计数和比较的重合要素。 | Feature Layer |
in_current_features | 已过滤到最近比较时间段的点要素。 例如，上一个 14 天的犯罪。 | Feature Layer |
in_previous_features | 已过滤到当前时间段的上一时间段的点要素。此时间段与当前时间段的长度必须相等，才能提供精确的比较。 例如，如果当前时间段包含从 1 月 15 日到 1 月 28 日的要素，则上一个时间段应包含从 1 月 1 日到 1 月 14 日的要素。 | Feature Layer |
out_feature_class | 输出要素类，包含时间段比较的差异计数和百分比变化计算。 | Feature Class |
search_radius （可选） | 将视为点要素重合的与线或点输入要素的最大距离。 仅当点或线要素用作输入要素时，此参数才处于活动状态。 | Linear Unit |
代码示例
以下 Python 窗口脚本演示了如何在即时模式下使用 SummarizePercentChange 函数。
import arcpy
arcpy.env.workspace = r"C:\data\city_pd.gdb"
arcpy.ca.SummarizePercentChange("Precincts", "crimes_q3", "crimes_q2",
"crimes_percent_change_by_precinct_q2_to_q3")以下 Python 脚本演示了如何在独立脚本中使用 SummarizePercentChange 函数。
# Name: SummarizePercentChange.py
# Description: Compare the number of crimes committed in the second quarter to
# the third quarter by precincts, and determine the percent
# change.
# import system modules
import arcpy
# Set environment settings
arcpy.env.workspace = r"C:\data\city_pd.gdb"
# Execute SummarizePercentChange
arcpy.ca.SummarizePercentChange("Precincts", "crimes_q3", "crimes_q2",
"crimes_percent_change_by_precinct_q2_to_q3")环境
许可信息
- Basic: 是
- Standard: 是
- Advanced: 是