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

サマリー

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

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

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

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

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

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

使用法

このツールでは、層のサブネットワーク定義の設定と変更も実行できます。層のサブネットワーク定義の値を変更するには、パラメーター値を変更して、このツールをもう一度実行します。
ネットワークトポロジが無効化されている必要があります。
エンタープライズジオデータベースを操作する場合、次の要件が満たされている必要があります。
- 接続された ArcGIS Enterprise ポータルアカウントは、ポータルユーティリティネットワークの所有者である必要があります。
- [入力ユーティリティネットワーク] パラメーター値は、データベースユーティリティネットワークの所有者として、確立されたデータベース接続から取得する必要があります。
- このツールを実行するには、デフォルトバージョンに接続する必要があります。
  - デフォルトバージョンに接続されているその他のセッションでは、有効化操作の実行中に検証操作も有効化操作も実行できません。
サマリーを定義し、[サマリー] パラメーターのサマリー属性フィールドを作成する場合、次の有効なフィールドタイプのマトリックスを使用して、指定した関数に基づいてフィールドタイプを定義することができます。

パラメーター

ラベル	説明	データタイプ
入力ユーティリティネットワーク	層のサブネットワークが属している入力ユーティリティネットワーク。	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
条件バリア (オプション)	ネットワーク属性との比較またはカテゴリ文字列のチェックに基づいて、フィーチャに対して通過可能性バリア条件を設定します。条件バリアは、ネットワーク属性、演算子とタイプ、および属性値を使用します。たとえば、フィーチャが Open の特定の値と等しい Device Status 属性を持っている場合に、トレースを停止します。フィーチャがこの条件を満たしている場合、トレースが停止します。複数の属性を使用している場合、[結合方法] パラメーターを使用して 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 と等しい)—値のビットが属性内に存在しないビット単位の論理積演算 (bitwise AND == False)。特定の値—特定の値によるフィルター。ネットワーク属性—ネットワーク属性によるフィルター。 And—条件バリアを結合します。 Or—いずれかの条件バリアが満たされている場合に使用します。	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—ネットワーク属性によるフィルター。ビット単位の演算子の詳細	Value Table
condition_barriers [[Name, Operator, Type, Value, Combine Using],...] (オプション)	ネットワーク属性との比較またはカテゴリ文字列のチェックに基づいて、フィーチャに対して通過可能性バリア条件を設定します。条件バリアは、ネットワーク属性、演算子とタイプ、および属性値を使用します。たとえば、フィーチャが Open の特定の値と等しい Device Status 属性を持っている場合に、トレースを停止します。フィーチャがこの条件を満たしている場合、トレースが停止します。複数の属性を使用している場合、[結合方法] パラメーターを使用して 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_INCLUDE_ANY—値のビットが属性内に存在しないビット単位の論理積演算 (bitwise AND == False)。ビット単位の演算子の詳細条件バリアの 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)。ビット単位の演算子の詳細関数バリア 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)。ビット単位の演算子の詳細注意: このパラメーターは 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 オプションを使用します。 MANAGE—Is dirty 属性がサブネットワーク更新操作によって管理されます。注意書きがない限り、これがデフォルトです。 NOT_MANAGE—Is 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.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)

環境

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

ライセンス情報

Basic: No
Standard: Yes
Advanced: Yes

サマリー

使用法

パラメーター

注意:

注意:

注意:

注意:

注意:

注意:

注意:

派生した出力

注意:

注意:

注意:

注意:

注意:

注意:

注意:

注意:

注意:

注意:

注意:

派生した出力

コードのサンプル

環境

ライセンス情報

関連トピック

このトピックの内容