添加层 (公共设施网络)

摘要

在公共设施网络中针对域网络创建新层。

层是共享相同级别、名称限制和拓扑类型的子网集合。层是子网管理的必要选项。

使用情况

  • 将为域网络添加子网名称字段,并向域网络添加第一层的分区层定义。对于具有等级层定义的域网络,将使用子网字段名称参数值创建子网字段名称。有关详细信息,请参阅子网名称

  • 对于具有等级层定义的域网络,层组名称是必需参数。可以使用添加层组工具为具有等级层定义的域网络创建层组。

  • 在公共设施网络要素类中追加数据之前,应该添加层。如果在添加新层之前追加数据,将出现错误。

  • 必须禁用网络拓扑。

  • 使用企业级地理数据库时,必须满足以下要求:

参数

标注说明数据类型
输入公共设施网络

包含域网络的公共设施网络,将向该域网络中添加层。

Utility Network; Utility Network Layer
域网络

将要创建该层的域网络。

String
名称

新层的名称。该名称在整个公共设施网络中必须唯一。

String
等级

正在添加的层的等级。最高等级是第 1 级。

Long
拓扑类型
(可选)

指定新层的拓扑类型。具有径向和网格拓扑类型的子网均支持一个或多个子网控制器。如果使用等级层定义创建了输入域网络并且拓扑类型默认为网格,则将在工具对话框上禁用此参数。如果使用分区层定义创建了域网络,则此参数将在下拉列表中列出所有拓扑类型。

对于追踪或子网管理,此参数当前不提供行为差异。此参数的功能正在研发中,且将在未来的版本中适用。

  • 半径子网将具有径向拓扑类型。
  • 网格子网将具有网格拓扑类型。这是使用等级层定义创建的层的默认拓扑类型。
String
层组名称
(可选)

将添加新层的现有层组。对于具有等级层定义的域网络,此参数为必需项。

String
子网字段名称
(可选)

将在其中存储该层子网名称的字段名称。该字段为系统维护字段,将在第一次将层添加到层组并重新用于任何附加层时创建该字段。例如,您有两个层组:Distribution 和 Transmission。当您将名为 system 的层添加到 Distribution 组,并将子网字段名称指定为 systemsubnet 时,将创建该字段。接下来,您要将第二个名为 system 的层添加到 Transmission 组。此参数将检测到应将 systemsubnet 字段用作子网字段名称。此参数是等级层类型的必要参数。

String

派生输出

标注说明数据类型
更新的公共设施网络

更新的公共设施网络。

公共设施网络

arcpy.un.AddTier(in_utility_network, domain_network, name, rank, {topology_type}, {tier_group_name}, {subnetwork_field_name})
名称说明数据类型
in_utility_network

包含域网络的公共设施网络,将向该域网络中添加层。

Utility Network; Utility Network Layer
domain_network

将要创建该层的域网络。

String
name

新层的名称。该名称在整个公共设施网络中必须唯一。

String
rank

正在添加的层的等级。最高等级是第 1 级。

Long
topology_type
(可选)

指定新层的拓扑类型。具有径向和网格拓扑类型的子网均支持一个或多个子网控制器。如果使用等级层定义创建了输入域网络并且拓扑类型默认为网格,则将在工具对话框上禁用此参数。如果使用等级层定义创建了输入域网络,则默认拓扑类型为 MESH。如果使用分区层定义创建了输入域网络,则需要拓扑类型参数。

注:

对于追踪或子网管理,此参数当前不提供行为差异。此参数的功能正在研发中,且将在未来的版本中适用。

  • RADIAL子网将具有径向拓扑类型。
  • MESH子网将具有网格拓扑类型。这是使用等级层定义创建的层的默认拓扑类型。
String
tier_group_name
(可选)

将添加新层的现有层组。对于具有等级层定义的域网络,此参数为必需项。

String
subnetwork_field_name
(可选)

将在其中存储该层子网名称的字段名称。该字段为系统维护字段,将在第一次将层添加到层组并重新用于任何附加层时创建该字段。例如,您有两个层组:Distribution 和 Transmission。当您将名为 system 的层添加到 Distribution 组,并将子网字段名称指定为 systemsubnet 时,将创建该字段。接下来,您要将第二个名为 system 的层添加到 Transmission 组。此参数将检测到应将 systemsubnet 字段用作子网字段名称。此参数是等级层类型的必要参数。

String

派生输出

名称说明数据类型
out_utility_network

更新的公共设施网络。

公共设施网络

代码示例

AddTier 示例 1(Python 窗口)

使用 MESH 拓扑类型在名为 DistributionSystem 的等级网络中创建层。

import arcpy
arcpy.AddTier_un("Utility Network", "GasDistribution", "Distribution System", 
                 1, "MESH", "Distribution", "System")
AddTier 示例 2(Python 窗口)

使用 RADIAL 拓扑类型在名为 MediumVoltage 的分区网络中创建层。

import arcpy
arcpy.AddTier_un("Utility Network", "ElectricDistribution", "Medium Voltage", 
                 1, "RADIAL")

环境

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

许可信息

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

相关主题