線形配置レイアウトの追加 (Add Linear Dispatch Layout) (ネットワーク ダイアグラム)

概要

線形配置レイアウト アルゴリズムをレイアウトのリストに追加して、指定したテンプレートに基づいて、ダイアグラム構築の終了時に自動的に連結されるようにします。このツールでは、そのテンプレートに基づいてダイアグラムの線形配置レイアウト アルゴリズム パラメーターも事前に設定します。

このレイアウト アルゴリズムは、視覚的に近すぎる、重なっている、または一致しているダイアグラム ジャンクションの間隔を空けます。接続されたエッジに沿ってジャンクションを移動します。エッジに沿った移動は、現在のジャンクションの相対位置およびレイアウト パラメーターによって決まります。

線形配置レイアウト アルゴリズムの詳細

注意:

このツールは構成および管理ツールです。

メモ:

このツールは、入力ダイアグラム テンプレートに基づく既存のダイアグラムの一貫性に影響を与えます。更新されるまで、既存のダイアグラムはすべて一貫性なしになり、一貫性警告アイコン 不整合の可能性 が表示されます。

使用法

  • このツールは、ユーティリティ ネットワーク サービスまたはトレース ネットワーク サービスを使用する場合、サポートされません。ファイル ジオデータベース内のユーティリティ ネットワークまたはトレース ネットワークを使用するか、エンタープライズ ジオデータベース内のユーティリティ ネットワークまたはトレース ネットワークへのデータベース接続を使用する必要があります。エンタープライズ ジオデータベースを操作する場合、次の要件があります。

  • ダイアグラム テンプレートに基づいてダイアグラムのレイアウト アルゴリズム パラメーターを事前に設定するには、[有効] パラメーターをオフにします (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

指定したテンプレートに基づくダイアグラムの生成中にレイアウト アルゴリズムを自動的に実行するかどうかを指定します。

  • ACTIVEtemplate_name パラメーターに基づくダイアグラムの生成中に、追加されたレイアウト アルゴリズムが自動的に実行されます。これがデフォルトです。レイアウト アルゴリズムに指定されたパラメーター値は、ダイアグラム生成中にレイアウトの実行に使用されます。また、このパラメーター値は、入力テンプレートに基づくダイアグラムでアルゴリズムを実行する際にデフォルトで読み込まれます。
  • INACTIVE追加されたレイアウト アルゴリズムに現在指定されているパラメーター値はすべて、入力テンプレートに基づくダイアグラムでアルゴリズムを実行する際にデフォルトで読み込まれます。
Boolean
junction_placement_type
(オプション)

ジャンクションの移動方法を指定します。

  • EQUAL_DISTANCE接続されたエッジが 2 つあるすべてのジャンクションが、接続先の 2 つのジャンクションの間隔が等しくなるように移動されます。これがデフォルトです。
  • USER_DEFINE_DISTANCE接続されたエッジが 2 つあるすべてのジャンクションが、接続するエッジのもう一方の端点との距離が最小 (minimum_shift_ パラメーター値) になるように移動されます。これは、レイアウト実行の最後に発生します。
  • ITERATIVE_DISTANCE接続されたエッジが 2 つあるすべてのジャンクションが、iterations_number パラメーター値および maximum_shift_ パラメーター値に従ってわずかに移動されます。
String
is_unit_absolute
(オプション)

距離を表すパラメーターの解釈方法を指定します。

  • ABSOLUTE_UNITレイアウト アルゴリズムは、距離値を距離単位として解釈します。
  • PROPORTIONAL_UNITレイアウト アルゴリズムは、現在のダイアグラムの範囲内にあるジャンクションの平均サイズを 1 とする相対単位で解釈します。これがデフォルトです。
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
(オプション)

エッジに沿った頂点を処理する方法を指定します。

  • PRESERVE_PATH接続エッジに沿ったすべての頂点が維持され、移動したジャンクションの元の位置に新しい頂点が追加されます。これがデフォルトです。
  • IGNORE_PATHエッジに沿った頂点は保持されません。
Boolean
are_leaves_moved
(オプション)

末端ジャンクション (接続されたエッジが 1 つあるジャンクション) がアルゴリズムの実行中に移動されるかどうかを指定します。

  • MOVE_LEAVES末端ジャンクションは移動されます。
  • DO_NOT_MOVE_LEAVES末端ジャンクションは移動されません。指定された入力ネットワーク ダイアグラムが、線形配置レイアウト アルゴリズムに別のパラメーター値が構成されているテンプレートに基づいていない場合は、これがデフォルトです。
Boolean
are_leaves_expanded
(オプション)

末端ジャンクションが拡張されるかどうかを指定します。

  • EXPAND_LEAVES末端ジャンクションは拡張されます。expand_shift_absolute パラメーター値には、この末端ジャンクションを接続先のジャンクションから拡張できる最大距離を指定します。
  • DO_NOT_EXPAND_LEAVES末端ジャンクションは拡張されません。指定された入力ネットワーク ダイアグラムが、線形配置レイアウト アルゴリズムに別のパラメーター値が構成されているテンプレートに基づいていない場合は、これがデフォルトです。
Boolean
expand_shift_absolute
(オプション)

末端ジャンクションが接続先のジャンクションから離される最大距離。指定された入力ネットワーク ダイアグラムが、線形配置レイアウト アルゴリズムに別のパラメーター値が構成されているテンプレートに基づいていない場合、デフォルト値は、そのダイアグラムの座標系の単位で 2 になります。この距離に達すると、以降の反復中に末端ジャンクションは移動されなくなります。このパラメーターは、[末端ノードを拡張] パラメーターおよび絶対単位を使用する場合にのみ、使用することができます。

Linear Unit
expand_shift_proportional
(オプション)

末端ジャンクションが接続先のジャンクションから離される最大距離。指定された入力ネットワーク ダイアグラムが、線形配置レイアウト アルゴリズムに別のパラメーター値が構成されているテンプレートに基づいていない場合、デフォルト値は 2 です。この距離に達すると、以降の反復中に末端ジャンクションは移動されなくなります。このパラメーターは、[末端ノードを拡張] パラメーターおよび比例単位を使用する場合にのみ、使用することができます。

Double

派生した出力

名前説明データ タイプ
out_utility_network

更新されたユーティリティ ネットワークまたはトレース ネットワーク

ユーティリティ ネットワーク、トレース ネットワーク
out_template_name

ダイアグラム テンプレートの名前。

String

コードのサンプル

AddLinearDispatchLayout (線形配置レイアウトの追加) の例 (Python ウィンドウ)

このサンプルでは、入力ネットワーク用の既存の 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: はい

関連トピック