描述
用于按等级排列逻辑示意图要素并将其置于智能树中。
警告:
如果您具有处于打开状态的编辑会话,则在运行此工具前,必须先保存您的编辑内容。从而确保逻辑示意图可反映对数据库中网络拓扑所做的最新更改。如果保存编辑内容失败,则编辑内容不会反映在逻辑示意图中。
注:
各布局算法均包括默认参数值。除非另行指定,否则将使用默认参数值。如果输入网络逻辑示意图基于模板且已使用其他参数值来配置此布局,则会使用该值。
使用方法
在与企业级地理数据库中的公共设施网络或追踪网络数据库连接搭配使用时,系统不支持此工具。您必须使用相关的已发布公共设施网络或追踪网络服务或文件地理数据库中的公共设施网络或追踪网络。
输入网络逻辑示意图图层必须来自文件地理数据库中的公共设施网络或追踪网络或者网络逻辑示意图服务。
此布局算法会对逻辑示意图要素进行等级排列,并根据指定的方向和间距将它们置于智能树中。
如果在逻辑示意图中指定根交汇点,则智能树布局算法将构建从交汇点开始的智能树。
如果在逻辑示意图中指定多个根交汇点,则这些根交汇点沿垂直于树方向的同一个轴对齐,并显示为逻辑示意图树分支的不同起始点。
如果未指定根交汇点,则算法将识别与最小网络拓扑索引关联的逻辑示意图交汇点,并将此交汇点用作根交汇点。
当处理非常大的逻辑示意图时,请考虑在服务器上以异步模式应用布局。
语法
arcpy.nd.ApplySmartTreeLayout(in_network_diagram_layer, {are_containers_preserved}, {tree_direction}, {is_unit_absolute}, {subtree_absolute}, {subtree_proportional}, {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 |
is_unit_absolute (可选) | 指定将如何解释表示距离的参数。
| Boolean |
subtree_absolute (可选) | 两个相邻子树之间的间距 - 即,垂直于智能树方向显示并且属于不同子树的逻辑示意图交汇点之间的间距。默认值为逻辑示意图坐标系中的单位。此参数只能与绝对单位搭配使用。 | Linear Unit |
subtree_proportional (可选) | 两个相邻子树之间的间距 - 即,垂直于智能树方向显示并且属于不同子树的逻辑示意图交汇点之间的间距。默认值为 2。此参数只能与比例单位搭配使用。 | Double |
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.ApplySmartTreeLayout_nd("Temporary Diagram", "PRESERVE_CONTAINERS",
"FROM_LEFT_TO_RIGHT", "PROPORTIONAL_UNIT",
"", 8, "", 5, "", 5, "", 15, "", 70,
"REGULAR_EDGES", "RUN_SYNCHRONOUSLY")
环境
许可信息
- Basic: 否
- Standard: 是
- Advanced: 是