ターミナル構成の追加 (Add Terminal Configuration) (ユーティリティ ネットワーク)

サマリー

ターミナル構成を既存のユーティリティ ネットワークに追加します。

ターミナルが備わったネットワーク フィーチャは、デバイスまたはジャンクション オブジェクトの内部接続性の有効な構成を定義する制限を必要とします。 このツールを使用すると、新しいターミナル構成をユーティリティ ネットワークに追加し、[ターミナル構成の設定 (Set Terminal Configuration)] ツールを使ってアセット グループ レベルまたはアセット タイプ レベルでクラスに割り当てることができます。

使用法

  • ターミナルをデバイスまたはジャンクション オブジェクト上に構成するには、ターミナル構成を割り当てます。 ターミナルをサポートする各アセット タイプに割り当てることができるターミナル構成は 1 つだけです。

  • フィーチャまたはオブジェクト上のターミナルでは、方向性を設定することができます。 [一方向] (一方向の流れしか許可されない) または [双方向] (双方向の流れが許可される) に設定できます。

  • 最小 2 個のターミナルを必ず指定しなくてはなりません。最大で 8 個までのターミナルを指定できます。 ターミナル名は、「high-side」や「source-side」などの記述的な名前にします。

  • ターミナルの数が 3 個か 4 個のフィーチャでは、有効なパスを定義できます。 これは、一対のターミナル間の流路を制限するのに必要となる複雑な開閉装置を取り扱うことが可能な設計になっています。 たとえば、A、B、C、および D という名前のターミナルが備わった 4 つのターミナル デバイスで、A から B および C への流れは許可するが、A から D への流れは許可しないように設定するとします。

  • ネットワーク トポロジを「無効化」する必要があります。

  • エンタープライズ ジオデータベースを操作する場合、次の要件があります。

    • このツールを実行するには、デフォルト バージョンに接続する必要があります。
      • デフォルト バージョンに接続されているその他のセッションでは、有効化操作の実行中に検証操作も有効化操作も実行できません。
    • [入力ユーティリティ ネットワーク] パラメーター値は、「データベース ユーティリティ ネットワークの所有者」として、確立されたデータベース コネクションから取得する必要があります。
    • 接続された ArcGIS Enterprise ポータル アカウントは、「ポータル ユーティリティ ネットワークの所有者」である必要があります。

パラメーター

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

ターミナル構成を追加する入力ユーティリティ ネットワーク。

Utility Network; Utility Network Layer
名前

ターミナル構成の名前。

String
方向性

ターミナル構成の方向性を指定します。 一方向通過可能性モデルは、ターミナルの流れが 1 方向にのみ進むことを意味します。 双方向通過可能性モデルは、ターミナルが双方向の流れを許可することを意味します。

  • 一方向一方向の流れだけが許可されます。
  • 双方向双方向の流れが許可されます。
String
ターミナル
(オプション)

各方向ターミナルの名前と有向フロー。 最小 2 個のターミナルを必ず指定しなくてはなりません。最大で 8 個まで指定できます。 各ターミナルの名前が 32 文字を超えてはなりません。 [方向性] パラメーター値が [一方向] の場合、このパラメーターは必須です。

  • [名前] - ターミナルの名前を指定します。
  • [上流] - ターミナルが上流か下流かを示します。
    • オン - ターミナルは上流です。
    • オフ - ターミナルは下流です。
Value Table
ターミナル
(オプション)

各双方向ターミナルの名前。 最小 2 個のターミナルを必ず指定しなくてはなりません。最大で 8 個まで指定できます。 各ターミナルの名前が 32 文字を超えてはなりません。 [方向性] パラメーター値が [双方向] (Python では traversability_model = "BIDIRECTIONAL") の場合、このパラメーターは必須です。

Value Table
有効なパス
(オプション)

ターミナル構成の名前と有効なパス。 双方向通過可能性では、3 つまたは 4 つのターミナルがある場合、このパラメーターが必須です。 双方向通過可能性を使用している場合、有効な構成にするには、いずれかのターミナルを上流にする必要があります。 有効なパスを作成して、デバイスまたはジャンクション オブジェクト内のどのパスがリソースの流れに適しているかを示す必要があります。 有効なパスごとに名前と値を指定します。

  • [名前] - 有効なパスの名前。
  • [値] - 有効なパスの値。
    • [すべて] - すべてのパスが有効であることを示すオプションを作成するには、[すべて] の値を入力します。
    • [なし] - どのパスも有効でないことを示すオプションを作成するには、[なし] の値を入力します。
    • [ターミナル ペア] - 単一のターミナル ペアか、ターミナル ペアのコレクションを入力します。 単一のターミナル ペアを入力するには、1 つのターミナルから別のターミナルへのパスをハイフンで区切って指定します (A-B など)。 ターミナル ペアのコレクションを入力するには、カンマ区切りで指定します (A-B, A-C など)。
Value Table
デフォルト パス
(オプション)

有効な構成のデフォルト パス。 このパスは、新しいフィーチャ (該当するターミナル構成がそのフィーチャのアセット タイプに割り当てられている) に割り当てられます。 有効なパスを指定されない場合、デフォルト パスである [すべて] が使用されます。

  • すべてすべてのパスが有効です。 これがデフォルトです。
  • なしどのパスも有効ではありません。
String

派生した出力

ラベル説明データ タイプ
更新されたユーティリティ ネットワーク

更新されるユーティリティ ネットワーク。

Utility Network

arcpy.un.AddTerminalConfiguration(in_utility_network, terminal_configuration_name, traversability_model, {terminals_directional}, {terminals_bidirectional}, {valid_paths}, {default_path})
名前説明データ タイプ
in_utility_network

ターミナル構成を追加する入力ユーティリティ ネットワーク。

Utility Network; Utility Network Layer
terminal_configuration_name

ターミナル構成の名前。

String
traversability_model

ターミナル構成の方向性を指定します。 一方向通過可能性モデルは、ターミナルの流れが 1 方向にのみ進むことを意味します。 双方向通過可能性モデルは、ターミナルが双方向の流れを許可することを意味します。

  • DIRECTIONAL一方向の流れだけが許可されます。
  • BIDIRECTIONAL双方向の流れが許可されます。
String
terminals_directional
[[name, upstream],...]
(オプション)

各方向ターミナルの名前と有向フロー。 最小 2 個のターミナルを必ず指定しなくてはなりません。最大で 8 個まで指定できます。 各ターミナルの名前が 32 文字を超えてはなりません。 traversability_model パラメーター値が DIRECTIONAL の場合、このパラメーターは必須です。

  • Name - ターミナルの名前を指定します。
  • Upstream - ターミナルが上流か下流かを示します。
    • True - ターミナルは上流です。
    • False - ターミナルは下流です。
Value Table
terminals_bidirectional
[[name],...]
(オプション)

各双方向ターミナルの名前。 最小 2 個のターミナルを必ず指定しなくてはなりません。最大で 8 個まで指定できます。 各ターミナルの名前が 32 文字を超えてはなりません。 [方向性] パラメーター値が [双方向] (Python では traversability_model = "BIDIRECTIONAL") の場合、このパラメーターは必須です。

Value Table
valid_paths
[[Name, [Value]],...]
(オプション)

ターミナル構成の名前と有効なパス。 双方向通過可能性では、3 つまたは 4 つのターミナルがある場合、このパラメーターが必須です。 双方向通過可能性を使用している場合、有効な構成にするには、いずれかのターミナルを上流にする必要があります。 有効なパスを作成して、デバイスまたはジャンクション オブジェクト内のどのパスがリソースの流れに適しているかを示す必要があります。 有効なパスごとに名前と値を指定します。

  • [名前] - 有効なパスの名前。
  • [値] - 有効なパスの値。
    • [すべて] - すべてのパスが有効であることを示すオプションを作成するには、[すべて] の値を入力します。
    • [なし] - どのパスも有効でないことを示すオプションを作成するには、[なし] の値を入力します。
    • [ターミナル ペア] - 単一のターミナル ペアか、ターミナル ペアのコレクションを入力します。 単一のターミナル ペアを入力するには、1 つのターミナルから別のターミナルへのパスをハイフンで区切って指定します (A-B など)。 ターミナル ペアのコレクションを入力するには、カンマ区切りで指定します (A-B, A-C など)。
Value Table
default_path
(オプション)

有効な構成のデフォルト パス。 このパスは、新しいフィーチャ (該当するターミナル構成がそのフィーチャのアセット タイプに割り当てられている) に割り当てられます。 有効なパスを指定されない場合、デフォルト パスである All が使用されます。

  • ALLすべてのパスが有効です。 これがデフォルトです。
  • NONEどのパスも有効ではありません。
String

派生した出力

名前説明データ タイプ
out_utility_network

更新されるユーティリティ ネットワーク。

Utility Network

コードのサンプル

AddTerminalConfiguration の例 1 (Python ウィンドウ)

3 つのターミナルを備えた双方向のターミナル構成を追加します。

import arcpy
arcpy.AddTerminalConfiguration_un('Electric Utility Network', 'config1', 
                                  'BIDIRECTIONAL', None, 'A;B;C', 
                                  'Top A-B;Bottom A-C', 'Top')
AddTerminalConfiguration の例 2 (Python ウィンドウ)

3 つのターミナルを備えた一方向のターミナル構成を追加します。

import arcpy
arcpy.AddTerminalConfiguration_un('Electric Utility Network', 'config2', 
                                  'DIRECTIONAL', 'A true;B true;C false', None, 
                                  'Top A-B;Bottom A-C', 'Bottom')
AddTerminalConfiguration の例 3 (Python ウィンドウ)

3 つのターミナルを備えた一方向のターミナル構成を追加します。 有効なパスは、ターミナル ペアのコレクションを使用して指定します。

import arcpy
arcpy.AddTerminalConfiguration_un('Electric Utility Network', 'config3', 
                                  'DIRECTIONAL', 'A true;B false;C false', None, 
                                  "AB A-B;ABAC 'A-B;A-C'", 'AB')

環境

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

ライセンス情報

  • Basic: No
  • Standard: Yes
  • Advanced: Yes

関連トピック