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

摘要

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

此布局算法将在活动逻辑示意图中沿平行的直线排列网络逻辑示意图要素，其中所有连接的边都具有相同的属性值。 还将放置源自这些线的分支，使它们相对于直线的方向以及相对于原始距离的比例和两者的关系保持不变。

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

警告：

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

注：

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

使用情况

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

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

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

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

参数

对话框

标注	说明	数据类型
输入网络	包含要修改的逻辑示意图模板的公共设施网络或追踪网络。	Utility Network; Trace Network
输入逻辑示意图模板	要修改的逻辑示意图模板名称	String
激活	指定是否将在基于指定模板生成逻辑示意图时自动运行布局算法。 选中 - 添加的布局算法会在基于输入逻辑示意图模板参数值生成任何逻辑示意图的过程中自动运行。 这是默认设置。 为布局算法指定的参数值是在生成逻辑示意图的过程中用于运行布局的参数值。 如果要对基于输入模板的任何逻辑示意图运行此算法，则还会默认加载这些参数值。 未选中 - 如果要对基于输入模板的任何逻辑示意图运行此算法，则还将默认加载当前为添加的布局逻辑示意图指定的所有参数值。	Boolean
线属性	用于标识构成直线的线的网络属性的名称。 此网络属性必须存在于网络线类中。 对于构成直线（例如线 1、线 2 等等）的所有边，其值都必须相同。	String
方向 (可选)	指定主线的方向。 从左到右—主线将绘制为从左侧开始并于右侧终止的水平线。 这是默认设置。 从上到下—主线将绘制为从顶部开始并于底部终止的垂直线。	String
分支间的偏移量 (可选)	两个相邻分支沿垂直于线方向的轴之间的间距。	Linear Unit
中断点角度（单位为度） (可选)	用于在分支上定位中断点的角度。 该值介于 30 度和 90 度之间，与分支间的偏移量参数值结合使用可计算出这个位置。 中断点角度值为 90 度时，将正交显示每个分支。	Double
类型属性 (可选)	用于限定线的网络属性的名称。 此网络属性可能存在于网络线类中。 注： 类型属性和线属性参数值可以是相同的。	String
主线值 (可选)	用于标识主线的类型属性值。 如果存在这样的值，则无论主线相关网络要素线类或边对象表为何，对于构成主线的任何边而言，该值都必须是相同的。	Value Table
分支值 (可选)	用于标识分支的类型属性值。	Value Table
排除的值 (可选)	用于标识边的类型属性值将从直线（交线或梯形线）中排除。	Value Table
沿该方向压缩 (可选)	指定是否压缩图形。 选中 - 将使用压缩。 在处理结束后将运行一个附加步骤，用于缩短邻近交汇点的相邻组之间沿该方向的距离，同时还保持这些组之间的相对定位。 邻近交汇点是指地理位置彼此靠近但没有直接连接的交汇点。 未选中 - 不使用压缩。 这是默认设置。	Boolean
比率 (%) (可选)	0 和 100 之间应用于任何边的长度（在减去其长度的最小距离后）的值。 当值为 100 时，检测的各个交汇点组之间的距离等于最小距离。	Double
最小距离 (可选)	两个邻近交汇点的相邻组之间的最小距离。 此最小距离也用于根据邻近交汇点沿方向轴的投影将它们分组。 当在该轴上投影的两个交汇点之间的距离小于此距离时，这两个交汇点将属于同一组。	Linear Unit
对齐属性 (可选)	用于对齐分割的线的网络属性的名称。 将线与相同的属性值对齐。	String
初始距离 (可选)	用于指定如何评估逻辑示意图边的长度。 此长度可确定交汇点沿这一方向的位置。 已连接交汇点沿方向的距离并不相等；它们彼此相关且取决于当前边的长度和最短边的长度。 根据当前边几何—根据当前的边几何计算距离。 这是默认设置。 根据属性边—根据边上存在的给定属性计算距离。	String
长度属性 (可选)	当初始距离为根据属性边时，将用于计算距离的网络属性。	String

派生输出

标注	说明	数据类型
输出网络	已更新的 utility network or trace network。	公共设施网络；追踪网络
输出逻辑示意图模板	逻辑示意图模板的名称。	字符串

Python

arcpy.nd.AddRelativeMainlineLayout(in_utility_network, template_name, is_active, line_attribute, {mainline_direction}, {offset_between_branches}, {breakpoint_angle}, {type_attribute}, {mainline_values}, {branch_values}, {excluded_values}, {is_compressing}, {compression_ratio}, {minimal_distance}, {alignment_attribute}, {initial_distances}, {length_attribute})

名称	说明	数据类型
in_utility_network	包含要修改的逻辑示意图模板的公共设施网络或追踪网络。	Utility Network; Trace Network
template_name	要修改的逻辑示意图模板名称	String
is_active	指定是否将在基于指定模板生成逻辑示意图时自动运行布局算法。 ACTIVE—添加的布局算法将在基于 template_name 参数值生成任何逻辑示意图的过程中自动运行。 这是默认设置。为布局算法指定的参数值是在生成逻辑示意图的过程中用于运行布局的参数值。 如果要对基于输入模板的任何逻辑示意图运行此算法，则还会默认加载这些参数值。 INACTIVE—如果要对基于输入模板的任何逻辑示意图运行此算法，则还将默认加载当前为添加的布局逻辑示意图指定的所有参数值。	Boolean
line_attribute	用于标识构成直线的线的网络属性的名称。 此网络属性必须存在于网络线类中。 对于构成直线（例如线 1、线 2 等等）的所有边，其值都必须相同。	String
mainline_direction (可选)	指定主线的方向。 FROM_LEFT_TO_RIGHT—主线将绘制为从左侧开始并于右侧终止的水平线。 这是默认设置。 FROM_TOP_TO_BOTTOM—主线将绘制为从顶部开始并于底部终止的垂直线。	String
offset_between_branches (可选)	两个相邻分支沿垂直于线方向的轴之间的间距。	Linear Unit
breakpoint_angle (可选)	用于在分支上定位中断点的角度。 该值在 30 度到 90 度之间，与 offset_between_branches 参数值结合使用可计算出这个位置。 中断点角度值为 90 度时，将正交显示每个分支。	Double
type_attribute (可选)	用于限定线的网络属性的名称。 此网络属性可能存在于网络线类中。 注： type_attribute 和 line_attribute 参数值可以是相同的。	String
mainline_values [mainline_values,...] (可选)	用于标识主线的 type_attribute 值。 如果存在这样的值，则无论主线相关网络要素线类或边对象表为何，对于构成主线的任何边而言，该值都必须是相同的。	Value Table
branch_values [branch_values,...] (可选)	用于标识分支的 type_attribute 值。	Value Table
excluded_values [excluded_values,...] (可选)	用于标识边的 type_attribute 值将从直线（交线或梯形线）中排除。	Value Table
is_compressing (可选)	指定是否压缩图形。 USE_COMPRESSION—将使用压缩。 在处理结束后将运行一个附加步骤，用于缩短邻近交汇点的相邻组之间沿该方向的距离，同时还保持这些组之间的相对定位。 邻近交汇点是指地理位置彼此靠近但没有直接连接的交汇点。 DO_NOT_USE_COMPRESSION—不使用压缩。 这是默认设置。	Boolean
compression_ratio (可选)	0 和 100 之间应用于任何边的长度（在减去其长度的最小距离后）的值。 当值为 100 时，检测的各个交汇点组之间的距离等于最小距离。	Double
minimal_distance (可选)	两个邻近交汇点的相邻组之间的最小距离。 此最小距离也用于根据邻近交汇点沿方向轴的投影将它们分组。 当在该轴上投影的两个交汇点之间的距离小于此距离时，这两个交汇点将属于同一组。	Linear Unit
alignment_attribute (可选)	用于对齐分割的线的网络属性的名称。 将线与相同的属性值对齐。	String
initial_distances (可选)	用于指定如何评估逻辑示意图边的长度。 此长度可确定交汇点沿这一方向的位置。 已连接交汇点沿方向的距离并不相等；它们彼此相关且取决于当前边的长度和最短边的长度。 FROM_CURRENT_EDGE_GEOMETRY—根据当前的边几何计算距离。 这是默认设置。 FROM_ATTRIBUTE_EDGE—根据边上存在的给定属性计算距离。	String
length_attribute (可选)	当 initial_distances 为 FROM_ATTRIBUTE_EDGE 时，将用于计算距离的网络属性。	String

派生输出

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

代码示例

AddRelativeMainlineLayout 示例（Python 窗口）

将“相对主线布局”作为自动布局添加到与输入网络相关的 MyTemplate1 模板。

import arcpy
input_Network = "D:/MyProjectLocation/MyDatabaseConnection.sde/MyDatabase.MAP.Electric/MyDatabase.MAP.Electric"
input_DiagramTemplate = "MyTemplate1"
arcpy.AddRelativeMainlineLayout_nd(input_Network, input_DiagramTemplate, 
                               "ACTIVE", "LineTrack",
                               "FROM_LEFT_RIGHT", 2, 45)

环境

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

许可信息

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