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

概要

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

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

注意:

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

メモ:

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

使用法

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

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

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

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

構文

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
(オプション)

評価される空間リレーションシップ。

  • 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 パラメーターが 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

更新されたユーティリティ ネットワークまたはトレース ネットワーク。

ユーティリティ ネットワーク、トレース ネットワーク
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.AddSpatialQueryRule_nd(input_Network, input_DiagramTemplate, 
                             'ACTIVE', input_DistributionLine, 'INTERSECT',
                             input_StructureBoundary, None, 'ASSETGROUP=6', 
                             'ASSETGROUP=3')

環境

このツールは、ジオプロセシング環境を使用しません。

ライセンス情報

  • Basic: いいえ
  • Standard: はい
  • Advanced: はい

関連トピック