放射状ツリー レイアウトの適用 (Apply Radial Tree Layout) (ネットワーク ダイアグラム)

概要

ダイアグラム フィーチャを階層化して放射状ツリーに配置します。

放射状ツリー レイアウト アルゴリズムの詳細

注意:

編集セッションを開いている場合、このツールを実行する前に編集内容を保存する必要があります。これにより、ダイアグラムはデータベース内のネットワーク トポロジに行われた最新の変更内容を反映するようになります。編集内容を保存できなかった場合、編集内容はダイアグラムに反映されません。

メモ:

各レイアウト アルゴリズムにはデフォルトのパラメーター値が含まれます。指定されていない限り、デフォルトのパラメーター値が使用されます。入力ネットワーク ダイアグラムが別のパラメーター値で構成されたこのレイアウトのテンプレートに基づいていない場合は、代わりにその値が使用されます。

使用法

  • このツールは、エンタープライズ ジオデータベース内のユーティリティ ネットワークまたはトレース ネットワークへのデータベース接続を使用している場合には使用できません。関連する公開されたユーティリティ ネットワーク サービス、トレース ネットワーク サービス、またはファイル ジオデータベースのユーティリティ ネットワークあるいはトレース ネットワークを使用してください。

  • 入力ネットワーク ダイアグラム レイヤーは、ファイル ジオデータベース内のユーティリティ ネットワークまたはトレース ネットワーク、あるいはネットワーク ダイアグラム サービスから取得する必要があります。

  • このレイアウト アルゴリズムは、ダイアグラム フィーチャを階層的に整理し、指定された半径パラメーターに従って放射状ツリーに配置します。このアルゴリズムは、ジャンクションから処理を開始し、そのノードを始点として、各階層レベルを表す同心円上にサブツリーを配置します。

  • ルート ジャンクションが指定されていない場合、アルゴリズムは、最小のネットワーク トポロジ インデックスが関連付けられたダイアグラム ジャンクションを識別し、このジャンクションをルート ジャンクションとして使用します。

    ダイアグラム ジャンクションがルート ジャンクションとして指定されている場合は、このルート ジャンクションが同心円の中心として使用されます。

    複数のルート ジャンクションがダイアグラム内に指定されている場合、このルート ジャンクションは、仮想中心がある 1 つ目の同心円の周囲に配置されます。

  • 非常に大きなダイアグラムの操作時は、サーバー上で非同期モードのレイアウトを適用することを検討してください。

構文

arcpy.nd.ApplyRadialTreeLayout(in_network_diagram_layer, {are_containers_preserved}, {is_unit_absolute}, {initial_radius_absolute}, {initial_radius_proportional}, {disjoined_graph_absolute}, {disjoined_graph_proportional}, {radius_factor}, {run_async})
パラメーター説明データ タイプ
in_network_diagram_layer

レイアウトを適用するネットワーク ダイアグラム。

Diagram Layer
are_containers_preserved
(オプション)

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

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

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

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

中心が放射状ツリー ルート ジャンクションである 1 つ目の同心円の半径。つまり、1 つ目の階層レベルに属するダイアグラム ジャンクションが周囲に配置される円の半径。デフォルトは、ダイアグラムの座標系の単位で 5 です。このパラメーターは、絶対単位を使用する場合にのみ利用可能です。

Linear Unit
initial_radius_proportional
(オプション)

中心が放射状ツリー ルート ジャンクションである 1 つ目の同心円の半径。つまり、1 つ目の階層レベルに属するダイアグラム ジャンクションが周囲に配置される円の半径。デフォルトは 5 です。このパラメーターは、比例単位を使用する場合にのみ利用可能です。

Double
disjoined_graph_absolute
(オプション)

ダイアグラムに分離されたグラフが含まれている場合に、そのグラフに属しているフィーチャを切り離す最小間隔。このパラメーターは、絶対単位で使用されます。デフォルトは、ダイアグラムの座標系の単位で 4 です。

Linear Unit
disjoined_graph_proportional
(オプション)

ダイアグラムに分離されたグラフが含まれている場合に、そのグラフに属しているフィーチャを切り離す最小間隔。このパラメーターは、比例単位で使用されます。デフォルトは 4 です。

Double
radius_factor
(オプション)

各同心円の半径の大きさを制御する乗算係数。これは、各階層レベルを表す同心円の間隔でもあります。[半径ファクター] の値が 1 未満の場合、階層が深くなるにつれて、ある階層レベルに属するダイアグラム ジャンクションと次の階層レベルに属するスケマティック ノードの間隔が狭くなります。[半径ファクター] の値が 1 より大きい場合、階層が深くなるにつれて、階層レベルの間隔が広くなります。デフォルトは 1 です。

Double
run_async
(オプション)

レイアウト アルゴリズムがサーバー上で非同期または同期で実行されるかどうかを指定します。

  • RUN_ASYNCHRONOUSLYサーバー上でレイアウト アルゴリズムを非同期で実行します。このオプションは、長いタイムアウト時間でレイアウト アルゴリズムを実行するサーバー リソース向けです。非同期での実行は、長時間を要し、サーバーのタイムアウトを超える可能性があるレイアウト (例: 部分オーバーラップ エッジ) を実行する場合や大規模なダイアグラム (例: フィーチャの数が 25,000 を上回る) を適用する場合にお勧めします。
  • RUN_SYNCHRONOUSLYサーバー上でレイアウト アルゴリズムを同期で実行します。実行時間がサービスのタイムアウト (デフォルトで 600 秒) を超えた場合、完了せずに失敗します。これがデフォルトです。
Boolean

派生した出力

名前説明データ タイプ
out_network_diagram_layer

更新されたネットワーク ダイアグラム レイヤー。

ダイアグラム レイヤー

コードのサンプル

ApplyRadialTreeLayout (放射状ツリー レイアウトの適用) の例 (Python ウィンドウ)

このサンプル スクリプトでは、[一時的なダイアグラム] という名前のダイアグラムに放射状ツリー レイアウト アルゴリズムが適用されます。

import arcpy
arcpy.ApplyRadialTreeLayout_nd("Temporary diagram", "PRESERVE_CONTAINERS", 
                               "ABSOLUTE_UNIT", 5, "", 15, "", 1, 
                               "RUN_SYNCHRONOUSLY")

環境

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

ライセンス情報

  • Basic: いいえ
  • Standard: はい
  • Advanced: はい

関連トピック