概要
時間対応入力データからラインまたはポリゴン トラッキングを作成します。
図
使用法
[トラッキングの再構築 (Reconstruct Tracks)] は、ポイント フィーチャまたはポリゴン フィーチャで実行されます。入力レイヤーは、特定時点を表すフィーチャによって、時間が有効化されている必要があります。
トラッキングを識別するために、1 つ以上のフィールドを選択できます。トラッキングは、1 つ以上のトラッキング フィールドの一意の組み合わせで表されます。たとえば、flightID フィールドと Destination フィールドがトラッキング識別子として使用されている場合、フィーチャ [ID007, Solden] および [ID007, Tokyo] は 2 つの個別トラッキングになります。これは、Destination フィールドの値が異なるためです。
バッファーが適用されたフィーチャはポリゴン トラッキングになります。バッファーが適用されない入力ポイント フィーチャは、ポリライン トラッキングになります。
入力フィーチャは、時間が有効化されており、特定時点を表すフィーチャで構成されます。結果は、時間の間隔を表すライン フィーチャまたはエリア フィーチャになります。間隔の開始時点と終了時点は、トラッキングの最初のフィーチャと最後のフィーチャによって決定されます。
時間タイプが「インスタント」 (左) と生成されるトラッキング (右)、または時間タイプが「間隔」である 2 つの明確なトラッキングを持つ入力フィーチャ (緑と赤) が表示されます。 線形の結果の場合、複数のポイントを含むトラッキングのみが返されます。バッファーを適用すると、すべてのフィーチャが返されます。
また、任意で入力フィーチャにバッファーを適用することもできます。バッファーを適用すると、生成されるトラッキングはポリゴン フィーチャになります。
バッファーが適用された入力ポイントは、トラッキングに再構築されます。 入力フィーチャをバッファー処理すると、入力フィーチャごとにバッファー処理されます。次に、凸包が生成され、ポリゴン トラッキングが作成されます。
入力ポイント (緑)、視覚化用の中間バッファー (青のハッチング)、生成されるポリゴン トラッキング (青) の例が表示されます。 バッファー式で使用されるフィールドは数値でなければならず、入力の空間参照の単位を使用して適用されます。詳細については、「ArcGIS Enterprise 10.5 および 10.5.1 のバッファー式」または「ArcGIS Enterprise 10.6 以降のバッファー式」をご参照ください。ArcGIS Enterprise 10.6.1 以降では、トラッキング対応方程式を使用できます。
デフォルトでは、トラッキング内のポイント数またはポリゴン数のみが計算されます。[サマリー フィールド] パラメーターの値を指定して、追加の統計情報を計算できます。
デフォルトでは、トラッキングは測地線による方法で作成されます。この方法は、解析の以下の 2 つのコンポーネントに適用されます。
- 国際日付変更線をまたぐトラッキング - 測地線による方法を使用する場合、国際日付変更線をまたぐ入力レイヤーには、国際日付変更線を正しく横断するトラッキングが含まれます。これがデフォルトです。入力レイヤーまたは処理空間参照は、国際日付変更線周辺の折り返しをサポートする空間参照に設定される必要があります (たとえば、正積円筒図法などのグローバル投影)。
- バッファー - 入力フィーチャは任意でバッファーすることもできます。測地線バッファーまたは平面バッファーの適用について詳しくは、「バッファーの作成」をご参照ください。
トラッキングは次の方法で分割できます。
- [時間分割] - 入力間の時間に基づきます。時間分割を適用すると、入力データが指定時間よりも大きい場合に、トラッキングが分割されます。たとえば、同じトラッキング識別子を持つフィーチャが 5 つあり、その時間が [01:00, 02:00, 03:30, 06:00, 06:30]、時間分割が 2 時間に設定されている場合、2 時間以上の間隔のあるフィーチャは分割されます。この例では、結果は [01:00, 02:00, 03:30] と [06:00, 06:30] となります。03:30 と 6:00 は 2 時間以上開いているからです。
- [時間境界分割] - 定義された時間間隔に基づきます。時間境界分割を適用すると、定義済み間隔で追跡が行われます。たとえば、時間の境界を 1 日に設定し、1990 年 1 月 1 日午前 9 時から開始した場合、各トラッキングは毎日午前 9 時に切詰められます。この分割を使用すると、解析のためのトラッキングを短縮できるため、計算時間を高速化できます。時間の境界の繰り返しによる分割が解析で有効な場合は、ビッグ データ処理にこの方法を使用することをお勧めします。
- [距離分割] - 入力間の距離に基づきます。距離分割を適用すると、入力データが指定距離よりも大きい場合に、トラッキングが分割されます。たとえば、距離分割を 5 キロメートルに設定した場合、5 キロメートル以上の連続したフィーチャは異なるトラッキングに分けられます。
- [分割式] - Arcade 式に基づいています。分割式を適用すると、値、ジオメトリ、または時間値に基づいてトラッキングが分割されます。たとえば、フィールド値がトラッキング内の前の値の 2 倍よりも大きい場合にトラッキングを分割できます。このためには、たとえば、フィールド名を WindSpeed にして、var speed = TrackFieldWindow("WindSpeed", -1, 1); 2* speed[0] < speed[1] という式を使用します。前の値 (speed[0]) が現在の値の 2 倍よりも小さくなると、トラッキングが分割されます。
0、1、2、3、または 4 つの分割オプションを同時に適用できます。次に示されたすべての例で、間隔分割が使用されています。6 時間の時間分割、1 日の時間境界、16 キロメートルの距離分割を適用することを前提とした場合の結果は、次のようになります。
時間と距離の変化による分割の 5 つの入力ポイント (黄色) 例が表示されます。 分割オプション 説明 時間と位置を含む 6 つの入力ポイント
同じ識別子の付いた入力ポイント。ポイント間の距離は点線の上にマークされ、各ポイント測定の時間はポイントの下にマークされます。タイムラインに 4 つの分割があります。赤色の分割は、午前 12 時から始まる 1 日の時間境界の分割を表します。青色の分割は、2 つのポイント間の距離が 16 キロメートルを超える距離分割を表します。紫色の分割は、2 つの連続したポイント間の時間距離が 6 時間を超える時間分割を表します。
時間分割なし、距離分割なしの例。
6 時間の時間分割を伴う例。2 時間以上離れているフィーチャは、別々のトラッキングに分割されます。
午前 12 時から始まる、1 日の時間境界を伴う例。指定された時間 (ここでは午前 12 時) から始まる 1 日の間隔に対して、それぞれトラッキングが作成されます。
16 キロメートルの距離分割を伴う例。16 キロメートル以上離れているフィーチャ (午前 5 時のフィーチャと午前 6 時のフィーチャ) は、別々のトラッキングに分割されます。
6 時間の時間分割と、午前 12 時から始まる 1 日の時間境界を伴う例。6 時間以上離れているフィーチャ、または午前 12 時の時間分割と交差するフィーチャは、 別々のトラッキングに分割されます。
6 時間の時間分割と 16 キロメートルの距離分割を伴う例。6 時間以上離れているフィーチャ (午前 6 時のフィーチャと午後 7 時のフィーチャ) または 16 km 以上離れているフィーチャは、別々のトラッキングに分割されます。
16 キロメートルの距離分割と、午前 12 時から始まる 1 日の時間境界を伴う例 16 キロメートル以上離れているフィーチャ、または午前 12 時の時間分割と交差するフィーチャは、別々のトラッキングに分割されます。
16 キロメートルの距離分割、6 時間の時間分割、および午前 12 時から始まる 1 日の時間境界を伴う例。16 キロメートル以上離れているフィーチャ、6 時間以上離れているフィーチャ、または午前 12 時の時間分割と交差するフィーチャは、別々のトラッキングに分割されます。
時間分割、距離分割、または分割式を使用してトラッキングを分割する場合は、分割間のセグメントの作成方法を設定できます。トラッキング分割オプションは、ArcGIS Enterprise 10.9 以降に追加されています。次のオプションがあります。
- [間隔] - 分割された 2 つのフィーチャ間に間隔を作成します。
- [分割後に終了] - 分割の後に終了するセグメントを作成します。
- [分割前に開始] - 分割の前に終了して開始するセグメントを作成します。
分割タイプの例を次の図に示します。
同じ入力ポイント (黄色) に対する時間分割の 3 つの例を示しています。 時間分割オプション 説明 時間と位置を含む 5 つの入力ポイント
同じ識別子が設定された 5 つの入力ポイント。各ポイントの時間は点線の下にマークされます。すべての例で、午前 2 時と午前 5 時の間に 1 つの分割が存在します。各トラッキングは、トラッキング上の 3 番目のポイントと 4 番目のポイントの間で 2 つのセグメントに分割されます。最初のトラッキングが緑色、2 番目のトラッキングが紫色です。トラッキングの分割方法は、分割タイプ パラメーターによって決まります。
間隔
分割された 2 つのポイントの間に間隔がある例。最初のトラッキングは 3 番目のポイントで終了し、2 番目のトラッキングは 4 番目のポイントから開始します。これがデフォルトです。
分割後に終了
分割後に 4 番目のポイントでトラッキングが終了する例。2 番目のトラッキングは 4 番目のポイントから開始します。このオプションは、ArcGIS Enterprise 10.9 以降に追加されています。
分割前に開始
分割前に 3 番目のポイントでトラッキングが分割する例。2 番目のトラッキングは 3 番目のポイントから開始します。このオプションは、ArcGIS Enterprise 10.9 以降に追加されています。
以下の例は、航空路線のフライト便を使用し、分割パラメーターとフィールド識別子パラメーターを使用してトラッキングを定義することが有効な理由を示したものです。
- 航空機フィーチャには、aircraft ID、flight ID、pilot name、start time、および flight_maneuver フィールドがあります。flight_maneuver フィールドは、航空機が着陸しているか、上昇しているか、下降しているか、一定の高度を保っているかを表します。
- それぞれの航空機が移動した位置を確認するには、aircraft ID フィールドを使用します。
- 個別のルートを比較するには、識別子として aircraft ID および flight ID フィールドを使用します。
- 1 年間の各航空機のフライト便を調査するには、aircraft ID フィールドと 1 年の時間境界を使用します。
- 各パイロットのフライトを表示するには、pilot name、aircraft ID、および start time フィールドを使用します。
- 1,000 キロメートル以上離れている測定値を同じトラッキングに含めない場合、aircraft ID フィールドを識別子として使用し、1,000 キロメートルを超える距離で分割して新しいトラッキングを決定します。
- aircraft ID フィールドを識別子として使用し、flight_maneuver フィールドの値が変化した場合に式を使用して分割します。たとえば、var flight_manuever = TrackFieldWindow("maneuver", -1, 1); flight_maneuver[0] != flight_maneuver[1] を指定すると、トラッキング内の現在の値と前の値が一致しているかどうかの確認が行われます。一致していない場合は、トラッキングが分割されます。
- 航空機フィーチャには、aircraft ID、flight ID、pilot name、start time、および flight_maneuver フィールドがあります。flight_maneuver フィールドは、航空機が着陸しているか、上昇しているか、下降しているか、一定の高度を保っているかを表します。
出力トラッキングは、トラッキング識別子として使用されるフィールド、トラッキング内のフィーチャ数 (count)、各トラッキングの開始時間と終了時間 (start_datetime と end_datetime)、トラッキングの間隔 (ミリ秒、duration)、およびその他のオプション統計 (形式は statisticstype_fieldname) を返します。
以下を 1 つ以上行うことで、[トラッキングの再構築 (Reconstruct Tracks)] ツールのパフォーマンスを向上させることができます。
- 対象データのみが解析されるように、範囲環境を設定します。
- 測地線の代わりに平面方法を使用します。
- バッファーは適用しないでください。
- [時間分割]、[時間境界分割]、[距離分割]、または [分割式] パラメーターを使用して、トラッキングを分割します。[時間境界分割] パラメーターを使用すると、パフォーマンスが最も上がります。
- 解析が実行されている場所に対してローカルなデータを使用します。
ジオプロセシング ツールは、ArcGIS GeoAnalytics Server を活用しています。解析は GeoAnalytics Server で実行され、結果が ArcGIS Enterprise のコンテンツに保存されます。
GeoAnalytics Server ツールを実行する場合、解析は GeoAnalytics Server で実行されます。最適なパフォーマンスを得るためには、ArcGIS Enterprise ポータルでホストされているフィーチャ レイヤーかビッグ データ ファイル共有を通じて、GeoAnalytics Server にデータを提供する必要があります。GeoAnalytics Server のローカルにないデータは、解析が開始する前に GeoAnalytics Server に移動されます。つまり、ツールを実行する時間が長くなり、場合によっては ArcGIS Pro から GeoAnalytics Server にデータを移動できないこともあります。エラーの閾値はネットワークの速度や、データのサイズや複雑さに左右されます。したがって、データを必ず共有するか、ビッグ データ ファイル共有を作成することをお勧めします。
次のツールを使用して、類似の解析を実行することもできます。
- [データ管理] ツールボックス内にある [ポイント → ライン (Points to Line)] ツール。
構文
arcpy.geoanalytics.ReconstructTracks(input_layer, output_name, track_fields, method, buffer_type, {buffer_field}, {buffer_expression}, {time_split}, {summary_fields}, {data_store}, {distance_split}, {time_boundary_split}, {time_boundary_reference}, {split_expression}, {split_type})| パラメーター | 説明 | データ タイプ |
input_layer | トラッキングに再構築するポイントまたはポリゴン。入力は、特定時点を表す時間対応レイヤーにする必要があります。 | Feature Set |
output_name | 出力フィーチャ サービスの名前。 | String |
track_fields [track_fields,...] | 一意のトラッキングを識別するために使用される 1 つ以上のフィールド。 | Field |
method | トラッキングの再構築に使用する基準を指定します。バッファーを使用する場合は、[method] パラメーターによってバッファーのタイプが決まります。
| String |
buffer_type | バッファー距離の定義方法を指定します。
| String |
buffer_field (オプション) | 入力フィーチャのバッファーを作成するために使用するフィールド。地理座標系を使用していない限り、フィールドの値は入力の空間参照の単位で適用されます。地理座標系を使用している場合の単位は m です。 | Field |
buffer_expression (オプション) | 入力フィーチャのバッファーを作成するために使用する式。フィールドは数値である必要があり、式には [ + - * / ] 演算子と複数のフィールドを含めることができます。地理座標系を使用していない限り、計算される値は入力の空間参照の単位で適用されます。地理座標系を使用している場合の単位は m です。 ArcGIS Enterprise 10.5 および 10.5.1 の式は as_kilometers(distance) * 2 + as_meters(15) の形式になります。ArcGIS Enterprise 10.6 以降では、as_kilometers($feature.distance) * 2 + as_meters(15) などの Arcade 式を使用します。 入力フィーチャのバッファーを作成するために使用する式。フィールドは数値である必要があり、式には [ + - * / ] 演算子と複数のフィールドを含めることができます。地理座標系を使用していない限り、計算される値は入力の空間参照の単位で適用されます。地理座標系を使用している場合の単位は m です。 ArcGIS Enterprise 10.5 および 10.5.1 の式は as_kilometers(distance) * 2 + as_meters(15) の形式になります。ArcGIS Enterprise 10.6 以降では、as_kilometers($feature.distance) * 2 + as_meters(15) などの Arcade 式を使用します。 | Calculator Expression |
time_split (オプション) | 時間次元で時間分割期間よりも離れているフィーチャは複数のトラッキングに分割されます。 | Time Unit |
summary_fields [summary_fields,...] (オプション) | 指定されたフィールドに関して計算される統計情報。
| Value Table |
data_store (オプション) | 出力の保存先の ArcGIS Data Store を指定します。デフォルトは、SPATIOTEMPORAL_DATA_STORE です。ビッグ データ ストアに格納されたすべての結果は、WGS84 で保存されます。リレーショナル データ ストアに格納された結果は、それらの座標系を維持します。
| String |
distance_split (オプション) | 距離次元で距離分割値よりも離れているフィーチャは複数のトラッキングに分割されます。このパラメーターは ArcGIS Enterprise 10.6 以降のライセンスでのみ利用可能です。 | Linear Unit |
time_boundary_split (オプション) | 入力データを解析用に分割する期間。時間境界により、指定期間内の値を解析できます。たとえば、時間境界を 1 日とした場合、1980 年 1 月 1 日から開始され、トラッキングは 1 日の開始時ごとに分割されます。このパラメーターは ArcGIS Enterprise 10.7 以降のライセンスでのみ利用可能です。 | Time Unit |
time_boundary_reference (オプション) | 入力データを解析用に分割する際に使用される基準時間。時間境界は、データの全期間に対して作成されます。基準時間は最初から作成する必要はありません。基準時間を指定しないと、1970 年 1 月 1 日が使用されます。このパラメーターは ArcGIS Enterprise 10.7 以降のライセンスでのみ利用可能です。 | Date |
split_expression (オプション) | 値、ジオメトリ、または時間値に基づいてトラッキングを分割する式。式の検証の結果、真と判定された場合は、分割が行われます。このパラメーターは ArcGIS Enterprise 10.9 以降のライセンスでのみ利用可能です。 | Calculator Expression |
split_type (オプション) | トラッキングを分割する場合に 2 つのフィーチャ間にトラッキング セグメントを作成する方法を指定します。分割タイプは、分割式、距離分割、および時間分割に適用されます。このパラメーターは ArcGIS Enterprise 10.9 以降のライセンスでのみ利用可能です。
| String |
派生した出力
| 名前 | 説明 | データ タイプ |
| output | 出力ラインまたはポリゴン トラッキング。 | フィーチャ セット |
コードのサンプル
次の Python ウィンドウ スクリプトは、ReconstructTracksツールの使用方法を示しています。
# Name: ReconstructTracks.py
# Description: Reconstruct hurricane points into hurricane tracks, where each
# location is buffered by the wind speed * 100
# Requirements: ArcGIS GeoAnalytics Server
# Import system modules
import arcpy
# Set local variables
inFeatures = "https://sampleserver6.arcgisonline.com/arcgis/rest/services/Hurricanes/MapServer/0"
trackIdentifier = "EVENTID"
outFS = "HurricaneTracks"
bufferExpression = "WINDSPEED * 100"
statistics = [["PRESSURE", "MEAN"]]
# Execute Reconstruct Tracks
arcpy.geoanalytics.ReconstructTracks(inFeatures, outFS, trackIdentifier,
"GEODESIC", "EXPRESSION", None,
bufferExpression, None, statistics)環境
- 出力座標系
解析で使用される座標系。このパラメーターで指定されない限り、入力の座標系で解析が行われます。GeoAnalytics Tools の場合、最終結果は WGS84 のビッグ データ ストアに保存されます。
ライセンス情報
- Basic: 次のものが必要 ArcGIS GeoAnalytics Server
- Standard: 次のものが必要 ArcGIS GeoAnalytics Server
- Advanced: 次のものが必要 ArcGIS GeoAnalytics Server