空間検索ルールの追加 (Add Spatial Query Rule) (ネットワーク ダイアグラム ツール)
サマリー
ダイアグラムに現在表示されているネットワーク フィーチャを基準にした位置に基づいて新しいネットワーク フィーチャをダイアグラムに自動的にアペンドするダイアグラム ルールを追加します。
ネットワーク ダイアグラムを構築するための空間クエリー ルールの使用の詳細
注意:
このツールは、入力ダイアグラム テンプレートに基づく、既存のダイアグラムの一貫性に影響を与えます。 更新されるまで、既存のダイアグラムは、すべて一貫性なしになり、一貫性警告アイコン
が表示されます。
使用法
このツールは、ユーティリティー ネットワーク サービスまたはトレース ネットワーク サービスを使用する場合、サポートされません。 ファイルまたはモバイル ジオデータベース内のユーティリティー ネットワークまたはトレース ネットワークを使用するか、エンタープライズ ジオデータベース内のユーティリティー ネットワークまたはトレース ネットワークへのデータベース コネクションを使用する必要があります。 エンタープライズ ジオデータベースを操作するときは、次の要件があります。
空間検索ルールは、ダイアグラムに現在存在しているネットワーク フィーチャを基準にした位置に基づいて、新しいネットワーク フィーチャを検出し、新たに検出されたフィーチャをネットワーク ダイアグラムにアペンドするために使用されます。
このルールが連動するネットワーク フィーチャは同じフィーチャクラスに基づいています。そのため、SQL クエリー式を使用してこれらのフィーチャをフィルターできます。
アペンドされるネットワーク フィーチャは同じフィーチャクラスに基づいています。そのため、SQL クエリー式を使用してこれらのフィーチャをフィルターできます。
パラメーター
|
ラベル
|
説明
|
データ タイプ
|
|
入力ネットワーク
|
変更するダイアグラム テンプレートを含むユーティリティー ネットワークまたはトレース ネットワーク。
|
Utility Network; Trace Network
|
|
入力ダイアグラム テンプレート
|
変更するダイアグラム テンプレートの名前。
|
String
|
|
有効
|
指定したテンプレートに基づくダイアグラムの生成および更新時に、ルールを有効にするかどうかを指定します。
|
Boolean
|
|
フィーチャの追加
|
フィーチャを追加するソース フィーチャクラス。
|
Feature Class
|
|
リレーションシップ
(オプション)
|
フィーチャ間の空間リレーションシップを指定します。
交差する—フィーチャの追加 ソース フィーチャクラスのフィーチャは、既存のフィーチャ の 1 つと交差する場合にダイアグラムにアペンドされます。 これがデフォルトです。
一定距離内にある—フィーチャの追加 ソース フィーチャクラスのフィーチャは、既存のフィーチャ の 1 つから指定の距離 (ユークリッド距離) 内にある場合にダイアグラムにアペンドされます。 検索距離 パラメーターを使用して、距離を指定します。
含む | 含まれる—フィーチャの追加 ソース フィーチャクラスのフィーチャは、既存のフィーチャ のフィーチャを含んでいるか、それらに含まれている場合に、ダイアグラムにアペンドされます。
含まれる—フィーチャの追加 ソース フィーチャクラスのフィーチャは、既存のフィーチャ の範囲内にある場合にダイアグラムにアペンドされます。
境界に接する—フィーチャの追加 ソース フィーチャクラスのフィーチャは、既存のフィーチャ の 1 つに接する境界線がある場合にダイアグラムにアペンドされます。 既存のフィーチャ がラインまたはポリゴンであるとき、フィーチャの追加 入力フィーチャの境界線は、既存のフィーチャ の 1 つの境界線と接することができるだけで、入力フィーチャのいずれの部分も 既存のフィーチャ の 1 つの境界線と重なることはできません。
線分を共有する—フィーチャの追加 ソース フィーチャクラスのフィーチャは、既存のフィーチャ の 1 つとライン セグメントを共有する場合にダイアグラムにアペンドされます。 追加されるフィーチャおよび既存のフィーチャは、ラインまたはポリゴンのどちらかでなければなりません。
アウトラインが横切る—フィーチャの追加 ソース フィーチャクラスのフィーチャは、既存のフィーチャ の 1 つのアウトラインと交差する場合にダイアグラムにアペンドされます。 追加されるフィーチャおよび既存のフィーチャは、ラインまたはポリゴンのどちらかでなければなりません。 既存のフィーチャ としてポリゴンが使用される場合には、ポリゴンの境界線 (ライン) が使用されます。 ポイントで交差するラインはアペンドされますが、ライン セグメントを共有するラインはアペンドされません。
|
String
|
|
既存のフィーチャ
|
空間クエリーを実行するソース フィーチャクラス。
|
Feature Class
|
|
検索距離
(オプション)
|
既存のフィーチャ パラメーターのフィーチャと フィーチャの追加 パラメーターのフィーチャの間の距離。 このパラメーターは、リレーションシップ パラメーターが 交差する、一定距離内にある、含む、または 含まれる のいずれかに設定された場合にのみ有効です。
|
Linear Unit
|
|
追加するフィーチャのクエリー定義
(オプション)
|
ダイアグラムに追加されるフィーチャのフィルターに使用する SQL クエリー。 SQL クエリーを使用しない場合、指定した既存のフィーチャに空間的に関連する指定のソース フィーチャクラスに基づくフィーチャがダイアグラムにアペンドされます。
|
SQL Expression
|
|
既存のフィーチャのクエリー定義
(オプション)
|
ダイアグラムに存在しているフィーチャのフィルターに使用する SQL クエリー。 SQL クエリーを使用しない場合、ダイアグラムに存在する指定のソース クラスに基づくフィーチャが考慮されます。
|
SQL Expression
|
|
説明
(オプション)
|
ルールの説明。
|
String
|
派生した出力
|
ラベル
|
説明
|
データ タイプ
|
|
出力ネットワーク
|
更新されたユーティリティー ネットワークまたはトレース ネットワーク。
|
Utility Network; Trace Network
|
|
出力ダイアグラム テンプレート
|
ダイアグラム テンプレートの名前。
|
String
|
arcpy.nd.AddSpatialQueryRule(in_utility_network, template_name, is_active, added_features, {overlap_type}, existing_features, {search_distance}, {added_where_clause}, {existing_where_clause}, {description})
|
名前
|
説明
|
データ タイプ
|
|
in_utility_network
|
変更するダイアグラム テンプレートを含むユーティリティー ネットワークまたはトレース ネットワーク。
|
Utility Network; Trace Network
|
|
template_name
|
変更するダイアグラム テンプレートの名前。
|
String
|
|
is_active
|
指定したテンプレートに基づくダイアグラムの生成および更新時に、ルールを有効にするかどうかを指定します。
|
Boolean
|
|
added_features
|
フィーチャを追加するソース フィーチャクラス。
|
Feature Class
|
|
overlap_type
(オプション)
|
評価される空間リレーションシップを指定します。
INTERSECT—added_features ソース フィーチャクラスのフィーチャは、existing_features の 1 つと交差する場合にダイアグラムにアペンドされます。 これがデフォルトです。
WITHIN_A_DISTANCE—added_features ソース フィーチャクラスのフィーチャは、existing_features の 1 つから指定の距離 (ユークリッド距離) 内にある場合にダイアグラムにアペンドされます。 search_distance パラメーターを使用して、距離を指定します。
CONTAINS—added_features ソース フィーチャクラスのフィーチャは、existing_features のフィーチャを含んでいるか、それらに含まれている場合に、ダイアグラムにアペンドされます。
WITHIN—added_features ソース フィーチャクラスのフィーチャは、existing_features の範囲内にある場合にダイアグラムにアペンドされます。
BOUNDARY_TOUCHES—added_features ソース フィーチャクラスのフィーチャは、existing_features の 1 つに接する境界線がある場合にダイアグラムにアペンドされます。 existing_features がラインまたはポリゴンであるとき、added_features の境界線は、existing_features の 1 つの境界線と接することができるだけで、入力フィーチャのいずれの部分も existing_features の 1 つの境界線と重なることはできません。
SHARE_A_LINE_SEGMENT_WITH—added_features ソース フィーチャクラスのフィーチャは、existing_features の 1 つとライン セグメントを共有する場合にダイアグラムにアペンドされます。 追加されるフィーチャおよび既存のフィーチャは、ラインまたはポリゴンのどちらかでなければなりません。
CROSSED_BY_THE_OUTLINE_OF—added_features ソース フィーチャクラスのフィーチャは、existing_features の 1 つのアウトラインと交差する場合にダイアグラムにアペンドされます。 追加されるフィーチャおよび既存のフィーチャは、ラインまたはポリゴンのどちらかでなければなりません。 existing_features としてポリゴンが使用される場合には、ポリゴンの境界線 (ライン) が使用されます。 ポイントで交差するラインはアペンドされますが、ライン セグメントを共有するラインはアペンドされません。
|
String
|
|
existing_features
|
空間クエリーを実行するソース フィーチャクラス。
|
Feature Class
|
|
search_distance
(オプション)
|
existing_features パラメーターのフィーチャと added_features パラメーターのフィーチャの間の距離。 このパラメーターは、overlap_type パラメーターが INTERSECT、WITHIN_A_DISTANCE、CONTAINS、または WITHIN のいずれかに設定された場合にのみ有効です。
|
Linear Unit
|
|
added_where_clause
(オプション)
|
ダイアグラムに追加されるフィーチャのフィルターに使用する SQL クエリー。 SQL クエリーを使用しない場合、指定した既存のフィーチャに空間的に関連する指定のソース フィーチャクラスに基づくフィーチャがダイアグラムにアペンドされます。
|
SQL Expression
|
|
existing_where_clause
(オプション)
|
ダイアグラムに存在しているフィーチャのフィルターに使用する SQL クエリー。 SQL クエリーを使用しない場合、ダイアグラムに存在する指定のソース クラスに基づくフィーチャが考慮されます。
|
SQL Expression
|
|
description
(オプション)
|
ルールの説明。
|
String
|
派生した出力
|
名前
|
説明
|
データ タイプ
|
|
out_utility_network
|
更新されたユーティリティー ネットワークまたはトレース ネットワーク。
|
Utility Network; Trace Network
|
|
out_template_name
|
ダイアグラム テンプレートの名前。
|
String
|
コードのサンプル
AddSpatialQueryRule の例 (スタンドアロン スクリプト)
生成されたダイアグラム内で変電所と交差するすべての二次送電線を体系的に追加する空間クエリー ルールを MyTemplate1 テンプレートに追加します。
import arcpy
input_Network = "D:/MyProjectLocation/MyDatabaseConnection.sde/MyDatabase.MAP.Electric/MyDatabase.MAP.Electric"
input_DistributionLine = "D:/MyProjectLocation/MyDatabaseConnection.sde/MyDatabase.MAP.Electric/MyDatabase.MAP.ElectricDistributionLine"
input_StructureBoundary = "D:/MyProjectLocation/MyDatabaseConnection.sde/MyDatabase.MAP.Electric/MyDatabase.MAP.ElectricStructureBoundary"
input_DiagramTemplate = "MyTemplate1"
arcpy.nd.AddSpatialQueryRule(input_Network, input_DiagramTemplate,
'ACTIVE', input_DistributionLine, 'INTERSECT',
input_StructureBoundary, None, 'ASSETGROUP=6',
'ASSETGROUP=3')
環境
このツールは、ジオプロセシング環境を一切使用しません。
ライセンス情報
- Basic: いいえ
- Standard: はい
- Advanced: はい