トレース ルールの追加 (Add Trace Rule) (ネットワーク ダイアグラム ツール)
サマリー
ダイアグラム構築中に、ユーティリティー ネットワークまたはトレース ネットワークに対して、トレースを自動的に実行するためのダイアグラム ルールを、ダイアグラム テンプレートで指定されたルール シーケンスに追加します。 トレースの結果として生成されたネットワーク フィーチャおよびネットワーク オブジェクトは、ダイアグラム コンテンツの構築に使用されます。
注意:
このツールは、構成および管理ツールです。
注意:
このツールは、入力ダイアグラム テンプレートに基づく、既存のダイアグラムの一貫性に影響を与えます。 更新されるまで、既存のダイアグラムは、すべて一貫性なしになり、一貫性警告アイコン
が表示されます。
使用法
このツールは、ユーティリティー ネットワーク サービスまたはトレース ネットワーク サービスを使用する場合、サポートされません。 ファイルまたはモバイル ジオデータベース内のユーティリティー ネットワークまたはトレース ネットワークを使用するか、エンタープライズ ジオデータベース内のユーティリティー ネットワークまたはトレース ネットワークへのデータベース コネクションを使用する必要があります。 エンタープライズ ジオデータベースを操作するときは、次の要件があります。
入力ネットワーク パラメーター値は、データベース ユーティリティー ネットワークの所有者またはデータベース トレース ネットワーク所有者として、確立されたデータベース コネクションから取得する必要があります。
接続された ArcGIS Enterprise ポータル アカウントは、ポータル ユーティリティー ネットワークの所有者またはポータル トレース ネットワーク所有者である必要があります。
このツールは、パブリックで保護されていないと想定される、デフォルトのバージョンに接続されている必要があります。
トレース ルールは、ダイアグラム内で現在表されているネットワーク フィーチャまたはネットワーク オブジェクトから、あるいは入力として指定するか始点の設定ルールを使用して指定された特定の始点からのトレースの実行に使用されます。
指定したトレース タイプによって、次のように、トレース ルールを実行するダイアグラムで、始点を事前に設定しておく必要があるかどうかが決まります。
接続、サブネットワーク、上流、下流、パス、回路のトレース タイプの場合、トレース ルールを開始する際に、ダイアグラムに表示されているすべてのユーティリティー ネットワークまたはトレース ネットワーク エレメントは、ダイアグラムの作成が入力として指定された特定のトレース位置から開始されていないか、ダイアグラム テンプレートで始点の設定ルールが構成されていて、特定の始点が明確に特定されていない限り、トレースの始点に考慮されます。
正常に機能するためには、パス トレース タイプに 1 つ以上の開始位置と停止位置が必要です。 ダイアグラム ルールを使用して停止点を指定できないため、パス トレース タイプには、ダイアグラムのトレース ルールとして使用した場合に、他のトレース タイプに比べて特定の要件があります。 パス トレース タイプ ルールを適用するように構成されたダイアグラム テンプレートに基づいてダイアグラムを作成するには、トレース位置からダイアグラムを作成 パラメーターをオンにして ダイアグラムの作成 ツールを実行する必要があります。
ヒント:
最短パス ネットワーク属性名パラメーターを構成すると、指定された開始位置と停止位置の間の最短パスを計算し、検出された最短パスをダイアグラムとして表示できます。
トレース ルールに基づいて、テンプレートを構成した場合、ダイアグラムが更新されるたびに、ユーティリティー ネットワークまたはトレース ネットワーク上で、体系的にトレースが再実行されます。 つまり、更新時に、必ず最新のネットワーク トレース結果が、そのテンプレートに基づくすべてのダイアグラムに反映されます。
ユーティリティー ネットワーク バージョン 7 以降では、サブネットワーク コントローラーの位置ではなく、ラインのデジタイズ方向と
Flow direction属性を使用して、フローを決定する上流または下流トレース操作を実行するよう、トレース ルールを構成できます。ユーティリティー ネットワーク バージョン 7 およびトレース ネットワーク バージョン 4 以降では、指定トレース構成を使用して、トレース ルールを構成することもできます。
ArcGIS Pro 3.6 以降では、ネットワーク属性またはカテゴリーに基づいて出力アセット タイプまたはフィーチャのタイプをフィルターして返すようにトレース ルールを構成できます。
ユーティリティー ネットワーク バージョン 8 以降では、通信ドメインのユーティリティー ネットワークが存在する場合、トレース ルールを構成して、通信ドメイン上で回路トレースを実行できます。
パラメーター
| ラベル | 説明 | データ タイプ |
|---|---|---|
|
入力ネットワーク |
変更するダイアグラム テンプレートを含むユーティリティー ネットワークまたはトレース ネットワーク。 |
Utility Network; Trace Network |
|
入力ダイアグラム テンプレート |
変更するダイアグラム テンプレートの名前。 |
String |
|
有効 |
指定したテンプレートに基づくダイアグラムの生成および更新時に、ルールを有効にするかどうかを指定します。
|
Boolean |
|
トレース タイプ |
ダイアグラム コンテンツの構築のために実行するトレースのタイプを指定します。
|
String |
|
ドメイン ネットワーク (オプション) |
ユーティリティー ネットワークに対して、トレースを実行するドメイン ネットワークの名前。 サブネットワーク、上流、下流、および回路トレース タイプを実行する場合、このパラメーターは必須です。 |
String |
|
層 (オプション) |
ユーティリティー ネットワークに対して、トレースを開始する層の名前。 このパラメーターは、接続トレース タイプを実行する場合にはオプションであり、サブネットワーク、上流、および下流トレース タイプを実行する場合には必須です。 |
String |
|
ターゲット層 (オプション) |
ユーティリティー ネットワークに対して、入力層が流れるターゲット層の名前。 上流および下流トレースで、このパラメーターを使用しない場合は、開始するサブネットワークの境界に到達すると、トレースは停止します。 このパラメーターを使用すると、このトレースを階層の上方または下方に継続できます。 |
String |
|
構造物を含める (オプション) |
構造物フィーチャおよびオブジェクトをトレース結果に含めるかどうかを指定します。
|
Boolean |
|
バリア フィーチャを含める (オプション) |
通過可能性バリア フィーチャが、トレース結果に含まれるかどうかを指定します。 通過可能性バリアは、サブネットワーク定義内で設定済みである場合でもオプションです。 このパラメーターは、ターミナルを含むデバイス フィーチャには適用されません。
|
Boolean |
|
条件バリア (オプション) |
ネットワーク属性との比較またはカテゴリー文字列のチェックに基づいて、フィーチャに対して通過可能性バリア条件を設定します。 条件バリアでは、ネットワーク属性またはネットワーク カテゴリー、演算子とタイプ、および属性値が使用されます。 たとえば、フィーチャが 値テーブル列:
|
Value Table |
|
関数バリア (オプション) |
関数に基づいて、フィーチャに対する通過可能性バリアを設定します。 関数バリアを使用して、始点からトレースが移動できる距離の制限としてそのような設定を行うか、トレースを停止するための最大値を設定することができます。 たとえば、通過した各ラインの長さが、それまでに移動した合計距離に追加されます。 移動した全長が指定された値に達した場合、トレースが停止します。 値テーブル列:
|
Value Table |
|
通過可能性の適用 (オプション) |
適用される通過可能性のタイプを指定します。 通過可能性の適用範囲では、通過可能性がジャンクション、エッジ、またはその両方のいずれに適用されるかを定義します。 たとえば、Device Status が Open であり、通過可能性の範囲がエッジのみに設定されている場合に、トレースを停止するように条件バリアを定義すると、トレースでオープン デバイスが検出された場合でも、Device Status は、ジャンクションにしか適用されないため、トレースは停止しません。 言い換えると、このパラメーターは、ジャンクション、エッジ、またはその両方を無視するかどうかをトレースに指示します。
|
String |
|
フィルター バリア (オプション) |
いつ特定のカテゴリーまたはネットワーク属性のトレースを停止するかを指定します。 たとえば、特定の値と等しいライフ サイクル ステータス属性があるフィーチャで、トレースを停止します。 このパラメーターを使用して、システムに定義されているネットワーク属性の値に基づいて、ターミネーターを設定します。 値テーブル列:
|
Value Table |
|
関数バリアのフィルター (オプション) |
特定のカテゴリーのトレース結果をフィルターします。 値テーブル列:
|
Value Table |
|
フィルターの適用 (オプション) |
特定のカテゴリーのフィルターをジャンクション、エッジ、その両方のいずれに適用するかを指定します。 たとえば、Device Status が Open であり、通過可能性の範囲がエッジのみに設定されている場合に、トレースを停止するようにフィルター バリアを定義すると、トレースでオープン デバイスが検出された場合でも、Device Status はジャンクションにしか適用されないため、トレースは停止しません。 言い換えると、このパラメーターは、ジャンクション、エッジ、またはその両方を無視するかどうかをトレースに指示します。
|
String |
|
bitset ネットワーク属性によるフィルター (オプション) |
bitset によるフィルターに使用するネットワーク属性の名前。 このパラメーターは、上流、下流、およびループ トレース タイプのみに適用できます。 このパラメーターを使用すると、トレースが実世界のシナリオをより細密に反映するように、トレース中に特別なロジックを追加できます。 たとえば、ループ トレースの場合、Phases current ネットワーク属性は、ループが真の電気ループである (ループ全体で同じフェーズに電源が入る) かどうかを判断し、トレース結果の真の電源ループのみを返すことができます。 上流トレースの場合、たとえば、配電網のトレース時に Phases current ネットワーク属性を指定することにより、トレース結果に、すべてのパスではなく、ネットワーク属性で指定された有効なパスのみを含めます。 |
String |
|
最近隣によるフィルター (オプション) |
K 最近隣内挿アルゴリズムを使用して、所定の距離内の特定のタイプのフィーチャの数を返すかどうかを指定します。 個数、コスト、およびカテゴリーやアセット タイプのコレクションを指定できます。
|
Boolean |
|
個数 (オプション) |
最近隣によるフィルター をオンにしたときに返されるフィーチャの数。 |
Long |
|
コスト ネットワーク属性 (オプション) |
最近隣によるフィルター をオンにした場合に、近接性、コスト、または距離の計算に使用される数値のネットワーク属性 (たとえば、形状の長さ)。 |
String |
|
最近隣カテゴリー (オプション) |
最近隣によるフィルター をオンにしたときに返されるカテゴリー (たとえば、Protective)。 |
String |
|
最近隣アセット グループ/タイプ (オプション) |
最近隣によるフィルター をオンにしたときに返されるアセット グループおよびアセット タイプ (たとえば、ElectricDistributionDevice/Transformer/Step Down)。 |
String |
|
プロパゲーター (オプション) |
このパラメーターは、Python を通じてのみ利用可能です。 値テーブル列:
|
Value Table |
|
説明 (オプション) |
ルールの説明。 |
String |
|
不定フローを許可 (オプション) |
フロー方向が、不定または未定のトレース ネットワーク フィーチャをトレースするかどうかを指定します。 このパラメーターは、上流トレース タイプまたは下流トレース タイプを実行する場合にのみ適用されます。
|
Boolean |
|
パス方向 (オプション) |
トレース ネットワークの最短パスの方向を指定します。 パスの通過にかかるコストは、最短パス ネットワーク属性名 パラメーターの値によって決定されます。 このパラメーターは、最短パス トレース タイプをトレース ネットワークに適用する場合にのみ使用されます。
|
String |
|
最短パス ネットワーク属性名 (オプション) |
ユーティリティー ネットワークまたはトレース ネットワークでパスまたは最短パス トレース タイプを使用して最短パスを計算する場合に使用するネットワーク属性。 最短パス解析トレースを実行すると、形状の長さなど、数値のネットワーク属性を使用して、最短パスが計算されます。 コストに基づくパスと、距離に基づくパスの両方が得られます。 最短パス トレースを実行する場合は、このパラメーターは必須です。 |
String |
|
トレース構成の使用 (オプション) |
トレースのプロパティの定義に、既存の指定トレース構成を使用するかどうかを指定します。 このパラメーターは、ユーティリティー ネットワーク バージョン 7 以降でのみ有効になります。
|
Boolean |
|
トレース構成名 (オプション) |
既存の指定トレース構成の名前を使用して、トレースのプロパティを定義します。 このパラメーターは、トレース構成の使用 パラメーターがオンの場合にのみ有効になります。 |
String |
|
デジタイズ方向を使用 (オプション) |
上流および下流のトレース操作でラインのデジタイズ方向とフロー方向属性を使用してフローを決定するかどうかを指定します。 このパラメーターは、ユーティリティー ネットワーク バージョン 7 以降で、トレース タイプ パラメーターが 上流 または 下流 オプションに設定されている場合にのみ使用できます。 注意:このパラメーターをエンタープライズ ジオデータベースで使用する場合は、ArcGIS Enterprise 11.3 以降が必要です。
|
Boolean |
|
出力アセット タイプ (オプション) |
結果に含める出力アセット タイプをフィルターします (たとえば、頭上の変圧器のみを返すなど)。 |
String |
|
出力条件 (オプション) |
ネットワーク属性またはカテゴリーに基づいて、返されるフィーチャのタイプです。 たとえば、Tap フィーチャ以外をすべて除外するよう構成されたトレースでは、Tap カテゴリーが割り当てられていないトレース済みフィーチャは、結果に含まれません。 そのカテゴリーがあるトレース対象フィーチャは、結果選択セットに返されます。 値テーブル列:
|
Value Table |
|
パス数 (オプション) |
パスまたは回路トレースで返されるパスの最大数。 デフォルトは 1 です。 このパラメーターは、トレース タイプ パラメーターが パス または 回路 に設定されている場合にのみ有効です。 |
Long |
|
最大ホップ (オプション) |
パスまたは回路で許容されるエッジ間の最大ホップ数 (始点を除く)。 すべてのエッジとジャンクション-ジャンクション接続性の関連付けは、通過時に固定ユニット長 1 を持つものとして評価されます。 ターミナル デバイスは、固定ユニット長 2 を持つものとして評価されます。 デフォルトは 100 です。 このパラメーターは、トレース タイプ パラメーターが パス または 回路 に設定されている場合にのみ有効です。 |
Long |
|
接続性の推測 (オプション) |
パス トレースで接続性の推測を使用して、格納の関連付けを通過し、所定の開始位置と終了位置間のパスを特定するかどうかを指定します。 このパラメーターは通信ドメイン ネットワークのパス トレースでのみサポートされており、接続性情報が明示的に利用できない場合でも、セクション間のパスを検出できるようにします。 詳細については、「接続性の推測」をご参照ください。
|
Boolean |
派生した出力
| ラベル | 説明 | データ タイプ |
|---|---|---|
|
出力ネットワーク |
更新されたユーティリティー ネットワークまたはトレース ネットワーク。 |
Utility Network; Trace Network |
|
出力ダイアグラム テンプレート |
ダイアグラム テンプレートの名前。 |
String |
環境
このツールは、ジオプロセシング環境を一切使用しません。
ライセンス情報
- Basic: いいえ
- Standard: はい
- Advanced: はい