描述
用于将“相对主线布局”算法添加到基于给定模板构建逻辑示意图结束时自动进行链接的布局列表。此工具还会针对基于该模板的任意逻辑示意图预设“相对主线布局”算法参数。
此布局将在活动逻辑示意图中沿平行的直线排列网络逻辑示意图要素，其中所有连接的边都具有相同的属性值。还将放置源自这些线的分支，使它们相对于直线的方向以及相对于原始距离的比例和两者的关系保持不变。
警告：
该工具为配置和管理工具。
注：
该工具会基于输入逻辑示意图模板影响任何现有逻辑示意图的一致性。所有现有逻辑示意图都将变得不一致，并随附打开一致性警告图标 
，直至对其进行更新为止。
使用方法
系统在使用公共设施网络或追踪网络服务时不支持此工具。您必须使用文件地理数据库中的公共设施网络或追踪网络，或者企业级地理数据库中公共设施网络或追踪网络的数据库连接。使用企业级地理数据库时，需要满足以下要求：
- 输入网络参数值必须来自作为数据库公共设施网络所有者或数据库追踪网络所有者建立的数据库连接。
- 连接的 ArcGIS Enterprise 门户帐户必须为门户公共设施网络所有者或门户追踪网络所有者。
- 该工具必须连接到预期为公开且不受保护的默认版本。
要基于逻辑示意图模板对任何逻辑示意图预设布局算法参数，请取消选中激活参数（Python 中为 is_active = "INACTIVE"）。
如果您想要将布局算法添加到基于输入逻辑示意图模板生成逻辑示意图结束时自动进行链接的布局列表，请在激活处于选中状态（默认）（Python 中为 is_active = "ACTIVE"）的情况下运行此工具。
语法
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 | 指定是否将在基于指定模板生成逻辑示意图时自动执行布局算法。
| Boolean |
line_attribute | 用于标识构成直线的线的网络属性的名称。此网络属性必须存在于网络线类中。对于构成直线（例如线 1、线 2 等等）的所有边，其值都必须相同。 | String |
mainline_direction （可选） | 指定主线的方向。
| 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 （可选） | 指定是否压缩图形。
| Boolean |
compression_ratio （可选） | 0 和 100 之间应用于任何边的长度（在减去其长度的最小距离后）的值。compression_ratio 为 100 时，检测的各个交汇点组之间的距离等于最小距离。 | Double |
minimal_distance （可选） | 两个邻近交汇点的相邻组之间的最小距离。此最小距离也用于根据邻近交汇点沿方向轴的投影将它们分组。当在该轴上投影的两个交汇点之间的距离小于此距离时，这两个交汇点将属于同一组。 | Linear Unit |
alignment_attribute （可选） | 用于对齐分割的线的网络属性的名称。此算法将线与相同的属性值对齐。 | String |
initial_distances （可选） | 用于指定如何评估逻辑示意图边的长度。此长度可确定交汇点沿这一方向的位置。已连接交汇点沿方向的距离并不相等；它们彼此相关且取决于当前边的长度和最短边的长度。
| String |
length_attribute （可选） | 当 initial_distances 为 FROM_ATTRIBUTE_EDGE 时，将用于计算距离的网络属性。 | String |
派生输出
| 名称 | 说明 | 数据类型 |
| out_utility_network | 已更新的 公共设施网络或追踪网络。 | 公共设施网络；追踪网络 |
| out_template_name | 逻辑示意图模板的名称。 | 字符串 |
代码示例
将“相对主线布局”作为自动布局添加到与输入网络相关的 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: 是