| 名前 | 説明 | データ タイプ |
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_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_name、starting_points、barriers を除く、すべてのパラメーターが無視されます。
- DO_NOT_USE_TRACE_CONFIGURATION—既存の名前付きトレース構成を使用してトレースのプロパティを定義します。 これがデフォルトです。
| Boolean |
trace_config_name (オプション) | トレースのプロパティの定義に使用されるトレース構成の名前。 このパラメーターは、use_trace_config パラメーターが USE_TRACE_CONFIGURATION に設定されている場合のみ有効です。 | String |
out_json_file (オプション) | 生成される *.json ファイルの名前と場所。 | File |