イベントメジャーの取得 (Derive Event Measures) (Location Referencing ツール)

サマリー

DerivedRouteID フィールドが構成および有効化されているポイントイベントとラインイベントでこれらのフィールドの値とメジャー値を取得して更新します。

使用法

このツールを実行するには、LRS データセットが必要です。
- ArcGIS Pipeline Referencing の LRS データセットの作成の詳細
- ArcGIS Roads and Highways の LRS データセットの作成の詳細
このツールは、大規模なワークフローの一部として実行される設計になっています。 [イベントメジャーの取得] を実行する前に、イベントの振舞いを適用 ツールと ルートの生成 ツールを実行しておく必要があります。ワークフローで上記の 2 つのツールを実行せずにこのツールを実行すると、データが不正確になることがあります。
データを初めて移行する際には、このツールをファイルジオデータベースに対して実行することをお勧めします。処理中にデータベース内の各イベントレコードを変更する必要があるため、この方法で実行時間が短縮されます。実稼働環境では、実行時間を大幅に短縮させるために変更されたルートの選択セットに対してこのツールを実行できます。
入力イベントフィーチャレイヤーには、DerivedRouteID フィールドとメジャーフィールドが構成されている必要があります。
入力ルートフィーチャレイヤーの選択セットは適用されません。
イベントレイヤー上の選択セットは無視され、適用されません。
このツールは、ラインネットワーク内の 1 つのイベント、複数のイベント、またはすべてのイベントに対して実行することができます。
このツールは競合の防止をサポートしており、ロックの取得と転送を試行します。
競合の防止を有効にした場合は、次の処理が実行されます。
- イベントロックが利用可能な場合に、派生イベントメジャーを更新する必要のあるイベントでイベントロックが自動的に取得されます。ロックを取得できない場合は、このツールが正常に実行されず、そのロックのテキストファイルが表示されます。
  
  Pipeline Referencing での競合の防止または Roads and Highways での競合の防止の詳細
- デフォルトバージョンで作業している場合は、このツールの実行が完了した時点で、取得されたロックが自動的に解除されます。
- 指定バージョンで作業している場合は、このツールの実行が完了した時点で、取得されたロックは、ON POST ステータスのまま維持されます。ロックを解除するには、バージョンをポストまたは削除する必要があります。
- 指定バージョンで作業している場合に、中断によってこのツールの実行が取り消されると、取得されたロックが解除可能なステータスのまま維持されます。

ラベル	説明	データタイプ
入力ルートフィーチャ	`DerivedRouteID` フィールドとメジャーフィールドが構成されているイベントを含む LRS ネットワーク。	Feature Layer
選択したネットワークに登録されているすべてのイベントフィーチャクラスを更新 (オプション)	ネットワーク内のすべてのイベントフィーチャクラスを更新するかどうかを指定します。オン—入力ルートフィーチャパラメーター値で選択されたネットワーク内のすべてのイベントフィーチャクラスが更新されます。これがデフォルトです。オフ—入力ルートフィーチャパラメーター値で選択されたネットワーク内の一部のイベントフィーチャクラスが更新されません。イベントレイヤーパラメーターを使用して、イベントレイヤーを個別に選択することができます。	Boolean
イベントレイヤー (オプション)	`DerivedRouteID` フィールドとメジャーフィールドが更新されるイベントレイヤー。	Feature Layer

派生した出力

ラベル	説明	データタイプ
出力イベント	更新されたイベントフィーチャレイヤー。	Feature Layer
出力詳細ファイル	イベントフィーチャレイヤーに加えられた変更が詳しく記述されたテキストファイル。注意: このツールの検証結果は、ArcGIS Server ディレクトリーに書き込まれます。このファイルは、デフォルトでは 10 分以内に自動的にクリーンアップされますが、すべての検証を処理し、ArcGIS Pro を実行しているワークステーションに書き込むには十分ではない場合があります。大規模なデータ読み込みの場合は、ファイルの最大保存期間を少なくとも 1 時間に調整することをおすすめします。	Text File

arcpy.locref.DeriveEventMeasures(in_route_features, {update_all_events}, {event_layers})

名前	説明	データタイプ
in_route_features	`DerivedRouteID` フィールドとメジャーフィールドが構成されているイベントを含む LRS ネットワーク。	Feature Layer
update_all_events (オプション)	ネットワーク内のすべてのイベントフィーチャクラスを更新するかどうかを指定します。 `UPDATE_ALL`—`in_route_features` パラメーター値で選択されたネットワーク内のすべてのイベントフィーチャクラスが更新されます。これがデフォルトです。 `UPDATE_SOME`—`in_route_features` パラメーター値で選択されたネットワーク内の一部のイベントフィーチャクラスが更新されません。 `event_layers` パラメーターを使用して、イベントレイヤーを個別に選択することができます。	Boolean
event_layers [event_layers,...] (オプション)	`DerivedRouteID` フィールドとメジャーフィールドが更新されるイベントレイヤー。	Feature Layer

派生した出力

名前	説明	データタイプ
out_events	更新されたイベントフィーチャレイヤー。	Feature Layer
out_details_file	イベントフィーチャレイヤーに加えられた変更が詳しく記述されたテキストファイル。注意: このツールの検証結果は、ArcGIS Server ディレクトリーに書き込まれます。このファイルは、デフォルトでは 10 分以内に自動的にクリーンアップされますが、すべての検証を処理し、ArcGIS Pro を実行しているワークステーションに書き込むには十分ではない場合があります。大規模なデータ読み込みの場合は、ファイルの最大保存期間を少なくとも 1 時間に調整することをおすすめします。	Text File

コードのサンプル

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

次の Python ウィンドウスクリプトは、イミディエイトモードで DeriveEventMeasures 関数を使用する方法を示しています。

# Name: DeriveEventMeasures_ex1.py
# Description: Populate and update the Derived RouteID and measure values on point and line events with those fields configured and enabled in Python window.
# Requires: ArcGIS Location Referencing

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

# Local variables
in_route_features = "LineNetwork"
update_all_events = "UPDATE_SOME"
event_layers = "Casing, Coating"

# Run the tool
arcpy.locref.DeriveEventMeasures(in_route_features, update_all_events, event_layers)

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

次のスタンドアロン Python スクリプトは、DeriveEventMeasures 関数の使用方法を示しています。

# Name: DeriveEventMeasures_ex2.py
# Description: Populate and update the Derived routeID and measure values on point and line events with those fields configured and enabled in stand-alone script.
# Requirements: ArcGIS Location Referencing

# Import arcpy module
import arcpy

# Local variables
in_route_features = r'C:\Data\PipelineReferencing.gdb\LRS\LineNetwork'
update_all_events = "UPDATE_ALL"
event_layers = ""

# Run the tool
arcpy.locref.DeriveEventMeasures(in_route_features, update_all_events, event_layers)

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

次のスタンドアロン Python スクリプトは、DeriveEventMeasures 関数をフィーチャサービスで使用する方法を示しています。

# Name: DeriveEventMeasures_ex3.py
# Description: Populate and update Derived RouteID and measure values on point and line events with those fields configured and enabled in stand-alone script.
# Requires: ArcGIS Location Referencing

# Import arcpy module.
import arcpy

# Input LRS Route Network is in feature service. Portal signin is required to access the feature service.
arcpy.SignInToPortal('https://yourdomain.com/portal', 'username', 'password')

# Map the input route network from the feature service. Here, 3 corresponds to the input route network.
in_route_features = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/3"

# Set tool variables.
update_all_events = "UPDATE_ALL"
event_layers = ""

# Process : Derive Event Measures.
arcpy.locref.DeriveEventMeasures(in_route_features, update_all_events, event_layers)

環境

現在のワークスペース

ライセンス情報

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) が必要

イベント メジャーの取得 (Derive Event Measures) (Location Referencing ツール)

サマリー

使用法

パラメーター

派生した出力

注意:

環境

ライセンス情報

関連トピック

イベントメジャーの取得 (Derive Event Measures) (Location Referencing ツール)