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

Location Referencing ライセンスで利用可能です。

サマリー

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

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

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

使用法

  • 入力イベント レイヤーは、ポイントまたはライン フィーチャクラスである必要があります。

  • このツールはどちらの入力も変更せず、出力としてフィーチャクラスを生成します。

  • このツールは、一度に 1 つの時間的表現をサポートします。 このツールを実行する前に、時間ベースのフィルター設定を作成するか、入力イベント レイヤーとターゲット LRS ネットワークに時間ベースの選択セットを適用します。 両方の入力レイヤーで時間が構成されている場合は、ArcGIS Pro のタイム スライダーを使用することもできます。

  • このツールは、ギャップを含むルートに対するイベントの変換をサポートしています。

  • ターゲット ネットワークが LRS ライン ネットワーク (別名エンジニアリング ネットワーク) である場合、入力イベント レイヤーの元のネットワークがラインの概念をサポートしていなくても、入力イベント レイヤーを変換できます。

  • 出力フィーチャクラス タイプ (ラインまたはポイント) は、入力イベント レイヤー タイプと一致する必要があります。

  • 入力イベント レイヤーの許容値と解像度の設定は、ターゲット LRS ネットワークと一致する必要があります。

  • 変換時の一致条件を特定するために、出力フィーチャクラスに Loc_Error というフィールドが作成されます。ここには、Multi-MatchPartial MatchNo MatchNo Error などの値が含まれます。

  • 入力イベント レイヤーの属性フィールドが、出力フィーチャクラスに含まれます。

  • ターゲット LRS ネットワークに並列ルートが含まれる場合、[並列ルートの一致] オプションを使用します。

  • [一致するルート ID を持つルート][並列ルートの一致] を組み合わせて使用する場合、入力イベント レイヤーを ArcGIS Location Referencing の LRS イベント レイヤーとして登録する必要があります。

  • このツールは、入力イベント レイヤーの空間オーバーレイをターゲット LRS ネットワークに対して実行し、ターゲット ネットワーク沿いに入力イベントのフィーチャを生成します。 これらのフィーチャには、ルート ID と、ルート上のその位置のメジャー情報が含まれます。

  • 正確な出力を取得するには、入力イベント レイヤーとターゲット ネットワークは特定の 1 つの時点を表す必要があります。 入力イベント レイヤーが複数の時点を表す場合、タイム スライダーを使用してフィルターを設定するか、日付列のフィルター設定を使用します。

  • 出力データは、[イベントのアペンド (Append Events)] ツールを使用することで、新しい LRS イベントや既存の LRS イベントに追加できます。 入力イベント レイヤーに複数の時間的表現が含まれており、その結果として、異なる日付フィルターを使用してこのツールを複数回実行した場合は、[イベントのアペンド (Append Events)] を使用して、それぞれの出力を単一の 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_ex2.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

# Tool variables
in_source_event = "Test Pressure Range"
in_target_route_features = "Station Series Network"
out_target_event = "Test_Pressure_Range_Station_Series"
in_concurrent_route_matching = "ANY"

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

# Execute the tool
arcpy.locref.TranslateEventMeasures(in_source_event, in_target_route_features, out_target_event, in_concurrent_route_matching)
TranslateEventMeasures の例 2 (スタンドアロン スクリプト)

次のスタンドアロン スクリプトで、ArcGIS ProTranslateEventMeasures ツールを使用する方法を示します。

# 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:
Event = r"C:\Data\Pipeline_Data.gdb\LRS\Pressure"
Network = r"C:\Data\Pipeline_Data.gdb\LRS\StationSeries"
Output = r"C:\Data\Pipeline_Data.gdb\LRS\Pressure_Transform"
Concurrency = "ANY"

# Process: Translate Event Measures
arcpy.locref.TranslateEventMeasures(Event, Network, Output, Concurrency)

# Check in license
arcpy.CheckInExtension('LocationReferencing')
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

# 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.
source_event = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/31"
target_route_network = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/53"

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

# Process: Translate Event Measures.
arcpy.locref.TranslateEventMeasures(source_event, target_route_network, output_event, concurrency)

# 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)

関連トピック