エネルギー方向レイアウトの追加 (Add Force Directed Layout) (ネットワークダイアグラム)—ArcGIS Pro

サマリー

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

このレイアウトアルゴリズムは、物理的相似法を用いてエネルギーを局所的に最小化する力学系を識別して、グラフを描画します。力学系の平衡状態 (各ダイアグラムジャンクション上で合力がゼロになる場所) が検索されます。

エネルギー方向レイアウトアルゴリズムの詳細

注意:

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

注意:

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

使用法

このツールは、ユーティリティネットワークサービスまたはトレースネットワークサービスを使用する場合、サポートされません。ファイルまたはモバイルジオデータベース内のユーティリティネットワークまたはトレースネットワークを使用するか、エンタープライズジオデータベース内のユーティリティネットワークまたはトレースネットワークへのデータベースコネクションを使用する必要があります。エンタープライズジオデータベースを操作する場合、次の要件があります。
- [入力ネットワーク] パラメーター値は、データベースユーティリティネットワークの所有者またはデータベーストレースネットワーク所有者として、確立されたデータベースコネクションから取得する必要があります。
- 接続された ArcGIS Enterprise ポータルアカウントは、ポータルユーティリティネットワークの所有者またはポータルトレースネットワーク所有者である必要があります。
- このツールは、パブリックで保護されていないと想定される、デフォルトのバージョンに接続されている必要があります。
ダイアグラムテンプレートに基づいてダイアグラムのレイアウトアルゴリズムパラメーターを事前に設定するには、[有効] パラメーターをオフにします (Python では is_active = "INACTIVE")。
また、入力ダイアグラムテンプレートに基づくダイアグラムの生成の終了時に自動的に連結されるレイアウトのリストにレイアウトアルゴリズムを追加する場合は、[有効] をオンにして (Python では is_active = "ACTIVE")、このツールを実行します。

パラメーター

ラベル	説明	データタイプ
入力ネットワーク	変更するダイアグラムテンプレートを含むユーティリティネットワークまたはトレースネットワーク。	Utility Network; Trace Network
入力ダイアグラムテンプレート	変更するダイアグラムテンプレートの名前。	String
アクティブ	指定したテンプレートに基づくダイアグラムの生成中にレイアウトアルゴリズムを自動的に実行するかどうかを指定します。オン - [入力ダイアグラムテンプレート] パラメーター値に基づくダイアグラムの生成中に、追加されたレイアウトアルゴリズムが自動的に実行されます。これがデフォルトです。レイアウトアルゴリズムに指定されたパラメーター値は、ダイアグラム生成中にレイアウトの実行に使用されます。また、このパラメーター値は、入力テンプレートに基づくダイアグラムでアルゴリズムを実行する際にデフォルトで読み込まれます。オフ - 追加されたレイアウトアルゴリズムに現在指定されているパラメーター値はすべて、入力テンプレートに基づくダイアグラムでアルゴリズムを実行する際にデフォルトで読み込まれます。	Boolean
格納器レイアウトを維持 (オプション)	アルゴリズムが格納器を処理する方法を指定します。オン - 格納器が保持されるように、ダイアグラムの上位グラフでレイアウトアルゴリズムを実行します。オフ - ダイアグラム内の格納物フィーチャと非格納物フィーチャの両方でレイアウトアルゴリズムを実行します。これがデフォルトです。	Boolean
処理の反復回数 (オプション)	処理を反復する回数。デフォルトは 20 です。	Long
反発係数 (オプション)	近接しているダイアグラムジャンクション間の距離を追加します。反発係数が大きいほど、ほぼ重なるダイアグラムジャンクションの間隔が広がります。デフォルトは 1 です。	Double
自由度 (オプション)	アルゴリズムの各反復中にダイアグラムジャンクションが移動する範囲を指定します。低—ダイアグラムジャンクションが移動する範囲が制限されます。これがデフォルトです。高—ダイアグラムジャンクションが移動する範囲が広くなります。中—ダイアグラムジャンクションが移動する範囲が中程度になります。	String
ブレークポイントの相対位置 (%) (オプション)	[エッジ表示タイプ] が [曲線エッジ] (Python では edges_display_type = "CURVED_EDGES") に設定されている場合、曲線エッジのジオメトリを計算するために、ダイアグラムエッジに沿って挿入される 2 つの変曲点の相対位置。15 ～ 40 の範囲のパーセントで、デフォルトは 30 です。たとえば、[ブレークポイントの相対位置 (%)] パラメーター値 N が 15 ～ 40 の場合、次のことが当てはまります。水平ツリーの場合、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 ジャンクションの概念はツリー方向を基準にしています。ネットワークフィーチャまたはオブジェクトのエッジの実際のトポロジとは関係ありません。 [エッジ表示タイプ] パラメーターが [標準エッジ] (Python では edges_display_type = "REGULAR_EDGES") に設定されている場合、このパラメーターは無視されます。	Double
エッジ表示タイプ (オプション)	ダイアグラムエッジの表示タイプを指定します。標準エッジ—すべてのダイアグラムエッジが直線として表示されます。これがデフォルトです。曲線エッジ—すべてのダイアグラムエッジが曲線になります。	String

派生した出力

ラベル	説明	データタイプ
出力ネットワーク	更新されたユーティリティネットワークまたはトレースネットワーク。	ユーティリティネットワーク、トレースネットワーク
出力ダイアグラムテンプレート	ダイアグラムテンプレートの名前。	String

arcpy.nd.AddForceDirectedLayout(in_utility_network, template_name, is_active, {are_containers_preserved}, {iterations_number}, {repel_factor}, {degree_freedom}, {breakpoint_position}, {edge_display_type})

名前	説明	データタイプ
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
iterations_number (オプション)	処理を反復する回数。デフォルトは 20 です。	Long
repel_factor (オプション)	近接しているダイアグラムジャンクション間の距離を追加します。反発係数が大きいほど、ほぼ重なるダイアグラムジャンクションの間隔が広がります。デフォルトは 1 です。	Double
degree_freedom (オプション)	アルゴリズムの各反復中にダイアグラムジャンクションが移動する範囲を指定します。 LOW—ダイアグラムジャンクションが移動する範囲が制限されます。これがデフォルトです。 HIGH—ダイアグラムジャンクションが移動する範囲が広くなります。 MEDIUM—ダイアグラムジャンクションが移動する範囲が中程度になります。	String
breakpoint_position (オプション)	[エッジ表示タイプ] が [曲線エッジ] (Python では edges_display_type = "CURVED_EDGES") に設定されている場合、曲線エッジのジオメトリを計算するために、ダイアグラムエッジに沿って挿入される 2 つの変曲点の相対位置。15 ～ 40 の範囲のパーセントで、デフォルトは 30 です。たとえば、[ブレークポイントの相対位置 (%)] パラメーター値 N が 15 ～ 40 の場合、次のことが当てはまります。水平ツリーの場合、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 ジャンクションの概念はツリー方向を基準にしています。ネットワークフィーチャまたはオブジェクトのエッジの実際のトポロジとは関係ありません。 [エッジ表示タイプ] パラメーターが [標準エッジ] (Python では edges_display_type = "REGULAR_EDGES") に設定されている場合、このパラメーターは無視されます。	Double
edge_display_type (オプション)	ダイアグラムエッジの表示タイプを指定します。 REGULAR_EDGES—すべてのダイアグラムエッジが直線として表示されます。これがデフォルトです。 CURVED_EDGES—すべてのダイアグラムエッジが曲線になります。	String

派生した出力

名前	説明	データタイプ
out_utility_network	更新されたユーティリティネットワークまたはトレースネットワーク。	ユーティリティネットワーク、トレースネットワーク
out_template_name	ダイアグラムテンプレートの名前。	String

コードのサンプル

AddForceDirectedLayout (エネルギー方向レイアウトの追加) の例 (Python ウィンドウ)

入力ネットワークに関連した MyTemplate1 テンプレートにエネルギー方向レイアウトアルゴリズムを自動レイアウトとして追加します。

import arcpy
input_Network = "D:/MyProjectLocation/MyDatabaseConnection.sde/MyDatabase.MAP.Electric/MyDatabase.MAP.Electric"
input_DiagramTemplate = "MyTemplate1"
arcpy.AddForceDirectedLayout_nd(input_Network, "MyTemplate1", "ACTIVE", 
                                "PRESERVE_CONTAINERS", 20, 1, "LOW", "25", 
                                "CURVED_EDGES")

環境

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

ライセンス情報

Basic: No
Standard: Yes
Advanced: Yes

サマリー

注意:

注意:

使用法

パラメーター

注意:

派生した出力

注意:

派生した出力

コードのサンプル

環境

ライセンス情報

関連トピック

このトピックの内容