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

概要

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

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

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

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

使用法

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

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

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

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

構文

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})

パラメーター	説明	データ タイプ
in_trace_network	トレースを実行するトレース ネットワーク。エンタープライズ ジオデータベースを操作する場合、入力トレース ネットワークはフィーチャ サービスから取得したものである必要があります。データベース接続から取得したトレース ネットワークはサポートされていません。	Trace Network; Trace Network Layer
trace_type	実行するトレースのタイプを指定します。 CONNECTED —1 つ以上の始点で始まり、接続フィーチャに沿って外側に広がる接続トレースが使用されます。 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_UPSTREAM —2 つの始点間の上流のパスが使用されます。 PATH_DOWNSTREAM —2 つの始点間の下流のパスが使用されます。	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 —属性が値より小さい。 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 —属性が値より小さい。 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 —属性が値より小さい。 Type コンポーネントには、次のオプションがあります。 SPECIFIC_VALUE —特定の値によるフィルター。 NETWORK_ATTRIBUTE —ネットワーク属性によるフィルター。 Combine Using コンポーネントには、次のオプションがあります。 AND —条件を結合します。 OR —いずれかの条件を満たした場合に使用します。	Value Table
result_types [result_types,...] (オプション)	トレースによって返される結果のタイプを指定します。 SELECTION — トレース結果は、該当するネットワーク フィーチャの選択セットとして返されます。これがデフォルトです。 AGGREGATED_GEOMETRY — トレース結果は、ジオメトリ タイプによって集約され、アクティブなマップのレイヤー内に表示されるフィーチャクラスに格納されます。 NETWORK_LAYERS —トレース結果は、グループ レイヤー内の選択セットとしてフィーチャ レイヤーに追加されます。	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_name]、[starting_points]、[barriers] を除く、すべてのパラメーターが無視されます。 DO_NOT_USE_TRACE_CONFIGURATION —トレースで、トレースのプロパティの定義にトレース構成が使用されません。これがデフォルトです。 メモ: このパラメーターには、トレース ネットワーク バージョン 2 以降が必要です。	Boolean
trace_config_name (オプション)	トレースのプロパティの定義に使用されるトレース構成の名前を指定します。このパラメーターは、[use_trace_config] パラメーターが [USE_TRACE_CONFIGURATION] に設定されている場合にのみ有効になります。 メモ: このパラメーターには、トレース ネットワーク バージョン 2 以降が必要です。	String

派生した出力

名前	説明	データ タイプ
updated_trace_network	更新されるトレース ネットワーク。	任意の値

コードのサンプル

Trace (トレース) の例 (Python ウィンドウ)

Trace 関数を使用して、HydroNetwork というトレース ネットワークに対して下流解析トレースを実行します。

import arcpy
arcpy.Trace_tn(r"C:\MyProject\NHD.gdb\Hydro\HydroNetwork", 
               "DOWNSTREAM", r"C:\MyProject\NHD.gdb\TN_Temp_Starting_Points")

環境

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

ライセンス情報

• Basic: いいえ
• Standard: はい
• Advanced: はい