应用相对主线布局 (网络逻辑示意图)

描述

用于在活动逻辑示意图中沿平行的直线排列网络逻辑示意图要素。

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

警告:

如果您具有处于打开状态的编辑会话,则在运行此工具前,必须先保存您的编辑内容。从而确保逻辑示意图可反映对数据库中网络拓扑所做的最新更改。如果保存编辑内容失败,则编辑内容不会反映在逻辑示意图中。

注:

各布局算法均包括默认参数值。除非另行指定,否则将使用默认参数值。如果输入网络逻辑示意图基于模板且已使用其他参数值来配置此布局,则会使用该值。

使用方法

  • 在与企业级地理数据库中的公共设施网络或追踪网络数据库连接搭配使用时,系统不支持此工具。您必须使用相关的已发布公共设施网络或追踪网络服务或文件地理数据库中的公共设施网络或追踪网络。

  • 输入网络逻辑示意图图层必须来自文件地理数据库中的公共设施网络或追踪网络或者网络逻辑示意图服务。

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

  • 该算法要求网络属性在网络线类别上使用特定值,以标识组成每条直线的边并对每个边进行分类,以便在此过程中对其进行优先级排序或将其排除。

  • 可将这种布局应用于任何平行的数据参考线,即使其不适用于铁路轨道时也是如此。

  • 可以设置根标记,以指定直线开始处的交汇点的点。如果未设置根,则此算法首先会搜索与单个边连接且可被视为直线起点的交汇点。在这些交汇点候选项中,根交汇点将是最长直线的起点。

  • 当处理非常大的逻辑示意图时,请考虑在服务器上以异步模式应用布局

语法

arcpy.nd.ApplyRelativeMainlineLayout(in_network_diagram_layer, 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}, {run_async})
参数说明数据类型
in_network_diagram_layer

将应用布局的网络逻辑示意图。

Diagram Layer
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_attributeline_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 之间应用于任何边的长度(在减去其长度的最小距离后)的值。compression_ratio 为 100 时,检测的各个交汇点组之间的距离等于最小距离。

Double
minimal_distance
(可选)

两个邻近交汇点的相邻组之间的最小距离。此最小距离也用于根据邻近交汇点沿方向轴的投影将它们分组。当在该轴上投影的两个交汇点之间的距离小于此距离时,这两个交汇点将属于同一组。

Linear Unit
alignment_attribute
(可选)

用于对齐分割的线的网络属性的名称。此算法将线与相同的属性值对齐。

String
initial_distances
(可选)

用于指定如何评估逻辑示意图边的长度。此长度可确定交汇点沿这一方向的位置。已连接交汇点沿方向的距离并不相等;它们彼此相关且取决于当前边的长度和最短边的长度。

  • FROM_CURRENT_EDGE_GEOMETRY 根据当前的边几何计算距离。这是默认设置。
  • FROM_ATTRIBUTE_EDGE根据边上存在的给定属性计算距离。
String
length_attribute
(可选)

initial_distancesFROM_ATTRIBUTE_EDGE 时,将用于计算距离的网络属性。

String
run_async
(可选)

指定布局算法在服务器上将异步运行还是同步运行。

  • RUN_ASYNCHRONOUSLY布局算法将在服务器上异步运行。服务器资源可通过该选项来运行超时较长的布局算法。当执行耗时且可能导致服务器超时的布局(例如,部分重叠边)并应用于大型逻辑示意图(超过 25,000 个要素)时,建议进行异步运行。
  • RUN_SYNCHRONOUSLY布局算法将在服务器上同步运行。如果执行时超过服务超时值(默认为 600 秒),则布局算法可能失败,无法完成。这是默认设置。
Boolean

派生输出

名称说明数据类型
out_network_diagram_layer

更新的网络逻辑示意图。

逻辑示意图图层

代码示例

ApplyRelativeMainlineLayout 示例(Python 窗口)

将相对主线布局应用至名为 Temporary Diagram 的逻辑示意图。

import arcpy
arcpy.ApplyRelativeMainlineLayout_nd("Temporary Diagram", "LineTrack", 
                                  "FROM_LEFT_RIGHT", 2, 45, "RUN_SYNCHRONOUSLY")

环境

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

许可信息

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

相关主题