トレース構成の追加 (Add Trace Configuration) (ユーティリティ ネットワーク)

Standard または Advancedのライセンスで利用可能。

サマリー

ユーティリティ ネットワーク内に、指定トレース構成を作成します。

指定トレース構成では、共有と再利用のために、複雑なトレースのプロパティを構成して、格納することができます。 ユーティリティ ネットワークで作成された指定トレース構成は、[トレース (Trace)] ツールまたは [トレース] ウィンドウの [指定構成] タブを使用して、ArcGIS Pro で使用できます。 エンタープライズ配置で作業する際に、これらの構成を Web マップを通じて共有し、Web アプリやフィールド アプリで使用することもできます。

指定トレース構成を作成する方法の詳細

使用法

  • [入力ユーティリティ ネットワーク] パラメーターの値は、必ずバージョン 5 以降でなければなりません。

  • エンタープライズ ジオデータベースを操作する場合、入力ユーティリティ ネットワークは、ユーティリティ ネットワーク サービスから取得する必要があります。

  • 接続されるポータル アカウントは、指定トレース構成の作成者として設定されます。 シングルユーザー配置内のユーティリティ ネットワークを操作する際に、指定トレース構成の作成者を保存する場合には、オペレーティング システム認証が使用されます。

  • ライセンス:
    エンタープライズ配置でこのツールを使用するには、アクティブなポータル アカウントは、ArcGIS Advanced Editing ユーザー タイプ エクステンションのライセンスが付与される必要があります。

パラメーター

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

新しい指定トレース構成が含まれるユーティリティ ネットワーク。

Utility Network; Utility Network Layer
トレース構成名

指定トレース構成の名前。

String
トレース タイプ

構成するトレースのタイプを指定します。

  • 接続1 つ以上の始点で始まり、接続フィーチャに沿って外側に広がる接続トレースが使用されます。 これがデフォルトです。
  • サブネットワーク1 つ以上の始点で始まり、サブネットワーク範囲を包含するように、接続フィーチャに沿って外側に広がるサブネットワーク トレースが使用されます。
  • サブネットワーク コントローラーサブネットワークに関連付けられたサブネットワーク コントローラー上で、ソースとシンクを検索するサブネットワーク コントローラー トレースが使用されます。
  • 上流ネットワーク内の場所から、上流のフィーチャを検索する上流トレースが使用されます。
  • 下流ネットワーク内の場所から、下流のフィーチャを検索する下流トレースが使用されます。
  • ループループは、フロー方向があいまいなネットワークのエリアです。 接続性に基づいて、始点から外側に広がるループ トレースが使用されます。
  • 最短パス2 つの始点間の最短パスを特定する最短パス トレースが使用されます。
  • 分離ネットワークのエリアを分離するフィーチャを検索する分離トレースが使用されます。
String
説明
(オプション)

指定トレース構成の説明。

String
タグ
(オプション)

指定トレース構成の識別に使用される一連のタグ。 これらのタグは、検索とインデックス構築に使用できます。

String
ドメイン ネットワーク
(オプション)

トレースを実行するドメイン ネットワークの名前。 サブネットワーク、サブネットワーク コントローラー、上流、および下流トレース タイプを実行する場合、このパラメーターは必須です。

String
(オプション)

トレースを開始する層の名前。 サブネットワーク、サブネットワーク コントローラー、上流、および下流トレース タイプを実行する場合、このパラメーターは必須です。

String
ターゲット層
(オプション)

入力層が流れるターゲット層の名前。 上流または下流トレースでこのパラメーターを指定しない場合、開始するサブネットワークの境界に到達すると、トレースは停止します。 このパラメーターを使用すると、このトレースを階層の上方または下方に継続できます。

String
サブネットワーク名
(オプション)

トレースを実行するサブネットワークの名前。 このパラメーターは、サブネットワーク トレース タイプの実行時に使用されます。 サブネットワーク名を指定した場合、始点は必要ありません。 サブネットワーク テーブルの 1 つの層に 10,000 以上のレコードが含まれている場合、パラメーターの選択リストは設定されず、サブネットワーク名に空のフィールドが指定されます。

String
最短パス ネットワーク属性名
(オプション)

最短パスを計算するために使用するネットワーク属性の名前。 最短パス トレース タイプを実行すると、形状の長さなど、数値のネットワーク属性を使用して、最短パスが計算されます。 コストに基づくパスと、距離に基づくパスの両方が得られます。 最短パス トレースを実行する場合は、このパラメーターは必須です。

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

格納器フィーチャをトレース結果に含めるかどうかを指定します。

  • オン - 格納器フィーチャをトレース結果に含めます。 [最初の空間格納器まで含める] パラメーターがアクティブになります。
  • オフ - 格納器フィーチャをトレース結果に含めません。 これがデフォルトです。

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

トレースが、結果に格納器の格納物を返すかどうかを指定します。

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

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

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

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

Boolean
バリア フィーチャを含める
(オプション)

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

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

Boolean
一貫性の検証
(オプション)

通過したフィーチャのいずれかでダーティ エリアが発生した場合、エラーを返すかどうかを指定します。 これは、トレースがネットワーク内を一貫したステータスでフィーチャを通過することを保証する唯一の方法です。 ダーティ エリアを削除するには、ネットワーク トポロジを検証します。

  • オン - 通過したフィーチャのいずれかでダーティ エリアが発生した場合、トレースがエラーを返します。 これがデフォルトです。
  • オフ - 通過したフィーチャのいずれかでダーティ エリアが発生したかどうかに関係なく、トレースが結果を返します。

Boolean
条件バリア
(オプション)

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

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

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

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

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

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

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

  • ジャンクションとエッジの両方通過可能性は、ジャンクションとエッジの両方に適用されます。 これがデフォルトです。
  • ジャンクションのみ通過可能性は、ジャンクションのみに適用されます。
  • エッジのみ通過可能性は、エッジのみに適用されます。
String
フィルター バリア
(オプション)

いつ特定のカテゴリまたはネットワーク属性のトレースを停止するかを指定します。 たとえば、特定の値と等しいライフ サイクル ステータス属性があるフィーチャで、トレースを停止します。 このパラメーターを使用して、システムに定義されているネットワーク属性の値に基づいて、ターミネーターを設定します。 複数の属性を使用している場合、[結合方法] オプションを使用して、And 条件および Or 条件を定義できます。

フィルター バリアの構成は次のとおりです。

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

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

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

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

  • [特定の値] - 特定の値によってフィルターします。
  • [ネットワーク属性] - ネットワーク属性によってフィルターします。

Value Table
関数バリアのフィルター
(オプション)

特定のカテゴリのトレース結果をフィルターします。

関数バリアのフィルターの構成は次のとおりです。

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

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

  • [最小] - 入力値の最小が特定されます。
  • [最大] - 入力値の最大が特定されます。
  • [加算] - 値の合計が計算されます。
  • [平均] - 入力値の平均が計算されます。
  • [個数] - フィーチャの数が特定されます。
  • [減算] - 値の差が計算されます。 サブネットワーク コントローラーおよびループ トレース タイプは、減算関数をサポートしていません。

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

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

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

Value Table
フィルターの適用
(オプション)

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

  • [ジャンクションとエッジの両方] - フィルターをジャンクションとエッジの両方に適用します。 これがデフォルトです。
  • [ジャンクションのみ] - フィルターをジャンクションのみに適用します。
  • [エッジのみ] - フィルターをエッジのみに適用します。

String
bitset ネットワーク属性によるフィルター
(オプション)

bitset によるフィルターに使用するネットワーク属性の名前。 このパラメーターは、上流、下流、およびループ トレース タイプのみに適用できます。 このパラメーターを使用すると、トレースが実世界のシナリオをより細密に反映するように、トレース中に特別なロジックを追加できます。 たとえば、ループ トレースの場合、Phases current ネットワーク属性は、ループが真の電気ループである (ループ全体で同じフェーズに電源が入る) かどうかを判断し、トレース結果の真の電源ループのみを返すことができます。 上流トレースの場合、たとえば、配電網のトレース時に Phases current ネットワーク属性を指定することにより、トレース結果に、すべてのパスではなく、ネットワーク属性で指定された有効なパスのみを含めます。

String
最近隣によるフィルター
(オプション)

K 最近隣内挿アルゴリズムを使用して、所定の距離内の特定のタイプのフィーチャの数を返すかどうかを指定します。 このパラメーターを使用すると、個数、コスト、およびカテゴリやアセット タイプのコレクションを指定できます。

  • オン - K 最近隣内挿アルゴリズムを使用して、[個数][コスト ネットワーク属性][最近隣カテゴリ]、または [最近隣アセット グループ/タイプ] パラメーターで指定されたさまざまなフィーチャを返します。
  • オフ - K 最近隣内挿アルゴリズムを使用して、結果をフィルターしません。 これがデフォルトです。

Boolean
個数
(オプション)

[最近隣によるフィルター] をオンにしたときに返されるフィーチャの数。

Long
コスト ネットワーク属性
(オプション)

[最近隣によるフィルター] をオンにしたときに、近接性、コスト、または距離の計算に使用される数値のネットワーク属性 (たとえば、形状の長さ)。

String
最近隣カテゴリ
(オプション)

[最近隣によるフィルター] をオンにしたときに返されるカテゴリ (たとえば、Protective)。

String
最近隣アセット グループ/タイプ
(オプション)

[最近隣によるフィルター] をオンにしたときに返されるアセット グループおよびアセット タイプ (たとえば、ElectricDistributionDevice/Transformer/Step Down)。

String
関数
(オプション)

トレース結果に適用される計算関数。

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

  • [関数] - 複数の計算関数から選択します。
  • [属性] - システムに定義されたネットワーク属性によってフィルターします。
  • [フィルター名] - 属性名によって、関数の結果をフィルターします。
  • [フィルター演算子] - 複数の演算子から選択します。
  • [フィルター タイプ] - 複数のフィルター タイプから選択します。
  • [フィルター値] - 入力フィルター属性の値を指定します。

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

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

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

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

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

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

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

  • [特定の値] - 特定の値によってフィルターします。
  • [ネットワーク属性] - ネットワーク属性によってフィルターします。

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

結果に含める出力アセット タイプをフィルターします (たとえば、頭上の変圧器のみを返すなど)。

String
出力条件
(オプション)

ネットワーク属性またはカテゴリに基づいて、返されるフィーチャのタイプです。 たとえば、Tap フィーチャ以外をすべて除外するよう構成されたトレースでは、Tap カテゴリが割り当てられていないトレース済みフィーチャは、結果に含まれません。 Tap 属性が割り当てられているトレース済みフィーチャは、結果選択セットに返されます。

出力条件の構成は次のとおりです。

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

出力条件の [タイプ] の値オプションは次のとおりです。

  • [特定の値] - 特定の値によってフィルターします。
  • [ネットワーク属性] - ネットワーク属性によってフィルターします。

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

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

Value Table
分離フィーチャを含める
(オプション)

分離フィーチャをトレース結果に含めるかどうかを指定します。 このパラメーターは、分離トレースの実行時にのみ使用されます。

  • オン - 分離フィーチャをトレース結果に含めます。
  • オフ - 分離フィーチャをトレース結果に含めません。 これがデフォルトです。

Boolean
始点でバリアを無視
(オプション)

始点では、トレース構成内のダイナミック バリアを無視するかどうかを指定します。 これは、検出された保護デバイス (バリア) を始点として使用して、上流の保護デバイスのトレースを実行し、その後の上流の保護デバイスを検索する場合に、役立つことがあります。

  • オン - 始点にあるバリアは、トレース内で無視されます。
  • オフ - 始点にあるバリアは、トレース内で無視されません。 これがデフォルトです。

Boolean
最初の空間格納器まで含める
(オプション)

返される格納器を、トレース結果の各ネットワーク エレメントの最初の空間格納器およびそれまで検出した格納器に制限するかどうかを指定します。 所定のネットワーク エレメントで、空間格納器が検出されず、非空間格納器のみがある場合、結果にはすべての非空間格納器が含まれます。 このパラメーターは、[格納器を含める] がオンの場合にのみ有効になります。

  • オン - トレース パスに沿って、ネストされた格納の関連付けが検出された場合、結果には最初の空間格納器まで (最初の空間格納器を含む) に遭遇した格納器のみが含まれます。 空間格納器がない場合、所定のネットワーク エレメントの結果には、すべての非空間格納器が含まれます。
  • オフ - すべての格納器が結果に返されます。 これがデフォルトです。
Boolean
結果タイプ
(オプション)

トレースから返される結果のタイプを指定します。

  • 選択トレース結果は、該当するネットワーク フィーチャの選択セットとして返されます。 これがデフォルトです。
  • 集約されたジオメトリトレース結果は、ジオメトリ タイプによって集約され、アクティブなマップのレイヤー内に表示される、マルチパート フィーチャクラスに格納されます。
String
不定フローの許可
(オプション)

フローが、不定のフィーチャをトレースするかどうかを指定します。 このパラメーターは、上流トレース、下流トレース、または分離トレースを実行する場合にのみ使用されます。

  • オン - フローが、不定のフィーチャがトレースされます。 これがデフォルトです。
  • オフ - フローが、不定のフィーチャが通過可能でなくなり、トレースされません。

Boolean
配置可能性の検証
(オプション)

通過したフィーチャの関連付け階層内の格納器も構造物も関連付けられていない非空間のジャンクション オブジェクトまたはエッジ オブジェクトが検出された場合に、エラーを返すかどうかを指定します。 このパラメーターを使用すると、トレースから返された非空間オブジェクトが、空間フィーチャに関連付けられているかどうかを確認できます。

  • オン - 通過したフィーチャの関連付け階層内の格納器も構造物も関連付けられていない非空間のジャンクション オブジェクト、またはエッジ オブジェクトが検出された場合に、トレースからエラーが返されます。
  • オフ - トレースで配置不可オブジェクトの確認が行われず、通過したオブジェクトの関連付け階層内に配置不可オブジェクトが存在するかどうかに関係なく、トレースから結果が返されます。 これがデフォルトです。

Boolean
デジタイズ方向を使用
(オプション)

上流と下流のトレース操作で、ラインのデジタイズ方向、関連付けのエッジ オブジェクトの From および To Global ID、Flow direction 属性を使用して、フロー方向を決定するかどうかを指定します。 このパラメーターは、ユーティリティ ネットワーク バージョン 7 以降で使用可能であり、[トレース タイプ] パラメーターが、[上流] または [下流] に設定されている場合にのみ、アクティブになります。

  • オン - トレース操作で、ラインのデジタイズ方向、関連付けのエッジ オブジェクトの From および To Global ID、フロー方向属性を使用して、フロー方向が決定されます。 このパラメーターをオンにすると、[ドメイン ネットワーク][層][ターゲット層] パラメーターが非表示になり、無視されます。
  • オフ - トレース操作は、サブネットワーク コントローラーの位置に基づいて、フロー方向を決定します。 これがデフォルトです。

注意:

このパラメーターをエンタープライズ ジオデータベースで使用する場合は、ArcGIS Enterprise 11.3 以降が必要です。

Boolean
ジオメトリの合成
(オプション)

トレース操作の一環として、通過した関連付けとエッジ オブジェクトのジオメトリの推測と作成 (合成) を実行するかどうかを指定します。 このパラメーターは、集約されたジオメトリの結果タイプのみに適用されます。

  • オン - 通過した関連付けとエッジ オブジェクトのジオメトリが推測され、Trace_Results_Aggregated_Lines 出力フィーチャクラス内に作成されます。
  • オフ - 通過した関連付けとエッジ オブジェクトのジオメトリが合成されません。 これがデフォルトです。
Boolean

派生した出力

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

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

Utility Network

arcpy.un.AddTraceConfiguration(in_utility_network, trace_config_name, trace_type, {description}, {tags}, {domain_network}, {tier}, {target_tier}, {subnetwork_name}, {shortest_path_network_attribute_name}, {include_containers}, {include_content}, {include_structures}, {include_barriers}, {validate_consistency}, {condition_barriers}, {function_barriers}, {traversability_scope}, {filter_barriers}, {filter_function_barriers}, {filter_scope}, {filter_bitset_network_attribute_name}, {filter_nearest}, {nearest_count}, {nearest_cost_network_attribute}, {nearest_categories}, {nearest_assets}, {functions}, {propagators}, {output_assettypes}, {output_conditions}, {include_isolated_features}, {ignore_barriers_at_starting_points}, {include_up_to_first_spatial_container}, {result_types}, {allow_indeterminate_flow}, {validate_locatability}, {use_digitized_direction}, {synthesize_geometries})
名前説明データ タイプ
in_utility_network

新しい指定トレース構成が含まれるユーティリティ ネットワーク。

Utility Network; Utility Network Layer
trace_config_name

指定トレース構成の名前。

String
trace_type

構成するトレースのタイプを指定します。

  • CONNECTED1 つ以上の始点で始まり、接続フィーチャに沿って外側に広がる接続トレースが使用されます。 これがデフォルトです。
  • SUBNETWORK1 つ以上の始点で始まり、サブネットワーク範囲を包含するように、接続フィーチャに沿って外側に広がるサブネットワーク トレースが使用されます。
  • SUBNETWORK_CONTROLLERSサブネットワークに関連付けられたサブネットワーク コントローラー上で、ソースとシンクを検索するサブネットワーク コントローラー トレースが使用されます。
  • UPSTREAMネットワーク内の場所から、上流のフィーチャを検索する上流トレースが使用されます。
  • DOWNSTREAMネットワーク内の場所から、下流のフィーチャを検索する下流トレースが使用されます。
  • LOOPSループは、フロー方向があいまいなネットワークのエリアです。 接続性に基づいて、始点から外側に広がるループ トレースが使用されます。
  • SHORTEST_PATH2 つの始点間の最短パスを特定する最短パス トレースが使用されます。
  • ISOLATIONネットワークのエリアを分離するフィーチャを検索する分離トレースが使用されます。
String
description
(オプション)

指定トレース構成の説明。

String
tags
[tags,...]
(オプション)

指定トレース構成の識別に使用される一連のタグ。 これらのタグは、検索とインデックス構築に使用できます。

String
domain_network
(オプション)

トレースを実行するドメイン ネットワークの名前。 サブネットワーク、サブネットワーク コントローラー、上流、および下流トレース タイプを実行する場合、このパラメーターは必須です。

String
tier
(オプション)

トレースを開始する層の名前。 サブネットワーク、サブネットワーク コントローラー、上流、および下流トレース タイプを実行する場合、このパラメーターは必須です。

String
target_tier
(オプション)

入力層が流れるターゲット層の名前。 上流または下流トレースでこのパラメーターを指定しない場合、開始するサブネットワークの境界に到達すると、トレースは停止します。 このパラメーターを使用すると、このトレースを階層の上方または下方に継続できます。

String
subnetwork_name
(オプション)

トレースを実行するサブネットワークの名前。 このパラメーターは、サブネットワーク トレース タイプの実行時に使用されます。 サブネットワーク名を指定した場合、starting_points パラメーターは必要ありません。

String
shortest_path_network_attribute_name
(オプション)

最短パスを計算するために使用するネットワーク属性の名前。 最短パス トレース タイプを実行すると、形状の長さなど、数値のネットワーク属性を使用して、最短パスが計算されます。 コストに基づくパスと、距離に基づくパスの両方が得られます。 最短パス トレースを実行する場合は、このパラメーターは必須です。

String
include_containers
(オプション)

格納器フィーチャをトレース結果に含めるかどうかを指定します。

  • INCLUDE_CONTAINERS格納器フィーチャをトレース結果に含めます。
  • EXCLUDE_CONTAINERS格納器フィーチャをトレース結果に含めません。 これがデフォルトです。
Boolean
include_content
(オプション)

トレースが、結果に格納器の格納物を返すかどうかを指定します。

  • INCLUDE_CONTENT格納器フィーチャの格納物をトレース結果に含めます。
  • EXCLUDE_CONTENT格納器フィーチャの格納物をトレース結果に含めません。 これがデフォルトです。
Boolean
include_structures
(オプション)

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

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

通過可能性バリア フィーチャをトレース結果に含めるかどうかを指定します。 通過可能性バリアは、サブネットワーク定義で事前に設定されている場合でも任意指定です。 このパラメーターは、ターミナルを含むデバイス フィーチャには適用されません。

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

通過したフィーチャのいずれかでダーティ エリアが発生した場合、エラーを返すかどうかを指定します。 これは、トレースがネットワーク内を一貫したステータスでフィーチャを通過することを保証する唯一の方法です。 ダーティ エリアを削除するには、ネットワーク トポロジを検証します。

  • VALIDATE_CONSISTENCY通過したフィーチャのいずれかでダーティ エリアが発生した場合、トレースがエラーを返します。 これがデフォルトです。
  • DO_NOT_VALIDATE_CONSISTENCY通過したフィーチャのいずれかでダーティ エリアが発生したかどうかに関係なく、トレースが結果を返します。
Boolean
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)。

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

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

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

いつ特定のカテゴリまたはネットワーク属性のトレースを停止するかを指定します。 たとえば、特定の値と等しいライフ サイクル ステータス属性があるフィーチャで、トレースを停止します。 このパラメーターを使用して、システムに定義されているネットワーク属性の値に基づいて、ターミネーターを設定します。 複数の属性を使用している場合、Combine Using オプションを使用して、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
filter_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
filter_scope
(オプション)

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

  • BOTH_JUNCTIONS_AND_EDGESフィルターをジャンクションとエッジの両方に適用します。 これがデフォルトです。
  • JUNCTIONS_ONLYフィルターをジャンクションのみに適用します。
  • EDGES_ONLYフィルターをエッジのみに適用します。
String
filter_bitset_network_attribute_name
(オプション)

bitset によるフィルターに使用するネットワーク属性の名前。 このパラメーターは、上流、下流、およびループ トレース タイプのみに適用できます。 このパラメーターを使用すると、トレースが実世界のシナリオをより細密に反映するように、トレース中に特別なロジックを追加できます。 たとえば、ループ トレースの場合、Phases current ネットワーク属性は、ループが真の電気ループである (ループ全体で同じフェーズに電源が入る) かどうかを判断し、トレース結果の真の電源ループのみを返すことができます。 上流トレースの場合、たとえば、配電網のトレース時に Phases current ネットワーク属性を指定することにより、トレース結果に、すべてのパスではなく、ネットワーク属性で指定された有効なパスのみを含めます。

String
filter_nearest
(オプション)

K 最近隣内挿アルゴリズムを使用して、所定の距離内の特定のタイプのフィーチャの数を返すかどうかを指定します。 このパラメーターを使用すると、個数、コスト、およびカテゴリやアセット タイプのコレクションを指定できます。

  • FILTER_BY_NEARESTK 最近隣内挿アルゴリズムを使用して、nearest_countnearest_cost_network_attributenearest_categories、または nearest_assets パラメーターで指定されたさまざまなフィーチャを返します。
  • DO_NOT_FILTERK 最近隣内挿アルゴリズムを使用して、結果をフィルターしません。 これがデフォルトです。
Boolean
nearest_count
(オプション)

filter_nearestFILTER_BY_NEAREST にしたときに返されるフィーチャの数。

Long
nearest_cost_network_attribute
(オプション)

filter_nearestFILTER_BY_NEAREST にしたときに、近接性、コスト、または距離の計算に使用される数値のネットワーク属性 (たとえば、形状の長さ)。

String
nearest_categories
[nearest_categories,...]
(オプション)

filter_nearestFILTER_BY_NEAREST にしたときに返されるカテゴリ (たとえば、Protective)。

String
nearest_assets
[nearest_assets,...]
(オプション)

filter_nearestFILTER_BY_NEAREST にしたときに返されるアセット グループおよびアセット タイプ (たとえば、ElectricDistributionDevice/Transformer/Step Down)。

String
functions
[[Function, Attribute, Filter Name, Filter Operator, Filter Type, Filter Value],...]
(オプション)

演算関数をトレース結果に適用します。

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

  • Function - 複数の計算関数から選択します。
  • Attribute - システム内で定義された任意のネットワーク属性によってフィルターします。
  • Filter Name - 属性名によって、関数の結果をフィルターします。
  • Filter Operator - 複数の演算子から選択します。
  • Filter Type - 複数のフィルター タイプから選択します。
  • Filter Value - 入力フィルター属性の値を指定します。

関数の Function の値オプションは次のとおりです。

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

たとえば、始点フィーチャの値が 20 とします。 次のフィーチャは、30 の値を持っています。 MINIMUM 関数を使用している場合、結果は 20、MAXIMUM は 30、ADD は 50、AVERAGE は 25、COUNT は 2、SUBTRACT は -10 になります。

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)。

bitwise 演算子の詳細

関数の Filter Type の値オプションは次のとおりです。

  • SPECIFIC_VALUE特定の値によってフィルターします。
  • NETWORK_ATTRIBUTEネットワーク属性によってフィルターします。
Value Table
propagators
[[Attribute, Substitution Attribute, Function, Operator, Value],...]
(オプション)

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

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

  • 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 - 演算子の値に基づいて、処理を停止させる入力属性タイプの特定の値を指定します。

プロパゲーターの 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
output_assettypes
[output_assettypes,...]
(オプション)

結果に含める出力アセット タイプをフィルターします (たとえば、頭上の変圧器のみを返すなど)。

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

ネットワーク属性またはカテゴリに基づいて、返されるフィーチャのタイプです。 たとえば、Tap フィーチャ以外をすべて除外するよう構成されたトレースでは、Tap カテゴリが割り当てられていないトレース済みフィーチャは、結果に含まれません。 Tap 属性が割り当てられているトレース済みフィーチャは、結果選択セットに返されます。 複数の属性を使用している場合、Combine Using オプションを使用して、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)。

bitwise 演算子の詳細

出力条件の Type の値オプションは次のとおりです。

  • SPECIFIC_VALUE特定の値によってフィルターします。
  • NETWORK_ATTRIBUTEネットワーク属性によってフィルターします。

出力条件の Combine Using の値オプションは次のとおりです。

  • AND条件を結合します。
  • ORいずれかの条件を満たした場合に使用します。

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

Value Table
include_isolated_features
(オプション)

分離フィーチャをトレース結果に含めるかどうかを指定します。 このパラメーターは、分離トレースの実行時にのみ使用されます。

  • INCLUDE_ISOLATED_FEATURES分離フィーチャをトレース結果に含めます。
  • EXCLUDE_ISOLATED_FEATURES分離フィーチャをトレース結果に含めません。 これがデフォルトです。
注意:

エンタープライズ ジオデータベースを使用している場合、分離トレース タイプには、ArcGIS Enterprise 10.7 以降が必要です。

Boolean
ignore_barriers_at_starting_points
(オプション)

始点では、トレース構成内のダイナミック バリアを無視するかどうかを指定します。 これは、検出された保護デバイス (バリア) を始点として使用して、上流の保護デバイスのトレースを実行し、その後の上流の保護デバイスを検索する場合に、役立つことがあります。

  • IGNORE_BARRIERS_AT_STARTING_POINTS始点にあるバリアは、トレース内で無視されます。
  • DO_NOT_IGNORE_BARRIERS_AT_STARTING_POINTS始点にあるバリアは、トレース内で無視されません。 これがデフォルトです。
Boolean
include_up_to_first_spatial_container
(オプション)

返される格納器を、トレース結果の各ネットワーク エレメントの最初の空間格納器およびそれまで検出した格納器に制限するかどうかを指定します。 所定のネットワーク エレメントで、空間格納器が検出されず、非空間格納器のみがある場合、結果にはすべての非空間格納器が含まれます。 このパラメーターは、Include ContainersINCLUDE_CONTAINERS である場合にのみ使用できます。

  • INCLUDE_UP_TO_FIRST_SPATIAL_CONTAINERトレース パスに沿って、ネストされた格納の関連付けが検出された場合、結果には最初の空間格納器まで (最初の空間格納器を含む) に遭遇した格納器のみが返されます。 空間格納器がない場合、所定のネットワーク エレメントの結果には、すべての非空間格納器が含まれます。
  • DO_NOT_INCLUDE_UP_TO_FIRST_SPATIAL_CONTAINERすべての格納器が結果に返されます。 これがデフォルトです。
Boolean
result_types
[result_types,...]
(オプション)

トレースから返される結果のタイプを指定します。

  • SELECTIONトレース結果は、該当するネットワーク フィーチャの選択セットとして返されます。 これがデフォルトです。
  • AGGREGATED_GEOMETRYトレース結果は、ジオメトリ タイプによって集約され、アクティブなマップのレイヤー内に表示される、マルチパート フィーチャクラスに格納されます。
String
allow_indeterminate_flow
(オプション)

フローが、不定のフィーチャをトレースするかどうかを指定します。 このパラメーターは、上流トレース、下流トレース、または分離トレースを実行する場合にのみ使用されます。

  • TRACE_INDETERMINATE_FLOWフローが、不定のフィーチャがトレースされます。 これがデフォルトです。
  • IGNORE_INDETERMINATE_FLOWフローが、不定のフィーチャが通過可能でなくなり、トレースされません。
Boolean
validate_locatability
(オプション)

通過したフィーチャの関連付け階層内の格納器も構造物も関連付けられていない非空間のジャンクション オブジェクトまたはエッジ オブジェクトが検出された場合に、エラーを返すかどうかを指定します。 このパラメーターを使用すると、トレースから返された非空間オブジェクトが、空間フィーチャに関連付けられているかどうかを確認できます。

  • VALIDATE_LOCATABILITY通過したフィーチャの関連付け階層内の格納器も構造物も関連付けられていない非空間のジャンクション オブジェクトまたはエッジ オブジェクトが検出された場合に、トレースからエラーが返されます。
  • DO_NOT_VALIDATE_LOCATABILITYトレースで配置不可オブジェクトの確認が行われず、通過したオブジェクトの関連付け階層内に配置不可オブジェクトが存在するかどうかに関係なく、トレースから結果が返されます。 これがデフォルトです。
Boolean
use_digitized_direction
(オプション)

上流と下流のトレース操作で、ラインのデジタイズ方向、関連付けのエッジ オブジェクトの From および To Global ID、Flow direction 属性を使用して、フロー方向を決定するかどうかを指定します。 このパラメーターは、ユーティリティ ネットワーク バージョン 7 以降で使用可能であり、trace_type パラメーターが、UPSTREAM または DOWNSTREAM に設定されている場合にのみ、アクティブになります。

  • USE_DIGITIZED_DIRECTIONトレース操作で、ラインのデジタイズ方向、関連付けのエッジ オブジェクトの From および To Global ID、フロー方向属性を使用して、フロー方向が決定されます。 このオプションを使用すると、domain_networktiertarget_tier パラメーターは無視されます。
  • IGNORE_DIGITIZED_DIRECTIONトレース操作は、サブネットワーク コントローラーの位置に基づいて、フロー方向を決定します。 これがデフォルトです。
注意:
このパラメーターをエンタープライズ ジオデータベースで使用する場合は、ArcGIS Enterprise 11.3 以降が必要です。
Boolean
synthesize_geometries
(オプション)

トレース操作の一環として、通過した関連付けとエッジ オブジェクトのジオメトリの推測と作成 (合成) を実行するかどうかを指定します。 このパラメーターは、集約されたジオメトリの結果タイプのみに適用されます。

  • DO_NOT_SYNTHESIZE_GEOMETRIES通過した関連付けとエッジ オブジェクトのジオメトリが合成されません。 これがデフォルトです。
  • SYNTHESIZE_GEOMETRIES通過した関連付けとエッジ オブジェクトのジオメトリが推測され、Trace_Results_Aggregated_Lines 出力フィーチャクラス内に作成されます。

注意:
このパラメーターをエンタープライズ ジオデータベースで使用する場合は、ArcGIS Enterprise 11.3 以降が必要です。

Boolean

派生した出力

名前説明データ タイプ
out_utility_network

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

Utility Network

コードのサンプル

AddTraceConfiguration の例 (Python ウィンドウ)

次の Python ウィンドウ スクリプトは、AddTraceConfiguration 関数の使用方法を示しています。

import arcpy
arcpy.un.AddTraceConfiguration(
        r"SampleUNService\Elec Utility Network", "Upstream_RMT002", "UPSTREAM", 
        "Upstream trace on RMT002", "Upstream;RMT002", "ElectricDistribution", 
        "Medium Voltage", '', '', '', "EXCLUDE_CONTAINERS", "EXCLUDE_CONTENT", 
        "EXCLUDE_STRUCTURES", "INCLUDE_BARRIERS", "VALIDATE_CONSISTENCY", None, 
        None, "BOTH_JUNCTIONS_AND_EDGES", None, None, "BOTH_JUNCTIONS_AND_EDGES", 
        '', "DO_NOT_FILTER", None, '', None, None, None, None, None, None, 
        "EXCLUDE_ISOLATED_FEATURES", "DO_NOT_IGNORE_BARRIERS_AT_STARTING_POINTS", 
        "DO_NOT_INCLUDE_UP_TO_FIRST_SPATIAL_CONTAINER", None, 
        "TRACE_INDETERMINATE_FLOW", "DO_NOT_VALIDATE_LOCATABILITY")

環境

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

ライセンス情報

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

関連トピック