イベントメジャーの変換 (Translate Event Measures) (Location Referencing ツール)

サマリー

ポイントまたはラインイベントレイヤーのメジャー (M 値) を 1 つのリニアリファレンス方法 (LRM) から別の LRM に変換します。

このツールは、イベントデータをマイル単位のネットワークからキロメートル単位のネットワークに変換するために使用されます。

メジャー値以外に、イベントフィーチャのルートの関連付けも、2 つの LRM 間で異なることがあります。このツールでは、正しいメジャー値を持つフィーチャクラスと、ターゲット LRS ネットワークのルートの関連付けが出力されます。

使用法

入力イベントレイヤーは、ポイントまたはラインフィーチャクラスである必要があります。
このツールはどちらの入力も変更せず、出力としてフィーチャクラスを生成します。
このツールは、一度に 1 つの時間的表現をサポートします。このツールを実行する前に、時間ベースの定義クエリを作成するか、入力イベントレイヤーとターゲット LRS ネットワークに時間ベースの選択セットを適用します。両方の入力レイヤーで時間が構成されている場合は、ArcGIS Pro のタイムスライダーを使用することもできます。
このツールは、ギャップを含むルートに対するイベントの変換をサポートしています。
ターゲットネットワークが LRS ラインネットワーク (別名エンジニアリングネットワーク) である場合、入力イベントレイヤーの元のネットワークがラインの概念をサポートしていなくても、入力イベントレイヤーを変換できます。
The output feature class type—ラインまたはポイント - 入力イベントレイヤータイプと一致する必要があります。
入力イベントレイヤーの許容値と解像度の設定は、ターゲット LRS ネットワークと一致する必要があります。
変換時の一致条件を特定するために、出力フィーチャクラスに Loc_Error というフィールドが作成されます。ここには、Multi-Match、Partial Match、No Match、No Error などの値が含まれます。
入力イベントレイヤーの属性フィールドが、出力フィーチャクラスに含まれます。
ターゲット LRS ネットワークに並列ルートが含まれる場合、並列ルートの一致 オプションを使用します。
一致するルート ID を持つルート と 並列ルートの一致 を組み合わせて使用する場合、入力イベントレイヤーを ArcGIS Location Referencing の LRS イベントレイヤーとして登録する必要があります。
このツールは、入力イベントレイヤーの空間オーバーレイをターゲット LRS ネットワークに対して実行し、ターゲットネットワーク沿いに入力イベントのフィーチャを生成します。これらのフィーチャには、ルート ID と、ルート上のその位置のメジャー情報が含まれます。
正確な出力を取得するには、入力イベントレイヤーとターゲットネットワークは特定の 1 つの時点を表す必要があります。入力イベントレイヤーが複数の時点を表す場合、タイムスライダーを使用してフィルターを設定するか、日付列の定義クエリを使用します。
出力データは、イベントのアペンド ツールを使用することで、新しい LRS イベントや既存の LRS イベントに追加できます。入力イベントレイヤーに複数の時間的表現が含まれており、その結果として、異なる日付フィルターを使用してこのツールを複数回実行した場合は、イベントのアペンド を使用して、それぞれの出力を単一の LRS イベントフィーチャクラスに追加できます。

ラベル	説明	データタイプ
ソースイベントレイヤー	変換する入力イベントレイヤー。	Feature Layer
入力ターゲットルートフィーチャ	入力イベントが変換されるターゲット LRS ネットワーク。	Feature Layer
出力イベントレイヤー	変換済みのイベントフィーチャが格納される出力フィーチャクラス。	Feature Class
並列ルートの一致 (オプション)	ターゲット LRS ネットワークに並列ルートが存在する場合に、どのルートに対してイベントを変換するか決定する方法を指定します。このパラメーターは、ターゲット LRS ネットワーク上のイベント変換の位置に並列ルート (位置を共有するルート) がある場合にのみ適用されます。任意の並列ルート—入力イベントレイヤーは、ターゲット LRS ネットワークにある最初の 2 つ以上の並列ルートに対して変換されます。一致する RouteID を持つルート—ソースイベントのルート ID と、ターゲット LRS ネットワークの並列ルートのルート ID を比較します。ソースイベントは、ソースイベントおよびターゲットネットワークのルート ID の一致に基づいて変換されます。この方法でイベントを正確に変換するには、入力イベントとターゲット LRS ネットワークのルート ID が完全に一致する必要があります。また、この方法を使用するには、入力イベントレイヤーは登録されている LRS イベントである必要があります。すべての並列ルート—入力イベントは、ターゲット LRS ネットワークのその位置にある、すべての並列ルートに対して変換されます。	String

arcpy.locref.TranslateEventMeasures(in_source_event, in_target_route_features, out_target_event, {in_concurrent_route_matching})

名前	説明	データタイプ
in_source_event	変換する入力イベントレイヤー。	Feature Layer
in_target_route_features	入力イベントが変換されるターゲット LRS ネットワーク。	Feature Layer
out_target_event	変換済みのイベントフィーチャが格納される出力フィーチャクラス。	Feature Class
in_concurrent_route_matching (オプション)	ターゲット LRS ネットワークに並列ルートが存在する場合に、どのルートに対してイベントを変換するか決定する方法を指定します。このパラメーターは、ターゲット LRS ネットワーク上のイベント変換の位置に並列ルート (位置を共有するルート) がある場合にのみ適用されます。 `ANY`—入力イベントレイヤーは、ターゲット LRS ネットワークにある最初の 2 つ以上の並列ルートに対して変換されます。 `ROUTE_ID`—ソースイベントのルート ID と、ターゲット LRS ネットワークの並列ルートのルート ID を比較します。ソースイベントは、ソースイベントおよびターゲットネットワークのルート ID の一致に基づいて変換されます。この方法でイベントを正確に変換するには、入力イベントとターゲット LRS ネットワークのルート ID が完全に一致する必要があります。また、この方法を使用するには、入力イベントレイヤーは登録されている LRS イベントである必要があります。 `ALL`—入力イベントは、ターゲット LRS ネットワークのその位置にある、すべての並列ルートに対して変換されます。	String

コードのサンプル

TranslateEventMeasures の例 1 (Python ウィンドウ)

次の Python ウィンドウスクリプトは、ArcGIS Pro のイミディエイトモードで TranslateEventMeasures ツールを使用する方法を示しています:

# Name: TranslateEventMeasures_ex1.py
# Description: Translate the measures (m-values) of events from one linear referencing method (LRM) to another. The output is a new event layer feature class.
# Requires: ArcGIS Location Referencing

# Set current workspace
arcpy.env.workspace = r"C:\Data\Outputs.gdb"

# Tool variables
in_source_event = "TestPressureRange"
in_target_route_features = "StationSeriesNetwork"
out_target_event = "Test_Pressure_Range_Station_Series"
in_concurrent_route_matching = "ANY"

# Run the tool
arcpy.locref.TranslateEventMeasures(in_source_event, in_target_route_features, out_target_event, in_concurrent_route_matching)

TranslateEventMeasures の例 2 (スタンドアロンスクリプト)

次のスタンドアロンスクリプトは、ArcGIS Pro で TranslateEventMeasures ツールを使用する方法を示しています:

# Name: TranslateEventMeasures_ex2.py
# Description: Translates the measures (m-values) of events from one linear referencing method (LRM) to another. The output is a new event layer feature class.
# Requires: ArcGIS Location Referencing

# Import arcpy module
import arcpy

# Local variables:
in_source_event = r"C:\Data\Pipeline_Data.gdb\LRS\Pressure"
in_target_route_features = r"C:\Data\Pipeline_Data.gdb\LRS\StationSeries"
out_target_event = r"C:\Data\Pipeline_Data.gdb\LRS\Pressure_Transform"
in_concurrent_route_matching = "ANY"

# Run Translate Event Measures
arcpy.locref.TranslateEventMeasures(in_source_event, in_target_route_features, out_target_event, in_concurrent_route_matching)

TranslateEventMeasures の例 3 (スタンドアロンスクリプト)

次のスタンドアロンスクリプトは、TranslateEventMeasures ツールをフィーチャサービスで使用する方法を示しています:

# Name: TranslateEventMeasures_Pro_Ex3.py
# Description: Translate event measures in stand-alone mode using a feature service. It is recommended to work in a version and post to a default version.
# Requires: ArcGIS Location Referencing

# Import arcpy module.
import arcpy

# Input event and target LRS network are in feature service.  Signing in portal is required to access the feature service.
arcpy.SignInToPortal('https://yourdomain.com/portal', 'username', 'password')

# Map the input event and target LRS network from the feature service. Here, 53 corresponds to the target LRS network and 31 corresponds to source event.
in_source_event = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/31"
in_target_route_features = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/53"

# Set tool variables
out_target_event = r"C:\Data\LocationReferencing.gdb\outputevent"
in_concurrent_route_matching = "ANY"

# Run Translate Event Measures
arcpy.locref.TranslateEventMeasures(in_source_event, in_target_route_features, out_target_event, in_concurrent_route_matching)

環境

現在のワークスペース

ライセンス情報

Basic: ArcGIS Location Referencing (ArcGIS Pipeline Referencing または ArcGIS Roads and Highways) が必要
Standard: ArcGIS Location Referencing (ArcGIS Pipeline Referencing または ArcGIS Roads and Highways) が必要
Advanced: ArcGIS Location Referencing (ArcGIS Pipeline Referencing または ArcGIS Roads and Highways) が必要

イベント メジャーの変換 (Translate Event Measures) (Location Referencing ツール)

サマリー

使用法

パラメーター

環境

ライセンス情報

関連トピック

イベントメジャーの変換 (Translate Event Measures) (Location Referencing ツール)