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

概要

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

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

使用法

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

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

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

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

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

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

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

    属性型イン ライン割り当て可能Null 値を許可代替

    Short

    チェック マークチェック マーク

    Long

    チェック マークチェック マークチェック マーク

    (行外のみ)

    Double

    チェック マークチェック マーク

    Date

    チェック マーク

構文

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_inlineTrue の場合は必須です。このドメインは、インライン属性に割り当てるビット数を決定するために使用され、コード値タイプである必要があります。たとえば、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: いいえ
  • Standard: はい
  • Advanced: はい

関連トピック