ネットワーク属性の追加 (Add Network Attribute) (ユーティリティ ネットワーク)

サマリー

ネットワーク属性をユーティリティ ネットワークに追加します。

ネットワーク属性は、ネットワーク内の対応するフィーチャの属性から取得される値であり、ネットワーク トポロジに保存されています。ネットワーク属性は、ネットワークがどのように通過するかを制御し、トレース解析時に使用されます。1 つのネットワーク属性に関連付けることができるのは、1 つのフィーチャクラスあたり 1 つの属性のみですが、1 つのユーティリティ ネットワークに設定できるネットワーク属性の数に制限はありません。ネットワーク属性は、通過可能性を制御し、ネットワーク内のパスのコストをモデリングするために、ウェイトとして使用されます。

使用法

• ネットワーク属性は、1 つのフィーチャクラスの 1 つの属性のみに関連付けることができます。ただし、複数のフィーチャクラスに関連付けることはできます。

• エンタープライズ ジオデータベースを操作する場合、接続する ArcGIS Enterprise ポータル アカウントがポータル ユーティリティ ネットワーク所有者である必要があります。

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

• エンタープライズ ジオデータベースを操作する場合、このツールは、実行時にデフォルト バージョンに接続する必要があります。

• エンタープライズ ジオデータベースを操作する場合、[入力ユーティリティ ネットワーク] パラメーターは、データベース ユーティリティ ネットワークの所有者として、確立されたデータベース接続から取得する必要があります。

• このツールは、ユーティリティ ネットワークのフィーチャクラス フィールドにネットワーク属性を割り当てる [ネットワーク属性の設定 (Set Network Attribute)] ツールとともに使用できます。

• 次の表に、ネットワーク属性のタイプとそれに適用可能なパラメーターを表示します。

  属性型	イン ライン	割り当て可能	Null 値を許可	代替
  Short
  Long				(行外のみ)
  Double
  Date

パラメーター

ダイアログ

ラベル	説明	データ タイプ
入力ユーティリティ ネットワーク	ネットワーク属性を追加する入力ユーティリティ ネットワーク。	Utility Network; Utility Network Layer
属性名	ユーティリティ ネットワークに追加するネットワーク属性の名前。	String
属性型	ネットワーク属性のデータ タイプを指定します。 Short (Small Integer)—短整数タイプ Long (Large Integer)—長整数タイプ Double (double precision)—倍精度タイプ Date—日付タイプ	String
イン ライン (オプション)	ネットワーク属性をイン ラインで維持するかどうかを指定します。インライン ネットワーク属性の方がやや効率的ですが、インライン属性のビット数には、1 ユーティリティ ネットワークあたり 28 ビットという制限があります。可能な限り、最も使用頻度の高いネットワーク属性 (電力網のフェーズ、ガスおよび水道網の圧力など) は、インラインで保存してください。ビットのサイズは、ドメイン パラメーターによって決まります。インライン属性は、整数のネットワーク属性でのみサポートされます。 オン - 属性はトポロジに内部的に追加され、さらに効率的に取得できるようになります。 オフ - 属性は外部テーブルに格納され、取得するには外部ウェイト テーブルの呼び出しが必要になります。これがデフォルトです。	Boolean
割り当て可能 (オプション)	同じフィーチャに属している複数のエッジにネットワーク属性を割り当てるかどうかを指定します。 割り当て可能なプロパティを含むネットワーク属性は、ライン フィーチャクラスまたはジャンクション フィーチャクラスのフィールドに割り当てることができますが、割り当て動作を実行するのはライン フィーチャのみです。 たとえば、shape_length ネットワーク属性では、1 つのライン フィーチャが 5 つのエッジ エレメントで構成され、そのライン フィーチャの全長が 100 フィートの場合、その属性は、20 フィートずつすべてのエッジに割り当てられます。値の配分は、元のフィーチャの始点に対して各エッジ エレメント沿いのパーセンテージによって異なります。 オン - ネットワーク属性が割り当てられます。 オフ - ネットワーク属性が割り当てられません。これがデフォルトです。	Boolean
ドメイン名 (オプション)	ネットワーク属性が関連付けられるドメイン。このパラメーターは、[イン ライン] がオンになっている場合は必須です。このドメインは、インライン属性に割り当てるビット数を決定するために使用され、コード値タイプである必要があります。たとえば、LifeCycleStatusDomain (0, Unknown | 1, In-Service | 2, Proposed | 3, Abandoned) ドメインには 4 つのエントリがあります。インライン属性を保存するのに、2 ビットが必要です。コード値ドメインには、0 から始まる連続コードが含まれる必要があります。	String
オーバーライド可能 (オプション)	注意: このパラメーターは使用されず、現在のリリースでは、入力した値は無視されます。このパラメーターの機能は開発中であり、将来のリリースで適用可能になる予定です。 ネットワーク トポロジが読み込み、トポロジ内に格納された現在の値を無視 (または上書き) する外部オーバーライド テーブルがネットワーク属性にあるかどうかを指定します。電気の場合の現在位置やガスの場合の圧力値など、外部システムからのライブデータを入力するために使用されます。例として、更新される Device A の切り替え位置を DeviceStatus ネットワーク属性にプッシュし、その後トポロジ エンジンがそれを使用して、Device A のデバイス ステータスの現在値をオーバーライド値でオーバーライドする SCADA システムがあります。 オン - トポロジ内に格納された現在の値が無視されます。 オフ - トポロジ内に格納された現在の値が無視されません。これがデフォルトです。	Boolean
Null 値を許可 (オプション)	ネットワーク属性が Null 値をサポートするかどうかを指定します。 オン - ネットワーク属性は Null 値をサポートします。 オフ - ネットワーク属性は Null 値をサポートしません。これがデフォルトです。	Boolean
代替 (オプション)	ネットワーク属性が代替として使用されるかどうかを指定します。代替ネットワーク属性を使用すると、トレース操作の反映中に、ビットセット ネットワーク属性値ではなく、代替値を使用できます。 オン - ネットワーク属性が代替として使用されます。 オフ - ネットワーク属性が代替として使用されません。これがデフォルトです。	Boolean
代替するネットワーク属性 (オプション)	代替に使用されるネットワーク属性。代替は、反映されるネットワーク属性のビット数に基づいてエンコードされます。ネットワーク属性は、インラインで、8 ビット以下の整数フィールド タイプである必要があります。	String

派生した出力

ラベル	説明	データ タイプ
更新されたユーティリティ ネットワーク	更新されるユーティリティ ネットワーク。	ユーティリティ ネットワーク

Python

arcpy.un.AddNetworkAttribute(in_utility_network, attribute_name, attribute_type, {is_inline}, {is_apportionable}, {domain}, {is_overridable}, {is_nullable}, {is_substitution}, {network_attribute_to_substitute})

名前	説明	データ タイプ
in_utility_network	ネットワーク属性を追加する入力ユーティリティ ネットワーク。	Utility Network; Utility Network Layer
attribute_name	ユーティリティ ネットワークに追加するネットワーク属性の名前。	String
attribute_type	ネットワーク属性のデータ タイプを指定します。 SHORT—短整数タイプ LONG—長整数タイプ DOUBLE—倍精度タイプ DATE—日付タイプ	String
is_inline (オプション)	ネットワーク属性をイン ラインで維持するかどうかを指定します。インライン ネットワーク属性の方がやや効率的ですが、インライン属性のビット数には、1 ユーティリティ ネットワークあたり 28 ビットという制限があります。可能な限り、最も使用頻度の高いネットワーク属性 (電力網のフェーズ、ガスおよび水道網の圧力など) は、インラインで保存してください。ビットのサイズは、ドメイン パラメーターによって決まります。インライン属性は、整数のネットワーク属性でのみサポートされます。 INLINE—属性はトポロジに内部的に追加され、さらに効率的に取得できるようになります。 NOT_INLINE—属性は外部テーブルに格納され、取得するには外部ウェイト テーブルの呼び出しが必要になります。これがデフォルトです。	Boolean
is_apportionable (オプション)	同じフィーチャに属している複数のエッジにネットワーク属性を割り当てるかどうかを指定します。 たとえば、shape_length ネットワーク属性では、1 つのライン フィーチャが 5 つのエッジ エレメントで構成され、そのライン フィーチャの全長が 100 フィートの場合、その属性は、20 フィートずつすべてのエッジに割り当てられます。値の配分は、元のフィーチャの始点に対して各エッジ エレメント沿いのパーセンテージによって異なります。 APPORTIONABLE—ネットワーク属性が割り当てられます。 NOT_APPORTIONABLE—ネットワーク属性が割り当てられません。これがデフォルトです。	Boolean
domain (オプション)	ネットワーク属性が関連付けられるドメイン。このパラメーターは、is_inline が True の場合は必須です。このドメインは、インライン属性に割り当てるビット数を決定するために使用され、コード値タイプである必要があります。たとえば、LifeCycleStatusDomain (0, Unknown | 1, In-Service | 2, Proposed | 3, Abandoned) ドメインには 4 つのエントリがあります。インライン属性を保存するのに、2 ビットが必要です。コード値ドメインには、0 から始まる連続コードが含まれる必要があります。	String
is_overridable (オプション)	注意: このパラメーターは使用されず、現在のリリースでは、入力した値は無視されます。このパラメーターの機能は開発中であり、将来のリリースで適用可能になる予定です。 ネットワーク トポロジが読み込み、トポロジ内に格納された現在の値を無視 (または上書き) する外部オーバーライド テーブルがネットワーク属性にあるかどうかを指定します。電気の場合の現在位置やガスの場合の圧力値など、外部システムからのライブ データを入力するために使用されます。例として、更新される Device A の切り替え位置を DeviceStatus ネットワーク属性にプッシュし、その後トポロジ エンジンがそれを使用して、Device A のデバイス ステータスの現在値をオーバーライド値でオーバーライドする SCADA システムがあります。 OVERRIDE—トポロジ内に格納された現在の値が無視されます。 NOT_OVERRIDABLE—トポロジ内に格納された現在の値が無視されません。これがデフォルトです。	Boolean
is_nullable (オプション)	ネットワーク属性が Null 値をサポートするかどうかを指定します。 NULLABLE—ネットワーク属性は Null 値をサポートします。 NOT_NULLABLE—ネットワーク属性は Null 値をサポートしません。これがデフォルトです。	Boolean
is_substitution (オプション)	ネットワーク属性が代替として使用されるかどうかを指定します。代替ネットワーク属性を使用すると、トレース操作の反映中に、ビットセット ネットワーク属性値ではなく、代替値を使用できます。 SUBSTITUTION—ネットワーク属性が代替として使用されます。 NOT_SUBSTITUTION—ネットワーク属性が代替として使用されません。これがデフォルトです。	Boolean
network_attribute_to_substitute (オプション)	代替に使用されるネットワーク属性。代替は、反映されるネットワーク属性のビット数に基づいてエンコードされます。ネットワーク属性は、インラインで、8 ビット以下の整数フィールド タイプである必要があります。	String

派生した出力

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

コードのサンプル

AddNetworkAttribute (ネットワーク属性の追加) の例 1 (Python ウィンドウ)

Device Status という名前のネットワーク属性を short 属性タイプで追加します。

import arcpy
arcpy.AddNetworkAttribute_un("Utility Network", "Device Status", "SHORT", 
                             "INLINE", "NOT_APPORTIONABLE", "", 
                             "ElectricDistributionDeviceStatus", 
                             "NOT_OVERRIDABLE")

AddNetworkAttribute (ネットワーク属性の追加) の例 2 (Python ウィンドウ)

代替に使用するネットワーク属性を追加します。

import arcpy
arcpy.AddNetworkAttribute_un("Utility Network", 
                             "Phases", "LONG", "NOT_INLINE", 
                             "NOT_APPORTIONABLE", 
                             "ElectricDistributionDeviceStatus", "", 
                             "NOT_NULLABLE", "SUBSTITUTION", 
                             "Phases current")

環境

現在のワークスペース

特殊なケース

ライセンス情報

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