概要
メイン リング レイアウト アルゴリズムをレイアウトのリストに追加して、指定したテンプレートに基づいて、ダイアグラム構築の終了時に自動的に連結されるようにします。さらに、このツールは、そのテンプレートに基づいてダイアグラムのメイン リング レイアウト アルゴリズム パラメーターを事前設定します。
このレイアウト アルゴリズムは、メイン リングの周囲にダイアグラム フィーチャを配置し、メイン リングに沿って配置された各ダイアグラム ジャンクションに接続するダイアグラム フィーチャのサブセットを階層的にレイアウトします。
注意:
このツールは構成および管理ツールです。
メモ:
このツールは、入力ダイアグラム テンプレートに基づく既存のダイアグラムの一貫性に影響を与えます。更新されるまで、既存のダイアグラムはすべて一貫性なしになり、一貫性警告アイコン 
が表示されます。
使用法
このツールは、ユーティリティ ネットワーク サービスまたはトレース ネットワーク サービスを使用する場合、サポートされません。ファイル ジオデータベース内のユーティリティ ネットワークまたはトレース ネットワークを使用するか、エンタープライズ ジオデータベース内のユーティリティ ネットワークまたはトレース ネットワークへのデータベース接続を使用する必要があります。エンタープライズ ジオデータベースを操作する場合、次の要件があります。
- [入力ネットワーク] パラメーター値は、データベース ユーティリティ ネットワークの所有者またはデータベース トレース ネットワーク所有者として、確立されたデータベース接続から取得する必要があります。
- 接続された ArcGIS Enterprise ポータル アカウントは、ポータル ユーティリティ ネットワークの所有者またはポータル トレース ネットワーク所有者である必要があります。
- このツールは、パブリックで保護されていないと想定される、デフォルトのバージョンに接続されている必要があります。
ダイアグラム テンプレートに基づいてダイアグラムのレイアウト アルゴリズム パラメーターを事前に設定するには、[有効] パラメーターをオフにします (Python では is_active = "INACTIVE")。
また、入力ダイアグラム テンプレートに基づくダイアグラムの生成の終了時に自動的に連結されるレイアウトのリストにレイアウト アルゴリズムを追加する場合は、[有効] をオン (デフォルト) にして (Python では is_active = "ACTIVE")、このツールを実行します。
構文
arcpy.nd.AddMainRingLayout(in_utility_network, template_name, is_active, {are_containers_preserved}, {ring_type}, {is_unit_absolute}, {ring_width_absolute}, {ring_width_proportional}, {ring_height_absolute}, {ring_height_proportional}, {tree_type}, {perpendicular_absolute}, {perpendicular_proportional}, {along_absolute}, {along_proportional}, {breakpoint_position}, {edge_display_type}, {offset_absolute}, {offset_proportional})| パラメーター | 説明 | データ タイプ |
in_utility_network | 変更するダイアグラム テンプレートを含むユーティリティ ネットワークまたはトレース ネットワーク。 | Utility Network; Trace Network |
template_name | 変更するダイアグラム テンプレートの名前。 | String |
is_active | 指定したテンプレートに基づくダイアグラムの生成中にレイアウト アルゴリズムを自動的に実行するかどうかを指定します。
| Boolean |
are_containers_preserved (オプション) | アルゴリズムが格納器を処理する方法を指定します。
| Boolean |
ring_type (オプション) | リングのタイプを指定します。
| String |
is_unit_absolute (オプション) | 距離を表すパラメーターの解釈方法を指定します。
| Boolean |
ring_width_absolute (オプション) | リング幅。デフォルトは、ダイアグラムの座標系の単位です。このパラメーターは、絶対単位を使用する場合にのみ利用可能です。 | Linear Unit |
ring_width_proportional (オプション) | リング幅。デフォルトは 50 です。このパラメーターは、比例単位を使用する場合にのみ利用可能です。 | Double |
ring_height_absolute (オプション) | リングの高さ。デフォルトは、ダイアグラムの座標系の単位です。このパラメーターは、絶対単位を使用する場合にのみ利用可能です。 | Linear Unit |
ring_height_proportional (オプション) | リングの高さ。デフォルトは 20 です。このパラメーターは、比例単位を使用する場合にのみ利用可能です。 | Double |
tree_type (オプション) | メイン リングのジャンクションから描画されるツリーの配置方法を指定します。
| String |
perpendicular_absolute (オプション) | ツリーの方向に対して垂直に表示され、同じサブツリー レベルに属しているダイアグラム ジャンクションの間隔。デフォルトは、ダイアグラムの座標系の単位で 2 です。このパラメーターは、絶対単位を使用する場合にのみ利用可能です。 | Linear Unit |
perpendicular_proportional (オプション) | ツリーの方向に対して垂直に表示され、同じサブツリー レベルに属しているダイアグラム ジャンクションの間隔。デフォルトは 2 です。このパラメーターは、比例単位を使用する場合にのみ利用可能です。 | Double |
along_absolute (オプション) | ツリーの方向に沿って表示されるダイアグラム ジャンクションの間隔。デフォルトは、ダイアグラムの座標系の単位で 2 です。このパラメーターは、絶対単位を使用する場合にのみ利用可能です。 | Linear Unit |
along_proportional (オプション) | ツリーの方向に沿って表示されるダイアグラム ジャンクションの間隔。デフォルトは 2 です。このパラメーターは、比例単位を使用する場合にのみ利用可能です。 | Double |
breakpoint_position (オプション) | [エッジ表示タイプ] が [標準エッジ] (Python では edge_display_type = "REGULAR_EDGES") または [エッジ表示タイプ] が [直交エッジ] (Python では edge_display_type = "ORTHOGONAL_EDGES") の場合、ダイアグラム エッジに沿って挿入されるブレーク ポイントの相対位置。パーセントを 0 ～ 100 の範囲で表します。
[エッジ表示タイプ] が [曲線エッジ] (Python では edge_display_type = "CURVED_EDGES") の場合、曲線エッジのジオメトリを計算するために、ダイアグラム エッジに沿って挿入される 2 つの変曲点の相対位置。パーセントを 15 ～ 40 の範囲で表します。ブレーク ポイントの相対位置 (%) の値が 15 ～ 40 の範囲内の N の場合:
メモ:上記の From ジャンクションと To ジャンクションの概念はツリー方向を基準にしています。ネットワークのエッジ フィーチャやエッジ オブジェクトの実際のトポロジとは関係ありません。 | Double |
edge_display_type (オプション) | ツリーの分岐に関連するダイアグラム エッジの表示タイプを指定します。
| String |
offset_absolute (オプション) | is_unit_absolute = "ABSOLUTE_UNIT" および edge_display_type = "ORTHOGONAL_EDGES" の場合、重なっているセグメントを分離するために使用するオフセット。値は、その他の間隔パラメーターに指定した最小値の 10 パーセント以下でなければなりません。デフォルトは 0 です。 | Linear Unit |
offset_proportional (オプション) | is_unit_absolute = "PROPORTIONAL_UNIT" および edge_display_type = "ORTHOGONAL_EDGES" の場合、重なっているセグメントを分離するために使用するオフセット。これは倍精度小数値で、その他の間隔パラメーターに指定した最小値の 10 パーセント以下でなければなりません。デフォルトは 0 です。 | Double |
派生した出力
| 名前 | 説明 | データ タイプ |
| 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.AddMainRingLayout_nd(input_Network, "MyTemplate1", "ACTIVE",
"PRESERVE_CONTAINERS", "ELLIPSE",
"PROPORTIONAL_UNIT", "", 50, "", 20, "SMART_TREE",
"", 2, "", 2, 30, "CURVED_EDGES")環境
ライセンス情報
- Basic: いいえ
- Standard: はい
- Advanced: はい