主軸ツリー レイアウトの追加 (Add Mainline Tree Layout) (ネットワーク ダイアグラム)

サマリー

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

このレイアウト アルゴリズムは、入力ネットワーク ダイアグラム内のジャンクションとエッジを主軸に沿って階層的に整理し、その関連ブランチを主軸の左側、右側、または両側に配置します。

主軸ツリー レイアウト アルゴリズムの詳細

注意:

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

注意:

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

使用法

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

  • [入力ネットワーク] パラメーター値は、データベース ユーティリティ ネットワークの所有者またはデータベース トレース ネットワーク所有者として、確立されたデータベース コネクションから取得する必要があります。
  • 接続された ArcGIS Enterprise ポータル アカウントは、ポータル ユーティリティ ネットワークの所有者またはポータル トレース ネットワーク所有者である必要があります。
  • このツールは、パブリックで保護されていないと想定される、デフォルトのバージョンに接続されている必要があります。

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

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

パラメーター

ダイアログ

ラベル	説明	データ タイプ
入力ネットワーク	変更するダイアグラム テンプレートを含むユーティリティ ネットワークまたはトレース ネットワーク。	Utility Network; Trace Network
入力ダイアグラム テンプレート	変更するダイアグラム テンプレートの名前。	String
アクティブ	指定したテンプレートに基づくダイアグラムの生成中に、レイアウト アルゴリズムを自動的に実行するかどうかを指定します。 オン - [入力ダイアグラム テンプレート] パラメーター値に基づくダイアグラムの生成中に、追加されたレイアウト アルゴリズムが自動的に実行されます。 これがデフォルトです。 レイアウト アルゴリズムに指定されたパラメーター値は、ダイアグラム生成中に、レイアウトの実行に使用されます。 また、このパラメーター値は、入力テンプレートに基づくダイアグラムでアルゴリズムを実行する際に、デフォルトで読み込まれます。 オフ - 追加されたレイアウト アルゴリズムに現在指定されているパラメーター値はすべて、入力テンプレートに基づくダイアグラムでアルゴリズムを実行する際に、デフォルトで読み込まれます。	Boolean
格納器レイアウトを維持 (オプション)	アルゴリズムが格納器を処理する方法を指定します。 オン - 格納器が保持されるよう、ダイアグラムの上位グラフに、レイアウト アルゴリズムを適用します。 オフ - ダイアグラム内の格納物フィーチャと非格納物フィーチャの両方に、レイアウト アルゴリズムを適用します。 これがデフォルトです。	Boolean
ツリー方向 (オプション)	主軸の方向を指定します。 左から右へ—主軸は、左から開始して右で終了する横線として描画されます。これがデフォルトです。 右から左へ—主軸は、右から開始して左で終了する横線として描画されます。 下から上へ—主軸は、下から開始して上で終了する縦線として描画されます。 上から下へ—主軸は、上から開始して下で終了する縦線として描画されます。	String
ブランチ配置 (オプション)	その方向を基準として、主軸からの分岐を配置する方法を指定します。 両側—分岐は主軸の左側と右側の両方に配置されます。これがデフォルトです。 左側—分岐は主軸の左側にのみ配置されます。 右側—分岐は主軸の右側にのみ配置されます。	String
ダイアグラム座標系の間隔値に絶対単位を使用 (オプション)	距離を表すパラメーターの解釈方法を指定します。 オン - レイアウト アルゴリズムは、距離値を距離単位で解釈します。 オフ - レイアウト アルゴリズムは、現在のダイアグラムの範囲内にあるジャンクションの平均サイズを 1 とする相対単位で、距離値を解釈します。 これがデフォルトです。	Boolean
方向に垂直なジャンクション間隔 (オプション)	主軸に垂直な軸に沿って表示されるダイアグラム ジャンクションの間隔。デフォルトは、ダイアグラムの座標系で 2 です。このパラメーターは、絶対単位を使用する場合にのみ利用可能です。	Linear Unit
方向に垂直なジャンクション間隔 (オプション)	主軸に垂直な軸に沿って表示されるダイアグラム ジャンクションの間隔。デフォルトは 2 です。このパラメーターは、比例単位を使用する場合にのみ利用可能です。	Double
方向に沿ったジャンクション間隔 (オプション)	主軸に沿って表示されるダイアグラム ジャンクションの間隔、および主軸に平行な軸に沿って表示されるダイアグラム ジャンクションの間隔。このパラメーターは、絶対単位を使用する場合にのみ利用可能です。デフォルトは、ダイアグラムの座標系の単位で 2 です。	Linear Unit
方向に沿ったジャンクション間隔 (オプション)	主軸に沿って表示されるダイアグラム ジャンクションの間隔、および主軸に平行な軸に沿って表示されるダイアグラム ジャンクションの間隔。このパラメーターは、比例単位で使用されます。デフォルトは 2 です。	Double
分離されたグラフ間 (オプション)	ダイアグラムに分離されたグラフが含まれている場合に、そのグラフに属しているフィーチャを切り離す最小間隔。 このパラメーターは、絶対単位で使用されます。 デフォルトは、ダイアグラムの座標系の単位で 4 です。	Linear Unit
分離されたグラフ間 (オプション)	ダイアグラムに分離されたグラフが含まれている場合に、そのグラフに属しているフィーチャを切り離す最小間隔。 このパラメーターは、比例単位と共に使用されます。 デフォルトは 4 です。	Double
エッジの直交表示 (オプション)		Boolean
ブレーク ポイントの相対位置 (%) (オプション)	[エッジ表示タイプ] が [標準エッジ] (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

Python

arcpy.nd.AddMainlineTreeLayout(in_utility_network, template_name, is_active, {are_containers_preserved}, {tree_direction}, {branches_placement}, {is_unit_absolute}, {perpendicular_absolute}, {perpendicular_proportional}, {along_absolute}, {along_proportional}, {disjoined_graph_absolute}, {disjoined_graph_proportional}, {are_edges_orthogonal}, {breakpoint_position}, {edge_display_type}, {offset_absolute}, {offset_proportional})

名前	説明	データ タイプ
in_utility_network	変更するダイアグラム テンプレートを含むユーティリティ ネットワークまたはトレース ネットワーク。	Utility Network; Trace Network
template_name	変更するダイアグラム テンプレートの名前。	String
is_active	指定したテンプレートに基づくダイアグラムの生成中に、レイアウト アルゴリズムを自動的に実行するかどうかを指定します。 ACTIVE—template_name パラメーター値に基づくダイアグラムの生成中に、追加されたレイアウト アルゴリズムが自動的に実行されます。 これがデフォルトです。レイアウト アルゴリズムに指定されたパラメーター値は、ダイアグラム生成中に、レイアウトの実行に使用されます。 また、このパラメーター値は、入力テンプレートに基づくダイアグラムでアルゴリズムを実行する際に、デフォルトで読み込まれます。 INACTIVE—追加されたレイアウト アルゴリズムに現在指定されているパラメーター値はすべて、入力テンプレートに基づくダイアグラムでアルゴリズムを実行する際に、デフォルトで読み込まれます。	Boolean
are_containers_preserved (オプション)	アルゴリズムが格納器を処理する方法を指定します。 PRESERVE_CONTAINERS—格納器が保持されるよう、ダイアグラムの上位グラフにレイアウト アルゴリズムを適用します。 IGNORE_CONTAINERS—ダイアグラム内の格納物フィーチャと非格納物フィーチャの両方に、レイアウト アルゴリズムを適用します。 これがデフォルトです。	Boolean
tree_direction (オプション)	主軸の方向を指定します。 FROM_LEFT_TO_RIGHT—主軸は、左から開始して右で終了する横線として描画されます。これがデフォルトです。 FROM_RIGHT_TO_LEFT—主軸は、右から開始して左で終了する横線として描画されます。 FROM_BOTTOM_TO_TOP—主軸は、下から開始して上で終了する縦線として描画されます。 FROM_TOP_TO_BOTTOM—主軸は、上から開始して下で終了する縦線として描画されます。	String
branches_placement (オプション)	その方向を基準として、主軸からの分岐を配置する方法を指定します。 BOTH_SIDES—分岐は主軸の左側と右側の両方に配置されます。これがデフォルトです。 LEFT_SIDE—分岐は主軸の左側にのみ配置されます。 RIGHT_SIDE—分岐は主軸の右側にのみ配置されます。	String
is_unit_absolute (オプション)	距離を表すパラメーターの解釈方法を指定します。 ABSOLUTE_UNIT—レイアウト アルゴリズムは、距離値を距離単位として解釈します。 PROPORTIONAL_UNIT—レイアウト アルゴリズムは、現在のダイアグラムの範囲内にあるジャンクションの平均サイズを 1 とする相対単位で解釈します。 これがデフォルトです。	Boolean
perpendicular_absolute (オプション)	主軸に垂直な軸に沿って表示されるダイアグラム ジャンクションの間隔。デフォルトは、ダイアグラムの座標系で 2 です。このパラメーターは、絶対単位を使用する場合にのみ利用可能です。	Linear Unit
perpendicular_proportional (オプション)	主軸に垂直な軸に沿って表示されるダイアグラム ジャンクションの間隔。デフォルトは 2 です。このパラメーターは、比例単位を使用する場合にのみ利用可能です。	Double
along_absolute (オプション)	主軸に沿って表示されるダイアグラム ジャンクションの間隔、および主軸に平行な軸に沿って表示されるダイアグラム ジャンクションの間隔。このパラメーターは、絶対単位を使用する場合にのみ利用可能です。デフォルトは、ダイアグラムの座標系の単位で 2 です。	Linear Unit
along_proportional (オプション)	主軸に沿って表示されるダイアグラム ジャンクションの間隔、および主軸に平行な軸に沿って表示されるダイアグラム ジャンクションの間隔。このパラメーターは、比例単位で使用されます。デフォルトは 2 です。	Double
disjoined_graph_absolute (オプション)	ダイアグラムに分離されたグラフが含まれている場合に、そのグラフに属しているフィーチャを切り離す最小間隔。 このパラメーターは、絶対単位で使用されます。 デフォルトは、ダイアグラムの座標系の単位で 4 です。	Linear Unit
disjoined_graph_proportional (オプション)	ダイアグラムに分離されたグラフが含まれている場合に、そのグラフに属しているフィーチャを切り離す最小間隔。 このパラメーターは、比例単位と共に使用されます。 デフォルトは 4 です。	Double
are_edges_orthogonal (オプション)	ツリーの分岐に関連するダイアグラム エッジを表示する方法を指定します。 レガシー: このパラメーターは、ArcGIS Pro 3.3 で廃止されました。 edge_display_type パラメーターが指定されていても、その値に関係なく、システムとして無視されます。 ただし、ArcGIS Pro 2.1 との互換性を維持するために、edge_display_type パラメーターが指定されていない場合には、このパラメーターをまだ使用できます。 ORTHOGONAL_EDGES—ツリーの分岐に関連する、すべてのダイアグラム エッジが直角で表示されます。 SLANTED_EDGES—ツリーの分岐に関連する、どのダイアグラム エッジも直角で表示されません。 これがデフォルトです。	Boolean
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

コードのサンプル

AddMainLineTreeLayout (主軸ツリーレイアウトの追加) の例 (Python ウィンドウ)

この例では、指定したネットワーク用の既存の MyTemplate1 テンプレートに、主軸ツリー レイアウト アルゴリズムを自動レイアウトとして追加します。

import arcpy
input_Network = "D:/MyProjectLocation/MyDatabaseConnection.sde/MyDatabase.MAP.Electric/MyDatabase.MAP.Electric"
input_DiagramTemplate = "MyTemplate1"
arcpy.AddMainlineTreeLayout_nd(input_Network, input_DiagramTemplate, 
                               "ACTIVE", "PRESERVE_CONTAINERS", 
                               "FROM_LEFT_TO_RIGHT", "BOTH_SIDES", 
                               "ABSOLUTE_UNIT", "100 Feet", "", "100 Feet", "", 
                               "200 Feet", "", "", 30, "ORTHOGONAL_EDGES", 
                               "10 Feet")

環境

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

ライセンス情報

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