添加径向树布局 (网络逻辑示意图)

描述

用于将“径向树布局”算法添加到基于给定模板构建逻辑示意图结束时自动进行链接的布局列表。此工具还会针对基于该模板的任意逻辑示意图预设“径向树布局”算法参数。

此布局算法会对逻辑示意图要素进行等级排列，并根据指定的半径参数将它们置于径向树中。此算法需有一个用作圆心的根交汇点，从此根交汇点开始围绕同心圆（每个圆对应一个级别）排列子树。

了解有关径向树布局算法的详细信息

警告：

该工具为配置和管理工具。

注：

该工具会基于输入逻辑示意图模板影响任何现有逻辑示意图的一致性。所有现有逻辑示意图都将变得不一致，并随附打开一致性警告图标 ，直至对其进行更新为止。

使用方法

• 系统在使用公共设施网络或追踪网络服务时不支持此工具。您必须使用文件地理数据库中的公共设施网络或追踪网络，或者企业级地理数据库中公共设施网络或追踪网络的数据库连接。使用企业级地理数据库时，需要满足以下要求：

  • 输入网络参数值必须来自作为数据库公共设施网络所有者或数据库追踪网络所有者建立的数据库连接。
  • 连接的 ArcGIS Enterprise 门户帐户必须为门户公共设施网络所有者或门户追踪网络所有者。
  • 该工具必须连接到预期为公开且不受保护的默认版本。

• 要基于逻辑示意图模板对任何逻辑示意图预设布局算法参数，请取消选中激活参数（Python 中为 is_active = "INACTIVE"）。

• 如果您想要将布局算法添加到基于输入逻辑示意图模板生成逻辑示意图结束时自动进行链接的布局列表，请在激活处于选中状态（默认）（Python 中为 is_active = "ACTIVE"）的情况下运行此工具。

语法

arcpy.nd.AddRadialTreeLayout(in_utility_network, template_name, is_active, {are_containers_preserved}, {is_unit_absolute}, {initial_radius_absolute}, {initial_radius_proportional}, {disjoined_graph_absolute}, {disjoined_graph_proportional}, {radius_factor})

参数	说明	数据类型
in_utility_network	包含要修改的逻辑示意图模板的公共设施网络或追踪网络。	Utility Network; Trace Network
template_name	要修改的逻辑示意图模板的名称。	String
is_active	指定是否将在基于指定模板生成逻辑示意图时自动执行布局算法。 ACTIVE —添加的布局算法将在基于 template_name 参数生成任何逻辑示意图的过程中自动运行。这是默认设置。为布局算法指定的参数值是在生成逻辑示意图的过程中用于运行布局的参数值。如果要对基于输入模板的任何逻辑示意图运行此算法，则还会默认加载这些参数值。 INACTIVE —如果要对基于输入模板的任何逻辑示意图运行此算法，则还将默认加载当前为添加的布局逻辑示意图指定的所有参数值。	Boolean
are_containers_preserved （可选）	指定算法将如何处理容器。 PRESERVE_CONTAINERS — 将对逻辑示意图的上方图执行布局算法，以保留容器。 IGNORE_CONTAINERS —将对逻辑示意图中的内容要素和非内容要素执行布局算法。这是默认设置。	Boolean
is_unit_absolute （可选）	指定将如何解释表示距离的参数。 ABSOLUTE_UNIT —布局算法会按线性单位来解释任意距离值。 PROPORTIONAL_UNIT —布局算法会将所有距离值解释为当前逻辑示意图范围内交汇点大小的估算平均值的相对单位。这是默认设置。	Boolean
initial_radius_absolute （可选）	圆心为径向树根交汇点的第一个同心圆的半径；即，放置属于第一个级别的逻辑示意图交汇点的圆的半径。默认值为 5（采用逻辑示意图坐标系的单位）。此参数只能与绝对单位搭配使用。	Linear Unit
initial_radius_proportional （可选）	圆心为径向树根交汇点的第一个同心圆的半径；即，放置属于第一个级别的逻辑示意图交汇点的圆的半径。默认值为 5。此参数只能与比例单位搭配使用。	Double
disjoined_graph_absolute （可选）	当逻辑示意图包含不相交图形时，属于此类图形的要素之间的最小间距。此参数与绝对单位搭配使用。默认值为 4（采用逻辑示意图坐标系的单位）。	Linear Unit
disjoined_graph_proportional （可选）	当逻辑示意图包含不相交图形时，属于此类图形的要素之间的最小间距。此参数与比例单位搭配使用。默认值为 4。	Double
radius_factor （可选）	用来增大或减小每个同心圆半径的倍乘系数。还表示分隔各级别同心圆的距离。如果使用的半径系数小于 1，则用来分隔级别 (n) 与级别 (n+1) 逻辑示意图交汇点的距离会逐渐减小。如果该系数大于 1，则不同级别间的距离会逐渐增大。默认值为 1。	Double

派生输出

名称	说明	数据类型
out_utility_network	已更新的 公共设施网络或追踪网络。	公共设施网络；追踪网络
out_template_name	逻辑示意图模板的名称。	字符串

代码示例

AddRadialTreeLayout 示例（Python 窗口）

将径向树布局算法作为自动布局添加到给定网络现有的 MyTemplate1 模板

import arcpy
input_Network = "D:/MyProjectLocation/MyDatabaseConnection.sde/MyDatabase.MAP.Electric/MyDatabase.MAP.Electric"
input_DiagramTemplate = "MyTemplate1"
arcpy.AddRadialTreeLayout_nd(input_Network, input_DiagramTemplate, "ACTIVE", 
                             "PRESERVE_CONTAINERS", "ABSOLUTE_UNIT", 5, "", 15, "", 1)

环境

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

许可信息

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