概要
2 つの等しい比較期間を表すポイント フィーチャに対応するフィーチャの変化を計算します。
使用法
[入力現在の期間ポイントフィーチャ] フィーチャと [入力以前の期間ポイント フィーチャ] フィーチャは、大きいデータセットで日時を選択し、その選択を新しいレイヤーに保存することで作成されます。
次のフィールドが出力に追加されます。
- CUR_CNT - [入力フィーチャ] パラメーター値と一致する、[入力現在の期間ポイント フィーチャ] パラメーター値からのポイント数。
- PREV_CNT - [入力フィーチャ] パラメーター値と一致する、[入力以前の期間ポイント フィーチャ] パラメーター値からのポイント数。
- DIFF_CNT - CUR_CNT フィールドと PREV_CNT フィールドの差。
- PERC - CUR_CNT フィールドと PREV_CNT フィールドの変化の割合。これは、次の数式で計算されます。
ここで、C は現在の数で、P は過去の数を意味します。現在の数が 0 の場合、変化の割合の値は NULL になります。変化の割合の値が NULL であれば、これらのフィーチャは出力シンボル分類で「パーセントなし」として指定されます。((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: はい