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

サマリー

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

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

使用法

ネットワーク属性は、1 つのフィーチャクラスの 1 つの属性のみに関連付けることができます。ただし、複数のフィーチャクラスに関連付けることはできます。
エンタープライズジオデータベースを操作する場合、接続する ArcGIS Enterprise ポータルアカウントがポータルユーティリティネットワークの所有者である必要があります。
ネットワークトポロジが、無効化されている必要があります。
エンタープライズジオデータベースを操作する場合、このツールを実行するには、デフォルトバージョンに接続する必要があります。
エンタープライズジオデータベースを操作する場合は、データベースユーティリティネットワークの所有者として確立されたデータベースコネクションから、[入力ユーティリティネットワーク] パラメーターの値を取得する必要があります。

ライセンス:

エンタープライズ配置でこのツールを使用するには、アクティブなポータルアカウントは、ArcGIS Advanced Editing ユーザータイプエクステンションのライセンスが付与される必要があります。

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

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


属性タイプ	インライン	割り当て可能	Null 値を許可	代替
Short
Long				(行外のみ)
Double
Date
Big Integer 注意: Big Integer ネットワーク属性は、ユーティリティネットワークバージョン 7 以降でサポートされています。

パラメーター

ラベル	説明	データタイプ
入力ユーティリティネットワーク	ネットワーク属性を追加する入力ユーティリティネットワーク。	Utility Network; Utility Network Layer
属性名	ユーティリティネットワークに追加されるネットワーク属性の名前。	String
属性タイプ	ネットワーク属性のデータタイプを指定します。 Short (16 ビット整数)—フィールドタイプは Short です。 Long (32 ビット整数)—フィールドタイプは Long です。 Double (64 ビット浮動小数点)—フィールドタイプは Double です。 Date—フィールドタイプは Date です。 Big Integer (64 ビット整数)—フィールドタイプは Big Integer です。	String
インライン (オプション)	ネットワーク属性をインラインで維持するかどうかを指定します。インラインネットワーク属性の方がやや効率的ですが、ユーザー定義インライン属性のビット数には、1 ユーティリティネットワークあたり 25 ビットという制限があります。可能な限り、最も使用頻度の高いネットワーク属性 (電力網のフェーズ、ガスおよび水道網の圧力など) は、インラインで保存してください。ビットのサイズは、ドメインパラメーターによって決まります。インライン属性は、整数のネットワーク属性 (Short または Long) でのみサポートされます。オン - 属性は、トポロジに内部的に追加され、さらに効率的に取得できるようになります。オフ - 属性は、外部テーブルに格納され、取得するには外部ウェイトテーブルの呼び出しが必要になります。これがデフォルトです。	Boolean
割り当て可能 (オプション)	同じフィーチャに属している複数のエッジに、ネットワーク属性を割り当てるかどうかを指定します。割り当て動作は、Double ネットワーク属性でのみサポートされます。割り当て可能なプロパティを含むネットワーク属性は、ラインフィーチャクラスまたはジャンクションフィーチャクラスのフィールドに割り当てることができますが、割り当て動作を実行するのはラインフィーチャのみです。たとえば、shape_length ネットワーク属性と、各 20 フィートの 5 つのエッジエレメントで構成された合計 100 フィートの 1 つのラインフィーチャが存在する場合、その属性は、すべてのエッジに割り当てられます。たとえば、接続トレース内の関数を使用してこのラインの shape length 属性をカウントすると、ライン全体ではなく個々のエッジエレメントに基づくため、カウントとして 5 が返されます。値の配分は、元のフィーチャの始点に対して各エッジエレメント沿いのパーセンテージによって異なります。オン - ネットワーク属性が割り当てられます。オフ - ネットワーク属性が割り当てられません。これがデフォルトです。	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
代替 (オプション)	ネットワーク属性が、代替として使用されるかどうかを指定します。代替ネットワーク属性を使用すると、トレース操作の伝達中に、bitset ネットワーク属性値ではなく、代替値を使用できます。代替は、Long integer ネットワーク属性でのみサポートされます。オン - ネットワーク属性が、代替として使用されます。オフ - ネットワーク属性が、代替として使用されません。これがデフォルトです。	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—フィールドタイプは Date です。 BIGINTEGER—フィールドタイプは Big Integer です。	String
is_inline (オプション)	ネットワーク属性をインラインで維持するかどうかを指定します。インラインネットワーク属性の方がやや効率的ですが、ユーザー定義インライン属性のビット数には、1 ユーティリティネットワークあたり 25 ビットという制限があります。可能な限り、最も使用頻度の高いネットワーク属性 (電力網のフェーズ、ガスおよび水道網の圧力など) は、インラインで保存してください。ビットのサイズは、ドメインパラメーターによって決まります。インライン属性は、整数のネットワーク属性 (Short または Long) でのみサポートされます。 INLINE—属性は、トポロジに内部的に追加され、さらに効率的に取得できるようになります。 NOT_INLINE—属性は、外部テーブルに格納され、取得するには外部ウェイトテーブルの呼び出しが必要になります。これがデフォルトです。	Boolean
is_apportionable (オプション)	同じフィーチャに属している複数のエッジにネットワーク属性を割り当てるかどうかを指定します。割り当て動作は、Double ネットワーク属性でのみサポートされます。割り当て可能なプロパティを含むネットワーク属性は、ラインフィーチャクラスまたはジャンクションフィーチャクラスのフィールドに割り当てることができますが、割り当て動作を実行するのはラインフィーチャのみです。たとえば、shape_length ネットワーク属性と、各 20 フィートの 5 つのエッジエレメントで構成された合計 100 フィートの 1 つのラインフィーチャが存在する場合、その属性は、すべてのエッジに割り当てられます。たとえば、接続トレース内の関数を使用してこのラインの shape_length 属性をカウントすると、ライン全体ではなく個々のエッジエレメントに基づくため、カウントとして 5 が返されます。値の配分は、元のフィーチャの始点に対して、各エッジエレメント沿いのパーセンテージによって異なります。 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 (オプション)	ネットワーク属性が、代替として使用されるかどうかを指定します。代替ネットワーク属性を使用すると、トレース操作の伝達中に、bitset ネットワーク属性値ではなく、代替値を使用できます。代替は、Long integer ネットワーク属性でのみサポートされます。 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

サマリー

使用法

ライセンス:

注意:

パラメーター

注意:

派生した出力

注意:

派生した出力

コードのサンプル

環境

ライセンス情報

関連トピック

このトピックの内容