ルートのキャリブレーション (Calibrate Routes)—ヘルプ

概要
使用法
構文
コードのサンプル
環境
ライセンス情報

概要

ポイントを使ってルートメジャー値を再計算します。

使用法

ルート全体またはルートの一部をキャリブレーションできます。入力ポイント間を内挿するか、入力ポイントの前後を外挿するか、またはこれらの方法を組み合わせて使用するかを選択できます。
[フィーチャレイヤーの作成 (Make Feature Layer)] または [クエリテーブルの作成 (Make Query Table)] を使用すると、キャリブレーションの対象となるルートを効果的に削減できます。
[出力ルートフィーチャクラス] がジオデータベースに書き出されている場合は、適切な M 許容値、M 座標精度、および M ドメイン環境を設定する必要があります。
[出力ルートフィーチャクラス] には、[入力ルートフィーチャ] のすべてのフィールドが含まれます。
outputMFlag 環境の設定は無視されます。[出力ルートフィーチャクラス] には、M (メジャー) 値があります。
検索範囲を無限にすることはできません。
ルート識別フィールドに属性フィールドを使用すると、ダイナミックセグメンテーション処理を高速化できます。ダイナミックセグメンテーションに出力ルートフィーチャクラスを使用する場合は、属性インデックスの作成を選択することをお勧めします。
ルートのキャリブレーション処理で拒否されたフィーチャがあると、一時ファイルパスにテキストファイルが作成されてそれらのフィーチャに関する情報が格納されます。たとえば、C:\Documents and Settings\patrickb\Local Settings\Temp\Calibrate_Output0.txt のようなパスになります (Calibrate_Output は [出力ルートフィーチャクラス] の名前です)。

構文

CalibrateRoutes(in_route_features, route_id_field, in_point_features, point_id_field, measure_field, out_feature_class, {calibrate_method}, {search_radius}, {interpolate_between}, {extrapolate_before}, {extrapolate_after}, {ignore_gaps}, {keep_all_routes}, {build_index})

パラメーター	説明	データタイプ
in_route_features	キャリブレーションの対象となるルートフィーチャ。	Feature Layer
route_id_field	各ルートを一意に識別する値を格納したフィールド。このフィールドには数値または文字を使用できます。	Field
in_point_features	ルートのキャリブレーションに使用するポイントフィーチャ。	Feature Layer
point_id_field	各キャリブレーションポイントのあるルートを識別するフィールド。このフィールドの値はルート識別フィールドの値に一致します。このフィールドには数値または文字を使用できます。	Field
measure_field	各キャリブレーションポイントのメジャー値を格納したフィールド。このフィールドの値は数値でなければなりません。	Field
out_feature_class	作成されるフィーチャクラス。シェープファイルかジオデータベースフィーチャクラスを指定できます。	Feature Class
calibrate_method (オプション)	ルートメジャー値の再計算方法を指定します。 DISTANCE —キャリブレーションポイント間の最短パスの距離を使用してメジャー値が再計算されます。これがデフォルトです。 MEASURES —キャリブレーションポイント間の既存のメジャー距離を使用してメジャー値が再計算されます。	String
search_radius (オプション)	距離とメジャー値の単位を指定して、キャリブレーションポイントのルートからの最大距離を設定します。メジャー値の単位が不明である場合は、ルートフィーチャクラスの座標系と同じ単位が使用されます。	Linear unit
interpolate_between (オプション)	メジャー値をキャリブレーションポイント間に内挿するかどうかを指定します。 BETWEEN —キャリブレーションポイント間を内挿します。これがデフォルトです。 NO_BETWEEN —キャリブレーションポイント間に内挿しません。	Boolean
extrapolate_before (オプション)	メジャー値をキャリブレーションポイントの前に外挿するかどうかを指定します。 BEFORE —キャリブレーションポイントの前に外挿します。これがデフォルトです。 NO_BEFORE —キャリブレーションポイントの前に外挿しません。	Boolean
extrapolate_after (オプション)	メジャー値をキャリブレーションポイントの後ろに外挿するかどうかを指定します。 AFTER —キャリブレーションポイントの後ろに外挿します。これがデフォルトです。 NO_AFTER —キャリブレーションポイントの後ろに外挿しません。	Boolean
ignore_gaps (オプション)	分断されたルート上のメジャー値を再計算するときに、空間的ギャップを無視するかどうかを指定します。 IGNORE —空間的ギャップが無視されます。分断されたルートのメジャー値が連続的になります。これがデフォルトです。 NO_IGNORE —空間的ギャップが無視されません。分断されたルートのメジャー値にギャップが生じます。分断した各パートの端点間の直線距離を使用してギャップの距離が計算されます。	Boolean
keep_all_routes (オプション)	キャリブレーションポイントのないルートフィーチャを出力フィーチャクラスから除外するかどうかを指定します。 KEEP —出力フィーチャクラスのすべてのルートフィーチャが保持されます。これがデフォルトです。 NO_KEEP —出力フィーチャクラスのすべてのルートフィーチャが保持されません。キャリブレーションポイントのないフィーチャは除外されます。	Boolean
build_index (オプション)	出力ルートフィーチャクラスに書き出されたルート識別フィールドについて属性インデックスを作成するかどうかを指定します。 INDEX —属性インデックスが作成されます。これがデフォルトです。 NO_INDEX —属性インデックスが作成されません。	Boolean

コードのサンプル

CalibrateRoutes (ルートのキャリブレーション) の例 (Python ウィンドウ)

次の Python ウィンドウスクリプトは、イミディエイトモードでの CalibrateRoutes (ルートのキャリブレーション) 関数の使用方法を示しています。

import arcpy
from arcpy import env

env.workspace = "C:/data"
arcpy.CalibrateRoutes_lr("hwy.shp", "RID", "cal_pts.shp", "RID", "MEASURE", "C:/output/hwy_new.shp","DISTANCE", \
 "5.0 Feet", "BETWEEN", "BEFORE", "AFTER", "#", "NO_KEEP")

CalibrateRoutes (ルートのキャリブレーション) の例 2 (スタンドアロン Python スクリプト)

次の Python スクリプトは、スタンドアロンスクリプトでファイルジオデータベースのデータに CalibrateRoutes (ルートのキャリブレーション) 関数を使用する方法を示しています。

# Name CalibrateRoutes_Example2.py
# Description: Calibrate personal geodatabase routes with file geodatabase points.
 
# Import system modules
import arcpy
from arcpy import env

# Set workspace
env.workspace = "C:/Data/Pitt.gdb"

# Set local variables
rts = "roads/hwy"         # hwy is in the roads feature dataset
rid = "ROUTE1" 
pts = "roads/cal_pts"     # cal_pts is in the roads feature dataset
mfield = "MEASURE"
radius = "2.5 Meters"
out_fc = "roads/hwy_new"  # new feature class in the roads feature dataset

# Execute CalibrateRoutes
arcpy.CalibrateRoutes_lr (rts, rid, pts, rid, mfield, out_fc, "DISTANCE", radius, \
                           "BETWEEN", "NO_BEFORE", "NO_AFTER")

CalibrateRoutes (ルートのキャリブレーション) の例 3 (スタンドアロン Python スクリプト)

次の Python スクリプトは、スタンドアロン Python スクリプトでパーソナルジオデータベースのデータに CalibrateRoutes (ルートのキャリブレーション) 関数を使用する方法を示しています。

# Name CalibrateRoutes_Example3.py
# Description: Calibrate personal geodatabase routes with personal geodatabase points.

# Import system modules
import arcpy
from arcpy import env

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

# Set local variables
rts = "roads/hwy"         # hwy is in the roads feature dataset
rid = "ROUTE1" 
pts = "roads/cal_pts"     # cal_pts is in the roads feature dataset
mfield = "MEASURE"
radius = "2.5 Meters"
out_fc = "roads/hwy_new"  # new feature class in a feature dataset

# Execute CalibrateRoutes
arcpy.CalibrateRoutes_lr (rts, rid, pts, rid, mfield, out_fc, "DISTANCE", radius, \
                           "BETWEEN", "NO_BEFORE", "NO_AFTER")

CalibrateRoutes (ルートのキャリブレーション) の例 4 (スタンドアロン Python スクリプト)

次の Python スクリプトは、スタンドアロン Python スクリプトで SDE データに CalibrateRoutes (ルートのキャリブレーション) 関数を使用する方法を示しています。

# Name Example 4:
# Description: Calibrate enterprise geodatabase routes using enterprise geodatabase points.

# Import system modules
import arcpy
from arcpy import env

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

# Set local variables
rts = gp.QualifyTableName("hwy", wkspc)      # standalone feature class
rid = "ROUTE1"
pts = gp.QualifyTableName("cal_pts", wkspc)  # standalone feature class
mfield = "MEASURE"
radius = "5.0 Feet"
out_fc = "hwy_new"                           #new standalone feature class 

# Execute CalibrateRoutes
arcpy.CalibrateRoutes_lr (rts, rid, pts, rid, mfield, out_fc, "DISTANCE", radius, \
                           "#", "#", "#", "#", "NO_KEEP")

環境

ライセンス情報

Basic: はい
Standard: はい
Advanced: はい

ArcMap

ルートのキャリブレーション (Calibrate Routes)

概要

使用法

構文