Сводка
Задает свойства уровня специализированной сети для подсети в инженерной сети.
Типы объектов, участвующих в уровне, могут быть ограничены путем определения корректных типов из классов объектов устройств, линий, соединений, объектов ребер и объектов соединений. Задание допустимых типов оборудования помогает обеспечить правильность данных, ограничивая типы объектов, которые могут участвовать в подсети на определенном уровне.
Параметры конфигурации могут использоваться для задания свойств при выполнении трассировки подсети.
Более подробно о настройке определения подсети
Использование
Этот инструмент также позволяет настраивать и изменять определение уровня подсети. Чтобы изменить значения определения уровня подсети, измените значения параметра и снова запустите этот инструмент.
Топология сети должна быть отключена.
- При работе с многопользовательской базой геоданных должны быть выполнены следующие требования:
- Учетная запись подключенного портала ArcGIS Enterprise должна быть записью владельца инженерной сети.
- Входная инженерная сеть должна быть из подключения к базе данных, установленного от имени владельца базы данных инженерной сети.
- Этот инструмент должен быть подключен к версии по умолчанию при выполнении.
Синтаксис
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})
Parameter | Объяснение | Тип данных |
in_utility_network | Входная инженерная сеть, которая содержит подсеть уровня. | Utility Network; Utility Network Layer |
domain_network | Специализированная сеть, которая содержит данный уровень. | String |
tier_name | Имя уровня, содержащего подсеть. | String |
support_disjoint_subnetwork | Указывает, поддерживает ли входной уровень несоединенные подсети. Несвязанные подсети - это две или более подсетей, принадлежащих одному уровню с одинаковым названием подсети и при этом непроходимых. Эта опция доступа только для уровней в специализированных сетях с определением разделенных уровней. У уровней в специализированной сети с иерархическим определением уровней это свойство всегда задано как SUPPORT_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 следующие:
Опции значений суммирования Filter Operator следующие:
Опции значений суммирования Filter Type следующие:
| Value Table |
condition_barriers [[Name, Operator, Type, Value, Combine Using],...] (Дополнительный) | Задает условия проходимости барьеров в объекте на основании сравнения с сетевым атрибутом или проверки строки категории. Барьер условия использует атрибут сети, оператор и тип, а также значение атрибута. Например, остановите трассировку, если атрибут Device Status объекта равен определенному значению Open. Если объект удовлетворяет этому условию, трассировка остановится. При использовании более одного атрибута, можно применить параметр Комбинировать использование, чтобы задать условие И или Или. Применяются следующие компоненты барьера условий:
Значения барьера условий operator:
Более подробно о побитовых операторах Варианты значений барьеров условий Type следующие:
Значения Combine Using:
Более подробно об использовании множественных условных выражений | Value Table |
function_barriers [[Function, Attribute, Operator, Value, Use Local Values],...] (Дополнительный) | Задает барьер проходимости на объектах на основе функции. Барьеры функций можно применять для ограничения того, насколько далеко трассировка может уйти от начальной точки, или установки максимального значения, при котором трассировка остановится. Например, длина каждой пройденной линии добавляется к общему пройденному на данный момент расстоянию. Когда общая пройденная длина достигнет указанного значения, трассировка остановится. Применяются следующие компоненты барьера функций:
Варианты значений барьера функции function следующие:
Варианты значений барьера функции operator следующие:
Более подробно о побитовых операторах Варианты значений барьера функции Use Local Values следующие:
| Value Table |
include_barriers (Дополнительный) | Определяет, будут ли объекты-барьеры проходимости включены в результаты трассировки. Включение барьеров проходимости являются дополнительной опцией, даже если они представлены в определении подсети.
| Boolean |
traversability_scope (Дополнительный) | Тип принудительной проходимости. Область проходимости определяет, будут ли применены настройки проходимости для соединений, ребер или для обоих. Например, если условный барьер задан для остановки трассировки в случае, когда Device Status равно Open и область проходимости задано только по ребрам, трассировка не остановится, даже при обнаружении открытого устройства, поскольку Device Status применимо только к узлам. Другими словами, параметр показывает, что трассировка должна игнорировать ребра, соединения, или и то и другое.
| String |
propagators [[Attribute, Substitution Attribute, Function, Operator, Value, Propagated Attribute],...] (Дополнительный) | Указывает сетевые атрибуты для распространения, а также то, как это распространение будет происходить во время трассировки. Класс распространяющихся атрибутов определяет ключевое значение для контроллеров подсети, которое будет распределено по остальным объектам подсети. Например, в модели электрической сети вы можете распространить значение фазы. Используются следующие компоненты распространения:
Варианты значений распространителей function следующие:
Варианты значений распространителей operator следующие:
Более подробно о побитовых операторах Примечание:Этот параметр доступен только в Python. | Value Table |
update_structure_features (Дополнительный) | Определяет, будет ли в ходе обработки подсети обновляться поддерживаемый атрибут имени подсети для контейнеров структурной сети.
Примечание:Этот параметр требует использования Инженерной сети версии 4 или более поздней. | Boolean |
update_container_features (Дополнительный) | Определяет, будет ли в процессе обновления подсети обновляться имя поддерживаемый подсети для контейнеров специализированной сети.
Примечание:Этот параметр требует использования Инженерной сети версии 4 или более поздней. | Boolean |
edit_mode_for_default_version (Дополнительный) | Задает режим редактирования для обновлений подсети в версии по умолчанию и в файловых базах геоданных.
Примечание:Этот параметр требует использования Инженерной сети версии 4 или более поздней. | String |
edit_mode_for_named_version (Дополнительный) | Задает режим редактирования для обновлений подсети в именованной версии.
Примечание:Этот параметр требует использования Инженерной сети версии 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.
Примечание:Этот параметр требует использования Инженерной сети версии 5 или более поздней. | Boolean |
include_containers (Дополнительный) | Определяет, будут ли объекты контейнера включены в результаты трассировки.
Этот параметр требует использования Инженерной сети версии 5 или более поздней. | Boolean |
include_content (Дополнительный) | Определяет, будет ли трассировка возвращать содержание контейнеров в качестве результатов.
Этот параметр требует использования Инженерной сети версии 5 или более поздней. | Boolean |
include_structures (Дополнительный) | Определяет, будут ли структурные объекты и другие объекты включены в результаты трассировки.
Этот параметр требует использования Инженерной сети версии 5 или более поздней. | Boolean |
validate_locatability (Дополнительный) | Задает, будет ли возвращаться ошибка во время трассировки или обновления подсети, если непространственное соединение или объекты ребер встречаются без необходимого контейнера, вложения, или соединения связности в соответствующей иерархии трассируемых объектов. Этот опция гарантирует, что непространственные объекты, возвращенные трассировкой или обновлением подсети, могут быть размещены через связность с объектами или другими размещаемыми объектами.
Примечание:Этот параметр требует использования Инженерной сети версии 5 или более поздней. | Boolean |
Производные выходные данные
Name | Объяснение | Тип данных |
out_utility_network | Обновленная входная инженерная сеть. | Инженерная сеть |
Пример кода
В этом примере определение подсети задается в домене 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: Да