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

サマリ

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

使用法

構文

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

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

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

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

Table View
overlay_event_properties

オーバーレイ イベント テーブルのルート ロケーション フィールドとイベントの種類で構成されるパラメータ。

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

イベント タイプ: オーバーレイ イベント テーブルのイベントのタイプ(POINT または LINE)。

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

始点メジャー値フィールド: メジャー値を格納したフィールド。このフィールドは数値でなければならず、イベント タイプが POINT または LINE の場合は必須です。イベント タイプが POINT の場合は、このパラメータのラベルが「メジャー値フィールド」になることに注目してください。

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

Route Measure Event Properties
overlay_type

実施されるオーバーレイのタイプ。

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

作成するテーブル。

Table
out_event_properties

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

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

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

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

出力イベント テーブルに入力およびオーバーレイ イベント テーブルからのすべてのフィールドを書き出すかどうかを指定します。

  • FIELDS出力テーブルに入力テーブルからのすべてのフィールドが含められます。これがデフォルトです。
  • NO_FIELDS入力テーブルからのすべてのフィールドが出力テーブルに含まれるわけではありません。ObjectID とルート ロケーション フィールドだけが保持されます。
Boolean
build_index
(オプション)

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

  • INDEX属性インデックスが作成されます。これがデフォルトです。
  • NO_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)

環境

関連項目

ライセンス情報

ArcView: はい
ArcEditor: はい
ArcInfo: はい

7/10/2012