ラベル | 説明 | データ タイプ |
入力フィーチャ | 作成されるトラックに沿ったポイント位置としてのポイント フィーチャ。 | Feature Layer |
日付フィールド | [入力フィーチャ] のポイントの順序付けに使用する日付フィールド。 | Field |
出力フィーチャクラス | 出力トラッキング ライン フィーチャ。 | Feature Class |
グループ フィールド (オプション) | 入力ポイントのグループ化に使用する [入力フィーチャ] パラメーターのフィールド。 一意のグループごとに別々のトラッキングが作成されます。 | Field |
速度フィールドを含める (オプション) | 速度フィールド (speed_mps、speed_mph、speed_kph、speed_knt) を [出力フィーチャクラス] パラメーター値に含めるかどうかを指定します。
| Boolean |
出力シーケンス ポイント (オプション) | 出力ポイント フィーチャ。 出力には SEQUENCE フィールドが含まれ、このフィールドには [出力フィーチャクラス] パラメーターで作成されたパスに使用される順序が含まれています。 | Feature Class |
重複するタイムスタンプのエラー (オプション) | [日付フィールド] パラメーター値内または [グループ フィールド] パラメーター値の各グループ内の重複するタイムスタンプが受け入れられるか、またはツールが失敗する原因となるかを指定します。
| Boolean |
入力フィールドの維持 (オプション) | フィールドを [入力フィーチャ] パラメーター値から [出力シーケンス ポイント] パラメーター値に転送するかどうかを指定します。
| Boolean |
サマリー
GPS ポイントなど、入力ポイント データの時間対応シーケンスを一連の出力パスに変換します。
使用法
[入力フィーチャ] パラメーター値が投影座標系である場合、[出力フィーチャクラス] パラメーター値も同じ座標系を使用します。 [入力フィーチャ] パラメーター値が地理座標系である場合、[出力フィーチャクラス] パラメーター値も世界正距方位図法を使用します。
[入力フィーチャ] パラメーターの値に同じ座標のポイントがある場合、出力ラインが作成されるたびに、2 つ目の Y 座標値に 1 センチメートルのオフセットが追加されます。 これは、ジオメトリ モデルで単一のポリラインの重複する頂点が許可されないためです。
投影された Web メルカトルに [入力フィーチャ] のポイントがある場合、distance_m フィールドの値は測地線の長さを使って計算され、それがより正確と見なされるため、Shape Length フィールドと distance_m フィールドの値が一致しない場合があります。
次のフィールドが [出力フィーチャクラス] パラメーター値に追加されます。
フィールド名 フィールド エイリアス 説明 d_start Start Date 開始日時
d_start_s Start Date (string) 開始日時 (文字列またはテキスト)
d_end End Date 終了日時
d_end_s End Date (string) 終了日時 (文字列またはテキスト)
distance_m Distance (meters) 距離 (メートル)
dt_sec Time Delta (seconds) 時差 (秒)
dt_min Time Delta (minutes) 時差 (分)
speed_mps Speed (meters per second) オプション。 速度 (メートル/秒)
speed_mph Speed (miles per hour) オプション。 速度 (マイル/時間)
speed_kph Speed (kilometers per hour) オプション。 速度 (キロメートル/時間)
speed_knt Speed (knots) オプション。 速度 (ノット)
oid_start Start ObjectID [入力フィーチャ] からの始点のオブジェクト ID
oid_end End ObjectID [入力フィーチャ] からの終点のオブジェクト ID
group_id Group Identification オプション。 [入力フィーチャ] パラメーターからの [グループ フィールド] の値
次のフィールドが、[出力シーケンス ポイント] パラメーター値に追加されます。
フィールド名 フィールド エイリアス 説明 sequence Sequence Number トラッキングのポイントのシーケンス番号
date Date [入力フィーチャ] パラメーターからの日時フィールド
date_str Date (string) 日時フィールド (文字列)
oid_orig Original ObjectID [入力フィーチャ] パラメーターからの元のフィーチャのオブジェクト ID
group_id Group Identification オプション。 [入力フィーチャ] パラメーターからの [グループ フィールド] の値
[出力フィーチャクラス] パラメーターと [出力シーケンス ポイント] パラメーターに対して、出力 .lyrx ファイル (シンボルとレイヤーの設定) が作成されます。 これらのファイルは、出力フィーチャを含む最も近いフォルダー ワークスペースに作成されます。
[速度フィールドを含める] パラメーターがオンで、[重複するタイムスタンプのエラー] パラメーターがオフの場合、出力トラックの速度で計測されるすべての重複するタイム スタンプは、ポイント間の距離に関係なく inf (inf は infinity (無限) を意味する) になります。
[グループ フィールド] パラメーター値の NULL 値は処理されません。 NULL 値の並べ替えとグループ化は、入力ポイント処理の一部として実行できないため、それらの行はスキップされます。 この問題を防止するには、データ エンジニアリングまたは [フィールド演算 (Calculate Field)] ツールを使用して NULL 値を有効な値に変換してから、このツールを使用します。
パラメーター
arcpy.intelligence.PointsToTrackSegments(in_features, date_field, out_feature_class, {group_field}, {include_velocity}, {out_point_feature_class}, {error_on_duplicate_timestamps}, {keep_input_fields})
名前 | 説明 | データ タイプ |
in_features | 作成されるトラックに沿ったポイント位置としてのポイント フィーチャ。 | Feature Layer |
date_field | in_features のポイントの順序付けに使用する日付フィールド。 | Field |
out_feature_class | 出力トラッキング ライン フィーチャ。 | Feature Class |
group_field (オプション) | 入力ポイントのグループ化に使用する in_features パラメーターのフィールド。 一意のグループごとに別々のトラッキングが作成されます。 | Field |
include_velocity (オプション) | 出力速度フィールド (speed_mps、speed_mph、speed_kph、speed_knt) を out_feature_class パラメーター値に含めるかどうかを指定します。
| Boolean |
out_point_feature_class (オプション) | 出力ポイント フィーチャ。 出力には SEQUENCE フィールドが含まれ、このフィールドには out_feature_class パラメーターで作成されたパスに使用される順序が含まれています。 | Feature Class |
error_on_duplicate_timestamps (オプション) | date_field パラメーター値内または group_field パラメーター値の各グループ内の重複するタイムスタンプが受け入れられるか、またはツールが失敗する原因となるかを指定します。
| Boolean |
keep_input_fields (オプション) | フィールドを in_features パラメーター値から out_point_feature_class パラメーター値に転送するかどうかを指定します。
| Boolean |
コードのサンプル
次の Python ウィンドウ スクリプトは、イミディエイト モードで PointsToTrackSegments 関数を使用する方法を示しています。
import arcpy
arcpy.intelligence.PointsToTrackSegments("C:/data/mtracks.gdb/source_pts",
"DateTime",
"C:/data/mtracks.gdb/tracklines",
"Name",
"INCLUDE_VELOCITY",
"C:/data/mtracks.gdb/seqpoints")
次の Python スクリプトは、スタンドアロン スクリプトで PointsToTrackSegments 関数を使用する方法を示しています。
# Name: PointsToTrackSegments_Example2.py
# Description: Convert points to track segments.
# Import system modules
import arcpy
# Set local variables
in_features = "C:/data/mtracks.gdb/source_pts"
date_time = "DateTime"
out_feature_class = "C:/data/mtracks.gdb/tracklines"
group_field = "Name"
out_points = "C:/data/mtracks.gdb/seqpoints"
# Run PointsToTrackSegments
arcpy.intelligence.PointsToTrackSegments(in_features, date_time,
out_feature_class, group_field,
"INCLUDE_VELOCITY", out_points)