同行者の検索 (Find Cotravelers) (インテリジェンス)

概要

ポイント トラック データセット内の、ユーザーが定義した間隔で時空間を移動する一意の識別子を抽出します。

使用法

  • このツールは、入力フィーチャを使用して、フィーチャから指定した時間間隔および距離間隔内で移動する一意の識別子を識別します。入力フィーチャは、時間対応である必要があります。

    データセットを時間対応にする方法の詳細については、「データでの時間プロパティの設定」をご参照ください。

  • 一意の識別子として使用するフィールドを選択するときは、整数またはテキストを含むフィールドを選択します。これにより、フィーチャのグループ化が効率的になり、最適な出力が返されます。

  • 時間的および空間的分離の間隔が小さいほど、処理が高速になります。たとえば、時間差が 10 分で空間的分離が 100 メートルの場合、時間差が 1 時間で空間的分離が 1 キロメートルの場合より処理が大幅に高速になります。

  • 出力フィーチャは、同行フィーチャの位置を表します。出力フィーチャには、他の説明フィールドのほかに、移動者と同行者間の時間的および空間的分離を示す 2 つのフィールドが追加されます。

    出力フィーチャには、次のフィールドが含まれます。

    • traveler_id - 移動フィーチャの一意の識別子。これは、同行フィーチャとともに移動し、ソース フィーチャと見なすことができる識別子です。
    • cotraveler_id - 同行フィーチャの一意の識別子。これは、移動フィーチャに同行する、ターゲット フィーチャと見なすことができる識別子です。
    • X - 移動フィーチャの X 座標。座標には、[入力フィーチャ] の投影単位が使用されます。
    • Y - 移動フィーチャの Y 座標。座標には、[入力フィーチャ] の投影単位が使用されます。
    • X_cotraveler - 同行フィーチャの X 座標。座標には、[入力フィーチャ] の投影単位が使用されます。
    • Y_cotraveler - 同行フィーチャの Y 座標。座標には、[入力フィーチャ] の投影単位が使用されます。
    • traveler_time - 移動フィーチャの日付と時刻。
    • cotraveler_time - 同行フィーチャの日付と時刻。
    • distance_difference - [入力フィーチャ] 内で識別されるフィーチャと評価対象の同行者の間の距離。距離には、[入力フィーチャ] の距離単位が使用されます。
    • time_difference - [入力フィーチャ] 内で識別されるフィーチャと評価対象の同行者の間の時間的分離。時間差は秒単位で、正または負の数値を使用できます。正の数値は、識別されるフィーチャが移動者の後に発生することを示しています。負の数値は、識別されるフィーチャが移動者の前に発生することを示しています。
    • cotraveling_pair_id - 同行フィーチャの一意のペアごとに生成される一意の識別子。2 つの同行フィーチャ (A, B) は、(A, B) と (B, A) の両方で同じ cotraveling_pair_id を共有します。

    出力フィーチャから作成できるオプションのサマリー テーブルがあります。サマリー テーブルには、次のフィールドが含まれます。

    • unique_pair_id - 同行フィーチャの一意のペアごとに生成される一意の識別子。2 つの同行フィーチャ (A, B) は、(A, B) と (B, A) の両方で同じ unique_pair_id を共有します。
    • traveler_id - 移動フィーチャの一意の識別子。これは、同行フィーチャとともに移動し、ソース フィーチャと見なすことができる識別子です。
    • cotraveler_id - 同行フィーチャの一意の識別子。これは、移動フィーチャに同行する、ターゲット フィーチャと見なすことができる識別子です。
    • time_diff_max - 移動者と同行者間の時間的分離の最大値。
    • time_diff_min - 移動者と同行者間の時間的分離の最小値。
    • time_diff_mean - 移動者と同行者間の時間的分離の平均値。
    • time_diff_std - 移動者と同行者間の時間的分離の標準偏差。
    • dist_diff_max - 移動者と同行者間の距離的分離の最大値。
    • dist_diff_min - 移動者と同行者間の距離的分離の最小値。
    • dist_diff_mean - 移動者と同行者間の距離的分離の平均値。
    • dist_diff_std - 移動者と同行者間の距離的分離の標準偏差。
    • unique_pair_id_count - unique_pair_id に対して同行していると識別されたフィーチャの総数。

構文

arcpy.intelligence.FindCotravelers(input_features, out_featureclass, id_field, {search_distance}, {time_difference}, {input_type}, {secondary_features}, {secondary_id_field}, {create_summary_table}, {out_summary_table})
パラメーター説明データ タイプ
input_features

同行者の検索に使用される既知の識別子を表す時間対応フィーチャ。一意の識別子、タイム スタンプ、位置は、出力レイヤーに転送され、時間的および空間的分離の計算に利用されます。

Feature Layer
out_featureclass

入力ソース レイヤーに同行すると識別されるポイント トラック セグメントを含む出力フィーチャクラス。このフィーチャクラスには、指定したポイント トラック セグメントが関連付けられているソースが含まれています。時間的および空間的分離は、各ポイント トラック フィーチャに対して計算されます。

Feature Class
id_field

ポイント トラックごとに一意の識別子を取得するために使用される [入力フィーチャ] のフィールド。このフィールドは、出力フィーチャクラスにコピーされます。

Field
search_distance
(オプション)

同行フィーチャと見なされなくなるまでフィーチャを分離できる最大距離。デフォルトは 100 フィートです。

Linear Unit
time_difference
(オプション)

同行フィーチャと見なされなくなるまでフィーチャを分離できる最大時間差。デフォルト値は 10 秒です。

Time Unit
input_type
(オプション)

同行者を 1 つのフィーチャクラスで識別するか、2 つのフィーチャクラス間で識別するかを指定します。

  • ONE_FEATURECLASS 同行者が 1 つのフィーチャクラスで検出されます。これがデフォルトです。
  • TWO_FEATURECLASSES同行者が 2 つのフィーチャクラス間で検出されます。
String
secondary_features
(オプション)

同行者を識別する第 2 のフィーチャクラス。同行者は以下の方法で評価されます。

  • 同行者が入力フィーチャ内部で同行している。
  • 同行者が第 2 フィーチャ内部で同行している。
  • 同行者が入力フィーチャと第 2 フィーチャの間で同行している。

Feature Layer
secondary_id_field
(オプション)

ポイント トラックごとに一意の識別子を取得するために使用される [第 2 フィーチャ] のフィールド。このフィールドは、出力フィーチャクラスにコピーされます。

Field
create_summary_table
(オプション)

出力サマリー テーブルを作成するかどうかを指定します。

  • NO_SUMMARY_TABLEサマリー テーブルは作成されません。これがデフォルトです。
  • CREATE_SUMMARY_TABLEサマリー テーブルが作成されます。
Boolean
out_summary_table
(オプション)

サマリー情報を格納する出力テーブル。このオプションは、[サマリー テーブルの作成] パラメーター値が True に設定されている場合にのみ使用できます。

Table

コードのサンプル

FindCotravelers (同行者の検索) の例 (スタンドアロン スクリプト)

次の Python スクリプトは、出力サマリー テーブルと 1 つの入力フィーチャクラスを使用しないスタンドアロン スクリプトで FindCotravelers 関数を使用する方法を示しています。

# Name: FindCotravelers.py
# Description: Identify cotravelers in a point track dataset. 
# Import system modules 
import arcpy 
arcpy.env.workspace = "C:/data/Tracks.gdb"
# Set local variables 
source_features = "Known_Tracks"
output_point_features = "Cotravelers"
id_field = "device_id"
# Execute tool
arcpy.FindCotravelers_intelligence(source_features,
                                   output_point_features,
                                   id_field)
FindCotravelers (同行者の検索) の例 (スタンドアロン スクリプト)

次の Python スクリプトは、出力サマリー テーブルと 2 つの入力フィーチャクラスを使用するスタンドアロン スクリプトで FindCotravelers 関数を使用する方法を示しています。

# Name: FindCotravelers.py
# Description: Identify cotravelers in a point track dataset. 
# Import system modules 
import arcpy 
arcpy.env.workspace = "C:/data/Tracks.gdb"
# Set local variables 
source_features = "Known_Tracks"
unknown_features = "Unknown_Tracks"
output_point_features = "Cotravelers"
id_field_name = "device_id"
unknown_id_field = "MMSI"
search_distance = "75 Feet"
time_difference = "5 Seconds"
summary_table = "CREATE_SUMMARY_TABLE"
summary_table_name = "Tracks_Summary_Table"
# Execute tool
arcpy.FindCotravelers_intelligence(source_features,
																												       output_point_features,
                                   id_field_name,
                                   search_distance,
                                   time_difference,
																																			"TWO_FEATURECLASSES",
																																			unknown_features,
																																			unknown_id_field,
																																			summary_table,
																																			summary_table_name)

ライセンス情報

  • Basic: いいえ
  • Standard: いいえ
  • Advanced: はい

関連トピック