ルート イベントのディゾルブ (Dissolve Route Events) (リニア リファレンス)

サマリー

重複する情報をイベント テーブルから削除することや、複数の詳細属性を持つイベント テーブルを別々のテーブルに分割することができます。

使用法

  • ArcGIS が対応しているテーブルであれば、どのタイプでも入力テーブルとして使用できます。 出力テーブルには、.dbf ファイルまたはジオデータベース テーブルを使用できます。

  • [入力イベント テーブル] パラメーター値に ObjectID フィールドがない場合は、このツールを使用する前に [クエリ テーブルの作成 (Make Query Table)] ツールを使用して仮想 ObjectID フィールドを追加してください。

  • ルート識別フィールドに属性フィールドを使用すると、ダイナミック セグメンテーション処理を高速化できます。 ダイナミック セグメンテーションに [出力イベント テーブル] パラメーター値を使用する場合は、属性インデックスを作成することをお勧めします。

パラメーター

ラベル説明データ タイプ
入力イベント テーブル

統合の対象となる行が含まれているテーブル。

Table View
イベント テーブル プロパティ

入力イベント テーブルのルート ロケーション フィールドとイベント タイプ。

  • [ルート識別フィールド]: 各イベントがあるルートを示す値が格納されるフィールド。 このフィールドには、数値、テキスト、または GUID フィールドを使用できます。
  • [イベント タイプ]: 入力イベント テーブルのイベントのタイプ ([ポイント] または [ライン])。
    • [ポイント]: ポイント イベントは、ルート沿いの正確な位置で発生します。 始点メジャーだけを指定する必要があります。
    • [ライン]: ライン イベントでは、ルートの一部分を定義します。 始点メジャーと終点メジャーの両方のフィールドを指定する必要があります。
  • [始点メジャー フィールド]: メジャー値を格納したフィールド。 このフィールドは数値でなければならず、イベント タイプが [ポイント] または [ライン] の場合は必須です。 [イベント タイプ] の値が [ポイント] の場合、このパラメーターのラベルは [メジャー フィールド] になります。
  • [終点メジャー フィールド]: メジャー値を格納したフィールド。 このフィールドは数値でなければならず、イベント タイプが [ライン] の場合は必須です。
Route Measure Event Properties
ディゾルブ フィールド

行の統合に使用するフィールド。

Field
出力イベント テーブル

作成されるテーブル。

Table
出力イベント テーブル プロパティ

出力イベント テーブルに書き出されるルート ロケーション フィールドとイベント タイプ。

  • [ルート識別フィールド]: 各イベントがあるルートを示す値が格納されるフィールド。 このフィールドには、数値、テキスト、または GUID フィールドを使用できます。
  • [イベント タイプ]: 出力イベント テーブルに格納されるイベントのタイプ ([ポイント] または [ライン])。
    • [ポイント]: ポイント イベントは、ルート沿いの正確な位置で発生します。 メジャーを 1 つだけ指定する必要があります。
    • [ライン]: ライン イベントでは、ルートの一部分を定義します。 始点メジャーと終点メジャーの両方のフィールドを指定する必要があります。
  • [始点メジャー フィールド]: メジャー値が格納されるフィールド。 このフィールドは、イベント タイプが [ポイント] または [ライン] の場合に必須です。 [イベント タイプ] の値が [ポイント] の場合、このパラメーターのラベルは [メジャー フィールド] になります。
  • [終点メジャー フィールド]: メジャー値が格納されるフィールド。 このフィールドは、イベント タイプが [ライン] の場合に必須です。
Route Measure Event Properties
隣接するイベントのみ結合
(オプション)

入力イベントの集約方法を指定します。

  • オフ: メジャーがオーバーラップしている各場所のイベントが統合されます。 これがデフォルトです。
  • オン: あるイベントの終点メジャーと次のイベントの始点メジャーが一致する場合に、イベントが統合されます。 このオプションはライン イベントにしか適用されません。
Boolean
インデックスの構築
(オプション)

出力イベント テーブルに書き出されたルート識別フィールドについて属性インデックスを作成するかどうかを指定します。

  • オン - 属性インデックスが作成されます。 これがデフォルトです。
  • オフ - 属性インデックスが作成されません。
Boolean

arcpy.lr.DissolveRouteEvents(in_events, in_event_properties, dissolve_field, out_table, out_event_properties, {dissolve_type}, {build_index})
名前説明データ タイプ
in_events

統合の対象となる行が含まれているテーブル。

Table View
in_event_properties

入力イベント テーブルのルート ロケーション フィールドとイベント タイプ。

  • ルート識別フィールド: 各イベントがあるルートを示す値が格納されるフィールド。 このフィールドには、数値、テキスト、または GUID フィールドを使用できます。
  • イベント タイプ: 入力イベント テーブルのイベントのタイプ (POINT または LINE)。
    • POINT: ポイント イベントは、ルート沿いの正確な位置で発生します。 始点メジャーだけを指定する必要があります。
    • LINE: ライン イベントでは、ルートの一部分を定義します。 始点メジャーと終点メジャーの両方のフィールドを指定する必要があります。
  • 始点メジャー フィールド - メジャー値を格納したフィールド。 このフィールドは数値でなければならず、イベント タイプが POINT または LINE の場合は必須です。
  • 終点メジャー フィールド - メジャー値を格納したフィールド。 このフィールドは数値でなければならず、イベント タイプが LINE の場合は必須です。
Route Measure Event Properties
dissolve_field
[dissolve_field,...]

行の統合に使用するフィールド。

Field
out_table

作成されるテーブル。

Table
out_event_properties

出力イベント テーブルに書き出されるルート ロケーション フィールドとイベント タイプ。

  • ルート識別フィールド: 各イベントがあるルートを示す値が格納されるフィールド。 このフィールドには、数値、テキスト、または GUID フィールドを使用できます。
  • イベント タイプ: 出力イベント テーブルに格納されるイベントのタイプ (POINT または LINE)。
    • POINT: ポイント イベントは、ルート沿いの正確な位置で発生します。 メジャーを 1 つだけ指定する必要があります。
    • LINE: ライン イベントでは、ルートの一部分を定義します。 始点メジャーと終点メジャーの両方のフィールドを指定する必要があります。
  • 始点メジャーフィールド: メジャー値が格納されるフィールド。 このフィールドは、イベント タイプが POINT または LINE の場合に必須です。
  • 終点メジャー フィールド: メジャー値が格納されるフィールド。 このフィールドは、イベント タイプが LINE の場合に必須です。
Route Measure Event Properties
dissolve_type
(オプション)

入力イベントの集約方法を指定します。

  • DISSOLVEメジャーがオーバーラップしている各場所のイベントが統合されます。 これがデフォルトです。
  • CONCATENATEあるイベントの終点メジャーと次のイベントの始点メジャーが一致する場合に、イベントが統合されます。 このオプションはライン イベントにしか適用されません。
Boolean
build_index
(オプション)

出力イベント テーブルに書き出されたルート識別フィールドについて属性インデックスを作成するかどうかを指定します。

  • INDEX属性インデックスが作成されます。 これがデフォルトです。
  • NO_INDEX属性インデックスが作成されません。
Boolean

コードのサンプル

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

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


import arcpy
arcpy.env.workspace = "C:/Data"
arcpy.lr.DissolveRouteEvents("pavecond.dbf", "rkey LINE fmp tmp", "lanes", 
                             "pave_dissolve1.dbf", "rkey LINE fmp tmp")
DissolveRouteEvents の例 2 (スタンドアロン スクリプト)

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

# Name: DissolveRouteEvents_Example2.py
# Description: Dissolve line events based on one field (input table is dBASE).

# Import system modules 
import arcpy

# Set workspace
arcpy.env.workspace = "D:/Data/pitt_county"

# Set local variables
in_tbl = "pavecond.dbf"
in_props = "rkey LINE fmp tmp"  # re-used as out event properties
flds = "lanes" 
out_tbl = "pave_dissolve1.dbf"

# Run DissolveRouteEvents
arcpy.lr.DissolveRouteEvents(in_tbl, in_props, flds, out_tbl, in_props)
DissolveRouteEvents の例 3 (スタンドアロン スクリプト)

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

# Name: DissolveRouteEvents_Example3.py
# Description: Concatenate line events based on two fields (input table is file geodatabase).

# Import system modules
import arcpy

# Set workspace
arcpy.env.workspace = "C:/Data/pitt.gdb"

# Set local variables
in_tbl = "pavecond"
in_props = "rkey LINE fmp tmp"  # re-used as out event properties
flds = "lanes;curb" 
out_tbl = "pave_dissolve2"

# Run DissolveRouteEvents
arcpy.lr.DissolveRouteEvents(in_tbl, in_props, flds, out_tbl, in_props, 
                             "CONCATENATE")
DissolveRouteEvents (ルート イベントのディゾルブ) の例 4 (スタンドアロン スクリプト)

次の Python スクリプトは、エンタープライズ ジオデータベース データを使用し、スタンドアロン Python スクリプトで DissolveRouteEvents 関数を使用する方法を示します。

# Name: DissolveRouteEvents_Example4.py
# Description: Dissolve line events based on two fields (input table is enterprise geodatabase).

# Import system modules
import arcpy

# Set workspace
arcpy.env.workspace = "C:/MyProject/myConn.sde"

# Set local variables
in_tbl = arcpy.ValidateTableName("pavecond", wkspc) 
in_props = "rkey LINE fmp tmp" 
flds = "lanes;curb" 
out_tbl = "pave_dissolve3"
out_props = "rid LINE f_meas t_meas" 

# Run DissolveRouteEvents
arcpy.lr.DissolveRouteEvents(in_tbl, in_props, flds, out_tbl, out_props, "#", 
                             "NO_INDEX")

ライセンス情報

  • Basic: Yes
  • Standard: Yes
  • Advanced: Yes

関連トピック