ルート イベント レイヤーの作成 (Make Route Event Layer) (リニア リファレンス)

サマリー

ルートとルート イベントを使ってテンポラリ フィーチャ レイヤーを作成します。

テンポラリ レイヤーを使用する場合は (マップに表示する場合や別のジオプロセシング ツールで使用する場合)、ダイナミック セグメンテーションが行われます。

使用法

  • ArcGIS が対応している種類のテーブルはどれでも入力テーブルとして使用できます。

  • このツールを使用する前に、ルートに対して [フィーチャ レイヤーの作成 (Make Feature Layer)] ツールを実行するか、イベントに対して [テーブル ビューの作成 (Make Table View)] ツールを実行するか、両方のツールを実行して、処理対象となるルートとイベントの数を減らします。

  • すべての種類のテーブルに ObjectID フィールドがあるわけではありません。この種のテーブルにこのツールを使用して生成したレイヤーは選択可能ではないため、特定のジオプロセシング操作で効果的に使用することができません。このツールを使用する前に [クエリ テーブルの作成 (Make Query Table)] ツールで仮想 ObjectID フィールドを追加することを検討してください。

パラメーター

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

イベントを配置する対象となるルート フィーチャ。

Feature Layer
ルート識別フィールド

各ルートを一意に識別する値を格納したフィールド。

Field
入力イベント テーブル

ルート沿いに配置する行が含まれているテーブル。

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

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

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

作成するフォルダー。このレイヤーはメモリに格納されるため、パスは不要です。

Feature Layer
オフセット フィールド
(オプション)

基本となるルートからイベントをオフセットするために使用される値を格納したフィールド。このフィールドの値は数値でなければなりません。

Field
配置エラー フィールドを作成
(オプション)

作成するテンポラリ レイヤーに「LOC_ERROR」という名前のフィールドを追加するかどうかを指定します。

  • オフ: 配置エラーを格納するためのフィールドが追加されません。これがデフォルトです。
  • オン: 配置エラーを格納するためのフィールドが追加されます。
Boolean
角度フィールドの生成
(オプション)

作成するテンポラリ レイヤーに「LOC_ANGLE」という名前のフィールドを追加するかどうかを指定します。このパラメーターはイベント タイプが POINT の場合にのみ有効です。

  • オフ: 配置角度を格納するためのフィールドが追加されません。これがデフォルトです。
  • オン: 配置角度を格納するためのフィールドが追加されます。
Boolean
算出される角度のタイプ
(オプション)

計算する配置角度のタイプを指定します。このパラメーターは、[角度フィールドの生成] がオンの場合のみ有効です。

  • 標準垂直 (直交) 角度が計算されます。これがデフォルトです。
  • 正接正接角度が計算されます。
String
角度フィールドに余角を作成
(オプション)

配置角度の余角を計算するかどうかを指定します。このパラメーターは、[角度フィールドの生成] がオンの場合のみ有効です。

  • オフ: 角度の余角は書き出されません。算出された角度だけが書き出されます。これがデフォルトです。
  • オン: 角度の余角が書き出されます。
Boolean
正の値のオフセットを持つイベントはルートの右側に配置
(オプション)

正のオフセットのルート イベントをどちら側に表示するかを指定します。このパラメーターはオフセット フィールドを指定している場合にのみ有効です。

  • オフ: 正のオフセットのイベントがルートの左側に配置されます。ルートのこちら側はメジャーによって決まり、必ずしもデジタイズされた方向ではありません。これがデフォルトです。
  • オン: 正のオフセットのイベントがルートの右側に配置されます。ルートのこちら側はデジタイズされた方向によって決まります。
Boolean
ポイント イベントをマルチポイント フィーチャとして生成
(オプション)

ポイント イベントをポイント フィーチャとして扱うか、マルチポイント フィーチャとして扱うかを指定します。

  • オフ – ポイント イベントはポイント フィーチャとして扱われます。これがデフォルトです。
  • オン – ポイント イベントはマルチポイント フィーチャとして扱われます。
Boolean

arcpy.lr.MakeRouteEventLayer(in_routes, route_id_field, in_table, in_event_properties, out_layer, {offset_field}, {add_error_field}, {add_angle_field}, {angle_type}, {complement_angle}, {offset_direction}, {point_event_type})
名前説明データ タイプ
in_routes

イベントを配置する対象となるルート フィーチャ。

Feature Layer
route_id_field

各ルートを一意に識別する値を格納したフィールド。

Field
in_table

ルート沿いに配置する行が含まれているテーブル。

Table View
in_event_properties

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

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

作成するフォルダー。このレイヤーはメモリに格納されるため、パスは不要です。

Feature Layer
offset_field
(オプション)

基本となるルートからイベントをオフセットするために使用される値を格納したフィールド。このフィールドの値は数値でなければなりません。

Field
add_error_field
(オプション)

作成するテンポラリ レイヤーに「LOC_ERROR」という名前のフィールドを追加するかどうかを指定します。

  • NO_ERROR_FIELD配置エラーを格納するためのフィールドが追加されません。これがデフォルトです。
  • ERROR_FIELD配置エラーを格納するためのフィールドが追加されます。
Boolean
add_angle_field
(オプション)

作成するテンポラリ レイヤーに「LOC_ANGLE」という名前のフィールドを追加するかどうかを指定します。このパラメーターはイベント タイプが POINT の場合にのみ有効です。

  • NO_ANGLE_FIELD配置角度を格納するためのフィールドが追加されません。これがデフォルトです。
  • ANGLE_FIELD配置角度を格納するためのフィールドが追加されます。
Boolean
angle_type
(オプション)

計算する配置角度のタイプを指定します。このパラメーターは、add_angle_field = "ANGLE_FIELD" である場合にのみ有効です。

  • NORMAL垂直 (直交) 角度が計算されます。これがデフォルトです。
  • TANGENT正接角度が計算されます。
String
complement_angle
(オプション)

配置角度の余角を計算するかどうかを指定します。このパラメーターは、add_angle_field = "ANGLE_FIELD" である場合にのみ有効です。

  • ANGLE角度の余角は書き出されません。算出された角度だけが書き出されます。これがデフォルトです。
  • COMPLEMENT角度の余角が書き出されます。
Boolean
offset_direction
(オプション)

正のオフセットのルート イベントをどちら側に表示するかを指定します。このパラメーターはオフセット フィールドを指定している場合にのみ有効です。

  • LEFT正のオフセットのイベントがルートの左側に配置されます。ルートのこちら側はメジャーによって決まり、必ずしもデジタイズされた方向ではありません。これがデフォルトです。
  • RIGHT正のオフセットのイベントがルートの右側に配置されます。ルートのこちら側はデジタイズされた方向によって決まります。
Boolean
point_event_type
(オプション)

ポイント イベントをポイント フィーチャとして扱うか、マルチポイント フィーチャとして扱うかを指定します。

  • POINTポイント イベントはポイント フィーチャとして扱われます。これがデフォルトです。
  • MULTIPOINTポイント イベントはマルチポイント フィーチャとして扱われます。
Boolean

コードのサンプル

MakeRouteEventLayer (ルート イベント レイヤーの作成) の例 1 (Python ウィンドウ)
import arcpy
arcpy.env.workspace = "C:/Data"
arcpy.MakeRouteEventLayer_lr("route_hwy.shp", "rkey", "accident.dbf", 
                             "rkey POINT mile", "accident_events", "#", 
                             "ERROR_FIELD", "ANGLE_FIELD")
MakeRouteEventLayer (ルート イベント レイヤーの作成) の例 2 (スタンドアロン スクリプト)

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

# Name: MakeRouteEventLayer_Example2.py
# Description:  Make a POINT event layer. Routes and events are in a shapefile workspace.
# An error field and an angle field are added to the new layer. The new layer can be used
# by other geoprocessing functions.
# Import system modules
import arcpy
# Set workspace
arcpy.env.workspace = "C:/Data"
# Set local variables
rt = "route_hwy.shp"
rid = "rkey" 
tbl = "accident.dbf"
props = "rkey POINT mile"
lyr = "accident_events" 
# Execute MakeRouteEventLayer
arcpy.MakeRouteEventLayer_lr(rt, rid, tbl, props, lyr, "#", "ERROR_FIELD", 
                             "ANGLE_FIELD")
MakeRouteEventLayer (ルート イベント レイヤーの作成) の例 3 (スタンドアロン スクリプト)

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

# Name: MakeRouteEventLayer_Example3.py
# Description:  Make a LINE event layer. Routes and events are in a file geodatabase.
# An error field is added to the new layer. The new layer can be used by other 
# geoprocessing functions.
# Import system modules 
import arcpy
# Set workspace
arcpy.env.workspace = "C:/Data/pitt.gdb"
# Set local variables
rt = "roads/hwy"  # the 'hwy' feature class is in the 'roads' feature dataset
rid = "rkey" 
tbl = "pavecond"
props = "rkey LINE fmp tmp"
lyr = "pave_events" 
# Execute MakeRouteEventLayer
arcpy.MakeRouteEventLayer_lr(rt, rid, tbl, props, lyr, "#", "ERROR_FIELD")
MakeRouteEventLayer (ルート イベント レイヤーの作成) の例 4 (スタンドアロン スクリプト)

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

# Name: MakeRouteEventLayer_Example4.py
# Description: Make a POINT event layer. Routes and events are in an enterprise geodatabase.
# The new layer can be used by other geoprocessing functions.
# Import system modules 
import arcpy
# Set workspace
arcpy.env.workspace = "C:/MyProject/myConn.sde"
# Set local variables
ds = arcpy.ValidateTableName("roads", wkspc)  # the 'roads' feature dataset
fc = arcpy.ValidateTableName("hwy", wkspc)  # the 'hwy' feature class 
rt = ds + "/" + fc  # the 'hwy' feature class is in the 'roads' feature dataset
rid = "rkey" 
tbl = "accident"
props = "rkey POINT mile"
lyr = "accident_events2" 
# Execute MakeRouteEventLayer
arcpy.MakeRouteEventLayer_lr(rt, rid, tbl, props, lyr)

ライセンス情報

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

関連トピック