ラベル | 説明 | データ タイプ |
入力ルート フィーチャ | イベント レイヤーが動的にセグメント化されるターゲット ネットワーク。 | Feature Layer |
イベント レイヤー | ターゲット ネットワークで、同時に動的にセグメント化されるイベント レイヤー。 | Feature Layer |
出力データセット | 作成される出力イベント レコードを含むテーブルまたはフィーチャクラス。 | Table |
ジオメトリを含める (オプション) | [出力データセット] 値にイベント ジオメトリを含めるかどうかを指定します。
| Boolean |
ネットワーク フィールド (オプション) | 出力に含められるネットワーク レイヤーのフィールド。 | Field |
Location Referencing ライセンスで利用可能です。
サマリー
ターゲット ネットワーク上に 1 つ以上のリニア イベント フィーチャ レイヤーをオーバーレイし、入力のダイナミック セグメンテーションを表すフィーチャクラスまたはテーブルを出力します。
使用法
すべての入力 [イベント レイヤー] 値はライン イベントでなくてはなりません。
[イベント レイヤー] パラメーターには、ArcGIS Location Referencing ネットワークに登録されているリニア イベント フィーチャクラスのみを含めることができます。
入力イベントで異なるリニア リファレンス方法 (LRM) を使用している場合、ターゲット ネットワークの LRM を使用して変換されます。
このツールは選択セットはサポートしています。
フィルター定義はサポートされています。
このツールは、複数ルートをスパンするイベントを含むように構成されている入力 [イベント レイヤー] 値をサポートしています。 出力は引き続き、[ネットワーク フィールド] パラメーターを使用して、ターゲット ネットワークのルート レベルで動的にセグメント化されます。
このツールは、時間のセグメンテーション (タイム スライス) をサポートしています。 これはデフォルトで発生し、時間ベースの定義クエリを作成するか、入力に選択セットを適用してオーバーライドできます。
このツールは、[ネットワーク フィールド] パラメーターを使用して、出力にネットワーク フィーチャクラスの 1 つ以上のフィールドを含めることをサポートしています。
出力は、テーブルまたはフィーチャクラスのいずれかとして保存できます。
出力をテーブルまたはフィーチャクラスとして保存した場合、出力には次のインデックスおよびフィールドが含まれます。
インデックス フィールド Route_ID
- Route_ID
Rid_Dates_Me
- Route_ID
- From_Date
- To_Date
- From_Measure
- To_Measure
ターゲット LRS ネットワークがマルチフィールド ルート ID をサポートするライン ネットワークとして構成されている場合,ルートを追加する際に以下のパラメーターは必要ありません。
- ルート名フィールド
- ライン名フィールド
このツールは、フィーチャクラスが [ユーティリティ ネットワーク フィーチャクラスの構成 (Configure Utility Network Feature Class)] ツールを使用して LRS で使用するために構成されている場合、入力イベント レイヤーとして Gas Utility Network Configuration パイプライン フィーチャ レイヤーをサポートしています。
Gas Utility Network Configuration に複数の LRS ネットワークが存在する場合、入力イベント レイヤーのメジャー値は以下の表の右側の列に示すメジャー値と一致します。
Utility Network Configuration を持つ LRS が以下を含む場合 PipelineLine フィーチャクラスのメジャー値は以下に含まれる ライン ネットワーク、非ライン ネットワーク
ライン ネットワーク
ライン ネットワーク
ライン ネットワーク
複数のライン ネットワーク
派生ネットワークを含むライン ネットワーク
派生ネットワークを含まない複数のライン ネットワーク
コード値ドメインで最も低い値のライン ネットワーク dLRSNetworks
派生ネットワークを含む複数のライン ネットワーク
コード値ドメインで最も低い値のライン ネットワーク dLRSNetworks
1 つの非ライン ネットワーク
非ライン ネットワーク
複数の非ライン ネットワーク
コード値ドメインで最も低い値のネットワーク dLRSNetworks
このツールは、物理的ギャップを含むルートとイベントを、それぞれ入力ルートおよび入力イベントとしてサポートします。
ルート セグメント上に配置できるのは、各レイヤーで 1 つのイベントのみです。 たとえば、Speed Limit レイヤーの場合、そのセグメント上にそのレイヤーのイベント レコードを 1 つだけ配置できます。 セグメントには複数のイベントを含めることができ、それぞれが独自のイベント レイヤーに含まれます。 ArcGIS Data Reviewer の [無効なイベント メジャー (Invalid Events Measures)] ツールを使用して、イベント データの問題を特定して解決します。
パラメーター
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"
include_geometry = "EXCLUDE_GEOMETRY"
network_fields = ""
# Set current workspace
arcpy.env.workspace = "C:\Data\NY_Data.gdb"
# Execute the tool
arcpy.locref.OverlayEvents(in_route_features, event_layers, output_dataset, include_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)