Добавить уровень (Инженерная сеть)

Сводка

Создает новый уровень в специализированной сети инженерной сети.

Уровни являются наборами подсетей одного уровня, с одинаковыми правилами именования и типом топологии. Уровни требуются для управления подсетями.

Использование

  • Поле Имя подсети добавляется для специализированных сетей с частью определения уровня для первого уровня, добавленного в специализированную сеть. Для специализированных сетей, которые работают с иерархическими определениями уровней, поле имени подсети создается с помощью значения параметра Имя поля подсети. Подробнее см. в разделе Имя подсети.

  • Для специализированных сетей с иерархическими определениями уровней параметр Имя группы уровня является обязательным. Для специализированных сетей с иерархическими определениями уровней имена групп могут создаваться с помощью инструмента Добавить группу уровней.

  • Уровни должны добавляться до присоединения данных в класс объектов инженерной сети. Если данные присоединяются перед добавлением нового уровня, это приведет к ошибке инструмента.

  • Топология сети должна быть отключена.

  • При работе с многопользовательской базой геоданных должны быть выполнены следующие требования:

Синтаксис

arcpy.un.AddTier(in_utility_network, domain_network, name, rank, {topology_type}, {tier_group_name}, {subnetwork_field_name})
ParameterОбъяснениеТип данных
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
(Дополнительный)

Имя поля, в котором будут храниться имена подсетей для данного уровня. Это системное поле, которое будет создано при первом добавлении уровня в группу уровней и которое будет снова использоваться для любых дополнительных уровней при их добавлении. Например, у вас две группы уровней: Распределение и Передача. Это поле будет создано, когда вы добавите в группу Распределение уровень с именем systemsubnet и укажете для поля подсети имя systemsubnet. Далее, второй уровень с именем system вы добавите в группу Передача. Этот параметр будет определять, будет ли использоваться поле systemsubnet как имя поля подсети. Для иерархических уровней этот параметр является обязательным.

String

Производные выходные данные

NameОбъяснениеТип данных
out_utility_network

Обновленная инженерная сеть

Инженерная сеть

Пример кода

AddTier, пример 1 (окно Python)

Создание уровня в иерархической сети DistributionSystem с типом топологии MESH.

import arcpy
arcpy.AddTier_un("Utility Network", "GasDistribution", "Distribution System", 
                 1, "MESH", "Distribution", "System")
AddTier, пример 2 (окно Python)

Создание уровня в частичной сети MediumVoltage с типом топологии RADIAL.

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

Environments

Этот инструмент не использует параметры среды геообработки

Информация о лицензиях

  • Basic: Нет
  • Standard: Да
  • Advanced: Да

Связанные разделы