Обновление подсети (Инженерная сеть)

Сводка

Обновляет информацию о подсетях в таблице Подсети, класс пространственных объектов SubnetLine, а также системные схемы подсетей для заданных подсетей. Кроме того, создаются или обновляются некоторые атрибуты для пространственных объектов подсетей. Для каждой новой подсети будет создана запись, записи для удаленных подсетей будут удалены, а для любых измененных подсетей будет обновлена информация и форма.

Более подробно об обновлении подсетей

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

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

    • Инженерная сеть должна быть зарегистрирована как версионная сервис-ориентированная.
    • Входная инженерная сеть должна быть сервисом инженерной сети.
    • Если инструмент запускается для версии по умолчанию, будут обновлены геометрия, имя подсети и перешедшие поля класса объектов SubnetLine. При выполнении на именованной версии обновляться будут только строки, отредактированные в версии.

  • Этот инструмент создает или обновляет схемы сети для обновленных подсетей, если был указан шаблон схемы при настройке определения подсети.

  • Перед запуском этого инструмента необходимо сохранить любые изменения.

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

  • Отсутствуют измененные области, пересекающие объекты подсетей.

Синтаксис

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.

  • ALL_SUBNETWORKS_IN_TIERОбновляет все подсети в уровне. Эта опция использует асинхронную обработку для обновления подсетей, использующих системный сервис геообработки UtilityNetworkTools. Этот сервис зарезервирован для задач геообработки инженерной сети и по умолчанию имеет более продолжительный интервал ожидания. Используется по умолчанию.
  • SPECIFIC_SUBNETWORKОбновляет только подсети, которые указаны в параметре subnetwork_name.
Boolean
subnetwork_name
(Дополнительный)

Имя обновляемой подсети. Если все подсети будут обновлены с использованием параметра all_subnetworks_in_tier, этот параметр игнорируется.

String
continue_on_failure
(Дополнительный)

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

  • CONTINUE_ON_FAILUREПродолжает обновлять подсети после ошибки.
  • STOP_ON_FAILUREОстанавливает обновление подсетей после ошибки. Используется по умолчанию.
Boolean
condition_barriers
[[Name, Operator, Type, Value, Combine Using],...]
(Дополнительный)

Задает условия проходимости барьеров в объекте на основании сравнения с сетевым атрибутом или проверки строки категории. Барьер условия использует атрибут сети, оператор и тип, а также значение атрибута. Например, остановить трассировку, если у атрибут Device Status объекта равен заданному значению Open. Если объект удовлетворяет этому условию, трассировка остановится. При использовании более одного атрибута, можно применить параметр Комбинировать использование, чтобы задать условие И или Или.

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

  • Name – выбрать фильтр по любому сетевому атрибуту, заданному в системе.
  • Operator – выбрать среди различных операторов.
  • Type – выберите определенное значение или сетевой атрибут значения, которое задано в параметре name.
  • Value – задайте определенное значение типа входного атрибута, которое может вызвать прекращение трассировки на основании значения оператора.
  • Combine Using – укажите это значение, если собираетесь добавить несколько атрибутов. Их можно скомбинировать, используя условие И или Или.

Далее приведены значения для барьера условий Operator:

  • IS_EQUAL_TOАтрибут эквивалентен значению.
  • DOES_NOT_EQUALАтрибут не равен значению.
  • IS_GREATER_THANАтрибут больше значения.
  • IS_GREATER_THAN_OR_EQUAL_TOАтрибут больше или равен значению.
  • IS_LESS_THANАтрибут меньше значения.
  • IS_LESS_THAN_OR_EQUAL_TOАтрибут меньше или равен значению.
  • INCLUDES_THE_VALUESПобитовый оператор AND, где все биты в значении представлены в атрибуте (bitwise AND == value).
  • DOES_NOT_INCLUDE_THE_VALUESПобитовый оператор AND, где не все биты в значении представлены в атрибуте (bitwise AND != value).
  • INCLUDES_ANYПобитовый оператор AND, где как минимум один бит в значении представлен в атрибуте (bitwise AND == True).
  • DOES_NOT_INCLUDE_ANYПобитовый оператор AND, где ни один из битов в значении не представлен в атрибуте (bitwise AND == value).

Опции для барьера условий type следующие:

  • SPECIFIC_VALUEФильтр по заданному значению.
  • NETWORK_ATTRIBUTEФильтр по сетевому атрибуту.

Значения Combine Using:

  • ANDКомбинировать барьеры условий.
  • ORИспользовать, если встречается любой из барьеров условий.
Примечание:

Этот параметр доступен только в Python.

Более подробно об использовании множественных условных выражений

Value Table
function_barriers
[[Function, Attribute, Operator, Value, Use Local Values],...]
(Дополнительный)

Задает барьер проходимости на объектах на основе функции. Барьеры функций можно применять для ограничения того, насколько далеко трассировка может уйти от начальной точки, или установки максимального значения, при котором трассировка остановится. Например, длина каждой пройденной линии добавляется к общему пройденному на данный момент расстоянию. Когда общая пройденная длина достигнет указанного значения, трассировка остановится.

Применяются следующие компоненты барьера функций:

  • Function – выбрать среди различных функций вычисления.
  • Attribute – выбрать фильтр по любому сетевому атрибуту, заданному в системе.
  • Operator – выбрать среди различных операторов.
  • Value – задайте значение для типа входного атрибута, которое вызывает прерывание, если будет найдено.
  • Use Local Values – вычисляет значения в каждом направлении, в отличие от общего глобального значения, например, имеется барьер функции, вычисляющей сумму Shape length, где трассировка прерывается, если значение больше или равно 4. В общем случае, после того, как вы прошли два ребра со значениями 2, вы уже достигли суммы длин геометрий, равной 4, поэтому трассировка останавливается. Если используются локальные значения, изменяются локальные значения вдоль каждого пути, и трассировка продолжается дальше.

  • TRUEИспользовать локальные значения.
  • FALSEИспользовать глобальные значения. Используется по умолчанию.

Возможные значения для опций ограничения функции function:

  • AVERAGEСреднее арифметическое входных значений.
  • COUNTЧисло объектов.
  • MAXМаксимальное из входных значений.
  • MINМинимальное из входных значений.
  • ADDДобавить все значения.
  • SUBTRACTВычесть значения. Контроллеры подсети и трассировка петель не поддерживают функцию вычитания.

Например, имеется объект начальной точки со значением 20. Следующий объект имеет значение 30. Если вы используете функцию минимума, результат равен 20, максимум - 30, добавить - 50, среднее - 25, количество - 2 и разность -10.

Варианты значений барьера функции operator следующие:

  • IS_EQUAL_TOАтрибут эквивалентен значению.
  • DOES_NOT_EQUALАтрибут не равен значению.
  • IS_GREATER_THANАтрибут больше значения.
  • IS_GREATER_THAN_OR_EQUAL_TOАтрибут больше или равен значению.
  • IS_LESS_THANАтрибут меньше значения.
  • IS_LESS_THAN_OR_EQUAL_TOАтрибут меньше или равен значению.
  • INCLUDES_THE_VALUESПобитовый оператор AND, где все биты в значении представлены в атрибуте (bitwise AND == value).
  • DOES_NOT_INCLUDE_THE_VALUESПобитовый оператор AND, где не все биты в значении представлены в атрибуте (bitwise AND != value).
  • INCLUDES_ANYПобитовый оператор AND, где как минимум один бит в значении представлен в атрибуте (bitwise AND == True).
  • DOES_NOT_INCLUDE_ANYПобитовый оператор AND, где ни один из битов в значении не представлен в атрибуте (bitwise AND == value).
Примечание:

Этот параметр доступен только в Python.

Value Table
include_barriers
(Дополнительный)

Определяет, будут ли объекты-барьеры проходимости включены в результаты трассировки. Включение барьеров проходимости являются дополнительной опцией, даже если они представлены в определении подсети.

  • INCLUDE_BARRIERSБарьеры проходимости включаются в результаты трассировки. Используется по умолчанию.
  • EXCLUDE_BARRIERSБарьеров проходимости не включаются в результаты трассировки.
Примечание:

Этот параметр доступен только в Python или ModelBuilder.

Boolean
traversability_scope
(Дополнительный)

Устанавливает тип проходимости, который будет применяться. Область проходимости определяет, будут ли применены настройки проходимости для соединений, ребер или для обоих. Например, если для остановки трассировки устанавливается барьер условия, и DEVICESTATUS равен Open, а объем проходимости ограничен только ребрами, трассировка не остановится даже, если трассировка проходит через открытое устройство, так как DEVICESTATUS применим только для соединений. Другими словами, этот параметр определяет, должны ли при трассировке игнорироваться соединения, ребра, или и то, и другое.

  • BOTH_JUNCTIONS_AND_EDGESПрименить проходимость к соединениям и ребрам. Используется по умолчанию.
  • JUNCTIONS_ONLYПрименить проходимость только к соединениям.
  • EDGES_ONLYПрименить проходимость только к ребрам.
Примечание:

Этот параметр доступен только в Python или ModelBuilder.

String
propagators
[[Attribute, Substitution Attribute, Function, Operator, Value],...]
(Дополнительный)

Задает распространяющиеся атрибуты сети, а также способ распространения в процессе трассировки. Класс распространяющихся атрибутов определяет ключевое значение для контроллеров подсети, которое будет распределено по остальным объектам подсети. Например, в модели электрической сети вы можете распространить значение фазы.

Используются следующие компоненты распространения:

  • Attribute – фильтрация по любому из атрибутов сети, определенному в системе.
  • Substitution Attribute – использовать заменяющее значение вместо битового множества атрибутов сети. Замены являются кодированными на основании числа битов в передаваемом сетевом атрибуте. Замена - это сопоставление каждого бита по фазе другого бита. Например, для Фазы AC, одна замена сопоставляет бит A с B, а C с null. В этом примере замена 1010 (Фаза AC) дает 0000-0010-0000-0000 (512). Замена захватывает сопоставление, т.ч. вы знаете, что Фаза A была сопоставлена с B, а Фаза C с null, а не иначе (например, Фаза A не сопоставлялась с null, а Фаза C не сопоставлялась с B).
  • Function – выбрать среди различных функций вычисления.
  • Operator – выбрать среди различных операторов.
  • Value – задать определенное значение для типа входного атрибута, которое может вызвать прерывание на основании значения оператора.

Возможные значения для распространителя function следующие:

  • PROPAGATED_BITWISE_ANDСравнивать значения одного объекта со значениями следующего.
  • PROPAGATED_MINПолучить минимальное значение.
  • PROPAGATED_MAXПолучить максимальное значение.

Значения operator распространителя следующие:

  • IS_EQUAL_TOАтрибут эквивалентен значению.
  • DOES_NOT_EQUALАтрибут не равен значению.
  • IS_GREATER_THANАтрибут больше значения.
  • IS_GREATER_THAN_OR_EQUAL_TOАтрибут больше или равен значению.
  • IS_LESS_THANАтрибут меньше значения.
  • IS_LESS_THAN_OR_EQUAL_TOАтрибут меньше или равен значению.
  • INCLUDES_THE_VALUESПобитовый оператор AND, где все биты в значении представлены в атрибуте (bitwise AND == value).
  • DOES_NOT_INCLUDE_THE_VALUESПобитовый оператор AND, где не все биты в значении представлены в атрибуте (bitwise AND != value).
  • INCLUDES_ANYПобитовый оператор AND, где как минимум один бит в значении представлен в атрибуте (bitwise AND == True).
  • DOES_NOT_INCLUDE_ANYПобитовый оператор AND, где ни один из битов в значении не представлен в атрибуте (bitwise AND == value).
Примечание:

Этот параметр доступен только в Python или ModelBuilder.

Value Table

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

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

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

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

Пример кода

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

Обновление определенной подсети с названием RMT004.

import arcpy
arcpy.UpdateSubnetwork_un("Utility Network", "ElectricDistribution", 
                          "Medium Voltage", "SPECIFIC_SUBNETWORK", "RMT004", 
                          "CONTINUE_ON_FAILURE")
UpdateSubnetwork, пример 2 (окно Python)

Обновляет все подсети в на уровне Среднее напряжение.

import arcpy
arcpy.UpdateSubnetwork_un("Utility Network", "ElectricDistribution", 
                          "Medium Voltage", "ALL")

Environments

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

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

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

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