相対的な主軸レイアウトの追加 (Add Relative Mainline Layout) (ネットワーク ダイアグラム)

サマリー

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

このレイアウト アルゴリズムでは、アクティブなダイアグラム内のネットワーク ダイアグラム フィーチャが、接続されるすべてのエッジが同じ属性値を持つ平行な直線に沿って配置されます。 さらに、それらの直線からの分岐が、直線に対する分岐の方向と、初期距離に比例し、相互に相対的な距離を維持しながら、配置されます。

相対的な主軸レイアウト アルゴリズムの詳細

注意:

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

注意:

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

使用法

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

  • ダイアグラム テンプレートに基づいて、ダイアグラムのレイアウト アルゴリズム パラメーターを事前に設定するには、[有効] パラメーターをオフにします (is_active = "INACTIVE" では Python)。

  • また、入力ダイアグラム テンプレートに基づく、ダイアグラムの生成の終了時に、自動的に連結されるレイアウトのリストに、レイアウト アルゴリズムを追加する場合は、[有効] をオンにして (is_active = "ACTIVE" では Python)、このツールを実行します。

パラメーター

ラベル説明データ タイプ
入力ネットワーク

変更するダイアグラム テンプレートを含むユーティリティ ネットワークまたはトレース ネットワーク。

Utility Network; Trace Network
入力ダイアグラム テンプレート

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

String
アクティブ

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

  • オン - [入力ダイアグラム テンプレート] パラメーター値に基づくダイアグラムの生成中に、追加されたレイアウト アルゴリズムが自動的に実行されます。 これがデフォルトです。

    レイアウト アルゴリズムに指定されたパラメーター値は、ダイアグラム生成中に、レイアウトの実行に使用されます。 また、このパラメーター値は、入力テンプレートに基づくダイアグラムでアルゴリズムを実行する際に、デフォルトで読み込まれます。

  • オフ - 追加されたレイアウト アルゴリズムに現在指定されているパラメーター値はすべて、入力テンプレートに基づくダイアグラムでアルゴリズムを実行する際に、デフォルトで読み込まれます。

Boolean
ライン属性

直線を構成するラインの識別に使用するネットワーク属性の名前。 このネットワーク属性は、ネットワーク ライン クラス内に存在する必要があります。 その値は、直線を構成するすべてのエッジで同じである必要があります (たとえば、「Line 1」や「Line 2」など)。

String
方向
(オプション)

主軸の方向を指定します。

  • 左から右へ主軸は、左から開始して右で終了する横線として描画されます。 これがデフォルトです。
  • 上から下へ主軸は、上から開始して下で終了する縦線として描画されます。
String
ブランチ間のオフセット
(オプション)

ラインの方向と垂直な軸に沿った、隣接する 2 つの分岐の間隔。

Linear Unit
ブレーク ポイント角度 (度)
(オプション)

分岐にブレーク ポイントを配置する際の角度。 値は 30 ~ 90 度の範囲で指定し、[ブランチ間のオフセット] パラメーターの値と組み合わせてブレーク ポイントの位置が計算されます。 ブレーク ポイント角度が 90 度の場合、各分岐は直交するように表示されます。

Double
タイプ属性
(オプション)

ラインの条件付けに使用するネットワーク属性の名前。 このネットワーク属性は、ネットワーク ライン クラス内に存在することがあります。

注意:

[タイプ属性] パラメーター値と [ライン属性] パラメーター値は同じにすることができます。

String
主軸値
(オプション)

主軸を識別する [タイプ属性] の値。 このような値が存在する場合、値は、関連するネットワーク フィーチャ ライン クラスまたはエッジ オブジェクト テーブルとは関係なく、主軸を構成するどのエッジでも同じである必要があります。

Value Table
分岐値
(オプション)

分岐を識別する [タイプ属性] の値。

Value Table
除外する値
(オプション)

直線から除外するエッジ (交差点またははしご) を識別する [タイプ属性] の値。

Value Table
方向に沿って圧縮
(オプション)

グラフを圧縮するかどうかを指定します。

  • オン - 圧縮が使用されます。 プロセスの最後に追加のステップが実行され、近接ジャンクションの隣接するグループ間の距離を、グループの相対的な配置を維持したまま方向に沿って縮小します。 近接ジャンクションとは、地理的に近い位置にある、直接接続されていないジャンクションです。
  • オフ - 圧縮は使用されません。 これがデフォルトです。

Boolean
比率 (%)
(オプション)

0 から 100 の間の値で、元の長さから最小距離を減算した後のエッジの長さに適用されます。 値が 100 の場合、検出された各ジャンクション グループ間の距離は最小距離に等しくなります。

Double
最小距離
(オプション)

近接ジャンクションの 2 つの隣接するグループ間の最小距離。 この最小距離は、方向軸に沿ったジャンクションの投影に基づいて、近接ジャンクションをグループ化するためにも使用されます。 この軸に投影された 2 つのジャンクションに注目したとき、投影された 2 つのポイント間の距離がこの距離より小さい場合、これらのジャンクションは同じグループに分類されます。

Linear Unit
整列属性
(オプション)

分割されたラインの整列に使用するネットワーク属性の名前。 同じ属性値を含むラインが整列されます。

String
初期距離
(オプション)

ダイアグラム エッジの長さの評価方法を指定します。 この長さは、方向に沿ったジャンクションの配置を決定します。 方向に沿った接続ジャンクション間の距離は等距離ではありません。これらの距離は相互に相対的で、現在のエッジの長さと最も短いエッジの長さに依存します。

  • 現在のエッジ ジオメトリから現在のエッジ ジオメトリから距離が計算されます。 これがデフォルトです。
  • 属性エッジからエッジ上に存在する所定の属性から距離が計算されます。
String
長さ属性
(オプション)

[初期距離][属性エッジから] の場合に距離の計算元となるネットワーク属性。

String

派生した出力

ラベル説明データ タイプ
出力ネットワーク

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

ユーティリティ ネットワーク、トレース ネットワーク
出力ダイアグラム テンプレート

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

String

arcpy.nd.AddRelativeMainlineLayout(in_utility_network, template_name, is_active, line_attribute, {mainline_direction}, {offset_between_branches}, {breakpoint_angle}, {type_attribute}, {mainline_values}, {branch_values}, {excluded_values}, {is_compressing}, {compression_ratio}, {minimal_distance}, {alignment_attribute}, {initial_distances}, {length_attribute})
名前説明データ タイプ
in_utility_network

変更するダイアグラム テンプレートを含むユーティリティ ネットワークまたはトレース ネットワーク。

Utility Network; Trace Network
template_name

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

String
is_active

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

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

直線を構成するラインの識別に使用するネットワーク属性の名前。 このネットワーク属性は、ネットワーク ライン クラス内に存在する必要があります。 その値は、直線を構成するすべてのエッジで同じである必要があります (たとえば、「Line 1」や「Line 2」など)。

String
mainline_direction
(オプション)

主軸の方向を指定します。

  • FROM_LEFT_TO_RIGHT主軸は、左から開始して右で終了する横線として描画されます。 これがデフォルトです。
  • FROM_TOP_TO_BOTTOM主軸は、上から開始して下で終了する縦線として描画されます。
String
offset_between_branches
(オプション)

ラインの方向と垂直な軸に沿った、隣接する 2 つの分岐の間隔。

Linear Unit
breakpoint_angle
(オプション)

分岐にブレーク ポイントを配置する際の角度。 値は 30 ~ 90 度の範囲で指定し、offset_between_branches パラメーターの値と組み合わせてブレーク ポイントの位置が計算されます。 ブレーク ポイント角度が 90 度の場合、各分岐は直交するように表示されます。

Double
type_attribute
(オプション)

ラインの条件付けに使用するネットワーク属性の名前。 このネットワーク属性は、ネットワーク ライン クラス内に存在することがあります。

注意:

type_attribute パラメーター値と line_attribute パラメーター値は同じにすることができます。

String
mainline_values
[mainline_values,...]
(オプション)

主軸を識別する type_attribute の値。 このような値が存在する場合、値は、関連するネットワーク フィーチャ ライン クラスまたはエッジ オブジェクト テーブルとは関係なく、主軸を構成するどのエッジでも同じである必要があります。

Value Table
branch_values
[branch_values,...]
(オプション)

分岐を識別する type_attribute の値。

Value Table
excluded_values
[excluded_values,...]
(オプション)

直線から除外するエッジ (交差点またははしご) を識別する type_attribute の値。

Value Table
is_compressing
(オプション)

グラフを圧縮するかどうかを指定します。

  • USE_COMPRESSION圧縮が使用されます。 プロセスの最後に追加のステップが実行され、近接ジャンクションの隣接するグループ間の距離を、グループの相対的な配置を維持したまま方向に沿って縮小します。 近接ジャンクションとは、地理的に近い位置にある、直接接続されていないジャンクションです。
  • DO_NOT_USE_COMPRESSION圧縮は使用されません。 これがデフォルトです。
Boolean
compression_ratio
(オプション)

0 から 100 の間の値で、元の長さから最小距離を減算した後のエッジの長さに適用されます。 値が 100 の場合、検出された各ジャンクション グループ間の距離は最小距離に等しくなります。

Double
minimal_distance
(オプション)

近接ジャンクションの 2 つの隣接するグループ間の最小距離。 この最小距離は、方向軸に沿ったジャンクションの投影に基づいて、近接ジャンクションをグループ化するためにも使用されます。 この軸に投影された 2 つのジャンクションに注目したとき、投影された 2 つのポイント間の距離がこの距離より小さい場合、これらのジャンクションは同じグループに分類されます。

Linear Unit
alignment_attribute
(オプション)

分割されたラインの整列に使用するネットワーク属性の名前。 同じ属性値を含むラインが整列されます。

String
initial_distances
(オプション)

ダイアグラム エッジの長さの評価方法を指定します。 この長さは、方向に沿ったジャンクションの配置を決定します。 方向に沿った接続ジャンクション間の距離は等距離ではありません。これらの距離は相互に相対的で、現在のエッジの長さと最も短いエッジの長さに依存します。

  • FROM_CURRENT_EDGE_GEOMETRY現在のエッジ ジオメトリから距離が計算されます。 これがデフォルトです。
  • FROM_ATTRIBUTE_EDGEエッジ上に存在する所定の属性から距離が計算されます。
String
length_attribute
(オプション)

initial_distancesFROM_ATTRIBUTE_EDGE の場合に距離の計算元となるネットワーク属性。

String

派生した出力

名前説明データ タイプ
out_utility_network

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

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

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

String

コードのサンプル

AddRelativeMainlineLayout (相対的な主軸レイアウトの追加) の例 (Python ウィンドウ)

入力ネットワークに関連した MyTemplate1 テンプレートに相対的な主軸レイアウト アルゴリズムを自動レイアウトとして追加します。

import arcpy
input_Network = "D:/MyProjectLocation/MyDatabaseConnection.sde/MyDatabase.MAP.Electric/MyDatabase.MAP.Electric"
input_DiagramTemplate = "MyTemplate1"
arcpy.AddRelativeMainlineLayout_nd(input_Network, input_DiagramTemplate, 
                               "ACTIVE", "LineTrack",
                               "FROM_LEFT_RIGHT", 2, 45)

環境

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

ライセンス情報

  • Basic: No
  • Standard: Yes
  • Advanced: Yes

関連トピック