概要
主軸に沿ってダイアグラム ジャンクションとエッジを階層化して配置します。
注意:
編集セッションを開いている場合、このツールを実行する前に編集内容を保存する必要があります。これにより、ダイアグラムはデータベース内のネットワーク トポロジに行われた最新の変更内容を反映するようになります。編集内容を保存できなかった場合、編集内容はダイアグラムに反映されません。
メモ:
各レイアウト アルゴリズムにはデフォルトのパラメーター値が含まれます。指定されていない限り、デフォルトのパラメーター値が使用されます。入力ネットワーク ダイアグラムが別のパラメーター値で構成されたこのレイアウトのテンプレートに基づいていない場合は、代わりにその値が使用されます。
使用法
このツールは、エンタープライズ ジオデータベース内のユーティリティ ネットワークまたはトレース ネットワークへのデータベース接続を使用している場合には使用できません。関連する公開されたユーティリティ ネットワーク サービス、トレース ネットワーク サービス、またはファイル ジオデータベースのユーティリティ ネットワークあるいはトレース ネットワークを使用してください。
入力ネットワーク ダイアグラム レイヤーは、ファイル ジオデータベース内のユーティリティ ネットワークまたはトレース ネットワーク、あるいはネットワーク ダイアグラム サービスから取得する必要があります。
このレイアウト アルゴリズムは、入力ネットワーク ダイアグラム内のジャンクションとエッジを主軸に沿って階層的に整理し、その関連ブランチを主軸の左側、右側、または両側に配置します。
ルート ジャンクションと端点ジャンクションをダイアグラム内に指定することで、主軸ツリー レイアウト アルゴリズムは、指定したルート ジャンクションから指定した端点ジャンクションまでの主軸を構築できます。
- デフォルトでは、ルート ジャンクションと端点ジャンクションがどちらも指定されていない場合、アルゴリズムは、最小のネットワーク トポロジ インデックスが関連付けられたダイアグラム ジャンクションを識別します。ルートを表すこのジャンクションから、アルゴリズムは、最も多くのエッジからなるライン、つまり主軸を検索します。
- ルート ジャンクションが設定されている場合は、そのルート ジャンクションから始まる、最も多くのエッジから成る分岐が主軸になります。
- ルート ジャンクションと端点ジャンクションの両方が指定されていて、それらのジャンクション間にパスがある場合は、ルート ジャンクションから始まって端点ジャンクションで終わる、最も多くのエッジから成る分岐が主軸になります。
接続していない複数のダイアグラム パートがネットワーク ダイアグラムにある場合、(たとえば、ダイアグラムの各パートに 1 つずつ) 複数の始点ジャンクションと終点ジャンクションを定義できます。
接続されている同じダイアグラム パートに属する複数のジャンクションをルートとして指定することもできます。このようなジャンクションは、ツリーの方向に対して垂直に同じ軸上に配置され、ダイアグラムのツリー分岐の別の始点として表示されます。端点ジャンクションの場合、接続されている同じダイアグラム パート上に複数の終点を指定することもできますが、そのいずれかのみが端点ジャンクションとして識別されます。
端点ジャンクションのみが指定され、ルート ジャンクションが指定されていない場合、端点ジャンクションは無視されます。
非常に大きなダイアグラムの操作時は、サーバー上で非同期モードのレイアウトを適用することを検討してください。
構文
arcpy.nd.ApplyMainlineTreeLayout(in_network_diagram_layer, {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}, {run_async}, {offset_absolute}, {offset_proportional})| パラメーター | 説明 | データ タイプ |
in_network_diagram_layer | レイアウトを適用するネットワーク ダイアグラム。 | Diagram Layer |
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 |
run_async (オプション) | レイアウト アルゴリズムがサーバー上で非同期または同期で実行されるかどうかを指定します。
| Boolean |
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_network_diagram_layer | 更新されたネットワーク ダイアグラム レイヤー。 | ダイアグラム レイヤー |
コードのサンプル
[一時的なダイアグラム] という名前のダイアグラムに主軸ツリー レイアウト アルゴリズムを適用します。
import arcpy
arcpy.ApplyMainlineTreeLayout_nd("Temporary Diagram", "PRESERVE_CONTAINERS",
"FROM_LEFT_TO_RIGHT", "BOTH_SIDES",
"ABSOLUTE_UNIT", "100 Feet", "" , "100 Feet",
"", "200 Feet", "", "", 30, "ORTHOGONAL_EDGES",
"RUN_SYNCHRONOUSLY", "10 Feet", "")環境
ライセンス情報
- Basic: いいえ
- Standard: はい
- Advanced: はい