サマリ
2 つのイベント テーブルをオーバーレイして入力の和または交点を表す出力イベント テーブルを作成します。
使用法
ライン上にライン、ポイント上にライン、およびポイント上にポイントのイベント オーバーレイを実行できます。
入力イベントとオーバーレイ イベントは同一のルート リファレンスに基づいている必要があります。
ArcGIS が対応している種類のテーブルはどれでも入力テーブルとして使用できます。出力テーブルは dBASE ファイルでもジオデータベース テーブルでもかまいません。
ArcMap で出力テーブルを表示するには、[ルート イベント レイヤーの作成] ツールを使用するか、ArcMap で [ルート イベント レイヤーの作成] コマンドを使用します。
入力イベントとオーバーレイ イベントのプロパティがどちらも POINT の場合は、出力イベントのプロパティのタイプにも POINT を指定する必要があります。
入力イベントとオーバーレイ イベントのプロパティがどちらも LINE の場合は、出力イベントのプロパティのタイプにも LINE を指定する必要があります。
入力イベントとオーバーレイ イベントのどちらかのプロパティが POINT の場合、INTERSECT オーバーレイを実施するときは出力イベントのプロパティのタイプに POINT を指定する必要があります。UNION オーバーレイを実施する場合は、出力イベントのプロパティのタイプに LINE を指定する必要があります。
入力イベントとオーバーレイ イベントの両方のプロパティのタイプが POINT の場合は、全く同一の値を持つポイントだけが交差するものと見なされます。検索許容値はありません。
ルート識別フィールドに属性フィールドを使用すると、ダイナミック セグメンテーション処理を高速化できます。ダイナミック セグメンテーションに出力イベント テーブルを使用する場合は、属性インデックスの作成を選択することをお勧めします。
このツールを使用する前に [テーブル ビューの作成 (Create Table View)] ツールを使用して、処理の対象となるイベントの数を効果的に減らしてください。
入力イベントまたはオーバーレイ イベントのどちらかに ObjectID フィールドがない場合は、このツールを使用する前に [クエリ テーブルの作成 (Make Query Table)] で仮想 ObjectID フィールドを追加してください。
構文
OverlayRouteEvents_lr (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 | オーバーレイ イベント テーブルのルート ロケーション フィールドとイベントの種類で構成されるパラメーター。 ルート識別フィールド: どのルート沿いに各イベントがあるのかを示す値を格納したフィールド。このフィールドには数値または文字を使用できます。 イベント タイプ: オーバーレイ イベント テーブルのイベントのタイプ (POINT または LINE)。
始点メジャー値フィールド: メジャー値を格納したフィールド。このフィールドは数値でなければならず、イベント タイプが POINT または LINE の場合は必須です。イベント タイプが POINT の場合は、このパラメーターのラベルが「メジャー値フィールド」になることに注目してください。 終点メジャー値フィールド: メジャー値を格納したフィールド。このフィールドは数値でなければならず、イベント タイプが LINE の場合は必須です。 | Route Measure Event Properties |
overlay_type | 実施されるオーバーレイのタイプ。
| String |
out_table | 作成されるテーブル。 | Table |
out_event_properties | 出力イベント テーブルに書き出されるルート ロケーション フィールドとイベント タイプで構成されるパラメーター。
| Route Measure Event Properties |
zero_length_events (オプション) | 出力テーブルに長さゼロのライン イベントを保持するかどうかを指定します。このパラメーターは出力イベント タイプが LINE の場合にのみ有効です。
| Boolean |
in_fields (オプション) | 出力イベント テーブルに入力およびオーバーレイ イベント テーブルからのすべてのフィールドを書き出すかどうかを指定します。
| Boolean |
build_index (オプション) | 出力イベント テーブルに書き出されたルート識別フィールドについて属性インデックスを作成するかどうかを指定します。
| Boolean |
コードのサンプル
OverlayRouteEvents (ルート イベントのオーバーレイ) の例 (Python ウィンドウ)
import arcpy
from arcpy import env
env.workspace = "C:/Data"
arcpy.OverlayRouteEvents_lr ("accident.dbf", "rkey POINT mile" , "pavecond.dbf", "rkey LINE fmp tmp", "INTERSECT", \
"accpav", "rkey POINT mile" )
OverlayRouteEvents (ルート イベントのオーバーレイ) の例 (スタンドアロン Python スクリプト)
次の Python スクリプトは、スタンドアロン Python スクリプトでの OverlayRouteEvents (ルート イベントのオーバーレイ) 関数の使用方法を示しています。
# NAme: OverlayRouteEvents_Example.py
# Description: Point-on-line INTERSECT overlay (both tables are dBASE)
# Author: ESRI
# Import system modules
import arcpy
from arcpy import env
# Set workspace
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 (ルート イベントのオーバーレイ) の例 2 (スタンドアロン Python スクリプト)
次の Python スクリプトは、スタンドアロン Python スクリプトでファイル ジオデータベース データにOverlayRouteEvents (ルート イベントのオーバーレイ) 関数を使用する方法を示しています。
# Name OverlayRouteEvents_Example2.py
# Description: Line-on-line UNION overlay (both tables are in a file geodatabase)
# Author: ESRI
# Import system modules
import arcpy
from arcpy import env
# Set workspace
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 (ルート イベントのオーバーレイ) の例 3 (スタンドアロン Python スクリプト)
次の Python スクリプトは、スタンドアロン Python スクリプトでパーソナル ジオデータベース データにOverlayRouteEvents (ルート イベントのオーバーレイ) 関数を使用する方法を示しています。
# Name: OverlayRouteEvents_Example3.py
# Description: Line-on-line UNION overlay (both tables are in a personal geodatabase)
# Author: ESRI
# Import system modules
import arcpy
from arcpy import env
# Set workspace
env.workspace = "C:/Data/Pitt.mdb"
# 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 スクリプトは、スタンドアロン Python スクリプトで SDE データにOverlayRouteEvents (ルート イベントのオーバーレイ) 関数を使用する方法を示しています。
# Name: OverlayRouteEvents_Example4.py
# Description: Point-on-line INTERSECT overlay (both tables are in enterprise geodatabase)
# Import system modules
import arcoy
from arcpy import env
# Set workspace
env.workspace = "Database Connections/Connection to Jerry.sde"
# Set local variables
in_tbl = gp.QualifyTableName("accident", wkspc)
in_props = "rkey POINT mile"
ov_tbl = gp.QualifyTableName("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)
環境
ライセンス情報
- ArcGIS for Desktop Basic: ○
- ArcGIS for Desktop Standard: ○
- ArcGIS for Desktop Advanced: ○