| ラベル | 説明 | データ タイプ |
ソース イベント レイヤー | 変換する入力イベント レイヤー。 | Feature Layer |
入力ターゲット ルート フィーチャ | 入力イベントが変換されるターゲット LRS ネットワーク。 | Feature Layer |
出力イベント レイヤー | 変換済みのイベント フィーチャが格納される出力フィーチャクラス。 | Feature Class |
並列ルートの一致 (オプション) | ターゲット LRS ネットワークに並列ルートが存在する場合に、どのルートに対してイベントを変換するか決定する方法を指定します。 このパラメーターは、ターゲット LRS ネットワーク上のイベント変換の位置に並列ルート (位置を共有するルート) がある場合にのみ適用されます。
| String |
Location Referencing ライセンスで利用可能です。
サマリー
ポイントまたはライン イベント レイヤーのメジャー (M 値) を 1 つのリニア リファレンス方法 (LRM) から別の LRM に変換します。
このツールは、イベント データをマイル単位のネットワークからキロメートル単位のネットワークに変換するために使用されます。
メジャー値以外に、イベント フィーチャのルートの関連付けも、2 つの LRM 間で異なることがあります。 このツールでは、正しいメジャー値を持つフィーチャクラスと、ターゲット LRS ネットワークのルートの関連付けが出力されます。
使用法
入力イベント レイヤーは、ポイントまたはライン フィーチャクラスである必要があります。
このツールはどちらの入力も変更せず、出力としてフィーチャクラスを生成します。
このツールは、一度に 1 つの時間的表現をサポートします。 このツールを実行する前に、時間ベースのフィルター設定を作成するか、入力イベント レイヤーとターゲット LRS ネットワークに時間ベースの選択セットを適用します。 両方の入力レイヤーで時間が構成されている場合は、ArcGIS Pro のタイム スライダーを使用することもできます。
このツールは、ギャップを含むルートに対するイベントの変換をサポートしています。
ターゲット ネットワークが LRS ライン ネットワーク (別名エンジニアリング ネットワーク) である場合、入力イベント レイヤーの元のネットワークがラインの概念をサポートしていなくても、入力イベント レイヤーを変換できます。
出力フィーチャクラス タイプ (ラインまたはポイント) は、入力イベント レイヤー タイプと一致する必要があります。
入力イベント レイヤーの許容値と解像度の設定は、ターゲット LRS ネットワークと一致する必要があります。
変換時の一致条件を特定するために、出力フィーチャクラスに Loc_Error というフィールドが作成されます。ここには、Multi-Match、Partial Match、No Match、No Error などの値が含まれます。
入力イベント レイヤーの属性フィールドが、出力フィーチャクラスに含まれます。
ターゲット LRS ネットワークに並列ルートが含まれる場合、[並列ルートの一致] オプションを使用します。
[一致するルート ID を持つルート] と [並列ルートの一致] を組み合わせて使用する場合、入力イベント レイヤーを ArcGIS Location Referencing の LRS イベント レイヤーとして登録する必要があります。
このツールは、入力イベント レイヤーの空間オーバーレイをターゲット LRS ネットワークに対して実行し、ターゲット ネットワーク沿いに入力イベントのフィーチャを生成します。 これらのフィーチャには、ルート ID と、ルート上のその位置のメジャー情報が含まれます。
正確な出力を取得するには、入力イベント レイヤーとターゲット ネットワークは特定の 1 つの時点を表す必要があります。 入力イベント レイヤーが複数の時点を表す場合、タイム スライダーを使用してフィルターを設定するか、日付列のフィルター設定を使用します。
出力データは、[イベントのアペンド (Append Events)] ツールを使用することで、新しい LRS イベントや既存の LRS イベントに追加できます。 入力イベント レイヤーに複数の時間的表現が含まれており、その結果として、異なる日付フィルターを使用してこのツールを複数回実行した場合は、[イベントのアペンド (Append Events)] を使用して、それぞれの出力を単一の LRS イベント フィーチャクラスに追加できます。
パラメーター
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 ネットワーク上のイベント変換の位置に並列ルート (位置を共有するルート) がある場合にのみ適用されます。
| String |
コードのサンプル
次の 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)次のスタンドアロン スクリプトで、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
# Check out license
arcpy.CheckOutExtension("LocationReferencing")
# 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)
# Check in license
arcpy.CheckInExtension('LocationReferencing')次のスタンドアロン スクリプトでは、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
# Check out the license
arcpy.CheckOutExtension("LocationReferencing")
# 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)
# Check in license
arcpy.CheckInExtension('LocationReferencing')ライセンス情報
- 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)