概要
線形配置レイアウト アルゴリズムをレイアウトのリストに追加して、指定したテンプレートに基づいて、ダイアグラム構築の終了時に自動的に連結されるようにします。このツールでは、そのテンプレートに基づいてダイアグラムの線形配置レイアウト アルゴリズム パラメーターも事前に設定します。
このレイアウト アルゴリズムは、視覚的に近すぎる、重なっている、または一致しているダイアグラム ジャンクションの間隔を空けます。接続されたエッジに沿ってジャンクションを移動します。エッジに沿った移動は、現在のジャンクションの相対位置およびレイアウト パラメーターによって決まります。
注意:
このツールは構成および管理ツールです。
メモ:
このツールは、入力ダイアグラム テンプレートに基づく既存のダイアグラムの一貫性に影響を与えます。更新されるまで、既存のダイアグラムはすべて一貫性なしになり、一貫性警告アイコン 
が表示されます。
使用法
このツールは、ユーティリティ ネットワーク サービスまたはトレース ネットワーク サービスを使用する場合、サポートされません。ファイル ジオデータベース内のユーティリティ ネットワークまたはトレース ネットワークを使用するか、エンタープライズ ジオデータベース内のユーティリティ ネットワークまたはトレース ネットワークへのデータベース接続を使用する必要があります。エンタープライズ ジオデータベースを操作する場合、次の要件があります。
- [入力ネットワーク] パラメーター値は、データベース ユーティリティ ネットワークの所有者またはデータベース トレース ネットワーク所有者として、確立されたデータベース接続から取得する必要があります。
- 接続された ArcGIS Enterprise ポータル アカウントは、ポータル ユーティリティ ネットワークの所有者またはポータル トレース ネットワーク所有者である必要があります。
- このツールは、パブリックで保護されていないと想定される、デフォルトのバージョンに接続されている必要があります。
ダイアグラム テンプレートに基づいてダイアグラムのレイアウト アルゴリズム パラメーターを事前に設定するには、[有効] パラメーターをオフにします (Python では is_active = "INACTIVE")。
また、入力ダイアグラム テンプレートに基づくダイアグラムの生成の終了時に自動的に連結されるレイアウトのリストにレイアウト アルゴリズムを追加する場合は、[有効] をオン (デフォルト) にして (Python では is_active = "ACTIVE")、このツールを実行します。
構文
arcpy.nd.AddLinearDispatchLayout(in_utility_network, template_name, is_active, {junction_placement_type}, {is_unit_absolute}, {maximum_shift_absolute}, {maximum_shift_proportional}, {minimum_shift_absolute}, {minimum_shift_proportional}, {iterations_number}, {is_path_preserved}, {are_leaves_moved}, {are_leaves_expanded}, {expand_shift_absolute}, {expand_shift_proportional})| パラメーター | 説明 | データ タイプ |
in_utility_network | 変更するダイアグラム テンプレートを含むユーティリティ ネットワークまたはトレース ネットワーク。 | Utility Network; Trace Network |
template_name | 変更するダイアグラム テンプレートの名前。 | String |
is_active | 指定したテンプレートに基づくダイアグラムの生成中にレイアウト アルゴリズムを自動的に実行するかどうかを指定します。
| Boolean |
junction_placement_type (オプション) | ジャンクションの移動方法を指定します。
| String |
is_unit_absolute (オプション) | 距離を表すパラメーターの解釈方法を指定します。
| Boolean |
maximum_shift_absolute (オプション) | 2 つの接続があるジャンクションが接続先のジャンクションから離される最大距離。デフォルトは、ダイアグラムの座標系の単位で 2 です。この距離に達すると、以降の反復中にジャンクションは移動されなくなります。このパラメーターは、ITERATIVE_DISTANCE ジャンクション配置タイプおよび絶対単位を使用する場合にのみ、使用することができます。 | Linear Unit |
maximum_shift_proportional (オプション) | 2 つの接続があるジャンクションが接続先のジャンクションから離される最大距離。デフォルトは 2 です。この距離に達すると、以降の反復中にジャンクションは移動されなくなります。このパラメーターは、ITERATIVE_DISTANCE ジャンクション配置タイプおよび比例単位を使用する場合にのみ、使用することができます。 | Double |
minimum_shift_absolute (オプション) | レイアウト実行後に、接続されたエッジが 2 つある各ジャンクションが 2 つのエッジ端点から離される最小距離。デフォルトは、ダイアグラムの座標系の単位で 2 です。このパラメーターの値が大きすぎる場合、接続されたエッジが 2 つあるジャンクションが移動すると、移動した各ジャンクションとそのエッジの端点との間隔は、2 つの接続エッジによって定義されるパス上で等しくなります。このパラメーターは、USER_DEFINE_DISTANCE ジャンクション配置タイプおよび絶対単位を使用する場合にのみ、使用することができます。 | Linear Unit |
minimum_shift_proportional (オプション) | レイアウト実行後に、接続されたエッジが 2 つある各ジャンクションが 2 つのエッジ端点から離される最小距離。デフォルトは 2 です。このパラメーターの値が大きすぎる場合、接続されたエッジが 2 つあるジャンクションが移動すると、移動した各ジャンクションとそのエッジの端点との間隔は、2 つの接続エッジによって定義されるパス上で等しくなります。このパラメーターは、USER_DEFINE_DISTANCE ジャンクション配置タイプおよび比例単位と共に使用されます。 | Double |
iterations_number (オプション) | 処理を反復する回数です。デフォルトは 5 です。このパラメーターは、ITERATIVE_DISTANCE ジャンクション配置タイプを使用する場合にのみ、使用することができます。 | Long |
is_path_preserved (オプション) | エッジに沿った頂点を処理する方法を指定します。
| Boolean |
are_leaves_moved (オプション) | 末端ジャンクション (接続されたエッジが 1 つあるジャンクション) がアルゴリズムの実行中に移動されるかどうかを指定します。
| Boolean |
are_leaves_expanded (オプション) | 末端ジャンクションが拡張されるかどうかを指定します。
| Boolean |
expand_shift_absolute (オプション) | 末端ジャンクションが接続先のジャンクションから離される最大距離。指定された入力ネットワーク ダイアグラムが、線形配置レイアウト アルゴリズムに別のパラメーター値が構成されているテンプレートに基づいていない場合、デフォルト値は、そのダイアグラムの座標系の単位で 2 になります。この距離に達すると、以降の反復中に末端ジャンクションは移動されなくなります。このパラメーターは、[末端ノードを拡張] パラメーターおよび絶対単位を使用する場合にのみ、使用することができます。 | Linear Unit |
expand_shift_proportional (オプション) | 末端ジャンクションが接続先のジャンクションから離される最大距離。指定された入力ネットワーク ダイアグラムが、線形配置レイアウト アルゴリズムに別のパラメーター値が構成されているテンプレートに基づいていない場合、デフォルト値は 2 です。この距離に達すると、以降の反復中に末端ジャンクションは移動されなくなります。このパラメーターは、[末端ノードを拡張] パラメーターおよび比例単位を使用する場合にのみ、使用することができます。 | 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.AddLinearDispatchLayout_nd(input_Network, input_DiagramTemplate,
"ACTIVE", "ITERATIVE_DISTANCE", "ABSOLUTE_UNIT",
"15 Feet", "", "2 Feet", "", 10, "PRESERVE_PATH",
"DO_NOT_MOVE_LEAVES", "DO_NOT_EXPAND_LEAVES",
"2 Feet", 2)環境
ライセンス情報
- Basic: いいえ
- Standard: はい
- Advanced: はい