ラベル | 説明 | データ タイプ |
入力フィーチャ | 比較期間のカウントと比較の対象となる一致フィーチャ。 | Feature Layer |
入力現在の期間ポイントフィーチャ | 最近の比較期間に絞り込まれたポイント フィーチャ。 たとえば、過去 14 日間の犯罪を絞り込むことができます。 | Feature Layer |
入力以前の期間ポイント フィーチャ | 現在の期間の直前の期間に絞り込まれたポイント フィーチャ。 正確に比較するため、この期間は現在の期間と同じ長さにする必要があります。 たとえば、現在の期間に 1 月 15 日から 1 月 28 日までのフィーチャが含まれている場合、以前の期間は 1 月 1 日から 1 月 14 日までのフィーチャが含まれます。 | Feature Layer |
出力フィーチャクラス | 期間比較の個数の差と、割合の変化の計算を含む出力フィーチャクラス。 | Feature Class |
検索範囲 (オプション) | [入力フィーチャ] パラメーター値からの最大距離。この距離に基づき、ポイント フィーチャが一致するかどうかが決定します。 このパラメーターは、ポイントまたはライン フィーチャが入力フィーチャとして使用される場合にのみ有効です。 | Linear Unit |
サマリー
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 (オプション) | in_features パラメーター値からの最大距離。この距離に基づき、ポイント フィーチャが一致するかどうかが決定します。 このパラメーターは、ポイントまたはライン フィーチャが入力フィーチャとして使用される場合にのみ有効です。 | 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"
# Run SummarizePercentChange
arcpy.ca.SummarizePercentChange("Precincts", "crimes_q3", "crimes_q2",
"crimes_percent_change_by_precinct_q2_to_q3")
環境
ライセンス情報
- Basic: Yes
- Standard: Yes
- Advanced: Yes