サブネットワーク定義の設定 (Set Subnetwork Definition) (ユーティリティ ネットワーク)

サマリー

ユーティリティ ネットワーク内のサブネットワークのドメイン ネットワーク層のプロパティを設定します。

層に追加するフィーチャのタイプを制限するには、デバイス、ライン、ジャンクション、エッジ オブジェクト、およびジャンクション オブジェクト クラスのから有効なアセット タイプを定義します。 有効なアセット タイプの定義では、特定の層のサブネットワークに追加できるフィーチャのタイプを制限して、データの正確性を高めることができます。

構成パラメーターは、サブネットワークに対してトレースを実行する場合のプロパティの設定に使用されます。

サブネットワーク定義の設定の詳細

サブネットワーク管理の詳細

ユーティリティ ネットワークのトレースの詳細

使用法

  • このツールでは、層のサブネットワーク定義の設定と変更も実行できます。 層のサブネットワーク定義の値を変更するには、パラメーター値を変更して、このツールをもう一度実行します。

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

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

パラメーター

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

層のサブネットワークが属している入力ユーティリティ ネットワーク。

Utility Network; Utility Network Layer
ドメイン ネットワーク

層が属しているドメイン ネットワーク。

String
層の名前

サブネットワークが属している層の名前。

String
分断されているサブネットワークのサポート

分断されているサブネットワークが入力層でサポートされているかどうかを示します。 分断されているサブネットワークは、同じ層に属しており、同じサブネットワーク名が割り当てられているが、通過することができない 2 つ以上のサブネットワークです。 このオプションは、パーティション型の層定義を持つドメイン ネットワークの層に対してのみ利用できます。 階層型の層定義を含むドメイン ネットワーク内の層では、分断されているサブネットワークに対応できるように、常にこの層プロパティがオンに設定されています。

  • オン - 分断されているサブネットワークが入力層でサポートされています。
  • オフ - 分断されているサブネットワークが入力層でサポートされていません。 これがデフォルトです。

Boolean
有効なデバイス
(オプション)

サブネットワークに有効なデバイスとして識別されるアセット グループとアセット タイプの組み合わせ。

String
有効なデバイス サブネットワーク コントローラー
(オプション)

サブネットワークで有効なデバイス ネットワーク コントローラーとして識別されるアセット グループとアセット タイプの組み合わせ。

String
有効なライン
(オプション)

サブネットワークに有効なラインとして識別されるアセット グループとアセット タイプの組み合わせ。

String
サブネットライン フィーチャクラスの集約ライン
(オプション)

SubnetLine フィーチャを生成するために集約されるジオメトリを含む有効なライン。 このリストは、[有効なライン] パラメーターで指定された値のサブセットです。

String
サブネットワーク ダイアグラムのテンプレート
(オプション)

サブネットワークごとにサブネットワーク システム ダイアグラムの生成に使用されるテンプレート。

String
サマリー
(オプション)

SubnetLine フィーチャを挿入または更新したときの関数の結果を格納するためのサマリー属性フィールドを設定します。

サマリーの構成は次のとおりです。

  • [関数] - 複数の計算関数から選択します。
  • [属性] - システム内で定義された任意のネットワーク属性によってフィルタリングします。
  • [フィルター名] - 属性名によって関数の結果をフィルタリングします。
  • [フィルター演算子] - 複数の演算子から選択します。
  • [フィルター タイプ] - 複数のフィルター タイプから選択します。
  • [フィルター値] - 入力フィルター属性の特定の値を指定します。
  • [サマリー属性] - 関数の結果を維持する SubnetLine フィーチャクラス内のフィールド。選択された関数およびネットワーク属性タイプに応じて、ユーザーが追加したサブネットワーク属性のうちの適用可能なタイプのみが、このパラメーターで有効になります。サマリー結果を格納するフィールドが SubnetLine フィーチャクラスに存在しない場合、[フィールドの追加 (Add Field)] ツールを使用してそのフィールドを作成することができます。1 つのフィールドは 1 つのサマリーの結果のみをサポートします。そのため各サマリーは、それ専用の SubnetLine フィーチャクラス内のフィールドを必要とします。さまざまな関数の有効なフィールド タイプについては、次のマトリックスをご参照ください。
    選択された関数に基づく、サマリー属性フィールドの有効なフィールド タイプのマトリックス

サマリーの [関数] の値オプションは次のとおりです。

  • 最小値 - 入力値の最小値。
  • 最大値 - 入力値の最大値。
  • 加算 - 入力値の合計。
  • 平均値 - 入力値の平均値。
  • 個数 - フィーチャの個数。
  • 減算 - 値の差。

    サブネットワーク コントローラーおよびループ トレース タイプは、[減算] 関数をサポートしてません。

たとえば、始点フィーチャの値が 20 とします。次のフィーチャは 30 の値を持っています。[最小値] 関数を使用すると、結果が 20、最大値が 30、追加が 50、平均値が 25、個数が 2、減算が -10 になります。

サマリーの [フィルター演算子] の値オプションは次のとおりです。

  • 等しい - 属性と値が等しい。
  • 等しくない - 属性と値が等しくない。
  • より大きい - 属性は値より大きい。
  • 以上 - 属性は値以上。
  • より小さい - 属性は値より小さい。
  • 以下 - 属性は値以下。
  • 値を含む - 値のすべてのビットが属性内に存在するビット単位の論理積演算 (bitwise AND == value)。
  • 値を含まない - 値の一部のビットが属性内に存在しないビット単位の論理積演算 (bitwise AND != value)。
  • いずれかを含む - 値の少なくとも 1 つのビットが属性内に存在するビット単位の論理積演算 (bitwise AND == True)。
  • いずれも含まない - 値のビットが属性内に存在しないビット単位の論理積演算 (bitwise AND == False)。

サマリーの [フィルター タイプ] の値オプションは次のとおりです。

  • 特定の値 - 特定の値を基準にフィルタリングします。
  • ネットワーク属性 - ネットワーク属性を基準にフィルタリングします。

  • 平均値入力値の平均値。
  • 個数フィーチャの数。
  • 最大最大の入力値。
  • 最小最小の入力値。
  • 加算入力値の合計。
  • 減算入力値の差。 サブネットワーク コントローラーおよびループ トレース タイプは、[減算] 関数をサポートしていません。
  • と等しい属性と値が等しい。
  • と等しくない属性と値が等しくない。
  • より大きい属性が値より大きい。
  • 以上属性が値以上である。
  • より小さい属性が値より小さい。
  • 以下属性が値以下である。
  • 値を含む (ビット単位の論理積が値と等しい)値のすべてのビットが属性内に存在するビット単位の論理積演算 (bitwise AND == value)。
  • 値を含まない (ビット単位の論理積が値と等しくない)値の一部のビットが属性内に存在しないビット単位の論理積演算 (bitwise AND != value)。
  • いずれかを含む (ビット単位の論理積が True と等しい)値の少なくとも 1 つのビットが属性内に存在するビット単位の論理積演算 (bitwise AND == True)。
  • いずれも含まない (ビット単位の論理積が False と等しい)値のビットが属性内に存在しないビット単位の論理積演算 (bitwise AND == False)。
  • 特定の値特定の値によるフィルター。
  • ネットワーク属性ネットワーク属性によるフィルター。
Value Table
条件バリア
(オプション)

ネットワーク属性との比較またはカテゴリ文字列のチェックに基づいて、フィーチャに対して通過可能性バリア条件を設定します。条件バリアは、ネットワーク属性、演算子とタイプ、および属性値を使用します。たとえば、フィーチャが Device Status の特定の値と等しい Open 属性を持っている場合に、トレースを停止します。フィーチャがこの条件を満たしている場合、トレースが停止します。複数の属性を使用している場合、[結合方法] パラメーターを使用して [And] 条件および [Or] 条件を定義することができます。

条件バリアの構成は次のとおりです。

  • [名前] - システム内で定義された任意のネットワーク属性によってフィルタリングします。
  • [演算子] - 複数の演算子から選択します。
  • [種類] - [名前] パラメーターで指定された値から、特定の値またはネットワーク属性を選択します。
  • [値] - 演算子の値に基づいて処理を停止させる入力属性タイプの特定の値を指定します。
  • [結合方法] - 複数の属性を追加する場合にこの値を設定します。[And] 条件または [Or] 条件を使用して、これらを組み合わせることができます。

条件バリアの [演算子] の値オプションは次のとおりです。

  • 等しい - 属性と値が等しい。
  • 等しくない - 属性と値が等しくない。
  • より大きい - 属性は値より大きい。
  • 以上 - 属性は値以上。
  • より小さい - 属性は値より小さい。
  • 以下 - 属性は値以下。
  • 値を含む - 値のすべてのビットが属性内に存在するビット単位の論理積演算 (bitwise AND == value)。
  • 値を含まない - 値の一部のビットが属性内に存在しないビット単位の論理積演算 (bitwise AND != value)。
  • いずれかを含む - 値の少なくとも 1 つのビットが属性内に存在するビット単位の論理積演算 (bitwise AND == True)。
  • いずれも含まない - 値のビットが属性内に存在しないビット単位の論理積演算 (bitwise AND == False)。

条件バリアの [種類] の値オプションは次のとおりです。

  • 特定の値 - 特定の値を基準にフィルタリングします。
  • ネットワーク属性 - ネットワーク属性を基準にフィルタリングします。

  • と等しい属性と値が等しい。
  • と等しくない属性と値が等しくない。
  • より大きい属性が値より大きい。
  • 以上属性が値以上である。
  • より小さい属性が値より小さい。
  • 以下属性が値以下である。
  • 値を含む (ビット単位の論理積が値と等しい)値のすべてのビットが属性内に存在するビット単位の論理積演算 (bitwise AND == value)。
  • 値を含まない (ビット単位の論理積が値と等しくない)値の一部のビットが属性内に存在しないビット単位の論理積演算 (bitwise AND != value)。
  • いずれかを含む (ビット単位の論理積が True と等しい)値の少なくとも 1 つのビットが属性内に存在するビット単位の論理積演算 (bitwise AND == True)。
  • いずれも含まない (ビット単位の論理積が False と等しい)
  • 特定の値特定の値によるフィルター。
  • ネットワーク属性ネットワーク属性によるフィルター。
  • 論理積条件バリアを結合します。
  • 論理和いずれかの条件バリアが満たされている場合に使用します。
Value Table
関数バリア
(オプション)

関数に基づいて、フィーチャに対する通過可能性バリアを設定します。関数バリアを使用して、始点からトレースが移動できる距離の制限としてそのような設定を行うか、トレースを停止するための最大値を設定することができます。たとえば、通過した各ラインの長さが、それまでに移動した合計距離に追加されます。移動した全長が指定された値に達した場合、トレースが停止します。

関数バリアの構成は次のとおりです。

  • [関数] - 複数の計算関数から選択します。
  • [属性] - システム内で定義された任意のネットワーク属性によってフィルタリングします。
  • [演算子] - 複数の演算子から選択します。
  • [値] - 検出された時点で、処理を停止させる入力属性タイプの特定の値を指定します。
  • [ローカル値の使用] - グローバル値ではなく各方向の値を算出します (たとえば、[Shape length] の合計値を算出する関数バリアで、値が 4 以上になると、トレースが停止する場合)。グローバルなケースでは、2 の値を持つ 2 つのエッジを通過した後に、Shape length の 4 の合計値にすでに達したため、トレースが停止します。ローカル値を使用している場合は、各パスに沿ってローカル値が変化するため、トレースが続行します。
    • オン - ローカル値が使用されます。
    • オフ - グローバル値が使用されます。これがデフォルトです。

関数バリアの [関数] の値オプションは次のとおりです。

  • 最小値 - 入力値の最小値。
  • 最大値 - 入力値の最大値。
  • 加算 - 入力値の合計。
  • 平均値 - 入力値の平均値。
  • 個数 - フィーチャの個数。
  • 減算 - 値の差。

    サブネットワーク コントローラーおよびループ トレース タイプは、[減算] 関数をサポートしてません。

たとえば、始点フィーチャの値が 20 とします。次のフィーチャは 30 の値を持っています。[最小値] 関数を使用すると、結果が 20、最大値が 30、追加が 50、平均値が 25、個数が 2、減算が -10 になります。

関数バリアの [演算子] の値のオプションは次のとおりです。

  • 等しい - 属性と値が等しい。
  • 等しくない - 属性と値が等しくない。
  • より大きい - 属性は値より大きい。
  • 以上 - 属性は値以上。
  • より小さい - 属性は値より小さい。
  • 以下 - 属性は値以下。
  • 値を含む - 値のすべてのビットが属性内に存在するビット単位の論理積演算 (bitwise AND == value)。
  • 値を含まない - 値の一部のビットが属性内に存在しないビット単位の論理積演算 (bitwise AND != value)。
  • いずれかを含む - 値の少なくとも 1 つのビットが属性内に存在するビット単位の論理積演算 (bitwise AND == True)。
  • いずれも含まない - 値のビットが属性内に存在しないビット単位の論理積演算 (bitwise AND == False)。

  • 平均値入力値の平均値。
  • 個数フィーチャの数。
  • 最大最大の入力値。
  • 最小最小の入力値。
  • 加算入力値の合計。
  • 減算入力値の差。サブネットワーク コントローラーおよびループ トレース タイプは、[減算] 関数をサポートしていません。
  • と等しい属性と値が等しい。
  • と等しくない属性と値が等しくない。
  • より大きい属性が値より大きい。
  • 以上属性が値以上である。
  • より小さい属性が値より小さい。
  • 以下属性が値以下である。
  • 値を含む (ビット単位の論理積が値と等しい)値のすべてのビットが属性内に存在するビット単位の論理積演算 (bitwise AND == value)。
  • 値を含まない (ビット単位の論理積が値と等しくない)値の一部のビットが属性内に存在しないビット単位の論理積演算 (bitwise AND != value)。
  • いずれかを含む (ビット単位の論理積が True と等しい)値の少なくとも 1 つのビットが属性内に存在するビット単位の論理積演算 (bitwise AND == True)。
  • いずれも含まない (ビット単位の論理積が False と等しい)値のビットが属性内に存在しないビット単位の論理積演算 (bitwise AND == False)。
Value Table
バリア フィーチャを含める
(オプション)

通過可能性バリア フィーチャがトレース結果に含まれるかどうかを指定します。通過可能性バリアは、サブネットワーク定義内で設定済みである場合でもオプションです。このパラメーターは、ターミナルを含むデバイス フィーチャには適用されません。

  • オン - 通過可能性バリア フィーチャをトレース結果に含めます。これがデフォルトです。
  • オフ - 通過可能性バリア フィーチャをトレース結果に含めません。

Boolean
通過可能性の適用
(オプション)

適用する通過可能性のタイプです。通過可能性範囲は、通過可能性がジャンクションまたはエッジ、あるいはその両方のいずれに適用されるかを決定します。たとえば、Device Status が Open であり、通過可能性の範囲がエッジのみに設定されている場合にトレースを停止するように条件バリアを定義すると、トレースでオープン デバイスが検出された場合でも、Device Status はジャンクションにしか適用されないため、トレースは停止しません。言い換えると、このパラメーターは、ジャンクション、エッジ、またはその両方を無視するかどうかをトレースに指示します。

  • [ジャンクションとエッジの両方] - 通過可能性をジャンクションとエッジの両方に適用します。
  • [ジャンクションのみ] - 通過可能性をジャンクションのみに適用します。
  • [エッジのみ] - 通過可能性をエッジのみに適用します。

  • ジャンクションとエッジの両方通過可能性は、ジャンクションとエッジの両方に適用されます。 これがデフォルトです。
  • ジャンクションのみ通過可能性は、ジャンクションのみに適用されます。
  • エッジのみ通過可能性は、エッジのみに適用されます。
String
プロパゲーター
(オプション)
  • Propagate BITWISE_ANDあるフィーチャの値と次のフィーチャの値を比較します。
  • Propagate MIN最小値を取得します。
  • Propagate MAX最大値を取得します。
  • と等しい属性と値が等しい。
  • と等しくない属性と値が等しくない。
  • より大きい属性が値より大きい。
  • 以上属性が値以上である。
  • より小さい属性が値より小さい。
  • 以下属性が値以下である。
  • 値を含む (ビット単位の論理積が値と等しい)値のすべてのビットが属性内に存在するビット単位の論理積演算 (bitwise AND == value)。
  • 値を含まない (ビット単位の論理積が値と等しくない)値の一部のビットが属性内に存在しないビット単位の論理積演算 (bitwise AND != value)。
  • いずれかを含む (ビット単位の論理積が True と等しい)値の少なくとも 1 つのビットが属性内に存在するビット単位の論理積演算 (bitwise AND == True)。
  • いずれも含まない (ビット単位の論理積が False と等しい)値のビットが属性内に存在しないビット単位の論理積演算 (bitwise AND == False)。
Value Table
構造物ネットワーク格納器の更新
(オプション)

構造物ネットワーク格納器に対してサポートされているサブネットワーク名属性が、サブネットワーク更新プロセスによって更新されるかどうかを指定します。

  • オン - 構造物ネットワーク格納器が更新されます。 これがデフォルトです。
  • オフ - 構造物ネットワーク格納器が更新されません。

このパラメーターには、ユーティリティ ネットワーク バージョン 4 以降が必要です。

Boolean
ドメイン ネットワーク格納器の更新
(オプション)

ドメイン ネットワーク格納器に対してサポートされているサブネットワーク名が、サブネットワーク更新プロセスによって更新されるかどうかを指定します。

  • オン - ドメイン ネットワーク格納器が更新されます。 これがデフォルトです。
  • オフ - ドメイン ネットワーク格納器が更新されません。

このパラメーターには、ユーティリティ ネットワーク バージョン 4 以降が必要です。

Boolean
デフォルト バージョンの編集モード
(オプション)

デフォルト バージョンでファイル ジオデータベースを使用してサブネットワークを更新する場合の編集モードを指定します。

  • イベントを使用しないデフォルト バージョンでファイル ジオデータベース内のサブネットワーク更新にイベントを使用しません。 この編集モードでは、サブネットワーク名と伝達された所定の値が更新されます。 これがデフォルトです。
  • イベントを使用デフォルト バージョンでファイル ジオデータベース内のサブネットワーク更新にイベントを使用します。 サブネットワークの更新時、この編集モードでは、ジオデータベース機能 (属性ルール、編集情報の記録など) が実行され、該当するすべてのフィーチャとオブジェクトのサブネットワーク名と伝達された値が更新されます。
注意:

このパラメーターには、ユーティリティ ネットワーク バージョン 4 以降が必要です。

String
名前付きバージョンの編集モード
(オプション)

名前付きバージョンでサブネットワークを更新する場合の編集モードを指定します。

  • イベントを使用しない名前付きバージョンでのサブネットワーク更新にイベントを使用しません。 この編集モードでは、そのバージョンで編集されたフィーチャとオブジェクトのサブネットワーク名と伝達された所定の値が更新されます。 これがデフォルトです。
  • イベントを使用名前付きバージョンでのサブネットワーク更新にイベントを使用します。 サブネットワークの更新時、この編集モードでは、ジオデータベース機能 (属性ルール、編集情報の記録など) が実行され、該当するすべてのフィーチャとオブジェクトのサブネットワーク名と伝達された値が更新されます。
注意:

このパラメーターには、ユーティリティ ネットワーク バージョン 4 以降が必要です。エンタープライズ ジオデータベースのみに、このパラメーターを適用できます。

String
有効なジャンクション
(オプション)

サブネットワークに有効なジャンクションとして識別されるアセット グループとアセット タイプの組み合わせ。

注意:

このパラメーターには、ユーティリティ ネットワーク バージョン 4 以降が必要です。

String
有効なジャンクション オブジェクト
(オプション)

サブネットワークに有効なジャンクション オブジェクトとして識別されるアセット グループとアセット タイプの組み合わせ。

注意:

このパラメーターには、ユーティリティ ネットワーク バージョン 4 以降が必要です。

String
有効なジャンクション オブジェクト サブネットワーク コントローラー
(オプション)

サブネットワークに有効なジャンクション オブジェクト サブネットワーク コントローラーとして識別されるアセット グループとアセット タイプの組み合わせ。

注意:

このパラメーターには、ユーティリティ ネットワーク バージョン 4 以降が必要です。

String
有効なエッジ オブジェクト
(オプション)

サブネットワークに有効なエッジ オブジェクトとして識別されるアセット グループとアセット タイプの組み合わせ。

注意:

このパラメーターには、ユーティリティ ネットワーク バージョン 4 以降が必要です。

String
IsDirty の管理
(オプション)

サブネットワーク テーブル内の Is dirty 属性がサブネットワーク更新操作によって管理されるかどうかを指定します。

  • オン - Is dirty 属性がサブネットワーク更新操作によって管理されます。 これがデフォルトです。
  • オフ - Is dirty 属性がサブネットワーク更新操作によって管理されません。

このパラメーターには、ユーティリティ ネットワーク バージョン 5 以降が必要です。

Boolean
格納器を含める
(オプション)

格納器フィーチャおよびオブジェクトをトレース結果に含めるかどうかを指定します。

  • オン - 格納器フィーチャおよびオブジェクトをトレース結果に含めます。
  • オフ - 格納器フィーチャおよびオブジェクトをトレース結果に含めません。 これがデフォルトです。

このパラメーターには、ユーティリティ ネットワーク バージョン 5 以降が必要です。

Boolean
格納物を含める
(オプション)

格納器の格納物をトレース結果に含めるかどうかを指定します。

  • オン - 格納器フィーチャおよびオブジェクトの格納物をトレース結果に含めます。
  • オフ - 格納器フィーチャおよびオブジェクトの格納物をトレース結果に含めません。 これがデフォルトです。

このパラメーターには、ユーティリティ ネットワーク バージョン 5 以降が必要です。

Boolean
構造物を含める
(オプション)

構造物フィーチャおよびオブジェクトをトレース結果に含めるかどうかを指定します。

  • オン - 構造物フィーチャおよびオブジェクトをトレース結果に含めます。
  • オフ - 構造物フィーチャおよびオブジェクトをトレース結果に含めません。 これがデフォルトです。

このパラメーターには、ユーティリティ ネットワーク バージョン 5 以降が必要です。

Boolean
配置可能性の整合チェック
(オプション)

トレースまたはサブネットワーク更新操作中に、通過したオブジェクトの関連付け階層に、必要な格納の関連付け、付属物の関連付け、または接続性の関連付けがない非空間ジャンクション オブジェクトまたはエッジ オブジェクトが検出された場合、エラーが返されるかどうかを指定します。 このパラメーターにより、トレースまたはサブネットワーク更新操作によって返される非空間オブジェクトを、フィーチャまたは他の配置可能オブジェクトとの関連付けを通じて配置できるようになります。

  • オン - 通過したオブジェクトの関連付け階層に、必要な格納の関連付け、付属物の関連付け、または接続性の関連付けがない非空間ジャンクション オブジェクトまたはエッジ オブジェクトが検出された場合、エラーが返されます。
  • オフ - トレースは未配置のオブジェクトを確認せず、通過したオブジェクトの関連付け階層に未配置のオブジェクトが存在するかどうかに関係なく、結果を返します。 これがデフォルトです。

注意:

このパラメーターには、ユーティリティ ネットワーク バージョン 5 以降が必要です。

Boolean

派生した出力

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

更新された入力ユーティリティ ネットワーク。

Utility Network

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 に設定されます。

  • SUPPORT_DISJOINT分断されているサブネットワークが入力層でサポートされています。
  • NO_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] - 複数の計算関数から選択します。
  • [Attribute] - システム内で定義された任意のネットワーク属性によってフィルタリングします。
  • [Filter Name] - 属性名によって関数の結果をフィルター処理します。
  • [Filter Operator] - 複数の演算子から選択します。
  • [Filter Type] - さまざまなフィルター タイプの中から選択します。
  • [Filter Value] - 入力フィルター属性の値を指定します。
  • [Summary Attribute] - 関数の結果を維持する SubnetLine フィーチャクラス内のフィールド。 選択された関数およびネットワーク属性タイプに応じて、ユーザーが追加したサブネットワーク属性のうちの適用可能なタイプのみが、このパラメーターで有効になります。 サマリー結果を格納するフィールドが SubnetLine フィーチャクラスに存在しない場合、[フィールドの追加 (Add Field)] ツールを使用してそのフィールドを作成することができます。 1 つのフィールドは 1 つのサマリーの結果のみをサポートします。そのため各サマリーは、それ専用の SubnetLine フィーチャクラス内のフィールドを必要とします。 さまざまな関数の有効なフィールド タイプについては、次のマトリックスをご参照ください。選択された関数に基づく、サマリー属性フィールドの有効なフィールド タイプのマトリックス

サマリーの Function の値オプションは次のとおりです。

  • AVERAGE入力値の平均値。
  • COUNTフィーチャの数。
  • MAX最大の入力値。
  • MIN最小の入力値。
  • ADD入力値の合計。
  • SUBTRACT入力値の差。 サブネットワーク コントローラーおよびループ トレース タイプは、[減算] 関数をサポートしていません。

サマリーの Filter Operator の値オプションは次のとおりです。

  • IS_EQUAL_TO属性と値が等しい。
  • DOES_NOT_EQUAL属性と値が等しくない。
  • IS_GREATER_THAN属性が値より大きい。
  • IS_GREATER_THAN_OR_EQUAL_TO属性が値以上である。
  • IS_LESS_THAN属性が値より小さい。
  • IS_LESS_THAN_OR_EQUAL_TO属性が値以下である。
  • INCLUDES_THE_VALUES値のすべてのビットが属性内に存在するビット単位の論理積演算 (bitwise AND == value)。
  • DOES_NOT_INCLUDE_THE_VALUES値の一部のビットが属性内に存在しないビット単位の論理積演算 (bitwise AND != value)。
  • INCLUDES_ANY値の少なくとも 1 つのビットが属性内に存在するビット単位の論理積演算 (bitwise AND == True)。
  • DOES_NOT_INCLUDE_ANY値のビットが属性内に存在しないビット単位の論理積演算 (bitwise AND == False)。

サマリーの Filter Type の値オプションは次のとおりです。

  • SPECIFIC_VALUE特定の値によるフィルター。
  • NETWORK_ATTRIBUTEネットワーク属性によるフィルター。

bitwise 演算子の詳細

Value Table
condition_barriers
[[Name, Operator, Type, Value, Combine Using],...]
(オプション)

ネットワーク属性との比較またはカテゴリ文字列のチェックに基づいて、フィーチャに対して通過可能性バリア条件を設定します。条件バリアは、ネットワーク属性、演算子とタイプ、および属性値を使用します。たとえば、フィーチャが Device Status の特定の値と等しい Open 属性を持っている場合に、トレースを停止します。フィーチャがこの条件を満たしている場合、トレースが停止します。複数の属性を使用している場合、[結合方法] パラメーターを使用して [And] 条件および [Or] 条件を定義することができます。

条件バリアの構成は次のとおりです。

  • [Name] - システム内で定義された任意のネットワーク属性によってフィルタリングします。
  • [Operator] - 複数の演算子から選択します。
  • [Type] - name パラメーターで指定された値から特定の値またはネットワーク属性を選択します。
  • [Value] - 演算子の値に基づいて処理を停止させる入力属性タイプの特定の値を指定します。
  • [Combine Using] - 複数の属性を追加する場合にこの値を設定します。[And] 条件または [Or] 条件を使用して属性を結合することができます。

条件バリアの [operator] の値は次のとおりです。

  • IS_EQUAL_TO属性と値が等しい。
  • DOES_NOT_EQUAL属性と値が等しくない。
  • IS_GREATER_THAN属性が値より大きい。
  • IS_GREATER_THAN_OR_EQUAL_TO属性が値以上である。
  • IS_LESS_THAN属性が値より小さい。
  • IS_LESS_THAN_OR_EQUAL_TO属性が値以下である。
  • INCLUDES_THE_VALUES値のすべてのビットが属性内に存在するビット単位の論理積演算 (bitwise AND == value)。
  • DOES_NOT_INCLUDE_THE_VALUES値の一部のビットが属性内に存在しないビット単位の論理積演算 (bitwise AND != value)。
  • INCLUDES_ANY値の少なくとも 1 つのビットが属性内に存在するビット単位の論理積演算 (bitwise AND == True)。
  • DOES_NOT_INLCUDE_ANY値のビットが属性内に存在しないビット単位の論理積演算 (bitwise AND == False)。

bitwise 演算子の詳細

条件バリアの Type の値オプションは次のとおりです。

  • SPECIFIC_VALUE特定の値によるフィルター。
  • NETWORK_ATTRIBUTEネットワーク属性によるフィルター。

[Combine Using] の値は次のとおりです。

  • AND条件バリアを結合します。
  • ORいずれかの条件バリアが満たされている場合に使用します。

複数の式の使用方法の詳細

Value Table
function_barriers
[[Function, Attribute, Operator, Value, Use Local Values],...]
(オプション)

関数に基づいて、フィーチャに対する通過可能性バリアを設定します。関数バリアを使用して、始点からトレースが移動できる距離の制限としてそのような設定を行うか、トレースを停止するための最大値を設定することができます。たとえば、通過した各ラインの長さが、それまでに移動した合計距離に追加されます。移動した全長が指定された値に達した場合、トレースが停止します。

関数バリアの構成は次のとおりです。

  • [Function] - 複数の計算関数から選択します。
  • [Attribute] - システム内で定義された任意のネットワーク属性によってフィルタリングします。
  • [Operator] - 複数の演算子から選択します。
  • [Value] - 検出された時点で、処理を停止させる入力属性タイプの特定の値を指定します。
  • [Use Local Values] - グローバル値ではなく各方向の値を算出します (たとえば、形状の長さの合計値を算出する関数バリアで、値が 4 以上になると、トレースが停止する場合)。 グローバル値の場合は、値が 2 の 2 つのエッジを通過すると、形状の長さの合計値 4 にすでに到達するため、トレースが停止します。 ローカル値を使用している場合は、各パスに沿ってローカル値が変化するため、トレースが続行します。

関数バリアの [function] 値のオプションは次のとおりです。

  • AVERAGE入力値の平均値。
  • COUNTフィーチャの数。
  • MAX最大の入力値。
  • MIN最小の入力値。
  • ADD入力値の合計。
  • SUBTRACT入力値の差。サブネットワーク コントローラーおよびループ トレース タイプは、[減算] 関数をサポートしていません。

関数バリアの [operator] 値のオプションは次のとおりです。

  • IS_EQUAL_TO属性と値が等しい。
  • DOES_NOT_EQUAL属性と値が等しくない。
  • IS_GREATER_THAN属性が値より大きい。
  • IS_GREATER_THAN_OR_EQUAL_TO属性が値以上である。
  • IS_LESS_THAN属性が値より小さい。
  • IS_LESS_THAN_OR_EQUAL_TO属性が値以下である。
  • INCLUDES_THE_VALUES値のすべてのビットが属性内に存在するビット単位の論理積演算 (bitwise AND == value)。
  • DOES_NOT_INCLUDE_THE_VALUES値の一部のビットが属性内に存在しないビット単位の論理積演算 (bitwise AND != value)。
  • INCLUDES_ANY値の少なくとも 1 つのビットが属性内に存在するビット単位の論理積演算 (bitwise AND == True)。
  • DOES_NOT_INCLUDE_ANY値のビットが属性内に存在しないビット単位の論理積演算 (bitwise AND == False)。

bitwise 演算子の詳細

関数バリア Use Local Values には次の選択肢があります。

  • TRUEローカル値を使用します。
  • FALSEグローバル値を使用します。 これがデフォルトです。
Value Table
include_barriers
(オプション)

通過可能性バリア フィーチャがトレース結果に含まれるかどうかを指定します。 通過可能性バリアは、サブネットワーク定義で事前に設定されている場合でも任意指定です。

  • INCLUDE_BARRIERS通過可能性バリアをトレース結果に含めます。 これがデフォルトです。
  • EXCLUDE_BARRIERS通過可能性バリアをトレース結果に含めません。
Boolean
traversability_scope
(オプション)

適用される通過可能性のタイプ。 通過可能性範囲は、通過可能性がジャンクション、エッジ、またはその両方のいずれに適用されるかを決定します。 たとえば、Device Status が Open であり、通過可能性の範囲がエッジのみに設定されている場合にトレースを停止するように条件バリアを定義すると、トレースでオープン デバイスが検出された場合でも、Device Status はジャンクションにしか適用されないため、トレースは停止しません。 つまり、このパラメーターは、トレースで、ジャンクション、エッジ、またはその両方を無視するかどうかを示します。

  • BOTH_JUNCTIONS_AND_EDGES通過可能性は、ジャンクションとエッジの両方に適用されます。 これがデフォルトです。
  • JUNCTIONS_ONLY通過可能性は、ジャンクションのみに適用されます。
  • EDGES_ONLY通過可能性は、エッジのみに適用されます。
String
propagators
[[Attribute, Substitution Attribute, Function, Operator, Value, Propagated Attribute],...]
(オプション)

伝播させるネットワーク属性、およびトレース中に伝播がどのように発生するかを指定します。伝播されるクラス属性は、サブネットワーク内の他のフィーチャに広められる、サブネットワーク コントローラーの重要な値を示します。たとえば、配電モデルでは、位相値を伝播することができます。

プロパゲーターの構成は次のとおりです。

  • [Attribute] - システム内で定義された任意のネットワーク属性によってフィルタリングします。
  • [Substitution Attribute] - bitset ネットワーク属性値の代わりに、代替値を使用します。 代替は、反映されるネットワーク属性のビット数に基づいてエンコードされます。 代替は、フェーズ内の各ビットから別のマップへのマッピングです。 たとえば、フェーズ AC では、1 つの代替は、ビット A から B、ビット C から NULL へのマッピングです。 この例では、1010 (フェーズ AC) の代替は 0000-0010-0000-0000 (512) です。 代替によりマッピングが取得され、マッピングは、フェーズ A から B、フェーズ C から NULL に行われたのであり、その逆 (すなわち、フェーズ A から NULL、フェーズ C から B) ではないことがわかります。
  • [Function] - 複数の計算関数から選択します。
  • [Operator] - 複数の演算子から選択します。
  • [Value] - 演算子の値に基づいて処理を停止させる入力属性タイプの特定の値を指定します。
  • [Propagated Attribute] - 計算された反映値の保存に使用されるネットワーク クラス内のフィールドの名前です。 フィールド タイプは、Attribute 値で選択されたネットワーク属性のフィールド タイプと同じである必要があります。

プロパゲーターの function の値オプションは次のとおりです。

  • PROPAGATED_BITWISE_ANDあるフィーチャの値と次のフィーチャの値を比較します。
  • PROPAGATED_MIN最小値を取得します。
  • PROPAGATED_MAX最大値を取得します。

プロパゲーターの operator の値オプションは次のとおりです。

  • IS_EQUAL_TO属性と値が等しい。
  • DOES_NOT_EQUAL属性と値が等しくない。
  • IS_GREATER_THAN属性が値より大きい。
  • IS_GREATER_THAN_OR_EQUAL_TO属性が値以上である。
  • IS_LESS_THAN属性が値より小さい。
  • IS_LESS_THAN_OR_EQUAL_TO属性が値以下である。
  • INCLUDES_THE_VALUES値のすべてのビットが属性内に存在するビット単位の論理積演算 (bitwise AND == value)。
  • DOES_NOT_INCLUDE_THE_VALUES値の一部のビットが属性内に存在しないビット単位の論理積演算 (bitwise AND != value)。
  • INCLUDES_ANY値の少なくとも 1 つのビットが属性内に存在するビット単位の論理積演算 (bitwise AND == True)。
  • DOES_NOT_INCLUDE_ANY値のビットが属性内に存在しないビット単位の論理積演算 (bitwise AND == False)。

bitwise 演算子の詳細

注意:

このパラメーターは Python でのみ使用できます。

Value Table
update_structure_features
(オプション)

構造物ネットワーク格納器に対してサポートされているサブネットワーク名属性が、サブネットワーク更新プロセスによって更新されるかどうかを指定します。

  • UPDATE構造物ネットワーク格納器が更新されます。 これがデフォルトです。
  • NOT_UPDATE構造物ネットワーク格納器が更新されません。
注意:

このパラメーターには、ユーティリティ ネットワーク バージョン 4 以降が必要です。

Boolean
update_container_features
(オプション)

ドメイン ネットワーク格納器に対してサポートされているサブネットワーク名が、サブネットワーク更新プロセスによって更新されるかどうかを指定します。

  • UPDATEドメイン ネットワーク格納器が更新されます。 これがデフォルトです。
  • NOT_UPDATEドメイン ネットワーク格納器が更新されません。
注意:

このパラメーターには、ユーティリティ ネットワーク バージョン 4 以降が必要です。

Boolean
edit_mode_for_default_version
(オプション)

デフォルト バージョンでファイル ジオデータベースを使用してサブネットワークを更新する場合の編集モードを指定します。

  • WITHOUT_EVENTINGデフォルト バージョンでファイル ジオデータベース内のサブネットワーク更新にイベントを使用しません。 この編集モードでは、サブネットワーク名と伝達された所定の値が更新されます。 これがデフォルトです。
  • WITH_EVENTINGデフォルト バージョンでファイル ジオデータベース内のサブネットワーク更新にイベントを使用します。 サブネットワークの更新時、この編集モードでは、ジオデータベース機能 (属性ルール、編集情報の記録など) が実行され、該当するすべてのフィーチャとオブジェクトのサブネットワーク名と伝達された値が更新されます。
注意:

このパラメーターには、ユーティリティ ネットワーク バージョン 4 以降が必要です。

String
edit_mode_for_named_version
(オプション)

名前付きバージョンでサブネットワークを更新する場合の編集モードを指定します。

  • WITHOUT_EVENTING名前付きバージョンでのサブネットワーク更新にイベントを使用しません。 この編集モードでは、そのバージョンで編集されたフィーチャとオブジェクトのサブネットワーク名と伝達された所定の値が更新されます。 これがデフォルトです。
  • WITH_EVENTING名前付きバージョンでのサブネットワーク更新にイベントを使用します。 サブネットワークの更新時、この編集モードでは、ジオデータベース機能 (属性ルール、編集情報の記録など) が実行され、該当するすべてのフィーチャとオブジェクトのサブネットワーク名と伝達された値が更新されます。
注意:

このパラメーターには、ユーティリティ ネットワーク バージョン 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 を使用します。

  • MANAGEIs dirty 属性がサブネットワーク更新操作によって管理されます。 これがデフォルトです。
  • NOT_MANAGEIs dirty 属性がサブネットワーク更新操作によって管理されません。
注意:

このパラメーターには、ユーティリティ ネットワーク バージョン 5 以降が必要です。

Boolean
include_containers
(オプション)

格納器フィーチャおよびオブジェクトをトレース結果に含めるかどうかを指定します。

  • INCLUDE_CONTAINERS格納器フィーチャおよびオブジェクトをトレース結果に含めます。
  • EXCLUDE_CONTAINERS格納器フィーチャおよびオブジェクトをトレース結果に含めません。 これがデフォルトです。

このパラメーターには、ユーティリティ ネットワーク バージョン 5 以降が必要です。

Boolean
include_content
(オプション)

格納器の格納物をトレース結果に含めるかどうかを指定します。

  • INCLUDE_CONTENT格納器フィーチャおよびオブジェクトの格納物をトレース結果に含めます。
  • EXCLUDE_CONTENT格納器フィーチャおよびオブジェクトの格納物をトレース結果に含めません。 これがデフォルトです。

このパラメーターには、ユーティリティ ネットワーク バージョン 5 以降が必要です。

Boolean
include_structures
(オプション)

構造物フィーチャおよびオブジェクトをトレース結果に含めるかどうかを指定します。

  • INCLUDE_STRUCTURES構造物フィーチャおよびオブジェクトをトレース結果に含めます。
  • EXCLUDE_STRUCTURES構造物フィーチャおよびオブジェクトをトレース結果に含めません。 これがデフォルトです。

このパラメーターには、ユーティリティ ネットワーク バージョン 5 以降が必要です。

Boolean
validate_locatability
(オプション)

トレースまたはサブネットワーク更新操作中に、通過したオブジェクトの関連付け階層に、必要な格納の関連付け、付属物の関連付け、または接続性の関連付けがない非空間ジャンクション オブジェクトまたはエッジ オブジェクトが検出された場合、エラーが返されるかどうかを指定します。 このオプションにより、トレースまたはサブネットワーク更新操作によって返される非空間オブジェクトを、フィーチャまたは他の配置可能オブジェクトとの関連付けを通じて配置できることが保証されます。

  • VALIDATE_LOCATABILITY通過したオブジェクトの関連付け階層に、必要な格納の関連付け、付属物の関連付け、または接続性の関連付けがない非空間ジャンクション オブジェクトまたはエッジ オブジェクトが検出された場合、エラーが返されます。
  • DO_NOT_VALIDATE_LOCATABILITYトレースは未配置のオブジェクトを確認せず、通過したオブジェクトの関連付け階層に未配置のオブジェクトが存在するかどうかに関係なく、結果を返します。 これがデフォルトです。
注意:

このパラメーターには、ユーティリティ ネットワーク バージョン 5 以降が必要です。

Boolean

派生した出力

名前説明データ タイプ
out_utility_network

更新された入力ユーティリティ ネットワーク。

Utility Network

コードのサンプル

SetSubnetworkDefinition (サブネットワーク定義の設定) の例 (スタンドアロン スクリプト)

この例では、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: No
  • Standard: Yes
  • Advanced: Yes

関連トピック