ユーティリティ ネットワークのトレースを行うことで、いつでもネットワークの状態について答えを見つけ、問題を解決できます。 ユーティリティ ネットワークを「トレース」するには、[トレース (Trace)] ジオプロセシング ツールを使用します。
「トレース」ツールでは、多くの「トレース タイプ」を使用できます。
これらのトレース タイプと合わせて、[トレース (Trace)] ツールには、提供される各トレース タイプの調整に使用する詳細構成の包括的なセットが含まれています。 これらの構成により、「通過可能性」を確立し、返されるフィーチャまたはオブジェクトを識別し、実行する計算を設定できます。 ModelBuilder を使用して複雑な構成を保存し、モデル ツールのインターフェイスに表示されるパラメーターの数を減らすことができます。 「名前付きトレース構成」を使用して、組織全体で共有できる複雑なトレースを作成して保存できます。 これにより、詳細なトレースを 1 クリックのみで返せるようになります。
「サブネットワーク定義」内でサブネットワーク トレース構成を設定すると、特定の層に対してトレースを実行する際に [トレース (Trace)] ツールを自動設定することができます。 これは、「サブネットワークベースのトレース」に適用されます。 たとえば、フィーダーの終端を表示し、各フィーダーの全負荷を算出するために、サブネットワーク トレースを常に保護デバイスで停止させる場合は、サブネットワークベースのトレースを実行するごとにこれらのパラメーターを設定しなくてもかまいません。 これは、層内のすべてのサブネットワークの標準サブネットワーク定義を指定する機能が備わっているためです。 「サブネットワーク定義」は、層の作成時に管理者が設定します。 [トレース (Trace)] ツールで層を指定すると、入力層に対するサブネットワーク トレース定義セットが詳細パラメーターに自動設定されます。 設定された「トレース構成」パラメーターは、トレースの実行前に、ツール内で手動で上書きできます。
サブネットワーク トレース構成は、トレースの設定中に修正または追加できます。 トレースするフィーチャおよびオブジェクトのタイプの制御 (6 インチ超のパイプ直径)、返されるネットワーク フィーチャのタイプの選択 (すべての開放バルブ)、「ネットワーク属性」を使用した計算の実行 (AB フェーズ ラインの長さの合計) などの操作を実行できます。
各構成要素について以下のセクションで説明します。 パラメーター オプションと使用法については、「トレース」ツールをご参照ください。
トレースの非同期実行
ArcGIS Pro 2.9 および ArcGIS Enterprise 10.9.1 以降、[サーバーでの非同期モードでの実行] パラメーターにより、UtilityNetworkTools ジオプロセシング サービスを使用してトレース操作を非同期に処理するオプションが提供されています。 このオプションは、「エンタープライズ配置」のユーティリティ ネットワークを操作する場合にのみ使用できます。 デフォルトでは、トレース操作は同期的に処理されます。
| 構成オプション | 説明 |
|---|---|
サーバーでの非同期モードでの実行 |
|
トレース範囲の定義
[トレース (Trace)] ツールでは、ネットワーク内のトレースで移動できる範囲を指定する必要があります。 トレース可能なエリアを定義することで、確実にネットワークの目的の部分をトレースできるようになります。 特定のトレース タイプでは、他の層への通過を制限するためにも使用します。 トレース可能なエリアの範囲を示すには、ドメイン ネットワーク、層、サブネットワークという 3 種類の情報を使用します。 トレースのタイプによって必要な情報の種類が決まるので、すべてのトレースでこれらのパラメーターを使用するわけではありません。
ドメイン ネットワークを指定すると、そのドメイン ネットワークのみにトレースが制限されます。 すべての「サブネットワークベースのトレース」で、ドメイン ネットワークを設定する必要があります。 一部のトレースでは、層とオプションのサブネットワークを指定する必要があります。 その他のトレース タイプでは、層とターゲット層を設定する必要があります (上流と下流)。 ターゲット層により、ドメイン ネットワーク内の複数の層にまたがってトレースできるようになります。
[トレース (Trace)] ツールで指定されている場合に、[層] パラメーターを使用して、トレースを特定の層に制限します。 また、これを使用して、トレース構成パラメーターに「サブネットワーク定義」の値セットを自動的に入力します。 [層] パラメーターと一緒に始点を使用する場合、始点は指定された層内に存在する必要があります。 [ターゲット層] パラメーターは、「上流および下流のトレース」に使用され、トレース可能なネットワークの境界を示します。トレースはターゲット層の内部を通過できますが、超えることはできません。
複数の層に対してトレースを行う場合、トレース構成の設定は最初の層から読み込まれます。 トレースが新しい層に遭遇するたびに、次のトレース構成の設定が読み込まれます:
- 通過可能性の適用範囲
- 条件バリア
- 関数バリア
- プロパゲーター
サブネットワーク トレースで、[サブネットワーク名] 値を設定すると、始点を使用せずに、トレースするサブネットワークを指定できるようになります。 この方法では、トレースの始点として指定されたサブネットワークのサブネットワーク コントローラーを使用します。
格納器、格納物、構造物、バリアを結果に含める
[トレース (Trace)] ツールのこの構成可能なオプション セットにより、結果に含まれるネットワーク フィーチャを、関連付けロールやバリア ステータスに基づいて構成できます。 関連付けフィーチャには、格納器、格納物、構造物があります。 デフォルトでは、格納器、その格納物、構造物以外がトレース結果として返されます。
格納器を含める
格納器をトレース結果に含めます。 トレースされる格納物フィーチャおよびオブジェクトのすべての格納器も、トレース結果に含められます。 この構成は、構造物ネットワークのトレースにも使用できます。接続された地中ダクトを返す場合などです。
| 構成オプション | 説明 |
|---|---|
格納器を含める |
|
最初の空間格納器まで含める
返される格納器を制限して、トレース結果の各ネットワーク エレメントの最初の空間格納器およびそれまで検出した格納器のみを含めるかどうかを指定します。 所定のネットワーク エレメントで、空間格納器が検出されず、非空間格納器のみがある場合、結果にはすべての非空間格納器が含まれます。 このパラメーターは、[格納器を含める] が有効な場合のみ使用できます。
| 構成オプション | 説明 |
|---|---|
最初の空間格納器まで含める |
|
格納物を含める
格納物フィーチャおよびオブジェクトをトレース結果に含めます。 これは、トレース結果に含まれている格納器の格納物も包含します。 異なるタイプの格納器間のあいまいさをなくすために、[出力] フィルターを使用して結果をフィルターします。
| 構成オプション | 説明 |
|---|---|
格納物を含める |
|
構造物を含める
構造物をトレース結果に含めます。 これは、構造物アセットのレポートなどのタスクに役立ちます。
| 構成オプション | 説明 |
|---|---|
構造物を含める |
|
バリア フィーチャを含める
「バリア」をトレース結果に含めます。 これには、[トレース] ウィンドウの [バリア] タブで設定されたフィーチャ バリアと、動的に構成されたバリア (条件バリア、関数バリア、フィルター バリア、関数バリアのフィルター) があります。 サブネットワーク定義を使用して、「サブネットワーク トレース構成」の一部として、トレース結果にバリアを含めるかどうかを構成できます。
注意:
トレースが返した選択セットは、バリアがミッドスパン接続でエッジ フィーチャに置かれており、[バリア フィーチャを含める] オプションがオフのとき、予期しない結果を表示することがあります。 フィーチャのいずれかの部分がトレースによって返された場合、全フィーチャが選択されてトレース結果に表示されます。
| 構成オプション | 説明 |
|---|---|
バリア フィーチャを含める |
注意:このトレース構成オプションは、サブネットワークベースの「トレース タイプ」の「サブネットワーク トレース構成」による影響も受けます。 これは、[層] パラメーターが指定されたときに読み込まれます。 |
注意:
[バリア フィーチャを含める] 構成オプションはターミナルを含むフィーチャには適用されません。
始点でバリアを無視する
「バリア」が始点である場合、トレース構成でそれらのバリアを無視します。 これは、上流の保護デバイスのトレースを実行し、検出された保護デバイス (バリア) を始点として使用して、その後の上流の保護デバイスを検索する場合に、役立ちます。
| 構成オプション | 説明 |
|---|---|
始点でバリアを無視する |
|
ネットワークの一貫性の確保
整合したネットワーク エリアとはダーティ エリアのないエリアのことです。 ネットワーク トポロジの検証は、トレースがネットワーク トポロジからネットワークに関する最新の情報を読み取っていることを保証する唯一の方法です。 一部のトレース タイプでは、トレース対象のサブネットワークもクリーンである必要があります。 詳細については、「サブネットワークのライフ サイクル」をご参照ください。
[トレース (Trace)] ツールの [一貫性の検証] オプションは、トレース結果のネットワーク トポロジの一貫性を保証します。 [一貫性の検証] が true に設定されている場合、ダーティ エリアがトレース パスと交差するとトレース操作が失敗します。 これが発生した場合、下の例に示すように、ダーティであると判明したトレース パス内のフィーチャまたはオブジェクトのクラス名および Global ID を含むエラーが返されます。
ERROR 002041: One or more dirty areas were discovered.
[[ElectricDistributionLine: {C0060506-AG17-4B64-B2E0-9162BE613C05}]]
Failed to execute (Trace).
次のシナリオでは、トレース結果に一貫性に関するエラーは発生しません。
- 新しく作成されたフィーチャのダーティ エリア。
- [格納器を含める] または [構造物を含める] オプションが有効ではない場合の、関連する格納器または構造物のダーティ エリア。
ダーティ エリアをクリーンにするか削除するには、「ネットワーク トポロジを検証」します。
[一貫性の検証] チェックボックスをオンにせずにトレースを実行すると、予期しないトレース結果が生成される場合があります。 たとえば、1 つのフィーチャがネットワークから削除され、これによって位置 A と位置 B 間のパスだけが切断されているシナリオを想定します。 削除したフィーチャのダーティ エリアが作成されますが、ネットワーク トポロジを検証する前に、[一貫性の検証] オプションをオフにした状態で、位置 A を始点としてトレースを実行し、「接続フィーチャを検索」します。 このシナリオでは、トレースが位置 B に到達し、ツールは警告が出ずに完了します。 位置 B に到達したのは、A と B を接続するフィーチャを削除したことが、検証操作の実行でネットワーク トポロジに反映されていないためです。
上の例で [一貫性の検証] オプションをオンにした場合、ダーティ エリアにトレースが到達して削除されたフィーチャをマークすると、トレースが失敗して、ダーティ エリアに遭遇したことをユーザーに知らせます。 トレースするエリアに関するトポロジの検証の後、トレースは位置 B に到達できなくなります。削除されたフィーチャがネットワーク トポロジに反映されたからです。 トレースされるエリアの範囲全体のネットワーク トポロジが検証されない場合、他のダーティ エリアが発生する可能性があります。
トレース可能な領域に関するネットワーク トポロジ内の情報が最新であっても、サブネットワークはダーティである場合があります。 トレース可能なサブネットワークが更新済みであることも確認してください。 詳細については、「サブネットワークの更新」をご参照ください。
| 構成オプション | 説明 |
|---|---|
一貫性の検証 | このオプションがオンのときに、ダーティ エリアがトレース パスと交差すると、トレースが失敗し、ツールよりエラーが返されます。 このオプションをオフにすると、ダーティ エリアは無視されます。 このオプションは、デフォルトでオンになっています。 |
非空間オブジェクトの配置可能性の確認
関連付けは、マップ上の非空間「ジャンクションおよびエッジ オブジェクト」の場所を決定し、視覚的に表現するために使用します。 この関連付けが削除されると、ジャンクションまたはエッジ オブジェクトが「未配置」になるシナリオが作成される可能性があります。 [トレース (Trace)] ツールと [サブネットワーク定義の設定 (Set Subnetwork Definition)] ツールの [配置可能性の検証] オプションは、通過したオブジェクトの関連付け階層の必要な格納の関連付け、付属物の関連付け、または接続性の関連付けがないオブジェクトを識別する機能を提供します。
[配置可能性の検証] が true に設定されている場合、トレースのパスで未配置のオブジェクトが検出されるとトレース操作が失敗し、エラーが表示されます。 この場合は、トレース パス内の未配置のオブジェクトのクラス名と Global ID を含むエラーがツールより返されます。以下にその例を示します。
ERROR 003326: Unlocatable objects discovered.
[[GasDistributionJunctionObject: {4F860903-PK17-5c15-Y2W0-3512BP436C00}]]
Failed to execute (Trace).
[関連付けの変更] ウィンドウは、オブジェクトを配置可能であると見なすための必要な関連付けを作成するために使用できます。
詳細については、「配置可能性」をご参照ください。
| 構成オプション | 説明 |
|---|---|
配置可能性の検証 | このオプションがオンのときに、未配置のオブジェクトが検出されると、トレースが失敗し、ツールよりエラーが返されます。 このオプションがオンになっていないと、未配置のオブジェクトのチェックは実行されません。 このオプションはデフォルトではオフになっています。 |
トレース内容の制御
トレース中は、停止位置を示すためにバリアが使用されます。その位置を超えるネットワーク フィーチャはトレースされません。 トレース結果には、バリアを超えるネットワーク フィーチャは含まれませんが、必要に応じてバリア自体を含めることができます。 [不定フローを許可] および [通過可能性] セクション内のパラメーターなどの他のパラメーターは、ネットワーク パスの通過可能性を管理する対象の定義に役立ちます。
不定フローを許可
上流トレース、下流トレース、分離トレースを実行する場合、サブネットワークのフロー方向が最初に決定し、次に始点に対する上流または下流のフィーチャおよびオブジェクトが返されます。 場合によっては、ループのあるシナリオなど、特定のフロー方向が識別できません。 このような場合、フローは「不定フロー」と定義されます。 デフォルトでは、不定フローのあるフィーチャおよびオブジェクトがトレース結果に含まれ、[不定フローを許可] パラメーターがオンになっています。 このオプションがオフの場合、不定フローがあるネットワーク フィーチャは、通過可能性が停止して、トレース結果に含まれません。 このパラメーターは、上流トレース、下流トレース、分離トレースを実行する場合にのみ適用されます。
| 構成オプション | 説明 |
|---|---|
不定フローを許可 |
|
通過可能性
[トレース (Trace)] ツールの [通過可能性] セクションには、トレースの通過可能性を制御する条件バリアと関数バリアがあります。 条件バリアはネットワーク属性またはネットワーク カテゴリに基づく式で、トレースを停止する場所を定義します。 関数バリアは、条件を満たしたときにトレースを停止するタイミングを定義します。
通過可能性の適用範囲は、[トレース (Trace)] ツールで [通過可能性の適用] 通過可能性の適用範囲パラメーターでさらに制御できます。 このパラメーターは、ジャンクションとエッジの両方、ジャンクションのみ、またはエッジのみに通過可能性を適用するかを決定します。 たとえば、通過可能性をジャンクションのみに適用し、エッジが条件バリアで指定された条件を満たしている場合、通過可能性の適用範囲により、トレースはエッジで停止しません。
詳細については、「バリア」をご参照ください。
関数の設定
関数は、トレースされたネットワーク フィーチャに関連付けられたネットワーク属性に対して計算 (たとえば、トレースされたすべてのワイヤーの長さの合計) を実行できるようにするトレース構成プロパティです。 1 つのトレースに対して複数の関数を指定できます。
さらに、オプションのネットワーク属性フィルターを各関数に追加することもできます。指定した場合、関数はネットワーク属性フィルターを満たすネットワーク フィーチャのみに適用されます。 関数内のフィルターは、条件付き要件を導入するために使用されます。たとえば、Phases Current 属性が値 ABC を含むすべてのラインの長さを合計します。
注意:
関数 (Add、Average、Count、Max、Min、Subtract) を含む割り当て可能なネットワーク属性を使用するトレース構成は、エッジ エレメントに基づいて割り当て可能な結果を返します。 たとえば、接続したトレース内の関数を使用して shape length 属性をカウントすると、ライン全体ではなく個々のエッジ フィーチャに基づくカウントが返されます。 詳細については、「割り当て可能なネットワーク属性」をご参照ください。
返される内容の制御
トレース結果で返される内容を制御するには、出力フィルターと結果タイプを使用します。
出力フィルター
出力フィルターは、フィルターに指定した条件に適合するかどうかを判別するために、トレース中に発生したすべてのネットワーク フィーチャを審査します。 たとえば、トレースは、電力ネットワークで始点からすべての上流への保護デバイスを返します。
[トレース (Trace)] ツールで使用できる [出力] フィルターのタイプは、[出力アセット タイプ] と [出力条件] の 2 つです。
[出力アセット タイプ] フィルターは、トレース結果に指定されたアセット タイプのみを含める場合に使用します。 たとえば、電気ネットワークのポール レポートに、結果にポールのみを含める出力アセット タイプ フィルターを設定します。
[出力条件] フィルターは、「ネットワーク カテゴリ」と「ネットワーク属性」をサポートします。 たとえば、ある出力条件は、特定のネットワーク カテゴリ名を使用して、ガス ネットワークのすべての個別デバイスを返す場合があります。 この操作では、個別ネットワーク カテゴリが割り当てられているすべてのフィーチャおよびオブジェクトが返されます。 ガス ネットワークのトレースでは、緊急時バルブ、バイパス バルブ、システム バルブ、ショート ストップを返すことができます。 このネットワーク カテゴリ以外のフィーチャおよびオブジェクトは、トレースはされますが、結果に含められません。
ネットワーク属性は、ネットワーク トポロジに格納され、1 つ以上のネットワーク クラスのフィールドに関連付けられます。 出力条件に、ネットワーク属性の名前、演算子、ネットワーク属性に有効な値を指定します。 水道網に漏れがある場合、ネットワーク属性を入力して、締めることのできるパイプを返します。 この場合、Line クラスに Pinchable という名前のフィールドがあります。 このフィールドは、[Pinchable] という名前のネットワーク属性に関連付けられています。 [出力条件] パラメーターを構成して、値が True である [Pinchable] ネットワーク属性を持つクラスを検索します。 トレース結果に、このフィールドと値 True を持つクラスのフィーチャおよびオブジェクトと、Pinchable フィールドのないクラスのネットワーク フィーチャが含まれます。
出力条件にネットワーク属性の動作を指定して、締めることのできるパイプを返すには、出力アセット タイプ フィルターを使用する必要があります。 たとえば、Esri が提供するガス ユーティリティ ネットワークの PipelineLine クラスの Distribution Pipe アセット グループで、Plastic PE アセット タイプを指定します。 2 つのフィルター IsPinchable = True AND AssetType = Plastic PE を使用すると、トレース結果には締めることのできる Plastic PE パイプのみが含まれます。
[結合方法] パラメーターを使用して、複数の [出力条件] 値を実装することができます。 どちらのタイプの出力も使用可能で、複数の出力タイプを設定できます。 出力タイプを組み合わせることで、たとえば、80 PSI を超える 12 インチの締めることのできる Plastic PE パイプをすべて返すように設定できます。
結果タイプ
オプションの [結果タイプ] パラメーターを使用すると、トレースによって返される結果のタイプを制御できます。
[集約されたジオメトリ]、[選択]、[接続性]、[エレメント]、[フィーチャ]、[格納および付属物の関連付け] の各結果タイプは、別々または同時に指定して、それぞれ、出力ジオメトリを生成する、トレース操作の選択セットを作成する、ジオメトリの一致または接続性の関連付けによって接続されたネットワーク フィーチャの接続性グラフを返す、フィーチャに基づく情報を返す、ジオメトリ、ネットワーク属性、ファイル情報を含めたフィーチャに基づく情報を返す、格納および構造物付属物の関連付けをよって関連付けられたフィーチャを .json ファイルに返す、などの処理を行えます。
| パラメーター | オプション |
|---|---|
結果タイプ |
注意:エンタープライズ ジオデータベースを操作する場合、次の要件を満たす必要があります。
|
[集約されたジオメトリ] オプションを使用すると、フィーチャクラスのマルチパート ジオメトリとしてトレース結果を得ることができます。 このオプションは、始点およびエッジ フィーチャのミッドスパンに配置されたバリアの位置を優先して、部分的なフィーチャの結果を返します。
以下の図で、下流トレースで選択と集約されたジオメトリの結果タイプ オプションを使用した場合の違いを比較してください。 下のネットワークは、9 つのエッジ エレメント (e1、e2、e3 などで表される) から構成される 5 つのライン フィーチャ (f1、f2、f3、f4、f5 で表される) を含みます。
バリア フィーチャを含むこの例では、選択結果が、9 つのエッジ エレメント (f1::e1、e2、e3、f2::e1、e2、f5::e1、e2) から構成される、7 つのポイント フィーチャと 5 つのライン フィーチャを返します。 集約されたジオメトリの結果では、同じフィーチャが返されますが、エッジ エレメント f1::e1,e2 および f5::e2 は除外されます。
[バリア フィーチャを含める] 構成オプションがオンで、エッジに沿ってバリアが配置されている場合、トレースはバリア フィーチャで停止し、そのエッジの部分的なフィーチャ ジオメトリをトレース結果に返します。 [バリア フィーチャを含める] オプションがオフの場合、トレースは、ミッドスパンの接続性によって検知された先行するラインの終点またはジャンクションで停止します。
下の例は、[バリア フィーチャを含める] オプションを使用して、トレース結果にバリア フィーチャを含めたり除いたりするときのトレース結果の違いを示しています。 この例では、始点とバリアの両方がエッジに沿って配置されています。 このオプションが有効な場合、選択結果は、9 つのエッジ エレメント (f1::e1、e2、e3、f2::e1、e2、f3::e1、f4::e1、f5::e1、e2) から構成される、6 つのポイント フィーチャと 5 つのライン フィーチャを返します。 集約されたジオメトリ結果は、同じ 5 つのライン フィーチャを返しますが、エッジ エレメント f1::e1 および f5::e2 を除外します。エッジ エレメント f1::e2 について部分的なジオメトリが返されます。 [バリア フィーチャを含める] がオフで、バリア フィーチャを除外しようとした場合、選択結果は変わりませんが、集約されたジオメトリの結果ではさらに f1::e2 が除外されます。
結果タイプに [集約されたジオメトリ] オプションが選択されている場合、トレース出力の振舞いを定義するために、追加で 5 つのパラメーターが用意されています。
- 以前のトレース結果をすべて消去
- トレース名
- 集約されたポイント
- 集約されたライン
- 集約されたポリゴン
[以前のトレース結果をすべて消去] チェックボックスは、集約されたジオメトリを格納するために選択されたフィーチャクラスのコンテンツに対して、切り捨てまたは追加を行うためのオプションを提供します。
| パラメーター | オプション |
|---|---|
以前のトレース結果をすべて消去 |
|
オプションの [トレース名] パラメーターを使用して、トレース操作の文字列識別子を作成し、トレース結果の識別を支援できます。 [以前のトレース結果をすべて消去] パラメーター チェックボックスをオフにして使用すると、複数のトレース操作を実行して、出力される集約されたジオメトリのフィーチャクラス内の結果を比較できます。
[集約されたポイント]、[集約されたライン]、[集約されたポリゴン] パラメーターを使用して、集約された結果ジオメトリを格納するためのフィーチャクラスを指定できます。 デフォルトでは次に示すように、各パラメーターに、プロジェクトのデフォルトのジオデータベースに格納されるシステム生成のフィーチャクラスが入力されます。
- Trace_Results_Aggregated_Lines - ライン フィーチャクラス
- Trace_Results_Aggregated_Points - マルチポイント フィーチャクラス
- Trace_Results_Aggregated_Polygons - ポリゴン フィーチャクラス
これらのフィーチャクラスは、存在しない場合、自動的に作成されます。 既存のフィーチャクラスも、集約されたジオメトリの格納に使用できます。 デフォルト以外のフィーチャクラスを使用する場合、そのフィーチャクラスは、TRACENAME という名前の文字列フィールドを含み、出力のジオメトリ タイプに一致する必要があります。
部分的なフィーチャの結果をともなう出力ジオメトリを生成すると、トレースをより正確に表現でき、他のタスクに対してトレース結果の比較や再利用が可能になります。
注意:
ジオプロセシング オプションの「ジオプロセシング ツールが既存のデータセットを上書きすることを許可」を無効にすると、集約されたジオメトリの結果タイプの出力フィーチャクラスがプロジェクトのデフォルト ジオデータベースに存在する場合、ツール検証の問題が生じる可能性があります。 これを解決するには、ジオプロセシング オプションを有効にするか、プロジェクトのデフォルト ジオデータベースで集約されたポイント、ライン、ポリゴン フィーチャクラスの名前を変更します。
結果タイプで [選択] オプションを選択した場合は、追加の [選択タイプ] パラメーターで、選択の適用方法や選択がすでに存在する場合に実行する操作を定義できます。
| パラメーター | オプション |
|---|---|
選択タイプ |
|
[接続性] 結果タイプ オプションは、トレースの結果を、ジオメトリの一致または接続性の関連付けによって接続されたネットワーク フィーチャの接続性グラフとして返します。 このオプションを選択すると、接続性は、指定した場所にある解析可能な .json ファイルに出力され、データをユーザー独自のグラフに表すため、他のシステムにインポートされます。 接続性情報は、トレースによって返されたネットワーク フィーチャに対してのみ返されます。 .json 出力ファイルには、connctivity の下位で通過したすべてのネットワーク フィーチャに対する次の情報が格納されます:
- fromNetworkSourceId
- fromGlobalId
- fromObjectId
- fromTerminalId
- fromGeometry
- viaNetworkSourceId
- viaGlobalId
- viaObjectId
- viaPositionFrom
- viaPositionTo
- viaGeometry
- toNetworkSourceId
- toGlobalId
- toObjectId
- toTerminalId
- toGeometry
[エレメント] 結果タイプ オプションは、トレースの結果を、フィーチャに基づく情報として、指定された .json 出力ファイルに返します。このファイルは、追加の解析を実行するための入力として使用できます。 .json 出力ファイルには、elements の下位で通過したすべてのネットワーク フィーチャに対する次の情報が格納されます。
- networkSourceId
- globalId
- objectId
- assetGroupCode
- assetTypeCode
ポイント フィーチャおよびジャンクション オブジェクトに対して、追加情報が返されます:
- terminalId
ライン フィーチャおよびエッジ オブジェクトに対して、追加情報が返されます:
- positionFrom
- positionTo
[フィーチャ] 結果タイプ オプションは、トレースの結果をフィーチャに基づく情報として、指定した出力 .json ファイルに返します。 [エレメント] オプションと同様に、このオプションを使用すると、他のアプリケーションで使用するための追加情報 (フィーチャ ジオメトリ、ネットワーク属性に関する情報、属性フィールドの値、など) を出力に含めることができます。 出力 .json ファイルには、featureElements の下にあるすべての通過したネットワーク フィーチャに対して上記の [エレメント] が返すのと同じ情報が、以下の追加情報とともに含まれます:
[ジオメトリを含める] で返される情報 (ジャンクションおよびエッジ オブジェクトには存在しません):
- geometry
[ドメインの説明を含める] で返される情報:
- networkSourceName
- assetGroupName
- assetTypeName
- networkAttributeDescriptions ([結果のネットワーク属性] が指定されている場合)
ポイント フィーチャおよびジャンクション オブジェクトに対して、追加情報が返されます:
- terminalName
[結果のネットワーク属性] で返される情報:
- networkAttributeValues
[結果フィールド] で返される情報:
- fieldValues
[格納および付属物の関連付け] 結果タイプ オプションは、格納および構造物付属物の関連付けによって関連付けられた通過済みのネットワーク フィーチャの関連付け情報を、指定した出力 .json ファイルに返します。 .json 出力ファイルには、associations の下位で通過したすべてのネットワーク フィーチャに対する次の情報が格納されます:
- associationType
- fromNetworkSourceId
- fromGlobalId
- fromTerminalId
- toNetworkSourceId
- toGlobalId
- toTerminalId
[ドメインの説明を含める] で返される情報:
- fromNetworkSourceName
- fromTerminalName
- toNetworkSourceName
- toTerminalName
特定の [結果タイプ] オプションが選択された場合に、追加のパラメーターが有効になります:
- [接続性]、[エレメント]、[フィーチャ]、[格納および付属物の関連付け] の各オプションが選択された場合、追加の [出力 JSON] パラメーターが、出力 .json ファイルの場所を指定するために追加されます。
- [フィーチャ] または [格納および付属物の関連付け] オプションが選択された場合、追加の [ドメインの説明を含める] パラメーターが、通過したネットワーク フィーチャのドメインの説明を含めるために追加されます。
- [フィーチャ] オプションが選択された場合、[ジオメトリを含める]、[結果のネットワーク属性]、および [結果フィールド] パラメーターが、通過したネットワーク フィーチャのフィーチャ ジオメトリ、ネットワーク属性の情報、およびフィールド レベルの情報を出力するために追加されます。
[接続性]、[エレメント]、[フィーチャ]、[格納および付属物の関連付け] のオプションが選択された場合、出力 .json ファイルに sourceMapping エレメントが含められ、ファイルの下部に配置されます。 このエレメントにより、各 networkSourceId に関連付けられたレイヤー名を検索できます。"sourceMapping": {
"1": "UN_6_Associations",
"2": "UN_6_SystemJunctions",
"4": "Structure Junction",
"5": "Structure Line",
"6": "Structure Boundary",
"7": "Structure Junction Object",
"8": "Structure Edge Object",
"9": "Electric Distribution Device",
"10": "Electric Distribution Line",
"11": "Electric Distribution Assembly",
"12": "Electric Distribution Junction",
"13": "Electric Distribution SubnetLine",
"14": "Electric Distribution Junction Object",
"15": "Electric Distribution Edge Object"
},
ビット単位の演算子の操作
トレース構成は、バリア、フィルター、関数、およびトレース結果の出力を定義するために使用される演算子の共通のセットを使用します。 標準的な演算子は、フィーチャ属性を評価して、ある値に等しいか、ある値より小さいか、または大きいかを判別するために使用されます。
トレース構成で使用される標準的な演算子は、等しい、等しくない、より大きい、以上、より小さい、以下です。
ビット単位の演算子は、値のビット セットを解析することによって、ビットの使用を論理に組み込みます。 これらの演算子は、機能および柔軟性を高め、高度なトレース アプリケーションにおいて一般的に使用されます。 トレース フレームワークは、ユーザーが定義する意味とは無関係に、それらのビットを操作することができます。
トレース構成で使用されるビット単位の演算子には以下が含まれます:
- 値を含む - 値のすべてのビットが属性内に存在するビット単位の論理積演算 (bitwise AND == value)。
- 値を含まない - 値の一部のビットが属性内に存在しないビット単位の論理積演算 (bitwise AND != value)。
- いずれかを含む - 値の少なくとも 1 つのビットが属性内に存在するビット単位の論理積演算 (bitwise AND == True)。
- いずれも含まない - 値のビットが属性内に存在しないビット単位の論理積演算 (bitwise AND == False)。
電力ユーティリティ ネットワーク内のフェーズをモデル化するときに、ビット セットを使用するようにデータセットを構成できます。 値のセットが、許容されるフェーズの組み合わせおよびビット表現 (各ビットが意味を持っている) ごとに構成されます。 コード値ドメインが、許容できるフェーズ値を使用して構成され、フェーズを使用する属性に割り当てられます。 トレース構成で使用するために、フェーズ フィールドで、ネットワーク属性が構成されます。
下の表は、ビット セットを使用してフェーズをモデル化する方法の概要を示しています。 ビット値がコードとして格納され、フェーズ値が、コード値ドメインで説明に使用されます。 表のバイナリ列は、各ビット セットのバイナリ リプレゼンテーションを示しています。 ビット単位の演算子は、属性をビットに分解し、各ビットを評価して、演算論理を満たすかどうかを判別します。 ネットワーク属性が AC (101) であり、比較される値が BC (011) である場合、値を含む演算子は、中央のビット (B) が AC に含まれていないため、True であると評価せず、一方、いずれかの値を含む演算子は、ビット C が AC および BC の両方に含まれているため、True であると評価します。
| バイナリ | ビット値 | フェーズ値 |
|---|---|---|
001 | 1 | C |
010 | 2 | B |
100 | 4 | A |
011 | 3 | BC |
101 | 5 | AC |
110 | 6 | AB |
111 | 7 | ABC |
例: A を含んでいるフェーズの現在値を持つサブネットワーク内のすべてのネットワーク フィーチャを見つけるために、配電ドメイン ネットワーク上でサブネットワーク トレースが実行されます。 始点が、A のフェーズの現在値を持つ供給ポイント上に設定され、以降のトレース構成が、フィルター バリアとして指定されます。 フィルター バリアは、フェーズ A を含んでいないフィーチャおよびオブジェクトをトレース結果から除外するように構成されます。 バリア フィーチャをトレース結果に含めないようにするには、トレース構成オプション [バリア フィーチャを含める] を False に設定します。 トレース結果は、A の Phases Current 値または A を含んでいる Phases Current 値を持つサブネットワーク フィーチャを含みます。Filter Barriers
Name: E:Phases Propagated
Operator: Does not include any (Bitwise AND equals False)
Type: Specific value
Value: 4 (code for A)
トレースしたネットワーク フィーチャに対する計算の実行
ユーティリティ ネットワークには、サブネットワークが更新またはトレースされたときに使用される、属性の伝達と呼ばれる高度な機能があります。
属性代替を処理するには、データベース フィールドのネットワーク属性を構成します。 代替は一種のネットワーク属性であり、その値を使用して、属性代替カテゴリがアセット タイプに割り当てられているフィーチャに反映される値が算出されます。 この後、結果として生成される代替値を使用して、次の接続フィーチャの値が算出されます。 属性代替を使用するには、属性の反映を構成する必要があります。
名前付きトレース構成の読み込み
名前付きトレース構成では、共有と再利用のために作成する複雑なトレースをすることができます。 [トレース (Trace)] ツールを使用すると、既存の名前付きトレース構成を読み込み、トレースのプロパティを定義できます。 これにより、トレースに関連付けられたユーザー エクスペリエンスが簡素化され、組織内に共通したトレースの再利用の一貫性をもたらします。
| パラメーター | オプション |
|---|---|
トレース構成の使用 |
|
[トレース構成名] パラメーターは、トレースのプロパティを定義するトレース構成の名前を指定します。 このパラメーターは、[トレース構成の使用] が有効な場合にのみ使用できます。
注意:
また、[トレース] ウィンドウの [指定構成] タブで、すでに構成済みの「名前付きトレース構成」を使用してトレースを実行することもできます。