ダイアグラム エッジ形状変更レイアウト (Reshape Diagram Edges Layout) (ネットワーク ダイアグラム)

概要

エッジ沿いの頂点にシンプルな操作を行います。

ダイアグラム エッジ形状変更レイアウト アルゴリズムの詳細

注意:

編集セッションを開いている場合、このツールを実行する前に編集内容を保存する必要があります。これにより、ダイアグラムはデータベース内のネットワーク トポロジに行われた最新の変更内容を反映するようになります。編集内容を保存できなかった場合、編集内容はダイアグラムに反映されません。

メモ:

各レイアウト アルゴリズムにはデフォルトのパラメーター値が含まれます。指定されていない限り、デフォルトのパラメーター値が使用されます。入力ネットワーク ダイアグラムが別のパラメーター値で構成されたこのレイアウトのテンプレートに基づいていない場合は、代わりにその値が使用されます。

使用法

  • このツールは、エンタープライズ ジオデータベース内のユーティリティ ネットワークまたはトレース ネットワークへのデータベース接続を使用している場合には使用できません。関連する公開されたユーティリティ ネットワーク サービス、トレース ネットワーク サービス、またはファイル ジオデータベースのユーティリティ ネットワークあるいはトレース ネットワークを使用してください。

  • 入力ネットワーク ダイアグラム レイヤーは、ファイル ジオデータベース内のユーティリティ ネットワークまたはトレース ネットワーク、あるいはネットワーク ダイアグラム サービスから取得する必要があります。

  • このレイアウトは、ネットワーク ダイアグラムのエッジに沿った頂点で簡単な操作を処理するために使用されます。次の操作ができます。

    • ダイアグラム エッジに沿ってすべての頂点を削除します。
    • ダイアグラム エッジに沿って一部の頂点を削減します。
    • エッジ上に頂点を追加してダイアグラム エッジを直角化します。
    • オーバーラップしているダイアグラム エッジを分離します。
    • 直角に交差しているダイアグラム エッジを検出し、交差位置に円弧が表示されるようにエッジのジオメトリを形状変更します。

  • 非常に大きなダイアグラムの操作時は、サーバー上で非同期モードのレイアウトを適用することを検討してください。

構文

arcpy.nd.ReshapeDiagramEdgesLayout(in_network_diagram_layer, {are_containers_preserved}, reshape_type, {is_path_preserved}, {offset_between_segment_absolute}, {breakpoint_absolute}, {shift_between_edge_absolute}, {angle_threshold}, {circular_arc_radius}, {circular_arc_position}, {run_async})
パラメーター説明データ タイプ
in_network_diagram_layer

レイアウトを適用するネットワーク ダイアグラム。

Diagram Layer
are_containers_preserved
(オプション)

アルゴリズムが格納器を処理する方法を指定します。

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

エッジの形状を変更する方法を指定します。

  • REMOVE_VERTICESダイアグラム内のすべてのエッジに沿った頂点が削除されます。
  • SQUARE_EDGES頂点がダイアグラム エッジに沿って配置され、エッジが直角に表示されます。これがデフォルトです。
  • SEPARATE_OVERLAPPING_EDGES同じ原点および端点ジャンクションを接続するエッジが重なっている場合、それらのエッジを切り離します。
  • REDUCE_VERTICES_BY_ANGLE頂点があるセグメントがなす角度に従って、ダイアグラム エッジ沿いに表示される一部またはすべての頂点を減らします。
  • MARK_CROSSING_EDGESダイアグラム内で直角に交差している水平および垂直ダイアグラム エッジにマークを付け、この位置に円弧が表示されるように交差する一方のエッジのジオメトリを形状変更します。
String
is_path_preserved
(オプション)

直角になるエッジ沿いの頂点を維持するかどうかを指定します。このパラメーターを使用できるのは、reshape_typeSQUARE_EDGES の場合に限ります。

  • PRESERVE_PATHエッジの方向が考慮され、そのエッジ沿いの頂点が最初の頂点から最後の頂点まで維持されます。これがデフォルトです。
  • IGNORE_PATHダイアグラム エッジ沿いの頂点は考慮されません。これらの頂点は実行中に削除されます。
Boolean
offset_between_segment_absolute
(オプション)

同じジャンクションがある四角形エッジの平行セグメントを離す間隔。デフォルトは、ダイアグラムの座標系の単位で 5 です。このパラメーターを使用できるのは、reshape_typeSQUARE_EDGES の場合に限ります。

Linear Unit
breakpoint_absolute
(オプション)

エッジが四角形のとき、ジャンクションがあるエッジに沿った最初または最後のブレーク ポイントに対する各ジャンクション間の最大距離。デフォルトは、ダイアグラムの座標系の単位で 8.66 です。このパラメーターを使用できるのは、reshape_typeSQUARE_EDGES の場合に限ります。

Linear Unit
shift_between_edge_absolute
(オプション)

2 つのエッジを切り離す絶対間隔。デフォルトは、ダイアグラムの座標系の単位で 0.5 です。このパラメーターを使用できるのは、reshape_typeSEPARATE_OVERLAPPING_EDGES の場合に限ります。

Linear Unit
angle_threshold
(オプション)

頂点を削除するときの条件となる、頂点があるセグメントで形成される角度。角度が大きくなるにしたがい、削除される頂点の数は少なくなります。デフォルト値は 160 度です。このパラメーターを使用できるのは、reshape_typeREDUCE_VERTICES_BY_ANGLE の場合に限ります。

Double
circular_arc_radius
(オプション)

交差するエッジの位置に追加される円弧の半径。デフォルトは 5 です。

Linear Unit
circular_arc_position
(オプション)

円弧が配置されるセグメントを指定します。

  • LEFT_OF_VERTICAL_SEGMENT円弧は、垂直セグメントの左側に配置されます。
  • RIGHT_OF_VERTICAL_SEGMENT円弧は、垂直セグメントの右側に配置されます。
  • ABOVE_HORIZONTAL_SEGMENT円弧は、水平セグメントの上側に配置されます。
  • BELOW_HORIZONTAL_SEGMENT円弧は、水平セグメントの下側に配置されます。
String
run_async
(オプション)

レイアウト アルゴリズムがサーバー上で非同期または同期で実行されるかどうかを指定します。

  • RUN_ASYNCHRONOUSLYサーバー上でレイアウト アルゴリズムを非同期で実行します。このオプションは、長いタイムアウト時間でレイアウト アルゴリズムを実行するサーバー リソース向けです。非同期での実行は、長時間を要し、サーバーのタイムアウトを超える可能性があるレイアウト (例: 部分オーバーラップ エッジ) を実行する場合や大規模なダイアグラム (例: フィーチャの数が 25,000 を上回る) を適用する場合にお勧めします。
  • RUN_SYNCHRONOUSLYサーバー上でレイアウト アルゴリズムを同期で実行します。実行時間がサービスのタイムアウト (デフォルトで 600 秒) を超えた場合、完了せずに失敗します。これがデフォルトです。
Boolean

派生した出力

名前説明データ タイプ
out_network_diagram_layer

更新されたネットワーク ダイアグラム レイヤー。

ダイアグラム レイヤー

コードのサンプル

ReshapeDiagramEdgesLayout (ダイアグラム エッジ形状変更レイアウト) の例 (Python ウィンドウ)

このサンプル スクリプトでは、[一時的なダイアグラム] という名前のネットワーク ダイアグラム レイヤー上でダイアグラム エッジ形状変更レイアウト アルゴリズムを実行して、角度で頂点を削減します。

import arcpy
arcpy.ReshapeDiagramEdgesLayout_nd("Temporary Diagram", "PRESERVE_CONTAINERS", 
                                   "REDUCE_VERTICES_BY_ANGLE", angle_threshold=160)

環境

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

ライセンス情報

  • Basic: いいえ
  • Standard: はい
  • Advanced: はい

関連トピック