Добавить конфигурацию трассировки (Инженерная сеть)

Доступно с лицензией Standard или Advanced.

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

Создает именованную конфигурацию трассировки в инженерной сети.

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

Подробнее о том, как добавить конфигурацию трассировки

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

  • Входная инженерная сеть должна быть версии 5 или более поздней.

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

  • В качестве создателя именованной конфигурации трассировки указана подключенная учетная запись портала.

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

Параметры

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

Инженерная сеть, которая будет содержать новую именованную конфигурацию трассировки.

Utility Network; Utility Network Layer
Имя конфигурации трассировки

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

String
Тип трассировки

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

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

Описание именованной конфигурации трассировки.

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

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

String
Специализированная сеть
(Дополнительный)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • Равно – атрибут равен значению.
  • Не равно – атрибут не равен значению.
  • Больше – атрибут больше значения.
  • Больше или равно – атрибут больше или равен значению.
  • Меньше – атрибут меньше значения.
  • Меньше или равно – атрибут меньше или равен значению.
  • Включает значения – побитовая операция 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).

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

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

  • СреднееСреднее арифметическое входных значений.
  • КоличествоЧисло объектов.
  • МаксимумМаксимальное из входных значений.
  • МинимумМинимальное из входных значений.
  • ДобавитьCумма значений.
  • ВычестьРазница значений.Контроллеры подсети и циклические трассировки не поддерживаются функцией вычитания.
Value Table
Распространители
(Дополнительный)
  • РавноАтрибут равен значению.
  • Не равноАтрибут не равен значению.
  • БольшеАтрибут больше значения.
  • Больше или равноАтрибут больше или равен значению.
  • МеньшеАтрибут меньше значения.
  • Меньше или равноАтрибут меньше или равен значению.
  • Включает значения (побитовый AND равен значению)Побитовая операция AND, где все биты в значении присутствуют в атрибуте (побитовый AND == значение).
  • Не включает значения (побитовый AND не равен значению)Побитовая операция AND, где не все биты в значении присутствуют в атрибуте (побитовый AND != значение).
  • Включает все (побитовый AND равен True)Побитовая операция AND, в которой хотя бы один бит в значении присутствует в атрибуте (побитовый AND == True).
  • Не включает ничего (побитовый AND равен False)Побитовая операция AND, где ни один из битов в значении не присутствует в атрибуте (побитовый AND == False).
Value Table
Выходные типы оборудования
(Дополнительный)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • ВыборкаРезультаты трассировки будут возвращаться в виде набора выборки соответствующих сетевых объектов. Это значение по умолчанию
  • Агрегированная геометрияРезультаты трассировки будут агрегированы по типу геометрии и сохранены в составных классах объектов, отображающихся в виде слоев активной карты.
String
Разрешение неопределенного потока
(Дополнительный)

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

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

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

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

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

Boolean

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

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

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

Utility Network

arcpy.un.AddTraceConfiguration(in_utility_network, trace_config_name, trace_type, {description}, {tags}, {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}, {allow_indeterminate_flow}, {validate_locatability})
ИмяОписаниеТип данных
in_utility_network

Инженерная сеть, которая будет содержать новую именованную конфигурацию трассировки.

Utility Network; Utility Network Layer
trace_config_name

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

String
trace_type

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

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

Описание именованной конфигурации трассировки.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • VALIDATE_CONSISTENCYТрассировка возвратит ошибку в случае обнаружения измененных областей для любого из пройденных объектов. Это значение по умолчанию
  • DO_NOT_VALIDATE_CONSISTENCYТрассировка возвращает результаты независимо от обнаружения измененных областей для любых из пройденных объектов.
Boolean
condition_barriers
[[Name, Operator, Type, Value, Combine Using],...]
(Дополнительный)

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

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

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

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

  • IS_EQUAL_TOАтрибут равен значению.
  • DOES_NOT_EQUALАтрибут не равен значению.
  • IS_GREATER_THANАтрибут больше значения.
  • IS_GREATER_THAN_OR_EQUAL_TOАтрибут больше или равен значению.
  • IS_LESS_THANАтрибут меньше значения.
  • IS_LESS_THAN_OR_EQUAL_TOАтрибут меньше или равен значению.
  • INCLUDES_THE_VALUESПобитовая операция AND, где все биты в значении присутствуют в атрибуте (побитовый 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 – вычислить значения в каждом направлении, в противоположность общему глобальному значению. Например, барьер функций, который вычисляет сумму длин объектов, при которой трассировка прекращается, если достигнуто значение, большее или равное 4. В общем, после того, как вы пройдете два ребра со значением 2, сумма длин объектов станет равна 4, и поэтому трассировка будет прекращена. Если используются локальные значения, изменяются локальные значения вдоль каждого пути, и трассировка продолжается дальше.

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

  • AVERAGEСреднее арифметическое входных значений.
  • COUNTЧисло объектов.
  • MAXМаксимальное из входных значений.
  • MINМинимальное из входных значений.
  • ADDCумма значений.
  • 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 – выбрать среди различных операторов.
  • name – выбрать определенное значение или сетевой атрибут из значения, которое задано в параметре Type.
  • 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Минимальное из входных значений.
  • ADDCумма значений.
  • 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_nearestFILTER_BY_NEAREST.

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

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

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

Возвращаемая категория или категории, когда filter_nearestFILTER_BY_NEAREST, например, Protective.

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

Группы оборудования и типы оборудования, возвращаемые, когда filter_nearestFILTER_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Минимальное из входных значений.
  • ADDCумма значений.
  • 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 – выбрать среди различных операторов.
  • name – выбрать определенное значение или сетевой атрибут из значения, которое задано в параметре Type.
  • 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Изолированные объекты не будут включаться в результаты трассировки. Это значение по умолчанию
Примечание:

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

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

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

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

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

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

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

  • SELECTIONРезультаты трассировки будут возвращаться в виде набора выборки соответствующих сетевых объектов. Это значение по умолчанию
  • AGGREGATED_GEOMETRYРезультаты трассировки будут агрегированы по типу геометрии и сохранены в составных классах объектов, отображающихся в виде слоев активной карты.
String
allow_indeterminate_flow
(Дополнительный)

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

  • TRACE_INDETERMINATE_FLOWОбъекты с неопределенным потоком будут трассироваться . Это значение по умолчанию
  • IGNORE_INDETERMINATE_FLOWОбъекты с неопределенным потоком будут останавливать трассировку и сами по себе трассироваться не будут.
Boolean
validate_locatability
(Дополнительный)

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

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

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

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

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

Utility Network

Пример кода

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

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

import arcpy
arcpy.AddTraceConfiguration_un(
        r"SampleUNService\Elec Utility Network", "Upstream_RMT002", "UPSTREAM", 
        "Upstream trace on RMT002", "Upstream;RMT002", "ElectricDistribution", 
        "Medium Voltage", '', '', '', "EXCLUDE_CONTAINERS", "EXCLUDE_CONTENT", 
        "EXCLUDE_STRUCTURES", "INCLUDE_BARRIERS", "VALIDATE_CONSISTENCY", None, 
        None, "BOTH_JUNCTIONS_AND_EDGES", None, None, "BOTH_JUNCTIONS_AND_EDGES", 
        '', "DO_NOT_FILTER", None, '', None, None, None, None, None, None, 
        "EXCLUDE_ISOLATED_FEATURES", "DO_NOT_IGNORE_BARRIERS_AT_STARTING_POINTS", 
        "DO_NOT_INCLUDE_UP_TO_FIRST_SPATIAL_CONTAINER", None, 
        "TRACE_INDETERMINATE_FLOW", "DO_NOT_VALIDATE_LOCATABILITY")

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

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

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

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

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