ルート イベント レイヤの作成(Make Route Event Layer) (リニア リファレンス)
サマリ
ルートとルート イベントを使ってテンポラリ フィーチャ レイヤを作成します。
テンポラリ レイヤを使用する場合(マップに表示する場合や、別のジオプロセシング ツールで使用する場合)には、ダイナミック セグメンテーションが実施されます。
使用法
-
ArcGIS が対応している種類のテーブルはどれでも入力テーブルとして使用できます。
-
このツールを使用する前に、ルートについて [フィーチャ レイヤの作成(Make Feature Layer)] を実施するか、イベントについて [テーブル ビューの作成(Create Table View)] を実施するか、またはこの両方を実施して、処理の対象となるルートとイベントの数を減らします。
-
すべての種類のテーブルに ObjectID フィールドがあるわけではありません。この種のテーブルにこのツールを使用して生成したレイヤは選択可能ではないため、特定のジオプロセシング操作で効果的に使用することができません。このツールを使用する前に [クエリ テーブルの作成(Make Query Table)] ツールで仮想 ObjectID フィールドを追加することを検討してください。
-
テンポラリ レイヤはメモリに格納されるので、現在の ArcCatalog または ArcMap セッションで他のジオプロセシング関数への入力として使用できます。
-
ArcMap では、[ジオプロセシング] → [ジオプロセシング オプション] → [ジオプロセシング処理結果をマップに追加] の順に選択してディスプレイへのジオプロセシング操作結果の追加を指定しておけば、テンポラリ フィーチャ レイヤを表示することができます。
-
ArcCatalog または ArcMap を終了すると、テンポラリ フィーチャ レイヤはメモリから削除されます。テンポラリ レイヤをディスクに格納する場合は、[レイヤ ファイルの保存 (Save To Layer File)](管理)または [フィーチャのコピー (Copy Features)](管理) ツールを使用します。
構文
パラメータ | 説明 | データ タイプ |
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」という名称のフィールドを追加するかどうかを指定します。
| Boolean |
add_angle_field (オプション) |
作成するテンポラリ レイヤに「LOC_ANGLE」という名称のフィールドを追加するかどうかを指定します。このパラメータはイベント タイプが POINT の場合にのみ有効です。
| Boolean |
angle_type (オプション) |
計算する配置角度のタイプを指定します。このパラメータは ANGLE_FIELD を指定している場合にのみ有効です。
| String |
complement_angle (オプション) |
配置角度の余角を計算するかどうかを指定します。このパラメータは ANGLE_FIELD を指定している場合にのみ有効です。
| Boolean |
offset_direction (オプション) |
正のオフセットのルート イベントをどちら側に表示するかを指定します。このパラメータはオフセット フィールドを指定している場合にのみ有効です。
| Boolean |
point_event_type (オプション) |
ポイント イベントをポイント フィーチャとして扱うか、マルチポイント フィーチャとして扱うかを指定します。
| Boolean |
コードのサンプル
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")
次の 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")
次の 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")
次の 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")
次の 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)