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

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

Задает свойства уровня специализированной сети для подсети в инженерной сети.

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

Параметры конфигурации могут использоваться для задания свойств при выполнении трассировки подсети.

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

Дополнительные сведения об управлении подсетями

Дополнительные сведения о трассировке в инженерной сети

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

  • Этот инструмент также позволяет настраивать и изменять определение уровня подсети. Чтобы изменить значения определения уровня подсети, измените значения параметра и снова запустите этот инструмент.

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

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

Параметры

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

Входная инженерная сеть, которая содержит подсеть уровня.

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

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

String
Имя уровня

Имя уровня, содержащего подсеть.

String
Поддерживать несоединенные подсети

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

  • Отмечено - входной уровень поддерживает несоединенные подсети.
  • Не отмечено - входной уровень не поддерживает несоединенные подсети. Это значение по умолчанию

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

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

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

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

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

Определяет пары группа оборудования/тип оборудования как допустимые линии для подсети.

String
Агрегированные линии для класса объектов SubnetLIne
(Дополнительный)

Допустимые линии с геометрией, которая будет агрегирована для создания объектов SubnetLine. Этот список является поднабором значений, указанных параметром Допустимые линии.

String
Шаблоны схемы подсети
(Дополнительный)

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

String
Краткая информация
(Дополнительный)

Задает атрибутивное поле суммирования, чтобы хранить результаты функции при вставке или обновлении объектов SubnetLine.

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

  • Функция – выбрать среди различных функций вычисления.
  • Атрибут – фильтрация по любому из атрибутов сети, определенному в системе.
  • Имя фильтра – Фильтрация результатов функции по имени атрибута.
  • Оператор фильтра – выбрать среди различных операторов.
  • Тип фильтра – выбрать среди различных типов фильтра.
  • Значение фильтра – укажите определенное значение входного атрибута фильтра.
  • Атрибут суммирования – поле в классе объектов SubnetLine, которое будет сохранять результат функции. В зависимости от выбранной функции и типа сетевого атрибута, только допустимый тип пользовательских атрибутов подсети будет действительным для этого параметра. Если в классе объектов не существует поля для хранения итогового результата, для его добавления можно использовать инструмент Добавить поле. Поле может поддерживать результат только одной сводки; поэтому для каждой сводки требуется собственное поле в классе объектов SubnetLine. См. следующую таблицу допустимых для различных функций типов полей для поля суммарного атрибута, в зависимости от выбранной функции

    Функция

    Short

    Long

    Double

    Date

    AVG

    Double

    Double

    Double

    недоступно

    MIN

    Short

    Long

    Double

    Date

    MAX

    Short

    Long

    Double

    Date

    SUBTRACT

    Long

    Long

    Double

    недоступно

    COUNT

    Long

    Long

    Long

    недоступно

    ДОБАВИТЬ

    Long

    Long

    Double

    недоступно

Опции значений Функции суммирования следующие:

  • Минимум – минимальное из входных значений.
  • Максимум – максимальное из входных значений.
  • Добавить – сумма входных значений.
  • Среднее – среднее входных значений.
  • Количество – количество пространственных объектов.
  • Вычесть – разница между входными значениями.

    Контроллеры подсети и циклические трассировки не поддерживаются функцией вычитания.

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

Опции значений Оператора фильтра суммирования следующие:

  • Равно – атрибут равен значению.
  • Не равно – атрибут не равен значению.
  • Больше – атрибут больше значения.
  • Больше или равно – атрибут больше или равен значению.
  • Меньше – атрибут меньше значения.
  • Меньше или равно – атрибут меньше или равен значению.
  • Включает значения – побитовая операция AND, где все биты в значении присутствуют в атрибуте (побитовый AND == значение).
  • Не включает значения – побитовая операция AND, где не все биты в значении присутствуют в атрибуте (побитовый AND != значение).
  • Включает любое – побитовая операция AND, в которой хотя бы один бит в значении присутствует в атрибуте (побитовый AND == True).
  • Не включает включает любое – побитовая операция AND, где ни один из битов в значении не присутствует в атрибуте (побитовый AND == False).

Опции значений Тип фильтра для сводок следующие:

  • Заданное значение – фильтр по заданному значению.
  • Сетевые атрибуты – Фильтровать по атрибуту сети.

  • СреднееСреднее арифметическое входных значений.
  • КоличествоЧисло объектов.
  • Макс.Максимальное из входных значений.
  • Мин.Минимальное из входных значений.
  • ДобавитьСумма входных значений.
  • ВычестьРазница входных значений. Контроллеры подсети и циклические трассировки не поддерживаются функцией вычитания.
  • РавноАтрибут равен значению.
  • Не равноАтрибут не равен значению.
  • БольшеАтрибут больше значения.
  • Больше или равноАтрибут больше или равен значению.
  • МеньшеАтрибут меньше значения.
  • Меньше или равноАтрибут меньше или равен значению.
  • Включает значения (побитовый AND равен значению)Побитовая операция AND, где все биты в значении присутствуют в атрибуте (побитовый AND == значение).
  • Не включает значения (побитовый AND не равен значению)Побитовая операция AND, где не все биты в значении присутствуют в атрибуте (побитовый AND != значение).
  • Включает все (побитовый AND равен True)Побитовая операция AND, в которой хотя бы один бит в значении присутствует в атрибуте (побитовый AND == True).
  • Не включает ничего (побитовый AND равен False)Побитовая операция AND, где ни один из битов в значении не присутствует в атрибуте (побитовый AND == False).
  • Определенное значениеФильтр по заданному значению.
  • Атрибут сетиФильтр по сетевому атрибуту.
Value Table
Барьеры условий
(Дополнительный)

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

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

  • Имя – фильтр по любому сетевому атрибуту, заданному в системе.
  • Оператор – выбрать среди различных операторов.
  • Тип – выбрать определенное значение или сетевой атрибут из значений, указанных в параметре Имя.
  • Значение – задать определенное значение для типа входного атрибута, которое может вызвать прерывание на основании значения оператора.
  • Комбинировать использование – задайте это значение, если собираетесь добавить несколько атрибутов. Их можно комбинировать при помощи условий И или ИЛИ.

Значения Оператора барьеров условий следующие:

  • Равно – атрибут равен значению.
  • Не равно – атрибут не равен значению.
  • Больше – атрибут больше значения.
  • Больше или равно – атрибут больше или равен значению.
  • Меньше – атрибут меньше значения.
  • Меньше или равно – атрибут меньше или равен значению.
  • Включает значения – побитовая операция AND, где все биты в значении присутствуют в атрибуте (побитовый AND == значение).
  • Не включает значения – побитовая операция AND, где не все биты в значении присутствуют в атрибуте (побитовый AND != значение).
  • Включает любое – побитовая операция AND, в которой хотя бы один бит в значении присутствует в атрибуте (побитовый AND == True).
  • Не включает включает любое – побитовая операция AND, где ни один из битов в значении не присутствует в атрибуте (побитовый AND == False).

Варианты значений барьеров условий Тип следующие:

  • Заданное значение – фильтр по заданному значению.
  • Сетевые атрибуты – Фильтровать по атрибуту сети.

  • РавноАтрибут равен значению.
  • Не равноАтрибут не равен значению.
  • БольшеАтрибут больше значения.
  • Больше или равноАтрибут больше или равен значению.
  • МеньшеАтрибут меньше значения.
  • Меньше или равноАтрибут меньше или равен значению.
  • Включает значения (побитовый AND равен значению)Побитовая операция AND, где все биты в значении присутствуют в атрибуте (побитовый AND == значение).
  • Не включает значения (побитовый AND не равен значению)Побитовая операция AND, где не все биты в значении присутствуют в атрибуте (побитовый AND != значение).
  • Включает все (побитовый AND равен True)Побитовая операция AND, в которой хотя бы один бит в значении присутствует в атрибуте (побитовый AND == True).
  • Не включает ничего (побитовый AND равен False)
  • Определенное значениеФильтр по заданному значению.
  • Атрибут сетиФильтр по сетевому атрибуту.
  • ИКомбинировать барьеры условий.
  • ИлиИспользовать, если встречается любой из барьеров условий.
Value Table
Барьеры функции
(Дополнительный)

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

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

  • Функция – выбрать среди различных функций вычисления.
  • Атрибут – фильтрация по любому из атрибутов сети, определенному в системе.
  • Оператор – выбрать среди различных операторов.
  • Значение – указать определенное значение типа входного атрибута, которое, если будет найдено, может вызвать прерывание.
  • Использовать локальные значения – вычисляет значения в каждом направлении, в отличие от общего глобального значения, например, имеется барьер функции, вычисляющей сумму Shape length, где трассировка прерывается, если значение больше или равно 4. В общем случае, после прохождения двух ребер со значением 2, вы уже достигнете суммы Shape length, равной 4, и трассировка остановится. Если используются локальные значения, изменяются локальные значения вдоль каждого пути, и трассировка продолжается дальше.
    • Отмечено — будут использоваться локальные значения.
    • Не отмечено — будут использоваться глобальные значения. Это значение по умолчанию

Опции значений Функции барьера функций:

  • Минимум – минимальное из входных значений.
  • Максимум – максимальное из входных значений.
  • Добавить – сумма входных значений.
  • Среднее – среднее входных значений.
  • Количество – количество пространственных объектов.
  • Вычесть – разница между входными значениями.

    Контроллеры подсети и циклические трассировки не поддерживаются функцией вычитания.

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

Опции значений Оператора барьера функций:

  • Равно – атрибут равен значению.
  • Не равно – атрибут не равен значению.
  • Больше – атрибут больше значения.
  • Больше или равно – атрибут больше или равен значению.
  • Меньше – атрибут меньше значения.
  • Меньше или равно – атрибут меньше или равен значению.
  • Включает значения – побитовая операция AND, где все биты в значении присутствуют в атрибуте (побитовый AND == значение).
  • Не включает значения – побитовая операция AND, где не все биты в значении присутствуют в атрибуте (побитовый AND != значение).
  • Включает любое – побитовая операция AND, в которой хотя бы один бит в значении присутствует в атрибуте (побитовый AND == True).
  • Не включает включает любое – побитовая операция AND, где ни один из битов в значении не присутствует в атрибуте (побитовый AND == False).

  • СреднееСреднее арифметическое входных значений.
  • КоличествоЧисло объектов.
  • Макс.Максимальное из входных значений.
  • Мин.Минимальное из входных значений.
  • ДобавитьСумма входных значений.
  • ВычестьРазница между входными значениями.Контроллеры подсети и циклические трассировки не поддерживаются функцией вычитания.
  • РавноАтрибут равен значению.
  • Не равноАтрибут не равен значению.
  • БольшеАтрибут больше значения.
  • Больше или равноАтрибут больше или равен значению.
  • МеньшеАтрибут меньше значения.
  • Меньше или равноАтрибут меньше или равен значению.
  • Включает значения (побитовый AND равен значению)Побитовая операция AND, где все биты в значении присутствуют в атрибуте (побитовый AND == значение).
  • Не включает значения (побитовый AND не равен значению)Побитовая операция AND, где не все биты в значении присутствуют в атрибуте (побитовый AND != значение).
  • Включает все (побитовый AND равен True)Побитовая операция AND, в которой хотя бы один бит в значении присутствует в атрибуте (побитовый AND == True).
  • Не включает ничего (побитовый AND равен False)Побитовая операция AND, где ни один из битов в значении не присутствует в атрибуте (побитовый AND == False).
Value Table
Включить объекты-барьеры
(Дополнительный)

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

  • Отмечено – объекты барьеров проходимости будут включены в результаты трассировки. Это значение по умолчанию
  • Не отмечено – объекты барьеров проходимости не будут включены в результаты трассировки.

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

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

  • Ребра и соединения – настройки проходимости будут применены как к ребрам, так и к соединениям.
  • Только соединения – настройки проходимости будут применены только к соединениям.
  • Только ребра – настройки проходимости будут применены только к ребрам.

  • И соединения, и ребраПроходимость будет применима как к соединениям, так и к ребрам. Это значение по умолчанию
  • Только соединенияПроходимость будет применена только к соединениям.
  • Только ребраПроходимость будет применена только к ребрам.
String
Распространители
(Дополнительный)
  • Распространить BITWISE_ANDСравнивать значения одного объекта со значениями следующего.
  • Распространить MINПолучить минимальное значение.
  • Распространить MAXПолучить максимальное значение.
  • РавноАтрибут равен значению.
  • Не равноАтрибут не равен значению.
  • БольшеАтрибут больше значения.
  • Больше или равноАтрибут больше или равен значению.
  • МеньшеАтрибут меньше значения.
  • Меньше или равноАтрибут меньше или равен значению.
  • Включает значения (побитовый AND равен значению)Побитовая операция AND, где все биты в значении присутствуют в атрибуте (побитовый AND == значение).
  • Не включает значения (побитовый AND не равен значению)Побитовая операция AND, где не все биты в значении присутствуют в атрибуте (побитовый AND != значение).
  • Включает все (побитовый AND равен True)Побитовая операция AND, в которой хотя бы один бит в значении присутствует в атрибуте (побитовый AND == True).
  • Не включает ничего (побитовый AND равен False)Побитовая операция AND, где ни один из битов в значении не присутствует в атрибуте (побитовый AND == False).
Value Table
Обновить контейнеры структурой сети
(Дополнительный)

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

  • Отмечено - контейнеры структурной сети будут обновлены. Это значение по умолчанию
  • Не отмечено – контейнеры структурной сети не будут обновлены.

Этот параметр требует использования Инженерной сети версии 4 или более поздней.

Boolean
Обновить контейнеры специализированной сети
(Дополнительный)

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

  • Отмечено - контейнеры специализированной сети будут обновлены. Это значение по умолчанию
  • Не отмечено – контейнеры специализированной сети не будут обновлены.

Этот параметр требует использования Инженерной сети версии 4 или более поздней.

Boolean
Режим редактирования для версии по умолчанию
(Дополнительный)

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

  • Без событийОбработка событий не будет использоваться для обновлений подсети в версии по умолчанию и в файловой или мобильной базе геоданных. Этот режим редактирования обновляет имя подсети и распространяемые значения на месте. Это значение по умолчанию
  • С событиямиОбработка событий будет использоваться для обновлений подсети в версии по умолчанию и в файловой или мобильной базе геоданных. В этом режиме редактирования выполняется поведение базы геоданных (например, правила атрибутов, отслеживание редактирования и т.д.), когда подсеть обновляется и обновляет имя подсети и распространяемые значения для всех применимых объектов.
Примечание:

Этот параметр требует использования Инженерной сети версии 4 или более поздней.

String
Режим редактирования для именованной версии
(Дополнительный)

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

  • Без событийСобытия для обновлений подсети именованной версии использоваться не будут. Этот режим редактирования обновляет имя подсети и распространяемые значения на месте для объектов, отредактированных в версии. Это значение по умолчанию
  • С событиямиСобытия будут использоваться для обновлений подсети в именованной версии. В этом режиме редактирования выполняется поведение базы геоданных (например, правила атрибутов, отслеживание редактирования и т.д.), когда подсеть обновляется и обновляет имя подсети и распространяемые значения для всех применимых объектов.
Примечание:

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

String
Корректные соединения
(Дополнительный)

Определяет пары группа оборудования/тип оборудования как допустимые соединения для подсети.

Примечание:

Этот параметр требует использования Инженерной сети версии 4 или более поздней.

String
Корректные объекты соединений
(Дополнительный)

Определяет пары группа оборудования/тип оборудования как допустимые объекты соединений для подсети.

Примечание:

Этот параметр требует использования Инженерной сети версии 4 или более поздней.

String
Допустимые контроллеры объектов соединений подсети
(Дополнительный)

Определяет пары группа оборудования/тип оборудования как допустимые контроллеры объектов соединений подсети для подсети.

Примечание:

Этот параметр требует использования Инженерной сети версии 4 или более поздней.

String
Корректные объекты ребер
(Дополнительный)

Определяет пары группа оборудования/тип оборудования как допустимые объекты ребер для подсети.

Примечание:

Этот параметр требует использования Инженерной сети версии 4 или более поздней.

String
Управление IsDirty
(Дополнительный)

Задает возможность управления атрибутом Is dirty в таблице подсетей с помощью операции обновления подсети.

  • Отмечено - атрибут Is dirty будет управляться операцией обновления подсети. Это значение по умолчанию
  • Не отмечено - атрибут Is dirty не будет управляться операцией обновления подсети.

Этот параметр требует использования Инженерной сети версии 5 или более поздней.

Boolean
Включить контейнеры
(Дополнительный)

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

  • Отмечено – объекты контейнера будут включены в результаты трассировки.
  • Не отмечено – объекты контейнера не будут включены в результаты трассировки. Это значение по умолчанию

Этот параметр требует использования Инженерной сети версии 5 или более поздней.

Boolean
Включить содержание
(Дополнительный)

Определяет, будет ли трассировка возвращать содержание контейнеров в качестве результатов.

  • Отмечено – ресурсы объектов контейнеров будут включены в результаты трассировки.
  • Не отмечено – ресурсы объектов контейнеров не будут включены в результаты трассировки. Это значение по умолчанию

Этот параметр требует использования Инженерной сети версии 5 или более поздней.

Boolean
Включить структуры
(Дополнительный)

Определяет, будут ли структурные объекты и другие объекты включены в результаты трассировки.

  • Отмечено – структурные объекты и другие объекты будут включены в результаты трассировки.
  • Не отмечено – структурные объекты и другие объекты не будут включаться в результаты трассировки. Это значение по умолчанию

Этот параметр требует использования Инженерной сети версии 5 или более поздней.

Boolean
Проверить доступность
(Дополнительный)

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

  • Отмечено - будет возвращаться ошибка, если не пространственные объекты соединений или ребер встречаются без необходимой связи содержания, прикрепления или связности в соответствующей иерархии трассируемых объектов.
  • Не отмечено - трассировка не будет проверять неразмещенные объекты и будет возвращать результаты независимо от того, есть ли неразмещенные объекты в иерархии связей для трассируемых объектов. Это значение по умолчанию

Примечание:

Этот параметр требует использования Инженерной сети версии 5 или более поздней.

Boolean

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

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

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

Utility Network

arcpy.un.SetSubnetworkDefinition(in_utility_network, domain_network, tier_name, support_disjoint_subnetwork, {valid_devices}, {valid_subnetwork_controller}, {valid_lines}, {aggregated_line}, {diagram_template}, {summaries}, {condition_barriers}, {function_barriers}, {include_barriers}, {traversability_scope}, {propagators}, {update_structure_features}, {update_container_features}, {edit_mode_for_default_version}, {edit_mode_for_named_version}, {valid_junctions}, {valid_junction_objects}, {valid_junction_object_subnetwork_controller}, {valid_edge_objects}, {manage_subnetwork_isdirty}, {include_containers}, {include_content}, {include_structures}, {validate_locatability})
ИмяОписаниеТип данных
in_utility_network

Входная инженерная сеть, которая содержит подсеть уровня.

Utility Network; Utility Network Layer
domain_network

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

String
tier_name

Имя уровня, содержащего подсеть.

String
support_disjoint_subnetwork

Указывает, поддерживает ли входной уровень несоединенные подсети. Несвязанные подсети - это две или более подсетей, принадлежащих одному уровню с одинаковым названием подсети и при этом непроходимых. Этот параметр доступен только для уровней в специализированных сетях с определением разделенных уровней. Этот параметр задан как SUPPORT_DISJOINT для уровней в доменной сети с иерархическим определением уровней для поддержки несвязанных подсетей.

  • SUPPORT_DISJOINTВходной уровень поддерживает несоединенные подсети.
  • NO_DISJOINTВходной уровень не поддерживает несоединенные подсети. Это значение по умолчанию
Boolean
valid_devices
[valid_devices,...]
(Дополнительный)

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

String
valid_subnetwork_controller
[valid_subnetwork_controller,...]
(Дополнительный)

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

String
valid_lines
[valid_lines,...]
(Дополнительный)

Определяет пары группа оборудования/тип оборудования как допустимые линии для подсети.

String
aggregated_line
[aggregated_line,...]
(Дополнительный)

Допустимые линии с геометрией, которая будет агрегирована для создания объектов SubnetLine. Этот список является поднабором значений, указанных параметром valid_lines.

String
diagram_template
[diagram_template,...]
(Дополнительный)

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

String
summaries
[[Function, Attribute, Filter Name, Filter Operator, Filter Type, Filter Value, Summary Attribute],...]
(Дополнительный)

Задает поле суммирования для хранения результатов функции при вставке или обновлении объектов SubnetLine.

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

  • Function – выбрать среди различных функций вычисления.
  • Attribute – фильтрация по любому из атрибутов сети, определенному в системе.
  • Filter Name – фильтрация результатов функции по имени атрибута.
  • Filter Operator – выбрать среди различных операторов.
  • Filter Type – выбрать из различных типов фильтра.
  • Filter Value – указать определенное значение входного атрибута фильтра.
  • Summary Attribute – поле в классе объектов SubnetLine, в котором будет сохраняться результат функции. В зависимости от выбранной функции и типа сетевого атрибута, только допустимый тип пользовательских атрибутов подсети будет действительным для этого параметра. Если в классе объектов не существует поля для хранения итогового результата, для его добавления можно использовать инструмент Добавить поле. Поле может поддерживать результат только одной сводки; поэтому для каждой сводки требуется собственное поле в классе объектов . См. следующую таблицу допустимых для различных функций типов полей: Таблица допустимых типов полей для поля суммарного атрибута, в зависимости от выбранной функции

Применяются следующие опции значений суммирования Function:

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

Опции значений суммирования Filter 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, где все биты в значении присутствуют в атрибуте (побитовый AND == значение).
  • DOES_NOT_INCLUDE_THE_VALUESПобитовая операция AND, где не все биты в значении присутствуют в атрибуте (побитовый AND != значение).
  • INCLUDES_ANYПобитовая операция AND, в которой хотя бы один бит в значении присутствует в атрибуте (побитовый AND == True).
  • DOES_NOT_INCLUDE_ANYПобитовая операция AND, где ни один из битов в значении не присутствует в атрибуте (побитовый AND == False).

Применяются следующие опции значений суммирования Filter Type:

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

Более подробно о побитовых операторах

Value Table
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, где все биты в значении присутствуют в атрибуте (побитовый AND == значение).
  • DOES_NOT_INCLUDE_THE_VALUESПобитовая операция AND, где не все биты в значении присутствуют в атрибуте (побитовый AND != значение).
  • INCLUDES_ANYПобитовая операция AND, в которой хотя бы один бит в значении присутствует в атрибуте (побитовый AND == True).
  • DOES_NOT_INLCUDE_ANYПобитовая операция AND, где ни один из битов в значении не присутствует в атрибуте (побитовый AND == False).

Более подробно о побитовых операторах

Опции значения 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 – вычислить значения в каждом направлении в отличие от общего глобального значения, например, для барьера функции, который вычисляет суммарную длину фигуры, на которой заканчивается трассировка, если значение больше или равно 4. В общем случае, после того, как вы прошли два ребра со значениями 2, вы уже достигли суммы длин геометрий, равной 4, поэтому трассировка останавливается. Если используются локальные значения, изменяются локальные значения вдоль каждого пути, и трассировка продолжается дальше.

Опции значения function барьеров функций следующие:

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

Опции значения 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, где все биты в значении присутствуют в атрибуте (побитовый AND == значение).
  • DOES_NOT_INCLUDE_THE_VALUESПобитовая операция AND, где не все биты в значении присутствуют в атрибуте (побитовый AND != значение).
  • INCLUDES_ANYПобитовая операция AND, в которой хотя бы один бит в значении присутствует в атрибуте (побитовый AND == True).
  • DOES_NOT_INCLUDE_ANYПобитовая операция AND, где ни один из битов в значении не присутствует в атрибуте (побитовый AND == False).

Более подробно о побитовых операторах

Варианты значений барьера функции Use Local Values:

  • TRUEИспользовать локальные значения.
  • FALSEИспользовать глобальные значения. Это значение по умолчанию
Value Table
include_barriers
(Дополнительный)

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

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

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

  • BOTH_JUNCTIONS_AND_EDGESПроходимость будет применима как к соединениям, так и к ребрам. Это значение по умолчанию
  • JUNCTIONS_ONLYПроходимость будет применена только к соединениям.
  • EDGES_ONLYПроходимость будет применена только к ребрам.
String
propagators
[[Attribute, Substitution Attribute, Function, Operator, Value, Propagated Attribute],...]
(Дополнительный)

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

Компоненты распространителя:

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

Опции значения 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, где все биты в значении присутствуют в атрибуте (побитовый AND == значение).
  • DOES_NOT_INCLUDE_THE_VALUESПобитовая операция AND, где не все биты в значении присутствуют в атрибуте (побитовый AND != значение).
  • INCLUDES_ANYПобитовая операция AND, в которой хотя бы один бит в значении присутствует в атрибуте (побитовый AND == True).
  • DOES_NOT_INCLUDE_ANYПобитовая операция AND, где ни один из битов в значении не присутствует в атрибуте (побитовый AND == False).

Более подробно о побитовых операторах

Примечание:

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

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

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

  • UPDATEКонтейнеры структурной сети будут обновлены. Это значение по умолчанию
  • NOT_UPDATEКонтейнеры структурной сети не будут обновлены.
Примечание:

Этот параметр требует использования Инженерной сети версии 4 или более поздней.

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

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

  • UPDATEКонтейнеры специализированной сети будут обновлены. Это значение по умолчанию
  • NOT_UPDATEКонтейнеры специализированной сети не будут обновлены.
Примечание:

Этот параметр требует использования Инженерной сети версии 4 или более поздней.

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

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

  • WITHOUT_EVENTINGОбработка событий не будет использоваться для обновлений подсети в версии по умолчанию и в файловой или мобильной базе геоданных. Этот режим редактирования обновляет имя подсети и распространяемые значения на месте. Это значение по умолчанию
  • WITH_EVENTINGОбработка событий будет использоваться для обновлений подсети в версии по умолчанию и в файловой или мобильной базе геоданных. В этом режиме редактирования выполняется поведение базы геоданных (например, правила атрибутов, отслеживание редактирования и т.д.), когда подсеть обновляется и обновляет имя подсети и распространяемые значения для всех применимых объектов.
Примечание:

Этот параметр требует использования Инженерной сети версии 4 или более поздней.

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

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

  • WITHOUT_EVENTINGСобытия для обновлений подсети именованной версии использоваться не будут. Этот режим редактирования обновляет имя подсети и распространяемые значения на месте для объектов, отредактированных в версии. Это значение по умолчанию
  • WITH_EVENTINGСобытия будут использоваться для обновлений подсети в именованной версии. В этом режиме редактирования выполняется поведение базы геоданных (например, правила атрибутов, отслеживание редактирования и т.д.), когда подсеть обновляется и обновляет имя подсети и распространяемые значения для всех применимых объектов.
Примечание:

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

String
valid_junctions
[valid_junctions,...]
(Дополнительный)

Определяет пары группа оборудования/тип оборудования как допустимые соединения для подсети.

Примечание:

Этот параметр требует использования Инженерной сети версии 4 или более поздней.

String
valid_junction_objects
[valid_junction_objects,...]
(Дополнительный)

Определяет пары группа оборудования/тип оборудования как допустимые объекты соединений для подсети.

Примечание:

Этот параметр требует использования Инженерной сети версии 4 или более поздней.

String
valid_junction_object_subnetwork_controller
[valid_junction_object_subnetwork_controller,...]
(Дополнительный)

Определяет пары группа оборудования/тип оборудования как допустимые контроллеры объектов соединений подсети для подсети.

Примечание:

Этот параметр требует использования Инженерной сети версии 4 или более поздней.

String
valid_edge_objects
[valid_edge_objects,...]
(Дополнительный)

Определяет пары группа оборудования/тип оборудования как допустимые объекты ребер для подсети.

Примечание:

Этот параметр требует использования Инженерной сети версии 4 или более поздней.

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

Задает возможность управления атрибутом Is dirty в таблице подсетей с помощью операции обновления подсети. Если для уровня не заданы контроллеры подсети, в этом параметре используется опция NOT_MANAGE.

  • MANAGEАтрибут Is dirty будет управляться операцией обновления подсети. Это значение по умолчанию
  • NOT_MANAGEАтрибут Is dirty не будет управляться операцией обновления подсети.
Примечание:

Этот параметр требует использования Инженерной сети версии 5 или более поздней.

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

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

  • INCLUDE_CONTAINERSОбъекты контейнера будут включены в результаты трассировки.
  • EXCLUDE_CONTAINERSОбъекты контейнера не будут включены в результаты трассировки. Это значение по умолчанию

Этот параметр требует использования Инженерной сети версии 5 или более поздней.

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

Определяет, будет ли трассировка возвращать содержание контейнеров в качестве результатов.

  • INCLUDE_CONTENTРесурсы объектов контейнеров будут включены в результаты трассировки.
  • EXCLUDE_CONTENTРесурсы объектов контейнеров не будут включены в результаты трассировки. Это значение по умолчанию

Этот параметр требует использования Инженерной сети версии 5 или более поздней.

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

Определяет, будут ли структурные объекты и другие объекты включены в результаты трассировки.

  • INCLUDE_STRUCTURESСтруктурные объекты будут включены в результаты трассировки.
  • EXCLUDE_STRUCTURESСтруктурные объекты не будут включаться в результаты трассировки. Это значение по умолчанию

Этот параметр требует использования Инженерной сети версии 5 или более поздней.

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

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

  • VALIDATE_LOCATABILITYВозвращается ошибка, если не пространственные объекты соединений или ребер встречаются без необходимой связи содержания, прикрепления или связности в соответствующей иерархии трассируемых объектов.
  • DO_NOT_VALIDATE_LOCATABILITYТрассировка не будет проверять неразмещенные объекты и будет возвращать результаты независимо от того, есть ли неразмещенные объекты в иерархии связей для трассируемых объектов. Это значение по умолчанию
Примечание:

Этот параметр требует использования Инженерной сети версии 5 или более поздней.

Boolean

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

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

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

Utility Network

Пример кода

SetSubnetworkDefinition, пример (автономный скрипт)

В этом примере определение подсети задается в домене ElectricDistribution.

'''****************************************************************************
Name:        SetSubnetworkDefinition.py
Description: This script sets the subnetwork definition for a tier in a Utility Network
Created by:  Esri
****************************************************************************'''

# Import required modules        
import arcpy

# Set local variables
in_utility_network = "ElectricDistribution"
domain_network = "ElecDist"
tier_name = "Medium Voltage"
support_disjoint_subnetwork = "SUPPORT_DISJOINT"
valid_devices = "'CircuitBreaker/Unknown';'CircuitBreaker/Air powered';'NetworkProtector/Unknown';'NetworkProtector/NetworkProtector';'Transformer/Unknown';'Transformer/Buck boost';'Transformer/Single-phase overhead';'Transformer/Single-phase padmounted';'Transformer/Three-phase padmounted';'Transformer/Power';'Transformer/Step';'Transformer/Vault'"
valid_subnetwork_controller = "'CircuitBreaker/Unknown';'CircuitBreaker/Air powered'"
valid_lines = "'Busbar/Unknown';'Busbar/Busbar';'Connector/Unknown';'Connector/Connector';'LowVoltage/Unknown';'LowVoltage/Overhead';'LowVoltage/Underground';'MediumVoltage/Unknown';'MediumVoltage/Single-phase overhead';'MediumVoltage/Two-phase overhead';'MediumVoltage/Three-phase overhead';'MediumVoltage/Single-phase underground';'MediumVoltage/Two-phase underground';'MediumVoltage/Three-phase underground';'IsolatedNeutral/Unknown';'IsolatedNeutral/Concentric neutral';'IsolatedNeutral/Neutral';'SubTransmission/Unknown';'SubTransmission/Overhead';'SubTransmission/Underground'"
aggregated_line = "'Busbar/Unknown';'Busbar/Busbar';'MediumVoltage/Unknown';'MediumVoltage/Single-phase overhead';'MediumVoltage/Two-phase overhead';'MediumVoltage/Three-phase overhead';'MediumVoltage/Single-phase underground';'MediumVoltage/Two-phase underground';'MediumVoltage/Three-phase underground'"
diagram_template = "Basic"
summaries = ""
condition_barriers = "'Device Status' IS_EQUAL_TO SPECIFIC_VALUE 'Opened' #"
function_barriers = ""
include_barriers = "INCLUDE_BARRIERS"
traversability_scope = "BOTH_JUNCTIONS_AND_EDGES"
propagators = ""

# Run the SetSubnetworkDefinition tool
arcpy.SetSubnetworkDefinition_un(in_utility_network, 
                                 domain_network, 
                                 tier_name, 
                                 support_disjoint_subnetwork, 
                                 valid_devices, 
                                 valid_subnetwork_controller, 
                                 valid_lines, 
                                 aggregated_line, 
                                 diagram_template, 
                                 summaries, 
                                 condition_barriers, 
                                 function_barriers, 
                                 include_barriers, 
                                 traversability_scope, 
                                 propagators)

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

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

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

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

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