サマリー
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 | オーバーレイ イベント テーブルのルート ロケーション フィールドとイベントの種類で構成されるパラメーター。 ルート識別フィールド: どのルート沿いに各イベントがあるのかを示す値を格納したフィールド。このフィールドには数値または文字を使用できます。 イベント タイプ: オーバーレイ イベント テーブルのイベントのタイプ ([ポイント] または [ライン])。
始点メジャー値フィールド: メジャー値を格納したフィールド。このフィールドは数値でなければならず、イベント タイプが ポイント または ライン の場合は必須です。イベント タイプが [ポイント] の場合は、このパラメーターのラベルが「メジャー値フィールド」になることに注目してください。 終点メジャー値フィールド: メジャー値を格納したフィールド。このフィールドは数値でなければならず、イベント タイプが [ライン] の場合は必須です。 | 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 Desktop Basic: はい
- ArcGIS Desktop Standard: はい
- ArcGIS Desktop Advanced: はい