Сводка
Обновляет информацию о подсетях в таблице Подсети, класс пространственных объектов SubnetLine, а также системные схемы подсетей для заданных подсетей. Кроме того, создаются или обновляются некоторые атрибуты для пространственных объектов подсетей. Для каждой новой подсети будет создана запись, записи для удаленных подсетей будут удалены, а для любых измененных подсетей будет обновлена информация и форма.
Использование
При работе с многопользовательской базой геоданных должны быть выполнены следующие требования:
- Инженерная сеть должна быть зарегистрирована как версионная сервис-ориентированная.
- Входная инженерная сеть должна быть сервисом инженерной сети.
- Если инструмент запускается для версии по умолчанию, будут обновлены геометрия, имя подсети и перешедшие поля класса объектов SubnetLine. Если он запущен для именованной версии, то ограничения поведения по умолчанию (без событий) обновят пространственные и непространственные объекты, которые редактируются в версии. Можно изменить режим редактирования, чтобы он использовал события (с событиями). Эта опция запускает поведение базы геоданных и ее можно настроить в определении подсети как для версии по умолчанию, так и для именованных версий. Более подробно о режиме редактирования, который используется инструментом Обновить подсеть
Этот инструмент создает или обновляет схемы сети для обновленных подсетей, если был указан шаблон схемы при настройке определения подсети.
Перед запуском этого инструмента необходимо сохранить любые изменения.
Топология сети должна быть включена.
Отсутствуют измененные области, пересекающие объекты подсетей.
Синтаксис
arcpy.un.UpdateSubnetwork(in_utility_network, domain_network, tier, {all_subnetworks_in_tier}, {subnetwork_name}, {continue_on_failure}, {condition_barriers}, {function_barriers}, {include_barriers}, {traversability_scope}, {propagators})
Parameter | Объяснение | Тип данных |
in_utility_network | Инженерная сеть, которая содержит подсеть. | Utility Network; Utility Network Layer |
domain_network | Специализированная сеть, которая содержит данную подсеть. | String |
tier | Уровень, содержащий подсеть. | String |
all_subnetworks_in_tier (Дополнительный) | Указывает, обновляются ли все подсети в уровне. Чтобы обновить поднабор подсетей данного уровня, используйте параметр subnetwork_name.
| Boolean |
subnetwork_name (Дополнительный) | Имя обновляемой подсети. Если все подсети будут обновлены с использованием параметра all_subnetworks_in_tier, этот параметр игнорируется. | String |
continue_on_failure (Дополнительный) | Указывает, следует ли останавливать процесс обновления, если не удается обновить подсеть при обновлении нескольких подсетей.
| Boolean |
condition_barriers [[Name, Operator, Type, Value, Combine Using],...] (Дополнительный) | Задает условия проходимости барьеров в объекте на основании сравнения с сетевым атрибутом или проверки строки категории. Барьер условия использует атрибут сети, оператор и тип, а также значение атрибута. Например, остановите трассировку, если атрибут Device Status объекта равен определенному значению Open. Если объект удовлетворяет этому условию, трассировка остановится. При использовании более одного атрибута, можно применить параметр Комбинировать использование, чтобы задать условие И или Или. Применяются следующие компоненты барьера условий:
Далее приведены значения для барьера условий Operator:
Опции для барьера условий type следующие:
Значения Combine Using:
Примечание:Этот параметр доступен только в Python. Более подробно об использовании множественных условных выражений | Value Table |
function_barriers [[Function, Attribute, Operator, Value, Use Local Values],...] (Дополнительный) | Задает барьер проходимости на объектах на основе функции. Барьеры функций можно применять для ограничения того, насколько далеко трассировка может уйти от начальной точки, или установки максимального значения, при котором трассировка остановится. Например, длина каждой пройденной линии добавляется к общему пройденному на данный момент расстоянию. Когда общая пройденная длина достигнет указанного значения, трассировка остановится. Применяются следующие компоненты барьера функций:
Возможные значения для опций ограничения функции function:
Например, объект начальной точки имеет значение 20. Следующий объект имеет значение 30. Если вы используете функцию минимума, результат равен 20, максимум - 30, добавить - 50, среднее - 25, количество - 2 и разность -10. Варианты значений барьера функции operator следующие:
Примечание:Этот параметр доступен только в Python. | Value Table |
include_barriers (Дополнительный) | Определяет, будут ли объекты-барьеры проходимости включены в результаты трассировки. Включение барьеров проходимости являются дополнительной опцией, даже если они представлены в определении подсети.
Примечание:Этот параметр доступен только в Python или ModelBuilder. | Boolean |
traversability_scope (Дополнительный) | Устанавливает тип проходимости, который будет применяться. Область проходимости определяет, будут ли применены настройки проходимости для соединений, ребер или для обоих. Например, если для остановки трассировки устанавливается барьер условия, и DEVICESTATUS равен Open, а объем проходимости ограничен только ребрами, трассировка не остановится даже, если трассировка проходит через открытое устройство, так как DEVICESTATUS применим только для соединений. Другими словами, этот параметр определяет, должны ли при трассировке игнорироваться соединения, ребра, или и то, и другое.
Примечание:Этот параметр доступен только в Python или ModelBuilder. | String |
propagators [[Attribute, Substitution Attribute, Function, Operator, Value],...] (Дополнительный) | Указывает сетевые атрибуты для распространения, а также то, как это распространение будет происходить во время трассировки. Класс распространяющихся атрибутов определяет ключевое значение для контроллеров подсети, которое будет распределено по остальным объектам подсети. Например, в модели электрической сети вы можете распространить значение фазы. Используются следующие компоненты распространения:
Возможные значения для распространителя function следующие:
Значения operator распространителя следующие:
Примечание:Этот параметр доступен только в Python или ModelBuilder. | Value Table |
Производные выходные данные
Name | Объяснение | Тип данных |
out_utility_network | Обновленная инженерная сеть | Инженерная сеть |
Пример кода
Обновление определенной подсети с названием RMT004.
import arcpy
arcpy.UpdateSubnetwork_un("Utility Network", "ElectricDistribution",
"Medium Voltage", "SPECIFIC_SUBNETWORK", "RMT004",
"CONTINUE_ON_FAILURE")
Обновляет все подсети в на уровне Среднее напряжение.
import arcpy
arcpy.UpdateSubnetwork_un("Utility Network", "ElectricDistribution",
"Medium Voltage", "ALL")
Environments
Информация о лицензиях
- Basic: Нет
- Standard: Да
- Advanced: Да