ネットワーク キャリブレーション ルールの変更 (Modify Network Calibration Rules) (Location Referencing)

サマリー

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)

    増分値の追加 (0.1)

    各物理的ギャップの後の各メジャーに、メジャー値 0.1 が追加されます。

    ユークリッド距離

    ユークリッド距離

    各物理的ギャップの後の最初のメジャーに、物理的ギャップの直線距離に等しいメジャー値が追加されます。

    凡例

    メジャー 0.5 〜 1 の間のルートを廃止

    ルートの廃止キャリブレーション例説明

    廃止により物理的ギャップが作成される前のルート

    廃止により物理的ギャップが作成される前のルート

    物理的ギャップが作成される前に表示されるルートの廃止部分は、[廃止] ツールを使用して表示されます。

    増分値のステッピング (0.1)

    増分値のステッピング (0.1)

    物理的ギャップの後の最初のメジャーに、メジャー値 0.1 が追加されます。

    増分値の追加 (0.1)

    増分値の追加 (0.1)

    廃止によって生成された物理的ギャップの後の各メジャーに、メジャー値 0.1 が追加されます。

    ユークリッド距離

    ユークリッド距離

    廃止によって生成された物理的ギャップの後の最初のメジャーに、物理的ギャップの直線距離に等しいメジャー値が追加されます。

    凡例
  • このツールは、指定したネットワークのギャップ キャリブレーション ルールと、キャリブレーション オフセットの設定をサポートします。

  • 通常、ネットワーク キャリブレーション ルールは、ネットワークの作成後に変更できます。 キャリブレーション ルールを変更すると、新しいルールは、将来的に編集または読み込まれるルートにのみ適用されます。 過去に編集または読み込まれたすべてのルートには、新しいキャリブレーション ルールは適用されません。 これらのルートには、ルートの作成または編集時に設定されたキャリブレーション ルールが適用されます。

  • [キャリブレーション ルール] パラメーターの [そのまま] オプションを使用し、要件に準じたキャリブレーション オフセット値のみを変更するオプションを指定し、既存のギャップ キャリブレーション方法を保持できます。

  • 増分値の追加と増分値のステッピングには、[キャリブレーション オフセット] パラメーターを設定する必要があります。 値は、小数の有無にかかわらず、数値でなくてはなりません。負の値は使用できません。

  • [キャリブレーション オフセット] パラメーター値は、ネットワークの 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
(オプション)

キャリブレーション ギャップ メジャーを定義するために使用する方法を指定します。

  • AS_ISキャリブレーション オフセット値の変更中は、ネットワークで定義された既存の方法が使用されます。
  • ADDING_EUCLIDEAN_DISTANCE編集したルートに沿って、各物理的ギャップのユークリッド距離 (直線距離) を計算し、追加します。
  • STEPPING_INCREMENTルートの各物理的ギャップで調整、またはステップする値が定義されます。 これがデフォルトです。
  • ADDING_INCREMENTルートの始点および終点メジャーの全長に加えて、物理的ギャップごとにルートの各メジャーで値が定義され、追加されます。
String
calibration_offset
(オプション)

[キャリブレーション ルール] パラメーターの [増分値の追加][増分値のステッピング] 方法の値。 増分値は数値である必要があり、小数も含めることができます。

Double
update_measure_cartorealign
(オプション)

カートグラフィックの再配置における長さの変更に基づき、ルートのメジャー値を再キャリブレーションするかどうかを指定します。

  • AS_ISネットワークで定義された既存の方法が使用されます。 これがデフォルトです。
  • ENABLEカートグラフィックの再配置における長さの変更に基づき、ルートのメジャー値の再キャリブレーションを有効にします。
  • DISABLEカートグラフィックの再配置における長さの変更に基づき、ルートのメジャー値の再キャリブレーションを無効にします。
String

派生した出力

名前説明データ タイプ
out_feature_class

更新されたネットワーク フィーチャ レイヤー。

Feature Layer

コードのサンプル

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

次のスクリプトは、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)
ModifyNetworkCalibrationRules の例 2 (スタンドアロン スクリプト)

次のスクリプトは、スタンドアロン 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')

ライセンス情報

  • 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)

関連トピック