トレースの構成

トレース ネットワークでのトレースは、ネットワークの状態に関する問題を解決し、疑問に回答するのに常時役立ちます。トレース ネットワークをトレースするには、[トレース (Trace)] ツールを使用します。

[トレース (Trace)] ツールでは、さまざまなトレース タイプを使用できます。

これらのトレース タイプと合わせて、[トレース (Trace)] ツールには、提供される各トレース タイプの調整に使用する詳細構成の包括的なセットが含まれています。これらの構成により、通過可能性を構成し、返されるフィーチャを識別し、実行する計算を設定できます。ModelBuilder を使用して複雑な構成を保存し、モデル ツールのインターフェイスに表示されるパラメーターの数を減らすこともできます。これにより、詳細なトレースを 1 クリックのみで再実行できるようになります。

各構成要素について以下のセクションで説明します。パラメーター オプションと使用法については、「トレース (Trace)」ツールをご参照ください。

結果にバリアを含める

デフォルトでは、始点と並んでバリア フィーチャが存在しなければ、バリア フィーチャはトレースの結果の中に返されます。これは [バリア フィーチャを含める] および [始点でバリアを無視する] オプションを使用して制御できます。

バリア フィーチャを含める

バリアをトレースの結果に含めます。これは、[トレース位置] ウィンドウのフィーチャ バリア セットと動的に構成されたバリア (条件バリア、関数バリア、フィルター バリア、フィルター関数バリア) を包含します。

トレースが返した選択セットは、バリアがミッドスパン接続でエッジ フィーチャに置かれており、[バリア フィーチャを含める] オプションが無効のとき、予期しない結果を表示することがあります。フィーチャのいずれかの部分がトレースによって返された場合、全フィーチャが選択されてトレース結果に表示されます。

構成オプション説明

バリア フィーチャを含める

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

始点でバリアを無視する

バリアが始点である場合、トレース構成でそれらのバリアを無視します。

構成オプション説明

始点でバリアを無視する

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

ネットワークの一貫性の確保

ネットワークの一貫したエリアは、ネットワーク トポロジが検証され、ダーティ エリアがないエリアです。検証は、トレースがネットワーク トポロジからネットワークに関する最新の情報を読み取っていることを保証する唯一の方法です。

[トレース (Trace)] ツールの [一貫性の検証] 構成オプションは、トレース結果のネットワーク トポロジの一貫性を保証します。[一貫性の検証] が true に設定されている場合、ダーティ エリアがトレース パスと交差するとトレース操作が失敗します。これが発生した場合、下の例に示すように、ダーティであると判明したトレース パス内のフィーチャのクラス名および Global ID を含むエラーがツールによって返されます。

ERROR 002041: One or more dirty areas were discovered.
[[NHDFlowline: {0DBFACDA-45D6-BA67-33CE-A750BE632C05}]]
Failed to execute (Trace).

編集に関連付けられたダーティ エリアを削除するには、ネットワーク トポロジを検証する必要があります。

メモ:

トレース結果に不整合に関するエラーを発生させるのは、削除操作、既存のネットワーク フィーチャの更新、またはエラー フィーチャの作成によって作成されたダーティ エリアのみです。新しく作成されたフィーチャのダーティ エリアからは、[一貫性の検証] チェックの失敗は発生しません。

[一貫性の検証] チェックボックスをオンにしないで実行したトレースは、予期しないトレース結果につながる場合があります。たとえば、1 つのフィーチャがネットワークから削除され、これによって位置 A と位置 B の間のパスだけが切断されている場合、削除されたフィーチャに対してダーティ エリアが作成されます。ネットワーク トポロジの検証の前に、[一貫性の検証] オプションをオフにした状態で、位置 A を起点としてトレースを実行し、接続されたフィーチャを検索します。このトレースは位置 B に到達し、ツールは警告なしで完了します。位置 B に到達したのは、A と B を接続するフィーチャを削除したことが、検証操作により、ネットワーク トポロジで更新されていないためです。

上のシナリオで [一貫性の検証] オプションをオンにした場合、ダーティ エリアにトレースが到達して削除されたフィーチャをマークすると、ツールがエラーを返し、ダーティ エリアに遭遇してトレースが失敗したことをユーザーに知らせます。トレースするエリアに関するトポロジの検証の後、トレースは位置 B に到達できなくなります。削除されたフィーチャがネットワーク トポロジに反映されたからです。トレースされるエリアの範囲全体のネットワーク トポロジが検証されない場合、他のダーティ エリアも発生する可能性があります。

構成オプション説明

一貫性の検証

  • オン - ダーティ エリアがトレース対象のフィーチャと交差している場合、ツールがエラーを返します。これがデフォルトです。
  • オフ - ダーティ エリアは無視されます。

トレースされる内容の制御

トレース中は、停止位置を示すためにバリアが使用されます。その位置を超えるフィーチャはトレースされません。トレースの結果には、バリアを超えるフィーチャは含まれませんが、必要に応じてバリア自体を含めることができます。[結果タイプ] パラメーターは、トレース結果の中に部分的なフィーチャをジオメトリとして返すことを可能にする、[集約されたジオメトリ] オプションを提供します。

[トレース (Trace)] ツールの [高度なオプション] セクションには、トレースの通過可能性を制御する [条件バリア][関数バリア] があります。条件バリアはネットワーク属性に基づく式で、トレースを停止する場所を定義します。関数バリアは、条件を満たしたときにトレースを停止する場所を定義します。

通過可能性の適用範囲は、[トレース (Trace)] ツールで [通過可能性の適用] とラベルが付けられている、traversability_scope パラメーターでさらに制御されます。このパラメーターは、ジャンクションとエッジの両方、ジャンクションのみ、またはエッジのみに通過可能性を適用するかを決定します。たとえば、通過可能性をジャンクションのみに適用し、エッジが条件バリアで指定された条件を満たしている場合、通過可能性の適用範囲により、トレースはエッジで停止しません。

詳細については、「バリア」をご参照ください。

関数の設定

関数は、トレース対象のフィーチャに関連付けられたネットワーク属性に関する計算を実行できるトレース構成です。オプションのネットワーク属性フィルターを各関数に追加できます。指定すると、関数は、ネットワーク属性フィルターに適合するフィーチャにのみ適用されます。関数内のフィルターを使用して、条件付き要件を導入します。たとえば、PathType 属性が値 Paved を含むすべてのラインの長さを合計します。1 つのトレースに対して複数の関数を指定できます。

返される内容の制御

トレースの結果に返されるものを制御するために、[出力条件] および [結果タイプ] という 2 つのパラメーターが用意されています。

出力条件

[出力条件] フィルターは、ネットワーク属性の使用をサポートし、フィルターに指定した条件に適合するかどうかを確認するために、トレース中に発生したすべてのフィーチャをスクリーニングします。ネットワーク属性は、ネットワーク トポロジに存在し、1 つ以上のフィーチャクラスのフィールドに関連付けられます。出力条件に、ネットワーク属性の名前、演算子、ネットワーク属性に有効な値を指定します。

トレイル ネットワークに関するシナリオを考えます。この場合、舗装された道路を返すためにネットワーク属性が入力されます。この場合、Trails クラスに PathType という名前のフィールドがあります。このフィールドは、[Surface] という名前のネットワーク属性に関連付けられています。[出力条件] パラメーターを構成して、値が [Paved] に等しい [Surface] ネットワーク属性を持つフィーチャクラスを検索します。トレースの結果に、このフィールドと値 [Paved] を持つフィーチャクラスのフィーチャと、PathType フィールドのないクラスのフィーチャが含まれます。

[結合方法] パラメーターを使用して、複数の [出力条件] 値を実装することができます。どちらのタイプの出力も使用可能で、複数の出力タイプを設定できます。出力タイプを組み合わせることで、たとえば、長さ 1,000 m を超えるすべての舗装道路を返すように設定できます。

結果タイプ

オプションの [結果タイプ] パラメーターを使用することで、トレースによって返される結果のタイプを制御できます。[集約されたジオメトリ] および [選択] 結果タイプを別々または同時に指定し、トレース操作の出力ジオメトリおよび選択を生成できます。

パラメーターオプション

結果タイプ

  • [選択] - トレース操作の結果は、該当するネットワーク フィーチャの選択セットとして返されます。これがデフォルトです。
  • [集約されたジオメトリ] - トレース操作の結果は、ジオメトリ タイプ別に集約され、アクティブなマップのレイヤー内に表示されるフィーチャクラスに格納されます。

[集約されたジオメトリ] オプションを使用すると、トレース結果をフィーチャクラス内のマルチパート ジオメトリとして返すことができます。これによって、始点とエッジ フィーチャの中間部に配置されるバリアの位置が適用され、部分的なフィーチャの結果が返されます。

下の図を確認し、下流方向のトレースにおける選択および集約されたジオメトリの結果タイプ オプションの違いを比較します。下のネットワークは、9 つのエッジ エレメント (e1、e2、e3 などで表される) から構成される 5 つのライン フィーチャ (f1、f2、f3、f4、および f5 で表される) を含みます。

バリア フィーチャを含むこの例では、選択結果が、7 つのエッジ エレメント (f1::e1、e2、e3、f2::e1、e2、および f5::e1、e2) から構成される、5 つのポイント フィーチャと 3 つのライン フィーチャを返します。集約されたジオメトリ結果は、同じフィーチャを返しますが、エッジエレメント f1::e1、e2 および f5::e2 を除外します。

選択および集約されたジオメトリ オプションを使用する下流方向のトレース結果

[バリア フィーチャを含める] 構成オプションがオンに設定されたエッジに沿ってバリアが配置されると、トレースはバリア フィーチャで停止し、エッジの部分的なフィーチャ ジオメトリをトレース結果に返します。[バリア フィーチャを含める] オプションがオフの場合、トレースは中間部の接続性で発生する先行のライン端点またはジャンクションで停止します。

下図は、[バリア フィーチャを含める] オプションを使用して、トレース結果にバリア フィーチャを含めたり除いたりするときのトレース結果の違いを示しています。この例では、始点とバリアの両方がエッジに沿って配置されています。このオプションが有効な場合、選択結果は、7 つのエッジ エレメント (f1::e1、e2、e3、f2::e1、e2、および f5::e1、e2) から構成される、4 つのポイント フィーチャと 3 つのライン フィーチャを返します。集約されたジオメトリ結果は、同じ 3 つのフィーチャを返しますが、エッジエレメント f1::e1 および f5::e2 を除外します。[バリア フィーチャを含める] をオフにして、バリア フィーチャを除外する場合、選択結果は変わりません。ただし、集約されたジオメトリ結果は、さらに f1::e2 を除外します。

構成オプションが有効な場合と無効な場合のトレース結果の比較

結果タイプに [集約されたジオメトリ] オプションが選択されている場合、トレース出力の振舞いを定義するために、追加で 4 つのパラメーターが用意されています。

  • 以前のトレース結果をすべて消去
  • トレース名
  • 集約されたポイント
  • 集約されたライン

[以前のトレース結果をすべて消去] チェックボックスは、集約されたジオメトリを格納するために選択されたフィーチャクラスのコンテンツに対して、切り捨てまたは追加を行うためのオプションを提供します。

パラメーターオプション

以前のトレース結果をすべて消去

  • オン - 集約されたトレース ジオメトリを格納するフィーチャクラスは切り捨てられます。現在のトレース操作の出力ジオメトリのみが書き込まれます。これがデフォルトです。
  • オフ - 現在のトレース操作の出力ジオメトリが、集約されたジオメトリを格納するフィーチャクラスに追加されます。

オプションの [トレース名] パラメーターを使用して、トレース操作の文字列識別子を作成し、トレース結果の識別を支援できます。

[集約されたポイント] および [集約されたライン] パラメーターを使用して、集約された結果ジオメトリを格納するためのフィーチャクラスを指定できます。デフォルトでは次に示すように、各パラメーターに、プロジェクトのデフォルトのジオデータベースに格納されるシステム生成のフィーチャクラスが入力されます。

  • Trace_Results_Aggregated_Lines - ライン フィーチャクラス
  • Trace_Results_Aggregated_Points - マルチポイント フィーチャクラス

これらのフィーチャクラスは、存在しない場合、自動的に作成されます。既存のフィーチャクラスも、集約されたジオメトリの格納に使用できます。デフォルト以外のフィーチャクラスを使用する場合、そのフィーチャクラスは、TRACENAME という名前の文字列フィールドを含み、出力のジオメトリ タイプに一致する必要があります。

部分的なフィーチャの結果を持つ出力ジオメトリの生成は、より正確なトレースの表現をもたらし、他のタスクのためにトレース結果の比較と再利用を可能にします。

結果タイプに [選択] オプションが選択されている場合、選択がどのように適用されるか、および選択がすでに存在する場合にどのようなアクションを実行するかを定義するために追加の [選択タイプ] パラメーターが用意されています。

パラメーターオプション

選択タイプ

  • [新しい選択] - 結果として得られる選択によって、現在の選択が置換されます。これがデフォルトです。
  • [現在の選択に追加] - 選択が存在する場合、結果として得られる選択が現在の選択に追加されます。選択が存在しない場合は、新規選択セット オプションと同じです。
  • [現在の選択から削除] - 結果として得られる選択が現在の選択から削除されます。選択が存在しない場合、このオプションは影響を与えません。新規選択セット オプションと同じです。
  • [現在の選択からサブセットを選択] - 結果として得られる選択が現在の選択に組み合わせられます。両方に共通のレコードだけが選択された状態となります。
  • [現在の選択の切り替え] - 結果として得られる選択が切り替わります。選択された結果が現在の選択から削除され、選択されなかった結果が現在の選択に追加されます。選択が存在しない場合は、新規選択セット オプションと同じです。