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

Краткая информация

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

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

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

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

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

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

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

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

    • Входная инженерная сеть должна быть из подключения к базе данных, установленного от имени владельца базы данных инженерной сети.
    • Учетная запись подключенного портала ArcGIS Enterprise должна быть записью владельца инженерной сети на портале.
    • Этот инструмент должен быть подключен к версии по умолчанию для запуска.
      • Все другие сеансы, подключенные к версии по умолчанию, блокируются от выполнения операций проверки или включения во время операции включения.

Параметры

ПодписьОписаниеТип данных
Входная инженерная сеть

Инженерная сеть, которая содержит специализированную сеть, к которой будет добавлена группа уровней.

Utility Network; Utility Network Layer
Специализированная сеть

Специализированная сеть, в которой будет создан уровень.

String
Имя

Название нового уровня. Имя должно быть уникальным по всей инженерной сети.

String
Ранг

Ранг добавляемого уровня. Высший ранг имеет номер 1.

Long
Тип топологии
(Дополнительный)

Указывает тип топологии нового уровня. Подсети с типами топологии Радиальный и Сетка поддерживают один или несколько контроллеров подсети. В диалоговом окне инструмента этот параметр отключается, если входная специализированная сеть создана с иерархическим определением уровня, а тип топологии по умолчанию становится Сетка. Если специализированная сеть была создана с частичным определением уровня, этот параметр позволяет выбрать любой тип топологии с помощью ниспадающего списка.

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

  • РадиальныйПодсети будут иметь тип топологии Радиальный.
  • СеткаПодсети будут иметь тип топологии Сетка. Этот тип топологии используется по умолчанию для уровня, созданного с иерархическим определением уровня.
String
Имя группы уровней
(Дополнительный)

Группа уровней, в которую будет добавлен новый уровень. Этот параметр является обязательным для специализированных сетей с иерархическим определением уровней.

String
Имя поля подсети
(Дополнительный)

Имя поля, в котором будут храниться имена подсетей для данного уровня. Это системное поле, которое будет создано при первом добавлении уровня в группу уровней и которое будет снова использоваться для любых дополнительных уровней при их добавлении. Например, у вас две группы уровней: Распределение и Передача. Это поле будет создано, когда вы добавите в группу Распределение уровень с именем systemsubnet и укажете для поля подсети имя systemsubnet. Далее, второй уровень с именем system вы добавите в группу Передача. Этот параметр будет определять, будет ли использоваться поле 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
(Дополнительный)

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

String

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

ИмяОписаниеТип данных
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")

Параметры среды

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

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

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

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