Наверх

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

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

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

Сводка

Экспортирует контроллеры подсети из инженерной сети в файл JSON. Инструмент также позволяет удалить строку в таблице Подсети, если для атрибута Is deleted установлено значение true. Это означает, что контроллер подсети удален из подсети.

Подробнее об экспорте подсетей

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

  • Подсети должны быть чистыми; сначала запустите инструмент Обновить подсеть.

  • Параметры в категории Trace Parameters могут исполняться только в Python.

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

  • Когда параметр Задать экспорт подтвержденным включен, должно соблюдаться следующее:

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

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

  • В версии ArcGIS Pro 2.3 добавлены следующие параметры: Включить геометрию, Типы результатов, Итоговые атрибуты сети и Поля результатов. При использовании этих параметров, формат выходного файла JSON может отличаться. Эти параметры требуют ArcGIS Enterprise 10.7 или более поздней версии при использовании с многопользовательской базой геоданных. Просмотр выходного синтаксиса ответа JSON.

Синтаксис

arcpy.un.ExportSubnetwork(in_utility_network, domain_network, tier, subnetwork_name, export_acknowledged, out_json_file, {condition_barriers}, {function_barriers}, {include_barriers}, {traversability_scope}, {propagators}, {include_geometry}, {result_types}, {result_network_attributes}, {result_fields})
ParameterОбъяснениеТип данных
in_utility_network

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

Utility Network; Utility Network Layer
domain_network

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

String
tier

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

String
subnetwork_name

Имя Подсети, которая будет экспортироваться. Выберите конкретный источник для экспорта соответствующей информации о подсети.

String
export_acknowledged

Определяет, будет ли обновлен атрибут LASTACKEXPORTSUBNETWORK для соответствующего контроллера в таблице Подсети и объект в классе SubnetLine.

  • ACKNOWLEDGE —Установлено – атрибут LASTACKEXPORTSUBNETWORK обновляется для соответствующего контроллера в таблице Подсети. Если источник был отмечен для удаления (Is deleted = True), он будет удален из таблицы Подсети. Этот параметр требует, чтобы входная инженерная сеть ссылалась на версию по умолчанию.
  • NO_ACKNOWLEDGE —Атрибут LASTACKEXPORTSUBNETWORK не обновляется для соответствующего контроллера в таблице Подсети. Это значение по умолчанию Короткое целое.
Boolean
out_json_file

Имя и местоположение создаваемого файла JSON.

File
condition_barriers
[[Name, Operator, Type, Value, Combine Using],...]
(Дополнительный)

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

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

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

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

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

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

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

Значения Combine Using:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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_INLCUDE_ANY —Побитовый оператор AND, где ни один из битов в значении не представлен в атрибуте (bitwise AND == value).
Примечание:

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

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

Выберите, включить ли геометрию в результаты.

  • INCLUDE_GEOMETRY —Включить геометрию в результаты.
  • EXCLUDE_GEOMETRY —Не включать геометрию в результаты. Это значение по умолчанию Короткое целое.
Примечание:

Для многопользовательских баз геоданных этот параметр требует наличия версии ArcGIS Enterprise 10.7 или более поздней.

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

Задает тип результатов экспорта.

  • CONNECTIVITY —Возвращает объекты, которые связаны через совпадение геометрии или связь связности. Это значение по умолчанию Короткое целое.
  • FEATURES —Вернуть в ответе информацию об уровнях объектов.
  • CONTAINMENT_AND_ATTACHMENT_ASSOCIATIONS —Возвращает объекты, которые связаны с помощью содержания или прикрепления к структуре.
Примечание:

Для многопользовательских баз геоданных этот параметр требует наличия версии ArcGIS Enterprise 10.7 или более поздней.

  • Опции связей содержания и прикрепления к структуре доступны в версии ArcGIS Enterprise 10.8.1 или более поздней.

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

Атрибуты сети будут включены в результаты.

Примечание:

Для многопользовательских баз геоданных этот параметр требует наличия версии ArcGIS Enterprise 10.7 или более поздней.

String
result_fields
[[Feature Class, Field Name],...]
(Дополнительный)

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

Примечание:

Для многопользовательских баз геоданных этот параметр требует наличия версии ArcGIS Enterprise 10.7 или более поздней.

Value Table

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

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

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

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

Пример кода

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

Экспорт соответствующей информации подсети для источника с названием RMT002 в файл JSON.

import arcpy
arcpy.ExportSubnetwork_un("Utility Network", "ElectricDistribution", 
                          "Medium Voltage", "RMT002", "ACKNOWLEDGE", 
                          "C:\\Temp\\RMT002clean.json")

Environments

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

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

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

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

  • Обзор набора инструментов Инженерная сеть
  • Поиск инструмента геообработки
  • Трассировка
  • ОБновить Is Connected
  • Обновление подсети
  • Проверить топологию сети

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

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