ルート イベントのオーバーレイ (Overlay Route Events) (リニア リファレンス)

サマリー

2 つのイベント テーブルをオーバーレイして入力の和または交点を表す出力イベント テーブルを作成します。

使用法

  • ライン上にライン、ポイント上にライン、およびポイント上にポイントのイベント オーバーレイを実行できます。

  • 入力イベントとオーバーレイ イベントは同一のルート リファレンスに基づいている必要があります。

  • ArcGIS が対応している種類のテーブルはどれでも入力テーブルとして使用できます。 出力テーブルには、*.dbf ファイルまたはジオデータベース テーブルを使用できます。

  • [出力イベント テーブル] パラメーター値は、[ルート イベント レイヤーの作成 (Make Route Event Layer)] ツールを使用してマップに表示できます。

  • 入力イベントとオーバーレイ イベントのプロパティがどちらも [ポイント] の場合は、出力イベントのプロパティのタイプにも [ポイント] を指定する必要があります。

  • 入力イベントとオーバーレイ イベントのプロパティがどちらも [ライン] の場合は、出力イベントのプロパティのタイプにも [ライン] を指定する必要があります。

  • 入力イベントとオーバーレイ イベントのどちらかのプロパティが [ポイント] の場合、[インターセクト] オーバーレイを実施するときは出力イベントのプロパティのタイプに [ポイント] を指定する必要があります。 [ユニオン] オーバーレイを実施する場合は、出力イベントのプロパティのタイプに [ライン] を指定する必要があります。

  • 入力イベントとオーバーレイ イベントの両方のプロパティのタイプが [ポイント] の場合は、まったく同一の値を持つポイントだけが交差するものと見なされます。 検索許容値はありません。

  • ルート識別フィールドに属性フィールドを使用すると、ダイナミック セグメンテーション処理を高速化できます。 ダイナミック セグメンテーションに [出力イベント テーブル] パラメーター値を使用する場合は、属性インデックスの作成を選択することをお勧めします。

  • このツールを使用する前に [テーブル ビューの作成 (Create Table View)] ツールを使用して、処理の対象となるイベントの数を効果的に減らしてください。

  • 入力イベントまたはオーバーレイ イベントのどちらかに ObjectID フィールドがない場合は、このツールを使用する前に [クエリ テーブルの作成 (Make Query Table)] ツールで仮想 ObjectID フィールドを追加してください。

パラメーター

ラベル説明データ タイプ
入力イベント テーブル

入力イベント テーブル。

Table View
入力イベント テーブル プロパティ

入力イベント テーブルのルート ロケーション フィールドとイベント タイプで構成されるパラメーター。

  • [ルート識別フィールド]: 各イベントがあるルートを示す値が格納されるフィールド。 このフィールドには数値または文字を使用できます。
  • [イベント タイプ]: 入力イベント テーブルのイベントのタイプ ([ポイント] または [ライン])。
    • [ポイント]: ポイント イベントは、ルート沿いの正確な位置で発生します。 始点メジャーだけを指定する必要があります。
    • [ライン]: ライン イベントでは、ルートの一部分を定義します。 始点メジャーと終点メジャーの両方のフィールドを指定する必要があります。
  • [始点メジャー フィールド]: メジャー値を格納したフィールド。 このフィールドは数値でなければならず、イベント タイプが [ポイント] または [ライン] の場合は必須です。 [イベント タイプ][ポイント] の場合は、このパラメーターのラベルが [メジャー フィールド] になることに注意してください。
  • [終点メジャー フィールド]: メジャー値を格納したフィールド。 このフィールドは数値でなければならず、イベント タイプが [ライン] の場合は必須です。
Route Measure Event Properties
オーバーレイ イベント テーブル

オーバーレイ イベント テーブル。

Table View
オーバーレイ イベント テーブル プロパティ

オーバーレイ イベント テーブルのルート ロケーション フィールドとイベントのタイプ。

ルート識別フィールド: どのルート沿いに各イベントがあるのかを示す値を格納したフィールド。 このフィールドには数値または文字を使用できます。

[イベント タイプ]: オーバーレイ イベント テーブルのイベントのタイプ ([ポイント] または [ライン])。

  • [ポイント]: ポイント イベントは、ルート沿いの正確な位置で発生します。 始点メジャー フィールドだけを指定する必要があります。
  • [ライン]: ライン イベントでは、ルートの一部分を定義します。 始点メジャーと終点メジャーの両方のフィールドを指定する必要があります。

[始点メジャー フィールド]: 始点メジャー値を格納したフィールド。 このフィールドは数値でなければならず、イベント タイプが [ポイント] または [ライン] の場合は必須です。 [イベント タイプ][ポイント] の場合、このパラメーターのラベルは [メジャー フィールド] になります。

[終点メジャー フィールド]: 終点メジャー値を格納したフィールド。 このフィールドは数値でなければならず、イベント タイプが [ライン] の場合は必須です。

Route Measure Event Properties
オーバーレイ タイプ

実行するオーバーレイのタイプを指定します。

  • インターセクト重複するイベントのみが出力イベント テーブルに書き出されます。 これがデフォルトです。
  • ユニオンすべてのイベントが出力テーブルに書き出されます。 ライン イベントは交点で分割されます。
String
出力イベント テーブル

作成されるテーブル。

Table
出力イベント テーブル プロパティ

出力イベント テーブルに書き出されるルート ロケーション フィールドとイベント タイプで構成されるパラメーター。

  • [ルート識別フィールド]: 各イベントがあるルートを示す値が格納されるフィールド。
  • [イベント タイプ]: 出力イベント テーブルに格納されるイベントのタイプ ([ポイント] または [ライン])。
    • [ポイント]: ポイント イベントは、ルート沿いの正確な位置で発生します。 メジャーを 1 つだけ指定する必要があります。
    • [ライン]: ライン イベントでは、ルートの一部分を定義します。 始点メジャーと終点メジャーの両方のフィールドを指定する必要があります。
  • [始点メジャー フィールド]: メジャー値が格納されるフィールド。 イベント タイプが [ポイント] または [ライン] の場合は必須です。 [イベント タイプ][ポイント] の場合は、このパラメーターのラベルが [メジャー フィールド] になることに注意してください。
  • [終点メジャー フィールド]: メジャー値が格納されるフィールド。 イベント タイプが [ライン] の場合は必須です。
Route Measure Event Properties
長さゼロのライン イベントを保持
(オプション)

長さゼロのライン イベントが [出力イベント テーブル] パラメーター値に追加されるかどうかを指定します。 このパラメーターは出力イベント タイプが [ライン] の場合のみ有効です。

  • オン - 長さゼロのライン イベントが追加されます。 これがデフォルトです。
  • オフ - 長さゼロのライン イベントが追加されません。
Boolean
入力のすべてのフィールドを含める
(オプション)

[出力イベント テーブル] パラメーター値に、入力およびオーバーレイ イベント テーブルのすべてのフィールドが含まれるかどうかを指定します。

  • オン - 入力テーブルのすべてのフィールドが出力テーブルに含まれます。 これがデフォルトです。
  • オン - 入力テーブルの一部のフィールドは出力テーブルに含まれません。 ObjectID フィールドとルート ロケーション フィールドのみが含まれます。
Boolean
インデックスの構築
(オプション)

[出力イベント テーブル] パラメーター値に書き出されたルート識別フィールドについて属性インデックスを作成するかどうかを指定します。

  • オン - 属性インデックスが作成されます。 これがデフォルトです。
  • オフ - 属性インデックスが作成されません。
Boolean

arcpy.lr.OverlayRouteEvents(in_table, in_event_properties, overlay_table, overlay_event_properties, overlay_type, out_table, out_event_properties, {zero_length_events}, {in_fields}, {build_index})
名前説明データ タイプ
in_table

入力イベント テーブル。

Table View
in_event_properties

入力イベント テーブルのルート ロケーション フィールドとイベント タイプで構成されるパラメーター。

  • [ルート識別フィールド]: 各イベントがあるルートを示す値が格納されるフィールド。 このフィールドには数値または文字を使用できます。
  • [イベント タイプ]: 入力イベント テーブルのイベントのタイプ ([ポイント] または [ライン])。
    • [ポイント]: ポイント イベントは、ルート沿いの正確な位置で発生します。 始点メジャーだけを指定する必要があります。
    • [ライン]: ライン イベントでは、ルートの一部分を定義します。 始点メジャーと終点メジャーの両方のフィールドを指定する必要があります。
  • [始点メジャー フィールド]: メジャー値を格納したフィールド。 このフィールドは数値でなければならず、イベント タイプが [ポイント] または [ライン] の場合は必須です。 [イベント タイプ][ポイント] の場合は、このパラメーターのラベルが [メジャー フィールド] になることに注意してください。
  • [終点メジャー フィールド]: メジャー値を格納したフィールド。 このフィールドは数値でなければならず、イベント タイプが [ライン] の場合は必須です。
Route Measure Event Properties
overlay_table

オーバーレイ イベント テーブル。

Table View
overlay_event_properties

オーバーレイ イベント テーブルのルート ロケーション フィールドとイベントのタイプ。

ルート識別フィールド: どのルート沿いに各イベントがあるのかを示す値を格納したフィールド。 このフィールドには数値または文字を使用できます。

[イベント タイプ]: オーバーレイ イベント テーブルのイベントのタイプ ([ポイント] または [ライン])。

  • [ポイント]: ポイント イベントは、ルート沿いの正確な位置で発生します。 始点メジャー フィールドだけを指定する必要があります。
  • [ライン]: ライン イベントでは、ルートの一部分を定義します。 始点メジャーと終点メジャーの両方のフィールドを指定する必要があります。

[始点メジャー フィールド]: 始点メジャー値を格納したフィールド。 このフィールドは数値でなければならず、イベント タイプが [ポイント] または [ライン] の場合は必須です。 [イベント タイプ][ポイント] の場合、このパラメーターのラベルは [メジャー フィールド] になります。

[終点メジャー フィールド]: 終点メジャー値を格納したフィールド。 このフィールドは数値でなければならず、イベント タイプが [ライン] の場合は必須です。

Route Measure Event Properties
overlay_type

実行するオーバーレイのタイプを指定します。

  • INTERSECT重複するイベントのみが出力イベント テーブルに書き出されます。 これがデフォルトです。
  • UNIONすべてのイベントが出力テーブルに書き出されます。 ライン イベントは交点で分割されます。
String
out_table

作成されるテーブル。

Table
out_event_properties

出力イベント テーブルに書き出されるルート ロケーション フィールドとイベント タイプで構成されるパラメーター。

  • [ルート識別フィールド]: 各イベントがあるルートを示す値が格納されるフィールド。
  • [イベント タイプ]: 出力イベント テーブルに格納されるイベントのタイプ ([ポイント] または [ライン])。
    • [ポイント]: ポイント イベントは、ルート沿いの正確な位置で発生します。 メジャーを 1 つだけ指定する必要があります。
    • [ライン]: ライン イベントでは、ルートの一部分を定義します。 始点メジャーと終点メジャーの両方のフィールドを指定する必要があります。
  • [始点メジャー フィールド]: メジャー値が格納されるフィールド。 イベント タイプが [ポイント] または [ライン] の場合は必須です。 [イベント タイプ][ポイント] の場合は、このパラメーターのラベルが [メジャー フィールド] になることに注意してください。
  • [終点メジャー フィールド]: メジャー値が格納されるフィールド。 イベント タイプが [ライン] の場合は必須です。
Route Measure Event Properties
zero_length_events
(オプション)

長さゼロのライン イベントが out_table パラメーター値に追加されるかどうかを指定します。 このパラメーターは出力イベント タイプが LINE の場合にのみ有効です。

  • ZERO長さゼロのライン イベントが追加されます。 これがデフォルトです。
  • NO_ZERO長さゼロのライン イベントが追加されません。
Boolean
in_fields
(オプション)

out_table パラメーター値に、入力およびオーバーレイ イベント テーブルのすべてのフィールドが含まれるかどうかを指定します。

  • FIELDS入力テーブルのすべてのフィールドが出力テーブルに含まれます。 これがデフォルトです。
  • NO_FIELDS入力テーブルの一部のフィールドは出力テーブルに含まれません。 ObjectID フィールドとルート ロケーション フィールドのみが含まれます。
Boolean
build_index
(オプション)

out_table パラメーター値に書き出されたルート識別フィールドについて属性インデックスを作成するかどうかを指定します。

  • INDEX属性インデックスが作成されます。 これがデフォルトです。
  • NO_INDEX属性インデックスが作成されません。
Boolean

コードのサンプル

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

次の Python ウィンドウ スクリプトは、OverlayRouteEvents 関数の使用方法を示しています。

import arcpy
arcpy.env.workspace = "C:/Data"
arcpy.OverlayRouteEvents_lr("accident.dbf", "rkey POINT mile", "pavecond.dbf", 
                            "rkey LINE fmp tmp", "INTERSECT", "accpav", 
                            "rkey POINT mile" )
OverlayRouteEvents の例 2 (スタンドアロン スクリプト)

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

# Description: Point-on-line INTERSECT overlay (both tables are dBASE)

# Import system modules 
import arcpy

# Set workspace
arcpy.env.workspace = "C:/Data"

# Set local variables
in_tbl = "accident.dbf"
in_props = "rkey POINT mile"  # reused as out event properties
ov_tbl = "pavecond.dbf"
ov_props = "rkey LINE fmp tmp"
out_tbl = "accpav"

# Execute OverlayRouteEvents
arcpy.OverlayRouteEvents_lr(in_tbl, in_props, ov_tbl, ov_props, "INTERSECT", 
                            out_tbl, in_props)
OverlayRouteEvents の例 3 (スタンドアロン スクリプト)

次の Python スクリプトは、ファイル ジオデータベース データを使用し、スタンドアロン Python スクリプトで OverlayRouteEvents 関数を使用する方法を示します。

# Description: Line-on-line UNION overlay (both tables are in a file 
#              geodatabase)

# Import system modules
import arcpy

# Set workspace
arcpy.env.workspace = "C:/Data/Pitt.gdb"

# Set local variables
in_tbl = "pavecond"
in_props = "rkey LINE fmp tmp"  # reused as overlay and out event properties
ov_tbl = "pavetype"
out_tbl = "condtype" 

# Execute OverlayRouteEvents
arcpy.OverlayRouteEvents_lr(in_tbl, in_props, ov_tbl, in_props, "UNION", 
                            out_tbl, in_props, "NO_ZERO")
OverlayRouteEvents の例 4 (スタンドアロン スクリプト)

次の Python スクリプトは、エンタープライズ ジオデータベース データを使用し、スタンドアロン Python スクリプトで OverlayRouteEvents 関数を使用する方法を示します。

# Description: Point-on-line INTERSECT overlay (both tables are in enterprise 
#              geodatabase)

# Import system modules 
import arcpy

# Set workspace
arcpy.env.workspace = "C:/MyProject/myConn.sde"

# Set local variables
in_tbl = arcpy.ValidateTableName("accident", wkspc)
in_props = "rkey POINT mile"  
ov_tbl = arcpy.ValidateTableName("pavecond", wkspc) 
ov_props = "rkey LINE fmp tmp"
out_tbl = "accpav"
out_props = "routekey POINT milepost"  # names are changed for out table

# Execute OverlayRouteEvents
arcpy.OverlayRouteEvents_lr(in_tbl, in_props, ov_tbl, ov_props, "INTERSECT", 
                            out_tbl, out_props)

ライセンス情報

  • Basic: Yes
  • Standard: Yes
  • Advanced: Yes

関連トピック