概要
[トレース (Trace)] ツールの始点とバリア入力として使用するフィーチャクラスを作成します。
使用法
出力フィーチャクラスには、[トレース (Trace)] ツールへの入力として必要な入力始点および入力バリアと同じスキーマがあります。このため、ModelBuilder またはスクリプト環境でトレース操作全体にさまざまなトレース位置を指定することができます。
[選択フィーチャの読み込み] パラメーターと [トレース位置] パラメーターは、相互排除されているため、同時に値を指定することができません。
構文
arcpy.un.AddTraceLocations(in_utility_network, out_feature_class, {load_selected_features}, {clear_trace_locations}, {trace_locations}, filter_barrier)| パラメーター | 説明 | データ タイプ |
in_utility_network | トレース位置を追加する入力ユーティリティ ネットワーク。 | Utility Network; Utility Network Layer |
out_feature_class | トレース位置を含む出力フィーチャクラス。新しいフィーチャクラス名を指定した場合、新しい出力フィーチャクラスが作成されます。 このツールで以前に作成した既存のフィーチャクラスを使用するか、既存の位置に追加または上書きするには、既存のフィーチャクラスの名前を指定します。 | Feature Class |
load_selected_features (オプション) | アクティブなマップ上で選択したフィーチャをトレース位置として読み込むかどうかを指定します。
| Boolean |
clear_trace_locations (オプション) | 出力フィーチャクラスからトレース位置を消去するかどうかを指定します。
| Boolean |
trace_locations [[Layer Name, Global ID, Terminal ID, Percent Along],...] (オプション) | 出力フィーチャクラスに追加するトレース位置。アクティブなマップで [load_selected_features] パラメーターを使用していない場合は、このパラメーターを使用し、必要な値を値テーブルに入力して、トレース位置として追加するユーティリティ ネットワーク フィーチャを指定することができます。 トレース位置のプロパティは次のとおりです。
| Value Table |
filter_barrier | トレース位置のバリアの動作を指定します。 メモ:このパラメーターには ArcGIS Enterprise 10.8.1 以降が必要です。 | Boolean |
コードのサンプル
アクティブなマップ上で選択したフィーチャを読み込んで、TraceLocations という名前の新しい出力フィーチャクラスにトレース位置を追加します。
import arcpy
arcpy.env.outputZFlag = "Enabled"
arcpy.AddTraceLocations_un("Naperville Electric UN",
r"C:\MyUNProject\MyUNProject.gdb\TraceLocations",
"LOAD_SELECTED_FEATURES")アクティブなマップなしで、TraceLocations という名前の既存のフィーチャクラスにトレース位置を追加します。
import arcpy
# Set the outputZFlag environment to Enabled
arcpy.env.outputZFlag = "Enabled"
# AddTraceLocations
arcpy.AddTraceLocations_un(r"http://utilitynetwork.esri.com/server/rest/services/NapervilleElectric/FeatureServer/9",
r"C:\MyUNProject\MyUNProject.gdb\TraceLocations",
"DO_NOT_LOAD_SELECTED_FEATURES",
"KEEP_LOCATIONS",
r"'Circuit Breaker' {DDB0765D-860A-4054-908D-9360E1A32F74} '(3/Load)' '';'Circuit Breaker' {4849D307-6413-40B7-B672-716AF50EE6E6} '(3/Load)' '' )ライセンス情報
- Basic: いいえ
- Standard: はい
- Advanced: はい