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

サマリー

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

使用法

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

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

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

パラメーター

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

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

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

入力イベント テーブルのルート ロケーション フィールドとイベント タイプで構成されるパラメーター。

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

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

Field
出力イベント テーブル

作成されるテーブル。

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

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

  • [ルート識別フィールド]: 各イベントがあるルートを示す値が格納されるフィールド。
  • [イベント タイプ]: 出力イベント テーブルに格納されるイベントのタイプ ([ポイント] または [ライン])。
    • [ポイント]: ポイント イベントは、ルート沿いの正確な位置で発生します。 メジャーを 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

入力イベント テーブルのルート ロケーション フィールドとイベント タイプで構成されるパラメーター。

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

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

Field
out_table

作成されるテーブル。

Table
out_event_properties

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

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

入力イベントを統合するか、ディゾルブするかを指定します。

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

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

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

コードのサンプル

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

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

import arcpy
arcpy.env.workspace = "C:/Data"
arcpy.DissolveRouteEvents_lr("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"

# Execute DissolveRouteEvents
arcpy.DissolveRouteEvents_lr(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"

# Execute DissolveRouteEvents
arcpy.DissolveRouteEvents_lr(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" 

# Execute DissolveRouteEvents
arcpy.DissolveRouteEvents_lr(in_tbl, in_props, flds, out_tbl, out_props, "#", 
                             "NO_INDEX")

ライセンス情報

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

関連トピック