トレース構成の追加 (Add Trace Configuration) (ユーティリティネットワーク)—ArcGIS Pro

Standard または Advancedのライセンスで利用可能。

概要

ユーティリティネットワーク内にトレース構成を作成します。

トレース構成では、共有と再利用のために複雑なトレースのプロパティを構成して格納することができます。ユーティリティネットワークに格納されているトレース構成を [トレース (Trace)] ツールから読み込んで実行したり、Web マップまたはフィールドアプリで使用するために共有したりできます。

トレース構成を追加する方法の詳細

使用法

入力ユーティリティネットワークは、バージョン 5 以降である必要があります。
エンタープライズジオデータベースを操作する場合、入力ユーティリティネットワークは、ユーティリティネットワークサービスから取得する必要があります。
接続されたポータルアカウントは、トレース構成の作成者として設定されます。
- ファイルジオデータベース内のユーティリティネットワークを操作する際にトレース構成の作成者を保存する場合には、オペレーティングシステム認証が使用されます。

構文

arcpy.un.AddTraceConfiguration(in_utility_network, trace_config_name, trace_type, {description}, {tags}, {domain_network}, {tier}, {target_tier}, {subnetwork_name}, {shortest_path_network_attribute_name}, {include_containers}, {include_content}, {include_structures}, {include_barriers}, {validate_consistency}, {condition_barriers}, {function_barriers}, {traversability_scope}, {filter_barriers}, {filter_function_barriers}, {filter_scope}, {filter_bitset_network_attribute_name}, {filter_nearest}, {nearest_count}, {nearest_cost_network_attribute}, {nearest_categories}, {nearest_assets}, {functions}, {propagators}, {output_assettypes}, {output_conditions}, {include_isolated_features}, {ignore_barriers_at_starting_points}, {include_up_to_first_spatial_container}, {result_types}, {allow_indeterminate_flow}, {validate_locatability})

パラメーター	説明	データタイプ
in_utility_network	新しいトレース構成が含まれるユーティリティネットワーク。	Utility Network; Utility Network Layer
trace_config_name	トレース構成の名前。	String
trace_type	構成するトレースのタイプを指定します。 CONNECTED — 接続解析トレースは 1 つ以上の始点で始まり、接続フィーチャに沿って外側に広がります。これがデフォルトです。 SUBNETWORK — サブネットワーク解析トレースは 1 つ以上の始点で始まり、接続フィーチャに沿って外側に広がります。 SUBNETWORK_CONTROLLERS —サブネットワークコントローラー解析トレースは、サブネットワークに関連付けられたサブネットワークコントローラー上でソースとシンクを検索します。 UPSTREAM —上流解析トレースは、ネットワーク内の場所から上流のフィーチャを検索します。 DOWNSTREAM —下流解析トレースは、ネットワーク内の場所から下流のフィーチャを検索します。 LOOPS — ループは、フロー方向があいまいなネットワークのエリアです。ループ解析トレースは、接続性に基づいて始点から外側に広がります。 SHORTEST_PATH —最短パス解析トレースは、2 つの始点間の最短パスを特定します。 ISOLATION —分離性トレースは、ネットワークのエリアを分離するフィーチャを検索します。	String
description (オプション)	トレース構成の説明。	String
tags [tags,...] (オプション)	トレース構成の識別に使用される一連のタグ。これらのタグは検索とインデックス構築に使用できます。	String
domain_network (オプション)	トレースを実行するドメインネットワークの名前。サブネットワーク、サブネットワークコントローラー、上流解析、および下流解析トレースタイプを実行する場合、このパラメーターは必須です。	String
tier (オプション)	トレースを開始する層の名前。サブネットワーク、サブネットワークコントローラー、上流解析、および下流解析トレースタイプを実行する場合、このパラメーターは必須です。	String
target_tier (オプション)	入力層が流れるターゲット層の名前。上流または下流解析トレースでこのパラメーターを使用しない場合は、開始するサブネットワークの境界に到達するとトレースは停止します。このパラメーターを使用すると、このトレースを階層の上方または下方に継続できます。	String
subnetwork_name (オプション)	トレースを実行するサブネットワークの名前。このパラメーターは、サブネットワーク解析トレースの実行時に使用されます。サブネットワーク名を指定した場合、[始点] パラメーター (Python では starting_points パラメーター) は必要ありません。	String
shortest_path_network_attribute_name (オプション)	最短パスを計算するために使用するネットワーク属性。最短パス解析トレースを実行すると、形状の長さなど、数値のネットワーク属性を使用して、最短パスが計算されます。コストに基づくパスと距離に基づくパスの両方が得られます。最短パス解析トレースを実行する場合は、このパラメーターは必須です。	String
include_containers (オプション)	格納器フィーチャをトレース結果に含めるかどうかを指定します。 INCLUDE_CONTAINERS —格納器フィーチャをトレース結果に含めます。 EXCLUDE_CONTAINERS —格納器フィーチャをトレース結果に含めません。これがデフォルトです。	Boolean
include_content (オプション)	格納器の格納物をトレース結果に含めるかどうかを指定します。 INCLUDE_CONTENT —格納器フィーチャの格納物をトレース結果に含めます。 EXCLUDE_CONTENT —格納器フィーチャの格納物をトレース結果に含めません。これがデフォルトです。	Boolean
include_structures (オプション)	構造物フィーチャおよびオブジェクトをトレース結果に含めるかどうかを指定します。 INCLUDE_STRUCTURES —構造物フィーチャおよびオブジェクトをトレース結果に含めます。 EXCLUDE_STRUCTURES —構造物フィーチャおよびオブジェクトをトレース結果に含めません。これがデフォルトです。	Boolean
include_barriers (オプション)	通過可能性バリアフィーチャをトレース結果に含めるかどうかを指定します。通過可能性バリアは、サブネットワーク定義で事前に設定されている場合でも任意指定です。このパラメーターは、ターミナルを含むデバイスフィーチャには適用されません。 INCLUDE_BARRIERS —通過可能性バリアフィーチャをトレース結果に含めます。これがデフォルトです。 EXCLUDE_BARRIERS —通過可能性バリアフィーチャをトレース結果に含めません。	Boolean
validate_consistency (オプション)	通過したフィーチャのいずれかでダーティエリアが発生した場合、エラーを返すかどうかを指定します。これは、トレースがネットワーク内を一貫したステータスでフィーチャを通過することを保証する唯一の方法です。ダーティエリアを削除するには、ネットワークトポロジを整合チェックします。 VALIDATE_CONSISTENCY —通過したフィーチャのいずれかでダーティエリアが発生した場合、トレースがエラーを返します。これがデフォルトです。 DO_NOT_VALIDATE_CONSISTENCY —通過したフィーチャのいずれかでダーティエリアが発生したかどうかに関係なく、トレースが結果を返します。	Boolean
condition_barriers [[Name, Operator, Type, Value, Combine Using],...] (オプション)	ネットワーク属性との比較またはカテゴリ文字列のチェックに基づいて、フィーチャに対して通過可能性バリア条件を設定します。条件バリアは、ネットワーク属性、演算子とタイプ、および属性値を使用します。たとえば、フィーチャが Device Status の特定の値と等しい Open 属性を持っている場合に、トレースを停止します。フィーチャがこの条件を満たしている場合、トレースが停止します。複数の属性を使用している場合、[結合方法] パラメーターを使用して [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 —属性が値以下である。 INCLUDES_THE_VALUES —値のすべてのビットが属性内に存在するビット単位の論理積演算 (bitwise AND == value)。 DOES_NOT_INCLUDE_THE_VALUES —値の一部のビットが属性内に存在しないビット単位の論理積演算 (bitwise AND != value)。 INCLUDES_ANY —値の少なくとも 1 つのビットが属性内に存在するビット単位の論理積演算 (bitwise AND == True)。 DOES_NOT_INCLUDE_ANY —値のビットが属性内に存在しないビット単位の論理積演算 (bitwise AND == False)。 bitwise 演算子の詳細条件バリアの 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 —関数結果が値以下。 INCLUDES_THE_VALUES —値のすべてのビットが属性内に存在するビット単位の論理積演算 (bitwise AND == value)。 DOES_NOT_INCLUDE_THE_VALUES —値の一部のビットが属性内に存在しないビット単位の論理積演算 (bitwise AND != value)。 INCLUDES_ANY —値の少なくとも 1 つのビットが属性内に存在するビット単位の論理積演算 (bitwise AND == True)。 DOES_NOT_INCLUDE_ANY —値のビットが属性内に存在しないビット単位の論理積演算 (bitwise AND == False)。 bitwise 演算子の詳細関数バリアの [Use Local Values] のオプションは次のとおりです。 TRUE —ローカル値が使用されます。 FALSE —グローバル値が使用されます。これがデフォルトです。	Value Table
traversability_scope (オプション)	適用する通過可能性のタイプ。通過可能性範囲は、通過可能性がジャンクション、エッジ、またはその両方のいずれに適用されるかを決定します。たとえば、Device Status が Open であり、通過可能性の範囲がエッジのみに設定されている場合にトレースを停止するように条件バリアを定義すると、トレースでオープンデバイスが検出された場合でも、Device Status はジャンクションにしか適用されないため、トレースは停止しません。つまり、このパラメーターは、トレースで、ジャンクション、エッジ、またはその両方を無視するかどうかを示します。 BOTH_JUNCTIONS_AND_EDGES —通過可能性をジャンクションとエッジの両方に適用します。これがデフォルトです。 JUNCTIONS_ONLY —通過可能性をジャンクションにのみ適用します。 EDGES_ONLY —通過可能性をエッジにのみ適用します。	String
filter_barriers [[Name, Operator, Type, Value, Combine Using],...] (オプション)	いつ特定のカテゴリまたはネットワーク属性のトレースを停止するかを指定します。たとえば、特定の値と等しいライフサイクルステータス属性があるフィーチャでトレースを停止します。このパラメーターを使用して、システムに定義されているネットワーク属性の値に基づいてターミネーターを設定します。複数の属性を使用している場合、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 —属性が値以下である。 INCLUDES_THE_VALUES —値のすべてのビットが属性内に存在するビット単位の論理積演算 (bitwise AND == value)。 DOES NOT INCLUDE_THE_VALUES —値の一部のビットが属性内に存在しないビット単位の論理積演算 (bitwise AND != value)。 INCLUDES_ANY —値の少なくとも 1 つのビットが属性内に存在するビット単位の論理積演算 (bitwise AND == True)。 DOES_NOT_INLCUDE_ANY —値のビットが属性内に存在しないビット単位の論理積演算 (bitwise AND == False)。 bitwise 演算子の詳細フィルターバリアの Type の値オプションは次のとおりです。 SPECIFIC_VALUE —特定の値によるフィルター。 NETWORK_ATTRIBUTE —ネットワーク属性によるフィルター。フィルターバリアの Combine Using の値オプションは次のとおりです。 AND —条件バリアを結合します。 OR —いずれかの条件バリアが満たされている場合に使用します。複数の式の使用方法の詳細	Value Table
filter_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 —属性が値以下である。 INCLUDES_THE_VALUES —値のすべてのビットが属性内に存在するビット単位の論理積演算 (bitwise AND == value)。 DOES_NOT_INCLUDE_THE_VALUES —値の一部のビットが属性内に存在しないビット単位の論理積演算 (bitwise AND != value)。 INCLUDES_ANY —値の少なくとも 1 つのビットが属性内に存在するビット単位の論理積演算 (bitwise AND == True)。 DOES_NOT_INCLUDE_ANY —値のビットが属性内に存在しないビット単位の論理積演算 (bitwise AND == False)。 bitwise 演算子の詳細フィルター関数バリアの Use Local Values オプションは次のとおりです。 TRUE —ローカル値が使用されます。 FALSE —グローバル値が使用されます。これがデフォルトです。	Value Table
filter_scope (オプション)	特定のカテゴリのフィルターをジャンクション、エッジ、その両方のいずれに適用するかを指定します。たとえば、Device Status が Open であり、通過可能性の範囲がエッジのみに設定されている場合にトレースを停止するようにフィルターバリアを定義すると、トレースでオープンデバイスが検出された場合でも、Device Status はジャンクションにしか適用されないため、トレースは停止しません。つまり、このパラメーターは、トレースで、ジャンクション、エッジ、またはその両方を無視するかどうかを示します。 BOTH_JUNCTIONS_AND_EDGES —フィルターをジャンクションとエッジの両方に適用します。これがデフォルトです。 JUNCTIONS_ONLY —フィルターをジャンクションのみに適用します。 EDGES_ONLY —フィルターをエッジのみに適用します。	String
filter_bitset_network_attribute_name (オプション)	bitset によるフィルター処理に使用するネットワーク属性の名前。このパラメーターは、上流、下流、およびループトレースタイプのみに適用できます。このパラメーターを使用すると、トレースが実世界のシナリオをより細密に反映するように、トレース中に特別なロジックを追加できます。たとえば、ループトレースの場合、Phases current ネットワーク属性は、ループが真の電気ループである (ループ全体で同じフェーズに電源が入る) かどうかを判断し、トレース結果の真の電源ループのみを返すことができます。上流トレースの場合、たとえば、配電網のトレース時に Phases current ネットワーク属性を指定することにより、トレース結果に、すべてのパスではなく、ネットワーク属性で指定された有効なパスのみを含めます。	String
filter_nearest (オプション)	K 最近隣内挿アルゴリズムを使用して、所定の距離内の特定のタイプのフィーチャの数を返すかどうかを指定します。このパラメーターを使用すると、個数、コスト、およびカテゴリやアセットタイプのコレクションを指定できます。 FILTER_BY_NEAREST —K 最近隣内挿アルゴリズムを使用して、nearest_count、nearest_cost_network_attribute、nearest_categories、または nearest_assets パラメーターで指定されたさまざまなフィーチャを返します。 DO_NOT_FILTER —K 最近隣内挿アルゴリズムを使用して結果をフィルター処理しません。これがデフォルトです。	Boolean
nearest_count (オプション)	filter_nearest を FILTER_BY_NEAREST にしたときに返されるフィーチャの数。	Long
nearest_cost_network_attribute (オプション)	filter_nearest を FILTER_BY_NEAREST にしたときに、近接性、コスト、または距離の計算に使用される数値のネットワーク属性 (たとえば、形状の長さ)。	String
nearest_categories [nearest_categories,...] (オプション)	filter_nearest を FILTER_BY_NEAREST にしたときに返されるカテゴリ (たとえば、Protective)。	String
nearest_assets [nearest_assets,...] (オプション)	filter_nearest を FILTER_BY_NEAREST にしたときに返されるアセットグループおよびアセットタイプ (たとえば、ElectricDistributionDevice/Transformer/Step Down)。	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 の値を持っています。MINIMUM 関数を使用している場合、結果は 20 になります。MAXIMUM 結果は 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 —属性が値以下である。 INCLUDES_THE_VALUES —値のすべてのビットが属性内に存在するビット単位の論理積演算 (bitwise AND == value)。 DOES_NOT_INCLUDE_THE_VALUES —値の一部のビットが属性内に存在しないビット単位の論理積演算 (bitwise AND != value)。 INCLUDES_ANY —値の少なくとも 1 つのビットが属性内に存在するビット単位の論理積演算 (bitwise AND == True)。 DOES_NOT_INCLUDE_ANY —値のビットが属性内に存在しないビット単位の論理積演算 (bitwise AND == False)。 bitwise 演算子の詳細関数の Filter Type の値オプションは次のとおりです。 SPECIFIC_VALUE —特定の値によるフィルター。 NETWORK_ATTRIBUTE —ネットワーク属性によるフィルター。	Value Table
propagators [[Attribute, Substitution Attribute, Function, Operator, Value],...] (オプション)	伝播させるネットワーク属性、およびトレース中に伝播がどのように発生するかを指定します。伝播されるクラス属性は、サブネットワーク内の他のフィーチャに広められる、サブネットワークコントローラーの重要な値を示します。たとえば、配電モデルでは、位相値を伝播することができます。プロパゲーターの構成は次のとおりです。 Attribute - システム内で定義された任意のネットワーク属性によってフィルタリングします。 Substitution Attribute - bitset ネットワーク属性値の代わりに、代替値を使用します。代替値は、伝播されるネットワーク属性のビット数に基づいてエンコードされます。代替は、フェーズ内の各ビットから別のマップへのマッピングです。たとえば、フェーズ AC では、1 つの代替は、ビット A から B、ビット C から NULL へのマッピングです。この例では、1010 (フェーズ AC) の代替は 0000-0010-0000-0000 (512) です。代替がマッピングをキャプチャし、マッピングは、フェーズ A から B、フェーズ C から NULL へ行われたのであり、その逆 (すなわち、フェーズ A から NULL、フェーズ C から B) ではないことがわかります。 Function - 複数の計算関数から選択します。 Operator - 複数の演算子から選択します。 Value- 演算子の値に基づいて処理を停止させる入力属性タイプの特定の値を指定します。プロパゲーターの function の値オプションは次のとおりです。 PROPAGATED_BITWISE_AND —あるフィーチャの値と次のフィーチャの値を比較します。 PROPAGATED_MIN —最小値を取得します。 PROPAGATED_MAX —最大値を取得します。プロパゲーターの 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 —属性が値以下である。 INCLUDES_THE_VALUES —値のすべてのビットが属性内に存在するビット単位の論理積演算 (bitwise AND == value)。 DOES_NOT_INCLUDE_THE_VALUES —値の一部のビットが属性内に存在しないビット単位の論理積演算 (bitwise AND != value)。 INCLUDES_ANY —値の少なくとも 1 つのビットが属性内に存在するビット単位の論理積演算 (bitwise AND == True)。 DOES_NOT_INCLUDE_ANY —値のビットが属性内に存在しないビット単位の論理積演算 (bitwise AND == False)。 bitwise 演算子の詳細メモ: このパラメーターは Python でのみ使用できます。	Value Table
output_assettypes [output_assettypes,...] (オプション)	結果に含める出力アセットタイプをフィルタリングします (たとえば、頭上の変圧器のみを返す、など)。	String
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 —属性が値以下である。 INCLUDES_THE_VALUES —値のすべてのビットが属性内に存在するビット単位の論理積演算 (bitwise AND == value)。 DOES_NOT_INCLUDE_THE_VALUES —値の一部のビットが属性内に存在しないビット単位の論理積演算 (bitwise AND != value)。 INCLUDES_ANY —値の少なくとも 1 つのビットが属性内に存在するビット単位の論理積演算 (bitwise AND == True)。 DOES_NOT_INCLUDE_ANY —値のビットが属性内に存在しないビット単位の論理積演算 (bitwise AND == False)。 bitwise 演算子の詳細出力条件の Type の値オプションは次のとおりです。 SPECIFIC_VALUE —特定の値によるフィルター。 NETWORK_ATTRIBUTE —ネットワーク属性によるフィルター。出力条件の Combine Using の値オプションは次のとおりです。 AND —条件を結合します。 OR —いずれかの条件を満たした場合に使用します。複数の式の使用方法の詳細	Value Table
include_isolated_features (オプション)	分離フィーチャをトレース結果に含めるかどうかを指定します。このパラメーターは、分離性トレースの実行時にのみ使用されます。 INCLUDE_ISOLATED_FEATURES —分離フィーチャをトレース結果に含めます。 EXCLUDE_ISOLATED_FEATURES —分離フィーチャをトレース結果に含めません。これがデフォルトです。メモ: エンタープライズジオデータベースを使用している場合、分離トレースタイプには ArcGIS Enterprise 10.7 以降が必要です。	Boolean
ignore_barriers_at_starting_points (オプション)	始点ではトレース構成内のダイナミックバリアを無視するかどうかを指定します。これは、上流の保護デバイスのトレースを実行し、検出された保護デバイス (バリア) を始点として使用して、その後の上流の保護デバイスを検索する場合に、役立ちます。 IGNORE_BARRIERS_AT_STARTING_POINTS —始点にあるバリアはトレース内で無視されます。 DO_NOT_IGNORE_BARRIERS_AT_STARTING_POINTS —始点にあるバリアはトレース内で無視されません。これがデフォルトです。	Boolean
include_up_to_first_spatial_container (オプション)	トレース結果内のネットワークエレメントごとに、最初の空間格納器まで (最初の空間格納器を含む) に遭遇した格納器のみを含めるように、返される格納器を制限するかどうかを指定します。所定のネットワークエレメントで、空間格納器が検出されず、非空間格納器のみがある場合、結果にはすべての非空間格納器が含まれます。このパラメーターは、[Include Containers] が [enabled] の場合にのみ適用可能です。 INCLUDE_UP_TO_FIRST_SPATIAL_CONTAINER —トレースパスに沿って、ネストされた格納の関連付けが検出された場合、結果には最初の空間格納器まで (最初の空間格納器を含む) に遭遇した格納器のみが返されます。空間格納器がない場合、所定のネットワークエレメントの結果にはすべての非空間格納器が含まれます。 DO_NOT_INCLUDE_UP_TO_FIRST_SPATIAL_CONTAINER —すべての格納器が結果に返されます。これがデフォルトです。	Boolean
result_types [result_types,...] (オプション)	トレースによって返される結果のタイプを指定します。 SELECTION — トレース操作の結果は、該当するネットワークフィーチャの選択セットとして返されます。これがデフォルトです。 AGGREGATED_GEOMETRY — トレース操作の結果は、ジオメトリタイプによって集約され、アクティブなマップのレイヤー内に表示されるマルチパートフィーチャクラスに格納されます。	String
allow_indeterminate_flow (オプション)	フローが不定のフィーチャをトレースするかどうかを指定します。このパラメーターは、上流解析トレースまたは下流解析トレースを実行する場合にのみ適用されます。 TRACE_INDETERMINATE_FLOW —フローが不定のフィーチャがトレースされます。これがデフォルトです。 IGNORE_INDETERMINATE_FLOW —フローが不定のフィーチャが通過可能でなくなり、トレースされません。	Boolean
validate_locatability (オプション)	通過したフィーチャの関連付け階層内の格納器も構造物も関連付けられていない非空間のジャンクションオブジェクトまたはエッジオブジェクトが検出された場合にエラーを返すかどうかを指定します。このオプションを選択すると、トレースから返された非空間オブジェクトが空間フィーチャに関連付けられているかどうかを確認できます。 VALIDATE_LOCATABILITY —通過したフィーチャの関連付け階層内の格納器も構造物も関連付けられていない非空間のジャンクションオブジェクトまたはエッジオブジェクトが検出された場合に、トレースからエラーが返されます。 DO_NOT_VALIDATE_LOCATABILITY —トレースで配置不可オブジェクトの確認が行われず、通過したオブジェクトの関連付け階層内に配置不可オブジェクトが存在するかどうかに関係なく、トレースから結果が返されます。これがデフォルトです。	Boolean

派生した出力

名前	説明	データタイプ
out_utility_network	更新されるユーティリティネットワーク。	ユーティリティネットワーク

コードのサンプル

AddTraceConfiguration (トレース構成の追加) の例 (Python ウィンドウ)

次の Python ウィンドウスクリプトは、AddTraceConfigurationツールの使用方法を示しています。

import arcpy
arcpy.AddTraceConfiguration_un(
        r"SampleUNService\Elec Utility Network", "Upstream_RMT002", "UPSTREAM", 
        "Upstream trace on RMT002", "Upstream;RMT002", "ElectricDistribution", 
        "Medium Voltage", '', '', '', "EXCLUDE_CONTAINERS", "EXCLUDE_CONTENT", 
        "EXCLUDE_STRUCTURES", "INCLUDE_BARRIERS", "VALIDATE_CONSISTENCY", None, 
        None, "BOTH_JUNCTIONS_AND_EDGES", None, None, "BOTH_JUNCTIONS_AND_EDGES", 
        '', "DO_NOT_FILTER", None, '', None, None, None, None, None, None, 
        "EXCLUDE_ISOLATED_FEATURES", "DO_NOT_IGNORE_BARRIERS_AT_STARTING_POINTS", 
        "DO_NOT_INCLUDE_UP_TO_FIRST_SPATIAL_CONTAINER", None, 
        "TRACE_INDETERMINATE_FLOW", "DO_NOT_VALIDATE_LOCATABILITY")

環境

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

ライセンス情報

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

概要

使用法

構文

メモ:

メモ:

派生した出力

コードのサンプル

環境

ライセンス情報

関連トピック

このトピックの内容