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