用于将“空间分派布局”算法添加到基于给定模板构建逻辑示意图结束时自动进行链接的布局列表。此工具还会针对基于该模板的任意逻辑示意图预设“空间分派布局”算法参数。
此布局算法可逐步分离明显接近重叠状态的逻辑示意图交汇点，分离的依据是交汇点的当前位置以及所指定的平移系数。
该工具为配置和管理工具。
该工具会基于输入逻辑示意图模板影响任何现有逻辑示意图的一致性。所有现有逻辑示意图都将变得不一致，并随附打开一致性警告图标 
，直至对其进行更新为止。
系统在使用公共设施网络或追踪网络服务时不支持此工具。您必须使用文件地理数据库中的公共设施网络或追踪网络，或者企业级地理数据库中公共设施网络或追踪网络的数据库连接。使用企业级地理数据库时，需要满足以下要求：
要基于逻辑示意图模板对任何逻辑示意图预设布局算法参数，请取消选中激活参数（Python 中为 is_active = "INACTIVE"）。
如果您想要将布局算法添加到基于输入逻辑示意图模板生成逻辑示意图结束时自动进行链接的布局列表，请在激活处于选中状态（默认）（Python 中为 is_active = "ACTIVE"）的情况下运行此工具。
| 标注 | 说明 | 数据类型 |
输入网络
| 包含要修改的逻辑示意图模板的公共设施网络或追踪网络。 | Utility Network; Trace Network |
输入逻辑示意图模板
| 要修改的逻辑示意图模板的名称。 | String |
激活
| 指定是否将在基于指定模板生成逻辑示意图时自动执行布局算法。
| Boolean |
保留容器布局
(可选) | 指定算法将如何处理容器。
| Boolean |
迭代次数
(可选) | 要处理的迭代次数。默认值为 5。 | Long |
最大平移系数
(可选) | 最大值，用于增大十分接近的交汇点的逻辑示意图交汇点位移。平移系数越大，几乎叠置的逻辑示意图交汇点之间的间隔越大。默认值为 2。 | Double |
| 标注 | 说明 | 数据类型 |
| 输出网络 | 已更新的 公共设施网络或追踪网络。 | 公共设施网络；追踪网络 |
| 输出逻辑示意图模板 | 逻辑示意图模板的名称。 | 字符串 |
arcpy.nd.AddSpatialDispatchLayout(in_utility_network, template_name, is_active, {are_containers_preserved}, {iterations_number}, {maximum_shift_factor})| 名称 | 说明 | 数据类型 |
in_utility_network | 包含要修改的逻辑示意图模板的公共设施网络或追踪网络。 | Utility Network; Trace Network |
template_name | 要修改的逻辑示意图模板的名称。 | String |
is_active | 指定是否将在基于指定模板生成逻辑示意图时自动执行布局算法。
| Boolean |
are_containers_preserved (可选) | 指定算法将如何处理容器。
| Boolean |
iterations_number (可选) | 要处理的迭代次数。默认值为 5。 | Long |
maximum_shift_factor (可选) | 最大值，用于增大十分接近的交汇点的逻辑示意图交汇点位移。平移系数越大，几乎叠置的逻辑示意图交汇点之间的间隔越大。默认值为 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.AddSpatialDispatchLayout_nd(input_Network, input_DiagramTemplate,
"ACTIVE", "PRESERVE_CONTAINERS", 5, 2)