ネットワーク属性の追加 (Add Network Attribute) (トレース ネットワーク)

サマリー

ネットワーク属性をトレース ネットワークに追加します。

使用法

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

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

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

    ネットワーク属性の作成の詳細

  • エンタープライズ ジオデータベースを操作する場合、次の要件があります。

    • 入力トレース ネットワークは、データベース トレース ネットワークの所有者として、確立されたデータベース接続から取得する必要があります。

    • 接続された ArcGIS Enterprise ポータル アカウントは、「ポータル トレース ネットワークの所有者」である必要があります。

    • ライセンス:
      アクティブなポータル アカウントは、エンタープライズ ジオデータベースでトレース ネットワークを作成、公開、操作するための「ArcGIS Advanced Editing」ユーザー タイプ エクステンションのライセンスが付与される必要があります。
    • このツールを実行するには、デフォルト バージョンに接続させる必要があります。
  • 次の表に、ネットワーク属性のタイプとそれに適用可能なパラメーターを表示します。

    属性タイプ割り当て可能Null 値を許可

    Short

    チェック マーク

    Long

    チェック マーク

    Double

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

    Date

    チェック マーク

パラメーター

ラベル説明データ タイプ
入力トレース ネットワーク

ネットワーク属性が追加される入力トレース ネットワーク。

Trace Network; Trace Network Layer
属性名

トレース ネットワークに追加するネットワーク属性の名前。

String
属性タイプ

ネットワーク属性のデータ タイプを指定します。

  • Short (16 ビット整数)フィールド タイプは Short です。
  • Long (32 ビット整数)フィールド タイプは Long です。
  • Double (64 ビット浮動小数点)フィールド タイプは Double です。
  • Dateフィールド タイプは date です。
String
Null 値を許可
(オプション)

ネットワーク属性が Null 値をサポートするかどうかを指定します。

  • オン - ネットワーク属性は Null 値をサポートします。
  • オフ - ネットワーク属性は Null 値をサポートしません。 これがデフォルトです。

Boolean
割り当て可能
(オプション)

同じフィーチャに属している複数のエッジにネットワーク属性を割り当てるかどうかを指定します。

割り当て動作は、Double ネットワーク属性でのみサポートされます。 割り当て可能なプロパティを含むネットワーク属性は、ライン フィーチャクラスまたはポイント フィーチャクラスのフィールドに割り当てることができますが、割り当て動作を実行するのはライン フィーチャのみです。

たとえば、shape_length ネットワーク属性で、1 つのライン フィーチャが 5 つの「エッジ エレメント」で構成され、各エッジ エレメントは 20 フィートであり、そのライン フィーチャの全長が 100 フィートであるとします。 この属性はすべてのエッジに割り当てられます。 たとえば、接続トレース内の関数を使用してこのラインの shape length 属性をカウントすると、ライン全体ではなく個々のエッジ エレメントに基づくため、カウントとして 5 が返されます。 値の配分は、元のフィーチャの始点に対して各エッジ エレメント沿いのパーセンテージによって異なります。

  • オン - ネットワーク属性が割り当てられます。
  • オフ - ネットワーク属性が割り当てられません。 これがデフォルトです。
Boolean

派生した出力

ラベル説明データ タイプ
更新されたトレース ネットワーク

更新されるトレース ネットワーク。

Trace Network

arcpy.tn.AddNetworkAttribute(in_trace_network, attribute_name, attribute_type, {is_nullable}, {is_apportionable})
名前説明データ タイプ
in_trace_network

ネットワーク属性が追加される入力トレース ネットワーク。

Trace Network; Trace Network Layer
attribute_name

トレース ネットワークに追加するネットワーク属性の名前。

String
attribute_type

ネットワーク属性のデータ タイプを指定します。

  • SHORTフィールド タイプは Short です。
  • LONGフィールド タイプは Long です。
  • DOUBLEフィールド タイプは Double です。
  • DATEフィールド タイプは date です。
String
is_nullable
(オプション)

ネットワーク属性が Null 値をサポートするかどうかを指定します。

  • NULLABLEネットワーク属性は Null 値をサポートします。
  • NOT_NULLABLEネットワーク属性は Null 値をサポートしません。 これがデフォルトです。
Boolean
is_apportionable
(オプション)

同じフィーチャに属している複数のエッジにネットワーク属性を割り当てるかどうかを指定します。

割り当て動作は、Double ネットワーク属性でのみサポートされます。 割り当て可能なプロパティを含むネットワーク属性は、ライン フィーチャクラスまたはポイント フィーチャクラスのフィールドに割り当てることができますが、割り当て動作を実行するのはライン フィーチャのみです。

たとえば、shape_length ネットワーク属性で、1 つのライン フィーチャが 5 つのエッジ エレメントで構成され、各エッジ エレメントは 20 フィートであり、そのライン フィーチャの全長が 100 フィートであるとします。 この属性はすべてのエッジに割り当てられます。 たとえば、接続トレース内の関数を使用してこのラインの shape_length 属性をカウントすると、ライン全体ではなく個々のエッジ エレメントに基づくため、カウントとして 5 が返されます。 値の配分は、元のフィーチャの始点に対して各エッジ エレメント沿いのパーセンテージによって異なります。

  • APPORTIONABLEネットワーク属性が割り当てられます。
  • NOT_APPORTIONABLEネットワーク属性が割り当てられません。 これがデフォルトです。
Boolean

派生した出力

名前説明データ タイプ
out_trace_network

更新されるトレース ネットワーク。

Trace Network

コードのサンプル

AddNetworkAttribute の例 (Python ウィンドウ)

Velocity という名前の割り当て可能なネットワーク属性を double 属性タイプで追加します。

import arcpy
arcpy.tn.AddNetworkAttribute("Trace Network", "Velocity", "DOUBLE", "APPORTIONABLE")

環境

このツールは、ジオプロセシング環境を使用しません。

ライセンス情報

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

関連トピック