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

ライセンス レベル:BasicStandardAdvanced

サマリ

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

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

使用法

構文

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

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

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

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

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

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

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

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

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

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

  • POINTポイント イベントはポイント フィーチャとして扱われます。これがデフォルトです。
  • MULTIPOINTポイント イベントはマルチポイント フィーチャとして扱われます。
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: ○
5/10/2014