イベントのオーバーレイ (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

  • このツールは、フィーチャクラスが [ユーティリティ ネットワーク フィーチャクラスの構成 (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 の「無効なイベント メジャー」チェックを使用して、イベント データの問題を特定して、解決します。

パラメーター

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

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

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 ウィンドウ スクリプトは、OverlayEvents ウィンドウで Python 関数を使用する方法を示しています。

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

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

# 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)

関連トピック