トレース構成の追加 (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 条件を定義することができます。

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

  • [名前] - システム内で定義された任意のネットワーク属性によってフィルターするか、Category を選択してネットワーク カテゴリを使用します。
  • [演算子] - 複数の演算子から選択します。
  • [タイプ] - バリアとして機能する [名前] パラメーターの値のタイプとして Specific value または Network attribute を選択します。 [名前] パラメーターが Category である場合、[タイプ] パラメーターを Specific value に設定する必要があります。
  • [値] - 演算子の値に基づいて、処理を停止させる入力属性またはカテゴリの特定の値を指定します。
  • [結合方法] - 複数の条件を追加する場合に、この値を設定します。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 グローバル ID、Flow direction 属性を使用して、フロー方向を決定するかどうかを指定します。 このパラメーターは、ユーティリティー ネットワーク バージョン 7 以降で使用可能であり、[トレース タイプ] パラメーターが、[上流] または [下流] に設定されている場合にのみ、アクティブになります。

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

注意:

エンタープライズ ジオデータベースの場合、このパラメーターは ArcGIS Enterprise 11.3 以降を必要とします。

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

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

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

注意:

エンタープライズ ジオデータベースの場合、このパラメーターは ArcGIS Enterprise 11.3 以降を必要とします。

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 パラメーターの値のタイプとして Specific value または Network attribute を指定します。 Name パラメーターが Category である場合、Type パラメーターを Specific value に設定する必要があります。
  • 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
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_INCLUDE_ANY値のビットが、属性内に存在しないビット単位の論理積演算 (bitwise AND == False)。

ビット単位の演算子の詳細

フィルター バリアの 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)。

ビット単位の演算子の詳細

関数バリアのフィルターの 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)。

ビット単位の演算子の詳細

関数の 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)。

ビット単位の演算子の詳細

注意:

このパラメーターは、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)。

ビット単位の演算子の詳細

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

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

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

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

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

Value Table
include_isolated_features
(オプション)

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

  • INCLUDE_ISOLATED_FEATURES分離フィーチャをトレース結果に含めます。
  • EXCLUDE_ISOLATED_FEATURES分離フィーチャをトレース結果に含めません。 これがデフォルトです。
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 グローバル ID、Flow direction 属性を使用して、フロー方向を決定するかどうかを指定します。 このパラメーターは、ユーティリティー ネットワーク バージョン 7 以降で使用可能であり、trace_type パラメーターが、UPSTREAM または DOWNSTREAM に設定されている場合にのみ、アクティブになります。

  • USE_DIGITIZED_DIRECTIONトレース操作で、ラインのデジタイズ方向、関連付けのエッジ オブジェクトの From および To グローバル 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

関連トピック