描述
用于沿主线按等级排列逻辑示意图交汇点和边。
警告：
如果您具有处于打开状态的编辑会话，则在运行此工具前，必须先保存您的编辑内容。从而确保逻辑示意图可反映对数据库中网络拓扑所做的最新更改。如果保存编辑内容失败，则编辑内容不会反映在逻辑示意图中。
注：
各布局算法均包括默认参数值。除非另行指定，否则将使用默认参数值。如果输入网络逻辑示意图基于模板且已使用其他参数值来配置此布局，则会使用该值。
使用方法
在与企业级地理数据库中的公共设施网络或追踪网络数据库连接搭配使用时，系统不支持此工具。您必须使用相关的已发布公共设施网络或追踪网络服务或文件地理数据库中的公共设施网络或追踪网络。
输入网络逻辑示意图图层必须来自文件地理数据库中的公共设施网络或追踪网络或者网络逻辑示意图服务。
此布局算法会沿主线对输入网络逻辑示意图中的交汇点和边进行等级排列，并将其相关分支置于该主线的左侧、右侧或两侧。
可在逻辑示意图中指定根交汇点和端交汇点，这样“主线树”布局算法将构建以指定的根交汇点开始且以指定的端交汇点结束的主线。
- 默认情况下，如果未指定根交汇点和端交汇点，则算法将识别与最小网络拓扑索引相关联的逻辑示意图交汇点。从表示根的此交汇点开始，算法将搜索包含最多边数的线：主线。
- 如果设置了根交汇点，则主线为从该根交汇点开始且包含最多边数的分支之一。
- 如果指定了根交汇点和端交汇点，并且在根交汇点和端交汇点之间存在一条路径，则主线为以该根交汇点开始、以端交汇点结束且具有最多逻辑示意图边的分支。
如果网络逻辑示意图由多个断开连接的逻辑示意图部分组成，则可以定义多个根交汇点和端交汇点，例如，每个逻辑示意图部分一个根交汇点和端交汇点。
也可以指定同一个相连逻辑示意图部分的多个交汇点作为根。这些交汇点沿垂直于树方向的同一个轴对齐，并显示为逻辑示意图树分支的不同起始点。对于端交汇点来说，尽管可以在同一个相连的逻辑示意图部分中指定多个端交汇点，但是系统只将其中一个识别为端交汇点。
如果指定了端交汇点，但未指定根交汇点，则会忽略此端交汇点。
当处理非常大的逻辑示意图时，请考虑在服务器上以异步模式应用布局。
语法
arcpy.nd.ApplyMainlineTreeLayout(in_network_diagram_layer, {are_containers_preserved}, {tree_direction}, {branches_placement}, {is_unit_absolute}, {perpendicular_absolute}, {perpendicular_proportional}, {along_absolute}, {along_proportional}, {disjoined_graph_absolute}, {disjoined_graph_proportional}, {are_edges_orthogonal}, {breakpoint_position}, {edge_display_type}, {run_async}, {offset_absolute}, {offset_proportional})| 参数 | 说明 | 数据类型 |
in_network_diagram_layer | 将应用布局的网络逻辑示意图。 | Diagram Layer |
are_containers_preserved （可选） | 指定算法将如何处理容器。
| Boolean |
tree_direction （可选） | 指定主线的方向。
| String |
branches_placement （可选） | 用于指定将如何针对主线分支的方向来相对放置主线分支。
| String |
is_unit_absolute （可选） | 指定将如何解释表示距离的参数。
| Boolean |
perpendicular_absolute （可选） | 沿垂直于主线的轴显示的逻辑示意图交汇点之间的间距。默认值为 2（采用逻辑示意图坐标系）。此参数只能与绝对单位搭配使用。 | Linear Unit |
perpendicular_proportional （可选） | 沿垂直于主线的轴显示的逻辑示意图交汇点之间的间距。默认值为 2。此参数只能与比例单位搭配使用。 | Double |
along_absolute （可选） | 沿主线显示的逻辑示意图交汇点之间的间距以及沿平行于此主线的轴显示的逻辑示意图交汇点之间的间距。此参数只能与绝对单位搭配使用。默认值为 2（采用逻辑示意图坐标系的单位）。 | Linear Unit |
along_proportional （可选） | 沿主线显示的逻辑示意图交汇点之间的间距以及沿平行于此主线的轴显示的逻辑示意图交汇点之间的间距。此参数与比例单位搭配使用。默认值为 2。 | Double |
disjoined_graph_absolute （可选） | 当逻辑示意图包含不相交图形时，属于此类图形的要素之间的最小间距。此参数与绝对单位搭配使用。默认值为 4（采用逻辑示意图坐标系的单位）。 | Linear Unit |
disjoined_graph_proportional （可选） | 当逻辑示意图包含不相交图形时，属于此类图形的要素之间的最小间距。此参数与比例单位搭配使用。默认值为 4。 | Double |
are_edges_orthogonal （可选） | 指定将如何显示与树分支相关的逻辑示意图边。 旧版本：此参数已在 ArcGIS Pro 2.7 中弃用。如果指定了 edge_display_type 参数，则无论其值是多少，都会被系统忽略。但是，为了保持与 ArcGIS Pro 2.1 的兼容性，如果未指定 edge_display_type 参数，则其将保持启用状态。
| Boolean |
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.ApplyMainlineTreeLayout_nd("Temporary Diagram", "PRESERVE_CONTAINERS",
"FROM_LEFT_TO_RIGHT", "BOTH_SIDES",
"ABSOLUTE_UNIT", "100 Feet", "" , "100 Feet",
"", "200 Feet", "", "", 30, "ORTHOGONAL_EDGES",
"RUN_SYNCHRONOUSLY", "10 Feet", "")环境
许可信息
- Basic: 否
- Standard: 是
- Advanced: 是