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

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

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

Для таблицы Подсети этот инструмент изменяет статус связанных контроллеров подсети на чистый (для Is dirtyатрибута установлено значение False). Если во время работы инструмента обнаруживаются ошибки проверки согласованности или ошибки подсети, статус связанных контроллеров подсети будет помечен как недопустимый (атрибут Is dirty помечается как недопустимый). В классе объектов Класс объектов SubnetLine будет создана запись для новых подсетей, записи для удаленных подсетей будут удалены, а для измененных подсетей будет обновлена информация и форма. Также создаются или обновляются некоторые атрибуты для пространственных объектов подсетей.

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

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

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

    • Инженерная сеть должна быть зарегистрирована как версионная сервис-ориентированная.
    • Входная инженерная сеть должна быть сервисом инженерной сети.
    • Если этот инструмент запущен в версии по умолчанию и опция Обновить политику подсети для уровня настроена так, чтобы не управлять Is dirtyатрибутом, операцию обновления подсети можно использовать для удаления строк в таблице Подсети, где для атрибута Is deleted установлено значение true.
    • Если этот инструмент запускается для версии по умолчанию, будут обновлены геометрия, имя подсети и перешедшие поля класса объектов SubnetLine. Если этот инструмент запущен для именованной версии, то ограничения поведения по умолчанию (без событий) обновят пространственные и непространственные объекты, которые редактируются в версии. Можно изменить режим редактирования, чтобы он использовал события (с событиями). Эта опция запускает поведение базы геоданных и ее можно настроить в определении подсети как для версии по умолчанию, так и для именованных версий.

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

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

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

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

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

Параметры

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

Инженерная сеть, которая содержит подсеть.

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

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

String
Уровень

Уровень, содержащий подсеть.

String
Все подсети уровня
(Дополнительный)

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

  • Отмечено — все подсети уровня будут обновлены. Эта опция использует асинхронную обработку для обновления подсетей, использующих системный сервис геообработки UtilityNetworkTools. Этот сервис зарезервирован для задач геообработки инженерной сети и по умолчанию имеет более продолжительный интервал ожидания. Это значение по умолчанию
  • Отключено — Будут обновлены только подсети, указанные в параметре Имя подсети.

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

Имя подсети, которая будет обновляться с уровня. Если все подсети будут обновлены с использованием параметра Все подсети в уровне, этот параметр игнорируется. Если таблица подсети содержит 10 000 или более записей для уровня, список выбора параметра не заполняется и для имени подсети предоставляется пустое поле.

String
Продолжить при сбое
(Дополнительный)

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

  • Отмечено — процесс обновления не остановится, если произойдет сбой подсети; он будет продолжаться.
  • Отключено — процесс обновления остановится, если произойдет сбой подсети. Это значение по умолчанию

Boolean
Барьеры условий
(Дополнительный)
Примечание:

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

Value Table
Барьеры функции
(Дополнительный)
Примечание:

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

Value Table
Включить объекты-барьеры
(Дополнительный)
Примечание:

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

Boolean
Применить проходимость к
(Дополнительный)

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

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

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

String
Распространители
(Дополнительный)
Примечание:

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

Value Table

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

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

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

Utility Network

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})
ИмяОписаниеТип данных
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 – выбрать из нескольких различных операторов.
  • name – выбрать определенное значение или сетевой атрибут из значения, которое задано в параметре Type.
  • 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Использовать, если встречается любой из барьеров условий.

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

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).
Value Table
include_barriers
(Дополнительный)

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

  • INCLUDE_BARRIERSБарьеры проходимости будут включаться в результаты трассировки. Это значение по умолчанию
  • EXCLUDE_BARRIERSБарьеры проходимости не включаются в результаты трассировки.
Boolean
traversability_scope
(Дополнительный)

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

  • BOTH_JUNCTIONS_AND_EDGESПроходимость будет применима как к соединениям, так и к ребрам. Это значение по умолчанию
  • JUNCTIONS_ONLYПроходимость будет применена только к соединениям.
  • EDGES_ONLYПроходимость будет применена только к ребрам.
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).
Value Table

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

ИмяОписаниеТип данных
out_utility_network

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

Utility Network

Пример кода

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

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

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

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

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

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

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

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

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

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