Наверх

Трассировка (Инженерная сеть)

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

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

Сводка

Возвращает выбранные объекты на основе связности или проходимости от выбранных начальных точек.

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

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

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

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

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

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

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

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

  • При выполнении трассировки на основе подсети, с помощью инструмента Трассировка через Python, Конфигурация трассировки подсети определение подсети не используется для входных данных Уровня и должна быть задана вручную.

Синтаксис

Trace(in_utility_network, trace_type, {starting_points}, {barriers}, {domain_network}, {tier}, {target_tier}, {subnetwork_name}, {shortest_path_network_attribute_name}, {include_containers}, {include_content}, {include_structures}, {include_barriers}, {validate_consistency}, {condition_barriers}, {function_barriers}, {traversability_scope}, {filter_barriers}, {filter_function_barriers}, {filter_scope}, {filter_bitset_network_attribute_name}, {filter_nearest}, {nearest_count}, {nearest_cost_network_attribute}, {nearest_categories}, {nearest_assets}, {functions}, {propagators}, {output_assettypes}, {output_conditions}, {include_isolated_features}, {ignore_barriers_at_starting_points}, {include_up_to_first_spatial_container}, {result_types}, selection_type, {clear_all_previous_trace_results}, {trace_name}, {aggregated_points}, {aggregated_lines}, {aggregated_polygons})
ParameterОбъяснениеТип данных
in_utility_network

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

Utility Network; Utility Network Layer
trace_type

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

  • CONNECTED — Подключенная трассировка начинается с одной или более начальных точек и разворачивается наружу вдоль соединенных объектов. Используется по умолчанию.
  • SUBNETWORK — Трассировка подсети начинается с одной или более начальных точек и разворачивается наружу, охватывая весь экстент подсети.
  • SUBNETWORK_CONTROLLERS —Трассировка контроллеров подсети определяет источники и локальные понижения на контроллерах подсети, связанных с подсетью.
  • UPSTREAM —Трассировка вверх против течения обнаруживает объекты выше по течению от местоположения в сети.
  • DOWNSTREAM —Трассировка вниз по течению обнаруживает объекты ниже по течению от местоположения в сети.
  • LOOPS — Петли - это районы сети, где направление потока не определено. Трассировка петель разворачивается наружу от начальной точки на основе связности.
  • SHORTEST_PATH —Трассировка кратчайшего пути определяет кратчайший путь между двумя начальными точками.
  • ISOLATION —Трассировка изоляции находит объекты, которые изолируют некоторую область сети.
String
starting_points
(Дополнительный)

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

Feature Layer
barriers
(Дополнительный)

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

Feature Layer
domain_network
(Дополнительный)

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

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

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

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

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

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

Имя подсети, где будет выполняться трассировка. Этот параметр можно использовать при запуске трассировки с типом трассировка подсети. Если указано имя подсети, параметр Начальные точки (параметр starting_points в Python) не требуется.

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

Атрибут сети, используемый для вычисления кратчайшего пути. При запуске трассировки типа кратчайший путь, кратчайший путь вычисляется с помощью числового атрибута сети, такого как Длина объекта. Могут быть вычислены пути как на основе стоимости, так и на основе расстояния. Этот параметр является обязательным при запуске трассировки кратчайшего пути.

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

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

  • INCLUDE_CONTAINERS —Объекты-контейнеры будут включены в результаты трассировки.
  • EXCLUDE_CONTAINERS —Объекты-контейнеры не будут включаться в результаты трассировки. Используется по умолчанию.
Boolean
include_content
(Дополнительный)

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

  • INCLUDE_CONTENT —Содержание объектов-контейнеров будет включено в результаты трассировки.
  • EXCLUDE_CONTENT —Содержание объектов-контейнеров не будет включаться в результаты трассировки. Используется по умолчанию.
Boolean
include_structures
(Дополнительный)

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

  • INCLUDE_STRUCTURES —Структурные объекты и другие объекты будут включены в результаты трассировки.
  • EXCLUDE_STRUCTURES —Структурные объекты и другие объекты не будут включаться в результаты трассировки. Используется по умолчанию.
Boolean
include_barriers
(Дополнительный)

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

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

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

  • VALIDATE_CONSISTENCY —Трассировка возвратит ошибку в случае обнаружения измененных областей для любого из пройденных объектов. Используется по умолчанию.
  • DO_NOT_VALIDATE_CONSISTENCY —Трассировка возвращает результаты независимо от обнаружения измененных областей для любых из пройденных объектов.
Boolean
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 —Использовать, если встречается любой из барьеров условий.

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

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 —Cумма значений.
  • 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
traversability_scope
(Дополнительный)

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

  • BOTH_JUNCTIONS_AND_EDGES —Применить проходимость к соединениям и ребрам. Используется по умолчанию.
  • JUNCTIONS_ONLY —Применить проходимость только к соединениям.
  • EDGES_ONLY —Применить проходимость только к ребрам.
String
filter_barriers
[[Name, Operator, Type, Value, Combine Using],...]
(Дополнительный)

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

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

  • 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
filter_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 —Cумма значений.
  • 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
filter_scope
(Дополнительный)

Определяет, будет ли использоваться фильтр для определенной категории – только для соединений, только для ребер или в обоих перечисленных случаях. Например, если задан фильтр-барьер, который должен прекращать трассировку в случае, когда Статус устройства равен значению Открыто, и область действия проходимости задана только для ребер, то даже в случае, если эта трассировка обнаружит открытое устройство, она не будет прекращена, поскольку Статус устройства применяется только к соединениям. Другими словами, параметр показывает, что трассировка должна игнорировать ребра, соединения, или и то и другое.

  • BOTH_JUNCTIONS_AND_EDGES —Фильтр будут применен как к соединениям, так и к ребрам. Используется по умолчанию.
  • JUNCTIONS_ONLY —Фильтр будет применен только к соединениям.
  • EDGES_ONLY —Фильтр будет применен только к ребрам.
String
filter_bitset_network_attribute_name
(Дополнительный)

Имя атрибута сети, который может быть использован для фильтрации по битовому множеству. Этот параметр применяется только для трассировки типа вверх против течения, вниз по течению и петли. Этот параметр может быть использован для добавления специальной логики во время трассировки, чтобы трассировка могла полнее отражать сценарии реального мира. Например, при трассировке петель атрибут сети Текущие фазы может определить, является ли петля истинной электрической петлей (та же фаза проходит вдоль всей петли, то есть А) и возвратить для результатов трассировки только реальные электрические петли. Пример трассировки вверх против течения: при трассировке сети электрического распределения, указав атрибут сети Текущие фазы, вы получите в качестве результатов трассировки только корректные пути, которые указаны в атрибуте сети, а не все пути.

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

Определяет, будет ли использоваться алгоритм K-ближайших соседей для возврата объектов определенного типа в пределах заданного расстояния. Используя этот параметр, вы можете указать количество, стоимость, а также либо набор категорий, либо тип оборудования, либо и то, и другое.

  • FILTER_BY_NEAREST —Алгоритм K ближайших соседей будет использоваться для возврата объектов в количестве, указанном в параметрах nearest_count, nearest_cost_network_attribute, nearest_categories или nearest_assets.
  • DO_NOT_FILTER —Алгоритм K-ближайших соседей не будет использоваться для фильтрации результатов. Используется по умолчанию.
Boolean
nearest_count
(Дополнительный)

Определяет число возвращаемых объектов, когда значением filter_nearest является True.

Long
nearest_cost_network_attribute
(Дополнительный)

Числовой атрибут сети, который будет использоваться для вычисления степени близости, стоимости или расстояния, когда filter_nearest – True, например, длина объекта.

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

Возвращаемые категории, когда filter_nearest – True, например – Protective.

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

Группы оборудования и типы оборудования, возвращаемые когда filter_nearest – True, например – ElectricDistributionDevice/Transformer/Step Down.

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

Применяет функцию вычисления к результатам трассировки.

Компоненты функций следующие:

  • Function – выбрать среди различных функций вычисления.
  • Attribute – фильтрация по любому из атрибутов сети, определенному в системе.
  • Filter Name – Фильтрация результатов функции по имени атрибута.
  • Filter Operator – выбрать среди различных операторов.
  • Filter Type – выберите один из различных типов фильтра.
  • Filter Value – укажите определенное значение входного атрибута фильтра.

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

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

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

Опции значения 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
propagators
[[Attribute, Substitution Attribute, Function, Operator, Value],...]
(Дополнительный)

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

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

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

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

  • PROPAGATED_BITWISE_AND —Сравнивать значения одного объекта со значениями следующего.
  • PROPAGATED_MIN —Получить минимальное значение.
  • PROPAGATED_MAX —Получить максимальное значение.

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

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

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

Примечание:

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

Value Table
output_assettypes
[output_assettypes,...]
(Дополнительный)

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

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

Определяет типы возвращаемых объектов в зависимости от сетевого атрибута или категории. Например, если трассировка настроена на фильтрацию всех объектов, кроме Водоотводов, любые трассированные объекты, которым не присвоена категория Водоотвод, не будут включены в результаты. Любые трассированные объекты с этой категорией будут возвращены в итоговом наборе выборки. Если используется более одного атрибута, можно использовать опцию Combine Using, чтобы задать условие И или Или.

Компоненты выходных условий следующие:

  • 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 —Использовать, если выполняется любое из условий.

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

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

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

  • INCLUDE_ISOLATED_FEATURES —Изолированные объекты будут включаться в результаты трассировки.
  • EXCLUDE_ISOLATED_FEATURES —Изолированные объекты не будут включаться в результаты трассировки. Используется по умолчанию.
Примечание:

Тип трассировки Изоляция требует ArcGIS Enterprise 10.7 или более поздней версии, если используется многопользовательская база геоданных.

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

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

  • IGNORE_BARRIERS_AT_STARTING_POINTS —Барьеры в начальных точках будут проигнорированы при трассировке.
  • DO_NOT_IGNORE_BARRIERS_AT_STARTING_POINTS —Барьеры в начальных точках не будут проигнорированы при трассировке. Используется по умолчанию.
Boolean
include_up_to_first_spatial_container
(Дополнительный)

Указывает, следует ли ограничить возвращаемые контейнеры включением только тех, которые встречаются до первого пространственного контейнера для каждого элемента сети в результатах трассировки и включая их. Если пространственные контейнеры не встречаются, но для данного элемента сети присутствуют не пространственные контейнеры, то все не пространственные контейнеры будут включены в результаты. Параметр применим, только когда включен Include Containers.

  • INCLUDE_UP_TO_FIRST_SPATIAL_CONTAINER —Возвращает все контейнеры в результате трассировки для элемента сети вплоть до первого пространственного контейнера включительно, когда на пути трассировки встречаются вложенные связи содержания. Если пространственных контейнеров не существует, то все не пространственные контейнеры будут включены в результаты для данного элемента сети.
  • DO_NOT_INCLUDE_UP_TO_FIRST_SPATIAL_CONTAINER —В результаты попадут все контейнеры. Используется по умолчанию.
Boolean
result_types
[result_types,...]
(Дополнительный)

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

  • SELECTION — Результаты трассировки возвращаются в виде набора выбранных соответствующих сетевых объектов. Используется по умолчанию.
  • AGGREGATED_GEOMETRY — Результаты операции трассировки агрегируются по типу геометрии и сохраняются в сложных классах объектов, отображающихся в виде слоев активной карты.
String
selection_type

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

  • NEW_SELECTION —Результирующая выборка заменяет текущую. Используется по умолчанию.
  • ADD_TO_SELECTION —Результирующая выборка добавляется к текущей, если таковая существует. Если никакой выборки нет, данная опция работает так же, как и опция создания новой выборки.
  • REMOVE_FROM_SELECTION —Результирующая выборка удаляется из текущей выборки. Если во входном слое объекты не были выбраны, выбор данной опции не приведет ни к какому результату.
  • SUBSET_SELECTION —Результирующая выборка комбинируется с текущей. Выбранными останутся только те записи, которые являются общими для обеих выборок.
  • SWITCH_SELECTION —Результирующая выборка переключена. Результаты, которые были выбраны, удаляются из нее, а все ранее не выбранные результаты добавляются к текущей выборке. Если никакой выборки нет, данная опция работает так же, как и опция создания новой выборки.
String
clear_all_previous_trace_results
(Дополнительный)

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

  • CLEAR_ALL_PREVIOUS_TRACE_RESULTS — Классы объектов, хранящие агрегированную геометрию трассировки, будут усечены. Будет записана только выходная геометрия из текущей операции трассировки. Используется по умолчанию.
  • DO_NOT_CLEAR_ALL_PREVIOUS_TRACE_RESULTS —Выходная геометрия текущей операции трассировки будет присоединена к классам объектов, хранящим агрегированную геометрию.
Boolean
trace_name
(Дополнительный)

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

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

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

Этот класс объектов будет создан автоматически, если он не существует. Существующий класс объектов также может использоваться для хранения агрегированной геометрии. При использовании класса объектов, отличного от класса объектов по умолчанию, это должен быть класс мультиточечных объектов, содержащий текстовое поле TRACENAME. Этот параметр применим только для типа результатов Агрегированная геометрия.

Feature Class
aggregated_lines
(Дополнительный)

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

Этот класс объектов будет создан автоматически, если он не существует. Существующий класс объектов также может использоваться для хранения агрегированной геометрии. При использовании класса объектов, отличного от класса объектов по умолчанию, это должен быть класс полилинейных объектов, содержащий текстовое поле TRACENAME. Этот параметр применим только для типа результатов Агрегированная геометрия.

Feature Class
aggregated_polygons
(Дополнительный)

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

Этот класс объектов будет создан автоматически, если он не существует. Существующий класс объектов также может использоваться для хранения агрегированной геометрии. При использовании класса объектов, отличного от класса объектов по умолчанию, это должен быть класс полигональных объектов, содержащий текстовое поле TRACENAME. Этот параметр применим только для типа результатов Агрегированная геометрия.

Feature Class

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

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

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

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

Пример кода

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

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

'''****************************************************************************
Name:        DownstreamTrace.py
Description: This script executes a downstream trace on the Medium Voltage tier 
             that adds up the transformer load on phases A, B, and C.
Created by:  Esri
****************************************************************************'''

# Import required modules        
import arcpy

# Set local variables
in_utility_network = "NapervilleElectric Utility Network"
trace_type = "DOWNSTREAM"
starting_points = "C:\\MyProject\\Bissell.gdb\UN_Temp_Starting_Points"
barriers = "C:\\MyProject\\Bissell.gdb\UN_Temp_Barriers"
domain_network = "ElectricDistribution"
tier = "Medium Voltage Radial"
include_containers = "INCLUDE_CONTAINERS"
include_structures = "INCLUDE_STRUCTURES"
condition_barriers = "'Device Status' IS_EQUAL_TO SPECIFIC_VALUE 1 #"
functions = "ADD 'Transformer Load' 'Phases Normal' INCLUDES_THE_VALUES SPECIFIC_VALUE 4;ADD 'Transformer Load' 'Phases Normal' INCLUDES_THE_VALUES SPECIFIC_VALUE 2;ADD 'Transformer Load' 'Phases Normal' INCLUDES_THE_VALUES SPECIFIC_VALUE 1"

# Run Trace with specified parameters and leave the rest default
arcpy.Trace_un(in_utility_network, 
               trace_type, 
               starting_points, 
               barriers, 
               domain_network, 
               tier,
               include_containers=include_containers,
               include_structures=include_structures,
               condition_barriers=condition_barriers,
               functions=functions)

Environments

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

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

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

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

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

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

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