メイン リング レイアウトの追加 (Add Main Ring Layout) (ネットワーク ダイアグラム)

サマリー

メイン リング レイアウト アルゴリズムをレイアウトのリストに追加して、指定したテンプレートに基づいて、ダイアグラム構築の終了時に自動的に連結されるようにします。さらに、このツールは、そのテンプレートに基づいてダイアグラムのメイン リング レイアウト アルゴリズム パラメーターを事前設定します。

このレイアウト アルゴリズムは、メイン リングの周囲にダイアグラム フィーチャを配置し、メイン リングに沿って配置された各ダイアグラム ジャンクションに接続するダイアグラム フィーチャのサブセットを階層的にレイアウトします。

メイン リング レイアウト アルゴリズムの詳細

注意:

このツールは、構成および管理ツールです。

注意:

このツールは、入力ダイアグラム テンプレートに基づく、既存のダイアグラムの一貫性に影響を与えます。 更新されるまで、既存のダイアグラムは、すべて一貫性なしになり、一貫性警告アイコン 更新するダイアグラム が表示されます。

使用法

  • このツールは、ユーティリティ ネットワーク サービスまたはトレース ネットワーク サービスを使用する場合、サポートされません。 ファイルまたはモバイル ジオデータベース内のユーティリティ ネットワークまたはトレース ネットワークを使用するか、エンタープライズ ジオデータベース内のユーティリティ ネットワークまたはトレース ネットワークへのデータベース コネクションを使用する必要があります。 エンタープライズ ジオデータベースを操作する場合、次の要件があります。

  • ダイアグラム テンプレートに基づいて、ダイアグラムのレイアウト アルゴリズム パラメーターを事前に設定するには、[有効] パラメーターをオフにします (is_active = "INACTIVE" では Python)。

  • また、入力ダイアグラム テンプレートに基づく、ダイアグラムの生成の終了時に、自動的に連結されるレイアウトのリストに、レイアウト アルゴリズムを追加する場合は、[有効] をオンにして (is_active = "ACTIVE" では Python)、このツールを実行します。

パラメーター

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

変更するダイアグラム テンプレートを含むユーティリティ ネットワークまたはトレース ネットワーク。

Utility Network; Trace Network
入力ダイアグラム テンプレート

変更するダイアグラム テンプレートの名前。

String
アクティブ

指定したテンプレートに基づくダイアグラムの生成中に、レイアウト アルゴリズムを自動的に実行するかどうかを指定します。

  • オン - [入力ダイアグラム テンプレート] パラメーター値に基づくダイアグラムの生成中に、追加されたレイアウト アルゴリズムが自動的に実行されます。 これがデフォルトです。

    レイアウト アルゴリズムに指定されたパラメーター値は、ダイアグラム生成中に、レイアウトの実行に使用されます。 また、このパラメーター値は、入力テンプレートに基づくダイアグラムでアルゴリズムを実行する際に、デフォルトで読み込まれます。

  • オフ - 追加されたレイアウト アルゴリズムに現在指定されているパラメーター値はすべて、入力テンプレートに基づくダイアグラムでアルゴリズムを実行する際に、デフォルトで読み込まれます。

Boolean
格納器レイアウトを維持
(オプション)

アルゴリズムが格納器を処理する方法を指定します。

  • オン - 格納器が保持されるよう、ダイアグラムの上位グラフに、レイアウト アルゴリズムを適用します。
  • オフ - ダイアグラム内の格納物フィーチャと非格納物フィーチャの両方に、レイアウト アルゴリズムを適用します。 これがデフォルトです。

Boolean
リング タイプ
(オプション)

リングのタイプを指定します。

  • 楕円形検出されたメイン リングのダイアグラム フィーチャが楕円に沿って表示されます。これがデフォルトです。
  • 四角形検出されたメイン リングのダイアグラム フィーチャが矩形に沿って表示されます。
String
ダイアグラム座標系の間隔値に絶対単位を使用
(オプション)

距離を表すパラメーターの解釈方法を指定します。

  • オン - レイアウト アルゴリズムは、距離値を距離単位で解釈します。
  • オフ - レイアウト アルゴリズムは、現在のダイアグラムの範囲内にあるジャンクションの平均サイズを 1 とする相対単位で、距離値を解釈します。 これがデフォルトです。

Boolean
リング幅
(オプション)

リング幅。デフォルトは、ダイアグラムの座標系の単位です。このパラメーターは、絶対単位を使用する場合にのみ利用可能です。

Linear Unit
リング幅
(オプション)

リング幅。デフォルトは 50 です。このパラメーターは、比例単位を使用する場合にのみ利用可能です。

Double
リングの高さ
(オプション)

リングの高さ。デフォルトは、ダイアグラムの座標系の単位です。このパラメーターは、絶対単位を使用する場合にのみ利用可能です。

Linear Unit
リングの高さ
(オプション)

リングの高さ。デフォルトは 20 です。このパラメーターは、比例単位を使用する場合にのみ利用可能です。

Double
階層的ツリー タイプ
(オプション)

メイン リングのジャンクションから描画されるツリーの配置方法を指定します。

  • 主軸ツリーの両側各ツリーは主軸に沿って表示され、関連する分岐は主軸の左右両側に配置されます。
  • 主軸ツリーの左側のみ各ツリーは主軸に沿って階層的に表示され、関連する分岐は主軸の左側に配置されます。
  • 主軸ツリーの右側のみ各ツリーは主軸に沿って階層的に表示され、関連する分岐は主軸の右側に配置されます。
  • スマート ツリー各ツリーは、スマート ツリーとして階層的に表示されます。これがデフォルトです。
String
方向に垂直なジャンクション間隔
(オプション)

ツリーの方向に対して垂直に表示され、同じサブツリー レベルに属しているダイアグラム ジャンクションの間隔。デフォルトは、ダイアグラムの座標系の単位で 2 です。このパラメーターは、絶対単位を使用する場合にのみ利用可能です。

Linear Unit
方向に垂直なジャンクション間隔
(オプション)

ツリーの方向に対して垂直に表示され、同じサブツリー レベルに属しているダイアグラム ジャンクションの間隔。デフォルトは 2 です。このパラメーターは、比例単位を使用する場合にのみ利用可能です。

Double
方向に沿ったジャンクション間隔
(オプション)

ツリーの方向に沿って表示されるダイアグラム ジャンクションの間隔。デフォルトは、ダイアグラムの座標系の単位で 2 です。このパラメーターは、絶対単位を使用する場合にのみ利用可能です。

Linear Unit
方向に沿ったジャンクション間隔
(オプション)

ツリーの方向に沿って表示されるダイアグラム ジャンクションの間隔。デフォルトは 2 です。このパラメーターは、比例単位を使用する場合にのみ利用可能です。

Double
ブレーク ポイントの相対位置 (%)
(オプション)

[エッジ表示タイプ][標準エッジ] (edge_display_type = "REGULAR_EDGES" では Python) または [エッジ表示タイプ][直交エッジ] (edge_display_type = "ORTHOGONAL_EDGES" では Python) に設定されている場合、ダイアグラム エッジに沿って挿入されるブレーク ポイントの相対位置。 パーセントを 0 ~ 100 の範囲で表します。

  • ブレーク ポイントの相対位置 (%) の値を 0 にすると、水平ツリーの場合、ブレーク ポイントは、エッジの From ジャンクションの X 座標およびエッジの To ジャンクションの Y 座標に配置されます。 垂直ツリーの場合、エッジの From ジャンクションの Y 座標およびエッジの To ジャンクションの X 座標に配置されます。
  • ブレーク ポイントの相対位置 (%) の値を 100 にすると、ブレーク ポイントは、ダイアグラム エッジ上に挿入されません。各ダイアグラム エッジは、その From ジャンクションおよび To ジャンクションに直接接続します。
  • ブレーク ポイントの相対位置 (%) の値を 0 ~ 100 の範囲内の N にすると、ブレーク ポイントは、[XY] セグメントの長さの N % に配置されます。水平ツリーの場合、X はエッジの From ジャンクションの X 座標、Y はエッジの To ジャンクションの Y 座標です。 垂直ツリーの場合、[YX] セグメントの長さの N % に配置されます。Y はエッジの From ジャンクションの Y 座標、X はエッジの To ジャンクションの X 座標です。

[エッジ表示タイプ][曲線エッジ] (edge_display_type = "CURVED_EDGES" では Python) に設定されている場合、曲線エッジのジオメトリを計算するために、ダイアグラム エッジに沿って挿入される 2 つの変曲点の相対位置。 パーセントを 15 ~ 40 の範囲で表します。 ブレーク ポイントの相対位置 (%) の値が 15 ~ 40 の範囲内の N の場合:

  • 水平ツリーの場合、X はエッジの From ジャンクションの X 座標、Y はエッジの To ジャンクションの Y 座標です。
    • 最初の変曲点は、[XY] セグメントの長さの N % に配置されます。
    • 2 番目の変曲点は、[XY] セグメントの長さの (100 - N) % に配置されます。
  • 垂直ツリーの場合、Y はエッジの From ジャンクションの Y 座標、X はエッジの To ジャンクションの X 座標です。
    • 最初の変曲点は、[YX] セグメントの長さの N % に配置されます。
    • 2 番目の変曲点は、[XY] セグメントの長さの (100 - N) % に配置されます。

注意:

上記の From ジャンクションと To ジャンクションの概念は、ツリー方向を基準にしています。ネットワークのエッジ フィーチャやエッジ オブジェクトの実際のトポロジとは関係ありません。

Double
エッジ表示タイプ
(オプション)

ツリーの分岐に関連する、ダイアグラム エッジの表示タイプを指定します。

  • 標準エッジツリーの分岐に関連する、どのダイアグラム エッジも直角で表示されません。 これがデフォルトです。
  • 直交エッジツリーの分岐に関連する、すべてのダイアグラム エッジが直角で表示されます。
  • 曲線エッジツリーの分岐に関連する、すべてのダイアグラム エッジが曲線になります。
String
絶対オフセット
(オプション)

絶対単位を使用し、[エッジ表示タイプ][直交エッジ] に設定されている場合、重なっているセグメントを分離するために使用するオフセット。 値は、その他の間隔パラメーターに指定した最小値の 10 パーセント以下でなければなりません。 デフォルトは 0 です。

Linear Unit
比例オフセット
(オプション)

比例単位を使用し、[エッジ表示タイプ][直交エッジ] の場合、重なっているセグメントを分離するために使用するオフセット。 これは、倍精度小数値で、その他の間隔パラメーターに指定した最小値の 10 パーセント以下でなければなりません。 デフォルトは 0 です。

Double

派生した出力

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

更新されたユーティリティ ネットワークまたはトレース ネットワーク

ユーティリティ ネットワーク、トレース ネットワーク
出力ダイアグラム テンプレート

ダイアグラム テンプレートの名前。

String

arcpy.nd.AddMainRingLayout(in_utility_network, template_name, is_active, {are_containers_preserved}, {ring_type}, {is_unit_absolute}, {ring_width_absolute}, {ring_width_proportional}, {ring_height_absolute}, {ring_height_proportional}, {tree_type}, {perpendicular_absolute}, {perpendicular_proportional}, {along_absolute}, {along_proportional}, {breakpoint_position}, {edge_display_type}, {offset_absolute}, {offset_proportional})
名前説明データ タイプ
in_utility_network

変更するダイアグラム テンプレートを含むユーティリティ ネットワークまたはトレース ネットワーク。

Utility Network; Trace Network
template_name

変更するダイアグラム テンプレートの名前。

String
is_active

指定したテンプレートに基づくダイアグラムの生成中に、レイアウト アルゴリズムを自動的に実行するかどうかを指定します。

  • ACTIVEtemplate_name パラメーター値に基づくダイアグラムの生成中に、追加されたレイアウト アルゴリズムが自動的に実行されます。 これがデフォルトです。レイアウト アルゴリズムに指定されたパラメーター値は、ダイアグラム生成中に、レイアウトの実行に使用されます。 また、このパラメーター値は、入力テンプレートに基づくダイアグラムでアルゴリズムを実行する際に、デフォルトで読み込まれます。
  • INACTIVE追加されたレイアウト アルゴリズムに現在指定されているパラメーター値はすべて、入力テンプレートに基づくダイアグラムでアルゴリズムを実行する際に、デフォルトで読み込まれます。
Boolean
are_containers_preserved
(オプション)

アルゴリズムが格納器を処理する方法を指定します。

  • PRESERVE_CONTAINERS格納器が保持されるよう、ダイアグラムの上位グラフにレイアウト アルゴリズムを適用します。
  • IGNORE_CONTAINERSダイアグラム内の格納物フィーチャと非格納物フィーチャの両方に、レイアウト アルゴリズムを適用します。 これがデフォルトです。
Boolean
ring_type
(オプション)

リングのタイプを指定します。

  • ELLIPSE検出されたメイン リングのダイアグラム フィーチャが楕円に沿って表示されます。これがデフォルトです。
  • RECTANGLE検出されたメイン リングのダイアグラム フィーチャが矩形に沿って表示されます。
String
is_unit_absolute
(オプション)

距離を表すパラメーターの解釈方法を指定します。

  • ABSOLUTE_UNITレイアウト アルゴリズムは、距離値を距離単位として解釈します。
  • PROPORTIONAL_UNITレイアウト アルゴリズムは、現在のダイアグラムの範囲内にあるジャンクションの平均サイズを 1 とする相対単位で解釈します。 これがデフォルトです。
Boolean
ring_width_absolute
(オプション)

リング幅。デフォルトは、ダイアグラムの座標系の単位です。このパラメーターは、絶対単位を使用する場合にのみ利用可能です。

Linear Unit
ring_width_proportional
(オプション)

リング幅。デフォルトは 50 です。このパラメーターは、比例単位を使用する場合にのみ利用可能です。

Double
ring_height_absolute
(オプション)

リングの高さ。デフォルトは、ダイアグラムの座標系の単位です。このパラメーターは、絶対単位を使用する場合にのみ利用可能です。

Linear Unit
ring_height_proportional
(オプション)

リングの高さ。デフォルトは 20 です。このパラメーターは、比例単位を使用する場合にのみ利用可能です。

Double
tree_type
(オプション)

メイン リングのジャンクションから描画されるツリーの配置方法を指定します。

  • BOTH_SIDES各ツリーは主軸に沿って表示され、関連する分岐は主軸の左右両側に配置されます。
  • LEFT_SIDE各ツリーは主軸に沿って階層的に表示され、関連する分岐は主軸の左側に配置されます。
  • RIGHT_SIDE各ツリーは主軸に沿って階層的に表示され、関連する分岐は主軸の右側に配置されます。
  • SMART_TREE各ツリーは、スマート ツリーとして階層的に表示されます。これがデフォルトです。
String
perpendicular_absolute
(オプション)

ツリーの方向に対して垂直に表示され、同じサブツリー レベルに属しているダイアグラム ジャンクションの間隔。デフォルトは、ダイアグラムの座標系の単位で 2 です。このパラメーターは、絶対単位を使用する場合にのみ利用可能です。

Linear Unit
perpendicular_proportional
(オプション)

ツリーの方向に対して垂直に表示され、同じサブツリー レベルに属しているダイアグラム ジャンクションの間隔。デフォルトは 2 です。このパラメーターは、比例単位を使用する場合にのみ利用可能です。

Double
along_absolute
(オプション)

ツリーの方向に沿って表示されるダイアグラム ジャンクションの間隔。デフォルトは、ダイアグラムの座標系の単位で 2 です。このパラメーターは、絶対単位を使用する場合にのみ利用可能です。

Linear Unit
along_proportional
(オプション)

ツリーの方向に沿って表示されるダイアグラム ジャンクションの間隔。デフォルトは 2 です。このパラメーターは、比例単位を使用する場合にのみ利用可能です。

Double
breakpoint_position
(オプション)

[エッジ表示タイプ][標準エッジ] (edge_display_type = "REGULAR_EDGES" では Python) または [エッジ表示タイプ][直交エッジ] (edge_display_type = "ORTHOGONAL_EDGES" では Python) に設定されている場合、ダイアグラム エッジに沿って挿入されるブレーク ポイントの相対位置。 パーセントを 0 ~ 100 の範囲で表します。

  • ブレーク ポイントの相対位置 (%) の値を 0 にすると、水平ツリーの場合、ブレーク ポイントは、エッジの From ジャンクションの X 座標およびエッジの To ジャンクションの Y 座標に配置されます。 垂直ツリーの場合、エッジの From ジャンクションの Y 座標およびエッジの To ジャンクションの X 座標に配置されます。
  • ブレーク ポイントの相対位置 (%) の値を 100 にすると、ブレーク ポイントは、ダイアグラム エッジ上に挿入されません。各ダイアグラム エッジは、その From ジャンクションおよび To ジャンクションに直接接続します。
  • ブレーク ポイントの相対位置 (%) の値を 0 ~ 100 の範囲内の N にすると、ブレーク ポイントは、[XY] セグメントの長さの N % に配置されます。水平ツリーの場合、X はエッジの From ジャンクションの X 座標、Y はエッジの To ジャンクションの Y 座標です。 垂直ツリーの場合、[YX] セグメントの長さの N % に配置されます。Y はエッジの From ジャンクションの Y 座標、X はエッジの To ジャンクションの X 座標です。

[エッジ表示タイプ][曲線エッジ] (edge_display_type = "CURVED_EDGES" では Python) に設定されている場合、曲線エッジのジオメトリを計算するために、ダイアグラム エッジに沿って挿入される 2 つの変曲点の相対位置。 パーセントを 15 ~ 40 の範囲で表します。 ブレーク ポイントの相対位置 (%) の値が 15 ~ 40 の範囲内の N の場合:

  • 水平ツリーの場合、X はエッジの From ジャンクションの X 座標、Y はエッジの To ジャンクションの Y 座標です。
    • 最初の変曲点は、[XY] セグメントの長さの N % に配置されます。
    • 2 番目の変曲点は、[XY] セグメントの長さの (100 - N) % に配置されます。
  • 垂直ツリーの場合、Y はエッジの From ジャンクションの Y 座標、X はエッジの To ジャンクションの X 座標です。
    • 最初の変曲点は、[YX] セグメントの長さの N % に配置されます。
    • 2 番目の変曲点は、[XY] セグメントの長さの (100 - N) % に配置されます。

注意:

上記の From ジャンクションと To ジャンクションの概念は、ツリー方向を基準にしています。ネットワークのエッジ フィーチャやエッジ オブジェクトの実際のトポロジとは関係ありません。

Double
edge_display_type
(オプション)

ツリーの分岐に関連する、ダイアグラム エッジの表示タイプを指定します。

  • REGULAR_EDGESツリーの分岐に関連する、どのダイアグラム エッジも直角で表示されません。 これがデフォルトです。
  • ORTHOGONAL_EDGESツリーの分岐に関連する、すべてのダイアグラム エッジが直角で表示されます。
  • CURVED_EDGESツリーの分岐に関連する、すべてのダイアグラム エッジが曲線になります。
String
offset_absolute
(オプション)

is_unit_absolute = "ABSOLUTE_UNIT" および edge_display_type = "ORTHOGONAL_EDGES" の場合、重なっているセグメントを分離するために使用するオフセット。 値は、その他の間隔パラメーターに指定した最小値の 10 パーセント以下でなければなりません。 デフォルトは 0 です。

Linear Unit
offset_proportional
(オプション)

is_unit_absolute = "PROPORTIONAL_UNIT" および edge_display_type = "ORTHOGONAL_EDGES" の場合、重なっているセグメントを分離するために使用するオフセット。 これは、倍精度小数値で、その他の間隔パラメーターに指定した最小値の 10 パーセント以下でなければなりません。 デフォルトは 0 です。

Double

派生した出力

名前説明データ タイプ
out_utility_network

更新されたユーティリティ ネットワークまたはトレース ネットワーク

ユーティリティ ネットワーク、トレース ネットワーク
out_template_name

ダイアグラム テンプレートの名前。

String

コードのサンプル

AddMainRingLayout (メイン リング レイアウトの追加) の例 (Python ウィンドウ)

入力ネットワークに関連する MyTemplate1 テンプレートに、メイン リング レイアウト アルゴリズムを自動レイアウトとして追加します。

import arcpy
input_Network = "D:/MyProjectLocation/MyDatabaseConnection.sde/MyDatabase.MAP.Electric/MyDatabase.MAP.Electric"
input_DiagramTemplate = "MyTemplate1"
arcpy.AddMainRingLayout_nd(input_Network, "MyTemplate1", "ACTIVE", 
                           "PRESERVE_CONTAINERS", "ELLIPSE", 
                           "PROPORTIONAL_UNIT", "", 50, "", 20, "SMART_TREE", 
                           "", 2, "", 2, 30, "CURVED_EDGES")

環境

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

ライセンス情報

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

関連トピック