トップへ戻る

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

このトピックの内容

  1. サマリー
  2. 使用法
  3. パラメーター
  4. 環境
  5. ライセンス情報

サマリー

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

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

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

注意:

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

注意:

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

使用法

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

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

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

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

パラメーター

ダイアログPython

ラベル説明データ タイプ
入力ネットワーク

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

Utility Network; Trace Network
入力ダイアグラム テンプレート

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

String
アクティブ

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

  • オン - [入力ダイアグラム テンプレート] パラメーター値に基づくダイアグラムの生成中に、追加されたレイアウト アルゴリズムが自動的に実行されます。 これがデフォルトです。

    レイアウト アルゴリズムに指定されたパラメーター値は、ダイアグラム生成中に、レイアウトの実行に使用されます。 また、このパラメーター値は、入力テンプレートに基づくダイアグラムでアルゴリズムを実行する際に、デフォルトで読み込まれます。

  • オフ - 追加されたレイアウト アルゴリズムに現在指定されているパラメーター値はすべて、入力テンプレートに基づくダイアグラムでアルゴリズムを実行する際に、デフォルトで読み込まれます。

Boolean
格納器レイアウトを維持
(オプション)

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

  • オン - 格納器が保持されるよう、ダイアグラムの上位グラフに、圧縮レイアウト アルゴリズムを適用します。 これがデフォルトです。
  • オフ - ダイアグラム内の格納物フィーチャと非格納物フィーチャの両方に、圧縮レイアウト アルゴリズムを適用します。

Boolean
グループ化の最大距離
(オプション)

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

Linear Unit
頂点削除ルール
(オプション)

ダイアグラムから削除されるエッジの頂点を指定します。

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

派生した出力

ラベル説明データ タイプ
出力ネットワーク

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

Utility Network; Trace Network
出力ダイアグラム テンプレート

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

String

arcpy.nd.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

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

  • ACTIVE—template_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

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

Utility Network; Trace 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.nd.AddCompressionLayout(input_Network, input_DiagramTemplate, "ACTIVE", 
                              "PRESERVE_CONTAINERS", "20 Feet", "OUTER")

環境

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

ライセンス情報

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

関連トピック

  • 構成ツールセットの概要
  • ジオプロセシング ツールの検索
  • 圧縮レイアウトに関するリファレンス
  • ダイアグラムのルールおよびレイアウト定義の概要
  • 圧縮レイアウトの適用 (Apply Compression Layout)

このトピックへのフィードバック

このトピックの内容
  1. サマリー
  2. 使用法
  3. パラメーター
  4. 環境
  5. ライセンス情報