トレース (トレース ネットワーク)

サマリー

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

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

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

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

使用法

  • ネットワーク トポロジを「有効化」する必要があります。

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

  • [トレース (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 条件を定義できます。

条件バリアの構成は、次のとおりです。

  • [名前] - システム内で定義された任意のネットワーク属性によってフィルターします。
  • [演算子] - 複数の演算子から選択します。
  • [タイプ] - [名前] コンポーネントで指定された値から、特定の値またはネットワーク属性を選択します。
  • [値] - 演算子の値に基づいて、処理を停止させる入力属性タイプの特定の値を指定します。
  • [結合方法] - 複数の属性を追加する場合に、この値を設定します。And 条件または Or 条件を使用して、属性を結合することができます。

[演算子] コンポーネントは次のとおりです。

  • [等しい] - 属性と値が等しい。
  • [等しくない] - 属性と値が等しくありません。
  • [より大きい] - 属性が値より大きい。
  • [以上] - 属性が値以上です。
  • [より小さい] - 属性が値より小さい。
  • [以下] - 属性が値以下です。

[タイプ] コンポーネントは次のとおりです。

  • [特定の値] - 特定の値によってフィルターします。
  • [ネットワーク属性] - ネットワーク属性によってフィルターします。

[結合方法] コンポーネントは次のとおりです。

  • [And] - 条件バリアを結合します。
  • [Or] - いずれかの条件バリアが満たされた場合に使用します。

  • 等しい属性と値が等しい。
  • 等しくない属性と値が等しくありません。
  • より大きい属性が値より大きい。
  • 以上属性が値以上です。
  • より小さい属性が値より小さい。
  • 以下属性が値以下です。
  • 特定の値特定の値によってフィルターします。
  • ネットワーク属性ネットワーク属性によってフィルターします。
  • And条件バリアを結合します。
  • Orいずれかの条件バリアが、満たされている場合に使用します。
Value Table
関数バリア
(オプション)

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

関数バリアの構成は、次のとおりです。

  • [関数] - 複数の計算関数から選択します。
  • [属性] - システムに定義されたネットワーク属性によってフィルターします。
  • [演算子] - 複数の演算子から選択します。
  • [値] - 検出された時点で、処理を停止させる入力属性タイプの特定の値を指定します。
  • [ローカル値の使用] - 全体的なグローバル値とは対照的に、各方向で値を計算します。 たとえば、関数バリアが、値が 4 以上の場合にトレースが停止する形状の長さの合計を計算するとします。 グローバル値の場合は、値が 2 の 2 つのエッジを通過すると、形状の長さの合計値 4 にすでに到達するため、トレースが停止します。 ローカル値を使用している場合は、各パスに沿ってローカル値が変化するため、トレースが続行します。

[関数] コンポーネントは次のとおりです。

  • [最小] - 最小の入力値。
  • [最大] - 最大の入力値。
  • [加算] - 入力値の合計。
  • [平均] - 入力値の平均。
  • [個数] - フィーチャの数。
  • [減算] - 入力値の差。

たとえば、20 の値を持つ始点フィーチャが存在するとします。 次のフィーチャは、30 の値を持っています。 最小関数を使用すると、結果が 20、最大が 30、追加が 50、平均が 25、個数が 2、減算が -10 になります。

[演算子] コンポーネントは次のとおりです。

  • [等しい] - 属性と値が等しい。
  • [等しくない] - 属性と値が等しくありません。
  • [より大きい] - 属性が値より大きい。
  • [以上] - 属性が値以上です。
  • [より小さい] - 属性が値より小さい。
  • [以下] - 属性が値以下です。

[ローカル値の使用] コンポーネントは次のとおりです。

  • オン - ローカル値が使用されます。
  • オフ - グローバル値が使用されます。 これがデフォルトです。

  • 平均入力値の平均。
  • 個数フィーチャの数。
  • 最大最大の入力値。
  • 最小最小の入力値。
  • 加算値を加算します。
  • 減算値を減算します。
  • 等しい属性と値が等しい。
  • 等しくない属性と値が等しくありません。
  • より大きい属性が値より大きい。
  • 以上属性が値以上です。
  • より小さい属性が値より小さい。
  • 以下属性が値以下です。
Value Table
通過可能性の適用
(オプション)

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

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

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

関数の構成は、次のとおりです。

  • [関数] - 複数の計算関数から選択します。
  • [属性] - システムに定義されたネットワーク属性によってフィルターします。
  • [フィルター名] - 属性名によって、関数の結果をフィルターします。
  • [フィルター演算子] - 複数の演算子から選択します。
  • [フィルター タイプ] - 複数のフィルター タイプから選択します。
  • [フィルター値] - 入力フィルター属性の値を指定します。

[関数] コンポーネントには、次のオプションがあります。

  • [最小] - 入力値の最小値。
  • [最大] - 入力値の最大値。
  • [加算] - 入力値の合計。
  • [平均] - 入力値の平均。
  • [個数] - フィーチャの数。
  • [減算] - 入力値の差。

たとえば、20 の値を持つ始点フィーチャが存在するとします。 次のフィーチャは、30 の値を持っています。 [最小] 関数を使用すると、結果は 20 になります。 [最大] は 30、[加算] は 50、[平均] は 25、[個数] は 2、[減算] は -10 になります。

[フィルター演算子] コンポーネントには、次のオプションがあります。

  • [等しい] - 属性と値が等しい。
  • [等しくない] - 属性と値が等しくありません。
  • [より大きい] - 属性が値より大きい。
  • [以上] - 属性が値以上です。
  • [より小さい] - 属性が値より小さい。
  • [以下] - 属性が値以下です。

[フィルター タイプ] コンポーネントには、次のオプションがあります。

  • [特定の値] - 特定の値によってフィルターします。
  • [ネットワーク属性] - ネットワーク属性を基準にフィルターします。

  • 平均入力値の平均。
  • 個数フィーチャの数。
  • 最大最大の入力値。
  • 最小最小の入力値。
  • 加算値の合計。
  • 減算値の差。
  • 等しい属性と値が等しい。
  • 等しくない属性と値が等しくありません。
  • より大きい属性が値より大きい。
  • 以上属性が値以上です。
  • より小さい属性が値より小さい。
  • 以下属性が値以下です。
Value Table
出力条件
(オプション)

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

出力条件の構成は、次のとおりです。

  • [名前] - システムに定義されたネットワーク属性によってフィルターします。
  • [演算子] - 複数の演算子から選択します。
  • [タイプ] - [名前] コンポーネントで指定された値から、特定の値またはネットワーク属性を選択します。
  • [値] - 演算子の値に基づいて、処理を停止させる入力属性タイプの特定の値を指定します。
  • [結合方法] - 複数の属性を追加する場合に、この値を設定します。And 条件または Or 条件を使用して、属性を結合することができます。

[演算子] コンポーネントには、次のオプションがあります。

  • [等しい] - 属性と値が等しい。
  • [等しくない] - 属性と値が等しくありません。
  • [より大きい] - 属性が値より大きい。
  • [以上] - 属性が値以上です。
  • [より小さい] - 属性が値より小さい。
  • [以下] - 属性が値以下です。

[タイプ] コンポーネントには、次のオプションがあります。

  • [特定の値] - 特定の値によってフィルターします。
  • [ネットワーク属性] - ネットワーク属性によってフィルターします。

  • 等しい属性と値が等しい。
  • 等しくない属性と値が等しくありません。
  • より大きい属性が値より大きい。
  • 以上属性が値以上です。
  • より小さい属性が値より小さい。
  • 以下属性が値以下です。
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
トレース構成の使用
(オプション)

[トレース (Trace)] ツールのパラメーターの設定に既存の名前付きトレース構成を使用するかどうかを指定します。

  • オン - 既存の指定トレース構成を使用して、トレースのプロパティを定義します。 [トレース構成名][始点][バリア] を除く、すべてのパラメーターが無視されます。
  • オフ - トレースのプロパティを定義するために、既存の指定トレース構成は使用されません。 これがデフォルトです。

注意:

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

Boolean
トレース構成名
(オプション)

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

注意:

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

String
出力 JSON
(オプション)

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

File

派生した出力

ラベル説明データ タイプ
更新されたトレース ネットワーク

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

Any Value

arcpy.tn.Trace(in_trace_network, trace_type, starting_points, {barriers}, {path_direction}, {shortest_path_network_attribute_name}, {include_barriers}, {validate_consistency}, {ignore_barriers_at_starting_points}, {allow_indeterminate_flow}, {condition_barriers}, {function_barriers}, {traversability_scope}, {functions}, {output_conditions}, {result_types}, selection_type, {clear_all_previous_trace_results}, {trace_name}, {aggregated_points}, {aggregated_lines}, {out_network_layer}, {use_trace_config}, {trace_config_name}, {out_json_file})
名前説明データ タイプ
in_trace_network

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

Trace Network; Trace Network Layer
trace_type

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

  • CONNECTED1 つ以上の始点で始まり、接続フィーチャに沿って外側に広がる接続トレースが使用されます。
  • UPSTREAMネットワーク内の場所から上流のフィーチャを検索する上流トレースが使用されます。 このタイプのトレースは、フロー方向を設定する必要があります。
  • DOWNSTREAMネットワーク内の場所から下流のフィーチャを検索する下流トレースが使用されます。 このタイプのトレースは、フロー方向を設定する必要があります。
  • SHORTEST_PATHフロー方向に関係なく、ネットワーク内の 2 つの始点間の最短パスを検索する最短パス トレースが使用されます。 パスの通過にかかるコストは、フロー方向に関係なく、shortest_path_network_attribute_name パラメーターで設定されたネットワーク属性に基づいて決定されます。
String
starting_points

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

Feature Layer; Table View
barriers
(オプション)

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

Feature Layer; Table View
path_direction
(オプション)

トレース パスの方向を指定します。 パスの通過にかかるコストは、shortest_path_network_attribute_name パラメーターの値によって決定されます。 このパラメーターは、SHORTEST_PATH トレース タイプを実行する場合にのみ適用されます。

  • NO_DIRECTIONフロー方向に関係なく、2 つの始点間のパスが使用されます。 これがデフォルトです。
  • PATH_UPSTREAM2 つの始点間の上流のパスが使用されます。
  • PATH_DOWNSTREAM2 つの始点間の下流のパスが使用されます。
String
shortest_path_network_attribute_name
(オプション)

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

String
include_barriers
(オプション)

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

  • INCLUDE_BARRIERS通過可能性バリア フィーチャをトレース結果に含めます。 これがデフォルトです。
  • EXCLUDE_BARRIERS通過可能性バリア フィーチャをトレース結果に含めません。
Boolean
validate_consistency
(オプション)

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

  • VALIDATE_CONSISTENCY通過したフィーチャのいずれかでダーティ エリアが発生した場合、トレースがエラーを返します。 これがデフォルトです。
  • DO_NOT_VALIDATE_CONSISTENCY通過したフィーチャのいずれかでダーティ エリアが発生したかどうかに関係なく、トレースが結果を返します。
Boolean
ignore_barriers_at_starting_points
(オプション)

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

  • IGNORE_BARRIERS_AT_STARTING_POINTS始点にあるバリアは、トレース内で無視されます。
  • DO_NOT_IGNORE_BARRIERS_AT_STARTING_POINTS始点にあるバリアは、トレース内で無視されません。 これがデフォルトです。
Boolean
allow_indeterminate_flow
(オプション)

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

  • TRACE_INDETERMINATE_FLOWフロー方向が不定または未定のフィーチャをトレースします。
  • IGNORE_INDETERMINATE_FLOWフロー方向が不定または未定のフィーチャはトレースしません。 これがデフォルトです。
Boolean
condition_barriers
[Name, Operator, Type, Value, Combine Using,...]
(オプション)

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

条件バリアの構成は、次のとおりです。

  • Name - システム内で定義された任意のネットワーク属性によってフィルターします。
  • Operator - 複数の異なる演算子から選択します。
  • Type - Name コンポーネントで指定された値から特定の値またはネットワーク属性を選択します。
  • Value - 演算子の値に基づいて処理を停止させる、入力属性タイプの特定の値を指定します。
  • Combine Using - 複数の属性を追加する場合に、この値を設定します。And 条件または Or 条件を使用して、属性を結合することができます。

Operator コンポーネントは次のとおりです。

  • IS_EQUAL_TO属性と値が等しい。
  • DOES_NOT_EQUAL属性と値が等しくありません。
  • IS_GREATER_THAN属性が値より大きい。
  • IS_GREATER_THAN_OR_EQUAL_TO属性が値以上です。
  • IS_LESS_THAN属性が値より小さい。
  • IS_LESS_THAN_OR_EQUAL_TO属性が値以下です。

Type コンポーネントは次のとおりです。

  • SPECIFIC_VALUE特定の値によってフィルターします。
  • NETWORK_ATTRIBUTEネットワーク属性によってフィルターします。

Combine Using コンポーネントは次のとおりです。

  • AND条件バリアを結合します。
  • ORいずれかの条件バリアが、満たされている場合に使用します。
Value Table
function_barriers
[Function, Attribute, Operator, Value, Use Local Values,...]
(オプション)

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

関数バリアの構成は、次のとおりです。

  • Function - 複数の計算関数から選択します。
  • Attribute - システム内で定義された任意のネットワーク属性によってフィルターします。
  • Operator - 複数の演算子から選択します。
  • Value - 検出された時点で、処理を停止させる入力属性タイプの特定の値を指定します。
  • Use Local Values - 全体的なグローバル値とは対照的に、各方向で値を計算します。 たとえば、関数バリアが、値が 4 以上の場合にトレースが停止する形状の長さの合計を計算するとします。 グローバル値の場合は、値が 2 の 2 つのエッジを通過すると、形状の長さの合計値 4 にすでに到達するため、トレースが停止します。 ローカル値を使用している場合は、各パスに沿ってローカル値が変化するため、トレースが続行します。

Function コンポーネントは次のとおりです。

  • AVERAGE入力値の平均。
  • COUNTフィーチャの数。
  • MAX最大の入力値。
  • MIN最小の入力値。
  • ADD値を加算します。
  • SUBTRACT値を減算します。

Operator コンポーネントは次のとおりです。

  • IS_EQUAL_TO属性と値が等しい。
  • DOES_NOT_EQUAL属性と値が等しくありません。
  • IS_GREATER_THAN属性が値より大きい。
  • IS_GREATER_THAN_OR_EQUAL_TO属性が値以上です。
  • IS_LESS_THAN属性が値より小さい。
  • IS_LESS_THAN_OR_EQUAL_TO属性が値以下です。

Use Local Values コンポーネントは次のとおりです。

  • TRUEローカル値を使用します。
  • FALSEグローバル値を使用します。 これがデフォルトです。
Value Table
traversability_scope
(オプション)

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

  • BOTH_JUNCTIONS_AND_EDGES通過可能性は、ジャンクションとエッジの両方に適用されます。 これがデフォルトです。
  • JUNCTIONS_ONLY通過可能性は、ジャンクションのみに適用されます。
  • EDGES_ONLY通過可能性は、エッジのみに適用されます。
String
functions
[[Function, Attribute, Filter Name, Filter Operator, Filter Type, Filter Value],...]
(オプション)

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

関数の構成は、次のとおりです。

  • Function - 複数の計算関数から選択します。
  • Attribute - システム内で定義された任意のネットワーク属性によってフィルターします。
  • Filter Name - 属性名によって、関数の結果をフィルターします。
  • Filter Operator - 複数の演算子から選択します。
  • Filter Type - 複数のフィルター タイプから選択します。
  • Filter Value - 入力フィルター属性の値を指定します。

Function コンポーネントには、次のオプションがあります。

  • AVERAGE入力値の平均。
  • COUNTフィーチャの数。
  • MAX最大の入力値。
  • MIN最小の入力値。
  • ADD値の合計。
  • SUBTRACT値の差。

たとえば、20 の値を持つ始点フィーチャが存在するとします。 次のフィーチャは、30 の値を持っています。 MIN 関数を使用している場合、結果が 20、MAX が 30、ADD が 50、AVERAGE が 25、COUNT が 2、SUBTRACT が -10 になります。

Filter Operator コンポーネントには、次のオプションがあります。

  • IS_EQUAL_TO属性と値が等しい。
  • DOES_NOT_EQUAL属性と値が等しくありません。
  • IS_GREATER_THAN属性が値より大きい。
  • IS_GREATER_THAN_OR_EQUAL_TO属性が値以上です。
  • IS_LESS_THAN属性が値より小さい。
  • IS_LESS_THAN_OR_EQUAL_TO属性が値以下です。

Filter Type コンポーネントには、次のオプションがあります。

  • SPECIFIC_VALUE特定の値によってフィルターします。
  • NETWORK_ATTRIBUTEネットワーク属性によってフィルターします。
Value Table
output_conditions
[[Name, Operator, Type, Value, Combine Using],...]
(オプション)

ネットワーク属性に基づいて返されるフィーチャのタイプ。 たとえば、Tap フィーチャ以外をすべて除外するよう構成されたトレースでは、Tap 属性が割り当てられていないトレース済みフィーチャは、結果に含まれません。 そのカテゴリがあるトレース対象フィーチャは、結果選択セットに返されます。 複数の属性を使用すると、Combine Using オプションを使用して、And 条件または Or 条件を定義できます。

出力条件の構成は、次のとおりです。

  • Name - システム内で定義された任意のネットワーク属性によってフィルターします。
  • Operator - 複数の演算子から選択します。
  • Type - Name コンポーネントで指定された値から特定の値またはネットワーク属性を選択します。
  • Value - 演算子の値に基づいて、処理を停止させる入力属性タイプの特定の値を指定します。
  • Combine Using - 複数の属性を追加する場合に、この値を設定します。And 条件または Or 条件を使用して、属性を結合することができます。

Operator コンポーネントには、次のオプションがあります。

  • IS_EQUAL_TO属性と値が等しい。
  • DOES_NOT_EQUAL属性と値が等しくありません。
  • IS_GREATER_THAN属性が値より大きい。
  • IS_GREATER_THAN_OR_EQUAL_TO属性が値以上です。
  • IS_LESS_THAN属性が値より小さい。
  • IS_LESS_THAN_OR_EQUAL_TO属性が値以下です。

Type コンポーネントには、次のオプションがあります。

  • SPECIFIC_VALUE特定の値によってフィルターします。
  • NETWORK_ATTRIBUTEネットワーク属性によってフィルターします。

Combine Using コンポーネントには、次のオプションがあります。

  • AND条件を結合します。
  • ORいずれかの条件を満たした場合に使用します。
Value Table
result_types
[result_types,...]
(オプション)

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

  • SELECTIONトレース結果は、該当するネットワーク フィーチャの選択セットとして返されます。 これがデフォルトです。
  • AGGREGATED_GEOMETRYトレース結果は、ジオメトリ タイプによって集約され、アクティブなマップのレイヤー内に表示されるフィーチャクラスに格納されます。
  • NETWORK_LAYERSトレース結果は、グループ レイヤー内の選択セットとしてフィーチャ レイヤーに追加されます。
  • CONNECTIVITYトレース結果は、指定した出力 *.json ファイルで接続性グラフとして返されます。 このオプションによって、out_json_file パラメーターが有効になります。
  • ELEMENTSトレース結果は、指定した出力 *.json ファイルでフィーチャ エレメントとして返されます。 このオプションによって、out_json_file パラメーターが有効になります。
String
selection_type

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

  • NEW_SELECTION結果として得られる選択によって、現在の選択が置換されます。 これがデフォルトです。
  • ADD_TO_SELECTION選択が存在する場合、結果として得られる選択が、現在の選択に追加されます。 選択が存在しない場合は、新しい選択オプションと同じです。
  • REMOVE_FROM_SELECTION結果として得られる選択が、現在の選択から削除されます。 選択が存在しない場合、このオプションは影響を与えません。
  • SUBSET_SELECTION結果として得られる選択が、現在の選択に統合されます。 両方に共通のレコードだけが、選択された状態となります。
  • SWITCH_SELECTION選択結果が切り替えられます。 選択された結果が、現在の選択から削除され、選択されなかった結果が、現在の選択に追加されます。 選択が存在しない場合は、新しい選択オプションと同じです。
String
clear_all_previous_trace_results
(オプション)

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

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

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

String
aggregated_points
(オプション)

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

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

Feature Class
aggregated_lines
(オプション)

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

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

Feature Class
out_network_layer
(オプション)

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

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

Group Layer
use_trace_config
(オプション)

[トレース (Trace)] ツールのパラメーターの設定に既存の名前付きトレース構成を使用するかどうかを指定します。

  • USE_TRACE_CONFIGURATION既存の指定トレース構成を使用して、トレースのプロパティを定義します。 trace_config_namestarting_pointsbarriers を除く、すべてのパラメーターが無視されます。
  • DO_NOT_USE_TRACE_CONFIGURATION既存の名前付きトレース構成を使用してトレースのプロパティを定義します。 これがデフォルトです。
注意:

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

Boolean
trace_config_name
(オプション)

トレースのプロパティの定義に使用されるトレース構成の名前。 このパラメーターは、use_trace_config パラメーターが、USE_TRACE_CONFIGURATION に設定されている場合のみ有効です。

注意:

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

String
out_json_file
(オプション)

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

File

派生した出力

名前説明データ タイプ
updated_trace_network

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

Any Value

コードのサンプル

Trace の例 (Python ウィンドウ)

HydroNetwork というトレース ネットワークに対して下流トレースを実行して、始点から 500 メートルの範囲内にあるフィーチャを返します。 これにより、ネットワーク レイヤー結果タイプを使用して、選択内容を含むグループ レイヤーが結果として返されます。

import arcpy

tn = r"C:\MyProject\NHD.gdb\Hydro\HydroNetwork"
trace = arcpy.tn.Trace(
    tn, "DOWNSTREAM", r"C:\Projects\Default.gdb\TN_Temp_Starting_Points", 
    r"C:\Projects\Default.gdb\TN_Temp_Barriers", "NO_DIRECTION", "", 
    "INCLUDE_BARRIERS", "VALIDATE_CONSISTENCY", 
    "DO_NOT_IGNORE_BARRIERS_AT_STARTING_POINTS", "IGNORE_INDETERMINATE_FLOW", 
    None, "ADD 'Shape length' IS_EQUAL_TO 500 true", "BOTH_JUNCTIONS_AND_EDGES", 
    None, None, "NETWORK_LAYERS", "NEW_SELECTION", 
    "CLEAR_ALL_PREVIOUS_TRACE_RESULTS", "", "", "", "MyTraceResult"
)

環境

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

ライセンス情報

  • Basic: No
  • Standard: Yes
  • Advanced: Yes

関連トピック