描述
用于将线性分派布局算法添加到基于给定模板构建逻辑示意图结束时自动进行链接的布局列表。此工具还会针对基于该模板的任意逻辑示意图预设线性分派布局算法参数。
此布局算法可用于在看起来过于紧密、重叠或重合的逻辑示意图交汇点之间添加空间。该算法会沿连接边移动交汇点。这种沿边的移动是基于交汇点的当前和相对位置以及布局参数实现的。
警告：
该工具为配置和管理工具。
注：
该工具会基于输入逻辑示意图模板影响任何现有逻辑示意图的一致性。所有现有逻辑示意图都将变得不一致，并随附打开一致性警告图标 
，直至对其进行更新为止。
使用方法
系统在使用公共设施网络或追踪网络服务时不支持此工具。您必须使用文件地理数据库中的公共设施网络或追踪网络，或者企业级地理数据库中公共设施网络或追踪网络的数据库连接。使用企业级地理数据库时，需要满足以下要求：
- 输入网络参数值必须来自作为数据库公共设施网络所有者或数据库追踪网络所有者建立的数据库连接。
- 连接的 ArcGIS Enterprise 门户帐户必须为门户公共设施网络所有者或门户追踪网络所有者。
- 该工具必须连接到预期为公开且不受保护的默认版本。
要基于逻辑示意图模板对任何逻辑示意图预设布局算法参数，请取消选中激活参数（Python 中为 is_active = "INACTIVE"）。
如果您想要将布局算法添加到基于输入逻辑示意图模板生成逻辑示意图结束时自动进行链接的布局列表，请在激活处于选中状态（默认）（Python 中为 is_active = "ACTIVE"）的情况下运行此工具。
语法
arcpy.nd.AddLinearDispatchLayout(in_utility_network, template_name, is_active, {junction_placement_type}, {is_unit_absolute}, {maximum_shift_absolute}, {maximum_shift_proportional}, {minimum_shift_absolute}, {minimum_shift_proportional}, {iterations_number}, {is_path_preserved}, {are_leaves_moved}, {are_leaves_expanded}, {expand_shift_absolute}, {expand_shift_proportional})| 参数 | 说明 | 数据类型 |
in_utility_network | 包含要修改的逻辑示意图模板的公共设施网络或追踪网络。 | Utility Network; Trace Network |
template_name | 要修改的逻辑示意图模板的名称。 | String |
is_active | 指定是否将在基于指定模板生成逻辑示意图时自动执行布局算法。
| Boolean |
junction_placement_type （可选） | 指定交汇点的移动方式。
| String |
is_unit_absolute （可选） | 指定将如何解释表示距离的参数。
| Boolean |
maximum_shift_absolute （可选） | 具有两个连接的交汇点与其连接的交汇点间隔的最大距离。默认值为 2（采用逻辑示意图坐标系的单位）。达到此距离后，后续迭代过程中将不再移动交汇点。此参数只能与 ITERATIVE_DISTANCE 交汇点放置类型和绝对单位一起使用。 | Linear Unit |
maximum_shift_proportional （可选） | 具有两个连接的交汇点与其连接的交汇点间隔的最大距离。默认值为 2。达到此距离后，后续迭代过程中将不再移动交汇点。此参数只能与 ITERATIVE_DISTANCE 交汇点放置类型和比例单位一起使用。 | Double |
minimum_shift_absolute （可选） | 布局执行后，对于每个具有两个连接边的交汇点，从其两个边端点对其进行分隔的最小距离。默认值为 2（采用逻辑示意图坐标系的单位）。如果此参数值过大，则将移动具有两个连接的交汇点，以使每个移动后的交汇点在沿其两个连接边所定义的路径上与其边端点之间的距离相等。此参数只能与 USER_DEFINE_DISTANCE 交汇点放置类型和绝对单位一起使用。 | Linear Unit |
minimum_shift_proportional （可选） | 布局执行后，对于每个具有两个连接边的交汇点，确定从其两个边端点对其进行分隔的最小距离。默认值为 2。如果此参数值过大，则将移动具有两个连接的交汇点，以使每个移动后的交汇点在沿其两个连接边所定义的路径上与其边端点之间的距离相等。此参数将与 USER_DEFINE_DISTANCE 交汇点放置类型和比例单位一起使用。 | Double |
iterations_number （可选） | 要处理的迭代次数。默认值为 5。此参数只能与 ITERATIVE_DISTANCE 交汇点放置类型一起使用。 | Long |
is_path_preserved （可选） | 指定如何对沿边的折点进行处理。
| Boolean |
are_leaves_moved （可选） | 指定在算法执行过程中是否移动叶交汇点（包含一个连接的交汇点）。
| Boolean |
are_leaves_expanded （可选） | 指定是否展开叶交汇点：
| Boolean |
expand_shift_absolute （可选） | 必须在叶交汇点与其连接的交汇点之间展开的最大距离。默认值为 2（采用逻辑示意图坐标系的单位），除非指定的输入网络逻辑示意图基于相应模板，通过另一参数值对该模板的线性分派布局算法进行了配置。达到此距离后，后续迭代过程中将不再移动叶交汇点。此参数只能与展开叶参数和绝对单位一起使用。 | Linear Unit |
expand_shift_proportional （可选） | 必须在叶交汇点与其连接的交汇点之间展开的最大距离。默认值为 2，除非指定的输入网络逻辑示意图基于相应模板，通过另一参数值对该模板的线性分派布局算法进行了配置。达到此距离后，后续迭代过程中将不再移动叶交汇点。此参数只能与展开叶参数和比例单位一起使用。 | Double |
派生输出
| 名称 | 说明 | 数据类型 |
| 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.AddLinearDispatchLayout_nd(input_Network, input_DiagramTemplate,
"ACTIVE", "ITERATIVE_DISTANCE", "ABSOLUTE_UNIT",
"15 Feet", "", "2 Feet", "", 10, "PRESERVE_PATH",
"DO_NOT_MOVE_LEAVES", "DO_NOT_EXPAND_LEAVES",
"2 Feet", 2)环境
许可信息
- Basic: 否
- Standard: 是
- Advanced: 是