描述
用于对主环周围的网络逻辑示意图中的逻辑示意图要素进行排列。
警告：
如果您具有处于打开状态的编辑会话，则在运行此工具前，必须先保存您的编辑内容。从而确保逻辑示意图可反映对数据库中网络拓扑所做的最新更改。如果保存编辑内容失败，则编辑内容不会反映在逻辑示意图中。
注：
各布局算法均包括默认参数值。除非另行指定，否则将使用默认参数值。如果输入网络逻辑示意图基于模板且已使用其他参数值来配置此布局，则会使用该值。
使用方法
在与企业级地理数据库中的 utility network 数据库连接搭配使用时，系统不支持此工具。您必须使用相关的已发布 utility network 服务或文件地理数据库中的 utility network or trace network。
输入网络逻辑示意图图层必须来自文件地理数据库中的 utility network or trace network 或网络逻辑示意图服务。
此布局算法用于在主环周围排列逻辑示意图要素，并对连接到沿主环放置的每个逻辑示意图交汇点的逻辑示意图要素子集进行等级布局。
主环是网络逻辑示意图中边数最多的环。
如果网络逻辑示意图中不包含环，则执行“主环”布局算法不会产生任何效果。
此布局算法通常应用于电信行业。
如果在逻辑示意图要素上指定了障碍，则主环布局算法会识别将排除这些标记要素的主环。
当处理非常大的逻辑示意图时，请考虑在服务器上以异步模式应用布局。
语法
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 （可选） | 指定算法将如何处理容器。
| Boolean |
ring_type （可选） | 指定环的类型。
| String |
is_unit_absolute （可选） | 指定将如何解释表示距离的参数。
| Boolean |
ring_width_absolute （可选） | 环的宽度。默认值为逻辑示意图坐标系中的单位。此参数只能与绝对单位搭配使用。 | Linear Unit |
ring_width_proportional （可选） | 环的宽度。默认值为 50。此参数只能与比例单位搭配使用。 | Double |
ring_height_absolute （可选） | 环的高度。默认值为逻辑示意图坐标系中的单位。此参数只能与绝对单位搭配使用。 | Linear Unit |
ring_height_proportional （可选） | 环的高度。默认值为 20。此参数只能与比例单位搭配使用。 | Double |
tree_type （可选） | 用于指定如何定位来自主环交汇点的树。
| 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 之间的百分比来表示。
当边显示类型为弯曲边（在 Python 中为 edge_display_type = "CURVED_EDGES"）时，将沿逻辑示意图边插入、用于计算弯曲边几何的两个拐点的相对位置。以 15 至 40 之间的百分比来表示。如果中断点相对位置 (%) 值为介于 15 至 40 之间的 N：
注：上述自和至交汇点的概念与树方向相关；它与网络中的边要素或边对象的真实拓扑无关。 | Double |
edge_display_type （可选） | 指定与树分支相关的逻辑示意图边的显示类型。
| String |
run_async （可选） | 指定布局算法在服务器上将异步运行还是同步运行。
| 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 | 更新的网络逻辑示意图图层。 | 逻辑示意图图层 |
代码示例
本示例将主环布局算法应用于名为 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: 是