増減率の集計 (Summarize Percent Change) (犯罪分析と安全)

概要

2 つの等しい比較期間を表すポイント フィーチャに対応するフィーチャの変化を計算します。

使用法

  • [入力現在の期間ポイントフィーチャ] フィーチャと [入力以前の期間ポイント フィーチャ] フィーチャは、大きいデータセットで日時を選択し、その選択を新しいレイヤーに保存することで作成されます。

  • 次のフィールドが出力に追加されます。

    • CUR_CNT - [入力フィーチャ] パラメーター値と一致する、[入力現在の期間ポイント フィーチャ] パラメーター値からのポイント数。
    • PREV_CNT - [入力フィーチャ] パラメーター値と一致する、[入力以前の期間ポイント フィーチャ] パラメーター値からのポイント数。
    • DIFF_CNT - CUR_CNT フィールドと PREV_CNT フィールドの差。
    • PERC - CUR_CNT フィールドと PREV_CNT フィールドの変化の割合。これは、次の数式で計算されます。
      ((C - P) / P) * 100
      ここで、C は現在の数で、P は過去の数を意味します。現在の数が 0 の場合、変化の割合の値は NULL になります。変化の割合の値が NULL であれば、これらのフィーチャは出力シンボル分類で「パーセントなし」として指定されます。

構文

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

コードのサンプル

SummarizePercentChange (増減率の集計) の例 1 (Python ウィンドウ)

次の 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")
SummarizePercentChange (増減率の集計) の例 2 (スタンドアロン スクリプト)

次の 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: はい

関連トピック