ルートの削除 (Delete Routes) (Location Referencing)

Location Referencing ライセンスで利用可能です。

サマリー

LRS ネットワークからルートとそれに関連付けられたデータ エレメントを削除します。

使用法

  • このツールの実行には、LRS データセットが必要です。

    詳細については、「ArcGIS Pipeline Referencing での LRS データセットの作成」か「ArcGIS Roads and Highways での LRS データセットの作成」をご参照ください。

  • ルートの削除の一環として、[ルートの削除 (Delete Routes)] ツールを使用して次の操作を実行することもできます。

    • 削除したルートの RouteID を含む中心線シーケンス レコードをすべて削除する。
    • 削除したルートに関連付けられた lrs_edit_log テーブル内のレコードをすべて削除する。
    • 必要に応じて、関連付けられた中心線、キャリブレーション ポイント、およびイベントを削除する。
      注意:

      [関連付けられた中心線の削除][関連付けられたキャリブレーション ポイントの削除]、および [関連付けられたイベントの削除] パラメーターを指定せずに [ルートの削除 (Delete Routes)] を実行すると、これらの中心線、キャリブレーション ポイント、およびイベントがどのルートも参照しなくなる場合があります。

  • この入力は、LRS ネットワークに登録されているネットワーク フィーチャクラスにする必要があります。

  • このツールを実行する前に削除しておく必要のあるルートを選択します。 LRS ネットワーク フィーチャクラスでの選択を実行するには、[選択] ツールまたはフィルター設定を使用します。

  • LRS ネットワーク フィーチャクラスでルートが選択されていない場合は、このツールの実行に失敗します。

  • 選択したルート レコードのうち、同じ RouteID を持つルート レコードは、時間が経つと削除されます。

  • ライン ネットワークでルートが選択されている場合、同じライン内のルートはすべて、時間が経つと削除されます。

  • [関連付けられたキャリブレーション ポイントの削除] パラメーターがオンの場合、ルートに関連付けられているキャリブレーション ポイントは、時間が経つと削除されます。

  • [関連付けられたイベントの削除] パラメーターがオンの場合、ネットワークに登録されているイベントのうち、削除したルートと同じ RouteID を持つイベントはすべて、時間が経つと削除されます。

  • [関連付けられた中心線の削除] パラメーターがオンの場合は、選択したルートに関連付けられている中心線が削除されます。 ネットワーク間で中心線が共有されている場合、これらの共通の中心線は削除されません。

  • このツールをデフォルト バージョンのデータベースに対して実行することはお勧めしません。

  • このツールを編集セッションで実行した場合は、削除したルートを元に戻すことができます。

  • 注意:

    このツールを編集セッション以外で実行した場合は、削除したルートを元に戻すことができません。

  • RouteID または LineID が NULL のルートの場合、このツールは実行されますが、レコードは削除されません。

  • 時間フィルターがオンになっている場合は、ArcGIS Pro でネットワーク レイヤーに対して [ルートの削除 (Delete Routes)] ツールを実行することができません。

  • このツールは競合の回避をサポートしており、ロックの取得と転送を試行します。

    ArcGIS Pipeline Referencing での競合の回避または ArcGIS Roads and Highways での競合の回避の詳細をご参照ください。

パラメーター

ラベル説明データ タイプ
入力ルート フィーチャ

ネットワークに登録されているルート フィーチャクラス。

Feature Layer
関連付けられたキャリブレーション ポイントの削除
(オプション)

削除したルートに関連付けられているキャリブレーション ポイントを削除するかどうかを指定します。

  • オン - ルートに関連付けられているキャリブレーション ポイントが削除されます。
  • オフ - ルートに関連付けられているキャリブレーション ポイントが削除されません。 これがデフォルトです。
Boolean
関連付けられたイベントの削除
(オプション)

削除したルートに関連付けられているイベントを削除するかどうかを指定します。

  • オン - ルートに関連付けられているイベントが削除されます。
  • オフ - ルートに関連付けられているイベントが削除されません。 これがデフォルトです。
Boolean
関連付けられた中心線の削除
(オプション)

削除したルートにのみ関連付けられている中心線を削除するかどうかを指定します。

  • オン - 選択したルートにのみ関連付けられている中心線が削除されます。 ネットワーク間で中心線が共有されている場合、これらの共通の中心線は削除されません。
  • オフ - 中心線が削除されません。 これがデフォルトです。
Boolean

派生した出力

ラベル説明データ タイプ
更新されたルート フィーチャ

更新された LRS ネットワーク フィーチャクラス。

Feature Layer
出力結果ファイル

LRS ネットワーク フィーチャクラスから削除されたルートを詳しく記述したテキスト ファイル。

Text File
出力派生ルート フィーチャ

更新された派生ルート フィーチャ レイヤー。

Feature Layer

arcpy.locref.DeleteRoutes(in_route_features, {delete_associated_calibration_points}, {delete_associated_events}, {delete_associated_centerlines})
名前説明データ タイプ
in_route_features

ネットワークに登録されているルート フィーチャクラス。

Feature Layer
delete_associated_calibration_points
(オプション)

削除したルートに関連付けられているキャリブレーション ポイントを削除するかどうかを指定します。

  • DELETE_CALIBRATION_POINTSルートに関連付けられているキャリブレーション ポイントが削除されます。
  • NO_DELETE_CALIBRATION_POINTSルートに関連付けられているキャリブレーション ポイントが削除されません。 これがデフォルトです。
Boolean
delete_associated_events
(オプション)

削除したルートに関連付けられているイベントを削除するかどうかを指定します。

  • DELETE_EVENTSルートに関連付けられているイベントが削除されます。
  • NO_DELETE_EVENTSルートに関連付けられているイベントが削除されません。 これがデフォルトです。
Boolean
delete_associated_centerlines
(オプション)

削除したルートにのみ関連付けられている中心線を削除するかどうかを指定します。

  • DELETE_CENTERLINES選択したルートにのみ関連付けられている中心線が削除されます。 ネットワーク間で中心線が共有されている場合、これらの共通の中心線は削除されません。
  • NO_DELETE_CENTERLINES中心線が削除されません。 これがデフォルトです。
Boolean

派生した出力

名前説明データ タイプ
updated_route_features

更新された LRS ネットワーク フィーチャクラス。

Feature Layer
out_details_file

LRS ネットワーク フィーチャクラスから削除されたルートを詳しく記述したテキスト ファイル。

Text File
out_derived_route_features

更新された派生ルート フィーチャ レイヤー。

Feature Layer

コードのサンプル

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

次の Python ウィンドウ スクリプトは、イミディエイト モードで DeleteRoutes 関数を使用する方法を示しています。

# Name: DeleteRoutes_ex1.py
# Description: Delete routes and associated data elements from an LRS Network in the Python window
# Requires: ArcGIS Location Referencing

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

# Delete Routes tool variables
in_route_features = "PipelineNetwork"
delete_associated_calibration_points = "DELETE_CALIBRATION_POINTS" 
delete_associated_events = "DELETE_EVENTS"
delete_associated_centerlines = "DELETE_CENTERLINES"

# Execute Delete Routes. (Input route features must be selected prior to tool execution)
arcpy.locref.DeleteRoutes(in_route_features, delete_associated_calibration_points, delete_associated_events, delete_associated_centerlines)
DeleteRoutes の例 2 (スタンドアロン スクリプト)

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

# Name: DeleteRoutes_ex2.py
# Description: Delete routes and associated data elements from an LRS Network.
# Requires: ArcGIS Location Referencing

# Import arcpy module
import arcpy

# Check out license
arcpy.CheckOutExtension("LocationReferencing")

# Provide the path of database
arcpy.env.workspace = r"C:\Users\Desktop\PipelineReferencing.gdb\LRS\LineNetwork"

# Convert network feature class to layer
arcpy.management.MakeFeatureLayer("LineNetwork", "networklyr")

# Process: Select Layer By Attribute
arcpy.management.SelectLayerByAttribute("networklyr", "NEW_SELECTION", "RouteID = '11316262800'")

# Run Delete Routes tool
arcpy.locref.DeleteRoutes("networklyr", "DELETE_CALIBRATION_POINTS", "DELETE_EVENTS", "DELETE_CENTERLINES")

print("Successfully deleted the selected route...")

# Check in license
arcpy.CheckInExtension('LocationReferencing')
DeleteRoutes の例 3 (スタンドアロン スクリプト)

次のスタンドアロン スクリプトは、フィーチャ サービスで DeleteRoutes 関数を使用する方法を示しています。

# Name: DeleteRoutes_Pro_Ex3.py
# Description: Delete routes in stand-alone mode using a feature service. It is recommended to work in a version and post it into the default version.
# Requires: ArcGIS Location Referencing

# Import arcpy module
import arcpy

# Check out license
arcpy.CheckOutExtension("LocationReferencing")

# Set tool variables
delete_associated_calibration_points = "DELETE_CALIBRATION_POINTS"
delete_associated_events = "DELETE_EVENTS"
delete_associated_centerlines = "DELETE_CENTERLINES"

# Input LRS route network is in a feature service. Sign into portal is required to access the feature service.
arcpy.SignInToPortal('https://yourdomain.com/portal', 'username', 'password')

## Make a layer of the LRS route network from the feature service for applying selection. Here, 1 corresponds to the LRS route network
in_route_layer = arcpy.management.MakeFeatureLayer("https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/1", 'route_layer')

## Process: Select Layer by attribute as required
arcpy.management.SelectLayerByAttribute(in_route_layer, "NEW_SELECTION", "RouteID = 'routeid1'")

# Process : Delete Routes
arcpy.locref.DeleteRoutes( in_route_layer, delete_associated_calibration_points, delete_associated_events, delete_associated_centerlines)

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

関連トピック