トップへ戻る

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

このトピックの内容

  1. サマリー
  2. 図
  3. 使用法
  4. パラメーター
  5. 環境
  6. ライセンス情報

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 ネットワークに登録されたイベント フィーチャクラスを含めることもできます。

    注意:
    • Address Data Management 構成または ArcGIS Utility Network 構成の一部である場合に中心線フィーチャクラスを [イベント レイヤー] パラメーターに入力すると、イベントを動的にセグメント化できます。 中心線フィーチャクラスが Address Data Management 構成の一部である場合は、中心線の方向が出力で優先されます。
    • Address Data Management 構成では、[住所フィーチャクラスの構成 (Configure Address Feature Classes)] ツールを使用して、LRS で使用する中心線フィーチャクラスを構成します。
    • Utility Network 構成では、[ユーティリティー ネットワーク フィーチャクラスの構成 (Configure Utility Network Feature Class)] ツールを使用して、LRS で使用する中心線フィーチャクラスを構成します。

  • 入力レイヤーが Address Data Management 構成の住所範囲フィールドを含み、LRS で住所範囲フィーチャクラスとして構成されていると、住所範囲フィールドの値が出力のセグメントごとに更新されます。

  • 入力イベント レイヤーが、別のリニア リファレンス方法 (LRM) を使用している場合は、ターゲット ネットワークの LRM を使用して変換されます。

  • このツールは、[入力ルート フィーチャ] および [イベント レイヤー] パラメーター値で選択セットと定義クエリーをサポートします。

    注意:

    入力ルートに関連付けられたすべてのイベント レコードを含めるには、入力イベント レイヤーごとに [選択レコードを使用] または [フィルターされたレコードを使用] 切り替えボタンをオフにします。

  • このツールは、複数のルートにまたがるイベントを含むように構成された入力イベント レイヤーをサポートします。 出力は、[ネットワーク フィールド] パラメーター値を使用してターゲット ネットワークのルート レベルで引き続き動的にセグメント化されます。

  • このツールは時間セグメンテーション (タイム スライス) をサポートします。 この機能はデフォルトで実行され、時間ベースの定義クエリーを作成するか、選択セットを入力に適用することでオーバーライドできます。

  • このツールでは、[ネットワーク フィールド] パラメーターを使用してネットワーク フィーチャクラスの 1 つ以上のフィールドを出力に含めることができます。

  • 出力はテーブルまたはフィーチャクラスとして保存できます。

  • 出力がテーブルまたはフィーチャクラスとして保存されると、次のインデックスとフィールドが含まれます。

    インデックスフィールド

    route_id

    • Route_ID

    rid_dates_measures

    • Route_ID
    • From_Date
    • To_Date
    • From_Measure
    • To_Measure

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

    Utility Network 構成を使用する LRS に次が含まれる場合パイプライン ライン フィーチャクラスのメジャーの所属先

    ライン ネットワーク、非ライン ネットワーク

    ライン ネットワーク

    ライン ネットワーク

    ライン ネットワーク

    複数のライン ネットワーク

    派生ネットワークがあるライン ネットワーク

    派生ネットワークがない複数のライン ネットワーク

    コード値ドメインで最小の数値を持つライン ネットワーク、 dLRSNetworks

    派生ネットワークがある複数のライン ネットワーク

    コード値ドメインで最小の数値を持つライン ネットワーク、 dLRSNetworks

    1 つの非ライン ネットワーク

    非ライン ネットワーク

    複数の非ライン ネットワーク

    コード値ドメインで最小の数値を持つネットワーク dLRSNetworks

  • このツールは、物理的ギャップを含むルートとイベントを、それぞれ入力ルートおよび入力イベントとしてサポートします。

  • ルート セグメントに指定できるイベントはレイヤーごとに 1 つのみです。 たとえば、Speed Limit という名前のレイヤーでは、そのレイヤーの 1 つのイベント レコードのみをそのセグメントに指定できます。 セグメントには、それぞれが独自のイベント レイヤーに含まれる複数のイベントを指定できます。 イベント データに関する問題を特定して解決するには、ArcGIS Data Reviewer の無効なイベント メジャー チェックを使用します。

パラメーター

ダイアログPython

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

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

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_GEOMETRY—output_dataset パラメーター値にイベント ジオメトリーを含めません。 イベント レコードはテーブルとして格納されます。 これがデフォルトです。
  • INCLUDE_GEOMETRY—output_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"
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 スクリプトは、スタンドアロン 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)

関連トピック

  • Location Referencing ツールボックスの概要
  • ジオプロセシング ツールの検索

このトピックへのフィードバック

このトピックの内容
  1. サマリー
  2. 図
  3. 使用法
  4. パラメーター
  5. 環境
  6. ライセンス情報