添加线性分派布局 (网络逻辑示意图)

描述

用于将线性分派布局算法添加到基于给定模板构建逻辑示意图结束时自动进行链接的布局列表。此工具还会针对基于该模板的任意逻辑示意图预设线性分派布局算法参数。

此布局算法可用于在看起来过于紧密、重叠或重合的逻辑示意图交汇点之间添加空间。该算法会沿连接边移动交汇点。这种沿边的移动是基于交汇点的当前和相对位置以及布局参数实现的。

了解有关线性分派布局算法的详细信息

警告:

该工具为配置和管理工具。

注:

该工具会基于输入逻辑示意图模板影响任何现有逻辑示意图的一致性。所有现有逻辑示意图都将变得不一致,并随附打开一致性警告图标 可能不一致,直至对其进行更新为止。

使用方法

  • 系统在使用 utility network 服务时不支持此工具。您必须使用文件地理数据库中的 utility network or trace network 或企业级地理数据库中 utility network 的数据库连接。在使用企业级地理数据库时,必须以数据库 utility network 所有者的身份建立连接。

  • 在企业级地理数据库中对公共设施网络执行此操作时,已连接的 ArcGIS Enterprise 门户帐户必须是门户公共设施网络所有者

  • 为输入网络参数指定的网络数据元素必须来自文件地理数据库中的 utility network or trace network 或企业级地理数据库中 utility network 的数据库连接。

  • 要基于逻辑示意图模板对任何逻辑示意图预设布局算法参数,请取消选中激活参数(Python 中为 is_active = "INACTIVE")。

  • 如果您想要将布局算法添加到基于输入逻辑示意图模板生成逻辑示意图结束时自动进行链接的布局列表,请在激活处于选中状态(默认)(Python 中为 is_active = "ACTIVE")的情况下运行此工具。

语法

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

指定是否将在基于指定模板生成逻辑示意图时自动执行布局算法。

  • ACTIVE添加的布局算法将在基于 template_name 参数生成任何逻辑示意图的过程中自动运行。这是默认设置。为布局算法指定的参数值是在生成逻辑示意图的过程中用于运行布局的参数值。如果要对基于输入模板的任何逻辑示意图运行此算法,则还会默认加载这些参数值。
  • INACTIVE如果要对基于输入模板的任何逻辑示意图运行此算法,则还将默认加载当前为添加的布局逻辑示意图指定的所有参数值。
Boolean
junction_placement_type
(可选)

指定交汇点的移动方式。

  • EQUAL_DISTANCE所有具有两条连接边的交汇点将移动,以使其之间的距离以及其两个连接交汇点相同。这是默认设置。
  • USER_DEFINE_DISTANCE所有具有两条连接边的交汇点将移动,以使其与其连接的边的另一端之间为最小距离(minimum_shift_ 参数值)。这发生在布局执行结束时。
  • ITERATIVE_DISTANCE具有两条连接边的所有交汇点将根据 iterations_numbermaximum_shift_ 参数值稍稍移动。
String
is_unit_absolute
(可选)

指定将如何解释表示距离的参数。

  • ABSOLUTE_UNIT布局算法会按线性单位来解释任意距离值。
  • PROPORTIONAL_UNIT布局算法会将所有距离值解释为当前逻辑示意图范围内交汇点大小的估算平均值的相对单位。这是默认设置。
Boolean
maximum_shift_absolute
(可选)

具有两个连接的交汇点与其连接的交汇点间隔的最大距离。默认值为 2(采用逻辑示意图坐标系的单位)。达到此距离后,后续迭代过程中将不再移动交汇点。此参数只能与 ITERATIVE_DISTANCE 交汇点放置类型和绝对单位一起使用。

Linear Unit
maximum_shift_proportional
(可选)

具有两个连接的交汇点与其连接的交汇点间隔的最大距离。默认值为 2。达到此距离后,后续迭代过程中将不再移动交汇点。此参数只能与 ITERATIVE_DISTANCE 交汇点放置类型和比例单位一起使用。

Double
minimum_shift_absolute
(可选)

布局执行后,对于每个具有两个连接边的交汇点,从其两个边端点对其进行分隔的最小距离。默认值为 2(采用逻辑示意图坐标系的单位)。如果此参数值过大,则将移动具有两个连接的交汇点,以使每个移动后的交汇点在沿其两个连接边所定义的路径上与其边端点之间的距离相等。此参数只能与 USER_DEFINE_DISTANCE 交汇点放置类型和绝对单位一起使用。

Linear Unit
minimum_shift_proportional
(可选)

布局执行后,对于每个具有两个连接边的交汇点,确定从其两个边端点对其进行分隔的最小距离。默认值为 2。如果此参数值过大,则将移动具有两个连接的交汇点,以使每个移动后的交汇点在沿其两个连接边所定义的路径上与其边端点之间的距离相等。此参数将与 USER_DEFINE_DISTANCE 交汇点放置类型和比例单位一起使用。

Double
iterations_number
(可选)

要处理的迭代次数。默认值为 5。此参数只能与 ITERATIVE_DISTANCE 交汇点放置类型一起使用。

Long
is_path_preserved
(可选)

指定如何对沿边的折点进行处理。

  • PRESERVE_PATH将保留所有沿已连接边的折点,并将在已移动交汇点的原始位置处添加新折点。这是默认设置。
  • IGNORE_PATH将不保留沿边的折点。
Boolean
are_leaves_moved
(可选)

指定在算法执行过程中是否移动叶交汇点(包含一个连接的交汇点)。

  • 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

逻辑示意图模板的名称。

字符串

代码示例

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: 是

相关主题