描述
使用活动地图中的网络要素图层设置，为输入逻辑示意图模板创建逻辑示意图图层定义。
此工具可用于执行以下操作：
- 当活动地图中的各个要素图层与在输入中指定的公共设施网络或追踪网络相关时，导入在这些要素图层上配置的外观和标注设置。
- 创建一组可与模板相关的额外图层，例如针对系统交汇点、结构附件等的图层。
警告：
该工具为配置和管理工具。
使用方法
系统在使用公共设施网络或追踪网络服务时不支持此工具。您必须使用文件地理数据库中的公共设施网络或追踪网络，或者企业级地理数据库中公共设施网络或追踪网络的数据库连接。使用企业级地理数据库时，需要满足以下要求：
- 输入网络参数值必须来自作为数据库公共设施网络所有者或数据库追踪网络所有者建立的数据库连接。
- 连接的 ArcGIS Enterprise 门户帐户必须为门户公共设施网络所有者或门户追踪网络所有者。
- 该工具必须连接到预期为公开且不受保护的默认版本。
此工具必须在 ArcGIS Pro 中使用，原因是它需要从活动地图中引用输入网络图层，并根据输入活动地图中的图层为所有基于输入模板的逻辑示意图准备网络逻辑示意图复合图层。使用默认设置运行后，基于输入模板的每个网络逻辑示意图都将显示以下内容：
- 每个公共设施网络或追踪网络图层的一个图层，用于表示活动地图中指定为输入的网络要素或网络对象。
- 一组与您的模板相关或无关的额外图层，专用于表示以下类型的网络元素：
- 在逻辑示意图中表示为折线的连通性关联和结构附件
- 可以转换为逻辑示意图中的点的容器面要素、线要素和边对象
- 可以转换为逻辑示意图中的面的容器点要素和容器交汇点对象
- 在逻辑示意图中表示为点的交汇点对象
- 在逻辑示意图中表示为折线的边对象
- 一个“减少边”图层，专用于表示两个交汇点之间的聚合网络元素。
根据覆盖所有图层参数值，可执行以下操作：
- 初始化模板上的自定义逻辑示意图图层定义 当选中覆盖所有图层参数时，这是默认行为。
- 如果未选中覆盖所有图层参数，添加新的逻辑示意图子图层，或覆盖某些现有逻辑示意图子图层上的设置同时保留其他图子层。
语法
arcpy.nd.CreateDiagramLayerDefinition(in_utility_network, template_name, {system_junctions}, {connectivity_associations}, {structural_attachments}, {reduction_edges}, {point_subLayers}, {polygon_subLayers}, {junction_object_point_subLayers}, {edge_object_polyline_subLayers}, {overwrite_all_layers})| 参数 | 说明 | 数据类型 |
in_utility_network | 活动地图中的 utility network or trace network 图层。 | Utility Network Layer; Trace Network Layer |
template_name | 要修改的逻辑示意图模板的名称。 | String |
system_junctions （可选） | 指定是否在基于指定模板的逻辑示意图中表示系统交汇点和系统交汇点对象。
| Boolean |
connectivity_associations （可选） | 指定是否在基于指定模板的逻辑示意图中表示连通性关联。
| Boolean |
structural_attachments （可选） | 指定是否在基于指定模板的逻辑示意图中表示结构附件。
| Boolean |
reduction_edges （可选） | 指定是否在基于指定模板的逻辑示意图中表示减少边。
| Boolean |
point_subLayers [[Name, Subtype Layer],...] （可选） | 指定是否添加图层以将容器面、线网络要素或网络边对象表示为逻辑示意图中的点要素。 第二列使用如下：
| Value Table |
polygon_subLayers [[Name, Subtype Layer],...] （可选） | 指定是否添加图层以将容器点要素或容器交汇点对象表示为逻辑示意图中的面要素。 第二列使用如下：
| Value Table |
junction_object_point_subLayers [[Name, Subtype Layer],...] （可选） | 指定是否添加图层以将交汇点对象表示为逻辑示意图中的点要素。 第二列使用如下：
| Value Table |
edge_object_polyline_subLayers [[Name, Subtype Layer],...] （可选） | 指定是否添加图层以将边对象表示为逻辑示意图中的折线要素。 第二列使用如下：
| Value Table |
overwrite_all_layers （可选） | 指定是覆盖还是保留逻辑示意图图层下的所有现有图层，输入网络地图中的图层和明确指定的其他子图层除外。
| Boolean |
派生输出
| 名称 | 说明 | 数据类型 |
| out_utility_network | 已更新的 utility network or trace network 图层。 | 公共设施网络图层；追踪网络图层 |
| out_template_name | 逻辑示意图模板的名称。 | 字符串 |
代码示例
针对与输入网络相关的名为 MyTemplate1 的模板创建逻辑示意图图层定义。
import arcpy
arcpy.CreateDiagramLayerDefinition_nd(input_Network, "MyTemplate1",
"SHOW", "SHOW", "HIDE", "HIDE",
"StructureBoundary true;StructureLine true;ElectricDistributionLine true",
"StructureJunction true;ElectricDistributionAssembly true",
"ElectricDistributionJunctionObject true",
"ElectricDistributionEdgeObject true",
"OVERWRITE_ALL")通过额外添加“缩减边”和“结构附件”子图层，而不更改其他逻辑示意图子图层，来优化与输入网络相关的名为 MyTemplate1 的模板上的逻辑示意图图层定义。
import arcpy
arcpy.CreateDiagramLayerDefinition_nd(input_Network, "MyTemplate1",
"HIDE", "HIDE", "SHOW", "SHOW",
overwrite_all_layers="MERGE")环境
许可信息
- Basic: 否
- Standard: 是
- Advanced: 是