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

Summary

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

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

Usage

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

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

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

• テンポラリ レイヤはメモリに格納されるので、現在の ArcCatalog または ArcMap セッションで他のジオプロセシング関数への入力として使用できます。

• ArcMap では、[ジオプロセシング] > [ジオプロセシング オプション] > [ジオプロセシング処理結果をマップに追加] の順に選択してディスプレイへのジオプロセシング操作結果の追加を指定しておけば、テンポラリ フィーチャ レイヤを表示することができます。

• ArcCatalog または ArcMap を終了すると、テンポラリ フィーチャ レイヤはメモリから削除されます。テンポラリ レイヤをディスクに格納する場合は、[レイヤ ファイルの保存 (Save To Layer File)]（管理）または [フィーチャのコピー (Copy Features)]（管理） ツールを使用します。

Syntax

MakeRouteEventLayer_lr (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})

Parameter	Explanation	Data Type
in_routes	イベントを配置する対象となるルート フィーチャ。	Feature Layer
route_id_field	各ルートを一意に識別する値を格納したフィールド。	Field
in_table	ルート沿いに配置する行が含まれているテーブル。	Table View
in_event_properties	入力イベント テーブルのルート ロケーション フィールドとイベント タイプで構成されるパラメータ。 ルート識別フィールド: どのルート沿いに各イベントがあるのかを示す値を格納したフィールド。このフィールドには数値または文字を使用できます。 イベント タイプ: 入力イベント テーブルのイベントのタイプ（POINT または LINE）。 POINT: ポイント イベントは、ルート沿いの正確な位置で発生します。始点メジャーだけを指定する必要があります。 LINE: ライン イベントでは、ルートの一部分を定義します。始点メジャーと終点メジャーの両方のフィールドを指定する必要があります。 始点メジャー値フィールド: メジャー値を格納したフィールド。このフィールドは数値でなければならず、イベント タイプが POINT または LINE の場合は必須です。イベント タイプが POINT の場合は、このパラメータのラベルが [メジャー値フィールド] になることに注意してください。 終点メジャー値フィールド: メジャー値を格納したフィールド。このフィールドは数値でなければならず、イベント タイプが LINE の場合は必須です。	Route Measure Event Properties
out_layer	作成するフォルダ。このレイヤはメモリに格納されるため、パスは不要です。	Feature Layer
offset_field (Optional)	基本となるルートからイベントをオフセットするために使用される値を格納したフィールド。このフィールドの値は数値でなければなりません。	Field
add_error_field (Optional)	作成するテンポラリ レイヤに「LOC_ERROR」という名称のフィールドを追加するかどうかを指定します。 NO_ERROR_FIELD —配置エラーを格納するためのフィールドが追加されません。これがデフォルトです。 ERROR_FIELD —配置エラーを格納するためのフィールドが追加されます。	Boolean
add_angle_field (Optional)	作成するテンポラリ レイヤに「LOC_ANGLE」という名称のフィールドを追加するかどうかを指定します。このパラメータはイベント タイプが POINT の場合にのみ有効です。 NO_ANGLE_FIELD —配置角度を格納するためのフィールドが追加されません。これがデフォルトです。 ANGLE_FIELD —配置角度を格納するためのフィールドが追加されます。	Boolean
angle_type (Optional)	計算する配置角度のタイプを指定します。このパラメータは ANGLE_FIELD を指定している場合にのみ有効です。 NORMAL —垂直（直交）角度が計算されます。これがデフォルトです。 TANGENT —正接角度が計算されます。	String
complement_angle (Optional)	配置角度の余角を計算するかどうかを指定します。このパラメータは ANGLE_FIELD を指定している場合にのみ有効です。 ANGLE —角度の余角は書き出されません。算出された角度だけが書き出されます。これがデフォルトです。 COMPLEMENT —角度の余角が書き出されます。	Boolean
offset_direction (Optional)	正のオフセットのルート イベントをどちら側に表示するかを指定します。このパラメータはオフセット フィールドを指定している場合にのみ有効です。 LEFT —正のオフセットのイベントがルートの左側に配置されます。ルートのこちら側はメジャーによって決まり、必ずしもデジタイズされた方向ではありません。これがデフォルトです。 RIGHT —正のオフセットのイベントがルートの右側に配置されます。ルートのこちら側はデジタイズされた方向によって決まります。	Boolean
point_event_type (Optional)	ポイント イベントをポイント フィーチャとして扱うか、マルチポイント フィーチャとして扱うかを指定します。 POINT —ポイント イベントはポイント フィーチャとして扱われます。これがデフォルトです。 MULTIPOINT —ポイント イベントはマルチポイント フィーチャとして扱われます。	Boolean

Code Sample

MakeRouteEventLayer（ルート イベント レイヤの作成）の例（Python ウィンドウ）

import arcpy
from arcpy import env

env.workspace = "C:/Data"
arcpy.MakeRouteEventLayer_lr ("route_hwy.shp", "rkey" , "accident.dbf", "rkey POINT mile", "accident_events", "#", "ERROR_FIELD", "ANGLE_FIELD")

MakeRouteEventLayer（ルート イベント レイヤの作成）の例（スタンドアロン Python スクリプト）

次の Python スクリプトは、スタンドアロン Python スクリプトでの MakeRouteEventLayer（ルート イベント レイヤの作成）関数の使用方法を示しています。

# Name: MakeRouteEventLayer_Example.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.
# Author: ESRI

# Import system modules
import arcpy
from arcpy import env

# Set workspace
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（ルート イベント レイヤの作成）の例 2（スタンドアロン Python スクリプト）

次の Python スクリプトは、スタンドアロン Python スクリプトでの MakeRouteEventLayer（ルート イベント レイヤの作成）関数の使用方法を示しています。

# Name: MakeRouteEventLayer_Example2.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.
# Author: ESRI

# Import system modules 
import arcpy
from arcpy import env

# Set workspace
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（ルート イベント レイヤの作成）の例 3（スタンドアロン Python スクリプト）

次の Python スクリプトは、スタンドアロン Python スクリプトでパーソナル ジオデータベース データにMakeRouteEventLayer（ルート イベント レイヤの作成）関数を使用する方法を示しています。

# Name: MakeRouteEventLayer_Example3.py
# Description: Make a LINE event layer. Routes and events are in a personal geodatabase.
# An error field is added to the new layer. The new layer can be used by other 
# geoprocessing functions.
# Author: ESRI

# Import system modules
import arcpy
from arcpy import env

# Set workspace
env.workspace = "C:/Data/pitt.mdb"

# 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 スクリプトは、スタンドアロン Python スクリプトで SDE データに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
from arcpy import env

# Set workspace
env.workspace = "Database Connections/Connection to Jerry.sde" 

# Set local variables
ds = gp.QualifyTableName("roads", wkspc)          # the 'roads' feature dataset
fc = gp.QualifyTableName("hwy", wkspc)            # the 'hwy' feature class 
rt = ds + "/" + fc #the 'hwy' feature class is in the 'roads' feature dataset
rid = "rkey" 
tbl = gp.QualifyTableName("accident", wkspc)
props = "rkey POINT mile"
lyr = "accident_events2" 

# Execute MakeRouteEventLayer
arcpy.MakeRouteEventLayer_lr (rt, rid, tbl, props, lyr)

Environments

現在のワークスペース, 出力データのコンフィグレーション キーワード, テンポラリ ワークスペース

Licensing Information

ArcGIS for Desktop Basic: Yes

ArcGIS for Desktop Standard: Yes

ArcGIS for Desktop Advanced: Yes