ラベル | 説明 | データ タイプ |
入力ルート フィーチャ | イベント レイヤーが、動的にセグメント化されるターゲット ネットワーク。 | Feature Layer |
イベント レイヤー | ターゲット ネットワークで、同時に動的にセグメント化されるイベント レイヤー。 中心線レイヤーは、イベントを動的にセグメント化するための入力として使用できます。 | Feature Layer |
出力データセット | 作成される出力イベント レコードを含むテーブルまたはフィーチャクラス。 | Table |
ジオメトリを含める (オプション) | [出力データセット] パラメーター値に、イベント ジオメトリを含めるかどうかを指定します。
| Boolean |
ネットワーク フィールド (オプション) | 出力に含められるネットワーク レイヤーのフィールド。 | Field |
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>
すべての [イベント レイヤー] の値は、ライン イベントのみであるか、ポイント イベントとライン イベントの両方を含めることができます。
[イベント レイヤー] パラメーターには、ArcGIS Location Referencing ネットワークに登録されているイベント フィーチャクラスのみを含めることができます。
注意:
中心線レイヤーが住所データの管理またはUtility Network構成の一部である場合、[イベント レイヤー] パラメーターに中心線レイヤーを入力して、イベントを動的にセグメント化できます。 中心線レイヤーが住所データの管理ソリューション構成の一部である場合、中心線方向が出力で適用されます。
入力レイヤーに住所データの管理の構成からの住所範囲フィールドが含まれており、入力レイヤーが LRS で住所フィーチャクラスとして構成されている場合、出力の各セグメントで住所範囲フィールドの値が更新されます。
入力イベントで異なるリニア リファレンス方法 (LRM) を使用している場合、ターゲット ネットワークの LRM を使用して変換されます。
このツールでは、[入力ルート フィーチャ] パラメーターと [イベント レイヤー] パラメーターの値として選択セットがサポートされます。
このツールでは、[入力ルート フィーチャ] パラメーターと [イベント レイヤー] パラメーターの値として定義フィルターがサポートされます。
このツールは、複数ルートをスパンするイベントを含むように構成されている入力 [イベント レイヤー] 値をサポートしています。 出力は引き続き、[ネットワーク フィールド] パラメーター値を使用して、ターゲット ネットワークのルート レベルで動的にセグメント化されます。
このツールは、時間のセグメンテーション (タイム スライス) をサポートしています。 これはデフォルトで発生し、時間ベースの定義クエリを作成するか、入力に選択セットを適用して、オーバーライドできます。
このツールは、[ネットワーク フィールド] パラメーターを使用して、出力にネットワーク フィーチャクラスの 1 つ以上のフィールドを含めることをサポートしています。
出力は、テーブルまたはフィーチャクラスのいずれかとして保存できます。
出力をテーブルまたはフィーチャクラスとして保存した場合、出力には次のインデックスおよびフィールドが含まれます。
インデックス フィールド Route_ID
- Route_ID
Rid_Dates_Me
- Route_ID
- From_Date
- To_Date
- From_Measure
- To_Measure
このツールは、フィーチャクラスが [ユーティリティ ネットワーク フィーチャクラスの構成 (Configure Utility Network Feature Class)] ツールを使用して、LRS で使用するために構成されている場合、入力イベント レイヤーとして Gas Utility Network Configuration パイプライン フィーチャ レイヤーをサポートしています。
Gas Utility Network Configuration に複数の LRS ネットワークが存在する場合、入力イベント レイヤーのメジャーは、以下の表の 2 列目に示すメジャーと一致します。
Utility Network Configuration を持つ LRS が以下を含む場合 パイプライン ライン フィーチャクラスのメジャーが以下を含む ライン ネットワーク、非ライン ネットワーク
ライン ネットワーク
ライン ネットワーク
ライン ネットワーク
複数のライン ネットワーク
派生ネットワークを含むライン ネットワーク
派生ネットワークを含まない複数のライン ネットワーク
コード値ドメインで最も低い値のライン ネットワーク dLRSNetworks
派生ネットワークを含む複数のライン ネットワーク
コード値ドメインで最も低い値のライン ネットワーク dLRSNetworks
1 つの非ライン ネットワーク
非ライン ネットワーク
複数の非ライン ネットワーク
コード値ドメインで最も低い値のネットワーク dLRSNetworks
このツールは、物理的ギャップを含むルートとイベントを、それぞれ入力ルートおよび入力イベントとしてサポートします。
ルート セグメント上に配置できるのは、各レイヤーで 1 つのイベントのみです。 たとえば、Speed Limit レイヤーの場合、そのセグメント上に、そのレイヤーのイベント レコードを 1 つだけ配置できます。 セグメントには複数のイベントを含めることができ、それぞれが独自のイベント レイヤーに含まれます。 ArcGIS Data Reviewer の「無効なイベント メジャー」チェックを使用して、イベント データの問題を特定して、解決します。
パラメーター
arcpy.locref.OverlayEvents(in_route_features, event_layers, output_dataset, {include_geometry}, {network_fields})
名前 | 説明 | データ タイプ |
in_route_features | イベント レイヤーが、動的にセグメント化されるターゲット ネットワーク。 | Feature Layer |
event_layers [event_layers,...] | ターゲット ネットワークで、同時に動的にセグメント化されるイベント レイヤー。 中心線レイヤーは、イベントを動的にセグメント化するための入力として使用できます。 | Feature Layer |
output_dataset | 作成される出力イベント レコードを含むテーブルまたはフィーチャクラス。 | Table |
include_geometry (オプション) | output_dataset パラメーター値に、イベント ジオメトリを含めるかどうかを指定します。
| Boolean |
network_fields [network_fields,...] (オプション) | 出力に含められるネットワーク レイヤーのフィールド。 | Field |
コードのサンプル
次の 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 = ""
# Set current workspace
arcpy.env.workspace = r"C:\Data\NY_Data.gdb"
# Execute the tool
arcpy.locref.OverlayEvents(in_route_features, event_layers, output_dataset, Geometry, network_fields)
次の Python スクリプトは、スタンドアロン Python スクリプトで 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
# Check out license
arcpy.CheckOutExtension("LocationReferencing")
# 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 = ""
# Process: Overlay Events
arcpy.locref.OverlayEvents(Network, Events, Output_Dataset, Geometry, Network_Fields)
# Check in license
arcpy.CheckInExtension('LocationReferencing')
次のスタンドアロン スクリプトは、フィーチャ サービスで 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
# Check out license
arcpy.CheckOutExtension("LocationReferencing")
#Input LRS network and events are in feature service. Portal signi 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 and 2 and 3 corresponds to 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 = ""
# Process: Overlay Events.
arcpy.locref.OverlayEvents(in_network, in_events, Output_Dataset, Geometry, Network_Fields)
# 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)