应用线性分派布局 (网络逻辑示意图)

描述

在视觉上过于接近、重叠或重合的逻辑示意图交汇点之间添加空间。

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

警告:

如果您具有处于打开状态的编辑会话,则在运行此工具前,必须先保存您的编辑内容。从而确保逻辑示意图可反映对数据库中网络拓扑所做的最新更改。如果保存编辑内容失败,则编辑内容不会反映在逻辑示意图中。

注:

各布局算法均包括默认参数值。除非另行指定,否则将使用默认参数值。如果输入网络逻辑示意图基于模板且已使用其他参数值来配置此布局,则会使用该值。

使用方法

  • 在与企业级地理数据库中的公共设施网络或追踪网络数据库连接搭配使用时,系统不支持此工具。您必须使用相关的已发布公共设施网络或追踪网络服务或文件地理数据库中的公共设施网络或追踪网络。

  • 输入网络逻辑示意图图层必须来自文件地理数据库中的公共设施网络或追踪网络或者网络逻辑示意图服务。

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

  • 此算法还可以分离与目标交汇点相连的逻辑示意图边。这些交汇点的价也会纳入考虑范畴 - 即它们的相邻边以及边缘路径数量将予以保留。

  • 此布局尤其适用于水、废水和天然气应用,但同时也可部署于其他行业。

  • 当处理非常大的逻辑示意图时,请考虑在服务器上以异步模式应用布局

语法

arcpy.nd.ApplyLinearDispatchLayout(in_network_diagram_layer, {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}, {run_async})
参数说明数据类型
in_network_diagram_layer

将应用布局的网络逻辑示意图。

Diagram Layer
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
run_async
(可选)

指定布局算法在服务器上将异步运行还是同步运行。

  • RUN_ASYNCHRONOUSLY布局算法将在服务器上异步运行。服务器资源可通过该选项来运行超时较长的布局算法。当执行耗时且可能导致服务器超时的布局(例如,部分重叠边)并应用于大型逻辑示意图(超过 25,000 个要素)时,建议进行异步运行。
  • RUN_SYNCHRONOUSLY布局算法将在服务器上同步运行。如果执行时超过服务超时值(默认为 600 秒),则布局算法可能失败,无法完成。这是默认设置。
Boolean

派生输出

名称说明数据类型
out_network_diagram_layer

更新的网络逻辑示意图图层。

逻辑示意图图层

代码示例

ApplyLinearDispatchLayout 示例(Python 窗口)

将线性分派布局算法应用至名为 Temporary Diagram 的逻辑示意图。

import arcpy
arcpy.ApplyLinearDispatchLayout_nd("Temporary Diagram", "ITERATIVE_DISTANCE", 
                                   "ABSOLUTE_UNIT", "15 Feet", "", "2 Feet", 
                                   "", 10, "PRESERVE_PATH", "DO_NOT_MOVE_LEAVES", 
                                   "DO_NOT_EXPAND_LEAVES", "2 Feet", 2, 
                                   "RUN_SYNCHRONOUSLY")

环境

此工具不使用任何地理处理环境。

许可信息

  • Basic: 否
  • Standard: 是
  • Advanced: 是

相关主题