| ラベル | 説明 | データ タイプ |
入力フィーチャ | 入力ポイント、ライン、またはポリゴン フィーチャ。 | Feature Layer |
入力ルート フィーチャ | [入力フィーチャ] パラメーター値が交差するルート。 | Feature Layer |
ルート識別フィールド | 各ルートを一意に識別する値を格納したフィールド。 このフィールドには、数値、テキスト、または GUID フィールドを使用できます。 | Field |
検索範囲 | [入力フィーチャ] パラメーター値がポイントの場合は、検索範囲に数値を指定して、ターゲット ルートの検索対象となる領域を各ポイントからの距離で定義します。 [入力フィーチャ] パラメーター値がラインの場合、検索許容値は、入力ラインとターゲット ルートの間の最大許容距離を表す数値であるクラスター許容値になります。 [入力フィーチャ] パラメーター値がポリゴンの場合、このパラメーターは無視され、検索範囲は使用されません。 | Linear Unit |
出力イベント テーブル | 作成されるテーブル。 出力テーブルは、dBase (.dbf ファイル) でもジオデータベース テーブルでもかまいません。 | Table |
出力イベント テーブル プロパティ | 出力イベント テーブルに書き出されるルート ロケーション フィールドとイベント タイプ。
| Route Measure Event Properties |
最も近いルート ロケーションのみを保持 (オプション) | [出力イベント テーブル] パラメーター値に書き出されるのは、検索範囲内の最も近いルート ロケーションであるか、すべてのルート ロケーションであるかを指定します。 ルート沿いのポイントを検索する場合、ポイントによっては、検索範囲に複数のルートが存在することがあります。 ルート沿いのラインまたはポリゴンを検索する場合、このパラメーターは無視されます。
| Boolean |
出力テーブルに距離フィールドを含める (オプション) | DISTANCE フィールドを [出力イベント テーブル] パラメーター値に追加するかどうかを指定します。 このフィールドの値には、指定した検索範囲の単位が使用されます。 ルート沿いのラインまたはポリゴンを検索する場合、このパラメーターは無視されます。
| Boolean |
長さゼロのライン イベントを保持 (オプション) | 長さゼロのライン イベントが、出力に書き出されるかどうかを指定します。 ルート沿いのポリゴンを検索する場合、始点メジャー値と終点メジャー値の等しいイベントが作成されることがあります。 ルート沿いのポイントまたはラインを検索する場合、このパラメーターは無視されます。
| Boolean |
入力のすべてのフィールドを含める (オプション) | [出力イベント テーブル] パラメーター値に、ルート ロケーション フィールドと、[入力フィーチャ] パラメーター値のすべての属性を格納するかどうかを指定します。
| Boolean |
M 方向オフセットの使用 (オプション) | M 方向またはデジタイズされた方向のどちらに基づいてオフセット距離を計算するかを指定します。 [出力テーブルに距離フィールドを含める] パラメーターをオンにした場合、[出力イベント テーブル] パラメーター値に距離が含まれます。
| Boolean |
サマリー
入力フィーチャ (ポイント、ライン、またはポリゴン) とルート フィーチャの交差を計算して、新しいイベント テーブルにルートとメジャー情報を書き出します。
使用法
[入力フィーチャ] パラメーター値がポイントの場合、[イベント タイプ] の値を [ポイント] に設定する必要があります。 [入力フィーチャ] パラメーター値がラインまたはポリゴンの場合、[イベント タイプ] の値を [ライン] に設定する必要があります。
入力フィーチャとターゲット ルートが、厳密にオーバーレイしている場合に、最良の結果を得ることができます。
注意:
入力フィーチャとターゲット ルートの間の相違点を克服するために、検索範囲やクラスター許容値を大きくすると、予期せぬ結果となることがあります。
このツールで処理する入力フィーチャの数を減らすには、選択を含むレイヤーを入力として指定します。
-
出力テーブルは、[ルート イベント レイヤーの作成 (Make Route Event Layer)] ツールを使用して、マップに表示できます。
パラメーター
arcpy.lr.LocateFeaturesAlongRoutes(in_features, in_routes, route_id_field, radius_or_tolerance, out_table, out_event_properties, {route_locations}, {distance_field}, {zero_length_events}, {in_fields}, {m_direction_offsetting})| 名前 | 説明 | データ タイプ |
in_features | 入力ポイント、ライン、またはポリゴン フィーチャ。 | Feature Layer |
in_routes | in_features パラメーター値が交差するルート。 | Feature Layer |
route_id_field | 各ルートを一意に識別する値を格納したフィールド。 このフィールドには、数値、テキスト、または GUID フィールドを使用できます。 | Field |
radius_or_tolerance | in_features パラメーター値がポイントの場合は、検索範囲に数値を指定して、ターゲット ルートの検索対象となる領域を各ポイントからの距離で定義します。 in_features パラメーター値がラインの場合、検索許容値は、入力ラインとターゲット ルートの間の最大許容距離を表す数値であるクラスター許容値になります。 in_features パラメーター値がポリゴンの場合、このパラメーターは無視され、検索範囲は使用されません。 | Linear Unit |
out_table | 作成されるテーブル。 出力テーブルは、dBase (.dbf ファイル) でもジオデータベース テーブルでもかまいません。 | Table |
out_event_properties | 出力イベント テーブルに書き出されるルート ロケーション フィールドとイベント タイプ。
| Route Measure Event Properties |
route_locations (オプション) | out_table パラメーター値に書き出されるのは、検索範囲内の最も近いルート ロケーションであるか、すべてのルート ロケーションであるかを指定します。 ルート沿いのポイントを検索する場合、ポイントによっては、検索範囲に複数のルートが存在することがあります。 ルート沿いのラインまたはポリゴンを検索する場合、このパラメーターは無視されます。
| Boolean |
distance_field (オプション) | DISTANCE フィールドを out_table パラメーター値に追加するかどうかを指定します。 このフィールドの値には、指定した検索範囲の単位が使用されます。 ルート沿いのラインまたはポリゴンを検索する場合、このパラメーターは無視されます。
| Boolean |
zero_length_events (オプション) | 長さゼロのライン イベントが、出力に書き出されるかどうかを指定します。 ルート沿いのポリゴンを検索する場合、始点メジャーと終点メジャーの等しいイベントが作成されることがあります。 ルート沿いのポイントまたはラインを検索する場合、このパラメーターは無視されます。
| Boolean |
in_fields (オプション) | out_table パラメーター値に、ルート ロケーション フィールドと、in_features パラメーター値のすべての属性を格納するかどうかを指定します。
| Boolean |
m_direction_offsetting (オプション) | M 方向またはデジタイズされた方向のどちらに基づいてオフセット距離を計算するかを指定します。 out_table パラメーター値を distance_field に設定した場合、DISTANCE パラメーター値に距離が含まれます。
| Boolean |
コードのサンプル
次の Python スクリプトは、Python ウィンドウで LocateFeaturesAlongRoutes 関数を使用する方法を示しています。
import arcpy
arcpy.env.workspace = "C:/Data"
arcpy.lr.LocateFeaturesAlongRoutes("rail_segments.shp", "rail_routes.shp",
"rkey", "0.5 Feet", "locate_lines",
"rkey LINE fmp tmp")次の Python スクリプトは、スタンドアロン LocateFeaturesAlongRoutes スクリプトで Python 関数を使用する方法を示しています。
# Name: LocateFeaturesAlongRoutes_Example2.py
# Description: Locate shapefile lines along shapefile routes.
# Import system modules
import arcpy
# Set workspace
arcpy.env.workspace = "C:/Data"
# Set local variables
feats = "rail_segments.shp"
rts = "rail_routes.shp"
rid = "rkey"
tol = "0.5 Feet"
tbl = "locate_lines"
props = "rkey LINE fmp tmp"
# Run LocateFeaturesAlongRoutes
arcpy.lr.LocateFeaturesAlongRoutes(feats, rts, rid, tol, tbl, props)次の Python スクリプトは、ファイル ジオデータベース データを使用し、スタンドアロン Python スクリプトで LocateFeaturesAlongRoutes 関数を使用する方法を示しています。
# Name: LocateFeaturesAlongRoutes_Example3.py
# Description: Locate file geodatabase points along file geodatabase routes.
# Import system modules
import arcpy
# Set workspace
arcpy.env.workspace = "C:/Data/Pitt.gdb"
# Set local variables
feats = "rail/crossings" # Crossings is in the rail feature dataset
rts = "rail/routes" # Routes is in the rail feature dataset
rid = "rkey"
rad = "10 Feet"
tbl = "locate_points"
props = "rkey POINT mp"
# Run LocateFeaturesAlongRoutes
arcpy.lr.LocateFeaturesAlongRoutes(feats, rts, rid, rad, tbl, props)次の Python スクリプトは、エンタープライズ ジオデータベース データを使用し、スタンドアロン Python スクリプトで LocateFeaturesAlongRoutes 関数を使用する方法を示します。
# Name: LocateFeaturesAlongRoutes_Example4.py
# Description: Locate enterprise geodatabase polygons along enterprise geodatabase routes.
# Import system modules
import arcpy
# Set workspace
arcpy.env.workspace = "C:/MyProject/myConn.sde"
# Set local variables
feats = arcpy.ValidateTableName("counties", wkspc) # Stand-alone feature class
rts = arcpy.ValidateTableName("rail_routes", wkspc) # Stand-alone feature class
rid = "rkey"
tbl = "locate_polys"
props = "rkey LINE fmp tmp"
# Run LocateFeaturesAlongRoutes
arcpy.lr.LocateFeaturesAlongRoutes(feats, rts, rid, "#", tbl, props, "#", "#",
"NO_ZERO", "M_DIRECTON")ライセンス情報
- Basic: Yes
- Standard: Yes
- Advanced: Yes