イベントのオーバーレイ (Overlay Events) (Location Referencing ツール)

サマリー

1 つ以上のラインおよびポイントイベントレイヤーをターゲットネットワーク上にオーバーレイして、入力のダイナミックセグメンテーションを表すフィーチャクラスまたはテーブルを出力します。

図

イベントのオーバーレイツールの図

使用法

次の表に、上の図に示したツールの出力を示します。

出力 (イベントのオーバーレイ)


タイプ	始点メジャー	終点メジャー	ラインイベント 1	ラインイベント 2	ポイントイベント
ライン	0	2	A	1	<Null>
ポイント	2	2	A	1	PE1
ライン	2	3	A	1	<Null>
ライン	3	4	B	1	<Null>
ライン	4	5	B	2	<Null>

イベントレイヤー パラメーター値には、ラインイベントを指定するか、ポイントイベントとラインイベントの両方を含めることができます。
イベントレイヤー パラメーターには、LRS ネットワークに登録されたイベントフィーチャクラスを含めることもできます。
注意:
- アドレスデータの管理の構成で、LRL と使用する中心線フィーチャクラスを構成した後に、ダイナミックセグメンテーションのために、中心線フィーチャクラスを イベントレイヤー パラメーターの入力として使用できます。出力では、中心線のデジタイズ方向が適用されます。
- ArcGIS Utility Network の構成で、LRS と使用するパイプラインライン、パイプラインデバイス、パイプラインジャンクションフィーチャクラスを構成した後に、ダイナミックセグメンテーションのために、これらのフィーチャクラスを イベントレイヤー パラメーターの入力として使用できます。
入力レイヤーがアドレスデータの管理の構成からのアドレス範囲フィールドを含み、LRS でアドレス範囲フィーチャクラスとして構成されていると、アドレスブロック分割タイプ パラメーター値が比例の場合に、アドレス範囲フィールドの値が出力のセグメントごとに比例して更新されます。このパラメーター値が 最近隣アドレスポイント の場合、アドレス範囲は、出力のセグメントごとに最も近い上流と下流のアドレスポイントに基づいて更新されます。

LRS とアドレスデータの管理データセットを組み合わせた場合の解析機能の詳細
入力イベントレイヤーが、別のリニアリファレンス方法 (LRM) を使用している場合は、ターゲットネットワークの LRM を使用して変換されます。
このツールは、入力ルートフィーチャ および イベントレイヤー パラメーター値で選択セットと定義クエリーをサポートします。

注意:

入力ルートに関連付けられたすべてのイベントレコードを含めるには、入力イベントレイヤーごとに 選択レコードを使用 または フィルターされたレコードを使用 切り替えボタンをオフにします。
このツールは、複数のルートにまたがるイベントを含むように構成された入力イベントレイヤーをサポートします。出力は、ネットワークフィールド パラメーター値を使用してターゲットネットワークのルートレベルで引き続き動的にセグメント化されます。
このツールは時間セグメンテーション (タイムスライス) をサポートします。この機能はデフォルトで実行され、時間ベースの定義クエリーを作成するか、選択セットを入力に適用することでオーバーライドできます。
このツールでは、ネットワークフィールド パラメーターを使用してネットワークフィーチャクラスの 1 つ以上のフィールドを出力に含めることができます。
出力はテーブルまたはフィーチャクラスとして保存できます。
出力がテーブルまたはフィーチャクラスとして保存されると、次のインデックスとフィールドが含まれます。
インデックス

フィールド
route_id
Route_ID
rid_dates_measures
Route_ID

From_Date

To_Date

From_Measure

To_Measure

インデックス	フィールド
route_id	`Route_ID`
rid_dates_measures	`Route_ID` `From_Date` `To_Date` `From_Measure` `To_Measure`

Utility Network の構成に複数の LRS ネットワークが存在する場合、入力イベントレイヤーのメジャーは、以下の表の 2 列目に示すメジャーと一致します:


Utility Network の構成を持つ LRS が以下を含む場合	パイプラインラインフィーチャクラスのメジャーの所属先
ラインネットワーク、非ラインネットワーク	ラインネットワーク
ラインネットワーク	ラインネットワーク
複数のラインネットワーク	派生ネットワークがあるラインネットワーク
派生ネットワークがない複数のラインネットワーク	コード値ドメインで最小の数値を持つラインネットワーク `dLRSNetworks`
派生ネットワークがある複数のラインネットワーク	コード値ドメインで最小の数値を持つラインネットワーク `dLRSNetworks`
1 つの非ラインネットワーク	非ラインネットワーク
複数の非ラインネットワーク	コード値ドメインで最小の数値を持つネットワーク `dLRSNetworks`

このツールは、物理的ギャップを含むルートとイベントを、それぞれ入力ルートおよび入力イベントとしてサポートします。
ルートセグメントに指定できるイベントはレイヤーごとに 1 つのみです。たとえば、Speed Limit という名前のレイヤーでは、そのレイヤーの 1 つのイベントレコードのみをそのセグメントに指定できます。セグメントには、それぞれが独自のイベントレイヤーに含まれる複数のイベントを指定できます。イベントデータに関する問題を特定して解決するには、ArcGIS Data Reviewer の無効なイベントメジャーチェックを使用します。
フィーチャサービスからのデータを使用してこのツールを実行しているときに、エラーが発生したりパフォーマンスが想定より低くなっている場合は、サービスレベルでヒープサイズを大きくしてください。
このツールの並列処理ファクター環境設定は、複数のルートにまたがるイベントや、ターゲットネットワークに登録されていないまたがらないイベントにのみ適用されます。

ラベル	説明	データタイプ
入力ルートフィーチャ	イベントレイヤーが、動的にセグメント化されるターゲットネットワーク。	Feature Layer
イベントレイヤー	ターゲットネットワークへと動的にセグメント化されるイベントレイヤー。中心線レイヤーは、イベントを動的にセグメント化するための入力として使用できます。	Feature Layer
出力データセット	作成される出力イベントレコードを含むテーブルまたはフィーチャクラス。	Table
ジオメトリーを含める (オプション)	出力データセットパラメーター値にイベントジオメトリーを含めるかどうかを指定します。オン—出力データセットパラメーター値にイベントジオメトリーを含めます。イベントレコードはフィーチャクラスとして格納されます。オフ—出力データセットパラメーター値にイベントジオメトリーを含めません。イベントレコードはテーブルとして格納されます。これがデフォルトです。	Boolean
ネットワークフィールド (オプション)	出力に含められるネットワークレイヤーのフィールド。	Field
アドレスブロック分割タイプ (オプション)	アドレス範囲が出力のセグメントごとにどのように更新されるかを指定します。このパラメーターは、構成されたアドレス範囲レイヤーが入力イベントレイヤーとして使用される場合にのみ使用できます。最近隣アドレスポイント—アドレス範囲は、出力のセグメントごとに最も近い上流と下流のアドレスの値に基づいて更新されます。比例—アドレス範囲は、出力のセグメントごとに分割位置から比例して更新されます。これがデフォルトです。	String

arcpy.locref.OverlayEvents(in_route_features, event_layers, output_dataset, {include_geometry}, {network_fields}, {address_block_split_type})

名前	説明	データタイプ
in_route_features	イベントレイヤーが、動的にセグメント化されるターゲットネットワーク。	Feature Layer
event_layers [event_layers,...]	ターゲットネットワークへと動的にセグメント化されるイベントレイヤー。中心線レイヤーは、イベントを動的にセグメント化するための入力として使用できます。	Feature Layer
output_dataset	作成される出力イベントレコードを含むテーブルまたはフィーチャクラス。	Table
include_geometry (オプション)	`output_dataset` パラメーター値にイベントジオメトリーを含めるかどうかを指定します。 `INCLUDE_GEOMETRY`—`output_dataset` パラメーター値にイベントジオメトリーを含めます。イベントレコードはフィーチャクラスとして格納されます。 `EXCLUDE_GEOMETRY`—`output_dataset` パラメーター値にイベントジオメトリーを含めません。イベントレコードはテーブルとして格納されます。これがデフォルトです。	Boolean
network_fields [network_fields,...] (オプション)	出力に含められるネットワークレイヤーのフィールド。	Field
address_block_split_type (オプション)	アドレス範囲が出力のセグメントごとにどのように更新されるかを指定します。このパラメーターは、構成されたアドレス範囲レイヤーが入力イベントレイヤーとして使用される場合にのみ使用できます。 `NEAREST_ADDRESS_POINT`—アドレス範囲は、出力のセグメントごとに最も近い上流と下流のアドレスの値に基づいて更新されます。 `PROPORTIONAL`—アドレス範囲は、出力のセグメントごとに分割位置から比例して更新されます。これがデフォルトです。	String

コードのサンプル

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

次の Python ウィンドウスクリプトは、OverlayEvents 関数の使用方法を示しています。

# Name: OverlayEvents_ex1.py
# Description: Overlays linear event feature layers against a target network and output a feature class or table that represents the dynamic segmentation of those inputs.
# Requirements: ArcGIS Location Referencing

# tool variables
in_route_features = r"C:\Data\NY_Data.gdb\LRS\LRSN_MilePoint"
event_layers = [r"C:\Data\NY_Data.gdb\LRS\LRSE_Access_Control", r"C:\Data\NY_Data.gdb\LRS\LRSE_Functional_Class"]
output_dataset = r"C:\Data\NY_Data.gdb\Output"
Geometry = "EXCLUDE_GEOMETRY"
network_fields = ""
address_block_split_type = ""

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

# Run the tool
arcpy.locref.OverlayEvents(in_route_features, event_layers, output_dataset, Geometry, network_fields, address_block_split_type)

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

次のスタンドアロンスクリプトで、OverlayEvents 関数を使用する方法を示します。

# Name: OverlayEvents_ex2.py
# Description: Overlay linear event feature layers against a target network then output a feature class or table that represents the dynamic segmentation of those inputs.
# Requires: ArcGIS Location Referencing

# Import arcpy module
import arcpy

# Local variables:
Network = r"C:\Data\NY_Data.gdb\LRS\LRSN_MilePoint"
Events = [r"C:\Data\NY_Data.gdb\LRS\LRSE_Access_Control", r"C:\Data\NY_Data.gdb\LRSE_Functional_Class"]
Output_Dataset = r"C:\Data\NY_Data.gdb\Output"
Geometry = "EXCLUDE_GEOMETRY"
Network_Fields = ""
Address_Block_Split_Type = ""

# Process: Overlay Events
arcpy.locref.OverlayEvents(Network, Events, Output_Dataset, Geometry, Network_Fields, Address_Block_Split_Type)

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

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

# Name: OverlayEvents_Pro_Ex3.py
# Description: Overlay events using a feature service. It is recommended to work in a version and post to the default version.
# Requires: ArcGIS Location Referencing

# Import arcpy module
import arcpy

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

# Map the input LRS network and events from the feature service. Here, 1 corresponds to the input LRS network, while 2 and 3 corresponds to the input events.
in_network  = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/1"
event1 = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/2"
event2 = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/3"
in_events = [event1, event2]

# Set tool variables
Output_Dataset = r"C:\Data\LocationReferencing.gdb\output"
Geometry = "EXCLUDE_GEOMETRY"
Network_Fields = ""
Address_Block_Split_Type = ""

# Process: Overlay Events.
arcpy.locref.OverlayEvents(in_network, in_events, Output_Dataset, Geometry, Network_Fields, Address_Block_Split_Type)

環境

現在のワークスペース, 並列処理ファクター

特殊なケース

並列処理ファクター: The default value for this environment, if left blank, is 0%. Any absolute value for the environment is always clamped between 0 and the number of logical cores on your machine.

ライセンス情報

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

イベントのオーバーレイ (Overlay Events) (Location Referencing ツール)

サマリー

図

使用法

注意:

注意:

パラメーター

環境

特殊なケース

ライセンス情報

関連トピック