概要
ダイアグラム エッジ形状変更レイアウト アルゴリズムをレイアウトのリストに追加して、指定したテンプレートに基づいて、ダイアグラム構築の終了時に自動的に連結されるようにします。このツールでは、そのテンプレートに基づいてダイアグラムのダイアグラム エッジ形状変更レイアウト アルゴリズム パラメーターも事前に設定します。
このレイアウトは、ネットワーク ダイアグラムのエッジに沿った頂点で簡単な操作を処理するために使用されます。次の操作ができます。
- ダイアグラム エッジに沿ってすべての頂点を削除します。
- ダイアグラム エッジに沿って一部の頂点を削減します。
- エッジ上に頂点を追加してダイアグラム エッジを直角化します。
- オーバーラップしているダイアグラム エッジを分離します。
- 直角に交差しているダイアグラム エッジを検出し、交差位置に円弧が表示されるようにエッジのジオメトリを形状変更します。
注意:
このツールは構成および管理ツールです。
メモ:
このツールは、入力ダイアグラム テンプレートに基づく既存のダイアグラムの一貫性に影響を与えます。更新されるまで、既存のダイアグラムはすべて一貫性なしになり、一貫性警告アイコン が表示されます。
使用法
このツールは、ユーティリティ ネットワーク サービスまたはトレース ネットワーク サービスを使用する場合、サポートされません。ファイル ジオデータベース内のユーティリティ ネットワークまたはトレース ネットワークを使用するか、エンタープライズ ジオデータベース内のユーティリティ ネットワークまたはトレース ネットワークへのデータベース接続を使用する必要があります。エンタープライズ ジオデータベースを操作する場合、次の要件があります。
- [入力ネットワーク] パラメーター値は、データベース ユーティリティ ネットワークの所有者またはデータベース トレース ネットワーク所有者として、確立されたデータベース接続から取得する必要があります。
- 接続された ArcGIS Enterprise ポータル アカウントは、ポータル ユーティリティ ネットワークの所有者またはポータル トレース ネットワーク所有者である必要があります。
- このツールは、パブリックで保護されていないと想定される、デフォルトのバージョンに接続されている必要があります。
ダイアグラム テンプレートに基づいてダイアグラムのレイアウト アルゴリズム パラメーターを事前に設定するには、[有効] パラメーターをオフにします (Python では is_active = "INACTIVE")。
また、入力ダイアグラム テンプレートに基づくダイアグラムの生成の終了時に自動的に連結されるレイアウトのリストにレイアウト アルゴリズムを追加する場合は、[有効] をオン (デフォルト) にして (Python では is_active = "ACTIVE")、このツールを実行します。
構文
arcpy.nd.AddReshapeDiagramEdgesLayout(in_utility_network, template_name, is_active, {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})
パラメーター | 説明 | データ タイプ |
in_utility_network | 変更するダイアグラム テンプレートを含むユーティリティ ネットワークまたはトレース ネットワーク。 | Utility Network; Trace Network |
template_name | 変更するダイアグラム テンプレートの名前。 | String |
is_active | 指定したテンプレートに基づくダイアグラムの生成中にレイアウト アルゴリズムを自動的に実行するかどうかを指定します。
| Boolean |
are_containers_preserved (オプション) | アルゴリズムが格納器を処理する方法を指定します。
| Boolean |
reshape_type | エッジの形状を変更する方法を指定します。
| 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 (オプション) | 円弧が配置されるセグメントを指定します。
| String |
派生した出力
名前 | 説明 | データ タイプ |
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.AddReshapeDiagramEdgesLayout_nd(input_Network, input_DiagramTemplate,
"ACTIVE", "PRESERVE_CONTAINERS",
"SQUARE_EDGES", "PRESERVE_PATH", "5 Feet",
"8.66 Feet")
環境
ライセンス情報
- Basic: いいえ
- Standard: はい
- Advanced: はい