LRS ネットワークのネットワーク キャリブレーション ルールを変更します。
LRS ネットワークを作成する際、ルートの作成または編集時にギャップを含むルートをキャリブレーションする方法を選択できます。 このツールを使用すると、LRS ネットワークを作成した後、およびデータ読み込み処理中に、ネットワークのキャリブレーション ルールを構成できます。
ArcGIS Pipeline Referencing での LRS ネットワークの作成と変更または ArcGIS Roads and Highways での LRS ネットワークの作成と変更の詳細をご参照ください。
物理的なギャップを含むルートをキャリブレーションするには、次のいずれかの方法を使用できます。
いずれの方法も、LRS 編集ツールを使用して作成された物理的なギャップを含むルートに対して、異なるキャリブレーション値を生成します。 次の例では、各キャリブレーション方法に対して、物理的ギャップを含む中心線から作成したルートのキャリブレーションと、各キャリブレーション方法に対して、メジャー 0.5 ～ 1 の廃止を含むルートのキャリブレーションを示します。
廃止ルートのシナリオでは、物理的ギャップはメジャー 0.5 ～ 1 の間で作成されます。 キャリブレーション ルールは、編集作業によって物理的ギャップが発生し、既存のギャップに影響しない場合にのみ適用されます。 この例では、メジャー 2 ～ 2.5 の間のギャップは、廃止による影響を受けません。
次のテーブルに、このツールを使用してルールを設定した後に、[ルートの作成] ウィンドウと [ルートの廃止] ウィンドウを使用して、ギャップ キャリブレーションを行った結果を示します。
| ルートの作成 | キャリブレーション例 | 説明 |
|---|---|---|
増分値のステッピング (0.1) |  | 各物理的ギャップの後の最初のメジャーに、メジャー値 0.1 が追加されます。 |
増分値の追加 (0.1) |  | 各物理的ギャップの後の各メジャーに、メジャー値 0.1 が追加されます。 |
ユークリッド距離 (Euclidean Distance) |  | 各物理的ギャップの後の最初のメジャーに、物理的ギャップの直線距離に等しいメジャー値が追加されます。 |
 | ||
| ルートの廃止 | キャリブレーション例 | 説明 |
|---|---|---|
廃止により物理的ギャップが作成される前のルート |  | 物理的ギャップが作成される前に表示されるルートの廃止部分は、[廃止] ツールを使用して表示されます。 |
増分値のステッピング (0.1) |  | 物理的ギャップの後の最初のメジャーに、メジャー値 0.1 が追加されます。 |
増分値の追加 (0.1) |  | 廃止によって生成された物理的ギャップの後の各メジャーに、メジャー値 0.1 が追加されます。 |
ユークリッド距離 (Euclidean Distance) |  | 廃止によって生成された物理的ギャップの後の最初のメジャーに、物理的ギャップの直線距離に等しいメジャー値が追加されます。 |
| ||
このツールは、指定したネットワークのギャップ キャリブレーション ルールと、キャリブレーション オフセットの設定をサポートします。
通常、ネットワーク キャリブレーション ルールは、ネットワークの作成後に変更できます。 キャリブレーション ルールを変更すると、新しいルールは、将来的に編集または読み込まれるルートにのみ適用されます。 過去に編集または読み込まれたすべてのルートには、新しいキャリブレーション ルールは適用されません。 これらのルートには、ルートの作成または編集時に設定されたキャリブレーション ルールが適用されます。
[キャリブレーション ルール] パラメーターの [そのまま] オプションを使用し、要件に準じたキャリブレーション オフセット値のみを変更するオプションを指定し、既存のギャップ キャリブレーション方法を保持できます。
増分値の追加と増分値のステッピングには、[キャリブレーション オフセット] パラメーターを設定する必要があります。 値は、小数の有無にかかわらず、数値でなくてはなりません。負の値は使用できません。
[キャリブレーション オフセット] パラメーター値は、ネットワークの M 許容値以下に設定できません。 ゼロに設定するか、ネットワークの M 許容値より大きい値に設定する必要があります。
[キャリブレーション オフセット] パラメーター値をゼロ (0) として定義すると、物理的ギャップでのキャリブレーション メジャーにギャップが含まれないルートが作成されます。
LRS ネットワークのデフォルトのギャップ キャリブレーション ルールは、オフセット値が 0 の増分値のステッピングです。
このツールは、フィーチャ サービスではサポートされていません。
| ラベル | 説明 | データ タイプ |
LRS ネットワーク フィーチャクラス | 入力 LRS ネットワーク フィーチャクラス。 | Feature Layer |
キャリブレーション ルール (オプション) | キャリブレーション ギャップ メジャーを定義するために使用する方法を指定します。
| String |
キャリブレーション オフセット (オプション) | [キャリブレーション ルール] パラメーターの [増分値の追加] と [増分値のステッピング] 方法の値。 増分値は数値である必要があり、小数も含めることができます。 | Double |
カートグラフィックの再配置中のルート メジャーの更新 (オプション) | カートグラフィックの再配置における長さの変更に基づき、ルートのメジャー値を再キャリブレーションするかどうかを指定します。
| String |
| ラベル | 説明 | データ タイプ |
| 出力ネットワーク フィーチャクラス | 更新されたネットワーク フィーチャ レイヤー。 | Feature Layer |
arcpy.locref.ModifyNetworkCalibrationRules(in_feature_class, {calibration_rule}, {calibration_offset}, {update_measure_cartorealign})| 名前 | 説明 | データ タイプ |
in_feature_class | 入力 LRS ネットワーク フィーチャクラス。 | Feature Layer |
calibration_rule (オプション) | キャリブレーション ギャップ メジャーを定義するために使用する方法を指定します。
| String |
calibration_offset (オプション) | [キャリブレーション ルール] パラメーターの [増分値の追加] と [増分値のステッピング] 方法の値。 増分値は数値である必要があり、小数も含めることができます。 | Double |
update_measure_cartorealign (オプション) | カートグラフィックの再配置における長さの変更に基づき、ルートのメジャー値を再キャリブレーションするかどうかを指定します。
| String |
| 名前 | 説明 | データ タイプ |
| out_feature_class | 更新されたネットワーク フィーチャ レイヤー。 | Feature Layer |
次のスクリプトは、Python ウィンドウで ModifyNetworkCalibrationRules 関数を使用する方法を示しています。
#Name: ModifyNetworkCalibrationRules_ex1.py
#Description: Use the ModifyNetworkCalibrationRules geoprocessing tool in the Python window.
#Requires: ArcGIS Location Referencing
# Set current workspace
arcpy.env.workspace = "C:\Data\LRS\RS.gdb"
# Tool variables
in_network_class = r"C:\Data\Lrs.gdb\LRS\LRSNetwork"
calibration_rule = "ADDING_INCREMENT"
calibration_offset = 0.1
recalibrate_route_measures_based_on_length_change_in_cartorealign = "ENABLE"
# Execute the tool
arcpy.locref.ModifyNetworkCalibrationRules(in_network_class, calibration_rule, calibration_offset, recalibrate_route_measures_based_on_length_change_in_cartorealign)次のスクリプトは、スタンドアロン Python スクリプトで ModifyNetworkCalibrationRules 関数を使用する方法を示しています。
#Name: ModifyNetworkCalibrationRules_ex2.py
#Description: This script demonstrates how to use ModifyNetworkCalibrationRules geoprocessing tool in stand-alone Python script.
#Requires: ArcGIS Location Referencing license
#Import arcpy module
import arcpy
#Check out license
arcpy.CheckOutExtension("LocationReferencing")
# Tool variables
in_network_class = r"C:\Data\Lrs.gdb\LRS\LRSNetwork"
calibration_rule = "ADDING_INCREMENT"
calibration_offset = 0.1
recalibrate_route_measures_based_on_length_change_in_cartorealign = "ENABLE"
# Execute the tool
arcpy.locref.ModifyNetworkCalibrationRules(in_network_class, calibration_rule, calibration_offset, recalibrate_route_measures_based_on_length_change_in_cartorealign)
# Check in license
arcpy.CheckInExtension('LocationReferencing')