概要
エネルギー方向レイアウト アルゴリズムをレイアウトのリストに追加して、指定したテンプレートに基づいて、ダイアグラム構築の終了時に自動的に連結されるようにします。このツールでは、そのテンプレートに基づいてダイアグラムのエネルギー方向レイアウト アルゴリズム パラメーターも事前に設定します。
このレイアウト アルゴリズムは、物理的相似法を用いてエネルギーを局所的に最小化する力学系を識別して、グラフを描画します。力学系の平衡状態 (各ダイアグラム ジャンクション上で合力がゼロになる場所) が検索されます。
注意:
このツールは構成および管理ツールです。
メモ:
このツールは、入力ダイアグラム テンプレートに基づく既存のダイアグラムの一貫性に影響を与えます。更新されるまで、既存のダイアグラムはすべて一貫性なしになり、一貫性警告アイコン 
が表示されます。
使用法
このツールは、ユーティリティ ネットワーク サービスを使用する場合、サポートされません。ファイル ジオデータベース内のユーティリティ ネットワークまたはトレース ネットワークを使用するか、エンタープライズ ジオデータベース内のユーティリティ ネットワークへのデータベース接続を使用する必要があります。エンタープライズ ジオデータベースを使用している場合は、接続をデータベース ユーティリティ ネットワーク所有者として確立する必要があります。
エンタープライズ ジオデータベースのユーティリティ ネットワークにこの操作を行う場合、接続する ArcGIS Enterprise ポータル アカウントはポータル ユーティリティ ネットワークの所有者である必要があります。
入力ネットワーク パラメーターに指定するネットワーク データ エレメントは、ファイル ジオデータベース内のユーティリティ ネットワークまたはトレース ネットワーク、あるいはエンタープライズ ジオデータベース内のユーティリティ ネットワークへのデータベース接続から取得する必要があります。
ダイアグラム テンプレートに基づいてダイアグラムのレイアウト アルゴリズム パラメーターを事前に設定するには、[有効] パラメーターをオフにします (Python では is_active = "INACTIVE")。
また、入力ダイアグラム テンプレートに基づくダイアグラムの生成の終了時に自動的に連結されるレイアウトのリストにレイアウト アルゴリズムを追加する場合は、[有効] をオン (デフォルト) にして (Python では is_active = "ACTIVE")、このツールを実行します。
構文
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 | 指定したテンプレートに基づくダイアグラムの生成中にレイアウト アルゴリズムを自動的に実行するかどうかを指定します。
| Boolean |
are_containers_preserved (オプション) | アルゴリズムが格納器を処理する方法を指定します。
| Boolean |
iterations_number (オプション) | 処理を反復する回数。デフォルトは 20 です。 | Long |
repel_factor (オプション) | 近接しているダイアグラム ジャンクション間の距離を追加します。反発係数が大きいほど、ほぼ重なるダイアグラム ジャンクションの間隔が広がります。デフォルトは 1 です。 | Double |
degree_freedom (オプション) | アルゴリズムの各反復中にダイアグラム ジャンクションが移動する範囲を指定します。
| String |
breakpoint_position (オプション) | [エッジ表示タイプ] が [曲線エッジ] (Python では edges_display_type = "CURVED_EDGES") に設定されている場合、曲線エッジのジオメトリを計算するために、ダイアグラム エッジに沿って挿入される 2 つの変曲点の相対位置。15 ～ 40 の範囲のパーセントで、デフォルトは 30 です。たとえば、[ブレーク ポイントの相対位置 (%)] パラメーター値 N が 15 ～ 40 の場合、次のことが当てはまります。
メモ:上記の From ジャンクションと To ジャンクションの概念はツリー方向を基準にしています。ネットワーク フィーチャまたはオブジェクトのエッジの実際のトポロジとは関係ありません。 [エッジ表示タイプ] パラメーターが [標準エッジ] (Python では edges_display_type = "REGULAR_EDGES") に設定されている場合、このパラメーターは無視されます。 | Double |
edge_display_type (オプション) | ダイアグラム エッジの表示タイプを指定します。
| String |
派生した出力
| 名前 | 説明 | データ タイプ |
| out_utility_network | 更新されたユーティリティ ネットワークまたはトレース ネットワーク。 | ユーティリティ ネットワーク、トレース ネットワーク |
| out_template_name | ダイアグラム テンプレートの名前。 | String |
コードのサンプル
入力ネットワークに関連した 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: いいえ
- Standard: はい
- Advanced: はい