添加主线树布局 (网络逻辑示意图)

摘要

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

此布局算法会沿主线对输入网络逻辑示意图中的交汇点和边进行等级排列,并将其相关分支置于该主线的左侧、右侧或两侧。

了解有关主线树布局算法的详细信息

警告:

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

注:

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

使用情况

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

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

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

参数

标注说明数据类型
输入网络

包含要修改的逻辑示意图模板的公共设施网络或追踪网络。

Utility Network; Trace Network
输入逻辑示意图模板

要修改的逻辑示意图模板名称

String
激活

指定是否将在基于指定模板生成逻辑示意图时自动运行布局算法。

  • 选中 - 添加的布局算法会在基于输入逻辑示意图模板参数值生成任何逻辑示意图的过程中自动运行。 这是默认设置。

    为布局算法指定的参数值是在生成逻辑示意图的过程中用于运行布局的参数值。 如果要对基于输入模板的任何逻辑示意图运行此算法,则还会默认加载这些参数值。

  • 未选中 - 如果要对基于输入模板的任何逻辑示意图运行此算法,则还将默认加载当前为添加的布局逻辑示意图指定的所有参数值。

Boolean
保留容器布局
(可选)

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

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

Boolean
树方向
(可选)

指定主线的方向。

  • 从左到右主线将绘制为从左侧开始并于右侧终止的水平线。这是默认设置。
  • 从右到左主线将绘制为从右侧开始并于左侧终止的水平线。
  • 从下到上主线将绘制为从底部开始并于顶部终止的垂直线。
  • 从上到下主线将绘制为从顶部开始并于底部终止的垂直线。
String
分支放置
(可选)

用于指定将如何针对主线分支的方向来相对放置主线分支。

  • 两侧分支将放置在主线的左右两侧。这是默认设置。
  • 左侧分支将只能放置在主线的左侧。
  • 右侧分支将只能放置在主线的右侧。
String
间距值解释为逻辑示意图坐标系中的绝对单位
(可选)

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

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

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

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

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

沿垂直于主线的轴显示的逻辑示意图交汇点之间的间距。默认值为 2。此参数只能与比例单位搭配使用。

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

沿主线显示的逻辑示意图交汇点之间的间距以及沿平行于此主线的轴显示的逻辑示意图交汇点之间的间距。此参数只能与绝对单位搭配使用。默认值为 2(采用逻辑示意图坐标系的单位)。

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

沿主线显示的逻辑示意图交汇点之间的间距以及沿平行于此主线的轴显示的逻辑示意图交汇点之间的间距。此参数与比例单位搭配使用。默认值为 2。

Double
不相交图形之间
(可选)

当逻辑示意图包含不相交图形时,属于此类图形的要素之间的最小间距。 此参数与绝对单位搭配使用。 默认值为逻辑示意图坐标系中的 4 个单位。

Linear Unit
不相交图形之间
(可选)

当逻辑示意图包含不相交图形时,属于此类图形的要素之间的最小间距。 此参数与比例单位搭配使用。 默认值为 4。

Double
正交显示的边
(可选)
Boolean
中断点相对位置 (%)
(可选)

边显示类型设置为规则边(在 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
绝对偏移
(可选)

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

Linear Unit
比例偏移
(可选)

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

Double

派生输出

标注说明数据类型
输出网络

已更新的 utility network or trace network

公共设施网络;追踪网络
输出逻辑示意图模板

逻辑示意图模板的名称。

字符串

arcpy.nd.AddMainlineTreeLayout(in_utility_network, template_name, is_active, {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}, {offset_absolute}, {offset_proportional})
名称说明数据类型
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
tree_direction
(可选)

指定主线的方向。

  • FROM_LEFT_TO_RIGHT主线将绘制为从左侧开始并于右侧终止的水平线。这是默认设置。
  • FROM_RIGHT_TO_LEFT主线将绘制为从右侧开始并于左侧终止的水平线。
  • FROM_BOTTOM_TO_TOP主线将绘制为从底部开始并于顶部终止的垂直线。
  • FROM_TOP_TO_BOTTOM主线将绘制为从顶部开始并于底部终止的垂直线。
String
branches_placement
(可选)

用于指定将如何针对主线分支的方向来相对放置主线分支。

  • BOTH_SIDES分支将放置在主线的左右两侧。这是默认设置。
  • LEFT_SIDE分支将只能放置在主线的左侧。
  • RIGHT_SIDE分支将只能放置在主线的右侧。
String
is_unit_absolute
(可选)

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

  • ABSOLUTE_UNIT布局算法会按线性单位来解释距离值。
  • PROPORTIONAL_UNIT布局算法会将距离值解释为当前逻辑示意图范围内交汇点大小的估算平均值的相对单位。 这是默认设置。
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 3.2 中弃用。 如果指定了 edge_display_type 参数,则无论其值是多少,都会被系统忽略。 但是,为了保持与 ArcGIS Pro 2.1 的兼容性,如果未指定 edge_display_type 参数,则其将保持启用状态。

  • ORTHOGONAL_EDGES与树分支相关的所有逻辑示意图边将显示为直角。
  • SLANTED_EDGES与树分支相关的所有逻辑示意图边将不会显示为直角。 这是默认设置。
Boolean
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
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_utility_network

已更新的 utility network or trace network

公共设施网络;追踪网络
out_template_name

逻辑示意图模板的名称。

字符串

代码示例

AddMainLineTreeLayout 示例(Python 窗口)

此示例可将“主线树布局”算法作为自动布局添加到给定网络中的 MyTemplate1 模板。

import arcpy
input_Network = "D:/MyProjectLocation/MyDatabaseConnection.sde/MyDatabase.MAP.Electric/MyDatabase.MAP.Electric"
input_DiagramTemplate = "MyTemplate1"
arcpy.AddMainlineTreeLayout_nd(input_Network, input_DiagramTemplate, 
                               "ACTIVE", "PRESERVE_CONTAINERS", 
                               "FROM_LEFT_TO_RIGHT", "BOTH_SIDES", 
                               "ABSOLUTE_UNIT", "100 Feet", "", "100 Feet", "", 
                               "200 Feet", "", "", 30, "ORTHOGONAL_EDGES", 
                               "10 Feet")

环境

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

许可信息

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

相关主题