ダイアグラム エッジ形状変更レイアウト (Reshape Diagram Edges Layout) (ネットワーク ダイアグラム ツール)
サマリー
エッジ沿いの頂点にシンプルな操作を行います。
ダイアグラム エッジ形状変更レイアウト アルゴリズムの詳細
注意:
編集セッションを開いている場合、このツールを実行する前に、編集内容を保存する必要があります。 これにより、ダイアグラムは、データベース内のネットワーク トポロジーに行われた最新の変更内容を反映するようになります。 編集内容を保存できなかった場合、編集内容は、ダイアグラムに反映されません。
ライセンス:
エンタープライズ デプロイメントでこのツールを使用するには、アクティブなポータル アカウントは、ArcGIS Advanced Editing ユーザー タイプ エクステンションのライセンスが付与される必要があります。
注意:
各レイアウト アルゴリズムには、デフォルトのパラメーター値が含まれます。 指定されていない限り、デフォルトのパラメーター値が使用されます。 入力ネットワーク ダイアグラムが別のパラメーター値で構成された、このレイアウトのテンプレートに基づいていない場合は、代わりにその値が使用されます。
使用法
このツールは、エンタープライズ ジオデータベース内のユーティリティー ネットワークまたはトレース ネットワークへのデータベース コネクションを使用している場合には使用できません。 関連する公開されたユーティリティー ネットワーク サービス、トレース ネットワーク サービス、ファイルまたはモバイル ジオデータベースのユーティリティー ネットワーク、あるいはトレース ネットワークを使用してください。
入力ネットワーク ダイアグラム レイヤーは、ファイルまたはモバイル ジオデータベース内のユーティリティー ネットワークまたはトレース ネットワーク、あるいはネットワーク ダイアグラム サービスから取得する必要があります。
このレイアウト アルゴリズムは、ネットワーク ダイアグラムのエッジに沿った頂点で、簡単な操作を処理するために使用されます。 次の操作ができます。
ダイアグラム エッジに沿って、すべての頂点を削除します。
ダイアグラム エッジに沿って、一部の頂点を削減します。
エッジ上に頂点を追加して、ダイアグラム エッジを直角化します。
オーバーラップしているダイアグラム エッジを分離します。
直角に交差しているダイアグラム エッジを検出し、交差位置に円弧が表示されるように、エッジのジオメトリーを形状変更します。
非常に大きなダイアグラムの操作時は、サーバー上で非同期モードのレイアウトを適用することを検討してください。
パラメーター
|
ラベル
|
説明
|
データ タイプ
|
|
入力ネットワーク ダイアグラム レイヤー
|
レイアウトを適用するネットワーク ダイアグラム。
|
Diagram Layer
|
|
格納器レイアウトを維持
(オプション)
|
アルゴリズムが格納器を処理する方法を指定します。
オン—格納器のレイアウトが保持されるように、ダイアグラムの上位グラフにダイアグラム エッジ形状変更レイアウト (Reshape Diagram Edges Layout) アルゴリズムを適用します。
オフ—ダイアグラム内の格納物フィーチャと非格納物フィーチャの両方に、ダイアグラム エッジ形状変更レイアウト (Reshape Diagram Edges Layout) アルゴリズムを適用します。 これがデフォルトです。
|
Boolean
|
|
形状変更操作
|
エッジの形状を変更する方法を指定します。
頂点の削除—ダイアグラム内のエッジに沿った頂点が削除されます。
四角形エッジ—頂点がダイアグラム エッジに沿って配置され、エッジが直角に表示されます。 これがデフォルトです。
オーバーラップエッジの切り離し—同じ原点および端点ジャンクションを接続するエッジがオーバーラップしている場合、それらのエッジを切り離します。
角度で頂点削減—頂点があるセグメントがなす角度に従って、ダイアグラム エッジ沿いに表示される一部またはすべての頂点を減らします。
交差エッジのマーク—ダイアグラム内で直角に交差している水平および垂直ダイアグラム エッジにマークを付け、この位置に円弧が表示されるように交差する一方のエッジのジオメトリーを形状変更します。
|
String
|
|
パスを維持
(オプション)
|
直角になるエッジ沿いの頂点を維持するかどうかを指定します。 このパラメーターは、形状変更操作 パラメーターが 正方形エッジ に設定されている場合にのみ有効になります。
|
Boolean
|
|
エッジ間のオフセット
(オプション)
|
同じジャンクションがある四角形エッジの平行セグメントを離す間隔。 デフォルトは、ダイアグラムの座標系の単位で 5 です。 このパラメーターは、形状変更操作 パラメーターが 正方形エッジ に設定されている場合にのみ有効になります。
|
Linear Unit
|
|
ブレーク ポイント位置
(オプション)
|
エッジが四角形のとき、ジャンクションがあるエッジに沿った最初または最後のブレーク ポイントに対する各ジャンクション間の最大距離。 デフォルトは、ダイアグラムの座標系の単位で 8.66 です。 このパラメーターは、形状変更操作 パラメーターが 正方形エッジ に設定されている場合にのみ有効になります。
|
Linear Unit
|
|
エッジ間のオフセット
(オプション)
|
2 つのエッジを切り離す絶対間隔。 デフォルトは、ダイアグラムの座標系の単位で 0.5 です。 このパラメーターは、形状変更操作 パラメーターが 重複エッジの切り離し に設定されている場合にのみ有効になります。
|
Linear Unit
|
|
角度の閾値
(オプション)
|
頂点を削除するときの条件となる、頂点があるセグメントで形成される角度。 角度が大きくなるに従い、削除される頂点の数は少なくなります。 デフォルト値は 160 度です。 このパラメーターは、形状変更操作 パラメーターが 角度で頂点削減 に設定されている場合にのみ有効になります。
|
Double
|
|
円弧の半径
(オプション)
|
交差するエッジの位置に追加される円弧の半径。 デフォルトは 5 です。
|
Linear Unit
|
|
円弧の位置
(オプション)
|
円弧が配置されるセグメントを指定します。
垂直セグメントの左—円弧は、垂直セグメントの左側に配置されます。
垂直セグメントの右—円弧は、垂直セグメントの右側に配置されます。
水平セグメントの上—円弧は、水平セグメントの上側に配置されます。
水平セグメントの下—円弧は、水平セグメントの下側に配置されます。
|
String
|
|
サーバーでの非同期モードでの実行
(オプション)
|
レイアウト アルゴリズムが、サーバー上で非同期または同期で実行されるかどうかを指定します。
オン—サーバー上でレイアウト アルゴリズムを非同期で実行します。 このオプションは、長いタイムアウト時間でレイアウト アルゴリズムを実行するサーバー リソース向けです。 非同期での実行は、長時間を要し、サーバーのタイムアウトを超える可能性があるレイアウト (例: 部分オーバーラップ エッジ) や、大規模なダイアグラム (フィーチャの数が 25,000 を上回る) を適用する場合におすすめします。
オフ—サーバー上でレイアウト アルゴリズムを同期で実行します。 実行時間がサービスのデフォルトのタイムアウト値である 600 秒を超えた場合、完了せずに失敗します。 これがデフォルトです。
|
Boolean
|
派生した出力
|
ラベル
|
説明
|
データ タイプ
|
|
出力ネットワーク ダイアグラム
|
更新されたネットワーク ダイアグラム レイヤー。
|
Diagram Layer
|
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—格納器のレイアウトが保持されるように、ダイアグラムの上位グラフにダイアグラム エッジ形状変更レイアウト (Reshape Diagram Edges Layout) アルゴリズムを適用します。
IGNORE_CONTAINERS—ダイアグラム内の格納物フィーチャと非格納物フィーチャの両方に、ダイアグラム エッジ形状変更レイアウト (Reshape Diagram Edges Layout) アルゴリズムを適用します。 これがデフォルトです。
|
Boolean
|
|
reshape_type
|
エッジの形状を変更する方法を指定します。
REMOVE_VERTICES—ダイアグラム内のエッジに沿った頂点が削除されます。
SQUARE_EDGES—頂点がダイアグラム エッジに沿って配置され、エッジが直角に表示されます。 これがデフォルトです。
SEPARATE_OVERLAPPING_EDGES—同じ原点および端点ジャンクションを接続するエッジがオーバーラップしている場合、それらのエッジを切り離します。
REDUCE_VERTICES_BY_ANGLE—頂点があるセグメントがなす角度に従って、ダイアグラム エッジ沿いに表示される一部またはすべての頂点を減らします。
MARK_CROSSING_EDGES—ダイアグラム内で直角に交差している水平および垂直ダイアグラム エッジにマークを付け、この位置に円弧が表示されるように交差する一方のエッジのジオメトリーを形状変更します。
|
String
|
|
is_path_preserved
(オプション)
|
直角になるエッジ沿いの頂点を維持するかどうかを指定します。 このパラメーターは、reshape_type パラメーターが SQUARE_EDGES の場合に使用され、それ以外の場合には無視されます。
|
Boolean
|
|
offset_between_segment_absolute
(オプション)
|
同じジャンクションがある四角形エッジの平行セグメントを離す間隔。 デフォルトは、ダイアグラムの座標系の単位で 5 です。 このパラメーターは、reshape_type パラメーターが SQUARE_EDGES の場合に使用され、それ以外の場合には無視されます。
|
Linear Unit
|
|
breakpoint_absolute
(オプション)
|
エッジが四角形のとき、ジャンクションがあるエッジに沿った最初または最後のブレーク ポイントに対する各ジャンクション間の最大距離。 デフォルトは、ダイアグラムの座標系の単位で 8.66 です。 このパラメーターは、reshape_type パラメーターが SQUARE_EDGES の場合に使用され、それ以外の場合には無視されます。
|
Linear Unit
|
|
shift_between_edge_absolute
(オプション)
|
2 つのエッジを切り離す絶対間隔。 デフォルトは、ダイアグラムの座標系の単位で 0.5 です。 このパラメーターは、reshape_type パラメーターが SEPARATE_OVERLAPPING_EDGES の場合に使用され、それ以外の場合には無視されます。
|
Linear Unit
|
|
angle_threshold
(オプション)
|
頂点を削除するときの条件となる、頂点があるセグメントで形成される角度。 角度が大きくなるに従い、削除される頂点の数は少なくなります。 デフォルト値は 160 度です。 このパラメーターは、reshape_type パラメーターが REDUCE_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
|
更新されたネットワーク ダイアグラム レイヤー。
|
Diagram Layer
|
コードのサンプル
ReshapeDiagramEdgesLayout の例 (Python ウィンドウ)
このサンプル スクリプトでは、テンポラリー ダイアグラムという名前のネットワーク ダイアグラム レイヤー上で ReshapeDiagramEdgesLayout 関数を実行して、角度で頂点を削減します。
import arcpy
arcpy.nd.ReshapeDiagramEdgesLayout("Temporary Diagram", "PRESERVE_CONTAINERS",
"REDUCE_VERTICES_BY_ANGLE", angle_threshold=160)
環境
このツールは、ジオプロセシング環境を一切使用しません。
ライセンス情報
- Basic: いいえ
- Standard: はい
- Advanced: はい