空間クエリ ルールの追加 (Add Spatial Query Rule) (ネットワーク ダイアグラム)

サマリー

ダイアグラムに現在表示されているネットワーク フィーチャを基準にした位置に基づいて新しいネットワーク フィーチャをダイアグラムに自動的に追加するダイアグラム ルールを追加します。

ネットワーク ダイアグラムを構築するための空間クエリ ルールの使用の詳細

注意:

このツールは、構成および管理ツールです。

注意:

このツールは、入力ダイアグラム テンプレートに基づく、既存のダイアグラムの一貫性に影響を与えます。 更新されるまで、既存のダイアグラムは、すべて一貫性なしになり、一貫性警告アイコン 更新するダイアグラム が表示されます。

使用法

  • このツールは、ユーティリティ ネットワーク サービスまたはトレース ネットワーク サービスを使用する場合、サポートされません。 ファイルまたはモバイル ジオデータベース内のユーティリティ ネットワークまたはトレース ネットワークを使用するか、エンタープライズ ジオデータベース内のユーティリティ ネットワークまたはトレース ネットワークへのデータベース コネクションを使用する必要があります。 エンタープライズ ジオデータベースを操作する場合、次の要件があります。

  • 空間検索ルールは、ダイアグラムに現在存在しているネットワーク フィーチャを基準にした位置に基づいて、新しいネットワーク フィーチャを検出し、新たに検出されたフィーチャをネットワーク ダイアグラムに追加するために使用されます。

  • このルールが連動するネットワーク フィーチャは同じフィーチャクラスに基づいています。そのため、SQL クエリ式を使用してこれらのフィーチャをフィルタリングできます。

  • 追加されるネットワーク フィーチャは同じフィーチャクラスに基づいています。そのため、SQL クエリ式を使用してこれらのフィーチャをフィルタリングできます。

パラメーター

ラベル説明データ タイプ
入力ネットワーク

変更するダイアグラム テンプレートを含むユーティリティ ネットワークまたはトレース ネットワーク。

Utility Network; Trace Network
入力ダイアグラム テンプレート

変更するダイアグラム テンプレートの名前。

String
アクティブ

指定したテンプレートに基づくダイアグラムの生成および更新時に、ルールを有効にするかどうかを指定します。

  • オン - 追加されたルールが、入力テンプレートに基づくダイアグラムの生成および更新時に有効になります。 これがデフォルトです。
  • オフ - 追加されたルールが、入力テンプレートに基づくダイアグラムの生成または更新時に有効になりません。

Boolean
フィーチャの追加

フィーチャを追加するソース フィーチャクラス。

Feature Class
リレーションシップ
(オプション)

フィーチャ間の空間リレーションシップを指定します。

  • インターセクト (Intersect)[フィーチャの追加] ソース フィーチャクラスのフィーチャは、[既存のフィーチャ] の 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

指定したテンプレートに基づくダイアグラムの生成および更新時に、ルールを有効にするかどうかを指定します。

  • ACTIVE追加されたルールが、入力テンプレートに基づくダイアグラムの生成および更新時に有効になります。 これがデフォルトです。
  • INACTIVE追加されたルールが、入力テンプレートに基づくダイアグラムの生成および更新時に有効になりません。
Boolean
added_features

フィーチャを追加するソース フィーチャクラス。

Feature Class
overlap_type
(オプション)

評価される空間リレーションシップを指定します。

  • INTERSECTadded_features ソース フィーチャクラスのフィーチャは、existing_features の 1 つと交差する場合にダイアグラムに追加されます。 これがデフォルトです。
  • WITHIN_A_DISTANCEadded_features ソース フィーチャクラスのフィーチャは、existing_features の 1 つから指定の距離 (ユークリッド距離) 内にある場合にダイアグラムに追加されます。 search_distance パラメーターを使用して、距離を指定します。
  • CONTAINSadded_features ソース フィーチャクラスのフィーチャは、existing_features のフィーチャを含んでいるか、それらに含まれている場合に、ダイアグラムに追加されます。
  • WITHINadded_features ソース フィーチャクラスのフィーチャは、existing_features の範囲内にある場合にダイアグラムに追加されます。
  • BOUNDARY_TOUCHESadded_features ソース フィーチャクラスのフィーチャは、existing_features の 1 つに接する境界線がある場合にダイアグラムに追加されます。 existing_features がラインまたはポリゴンであるとき、added_features の境界線は、existing_features の 1 つの境界線と接することができるだけで、入力フィーチャのいずれの部分も existing_features の 1 つの境界線と重なることはできません。
  • SHARE_A_LINE_SEGMENT_WITHadded_features ソース フィーチャクラスのフィーチャは、existing_features の 1 つとライン セグメントを共有する場合にダイアグラムに追加されます。 追加されるフィーチャおよび既存のフィーチャは、ラインまたはポリゴンのどちらかでなければなりません。
  • CROSSED_BY_THE_OUTLINE_OFadded_features ソース フィーチャクラスのフィーチャは、existing_features の 1 つのアウトラインと交差する場合にダイアグラムに追加されます。 追加されるフィーチャおよび既存のフィーチャは、ラインまたはポリゴンのどちらかでなければなりません。 existing_features としてポリゴンが使用される場合には、ポリゴンの境界線 (ライン) が使用されます。 ポイントで交差するラインは追加されますが、ライン セグメントを共有するラインは追加されません。
String
existing_features

空間クエリを実行するソース フィーチャクラス。

Feature Class
search_distance
(オプション)

existing_features パラメーターのフィーチャと added_features パラメーターのフィーチャの間の距離。 このパラメーターは、overlap_type パラメーターが INTERSECTWITHIN_A_DISTANCECONTAINS、または 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: No
  • Standard: Yes
  • Advanced: Yes

関連トピック