Наверх

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

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

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

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

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

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

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

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

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

  • Значение параметра Входная инженерная сеть должно быть версии 5 и выше.

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

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

    • Лицензия:
    Для использования этого инструмента в многопользовательском развертывании активной учетной записи портала должна быть назначена лицензия с расширением типа пользователя ArcGIS Advanced Editing.

Параметры

ДиалогPython

ПодписьОписаниеТип данных
Входная сеть коммуникаций

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

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

Имя конфигурации трассировки.

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

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

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

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

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

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

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

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

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 != значение).
  • Включает любое (побитовый AND равен True) – побитовая операция AND, в которой хотя бы один бит в значении присутствует в атрибуте (побитовый AND == True).
  • Не включает любое (побитовый AND равен False) – побитовая операция AND, где ни один из битов в значении не присутствует в атрибуте (побитовый AND == False).

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

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

  • Среднее—Будет вычислено среднее входных значений.
  • Количество—Будет определено количество пространственных объектов.
  • Максимум—Будет определен максимум входных значений.
  • Минимум—Будет определен минимум входных значений.
  • Добавить—Будет вычислена сумма входных значений.
  • Вычесть—Будет вычислена разница между входными значениями.Контроллеры подсети и трассировка петель не поддерживают функцию вычитания.
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 != значение).
  • Включает любое (побитовый AND равен True) – побитовая операция AND, в которой хотя бы один бит в значении присутствует в атрибуте (побитовый AND == True).
  • Не включает любое (побитовый AND равен False) – побитовая операция AND, где ни один из битов в значении не присутствует в атрибуте (побитовый AND == False).

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Примечание:

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

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

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

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

Примечание:

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

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}, {use_digitized_direction}, {synthesize_geometries})
ИмяОписаниеТип данных
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 не требуется.

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 — укажите 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 – вычисляет значения в каждом направлении, в противоположность общему глобальному значению. Например, барьер функций, который вычисляет сумму длин объектов, при которой трассировка прекращается, если достигнуто значение, большее или равное 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
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_INCLUDE_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—Результаты трассировки будут агрегированы по типу геометрии и сохранены в составных классах объектов, отображающихся в виде слоев активной карты.
String
allow_indeterminate_flow
(Дополнительный)

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

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

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

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

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

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

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

Utility Network

Пример кода

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

Следующий скрипт окна Python демонстрирует использование функции AddTraceConfiguration.

import arcpy
arcpy.un.AddTraceConfiguration(
        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: Да

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

  • Обзор группы инструментов Конфигурация трассировки
  • Поиск инструмента геообработки

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

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