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

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)] ツールを使用して、イベント データの問題を特定して解決します。

パラメーター

ラベル説明データ タイプ
入力ルート フィーチャ

イベント レイヤーが動的にセグメント化されるターゲット ネットワーク。

Feature Layer
イベント レイヤー

ターゲット ネットワークで、同時に動的にセグメント化されるイベント レイヤー。

Feature Layer
出力データセット

作成される出力イベント レコードを含むテーブルまたはフィーチャクラス。

Table
ジオメトリを含める
(オプション)

[出力データセット] 値にイベント ジオメトリを含めるかどうかを指定します。

  • オフ - [出力データセット] 値にイベント ジオメトリは含まれません。 イベント レコードはテーブルとして格納されます。 これがデフォルトです。
  • オン - [出力データセット] 値にイベント ジオメトリが含まれます。 イベント レコードはフィーチャクラスとして格納されます。
Boolean
ネットワーク フィールド
(オプション)

出力に含められるネットワーク レイヤーのフィールド。

Field

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 値にイベント ジオメトリを含めるかどうかを指定します。

  • EXCLUDE_GEOMETRYoutput_dataset 値にイベント ジオメトリは含まれません。 イベント レコードはテーブルとして格納されます。 これがデフォルトです。
  • INCLUDE_GEOMETRYoutput_dataset 値にイベント ジオメトリが含まれます。 イベント レコードはフィーチャクラスとして格納されます。
Boolean
network_fields
[network_fields,...]
(オプション)

出力に含められるネットワーク レイヤーのフィールド。

Field

コードのサンプル

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

次の 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)
OverlayEvents の例 2 (スタンドアロン スクリプト)

次の 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 の例 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
 
# 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)

関連トピック