サマリ
ルートとルート イベントを使ってテンポラリ フィーチャ レイヤーを作成します。
テンポラリ レイヤーを使用する場合 (マップに表示する場合や、別のジオプロセシング ツールで使用する場合) には、ダイナミック セグメンテーションが実施されます。
使用法
ArcGIS が対応している種類のテーブルはどれでも入力テーブルとして使用できます。
このツールを使用する前に、ルートについて [フィーチャ レイヤーの作成 (Make Feature Layer)] を実施するか、イベントについて [テーブル ビューの作成 (Create Table View)] を実施するか、またはこの両方を実施して、処理の対象となるルートとイベントの数を減らします。
すべての種類のテーブルに ObjectID フィールドがあるわけではありません。この種のテーブルにこのツールを使用して生成したレイヤーは選択可能ではないため、特定のジオプロセシング操作で効果的に使用することができません。このツールを使用する前に [クエリ テーブルの作成 (Make Query Table)] ツールで仮想 ObjectID フィールドを追加することを検討してください。
テンポラリ レイヤーはメモリに格納されるので、現在の ArcCatalog または ArcMap セッションで他のジオプロセシング関数への入力として使用できます。
ArcMap では、[ジオプロセシング] > [ジオプロセシング オプション] > [ジオプロセシング処理結果をマップに追加] の順に選択してディスプレイへのジオプロセシング操作結果の追加を指定しておけば、テンポラリ フィーチャ レイヤーを表示することができます。
ArcCatalog または ArcMap を終了すると、テンポラリ フィーチャ レイヤーはメモリから削除されます。テンポラリ レイヤーをディスクに格納する場合は、[レイヤー ファイルの保存 (Save To Layer File)] (管理)または [フィーチャのコピー (Copy Features)] (管理) ツールを使用します。
構文
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})| パラメータ | 説明 | データ タイプ |
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 (ルート イベント レイヤーの作成) の例 (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)
環境
ライセンス情報
- ArcGIS for Desktop Basic: ○
- ArcGIS for Desktop Standard: ○
- ArcGIS for Desktop Advanced: ○