圧縮レイアウトの追加 (Add Compression Layout) (ネットワーク ダイアグラム)

概要

圧縮レイアウト アルゴリズムを入力ダイアグラム テンプレートのレイアウト リストに追加して、ダイアグラム構築の最後にこのアルゴリズムが自動的に実行されるようにします。このツールでは、そのテンプレートに基づいてダイアグラムの圧縮レイアウト アルゴリズム パラメーターも事前に設定します。

このレイアウト アルゴリズムは、相対位置を維持しながら、ダイアグラムの中央に向かってダイアグラム フィーチャを圧縮します。このアルゴリズムは、ジャンクションのグループを構築できる距離から処理を開始し、それらのグループは、アルゴリズムの実行中に、スーパー ノードとして移動されます。

圧縮レイアウト アルゴリズムの詳細

注意:

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

メモ:

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

使用法

  • このツールは、ユーティリティ ネットワーク サービスを使用する場合、サポートされません。ファイル ジオデータベース内のユーティリティ ネットワークまたはトレース ネットワークを使用するか、エンタープライズ ジオデータベース内のユーティリティ ネットワークへのデータベース接続を使用する必要があります。エンタープライズ ジオデータベースを使用している場合は、接続をデータベース ユーティリティ ネットワーク所有者として確立する必要があります。

  • エンタープライズ ジオデータベースのユーティリティ ネットワークにこの操作を行う場合、接続する ArcGIS Enterprise ポータル アカウントはポータル ユーティリティ ネットワークの所有者である必要があります。

  • 入力ネットワーク パラメーターに指定するネットワーク データ エレメントは、ファイル ジオデータベース内のユーティリティ ネットワークまたはトレース ネットワーク、あるいはエンタープライズ ジオデータベース内のユーティリティ ネットワークへのデータベース接続から取得する必要があります。

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

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

構文

AddCompressionLayout(in_utility_network, template_name, is_active, {are_containers_preserved}, {grouping_distance_absolute}, {vertices_removal_rule})
パラメーター説明データ タイプ
in_utility_network

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

Utility Network; Trace Network
template_name

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

String
is_active

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

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

圧縮レイアウト アルゴリズムが格納器を処理する方法を指定します。

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

グループ距離は、2 つの接続ジャンクションが同じジャンクション グループに属していると見なされるほど十分に近接しているどうかを判定するために使用されます。ジャンクション グループは、実行時にグループとして移動される複数のジャンクションを表します。グループは、ジャンクションと格納器の両方を含むことができます。2 つのジャンクションをグループ化するには、そのジャンクションがエッジによりダイアグラム内で接続されている必要があります。デフォルトは、ダイアグラムの座標系で 20 単位です。

Linear Unit
vertices_removal_rule
(オプション)

ダイアグラム内のエッジに沿ったどの頂点が削除されるかを指定します。

  • ALLすべてのエッジ上の頂点はすべてダイアグラムから削除されます。
  • OUTER検出されたジャンクションのグループ内にあるエッジの頂点は維持され、外側にあるエッジの頂点は削除されます。ダイアグラム内の格納器に格納器ポリゴンと交差するエッジがあるとき、エッジと格納器ポリゴンの交点に頂点が追加されます。これがデフォルトです。
  • OUTER_EXCEPT_FIRST検出されたジャンクションのグループ内にあるエッジの頂点は維持され、外側にあるエッジの頂点は削除されます。ダイアグラム内の格納器に格納器ポリゴンと交差するエッジがあるとき、最初 (または最後) の外部頂点は、格納器ポリゴンと交差するエッジ上に保持されます。頂点は、エッジと格納器ポリゴンの交点に自動的に挿入されます。
String

派生した出力

名前説明データ タイプ
out_utility_network

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

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

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

String

コードのサンプル

AddCompressionLayout (圧縮レイアウトの追加) の例 (Python ウィンドウ)

指定したネットワーク用の既存の MyTemplate1 テンプレートに圧縮レイアウト アルゴリズムを自動レイアウトとして追加します。

import arcpy
input_Network = "D:/MyProjectLocation/MyDatabaseConnection.sde/MyDatabase.MAP.Electric/MyDatabase.MAP.Electric"
input_DiagramTemplate = "MyTemplate1"
arcpy.AddCompressionLayout_nd(input_Network, input_DiagramTemplate, "ACTIVE", 
                              "PRESERVE_CONTAINERS", "20 Feet", "OUTER")

環境

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

ライセンス情報

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

関連トピック