Skip to main content

トレース (Trace) (トレース ネットワーク ツール)

サマリー

指定した始点から接続性または通過可能性に基づいて、トレース ネットワーク内で選択されたフィーチャを返します。

トレース ネットワークのトレース機能を使用すると、ネットワーク内のパスを解析できます。 通過可能性は、構成要件を満たす接続されたフィーチャによって確立されたパスを指します。

デフォルトでは、トレース結果は選択として返され、ライン フィーチャ全体が含まれています。 部分的なフィーチャの結果を返すには、結果タイプ パラメーターを ジオメトリーの集約 に設定します。 始点またはバリアが中間部分で接続しているジャンクション上に配置されている場合、トレース結果はエッジ フィーチャの一部のエレメントを返します。 バリアがエッジに沿って配置されている場合、トレース結果は中間部分で接続している最も近いジャンクションで停止できます。 トレースの結果、生成される選択セットまたは出力フィーチャクラスは、別のマップやネットワークのダイアグラム ビューに伝達されるか、別のツールまたはトレースの入力として使用されます。

トレース ネットワークのトレースの詳細

使用法

  • ネットワーク トポロジーが有効化されている必要があります。

  • エンタープライズ ジオデータベースを操作する場合、入力トレース ネットワークはフィーチャ サービスから取得したものである必要があります。データベース コネクションから取得したトレース ネットワークはサポートされていません。

  • トレース ツールはネットワーク トポロジーに依存しているため、ダーティー エリアがトレース範囲内に存在する場合、トレース結果が正確であるという保証はありません。 トレース対象エリアのネットワーク トポロジーは、ネットワークへの最新の変更または更新を反映するよう、検証を行う必要があります。

  • 条件バリア、関数バリア、関数、および出力条件の日付フィールドに割り当てられたネットワーク属性を操作する場合は、日付値を yyyy-mm-dd hh:mm:ss の形式に書式設定する必要があります (例: 2020-10-12 18:45:31)。

パラメーター

ラベル 説明 データ タイプ

入力トレース ネットワーク

トレースを実行するトレース ネットワーク。 エンタープライズ ジオデータベースを操作する場合、入力トレース ネットワークはフィーチャ サービスから取得したものである必要があります。データベース コネクションから取得したトレース ネットワークはサポートされていません。

Trace Network; Trace Network Layer

トレース タイプ

実行するトレースのタイプを指定します。

  • 接続— 1 つ以上の始点で始まり、接続フィーチャに沿って外側に広がる接続トレースが使用されます。

  • 上流— ネットワーク内の場所から上流のフィーチャを検索する上流解析トレースが使用されます。 このタイプのトレースは、フロー方向を設定する必要があります。

  • 下流— ネットワーク内の場所から下流のフィーチャを検索する下流解析トレースが使用されます。 このタイプのトレースは、フロー方向を設定する必要があります。

  • 最短パス— フロー方向に関係なく、ネットワーク内の 2 つの始点間の最短パスを検索する最短パス トレースが使用されます。 パスの通過にかかるコストは、最短パス ネットワーク属性名 パラメーターで設定されたネットワーク属性に基づいて決定されます。

  • 接続—1 つ以上の始点で始まり、接続フィーチャに沿って外側に広がる接続トレースが使用されます。

  • 上流—ネットワーク内の場所から上流のフィーチャを検索する上流トレースが使用されます。 このタイプのトレースは、フロー方向を設定する必要があります。

  • 下流—ネットワーク内の場所から下流のフィーチャを検索する下流トレースが使用されます。 このタイプのトレースは、フロー方向を設定する必要があります。

  • 最短パス—フロー方向に関係なく、ネットワーク内の 2 つの始点間の最短パスを検索する最短パス トレースが使用されます。 パスの通過にかかるコストは、shortest_path_network_attribute_name パラメーターで設定されたネットワーク属性に基づいて決定されます。

String

始点

トレース位置 ウィンドウの 始点 タブを使用して作成されるフィーチャ レイヤー、またはトレースの始点を表す 1 つ以上のレコードを含むテーブルまたはフィーチャクラス。 デフォルトでは TN_Temp_Starting_Points フィーチャクラスが使用され、トレース位置 ウィンドウの 始点 ツールを使用して始点を作成するときに、プロジェクトのデフォルト ジオデータベースに生成されます。

Feature Layer; Table View

バリア

(オプション)

トレースがそのポイントを通過しないようにするトレースのバリアを表す、1 つ以上のフィーチャを含むテーブルまたはフィーチャクラス。 デフォルトでは TN_Temp_Barriers フィーチャクラスが使用され、トレース位置 ウィンドウの バリア タブを使用してバリアを作成するとき、プロジェクトのデフォルト ジオデータベースに生成されます。

Feature Layer; Table View

パス方向

(オプション)

トレース パスの方向を指定します。 パスの通過にかかるコストは、最短パス ネットワーク属性名 パラメーターの値によって決定されます。 このパラメーターは、最短パス トレース タイプを実行する場合にのみ適用されます。

  • 方向なし—フロー方向に関係なく、2 つの始点間のパスが使用されます。 これがデフォルトです。

  • 上流のパス—2 つの始点間の上流のパスが使用されます。

  • 下流のパス—2 つの始点間の下流のパスが使用されます。

String

最短パス ネットワーク属性名

(オプション)

パスの計算に使用されるネットワーク属性の名前。 最短パス解析トレースを実行すると、形状の長さなど、数値のネットワーク属性を使用して、最短パスが計算されます。 パスに基づいて、コストと距離の両方が得られます。 最短パス トレースを実行する場合は、このパラメーターは必須です。

String

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

(オプション)

通過可能性バリア フィーチャが、トレース結果に含まれるかどうかを指定します。

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

  • オフ—通過可能性バリア フィーチャをトレース結果に含めません。

Boolean

一貫性の検証

(オプション)

通過したフィーチャのいずれかでダーティー エリアが発生した場合、エラーを返すかどうかを指定します。 これは、トレースがネットワーク内を一貫したステータスでフィーチャを通過することを保証する唯一の方法です。 ダーティー エリアを削除するには、ネットワーク トポロジーを検証します。

  • オン—通過したフィーチャのいずれかでダーティー エリアが発生した場合、トレースがエラーを返します。 これがデフォルトです。

  • オフ—通過したフィーチャのいずれかでダーティー エリアが発生したかどうかに関係なく、トレースが結果を返します。

Boolean

始点でバリアを無視する

(オプション)

始点ではトレース構成内のバリアを無視するかどうかを指定します。

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

  • オフ—始点にあるバリアは、トレース内で無視されません。 これがデフォルトです。

Boolean

不定フローを許可

(オプション)

フロー方向が不定または未定のフィーチャをトレースするかどうかを指定します。 このパラメーターは、上流トレースまたは下流トレースを実行する場合にのみ適用されます。

  • オン—フロー方向が不定または未定のフィーチャをトレースします。

  • オフ—フロー方向が不定または未定のフィーチャはトレースしません。 これがデフォルトです。

Boolean

条件バリア

(オプション)

ネットワーク属性との比較に基づいて、フィーチャに対して通過可能性バリア条件を設定します。 条件バリアは、ネットワーク属性、演算子とタイプ、および属性値を使用します。 たとえば、フィーチャが ArtificialPath の特定の値と等しい Code 属性を持っている場合に、トレースを停止します。 フィーチャがこの条件を満たしている場合、トレースが停止します。 複数の属性を使用している場合、結合方法 パラメーターを使用して、And または Or 条件を定義できます。

値テーブル列:

  • Name—Filter by network attribute name.

  • Operator—Filter by an operator.

    • Is equal to—The attribute is equal to the value.

    • Does not equal—The attribute is not equal to the value.

    • Is greater than—The attribute is greater than the value.

    • Is greater than or equal to—The attribute is greater than or equal to the value.

    • Is less than—The attribute is less than the value.

    • Is less than or equal to—The attribute is less than or equal to the value.

  • Type—Filter by a specific type.

    • Specific value—Filter by a specific value.

    • Network attribute—Filter by a network attribute.

  • Value—Filter by a specific value.

  • Combine Using—Combine multiple condition barriers.

    • And—Combine the condition barriers.

    • Or—Use if either condition barrier is met.

Value Table

関数バリア

(オプション)

関数に基づいて、フィーチャに対する通過可能性バリアを設定します。 関数バリアを使用すると、たとえば、始点からトレースが移動できる距離を制限したり、トレースを停止するための最大値を設定したりできます。 たとえば、通過した各ラインの長さが、それまでに移動した合計距離に追加されます。 移動した全長が指定された値に達した場合、トレースが停止します。

値テーブル列:

  • Function—Filter by a function.

    • Min—The minimum of the input values.

    • Max—The maximum of the input values.

    • Average—The average of the input values.

    • Count—The number of features.

    • Add—Add the values.

    • Subtract—Subtract the values.

  • Attribute—Filter by a network attribute.

  • Operator—Filter by an operator.

    • Is equal to—The attribute is equal to the value.

    • Does not equal—The attribute is not equal to the value.

    • Is greater than—The attribute is greater than the value.

    • Is greater than or equal to—The attribute is greater than or equal to the value.

    • Is less than—The attribute is less than the value.

    • Is less than or equal to—The attribute is less than or equal to the value.

  • Value—Filter by a specific value.

  • Use Local Values—Boolean value to use local variables instead of a global variable.

Value Table

通過可能性の適用

(オプション)

適用される通過可能性のタイプを指定します。 通過可能性範囲は、通過可能性がジャンクション、エッジ、またはその両方のいずれに適用されるかを決定します。 たとえば、レクリエーション コースのネットワークにおいて、surfacetype 属性に砂利の値が含まれ、通過可能性範囲がジャンクションのみに設定されている場合にトレースを停止するように条件バリアを定義すると、surfacetype フィールドがこの値であるエッジ フィーチャが検出された場合でも、この surfacetype 属性はエッジにしか適用されないため、トレースは停止しません。

  • ジャンクションとエッジの両方—通過可能性は、ジャンクションとエッジの両方に適用されます。 これがデフォルトです。

  • ジャンクションのみ—通過可能性は、ジャンクションのみに適用されます。

  • エッジのみ—通過可能性は、エッジのみに適用されます。

String

関数

(オプション)

トレース結果に適用される計算関数。

値テーブル列:

  • Function—Filter by a function.

    • Min—The minimum of the input values.

    • Max—The maximum of the input values.

    • Average—The average of the input values.

    • Count—The number of features.

    • Add—The sum of the values.

    • Subtract—The difference between the values.

  • Attribute—Filter by a network attribute

  • Filter Name—Filter by attribute name.

  • Filter Operator—Filter by an operator.

    • Is equal to—The attribute is equal to the value.

    • Does not equal—The attribute is not equal to the value.

    • Is greater than—The attribute is greater than the value.

    • Is greater than or equal to—The attribute is greater than or equal to the value.

    • Is less than—The attribute is less than the value.

    • Is less than or equal to—The attribute is less than or equal to the value.

  • Filter Type—Filter by attribute type.

    • Specific value—Filter by a specific value.

    • Network attribute—Filter by a network attribute.

  • Filter Value—Filter by a specific value.

  • Function Name—The name for the alias to describe the function result.

Value Table

出力条件

(オプション)

ネットワーク属性に基づいて返されるフィーチャのタイプ。 たとえば、Tap フィーチャ以外をすべて除外するよう構成されたトレースでは、Tap 属性が割り当てられていないトレース済みフィーチャは、結果に含まれません。 そのカテゴリーがあるトレース対象フィーチャは、結果選択セットに返されます。

値テーブル列:

  • Name—Filter by network attribute name.

  • Operator—Filter by an operator.

    • Is equal to—The attribute is equal to the value.

    • Does not equal—The attribute is not equal to the value.

    • Is greater than—The attribute is greater than the value.

    • Is greater than or equal to—The attribute is greater than or equal to the value.

    • Is less than—The attribute is less than the value.

    • Is less than or equal to—The attribute is less than or equal to the value.

  • Type—Filter by a specific type.

    • Specific value—Filter by a specific value.

    • Network attribute—Filter by a network attribute.

  • Value—Filter by a specific value.

  • Combine Using—Combine multiple conditions.

    • And—Combine the conditions.

    • Or—Use if either condition is met.

Value Table

結果タイプ

(オプション)

トレースから返される結果のタイプを指定します。

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

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

  • ネットワーク レイヤー—トレース結果は、グループ レイヤー内の選択セットとしてフィーチャ レイヤーに追加されます。

  • 接続性—トレース結果は、指定した出力 .json ファイルで接続性グラフとして返されます。 このオプションによって、出力 JSON パラメーターが有効になります。

  • エレメント—トレース結果は、指定した出力 .json ファイルでフィーチャベースの情報として返されます。 このオプションによって、出力 JSON パラメーターが有効になります。

String

選択タイプ

どのように選択を適用するか、選択が存在する場合にはそれをどうするかを指定します。

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

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

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

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

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

String

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

(オプション)

集約されたジオメトリーを格納するために選択されたフィーチャクラスの内容を切り捨てるか追加するかを指定します。 このパラメーターは、集約されたジオメトリー結果タイプにのみ適用されます。

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

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

Boolean

トレース名

(オプション)

トレース操作の名前。 この値は、出力フィーチャクラスの TRACENAME フィールドに格納され、トレース結果の識別に役立ちます。 このパラメーターは、集約されたジオメトリー結果タイプにのみ適用されます。

String

集約されたポイント

(オプション)

集約された結果ジオメトリーを含む出力マルチポイント フィーチャクラス。 デフォルトでは、このパラメーターは、Trace_Results_Aggregated_Points というシステムで生成されるフィーチャクラスを使用して設定され、プロジェクトのデフォルト ジオデータベースに格納されます。

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

Feature Class

集約されたライン

(オプション)

集約された結果ジオメトリーを含む出力ポリライン フィーチャクラス。 デフォルトでは、このパラメーターは、Trace_Results_Aggregated_Lines というシステムで生成されるフィーチャクラスを使用して設定され、プロジェクトのデフォルト ジオデータベースに格納されます。

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

Feature Class

出力グループ レイヤー名

(オプション)

トレースの結果として返されたフィーチャの選択セットを含むフィーチャ レイヤーを含む出力グループ レイヤーの名前。 このレイヤーにより、ModelBuilder および Python でトレースの出力を操作できます。

このパラメーターは、ネットワーク レイヤーの結果タイプにのみ適用されます。

Group Layer

トレース構成の使用

(オプション)

トレース ツールのパラメーターの設定に、既存の指定トレース構成を使用するかどうかを指定します。

注意:

このパラメーターには、トレース ネットワーク バージョン 2 以降が必要です。

  • オン—既存の指定トレース構成を使用して、トレースのプロパティを定義します。 トレース構成名、始点、バリア を除く、すべてのパラメーターが無視されます。

  • オフ—既存の指定トレース構成を使用してトレースのプロパティを定義します。 これがデフォルトです。

Boolean

トレース構成名

(オプション)

トレースのプロパティの定義に使用されるトレース構成の名前。 このパラメーターは、トレース構成の使用 パラメーターがオンの場合にのみアクティブになります。

注意:

このパラメーターには、トレース ネットワーク バージョン 2 以降が必要です。

String

出力 JSON

(オプション)

生成される .json ファイルの名前と場所。

File

派生した出力

ラベル 説明 データ タイプ

更新されたトレース ネットワーク

更新されるトレース ネットワーク。

Any Value

環境

このツールは、ジオプロセシング環境を一切使用しません。

ライセンス情報

  • Basic: 限定的
    ArcGIS Enterprise 指定ユーザー ライセンスを使用している場合に、エンタープライズ デプロイメントでサポートされます。
  • Standard: はい
  • Advanced: はい