概要
ユーティリティ ネットワーク内のサブネットワークのドメイン ネットワーク層のプロパティを設定します。
層に追加するフィーチャのタイプを制限するには、デバイス、ライン、ジャンクション、エッジ オブジェクト、およびジャンクション オブジェクト クラスのから有効なアセット タイプを定義します。有効なアセット タイプの定義では、特定の層のサブネットワークに追加できるフィーチャのタイプを制限して、データの正確性を高めることができます。
構成パラメーターは、サブネットワークに対してトレースを実行する場合のプロパティの設定に使用されます。
使用法
このツールでは、層のサブネットワーク定義の設定と変更も実行できます。層のサブネットワーク定義の値を変更するには、パラメーター値を変更して、このツールをもう一度実行します。
ネットワーク トポロジを無効化する必要があります。
- エンタープライズ ジオデータベースを操作する場合、次の要件が満たされている必要があります。
- 接続された ArcGIS Enterprise ポータル アカウントは、ポータル ユーティリティ ネットワークの所有者である必要があります。
- [入力ユーティリティ ネットワーク] パラメーター値は、データベース ユーティリティ ネットワークの所有者として、確立されたデータベース接続から取得する必要があります。
- このツールは、実行時にデフォルト バージョンに接続する必要があります。
構文
arcpy.un.SetSubnetworkDefinition(in_utility_network, domain_network, tier_name, support_disjoint_subnetwork, {valid_devices}, {valid_subnetwork_controller}, {valid_lines}, {aggregated_line}, {diagram_template}, {summaries}, {condition_barriers}, {function_barriers}, {include_barriers}, {traversability_scope}, {propagators}, {update_structure_features}, {update_container_features}, {edit_mode_for_default_version}, {edit_mode_for_named_version}, {valid_junctions}, {valid_junction_objects}, {valid_junction_object_subnetwork_controller}, {valid_edge_objects}, {manage_subnetwork_isdirty}, {include_containers}, {include_content}, {include_structures}, {validate_locatability})
パラメーター | 説明 | データ タイプ |
in_utility_network | 層のサブネットワークが属している入力ユーティリティ ネットワーク。 | Utility Network; Utility Network Layer |
domain_network | 層が属しているドメイン ネットワーク。 | String |
tier_name | サブネットワークが属している層の名前。 | String |
support_disjoint_subnetwork | 分断されているサブネットワークが入力層でサポートされているかどうかを示します。分断されているサブネットワークは、同じ層に属しており、同じサブネットワーク名が割り当てられているが、通過することができない 2 つ以上のサブネットワークです。このオプションは、パーティション型の層定義を持つドメイン ネットワークの層に対してのみ利用できます。階層型の層定義を持つドメイン ネットワークの層では、分断されているサブネットワークをサポートするために、この層プロパティは常に SUPPORT_DISJOINT に設定されます。
| Boolean |
valid_devices [valid_devices,...] (オプション) | サブネットワークに有効なデバイスとして識別されるアセット グループとアセット タイプの組み合わせ。 | String |
valid_subnetwork_controller [valid_subnetwork_controller,...] (オプション) | サブネットワークで有効なデバイス ネットワーク コントローラーとして識別されるアセット グループとアセット タイプの組み合わせ。 | String |
valid_lines [valid_lines,...] (オプション) | サブネットワークに有効なラインとして識別されるアセット グループとアセット タイプの組み合わせ。 | String |
aggregated_line [aggregated_line,...] (オプション) | SubnetLine フィーチャを生成するために集約されるジオメトリを含む有効なライン。このリストは、[valid_lines] パラメーターで指定された値のサブセットです。 | String |
diagram_template [diagram_template,...] (オプション) | サブネットワークごとにサブネットワーク システム ダイアグラムの生成に使用されるテンプレート。 | String |
summaries [[Function, Attribute, Filter Name, Filter Operator, Filter Type, Filter Value, Summary Attribute],...] (オプション) | SubnetLine フィーチャを挿入または更新した場合に関数の結果を保存するサマリー フィールドを設定します。 サマリーの構成は次のとおりです。
サマリーの Function の値オプションは次のとおりです。
サマリーの Filter Operator の値オプションは次のとおりです。
サマリーの Filter Type の値オプションは次のとおりです。
| Value Table |
condition_barriers [[Name, Operator, Type, Value, Combine Using],...] (オプション) | ネットワーク属性との比較またはカテゴリ文字列のチェックに基づいて、フィーチャに対して通過可能性バリア条件を設定します。条件バリアは、ネットワーク属性、演算子とタイプ、および属性値を使用します。たとえば、フィーチャが Device Status の特定の値と等しい Open 属性を持っている場合に、トレースを停止します。フィーチャがこの条件を満たしている場合、トレースが停止します。複数の属性を使用している場合、[結合方法] パラメーターを使用して [And] 条件および [Or] 条件を定義することができます。 条件バリアの構成は次のとおりです。
条件バリアの [operator] の値は次のとおりです。
条件バリアの Type の値オプションは次のとおりです。
[Combine Using] の値は次のとおりです。
| Value Table |
function_barriers [[Function, Attribute, Operator, Value, Use Local Values],...] (オプション) | 関数に基づいて、フィーチャに対する通過可能性バリアを設定します。関数バリアを使用して、始点からトレースが移動できる距離の制限としてそのような設定を行うか、トレースを停止するための最大値を設定することができます。たとえば、通過した各ラインの長さが、それまでに移動した合計距離に追加されます。移動した全長が指定された値に達した場合、トレースが停止します。 関数バリアの構成は次のとおりです。
関数バリアの [function] 値のオプションは次のとおりです。
関数バリアの [operator] 値のオプションは次のとおりです。
関数バリア Use Local Values には次の選択肢があります。
| Value Table |
include_barriers (オプション) | 通過可能性バリア フィーチャがトレース結果に含まれるかどうかを指定します。通過可能性バリアは、サブネットワーク定義で事前に設定されている場合でも任意指定です。
| Boolean |
traversability_scope (オプション) | 適用する通過可能性のタイプ。通過可能性範囲は、通過可能性がジャンクション、エッジ、またはその両方のいずれに適用されるかを決定します。たとえば、Device Status が Open であり、通過可能性の範囲がエッジのみに設定されている場合にトレースを停止するように条件バリアを定義すると、トレースでオープン デバイスが検出された場合でも、Device Status はジャンクションにしか適用されないため、トレースは停止しません。つまり、このパラメーターは、トレースで、ジャンクション、エッジ、またはその両方を無視するかどうかを示します。
| String |
propagators [[Attribute, Substitution Attribute, Function, Operator, Value, Propagated Attribute],...] (オプション) | 伝播させるネットワーク属性、およびトレース中に伝播がどのように発生するかを指定します。伝播されるクラス属性は、サブネットワーク内の他のフィーチャに広められる、サブネットワーク コントローラーの重要な値を示します。たとえば、配電モデルでは、位相値を伝播することができます。 プロパゲーターの構成は次のとおりです。
プロパゲーターの function の値オプションは次のとおりです。
プロパゲーターの operator の値オプションは次のとおりです。
メモ:このパラメーターは Python でのみ使用できます。 | Value Table |
update_structure_features (オプション) | 構造物ネットワーク格納器に対してサポートされているサブネットワーク名属性が、サブネットワーク更新プロセスによって更新されるかどうかを指定します。
メモ:このパラメーターには、ユーティリティ ネットワーク バージョン 4 以降が必要です。 | Boolean |
update_container_features (オプション) | ドメイン ネットワーク格納器に対してサポートされているサブネットワーク名が、サブネットワーク更新プロセスによって更新されるかどうかを指定します。
メモ:このパラメーターには、ユーティリティ ネットワーク バージョン 4 以降が必要です。 | Boolean |
edit_mode_for_default_version (オプション) | デフォルト バージョンでファイル ジオデータベースを使用してサブネットワークを更新する場合の編集モードを指定します。
メモ:このパラメーターには、ユーティリティ ネットワーク バージョン 4 以降が必要です。 | String |
edit_mode_for_named_version (オプション) | 名前付きバージョンでサブネットワークを更新する場合の編集モードを指定します。
メモ:このパラメーターには、ユーティリティ ネットワーク バージョン 4 以降が必要です。エンタープライズ ジオデータベースのみに、このパラメーターを適用できます。 | String |
valid_junctions [valid_junctions,...] (オプション) | サブネットワークに有効なジャンクションとして識別されるアセット グループとアセット タイプの組み合わせ。 メモ:このパラメーターには、ユーティリティ ネットワーク バージョン 4 以降が必要です。 | String |
valid_junction_objects [valid_junction_objects,...] (オプション) | サブネットワークに有効なジャンクション オブジェクトとして識別されるアセット グループとアセット タイプの組み合わせ。 メモ:このパラメーターには、ユーティリティ ネットワーク バージョン 4 以降が必要です。 | String |
valid_junction_object_subnetwork_controller [valid_junction_object_subnetwork_controller,...] (オプション) | サブネットワークに有効なジャンクション オブジェクト サブネットワーク コントローラーとして識別されるアセット グループとアセット タイプの組み合わせ。 メモ:このパラメーターには、ユーティリティ ネットワーク バージョン 4 以降が必要です。 | String |
valid_edge_objects [valid_edge_objects,...] (オプション) | サブネットワークに有効なエッジ オブジェクトとして識別されるアセット グループとアセット タイプの組み合わせ。 メモ:このパラメーターには、ユーティリティ ネットワーク バージョン 4 以降が必要です。 | String |
manage_subnetwork_isdirty (オプション) | サブネットワーク テーブル内の Is dirty 属性がサブネットワーク更新操作によって管理されるかどうかを指定します。層にサブネットワーク コントローラーが定義されていない場合、このパラメーターはデフォルトのオプション NOT_MANAGE を使用します。
メモ:このパラメーターには、ユーティリティ ネットワーク バージョン 5 以降が必要です。 | Boolean |
include_containers (オプション) | 格納器フィーチャおよびオブジェクトをトレース結果に含めるかどうかを指定します。
このパラメーターには、ユーティリティ ネットワーク バージョン 5 以降が必要です。 | Boolean |
include_content (オプション) | 格納器の格納物をトレース結果に含めるかどうかを指定します。
このパラメーターには、ユーティリティ ネットワーク バージョン 5 以降が必要です。 | Boolean |
include_structures (オプション) | 構造物フィーチャおよびオブジェクトをトレース結果に含めるかどうかを指定します。
このパラメーターには、ユーティリティ ネットワーク バージョン 5 以降が必要です。 | Boolean |
validate_locatability (オプション) | トレースまたはサブネットワーク更新操作中に、通過したオブジェクトの関連付け階層に、必要な格納の関連付け、付属物の関連付け、または接続性の関連付けがない非空間ジャンクション オブジェクトまたはエッジ オブジェクトが検出された場合、エラーが返されるかどうかを指定します。このオプションにより、トレースまたはサブネットワーク更新操作によって返される非空間オブジェクトを、フィーチャまたは他の配置可能オブジェクトとの関連付けを通じて配置できることが保証されます。
メモ:このパラメーターには、ユーティリティ ネットワーク バージョン 5 以降が必要です。 | Boolean |
派生した出力
名前 | 説明 | データ タイプ |
out_utility_network | 更新された入力ユーティリティ ネットワーク。 | ユーティリティ ネットワーク |
コードのサンプル
この例では、ElectricDistribution というサブネットワーク定義をドメイン内に設定します。
'''****************************************************************************
Name: SetSubnetworkDefinition.py
Description: This script sets the subnetwork definition for a tier in a Utility Network
Created by: Esri
****************************************************************************'''
# Import required modules
import arcpy
# Set local variables
in_utility_network = "ElectricDistribution"
domain_network = "ElecDist"
tier_name = "Medium Voltage"
support_disjoint_subnetwork = "SUPPORT_DISJOINT"
valid_devices = "'CircuitBreaker/Unknown';'CircuitBreaker/Air powered';'NetworkProtector/Unknown';'NetworkProtector/NetworkProtector';'Transformer/Unknown';'Transformer/Buck boost';'Transformer/Single-phase overhead';'Transformer/Single-phase padmounted';'Transformer/Three-phase padmounted';'Transformer/Power';'Transformer/Step';'Transformer/Vault'"
valid_subnetwork_controller = "'CircuitBreaker/Unknown';'CircuitBreaker/Air powered'"
valid_lines = "'Busbar/Unknown';'Busbar/Busbar';'Connector/Unknown';'Connector/Connector';'LowVoltage/Unknown';'LowVoltage/Overhead';'LowVoltage/Underground';'MediumVoltage/Unknown';'MediumVoltage/Single-phase overhead';'MediumVoltage/Two-phase overhead';'MediumVoltage/Three-phase overhead';'MediumVoltage/Single-phase underground';'MediumVoltage/Two-phase underground';'MediumVoltage/Three-phase underground';'IsolatedNeutral/Unknown';'IsolatedNeutral/Concentric neutral';'IsolatedNeutral/Neutral';'SubTransmission/Unknown';'SubTransmission/Overhead';'SubTransmission/Underground'"
aggregated_line = "'Busbar/Unknown';'Busbar/Busbar';'MediumVoltage/Unknown';'MediumVoltage/Single-phase overhead';'MediumVoltage/Two-phase overhead';'MediumVoltage/Three-phase overhead';'MediumVoltage/Single-phase underground';'MediumVoltage/Two-phase underground';'MediumVoltage/Three-phase underground'"
diagram_template = "Basic"
summaries = ""
condition_barriers = "'Device Status' IS_EQUAL_TO SPECIFIC_VALUE 'Opened' #"
function_barriers = ""
include_barriers = "INCLUDE_BARRIERS"
traversability_scope = "BOTH_JUNCTIONS_AND_EDGES"
propagators = ""
# Run the SetSubnetworkDefinition tool
arcpy.SetSubnetworkDefinition_un(in_utility_network,
domain_network,
tier_name,
support_disjoint_subnetwork,
valid_devices,
valid_subnetwork_controller,
valid_lines,
aggregated_line,
diagram_template,
summaries,
condition_barriers,
function_barriers,
include_barriers,
traversability_scope,
propagators)
環境
ライセンス情報
- Basic: いいえ
- Standard: はい
- Advanced: はい