トップへ戻る

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

このトピックの内容

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

サマリー

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

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

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

注意:

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

注意:

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

使用法

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

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

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

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

パラメーター

ダイアログPython

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

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

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

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

String
有効

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

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

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

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

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

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

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

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

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

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

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

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

派生した出力

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

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

ユーティリティ ネットワーク、トレース ネットワーク
出力ダイアグラム テンプレート

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

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

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

ユーティリティ ネットワーク、トレース ネットワーク
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: No
  • Standard: Yes
  • Advanced: Yes

関連トピック

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

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

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