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

サマリー

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

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

使用法

ネットワーク属性は、1 つのフィーチャクラスの 1 つの属性のみに関連付けることができます。ただし、複数のフィーチャクラスに関連付けることはできます。
エンタープライズジオデータベースを操作する場合、接続する ArcGIS Enterprise ポータルアカウントがポータルユーティリティネットワークの所有者である必要があります。
ネットワークトポロジが無効化されている必要があります。
エンタープライズジオデータベースを操作する場合、このツールを実行するには、デフォルトバージョンに接続する必要があります。
エンタープライズジオデータベースを操作する場合は、データベースユーティリティネットワークの所有者として確立されたデータベースコネクションから [入力ユーティリティネットワーク] パラメーターの値を取得する必要があります。
このツールを [ネットワーク属性の設定 (Set Network Attribute)] ツールと組み合わせて使用すると、ユーティリティネットワークのフィーチャクラスフィールドにネットワーク属性を割り当てることができます。
次の表に、ネットワーク属性のタイプとそれに適用可能なパラメーターを表示します。
属性型インライン割り当て可能 Null 値を許可代替
Short
Long
(行外のみ)
Double
Date

パラメーター

ラベル	説明	データタイプ
入力ユーティリティネットワーク	ネットワーク属性を追加する入力ユーティリティネットワーク。	Utility Network; Utility Network Layer
属性名	ユーティリティネットワークに追加するネットワーク属性の名前。	String
属性タイプ	ネットワーク属性のデータタイプを指定します。 Short (16 ビット整数)—フィールドタイプは Short です。 Long (32 ビット整数)—フィールドタイプは Long です。 Double (64 ビット浮動小数点)—フィールドタイプは Double です。 Date—フィールドタイプは日付です。	String
インライン (オプション)	ネットワーク属性をインラインで維持するかどうかを指定します。インラインネットワーク属性の方がやや効率的ですが、ユーザー定義インライン属性のビット数には、1 ユーティリティネットワークあたり 25 ビットという制限があります。可能な限り、最も使用頻度の高いネットワーク属性 (電力網のフェーズ、ガスおよび水道網の圧力など) は、インラインで保存してください。ビットのサイズは、ドメインパラメーターによって決まります。インライン属性は、整数のネットワーク属性 (短、長) でのみサポートされます。オン - 属性はトポロジに内部的に追加され、さらに効率的に取得できるようになります。オフ - 属性は外部テーブルに格納され、取得するには外部ウェイトテーブルの呼び出しが必要になります。これがデフォルトです。	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

派生した出力

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

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—フィールドタイプは Short です。 LONG—フィールドタイプは Long です。 DOUBLE—フィールドタイプは Double です。 DATE—フィールドタイプは日付です。	String
is_inline (オプション)	ネットワーク属性をインラインで維持するかどうかを指定します。インラインネットワーク属性の方がやや効率的ですが、ユーザー定義インライン属性のビット数には、1 ユーティリティネットワークあたり 25 ビットという制限があります。可能な限り、最も使用頻度の高いネットワーク属性 (電力網のフェーズ、ガスおよび水道網の圧力など) は、インラインで保存してください。ビットのサイズは、ドメインパラメーターによって決まります。インライン属性は、整数のネットワーク属性 (短、長) でのみサポートされます。 INLINE—属性はトポロジに内部的に追加され、さらに効率的に取得できるようになります。 NOT_INLINE—属性は外部テーブルに格納され、取得するには外部加重テーブルの呼び出しが必要になります。これがデフォルトです。	Boolean
is_apportionable (オプション)	同じフィーチャに属している複数のエッジにネットワーク属性を割り当てるかどうかを指定します。たとえば、shape_length ネットワーク属性では、1 つのラインフィーチャが 5 つのエッジエレメントで構成され、そのラインフィーチャの全長が 100 フィートの場合、その属性は、20 フィートずつすべてのエッジに割り当てられます。値の配分は、元のフィーチャの始点に対して各エッジエレメント沿いのパーセンテージによって異なります。 APPORTIONABLE—ネットワーク属性が割り当てられます。 NOT_APPORTIONABLE—ネットワーク属性が割り当てられません。これがデフォルトです。	Boolean
domain (オプション)	ネットワーク属性が関連付けられるドメイン。このパラメーターは、is_inline が INLINE の場合に必須です。このドメインは、インライン属性に割り当てるビット数を決定するために使用され、コード値タイプである必要があります。たとえば、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	更新されるユーティリティネットワーク。	Utility Network

コードのサンプル

AddNetworkAttribute の例 1 (Python ウィンドウ)

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

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

AddNetworkAttribute の例 2 (Python ウィンドウ)

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

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

環境

現在のワークスペース

ライセンス情報

Basic: No
Standard: Yes
Advanced: Yes

サマリー

使用法

パラメーター

注意:

派生した出力

注意:

派生した出力

コードのサンプル

環境

ライセンス情報

関連トピック

このトピックの内容