用于将格网布局算法添加到基于给定模板构建逻辑示意图结束时自动进行链接的布局列表。此工具还会针对基于该模板的任意逻辑示意图预设格网布局算法参数。
此算法可对与某一磁力格网相关的逻辑示意图交汇点进行定位，该磁力格网的像元大小由像元宽度和像元高度参数值确定。
该工具为配置和管理工具。
该工具会基于输入逻辑示意图模板影响任何现有逻辑示意图的一致性。所有现有逻辑示意图都将变得不一致，并随附打开一致性警告图标 
，直至对其进行更新为止。
系统在使用公共设施网络或追踪网络服务时不支持此工具。您必须使用文件地理数据库中的公共设施网络或追踪网络，或者企业级地理数据库中公共设施网络或追踪网络的数据库连接。使用企业级地理数据库时，需要满足以下要求：
要基于逻辑示意图模板对任何逻辑示意图预设布局算法参数，请取消选中激活参数（Python 中为 is_active = "INACTIVE"）。
如果您想要将布局算法添加到基于输入逻辑示意图模板生成逻辑示意图结束时自动进行链接的布局列表，请在激活处于选中状态（默认）（Python 中为 is_active = "ACTIVE"）的情况下运行此工具。
| 标注 | 说明 | 数据类型 |
输入网络
| 包含要修改的逻辑示意图模板的公共设施网络或追踪网络。 | Utility Network; Trace Network |
输入逻辑示意图模板
| 要修改的逻辑示意图模板的名称。 | String |
激活
| 指定是否将在基于指定模板生成逻辑示意图时自动执行布局算法。
| Boolean |
保留容器布局
(可选) | 指定算法将如何处理容器。
| Boolean |
像元宽度
(可选) | 每个格网像元的宽度。默认值为 2（采用逻辑示意图坐标系的单位）。 | Linear Unit |
像元高度
(可选) | 每个格网像元的高度。默认值为 2（采用逻辑示意图坐标系的单位）。 | Linear Unit |
| 标注 | 说明 | 数据类型 |
| 输出网络 | 已更新的 公共设施网络或追踪网络。 | 公共设施网络；追踪网络 |
| 输出逻辑示意图模板 | 逻辑示意图模板的名称。 | 字符串 |
arcpy.nd.AddGridLayout(in_utility_network, template_name, is_active, {are_containers_preserved}, {cell_width_absolute}, {cell_height_absolute})| 名称 | 说明 | 数据类型 |
in_utility_network | 包含要修改的逻辑示意图模板的公共设施网络或追踪网络。 | Utility Network; Trace Network |
template_name | 要修改的逻辑示意图模板的名称。 | String |
is_active | 指定是否将在基于指定模板生成逻辑示意图时自动执行布局算法。
| Boolean |
are_containers_preserved (可选) | 指定算法将如何处理容器。
| Boolean |
cell_width_absolute (可选) | 每个格网像元的宽度。默认值为 2（采用逻辑示意图坐标系的单位）。 | Linear Unit |
cell_height_absolute (可选) | 每个格网像元的高度。默认值为 2（采用逻辑示意图坐标系的单位）。 | Linear Unit |
| 名称 | 说明 | 数据类型 |
| 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.AddGridLayout_nd(input_Network, input_DiagramTemplate, "ACTIVE",
"PRESERVE_CONTAINERS", "2 Meter", "5 Meter")