Трассировка (Инструменты инженерной сети)
Краткая информация
Возвращает сетевые объекты инженерной сети на основе связности или проходимости от выбранных начальных точек.
Возможности трассировки инженерной сети позволяют анализировать пути внутри сети. Проходимость относится к путям, установленным между подключенными или связанными объектами, которые также удовлетворяют требованиям конфигурации.
По умолчанию, результаты трассировки возвращаются в виде выборки и включают весь линейный объект. Для возвращения результатов с частями объектов, учитывающих местоположения трассировки, расположенные вдоль ребра, такие как начальные точки, конечные точки и барьеры, установите для параметра Типы результатов значение Агрегировать геометрию. Местоположения трассировки, расположенные в середине ребра, можно использовать для возврата частичной геометрии, если объекты-ребра являются содержимым линейного объекта, с помощью параметра Синтезировать геометрию.
При выборе опции Агрегированная геометрия начальные точки, расположенные вдоль ребра, будут возвращать элемент ребра от предыдущего соединения со связностью посередине или в конечной точке. При установке барьера вдоль ребра с включенным параметром Включить объекты барьеров трассировка остановится на следующем соединении со связностью посередине или в конце линии. Если параметр Включить объекты барьеров не отмечен, трассировка остановится на предыдущем соединении со связностью посередине или в конце предыдущей линии.
Затем вы можете распространить итоговый набор выборки объектов или выходной класс объектов, созданный в результате трассировки, на другую карту или представление схемы сети либо использовать его в качестве входных данных для другого инструмента или трассировки.
Использование
Топология сети должна быть включена. Поскольку инструмент Трассировка основывается на топологии сети, результаты трассировки могут оказаться неточными, если трассировка идет в измененных областях. Топология сети в области трассировки должна быть проверена, чтобы отображать самые последние изменения или обновления сети.
При работе с многопользовательской базой геоданных входная инженерная сеть должна быть сервисом инженерной сети.
При запуске трассировки на основе подсети в традиционной специализированной сети с использованием инструмента Трассировка через Python, конфигурация трассировки подсети для входного уровня не применяется автоматически и должна быть указана вручную.
При работе с сетевыми атрибутами, назначенными полю дат для барьеров фильтров, барьеров функций фильтра, функций и выходных условий, значение даты должно быть в формате
yyyy-mm-dd hh:mm:ss, например,2020-10-12 18:45:31.
Параметры
| Подпись | Объяснение | Тип данных |
|---|---|---|
|
Входная инженерная сеть |
Инженерная сеть, в которой будет выполняться трассировка. При работе с многопользовательской базой геоданных, входная инженерная сеть должна поступать из сервиса объектов; инженерная сеть из подключения к базе данных не поддерживается. |
Utility Network; Utility Network Layer |
|
Тип трассировки |
Определяет тип используемой трассировки.
|
String |
|
Начальные точки (Дополнительный) |
Слой объектов, созданный с помощью вкладки Начало панели Трассировка, таблица или класс пространственных объектов, содержащий одну или более записей, представляющих начальные точки трассировки. Этот класс объектов или таблица должны включать поле |
Feature Layer; Table View |
|
Барьеры (Дополнительный) |
Векторный слой, созданный с помощью вкладки Барьеры на панели Трассировка, либо класс линейных или полигональных объектов, содержащий один или несколько объектов, представляющих барьеры, не позволяющие трассировке пройти через эту точку. Этот класс объектов или таблица должны включать поле |
Feature Layer; Table View |
|
Специализированная сеть (Дополнительный) |
Имя специализированной сети, где будет выполняться трассировка. Этот параметр необходим для выполнения таких типов трассировки, как трассировка подсети, контроллеров подсети, вверх против течения, вниз по течению и контура. |
String |
|
Уровень (Дополнительный) |
Имя уровня в специализированной сети телекоммуникаций, откуда начинается трассировка. Этот параметр обязателен при выполнении трассировки типов подсеть, контроллеры подсети, вверх по течению и вниз по течению. |
String |
|
Целевой уровень (Дополнительный) |
Имя целевого уровня в специализированной сети телекоммуникаций, в сторону которого будет перетекать входной уровень в направленной трассировке. Если для трассировок вверх и вниз по течению этот параметр не указан, эти трассировки будут прекращены, когда они достигнут границы начальной подсети. Данный параметр используется для того, чтобы эти трассировки могли быть продолжены далее, либо вверх, либо вниз по иерархии. |
String |
|
Имя подсети (Дополнительный) |
Имя подсети в традиционной специализированной сети, где будет выполняться трассировка. Этот параметр можно использовать при запуске трассировки с типом трассировка подсети. Этот параметр обязателен, если не используется параметр Начальные точки. Если таблица подсети содержит 10 000 или более записей для уровня, список выбора параметра не заполняется и для имени подсети предоставляется пустое поле. |
String |
|
Имя сетевого атрибута кратчайшего пути (Дополнительный) |
Сетевой атрибут, который будет использоваться для вычисления кратчайшего пути с использованием типа трассировки путь или кратчайший путь. Кратчайший путь вычисляется с помощью числового атрибута сети, такого как длина объекта. Могут быть вычислены пути как на основе стоимости, так и на основе расстояния. Этот параметр не является обязательным для трассировки пути, но требуется при выполнении трассировки кратчайшего пути. |
String |
|
Включить контейнеры (Дополнительный) |
Определяет, будут ли объекты-контейнеры включены в результаты трассировки.
|
Boolean |
|
Включить содержимое (Дополнительный) |
Определяет, будет ли трассировка возвращать содержимое объектов- контейнеров в качестве результатов.
|
Boolean |
|
Включить структуры (Дополнительный) |
Определяет, будут ли структурные объекты и пространственные объекты включены в результаты трассировки.
|
Boolean |
|
Включить объекты барьеров (Дополнительный) |
Определяет, будут ли объекты-барьеры проходимости включены в результаты трассировки. Использование барьеров проходимости необязательно, даже если они были предварительно заданы в определении подсети. Этот параметр не применяется для объектов устройств с терминалами.
|
Boolean |
|
Проверить согласованность (Дополнительный) |
Определяет, будет ли возвращаться ошибка в случае обнаружения измененных областей для любого из пройденных объектов. Это единственный способ гарантировать, что трассировка проходит через объекты со статусом целостности в сети. Для удаления измененных областей проверьте топологию сети.
|
Boolean |
|
Барьеры условий (Дополнительный) |
Задает условие барьера проходимости для объектов на основании сравнения с сетевым атрибутом или проверки строки категории. В качестве барьера условия используются атрибут сети или категория сети, оператор и тип, а также значение атрибута. Например, остановить трассировку, если атрибут объекта "Статус устройства" равен указанному значению Подробнее об использовании множественных условных выражений Столбцы таблицы значений:
|
Value Table |
|
Барьеры функции (Дополнительный) |
Задает барьер проходимости для объектов на основе функции. Барьеры функций можно применять для ограничения того, насколько далеко трассировка может уйти от начальной точки, или установки максимального значения, при котором трассировка остановится. Например, длина каждой пройденной линии добавляется к общему пройденному на данный момент расстоянию. Когда общая пройденная длина достигнет указанного значения, трассировка остановится. Столбцы таблицы значений:
|
Value Table |
|
Применить проходимость к (Дополнительный) |
Определяет, будет ли применяться проходимость к соединениям, ребрам или к тем и другим. Например, если барьер условия настроен на остановку трассировки в случае, когда Device Status равно Open, а область проходимости задана только по ребрам, то трассировка не остановится даже при обнаружении открытого устройства, поскольку Device Status применим только к узлам. Другими словами, параметр показывает, что трассировка должна игнорировать ребра, соединения, или и то и другое.
|
String |
|
Барьеры фильтров (Дополнительный) |
Определяет, когда должна быть прекращена трассировка для определенной категории или атрибута сети. Например, остановить трассировку на объектах, имеющих атрибут статуса жизненного цикла, равный заданному значению. Этот параметр используется для задания ограничителя на основе значения атрибута сети, определенного в системе. При использовании более одного атрибута можно воспользоваться опцией Комбинировать используя, чтобы задать условие И либо Или. Подробнее об использовании множественных условных выражений Столбцы таблицы значений:
|
Value Table |
|
Фильтр барьеров функции (Дополнительный) |
Фильтрует результаты трассировки на определенную категорию. Столбцы таблицы значений:
|
Value Table |
|
Применить фильтр к (Дополнительный) |
Определяет, будет ли фильтр для определенной категории применяться к соединениям, ребрам или и к тем, и к другим. Например, если фильтр барьера задан для остановки трассировки, если Состояние устройства — Открыто, а для области проходимости задано «только ребра», трассировка не остановится, даже если обнаружит открытое устройство, так как Статус устройства применим только к соединениям. Другими словами, параметр показывает, что трассировка должна игнорировать ребра, соединения, или и то и другое.
|
String |
|
Фильтр по сетевому атрибуту битового множества (Дополнительный) |
Имя атрибута сети, который может быть использован для фильтрации по битовому множеству. Этот параметр применяется только для трассировки типа вверх по течению, вниз по течению и петли. Этот параметр может быть использован для добавления специальной логики во время трассировки, чтобы трассировка могла полнее отражать сценарии реального мира. Например, при трассировке петель атрибут сети Текущие фазы может определить, является ли петля истинной электрической петлей (та же фаза проходит вдоль всей петли, то есть А) и возвратить для результатов трассировки только реальные электрические петли. Пример трассировки вверх по течению: при трассировке сети электрического распределения, указав атрибут сети Текущие фазы, вы получите в качестве результатов трассировки только корректные пути, которые указаны в атрибуте сети, а не все пути. |
String |
|
Фильтр по ближайшему (Дополнительный) |
Определяет, будет ли использоваться алгоритм K-ближайших соседей для возврата объектов определенного типа в пределах заданного расстояния. Вы можете указать количество, стоимость, а также либо набор категорий, либо тип оборудования, либо и то, и другое.
|
Boolean |
|
Количество (Дополнительный) |
Число возвращаемых объектов при включенной опции Фильтр по ближайшему. |
Long |
|
Стоимость атрибута сети (Дополнительный) |
Числовой атрибут сети, который будет использоваться для вычисления степени близости, стоимости или расстояния при включенной опции Фильтр по ближайшему, – например, длина объекта. |
String |
|
Категории ближайших (Дополнительный) |
Возвращаемые категории, когда включена опция Фильтр по ближайшему, – например, protective. |
String |
|
Группы/Типы ближайшего оборудования (Дополнительный) |
Группы оборудования и типы оборудования, возвращаемые при включенной опции Фильтр по ближайшему, – например, ElectricDistributionDevice/Transformer/Step Down. |
String |
|
Функции (Дополнительный) |
Функция или функции вычисления, которая будет применяться к результатам трассировки. Столбцы таблицы значений:
|
Value Table |
|
Распространители (Дополнительный) |
Указывает сетевые атрибуты для распространения, а также то, как это распространение будет происходить во время трассировки. Распространяемые атрибуты класса определяют ключевые значения контроллеров подсети, которые распространяются на остальные объекты подсети. Например, в модели электрической сети вы можете распространить значение фазы. В специализированной сети телекоммуникаций вы можете распространить значения длин волн из объектов, определенных как местоположения контуров. Подробнее о побитовых операторах Примечание:Этот параметр доступен только в Python. Столбцы таблицы значений:
|
Value Table |
|
Выходные типы оборудования (Дополнительный) |
Фильтрует выходные типы оборудования, которые должны быть включены в результаты, например, только навесные трансформаторы. |
String |
|
Выходные условия (Дополнительный) |
Типы возвращаемых объектов в зависимости от сетевого атрибута или категории. Например, если трассировка настроена на фильтрацию всех объектов, кроме Водоотводов, любые трассированные объекты, которым не присвоена категория Водоотвод, не будут включены в результаты. Любые трассированные объекты с этой категорией будут возвращены в итоговом наборе выборки. Подробнее об использовании множественных условных выражений Столбцы таблицы значений:
|
Value Table |
|
Включить изолирующие объекты (Дополнительный) |
Определяет, будут ли изолированные объекты включаться в результаты трассировки с традиционной специализированной сетью. Этот параметр используется только при запуске трассировки изоляции.
|
Boolean |
|
Игнорировать барьеры в начальных точках (Дополнительный) |
Определяет, будут ли в конфигурации трассировки игнорироваться динамические барьеры для начальных точек. Это может быть полезно при выполнении трассировки защитных устройств вверх по течению и использовании найденных защитных устройств (барьеров) в качестве начальных точек для поиска последующих защитных устройств, находящихся вверх по течению.
|
Boolean |
|
Включать до первого пространственного контейнера (Дополнительный) |
Указывает, будут ли в результатах трассировки среди возвращаемых только те контейнеры, которые встречались до первого пространственного контейнера, включая его самого, для каждого сетевого элемента. Если пространственные контейнеры не встречаются, но для данного элемента сети присутствуют непространственные контейнеры, то все непространственные контейнеры будут включены в результаты. Этот параметр включается только тогда, когда параметр
|
Boolean |
|
Типы результатов (Дополнительный) |
Задает тип результатов, которые будет возвращать данная трассировка.
|
String |
|
Тип выборки |
Определяет, как будет применяться выборка и что произойдет, если есть текущая выборка.
|
String |
|
Очистить все результаты предыдущих трассировок (Дополнительный) |
Указывает, будет ли содержимое усечено из классов пространственных объектов, выбранных для хранения агрегированной геометрии, или добавлено к ним. Этот параметр применим только для типа результатов Агрегированная геометрия.
|
Boolean |
|
Имя трассировки (Дополнительный) |
Имя операции трассировки. Это значение хранится в поле |
String |
|
Агрегированные точки (Дополнительный) |
Выходной класс мультиточечных объектов, содержащий агрегированную результирующую геометрию. По умолчанию параметр заполняется сгенерированным системой классом объектов Trace_Results_Aggregated_Points, который будет сохраняться в базе геоданных проекта по умолчанию. Этот класс объектов будет создан автоматически, если он не существует. Существующий класс объектов также может использоваться для хранения агрегированной геометрии. При использовании класса объектов, отличного от класса объектов по умолчанию, это должен быть класс мультиточечных объектов, содержащий текстовое поле |
Feature Class |
|
Агрегированные линии (Дополнительный) |
Выходной класс полилинейных объектов, содержащий агрегированную результирующую геометрию. По умолчанию параметр заполняется сгенерированным системой классом объектов Trace_Results_Aggregated_Lines, который будет сохраняться в базе геоданных проекта по умолчанию. Этот класс объектов будет создан автоматически, если он не существует. Существующий класс объектов также может использоваться для хранения агрегированной геометрии. При использовании класса объектов, отличного от класса объектов по умолчанию, это должен быть класс полилинейных объектов, содержащий текстовое поле |
Feature Class |
|
Агрегированные полигоны (Дополнительный) |
Выходной класс полигональных объектов, содержащий агрегированную результирующую геометрию. По умолчанию параметр заполняется сгенерированным системой классом объектов Trace_Results_Aggregated_Polygons, который будет сохраняться в базе геоданных проекта по умолчанию. Этот класс объектов будет создан автоматически, если он не существует. Существующий класс объектов также может использоваться для хранения агрегированной геометрии. При использовании класса объектов, отличного от класса объектов по умолчанию, это должен быть класс полигональных объектов, содержащий текстовое поле |
Feature Class |
|
Разрешать неопределенный поток (Дополнительный) |
Определяет, будут ли трассироваться объекты с неопределенным потоком. Неопределенный поток определяется как области в подсети, где направление потока неоднозначно или не может быть определено. Этот параметр применим только при запуске трассировки вверх или вниз по течению, или для изолированной трассировки. Примечание:Этот параметр требует Версии инженерной сети 5 или выше.
|
Boolean |
|
Проверить размещаемость (Дополнительный) |
Определяет, будет ли возникать ошибка в ходе трассировки, если появятся непространственные объекты соединений или ребер, у которых нет необходимых связей связности, содержания или прикреплений в их иерархии связей. Этот параметр гарантирует, что непространственные объекты, которые возвращаются в ходе трассировки либо обновления подсети, можно будет найти через связность с пространственными объектам или другими размещаемыми объектами.
|
Boolean |
|
Использовать конфигурацию трассировки (Дополнительный) |
Определяет, будет ли использоваться существующая именованная конфигурация трассировки для заполнения параметров этого инструмента. Примечание:Этот параметр требует Версии инженерной сети 5 или выше.
|
Boolean |
|
Имя конфигурации трассировки (Дополнительный) |
Имя существующей именованной конфигурации трассировки, которое будет использоваться для определения свойств трассировки. Этот параметр будет активен только в случае, если отмечен параметр Использовать конфигурацию трассировки. Примечание:Этот параметр требует Версии инженерной сети 5 или выше. |
String |
|
Выходной JSON (Дополнительный) |
Имя и расположение файла |
File |
|
Запуск в асинхронном режиме на сервере (Дополнительный) |
Определяет, будут ли операции трассировки выполнятся асинхронно при работе с инженерной сетью в многопользовательской базе геоданных.
|
Boolean |
|
Включить геометрию (Дополнительный) |
Определяет, будет ли геометрия включена в результаты. Примечание:Для многопользовательских баз геоданных этот параметр требует наличия ArcGIS Enterprise 11.1 или более поздней версии.
|
Boolean |
|
Включить описания домена (Дополнительный) |
Определяет, будут ли описания доменов включены в выходной файл Примечание:Для многопользовательских баз геоданных этот параметр требует наличия ArcGIS Enterprise 11.1 или более поздней версии.
|
Boolean |
|
Итоговые атрибуты сети (Дополнительный) |
Атрибуты сети будут включены в результаты. Примечание:Для многопользовательских баз геоданных этот параметр требует наличия ArcGIS Enterprise 11.1 или более поздней версии. |
String |
|
Поля результатов (Дополнительный) |
Поля из класса объектов, которые будут возвращены как результаты. Значения поля будут возвращены в результатах для объектов трассировки. Примечание:Для многопользовательских баз геоданных этот параметр требует наличия ArcGIS Enterprise 11.1 или более поздней версии. Столбцы таблицы значений:
|
Value Table |
|
Использовать направление оцифровки (Дополнительный) |
Указывает, будут ли операции трассировки вверх и вниз по течению определять направление потока, используя направление оцифровки линии, глобальный идентификатор От и До объекта ребра в связи и атрибут "Направление потока". Этот параметр доступен и активен только для инженерной сети версии 7 и более поздних версий, если для параметра Примечание:Для многопользовательских баз геоданных этот параметр требует наличия ArcGIS Enterprise 11.3 или более поздней версии.
|
Boolean |
|
Синтезировать геометрию (Дополнительный) |
Указывает, будет ли выводиться и создаваться (синтезироваться) геометрия для ассоциаций и объектов ребер, проходимых в ходе операции трассировки. Этот параметр применим только для типа результатов Агрегированная геометрия и Контуры. Примечание:Для корпоративных баз геоданных этот параметр требует ArcGIS Enterprise 11.3 или более поздней версии для использования с типом результата Агрегированная геометрия и ArcGIS Enterprise 12.1 или более поздней версии для использования с типом результата Контур.
|
Boolean |
|
Остановочные точки (Дополнительный) |
Слой объектов, созданный с помощью вкладки Остановка на панели Трассировка, таблица или класс пространственных объектов, содержащий одну или более записей, представляющих точки останова для трассировки Путь. Этот класс объектов или таблица должны включать поле Примечание:Для многопользовательских баз геоданных этот параметр требует наличия ArcGIS Enterprise 12.1 или более поздней версии. |
Feature Layer; Table View |
|
Число путей (Дополнительный) |
Максимальное число путей между заданным набором местоположений начала и окончания, которые будут возвращены в виде Пути трассировки. Значение по умолчанию равно 1. Этот параметр активен только тогда, когда параметр Тип трассировки установлен на Путь. Примечание:Для многопользовательских баз геоданных этот параметр требует наличия ArcGIS Enterprise 12.1 или более поздней версии. |
Long |
|
Максимальное количество переходов (Дополнительный) |
Максимальное число скачков между ребрами, допустимое в пути, включая начальную точку. Все ребра и связи связности соединение-соединение оцениваются при прохождении как имеющие фиксированную единицу длины 1. Оконечные устройства оцениваются как имеющие фиксированную единицу длины 2. По умолчанию используется 100. Этот параметр активен только тогда, когда параметр Тип трассировки установлен на Путь. Примечание:Для многопользовательских баз геоданных этот параметр требует наличия ArcGIS Enterprise 12.1 или более поздней версии. |
Long |
|
Поля связанных записей (Дополнительный) |
Поля из классов связанных объектов, которые будут возвращены как результаты. Значения поля будут возвращены в результатах для пройденных объектов в выходной файле Столбцы таблицы значений:
|
Value Table |
|
Имя контура (Дополнительный) |
Имя контура в телекоммуникационной специализированной сети, где будет выполняться трассировка. Обязательно для трассировки контуров, если не используется параметр Начальные точки. Примечание:Для многопользовательских баз геоданных этот параметр требует наличия ArcGIS Enterprise 12.1 или более поздней версии. |
String |
|
Вывести связность (Дополнительный) |
Задает, будет ли трассировка пути использовать вывод связности для прохождения связей содержания и идентификации пути между указанным начальным и конечным местоположениями. Этот параметр поддерживается только при трассировке пути в специализированных сетях телекоммуникаций и позволяет обнаруживать пути между секциями при отсутствии явной информации о связности. Дополнительные сведения см. в разделе Вывести связность.
|
Boolean |
|
Включить направления стока (Дополнительный) |
Задает, будут ли направления потока включаться в выходной файл Этот параметр применяется только к опциям типов результатов Связность, Элементы и Объекты при использовании с типами трассировки по подсети, вверх по течению и вниз по течению. Примечание:Для многопользовательских баз геоданных этот параметр требует наличия ArcGIS Enterprise 12.1 или более поздней версии.
|
Boolean |
|
Включить распространяемые значения (Дополнительный) |
Определяет, будут ли распространяемые значения включены в выходной файл Примечание:Для многопользовательских баз геоданных этот параметр требует наличия ArcGIS Enterprise 12.1 или более поздней версии.
|
Boolean |
Производные выходные данные
| Подпись | Объяснение | Тип данных |
|---|---|---|
|
Выходная инженерная сеть |
Обновленная инженерная сеть. |
Utility Network |
Параметры среды
Этот инструмент не использует параметры среды геообработки.
Информация о лицензировании
- Basic: С ограничением
Поддерживается в многопользовательском развертывании при использовании лицензии именованного пользователя ArcGIS Enterprise. - Standard: Да
- Advanced: Да