Наверх

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

В этом разделе

  1. Сводка
  2. Использование
  3. Синтаксис
  4. Пример кода
  5. Environments
  6. Информация о лицензиях

Сводка

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

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

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

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

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

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

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

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

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

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

Синтаксис

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})
ParameterОбъяснениеТип данных
in_utility_network

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

Utility Network; Utility Network Layer
domain_network

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

String
tier_name

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

String
support_disjoint_subnetwork

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

  • 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, где все биты в значении представлены в атрибуте (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).

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

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

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

Value Table
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_INLCUDE_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 – вычисляет значения в каждом направлении, в отличие от общего глобального значения, например, имеется барьер функции, вычисляющей сумму длины периметра, где трассировка прерывается, если значение больше или равно 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, где все биты в значении представлены в атрибуте (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).

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

Варианты значений барьера функции 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 с null. В этом примере замена 1010 (Фаза AC) дает 0000-0010-0000-0000 (512). Замена захватывает сопоставление, т.ч. вы знаете, что Фаза A была сопоставлена с B, а Фаза C с null, а не иначе (например, Фаза A не сопоставлялась с null, а Фаза 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, где все биты в значении представлены в атрибуте (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
update_structure_features
(Дополнительный)

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

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

Для этого параметра требуется Utility Network Release 4 или выше.

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

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

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

Для этого параметра требуется Utility Network Release 4 или выше.

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

Задает режим редактирования для обновлений подсети в версии по умолчанию.

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

Для этого параметра требуется Utility Network Release 4 или выше, и он применим только к многопользовательским базам геоданных.

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

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

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

Для этого параметра требуется Utility Network Release 4 или выше, и он применим только к многопользовательским базам геоданных.

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

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

Примечание:

Для этого параметра требуется Utility Network Release 4 или выше.

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

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

Примечание:

Для этого параметра требуется Utility Network Release 4 или выше.

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

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

Примечание:

Для этого параметра требуется Utility Network Release 4 или выше.

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

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

Примечание:

Для этого параметра требуется Utility Network Release 4 или выше.

String

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

NameОбъяснениеТип данных
out_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)

Environments

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

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

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

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

  • Обзор группы инструментов Администрирование
  • Обзор набора инструментов Инженерная сеть
  • Поиск инструмента геообработки

Отзыв по этому разделу?

В этом разделе
  1. Сводка
  2. Использование
  3. Синтаксис
  4. Пример кода
  5. Environments
  6. Информация о лицензиях