Skip to main content

トレースの構成

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

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

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

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

結果にバリアを含める

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

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

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

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

構成オプション

説明

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

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

  • オフ - バリア フィーチャをトレース結果に含めません。

始点でバリアを無視する

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

構成オプション

説明

始点でバリアを無視

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

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

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

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

トレース ツールの 一貫性の検証 構成オプションは、トレース結果のネットワーク トポロジーの一貫性を保証します。 一貫性の検証 が 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 に到達できなくなります。削除されたフィーチャが、ネットワーク トポロジーに反映されたからです。 トレースされるエリアの範囲全体のネットワーク トポロジーが検証されない場合、他のダーティー エリアも発生する可能性があります。

構成オプション

説明

一貫性の検証

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

  • オフ - ダーティー エリアは無視されます。

トレース内容の制御

トレース中は、停止位置を示すためにバリアが使用されます。その位置を超えるフィーチャはトレースされません。 トレースの結果には、バリアを超えるフィーチャは含まれませんが、必要に応じてバリア自体を含めることができます。 不定フローを許可 および 高度な設定 内のパラメーターなどの他のパラメーターは、ネットワーク パスの通過可能性を管理する対象の定義に役立ちます。

不定フローを許可

上流トレースや下流トレースを実行する場合、トレース解析は Flow direction ネットワーク属性内の値を使用して方向性を決定します。 一部のシナリオでは、双方向の流れを示す不定フロー方向のライン フィーチャがある場合があります。 このオプションは、パスに沿った不定フローがあるフィーチャをトレースするか、トレースの通過可能性を停止するかを指定します。 このパラメーターは、上流トレースまたは下流トレースを実行する場合にのみ適用されます。

構成オプション

説明

不定フローを許可

  • オン - 不定フローのあるフィーチャをトレースします。

  • オフ - パスに沿った不定フローのあるフィーチャの通過可能性が停止し、そのフィーチャがトレースされません。 これがデフォルトです。

高度な設定

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

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

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

関数の設定

関数は、トレースされたネットワーク フィーチャに関連付けられたネットワーク属性に対して、計算 (たとえば、トレースされたすべてのワイヤの長さの合計) を実行できるようにする、トレース構成プロパティです。 1 つのトレースに対して、複数の関数を指定できます。

さらに、オプションの関数名 (関数名) と属性フィルター (フィルター名、フィルター演算子、フィルター タイプ、フィルター値)を、各関数に追加できます。 関数名では、関数出力を説明しコンテキストを提供するためのエイリアスを指定します。 属性フィルター名を指定した場合、その関数は属性フィルターを満たすネットワーク フィーチャにのみ適用されます。 関数内のフィルターを使用して、条件付き要件を導入します。 たとえば、PathType 属性が値 Paved を含むすべてのラインの長さを合計します。 1 つのトレースに対して、複数の関数を指定できます。

注意:

関数 (Add、Average、Count、Max、Min、Subtract) を含む割り当て可能なネットワーク属性を使用するトレースは、エッジ エレメントに基づいて割り当て可能な結果を返します。 たとえば、接続トレース内の関数を使用して shape length 属性をカウントすると、ライン全体ではなく個々のエッジ フィーチャに基づくカウントが返されます。 詳細については、「割り当て可能なネットワーク属性」をご参照ください。

返される内容の制御

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

出力条件

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

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

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

結果タイプ

オプションの 結果タイプ パラメーターを使用すると、トレースによって返される結果のタイプを制御できます。 集約されたジオメトリー、選択、ネットワーク レイヤー、接続性、エレメント の各結果タイプは、別々または同時に指定して、それぞれ、フィーチャ レイヤーの出力ジオメトリーを生成する、選択セットを生成する、グループ レイヤー内のフィーチャ レイヤーの選択セットとしてトレース結果を返す、幾何学的一致によって接続されたネットワーク機能の接続性グラフを返す、フィーチャに基づく情報を .json ファイルに返す、などの処理を行えます。

パラメーター

オプション

結果タイプ

  • 選択 - トレース操作の結果は、該当するネットワーク フィーチャの選択セットとして返されます。 これがデフォルトです。

  • 集約されたジオメトリー - トレース操作の結果は、ジオメトリー タイプ別に集約され、アクティブなマップのレイヤー内に表示されるフィーチャクラスに格納されます。

  • ネットワーク レイヤー - トレースにより返されたフィーチャの選択セットを含むフィーチャ レイヤーを格納するグループ レイヤーを作成します。

  • 接続性 - トレースの結果が接続性グラフとして、指定した .json 出力ファイルに返されます。

  • エレメント - トレースの結果がフィーチャに基づく情報として、指定した .json 出力ファイルに返されます。

注意:

エンタープライズ ジオデータベースの場合、接続性 オプションを使用するには、ArcGIS Enterprise 10.9.1 以降が必要です。

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

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

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

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

バリア フィーチャを含める 構成オプションがオンで、エッジに沿ってバリアが配置されている場合、トレースは、バリア フィーチャで停止し、そのエッジの部分的なフィーチャ ジオメトリーをトレース結果に返します。 バリア フィーチャを含める オプションがオフの場合、トレースは、ミッドスパンの接続性によって検知された、先行するラインの終点またはジャンクションで停止します。

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

バリア フィーチャを含める構成オプションが有効な場合と無効な場合のトレース結果の比較

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

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

  • トレース名

  • 集約されたポイント

  • 集約されたライン

以前のトレース結果をすべて消去 チェックボックスを使用して、集約されたジオメトリーを格納するために選択されたフィーチャクラスのコンテンツに対して、切り捨てまたはアペンドを行うことができます。 デフォルト オプションは、以前のトレース結果を上書きし、現在のトレース操作のみに関する集約されたジオメトリーを表示します。

パラメーター

オプション

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

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

  • オフ - 現在のトレース操作の出力ジオメトリーが、集約されたジオメトリーを格納するフィーチャクラスにアペンドされます。

オプションの トレース名 パラメーターを使用して、トレース操作の文字列識別子を作成し、トレース結果の識別を支援できます。 以前のトレース結果をすべて消去 パラメーター チェックボックスをオフにして使用すると、複数のトレース操作を実行して、出力される集約されたジオメトリーのフィーチャクラス内の結果を比較できます。

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

  • Trace_Results_Aggregated_Lines - ライン フィーチャクラス

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

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

部分的なフィーチャの結果をともなう出力ジオメトリーを生成すると、トレースをより正確に表現でき、他のタスクに対して、トレース結果の比較や再利用が可能になります。

注意:

ジオプロセシング オプションのジオプロセシング ツールが既存のデータセットを上書きすることを許可を無効にすると、集約されたジオメトリーの結果タイプの出力フィーチャクラスが、プロジェクトのデフォルト ジオデータベースに存在する場合、ツール検証の問題が生じる可能性があります。 これを解決するには、ジオプロセシング オプションを有効にするか、プロジェクトのデフォルト ジオデータベースで集約されたポイント、ライン、およびポリゴン フィーチャクラスの名前を変更します。

結果タイプで、選択 オプションを選択した場合は、追加の 選択タイプ パラメーターで、選択の適用方法や選択がすでに存在する場合に、実行する操作を定義できます。

パラメーター

オプション

選択タイプ

  • 新しい選択 - 結果として得られた選択によって、現在の選択が置換されます。 これがデフォルトです。

  • 現在の選択に追加 - 選択が存在する場合、結果として得られる選択が、現在の選択に追加されます。 選択が存在しない場合は、新しい選択オプションと同じです。

  • 現在の選択から削除 - 結果として得られた選択が、現在の選択から削除されます。 選択が存在しない場合、このオプションは影響を与えません。新しい選択オプションと同じです。

  • 現在の選択からサブセットを選択 - 結果として得られた選択を現在の選択と組み合せます。 両方に共通のレコードだけが、選択された状態となります。

  • 現在の選択の切り替え - 結果として得られる選択が、切り替えられます。 選択された結果が現在の選択から削除され、選択されなかった結果が現在の選択に追加されます。 選択が存在しない場合は、新しい選択オプションと同じです。

ネットワーク レイヤー 結果タイプ オプションは、グループ レイヤー内のフィーチャ レイヤーの選択セットとしてトレース結果を返します。 ArcGIS Pro でこのオプションを選択すると、新しいグループ レイヤーがマップに追加されます。 フィーチャ レイヤーは、トレースによって返されたフィーチャを含むクラスでのみ作成されます。 各フィーチャ レイヤーには、ModelBuilder および Python のトレースの結果を操作するために使用できる、トレースにより返されたフィーチャの選択セットが格納されます。

ネットワーク レイヤー オプションを選択して、追加の 出力グループ レイヤー名 パラメーターで、作成する出力グループ レイヤーの名前を付けます。 ArcGIS Pro で操作する場合、新しいグループ レイヤーが指定した名前でアクティブなマップに追加されます。

接続性 結果タイプ オプションは、トレースの結果を、ジオメトリーの一致によって接続されたネットワーク フィーチャの接続性グラフとして返します。 このオプションを選択すると、接続性は、指定した場所にある解析可能な .json ファイルに出力され、データをユーザー独自のグラフに表すため、他のシステムにインポートされます。 接続性情報は、トレースによって返されたネットワーク フィーチャに対してのみ返されます。

結果タイプとして 接続性 オプションが選択された場合、追加の 出力 JSON パラメーターが、.json 出力ファイルの場所を指定するために追加されます。

エレメント 結果タイプ オプションは、トレースの結果を、フィーチャに基づく情報として返します。 このオプションを選択した場合、フィーチャに基づく情報が、指定された場所にある .json ファイルに出力されます。このファイルは、追加の解析を実行するための入力として使用できます。

エレメント オプションが選択された場合、追加の 出力 JSON パラメーターが、.json 出力ファイルの場所を指定するために追加されます。 .json 出力ファイルには、elements の下位で通過したすべてのネットワーク フィーチャに対する、次の情報が格納されます。

  • networkSourceId

  • globalId

  • objectId

追加情報はライン フィーチャに対して返されます。

  • positionFrom および positionTo

指定トレース構成の読み込み

指定トレース構成では、共有と再利用のために作成する、複雑なトレースをすることができます。 トレース ツールを使用すると、既存の指定トレース構成を読み込み、トレースのプロパティを定義できます。 これにより、トレースに関連付けられたユーザー エクスペリエンスが簡素化され、組織内に共通したトレースの再利用の一貫性をもたらします。

パラメーター

オプション

トレース構成の使用

  • オン - ツールは、トレースのプロパティを定義するために、既存の指定トレース構成を使用します。 オンの場合、トレース構成名、始点、バリア パラメーターだけが表示されます。 集約されたジオメトリー結果タイプを使用するトレース構成が読み込まれると、集約されたポイント および 集約されたライン パラメーターも表示されます。

  • オフ - ツールは、トレースのプロパティを定義するために、既存の指定トレース構成を使用しません。 これがデフォルトです。

トレース構成名 パラメーターは、トレースのプロパティを定義するトレース構成の名前を指定します。 このパラメーターは、トレース構成の使用 が有効な場合にのみ使用できます。

注意:

また、トレース ウィンドウの 指定構成 タブで、すでに構成済みの指定トレース構成を使用して、トレースを実行することもできます。

指定トレース構成の詳細