应用主环布局 (网络逻辑示意图)

摘要

用于对主环周围的网络逻辑示意图中的逻辑示意图要素进行排列。

了解有关主环布局算法参数的详细信息

警告:

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

注:

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

使用情况

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

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

  • 此布局算法用于在主环周围排列逻辑示意图要素,并对连接到沿主环放置的每个逻辑示意图交汇点的逻辑示意图要素子集进行等级布局。

    主环是网络逻辑示意图中边数最多的环。

    如果网络逻辑示意图中不包含环,则执行“主环”布局算法不会产生任何效果。

  • 此布局算法通常应用于电信行业。

  • 如果在逻辑示意图要素上指定了障碍,则主环布局算法会识别将排除这些标记要素的主环。

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

参数

标注说明数据类型
输入网络逻辑示意图图层

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

Diagram Layer
保留容器布局
(可选)

指定算法将如何处理容器。

  • 选中 - 将对逻辑示意图的上方图执行布局算法,以保留容器。
  • 未选中 - 将对逻辑示意图中的内容要素和非内容要素执行布局算法。 这是默认设置。

Boolean
环类型
(可选)

指定环的类型。

  • 椭圆形检测到的主环的逻辑示意图要素将沿椭圆显示。这是默认设置。
  • 矩形检测到的主环的逻辑示意图要素将沿矩形显示。
String
间距值解释为逻辑示意图坐标系中的绝对单位
(可选)

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

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

Boolean
环宽度
(可选)

环的宽度。默认值为逻辑示意图坐标系中的单位。此参数只能与绝对单位搭配使用。

Linear Unit
环宽度
(可选)

环的宽度。默认值为 50。此参数只能与比例单位搭配使用。

Double
环高度
(可选)

环的高度。默认值为逻辑示意图坐标系中的单位。此参数只能与绝对单位搭配使用。

Linear Unit
环高度
(可选)

环的高度。默认值为 20。此参数只能与比例单位搭配使用。

Double
等级树类型
(可选)

用于指定如何定位来自主环交汇点的树。

  • 主线树的两侧将沿主线显示每棵树,并将其相关分支排列在此主线的左右两侧。
  • 主线树的左侧将沿主线按等级显示每棵树,并将其相关分支排列在此主线的左侧。
  • 主线树的右侧将沿主线按等级显示每棵树,并将其相关分支排列在此主线的右侧。
  • 智能树将以智能树的形式按等级显示每棵树。这是默认设置。
String
交汇点之间的间距垂直于方向
(可选)

垂直于树方向显示并且属于相同子树级别的逻辑示意图交汇点之间的间距。默认值为 2(采用逻辑示意图坐标系的单位)。此参数只能与绝对单位搭配使用。

Linear Unit
交汇点之间的间距垂直于方向
(可选)

垂直于树方向显示并且属于相同子树级别的逻辑示意图交汇点之间的间距。默认值为 2。此参数只能与比例单位搭配使用。

Double
交汇点之间的间距沿着方向
(可选)

沿树方向显示的逻辑示意图交汇点之间的间距。默认值为 2(采用逻辑示意图坐标系的单位)。此参数只能与绝对单位搭配使用。

Linear Unit
交汇点之间的间距沿着方向
(可选)

沿树方向显示的逻辑示意图交汇点之间的间距。默认值为 2。此参数只能与比例单位搭配使用。

Double
中断点相对位置 (%)
(可选)

边显示类型设置为规则边(在 Python 中为 edge_display_type = "REGULAR_EDGES")或边显示类型设置为正交边(在 Python 中为 edge_display_type = "ORTHOGONAL_EDGES")时,将沿逻辑示意图边插入的中断点的相对位置。 以 0 至 100 之间的百分比来表示。

  • 当中断点相对位置 (%) 的值为 0 时,中断点位于边的自交汇点的 x 坐标,以及水平树边的至交汇点的 y 坐标。 中断点位于边的自交汇点的 y 坐标,以及垂直树边的至交汇点的 x 坐标。
  • 当中断点相对位置 (%) 的值为 100 时,即表示未在逻辑示意图边上插入任何中断点;每条逻辑示意图边直接连接其自和至交汇点。
  • 当中断点相对位置 (%) 的值为介于 0 至 100 之间的 N 时,中断点位于 [XY] 线段长度的 N%,其中 X 表示边的自交汇点的 x 坐标,Y 表示水平树边的至交汇点的 y 坐标。 中断点位于 [YX] 线段长度的 N%,其中 Y 表示边的自交汇点的 y 坐标,X 表示垂直树边的至交汇点的 x 坐标。

边显示类型设置为弯曲边(在 Python 中为 edge_display_type = "CURVED_EDGES")时,将沿逻辑示意图边插入、用于计算弯曲边几何的两个拐点的相对位置。 以 15 至 40 之间的百分比来表示。 如果中断点相对位置 (%) 值为介于 15 至 40 之间的 N:

  • X 为边的自交汇点的 x 坐标,Y 为水平树边的至交汇点的 y 坐标:
    • 第一个拐点将定位在 [XY] 线段长度的 N%。
    • 第二个拐点将定位在 [XY] 线段长度的 (100 - N)%。
  • Y 为边的自交汇点的 y 坐标,X 为垂直树边的至交汇点的 x 坐标:
    • 第一个拐点将定位在 [YX] 线段长度的 N%。
    • 第二个拐点将定位在 [XY] 线段长度的 (100 - N)%。

注:

上述自和至交汇点的概念与树方向相关;它与网络中的边要素或边对象的真实拓扑无关。

Double
边显示类型
(可选)

指定与树分支相关的逻辑示意图边的显示类型。

  • 规则边与树分支相关的所有逻辑示意图边将不会显示为直角。 这是默认设置。
  • 正交边与树分支相关的所有逻辑示意图边将显示为直角。
  • 弯曲边与树分支相关的所有逻辑示意图边将显示为曲线。
String
在服务器上以异步模式运行
(可选)

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

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

Boolean
绝对偏移
(可选)

在使用绝对单位,并且边显示类型设置为正交边时,将使用此偏移分隔重叠线段。 该值不能超过为其他间距参数指定的最小值的 10%。 默认值为 0。

Linear Unit
比例偏移
(可选)

在使用比例单位,并且边显示类型设置为正交边时,将使用此偏移分隔重叠线段。 它是一个双精度值,不能超过为其他间距参数指定的最小值的 10%。 默认值为 0。

Double

派生输出

标注说明数据类型
输出网络逻辑示意图

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

逻辑示意图图层

arcpy.nd.ApplyMainRingLayout(in_network_diagram_layer, {are_containers_preserved}, {ring_type}, {is_unit_absolute}, {ring_width_absolute}, {ring_width_proportional}, {ring_height_absolute}, {ring_height_proportional}, {tree_type}, {perpendicular_absolute}, {perpendicular_proportional}, {along_absolute}, {along_proportional}, {breakpoint_position}, {edge_display_type}, {run_async}, {offset_absolute}, {offset_proportional})
名称说明数据类型
in_network_diagram_layer

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

Diagram Layer
are_containers_preserved
(可选)

指定算法将如何处理容器。

  • PRESERVE_CONTAINERS将对逻辑示意图的上方图执行布局算法,以保留容器。
  • IGNORE_CONTAINERS将对逻辑示意图中的内容要素和非内容要素执行布局算法。 这是默认设置。
Boolean
ring_type
(可选)

指定环的类型。

  • ELLIPSE检测到的主环的逻辑示意图要素将沿椭圆显示。这是默认设置。
  • RECTANGLE检测到的主环的逻辑示意图要素将沿矩形显示。
String
is_unit_absolute
(可选)

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

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

环的宽度。默认值为逻辑示意图坐标系中的单位。此参数只能与绝对单位搭配使用。

Linear Unit
ring_width_proportional
(可选)

环的宽度。默认值为 50。此参数只能与比例单位搭配使用。

Double
ring_height_absolute
(可选)

环的高度。默认值为逻辑示意图坐标系中的单位。此参数只能与绝对单位搭配使用。

Linear Unit
ring_height_proportional
(可选)

环的高度。默认值为 20。此参数只能与比例单位搭配使用。

Double
tree_type
(可选)

用于指定如何定位来自主环交汇点的树。

  • BOTH_SIDES将沿主线显示每棵树,并将其相关分支排列在此主线的左右两侧。
  • LEFT_SIDE将沿主线按等级显示每棵树,并将其相关分支排列在此主线的左侧。
  • RIGHT_SIDE将沿主线按等级显示每棵树,并将其相关分支排列在此主线的右侧。
  • SMART_TREE将以智能树的形式按等级显示每棵树。这是默认设置。
String
perpendicular_absolute
(可选)

垂直于树方向显示并且属于相同子树级别的逻辑示意图交汇点之间的间距。默认值为 2(采用逻辑示意图坐标系的单位)。此参数只能与绝对单位搭配使用。

Linear Unit
perpendicular_proportional
(可选)

垂直于树方向显示并且属于相同子树级别的逻辑示意图交汇点之间的间距。默认值为 2。此参数只能与比例单位搭配使用。

Double
along_absolute
(可选)

沿树方向显示的逻辑示意图交汇点之间的间距。默认值为 2(采用逻辑示意图坐标系的单位)。此参数只能与绝对单位搭配使用。

Linear Unit
along_proportional
(可选)

沿树方向显示的逻辑示意图交汇点之间的间距。默认值为 2。此参数只能与比例单位搭配使用。

Double
breakpoint_position
(可选)

边显示类型设置为规则边(在 Python 中为 edge_display_type = "REGULAR_EDGES")或边显示类型设置为正交边(在 Python 中为 edge_display_type = "ORTHOGONAL_EDGES")时,将沿逻辑示意图边插入的中断点的相对位置。 以 0 至 100 之间的百分比来表示。

  • 当中断点相对位置 (%) 的值为 0 时,中断点位于边的自交汇点的 x 坐标,以及水平树边的至交汇点的 y 坐标。 中断点位于边的自交汇点的 y 坐标,以及垂直树边的至交汇点的 x 坐标。
  • 当中断点相对位置 (%) 的值为 100 时,即表示未在逻辑示意图边上插入任何中断点;每条逻辑示意图边直接连接其自和至交汇点。
  • 当中断点相对位置 (%) 的值为介于 0 至 100 之间的 N 时,中断点位于 [XY] 线段长度的 N%,其中 X 表示边的自交汇点的 x 坐标,Y 表示水平树边的至交汇点的 y 坐标。 中断点位于 [YX] 线段长度的 N%,其中 Y 表示边的自交汇点的 y 坐标,X 表示垂直树边的至交汇点的 x 坐标。

边显示类型设置为弯曲边(在 Python 中为 edge_display_type = "CURVED_EDGES")时,将沿逻辑示意图边插入、用于计算弯曲边几何的两个拐点的相对位置。 以 15 至 40 之间的百分比来表示。 如果中断点相对位置 (%) 值为介于 15 至 40 之间的 N:

  • X 为边的自交汇点的 x 坐标,Y 为水平树边的至交汇点的 y 坐标:
    • 第一个拐点将定位在 [XY] 线段长度的 N%。
    • 第二个拐点将定位在 [XY] 线段长度的 (100 - N)%。
  • Y 为边的自交汇点的 y 坐标,X 为垂直树边的至交汇点的 x 坐标:
    • 第一个拐点将定位在 [YX] 线段长度的 N%。
    • 第二个拐点将定位在 [XY] 线段长度的 (100 - N)%。

注:

上述自和至交汇点的概念与树方向相关;它与网络中的边要素或边对象的真实拓扑无关。

Double
edge_display_type
(可选)

指定与树分支相关的逻辑示意图边的显示类型。

  • REGULAR_EDGES与树分支相关的所有逻辑示意图边将不会显示为直角。 这是默认设置。
  • ORTHOGONAL_EDGES与树分支相关的所有逻辑示意图边将显示为直角。
  • CURVED_EDGES与树分支相关的所有逻辑示意图边将显示为曲线。
String
run_async
(可选)

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

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

此偏移用于在 is_unit_absolute = "ABSOLUTE_UNIT"edge_display_type = "ORTHOGONAL_EDGES" 时分隔重叠线段。 该值不能超过为其他间距参数指定的最小值的 10%。 默认值为 0。

Linear Unit
offset_proportional
(可选)

此偏移用于在 is_unit_absolute = "PROPORTIONAL_UNIT"edge_display_type = "ORTHOGONAL_EDGES" 时分隔重叠线段。 它是一个双精度值,不能超过为其他间距参数指定的最小值的 10%。 默认值为 0。

Double

派生输出

名称说明数据类型
out_network_diagram_layer

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

逻辑示意图图层

代码示例

ApplyMainRingLayout 示例(Python 窗口)

本示例将主环布局算法应用于名为 Temporary Diagram 的逻辑示意图。

import arcpy
arcpy.ApplyMainRingLayout_nd("Temporary Diagram", "PRESERVE_CONTAINERS", 
                             "ELLIPSE", "PROPORTIONAL_UNIT", "", 50, "", 20, 
                             "SMART_TREE", "", 2, "", 2, 25, "CURVED_EDGES", 
                             "RUN_SYNCHRONOUSLY")

环境

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

许可信息

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

相关主题