概要
主軸ツリー レイアウト アルゴリズムをレイアウトのリストに追加して、指定したテンプレートに基づいて、ダイアグラム構築の終了時に自動的に連結されるようにします。このツールでは、そのテンプレートに基づいてダイアグラムの主軸ツリー レイアウト アルゴリズム パラメーターも事前に設定します。
このレイアウト アルゴリズムは、入力ネットワーク ダイアグラム内のジャンクションとエッジを主軸に沿って階層的に整理し、その関連ブランチを主軸の左側、右側、または両側に配置します。
注意:
このツールは構成および管理ツールです。
メモ:
このツールは、入力ダイアグラム テンプレートに基づく既存のダイアグラムの一貫性に影響を与えます。更新されるまで、既存のダイアグラムはすべて一貫性なしになり、一貫性警告アイコン 
が表示されます。
使用法
このツールは、ユーティリティ ネットワーク サービスまたはトレース ネットワーク サービスを使用する場合、サポートされません。ファイル ジオデータベース内のユーティリティ ネットワークまたはトレース ネットワークを使用するか、エンタープライズ ジオデータベース内のユーティリティ ネットワークまたはトレース ネットワークへのデータベース接続を使用する必要があります。エンタープライズ ジオデータベースを操作する場合、次の要件があります。
- [入力ネットワーク] パラメーター値は、データベース ユーティリティ ネットワークの所有者またはデータベース トレース ネットワーク所有者として、確立されたデータベース接続から取得する必要があります。
- 接続された ArcGIS Enterprise ポータル アカウントは、ポータル ユーティリティ ネットワークの所有者またはポータル トレース ネットワーク所有者である必要があります。
- このツールは、パブリックで保護されていないと想定される、デフォルトのバージョンに接続されている必要があります。
ダイアグラム テンプレートに基づいてダイアグラムのレイアウト アルゴリズム パラメーターを事前に設定するには、[有効] パラメーターをオフにします (Python では is_active = "INACTIVE")。
また、入力ダイアグラム テンプレートに基づくダイアグラムの生成の終了時に自動的に連結されるレイアウトのリストにレイアウト アルゴリズムを追加する場合は、[有効] をオン (デフォルト) にして (Python では is_active = "ACTIVE")、このツールを実行します。
構文
arcpy.nd.AddMainlineTreeLayout(in_utility_network, template_name, is_active, {are_containers_preserved}, {tree_direction}, {branches_placement}, {is_unit_absolute}, {perpendicular_absolute}, {perpendicular_proportional}, {along_absolute}, {along_proportional}, {disjoined_graph_absolute}, {disjoined_graph_proportional}, {are_edges_orthogonal}, {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 |
tree_direction (オプション) | 主軸の方向を指定します。
| String |
branches_placement (オプション) | その方向を基準として、主軸からの分岐を配置する方法を指定します。
| String |
is_unit_absolute (オプション) | 距離を表すパラメーターの解釈方法を指定します。
| Boolean |
perpendicular_absolute (オプション) | 主軸に垂直な軸に沿って表示されるダイアグラム ジャンクションの間隔。デフォルトは、ダイアグラムの座標系で 2 です。このパラメーターは、絶対単位を使用する場合にのみ利用可能です。 | Linear Unit |
perpendicular_proportional (オプション) | 主軸に垂直な軸に沿って表示されるダイアグラム ジャンクションの間隔。デフォルトは 2 です。このパラメーターは、比例単位を使用する場合にのみ利用可能です。 | Double |
along_absolute (オプション) | 主軸に沿って表示されるダイアグラム ジャンクションの間隔、および主軸に平行な軸に沿って表示されるダイアグラム ジャンクションの間隔。このパラメーターは、絶対単位を使用する場合にのみ利用可能です。デフォルトは、ダイアグラムの座標系の単位で 2 です。 | Linear Unit |
along_proportional (オプション) | 主軸に沿って表示されるダイアグラム ジャンクションの間隔、および主軸に平行な軸に沿って表示されるダイアグラム ジャンクションの間隔。このパラメーターは、比例単位で使用されます。デフォルトは 2 です。 | Double |
disjoined_graph_absolute (オプション) | ダイアグラムに分離されたグラフが含まれている場合に、そのグラフに属しているフィーチャを切り離す最小間隔。このパラメーターは、絶対単位で使用されます。デフォルトは、ダイアグラムの座標系の単位で 4 です。 | Linear Unit |
disjoined_graph_proportional (オプション) | ダイアグラムに分離されたグラフが含まれている場合に、そのグラフに属しているフィーチャを切り離す最小間隔。このパラメーターは、比例単位で使用されます。デフォルトは 4 です。 | Double |
are_edges_orthogonal (オプション) | ツリーの分岐に関連するダイアグラム エッジを表示する方法を指定します。 レガシー:このパラメーターは ArcGIS Pro 2.7 で廃止されました。edge_display_type パラメーターが指定されていても、その値に関係なくシステムとして無視されます。ただし、ArcGIS Pro 2.1 との互換性を維持するために、edge_display_type パラメーターが指定されていない場合には、このパラメーターをまだ使用できます。
| Boolean |
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.AddMainlineTreeLayout_nd(input_Network, input_DiagramTemplate,
"ACTIVE", "PRESERVE_CONTAINERS",
"FROM_LEFT_TO_RIGHT", "BOTH_SIDES",
"ABSOLUTE_UNIT", "100 Feet", "", "100 Feet", "",
"200 Feet", "", "", 30, "ORTHOGONAL_EDGES",
"10 Feet")環境
ライセンス情報
- Basic: いいえ
- Standard: はい
- Advanced: はい