Наверх

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • При работе с сетевыми атрибутами, назначенными полю дат для барьеров фильтров, барьеров функций фильтра, функций и выходных условий, формат значения даты должен быть отформатирован как yyyy-mm-dd hh:mm:ss, например, .2020-10-12 18:45:31

Параметры

ДиалогPython

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

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

Utility Network; Utility Network Layer
Тип трассировки

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

  • Подключенная—Будет использоваться подключенная трассировка, которая начинается в одной или нескольких начальных точек и распространяется наружу вдоль связанных объектов. Это значение по умолчанию
  • Подсеть—Будет использоваться трассировка подсети, которая начинается с одной или более начальных точек и разворачивается наружу, охватывая весь экстент подсети. Эта опция поддерживается только для использования с традиционными специализированными сетями.
  • Контроллеры подсети—Будет использоваться трассировка контроллеров подсети, которая определяет источники и приемники на контроллерах подсети, связанных с подсетью. Эта опция поддерживается только для использования с традиционными специализированными сетями.
  • Вверх по течению—Будет использоваться трассировка вверх по течению, которая обнаруживает объекты выше по течению от местоположения в сети. Эта опция поддерживается только для использования с традиционными специализированными сетями, если не включен параметр Использовать направление оцифровки.
  • Вниз по течению—Будет использоваться трассировка вниз по течению, которая обнаруживает объекты ниже по течению от местоположения в сети. Эта опция поддерживается только для использования с традиционными специализированными сетями, если не включен параметр Использовать направление оцифровки.
  • Петли—Будет использоваться трассировка петель, которая разворачивается наружу от начальной точки на основе связности. Петли - это районы сети, где направление потока не определено.
  • Кратчайший путь—Будет использоваться трассировка кратчайшего пути, которая определяет кратчайший путь между двумя начальными точками.
  • Изоляция—Будет использоваться трассировка изоляции, которая находит объекты, изолирующие некоторую область сети. Эта опция поддерживается только для использования с традиционными специализированными сетями.
String
Начальные точки
(Дополнительный)

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

Feature Layer; Table View
Барьеры
(Дополнительный)

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

Feature Layer; Table View
Специализированная сеть
(Дополнительный)

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

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

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

String
Целевой уровень
(Дополнительный)

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

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

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

String
Имя сетевого атрибута кратчайшего пути
(Дополнительный)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Value Table
Барьеры функции
(Дополнительный)

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

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

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

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

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

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

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

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

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

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

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

  • И соединения, и ребра—Проходимость будет применима как к соединениям, так и к ребрам. Это значение по умолчанию
  • Только соединения—Проходимость будет применена только к соединениям.
  • Только ребра—Проходимость будет применена только к ребрам.
String
Фильтр барьеров
(Дополнительный)

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

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

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

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

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

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

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

Value Table
Фильтр барьеров функции
(Дополнительный)

Фильтрует результаты трассировки на определенную категорию.

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

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

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

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

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

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

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

Value Table
Применить фильтр к
(Дополнительный)

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

  • Ребра и соединения – фильтр будет применен как к соединениям, так и к ребрам. Это значение по умолчанию
  • Только соединения – фильтр будет применен только к соединениям.
  • Только ребра – фильтр будет применен только к ребрам.

  • И соединения, и ребра—Фильтр будут применен как к соединениям, так и к ребрам. Это значение по умолчанию
  • Только соединения—Фильтр будет применен только к соединениям.
  • Только ребра—Фильтр будет применен только к ребрам.
String
Фильтр по сетевому атрибуту битового множества
(Дополнительный)

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

String
Фильтр по ближайшему
(Дополнительный)

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

  • Отмечено – алгоритм K ближайших соседей будет использоваться для возврата объектов в количестве, как указано в параметрах Количество, Стоимость атрибута сети, Категории ближайших или Группы/Типы ближайшего оборудования.
  • Не отмечено – Алгоритм K-ближайших соседей не будет использоваться для фильтрации результатов. Это значение по умолчанию

Boolean
Количество
(Дополнительный)

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

Long
Стоимость атрибута сети
(Дополнительный)

Числовой атрибут сети, который будет использоваться для вычисления степени близости, стоимости или расстояния при включенной опции Фильтр по ближайшему – например, длина объекта.

String
Категории ближайших
(Дополнительный)

Возвращаемые категории, когда включена опция Фильтр по ближайшему, например – Protective.

String
Группы/Типы ближайшего оборудования
(Дополнительный)

Группы оборудования и типы оборудования, возвращаемые при включенной опции Фильтр по ближайшему, например – ElectricDistributionDevice/Transformer/Step Down.

String
Функции
(Дополнительный)

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

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

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

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

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

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

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

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

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

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

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

  • Среднее—Будет рассчитано среднее входных значений.
  • Количество—Будет определено количество объектов.
  • Максимум—Будет определено максимальное из входных значений.
  • Минимум—Будет определено минимальное из входных значений.
  • Добавить—Будет вычислена сумма входных значений.
  • Вычесть—Будет вычислена разница между входными значениями.Контроллеры подсети и циклические трассировки не поддерживаются функцией вычитания.
Value Table
Распространители
(Дополнительный)

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

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

  • 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 распространителей следующие:

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

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

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

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

Value Table
Выходные типы оборудования
(Дополнительный)

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

String
Выходные условия
(Дополнительный)

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

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

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

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

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

Опции значения Тип выходных условий следующие:

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

Value Table
Включить изолирующие объекты
(Дополнительный)

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

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

Boolean
Игнорировать барьеры в начальных точках
(Дополнительный)

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

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

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

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

  • Отмечено - только контейнеры, встречающиеся до первого пространственного контейнера включительно, будут возвращены в результатах, если на пути трассировки встретятся вложенные связи содержания. Если пространственных контейнеров не существует, то все не пространственные контейнеры будут включены в результаты для данного элемента сети.
  • Не отмечено – в результаты попадут все контейнеры. Это значение по умолчанию
Boolean
Типы результатов
(Дополнительный)

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

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

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

  • Элементы—Результаты трассировки будут возвращены в виде информации на основе объектов в указанном выходном файле .json для пройденных сетевых объектов. Эта опция активирует параметр Выходной JSON.
  • Объекты—Результаты трассировки будут возвращены в виде информации на основе объектов в указанном выходном файле .json для пройденных сетевых объектов. Эта опция включает параметры Включить геометрию, Включить описания домена, Итоговые атрибуты сети, Поля результатов и Выходной JSON.
    Примечание:

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

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

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

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

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

String
Тип выборки

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

  • Новая выборка—Результирующая выборка заменяет текущую. Это значение по умолчанию
  • Добавить к текущей выборке—Результирующая выборка добавляется к текущей, если таковая существует. Если никакой выборки нет, данная опция работает так же, как и опция создания новой выборки.
  • Удалить из текущей выборки—Результирующая выборка будет удалена из текущей выборки. Если во входном слое объекты не были выбраны, выбор данной опции не приведет ни к какому результату.
  • Выбрать поднабор из текущей выборки.—Результирующая выборка будет соединена с текущей выборкой. Выбранными останутся только те записи, которые являются общими для обеих выборок.
  • Переключить текущую выборку—Результирующая выборка будет переключена. Результаты, которые были выбраны, удаляются из текущей выборки, а все ранее не выбранные записи добавляются к текущей выборке. Если никакой выборки нет, данная опция работает так же, как и опция создания новой выборки.
String
Очистить все результаты предыдущей трассировки
(Дополнительный)

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

  • Отмечено - классы объектов, хранящие агрегированную геометрию трассировки, будут усечены. Будет записана только выходная геометрия из текущей операции трассировки. Это значение по умолчанию
  • Не отмечено - выходная геометрия текущей операции трассировки будет присоединена к классам объектов, хранящим агрегированную геометрию.
Boolean
Имя трассировки
(Дополнительный)

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

String
Агрегированные точки
(Дополнительный)

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

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

Feature Class
Агрегированные линии
(Дополнительный)

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

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

Feature Class
Агрегированные полигоны
(Дополнительный)

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

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

Feature Class
Разрешение неопределенного потока
(Дополнительный)

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

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

Примечание:

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

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

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

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

Примечание:

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

Boolean
Использовать конфигурацию трассировки
(Дополнительный)

Определяет, будет ли использоваться существующая именованная конфигурация трассировки для заполнения параметров инструмента.

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

Примечание:

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

Boolean
Имя конфигурации трассировки
(Дополнительный)

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

Примечание:

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

String
Выходной JSON
(Дополнительный)

Имя и расположение файла .json, который будет создан при возвращении результатов трассировки с использованием типов результатов связности, элементов, объектов или связей содержания и прикрепления.

File
Запустить в асинхронном режиме на сервере
(Дополнительный)

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

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

Примечание:

Для этого параметра требуется ArcGIS Enterprise 10.9.1 или более новая версия.

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

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

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

Примечание:

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

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

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

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

Примечание:

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

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

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

Примечание:

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

String
Поля результатов
(Дополнительный)

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

Примечание:

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

Value Table
Использовать направление оцифровки
(Дополнительный)

Указывает, будут ли операции трассировки вверх и вниз по течению определять направление потока, используя оцифрованное направление линии, глобальный ID От и До объекта ребра в ассоциации и атрибут Flow direction. Этот параметр доступен и активен только для инженерной сети версии 7 и более поздних версий, если для параметра Тип трассировки задано значение Вверх по течению или Вниз по течению.

  • Отмечено - Операции трассировки определят направление потока, используя направление оцифровки линии, global ID идентификаторы От и До (From и To) объекта ребра в соединении, а также атрибут направления потока. Если этот параметр включен, распространители, настроенные на уровне, будут проигнорированы, а параметры Специализированная сеть, Уровень и Целевой уровень скрываются и игнорируются.
  • Не отмечено — операции трассировки будут определять направление потока на основе местоположения контроллеров подсети. Это значение по умолчанию

Примечание:

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

Boolean
Синтезировать геометрию
(Дополнительный)

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

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

Примечание:

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

Boolean
Поля связанных записей
(Дополнительный)

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

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

Value Table

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

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

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

Utility Network

arcpy.un.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}, {allow_indeterminate_flow}, {validate_locatability}, {use_trace_config}, {trace_config_name}, {out_json_file}, {run_async}, {include_geometry}, {include_domain_descriptions}, {result_network_attributes}, {result_fields}, {use_digitized_direction}, {synthesize_geometries}, {related_record_fields})
ИмяОписаниеТип данных
in_utility_network

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

Utility Network; Utility Network Layer
trace_type

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

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

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

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

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

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

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

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

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

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

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

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

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

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 — фильтр по любому сетевому атрибуту, определенному в системе, или задайте Category, чтобы использовать категорию сети.
  • Operator – выбрать среди различных операторов.
  • Type — укажите Specific value или Network attribute для типа значения параметра Name, который будет служить барьером. Значение параметра Type должно быть меньшеSpecific value, если значение параметра Name равно Category.
  • Value — задать определенное значение для входного атрибута или категории, которое может вызвать прерывание на основании значения оператора.
  • Combine Using — задайте это значение, если собираетесь добавить несколько условий. Их можно комбинировать при помощи условий И или ИЛИ.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Опции Use Local Values барьера функции следующие:

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

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

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

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

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

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

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

Value Table
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—Будет рассчитана сумма значений.
  • SUBTRACT—Будет рассчитана разность между значениями. Контроллеры подсети и циклические трассировки не поддерживаются функцией вычитания.

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

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

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

Опции Use Local Values барьеров функций фильтра следующие:

  • TRUE—Будут использоваться локальные значения. Это значение по умолчанию
  • FALSE—Будут использоваться глобальные значения.
Value Table
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 установлен на FILTER_BY_NEAREST.

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

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

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

Возвращаемые категории, когда для опции filter_nearest задано FILTER_BY_NEAREST, например, protective.

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

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

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

Опции значения Filter Type функций следующие:

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

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

Примечание:

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

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

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

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

Опции значения Combine Using выходных условий следующие:

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

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

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

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

  • INCLUDE_ISOLATED_FEATURES—Изолированные объекты будут включаться в результаты трассировки.
  • EXCLUDE_ISOLATED_FEATURES—Изолированные объекты не будут включаться в результаты трассировки. Это значение по умолчанию
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_CONTAINERS.

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

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

  • SELECTION—Результаты трассировки будут возвращаться в виде набора выборки соответствующих сетевых объектов. Это значение по умолчанию
  • AGGREGATED_GEOMETRY—Результаты трассировки будут агрегированы по типу геометрии и сохранены в составных классах объектов, отображающихся в виде слоев активной карты.
  • CONNECTIVITY—Результаты трассировки будут возвращены в виде графа связности в заданном выходном файле .json для пройденных сетевых объектов. Эта опция активирует параметры include_geometry, include_domain_description и out_json_file.
    Примечание:

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

  • ELEMENTS—Результаты трассировки будут возвращены в виде информации на основе объектов в указанном выходном файле .json для пройденных сетевых объектов. Эта опция активирует параметр out_json_file.
  • FEATURES—Результаты трассировки будут возвращены в виде информации на основе объектов в указанном выходном файле .json для пройденных сетевых объектов. Эта опция включает параметры include_geometry, include_domain_description, result_network_attributes, result_fields и out_json_file.
    Примечание:

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

  • CONTAINMENT_AND_ATTACHMENT_ASSOCIATIONS—Результаты трассировки будут возвращены в виде информации о соединениях для пройденных объектов сети, которые связаны посредством связей содержания и прикрепления к структуре в указанном выходном файле .json. Эта опция включает параметры include_domain_description и out_json_file.
    Примечание:

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

  • RELATED_RECORDS—Значения из связанных объектов будут возвращены для пройденных объектов в заданных выходных данных с использованием указанного класса отношений и поля. Эта опция включает параметры include_geometry, include_domain_description, related_record_fields и out_json_file.
    Примечание:

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

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
allow_indeterminate_flow
(Дополнительный)

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

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

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

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

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

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

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

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

Определяет, будет ли использоваться существующая именованная конфигурация трассировки для заполнения параметров инструмента.

  • USE_TRACE_CONFIGURATION—Существующая именованная конфигурация трассировки будет использоваться для определения свойств трассировки. Будут проигнорированы все параметры, за исключением trace_config_name, starting_points и barriers.
  • DO_NOT_USE_TRACE_CONFIGURATION—Существующая именованная конфигурация трассировки не будет использоваться для определения свойств трассировки. Это значение по умолчанию
Примечание:

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

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

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

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

Имя и расположение файла .json, который будет создан при возвращении результатов трассировки с использованием типов результатов связности, элементов, объектов или связей содержания и прикрепления.

File
run_async
(Дополнительный)

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

  • RUN_ASYNCHRONOUSLY—Операции трассировки будут выполняться асинхронно.
  • RUN_SYNCHRONOUSLY—Операции трассировки будут выполняться с синхронизацией. Это значение по умолчанию
Примечание:
Для этого параметра требуется ArcGIS Enterprise 10.9.1 или более новая версия.
Boolean
include_geometry
(Дополнительный)

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

  • INCLUDE_GEOMETRY—Геометрия будет включена в результаты.
  • EXCLUDE_GEOMETRY—Геометрия не будет включена в результаты. Это значение по умолчанию
Примечание:

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

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

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

  • INCLUDE_DOMAIN_DESCRIPTIONS—Описания доменов будут включены в результат.
  • EXCLUDE_DOMAIN_DESCRIPTIONS—Описания доменов не будут включены в результат. Это значение по умолчанию
Примечание:

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

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

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

Примечание:

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

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

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

Примечание:

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

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

Указывает, будут ли операции трассировки вверх и вниз по течению определять направление потока, используя оцифрованное направление линии, глобальный идентификатор От и До объекта ребра в ассоциации и атрибут Flow direction. Этот параметр доступен и активен только для инженерной сети версии 7 и более поздних версий, если для параметра trace_type задано значение UPSTREAM или DOWNSTREAM.

  • USE_DIGITIZED_DIRECTION—Операции трассировки будут определять направление потока, используя оцифрованное направление линии, глобальный идентификатор От и До объекта ребра в связи и атрибут направления потока. С этой опцией, распространители, настроенные на уровне, будут проигнорированы, параметры domain_network, tier и target_tier также игнорируются.
  • IGNORE_DIGITIZED_DIRECTION—Операции трассировки будут определять направление потока на основе местоположения контроллеров подсети. Это значение по умолчанию
Примечание:

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

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

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

  • DO_NOT_SYNTHESIZE_GEOMETRIES—Геометрии не будут синтезироваться для пройденных ассоциаций и объектов ребер. Это значение по умолчанию
  • SYNTHESIZE_GEOMETRIES—Геометрия будет выведена и создана для пройденных ассоциаций и объектов ребер в выходном классе объектов Trace_Results_Aggregated_Lines.

Примечание:

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

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

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

  • Relationship Class — класс отношений, относящийся к классу объектов или элементов, участвующему в инженерной сети.
  • Field Name - имя поля в классе связанных элементов, значения которого будут возвращены в результатах.

Value Table

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

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

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

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_content ="INCLUDE_CONTENT"
include_structures = "INCLUDE_STRUCTURES"
include_barriers ="INCLUDE_BARRIERS"
condition_barriers = "'Device Status' IS_EQUAL_TO SPECIFIC_VALUE 1 #"
propagators = "'Phases Current' phasessub PROPAGATED_BITWISE_AND INCLUDES_ANY 15"
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"
use_digitized_direction = "IGNORE_DIGITIZED_DIRECTION"
synthesize_geometries = "DO_NOT_SYNTHESIZE_GEOMETRIES"




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

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

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

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

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

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

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

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

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