ルートのキャリブレーション(Calibrate Routes) (リニア リファレンス)

サマリ

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

使用法

構文

CalibrateRoutes_lr (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.
# Author: ESRI
 
# 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.
# Author: ESRI

# 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.
# Author: ESRI

# 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")
except:
    print gp.GetMessages(2)

環境

関連項目

ライセンス情報

ArcView: はい
ArcEditor: はい
ArcInfo: はい

7/10/2012