トレースの構成—ArcGIS Pro

トレースネットワークでのトレースは、ネットワークの状態に関する問題を解決し、疑問に回答するのに常時役立ちます。トレースネットワークをトレースするには、[トレース (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 に到達できなくなります。削除されたフィーチャがネットワークトポロジに反映されたからです。トレースされるエリアの範囲全体のネットワークトポロジが検証されない場合、他のダーティエリアも発生する可能性があります。


構成オプション	説明
一貫性の検証	オン - ダーティエリアがトレース対象のフィーチャと交差している場合、ツールがエラーを返します。これがデフォルトです。オフ - ダーティエリアは無視されます。

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

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

不定フローを許可

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


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

高度な設定

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

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

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

関数の設定

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

返される内容の制御

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

出力条件

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

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

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

結果タイプ

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


パラメーター	オプション
結果タイプ	選択 - トレース操作の結果は、該当するネットワークフィーチャの選択セットとして返されます。これがデフォルトです。 [集約されたジオメトリ] - トレース操作の結果は、ジオメトリタイプ別に集約され、アクティブなマップのレイヤー内に表示されるフィーチャクラスに格納されます。 [ネットワークレイヤー] - トレースにより返されたフィーチャの選択セットを含むフィーチャレイヤーを格納するグループレイヤーを作成します。 [接続性] - トレースの結果が接続性グラフとして、指定した .json 出力ファイルに返されます。 [エレメント] - トレースの結果がフィーチャに基づく情報として、指定した .json 出力ファイルに返されます。注意: エンタープライズジオデータベースの場合、[接続性] オプションを使用するには、ArcGIS Enterprise 10.9.1 以降が必要です。

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

以下の図で、下流トレースで選択と集約されたジオメトリの結果タイプオプションを使用した場合の違いを比較してください。下のネットワークは、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 という名前の文字列フィールドを含み、出力のジオメトリタイプに一致する必要があります。

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

注意:

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

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


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

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

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

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

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

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

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

networkSourceId
globalId
objectId

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

positionFrom および positionTo

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

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


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

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

指定トレース構成の詳細

このトピックへのフィードバック