キャリブレーションポイントの生成 (Generate Calibration Points) (Location Referencing ツール)

サマリー

自己閉鎖型ルート、自己交差型ルート、ブランチルートのような複雑な形状を含む、指定した任意のルート形状のキャリブレーションポイントを生成します。

使用法

このツールを実行するには、LRS データセットが必要です。
- ArcGIS Pipeline Referencing の LRS データセットの作成の詳細
- ArcGIS Roads and Highways の LRS データセットの作成の詳細
入力ポリラインフィーチャ パラメーター値は、生成されるキャリブレーションポイントの基準になります。
キャリブレーションポイントフィーチャクラス パラメーター値は LRS に登録する必要があります。
LRS ネットワーク パラメーター値は LRS に登録されている必要があります。
派生 LRS ネットワークは、LRS ネットワーク パラメーター値としてサポートされていません。
中心線のジオメトリーの長さを計算する際は、Z 値が考慮されます。
キャリブレーション方法 パラメーターの ジオメトリーの長さ および 属性フィールド オプションを使用してキャリブレーションポイントを生成する際は、ギャップキャリブレーションルールが適用されます。

ArcGIS Roads and Highways での物理的なギャップによるルートのキャリブレーションまたは ArcGIS Pipeline Referencing での物理的なギャップによるルートのキャリブレーションの詳細
キャリブレーション方法 パラメーターが ルート上の M に設定されている場合、入力ルートの開始頂点と終了頂点の M 値を使用して、キャリブレーションポイントの始点と終点が作成されます。
キャリブレーション方法 パラメーターが 属性フィールド に設定されている場合、以下が実行されます:
- 属性フィールド オプションを使用して、Double フィールドタイプのフィールドをキャリブレーション用に評価します。
- 始点メジャーフィールド パラメーター値を使用してルートの始点メジャーを指定し、終点メジャーフィールド パラメーター値を使用してルートの終点メジャーを指定します。
入力ポリラインフィーチャ パラメーター値には、リニアリファレンス機能を持たないフィーチャサービスレイヤーを指定できます。 キャリブレーションポイントフィーチャクラス パラメーター値がフィーチャサービスレイヤーである場合、リニアリファレンス機能が有効である必要があります。

ラベル	説明	データタイプ
入力ポリラインフィーチャ	キャリブレーションポイントのメジャー値を計算するためのソースとして使用されるフィーチャ。	Feature Layer
ルート ID フィールド	各ルートを一意に識別する値を格納したフィールド。このフィールドは、キャリブレーションポイントフィーチャクラス内の `Route ID` フィールドのタイプと同じでなければなりません。	Field
開始日フィールド	ルートの開始日値を含むフィールド。	Field
終了日フィールド	ルートの終了日値を含むフィールド。	Field
キャリブレーションポイントフィーチャクラス	新しいフィーチャが追加される、既存のキャリブレーションポイントフィーチャクラス。	Feature Layer
LRS ネットワーク	キャリブレーションポイントフィーチャクラスでメジャー値が生成される LRS ネットワーク。	String
キャリブレーション方向 (オプション)	キャリブレーションポイントを作成する際に、ルート上のキャリブレーションが増加する方向を指定します。デジタイズ方向—個々のポリラインフィーチャの方向によって、ルートのキャリブレーションの方向が決まります。これがデフォルトです。メジャー方向—個々のポリラインフィーチャの M 値が増加する方向によって、ルートのキャリブレーションの方向が決まります。個々のポリラインフィーチャに M 値が含まれていない場合は、デジタイズ方向が使用されます。	String
キャリブレーション方法 (オプション)	キャリブレーションポイントを作成する際に、ルート上のメジャーの決定に使用される方法を指定します。ジオメトリーの長さ—入力ルートフィーチャの幾何学的長さがキャリブレーション方法として使用されます。これがデフォルトです。ルート上の M—入力ルートフィーチャのメジャー値がキャリブレーション方法として使用されます。属性フィールド—入力ルートフィーチャの属性フィールドに格納されたメジャー値がキャリブレーション方法として使用されます。	String
始点メジャーフィールド (オプション)	選択したルートの始点メジャーを含むフィールド。このパラメーターは、キャリブレーション方法パラメーターが属性フィールドに設定されている場合に有効です。	Field
終点メジャーフィールド (オプション)	選択したルートの終点メジャーを含むフィールド。このパラメーターは、キャリブレーション方法パラメーターが属性フィールドに設定されている場合に有効です。	Field

派生した出力

ラベル	説明	データタイプ
更新キャリブレーションポイントフィーチャクラス	更新されたキャリブレーションフィーチャ。	Feature Layer
出力詳細ファイル	このツールで変更された内容が詳しく記述されたテキストファイル。	Text File

arcpy.locref.GenerateCalibrationPoints(in_polyline_features, route_id_field, from_date_field, to_date_field, in_calibration_point_feature_class, lrs_network, {calibration_direction}, {calibration_method}, {from_measure_field}, {to_measure_field})

名前	説明	データタイプ
in_polyline_features	キャリブレーションポイントのメジャー値を計算するためのソースとして使用されるフィーチャ。	Feature Layer
route_id_field	各ルートを一意に識別する値を格納したフィールド。このフィールドは、キャリブレーションポイントフィーチャクラス内の `Route ID` フィールドのタイプと同じでなければなりません。	Field
from_date_field	ルートの開始日値を含むフィールド。	Field
to_date_field	ルートの終了日値を含むフィールド。	Field
in_calibration_point_feature_class	新しいフィーチャが追加される、既存のキャリブレーションポイントフィーチャクラス。	Feature Layer
lrs_network	キャリブレーションポイントフィーチャクラスでメジャー値が生成される LRS ネットワーク。	String
calibration_direction (オプション)	キャリブレーションポイントを作成する際に、ルート上のキャリブレーションが増加する方向を指定します。 `DIGITIZED_DIRECTION`—個々のポリラインフィーチャの方向によって、ルートのキャリブレーションの方向が決まります。これがデフォルトです。 `MEASURE_DIRECTION`—個々のポリラインフィーチャの M 値が増加する方向によって、ルートのキャリブレーションの方向が決まります。個々のポリラインフィーチャに M 値が含まれていない場合は、デジタイズ方向が使用されます。	String
calibration_method (オプション)	キャリブレーションポイントを作成する際に、ルート上のメジャーの決定に使用される方法を指定します。 `GEOMETRY_LENGTH`—入力ルートフィーチャの幾何学的長さがキャリブレーション方法として使用されます。これがデフォルトです。 `M_ON_ROUTE`—入力ルートフィーチャのメジャー値がキャリブレーション方法として使用されます。 `ATTRIBUTE_FIELDS`—入力ルートフィーチャの属性フィールドに格納されたメジャー値がキャリブレーション方法として使用されます。	String
from_measure_field (オプション)	選択したルートの始点メジャーを含むフィールド。このパラメーターは、`calibration_method` パラメーターが `ATTRIBUTE_FIELDS` に設定されている場合に有効になります。	Field
to_measure_field (オプション)	選択したルートの終点メジャーを含むフィールド。このパラメーターは、`calibration_method` パラメーターが `ATTRIBUTE_FIELDS` に設定されている場合に有効になります。	Field

派生した出力

名前	説明	データタイプ
out_calibration_point_feature_class	更新されたキャリブレーションフィーチャ。	Feature Layer
out_details_file	このツールで変更された内容が詳しく記述されたテキストファイル。	Text File

コードのサンプル

GenerateCalibrationPoints の例 1 (Python ウィンドウ)

次の Python ウィンドウスクリプトは、GenerateCalibrationPoints 関数を使用する方法を示しています。

# Name: GenerateCalibrationPoints_ex1.py
# Description: Build calibration point features when an LRS already exists in the geodatabase in Python window.
# Requires: ArcGIS Location Referencing

# Set current workspace
arcpy.env.workspace = r"C:\Data\UPDM.gdb"

# Generate Calibration Points tool variables:
in_polyline_features = "SourceRoutes"
route_id_field = "RouteID"
from_date_field = "FromDate"
to_date_field = "ToDate"
in_calibration_point_feature_class = "Calibration_Point"
lrs_network = "NonLineNetwork"
calibration_direction = "MEASURE_DIRECTION"
calibration_method = "GEOMETRY_LENGTH"

# Run Generate Calibration Points
arcpy.locref.GenerateCalibrationPoints(in_polyline_features, route_id_field, from_date_field, to_date_field, in_calibration_point_feature_class, lrs_network, calibration_direction, calibration_method)

GenerateCalibrationPoints の例 2 (スタンドアロンスクリプト)

次のスタンドアロンスクリプトで、GenerateCalibrationPoints 関数を使用する方法を示します。

# Name: GenerateCalibrationPoints_ex2.py
# Description: Build calibration point features when an LRS already exists in the geodatabase in a stand-alone script.
# Requires: ArcGIS Location Referencing

# Import arcpy module
import arcpy

# Generate Calibration Points tool variables:
in_polyline_features = r"C:\Data\SourceData.gdb\LRS\SourceRoutes"
route_id_field = "RouteID"
from_date_field = "FromDate"
to_date_field = "ToDate"
in_calibration_point_feature_class = r"C:\\Data\UPDM.gdb\LRS\Calibration_Point"
lrs_network = "EngineeringNetwork"
calibration_direction = "MEASURE_DIRECTION"
calibration_method = "GEOMETRY_LENGTH"

# Process: Generate Calibration Points
arcpy.locref.GenerateCalibrationPoints(in_polyline_features, route_id_field, from_date_field, to_date_field, in_calibration_point_feature_class, lrs_network, calibration_direction, calibration_method)

GenerateCalibrationPoints の例 3 (スタンドアロンスクリプト)

次のスタンドアロンスクリプトは、既存のフィーチャサービスにキャリブレーションポイントを作成するために GenerateCalibrationPoints 関数を使用する方法を示しています。

# Name: GenerateCalibrationPoints_ex3.py
# Description: Build calibration point features in an existing feature service in a stand-alone script.
# Requires: ArcGIS Location Referencing

# Import arcpy module
import arcpy

# Input LRS route network and calibration point feature class are in feature service.  Signing into portal is required to access the feature service.
arcpy.SignInToPortal('https://yourdomain.com/portal', 'username', 'password')

# Generate Calibration Points tool variables:
in_polyline_features = r"C:\Data\SourceData.gdb\LRS\SourceRoutes"
route_id_field = "RouteID"
from_date_field = "FromDate"
to_date_field = "ToDate"
calibration_direction = "MEASURE_DIRECTION"
calibration_method = "GEOMETRY_LENGTH"

# Map the LRS Network and Calibration Point feature class from the feature service. Here, 5 corresponds to the LRS Network and 1 corresponds to the Calibration Point feature class.
lrs_network = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/5"
in_calibration_point_feature_class = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/1"

# Process: Generate Calibration Points
arcpy.locref.GenerateCalibrationPoints(in_polyline_features, route_id_field, from_date_field, to_date_field, in_calibration_point_feature_class, lrs_network, calibration_direction, calibration_method)

環境

現在のワークスペース, 並列処理ファクター

特殊なケース

並列処理ファクター: The default value for this environment, if left blank, is 0%. Any absolute value for the environment is always clamped between 0 and the number of logical cores in that machine.

ライセンス情報

Basic: ArcGIS Location Referencing (ArcGIS Pipeline Referencing または ArcGIS Roads and Highways) が必要
Standard: ArcGIS Location Referencing (ArcGIS Pipeline Referencing または ArcGIS Roads and Highways) が必要
Advanced: ArcGIS Location Referencing (ArcGIS Pipeline Referencing または ArcGIS Roads and Highways) が必要

キャリブレーション ポイントの生成 (Generate Calibration Points) (Location Referencing ツール)

サマリー

使用法

パラメーター

派生した出力

環境

特殊なケース

ライセンス情報

関連トピック

キャリブレーションポイントの生成 (Generate Calibration Points) (Location Referencing ツール)