Настройка трассировки

Трассировка инженерной сети выполняется для поиска ответов и решения проблем, относящихся к состоянию вашей сети в любой момент времени. Для трассировки инженерной сети применяется инструмент геообработки Трассировка.

Вы можете выполнять множество типов трассировки с помощью инструмента Трассировка:

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

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

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

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

Выполнение трассировки в асинхронном режиме

Начиная с версии ArcGIS Pro 2.9 и версии ArcGIS Enterprise 10.9.1, параметр Запуск в асинхронном режиме на сервере предоставляет возможность асинхронно обрабатывать операции трассировки с помощью сервиса геообработки UtilityNetworkTools. Этот параметр доступен только при работе с инженерными сетями в многопользовательском развертывании. По умолчанию, операции трассировки обрабатываются синхронно.

Опция настройкиОписание

Запуск в асинхронном режиме на сервере

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

Указание региона трассировки

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

Указание специализированной сети ограничивает трассировку только этой специализированной сетью. Для всех трассировок на основе подсетей требуется указать специализированную сеть. Для некоторых трассировок необходимо указать уровень и дополнительную подсеть. Для других типов необходимо задать уровень и целевой уровень (вверх и вниз по течению). Целевой уровень позволяет выполнять трассировку по нескольким уровням в специализированной сети.

Параметр Уровень применяется для ограничения трассировки в рамках определенного уровня, если он указан в инструменте Трассировка. Он также используется для автоматического заполнения параметров конфигурации трассировки значениями, заданными для определения подсети. Если начальные точки заданы вместе с параметром Уровень, они должны располагаться внутри указанного уровня. Параметр Целевой уровень применяется для трассировки по и против течения и указывает границу трассируемой сети; трассировка может происходить внутри целевого уровня, но не за его пределами.

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

  • Область проходимости
  • Барьеры условий
  • Барьеры функций
  • Распространители

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

Включение контейнеров, содержания, структур и барьеров в результаты

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

Включить контейнеры

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

Опция настройкиОписание

Включить контейнеры

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

Включать до первого пространственного контейнера

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

Опция настройкиОписание

Включать до первого пространственного контейнера

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

Включить содержание

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

Опция настройкиОписание

Включить содержание

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

Включить структуры

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

Опция настройкиОписание

Включить структуры

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

Включить объекты барьеров

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

Примечание:

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

Опция настройкиОписание

Включить объекты барьеров

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

Примечание:
Эта опции конфигурации трассировки также зависит от конфигурации трассировки подсети для типов трассировки на базе подсети. Загружается, когда настроен параметр Уровень.

Примечание:

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

Игнорировать барьеры в начальных точках

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

Опция настройкиОписание

Игнорировать барьеры в начальных точках

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

Настройка потока ресурсов

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

Когда используется эта опция, параметры Специализированная сеть, Уровень и Целевой уровень скрыты и игнорируются. Этот параметр доступен и активен только для версии Utility Network 7 и более поздних версий, когда тип трассировки - вверх по течению (восходящий) или по течению (нисходящий).

Опция настройкиОписание

Использовать направление оцифровки

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

Проверка согласованности сети

Согласованная область сети не имеет измененных областей. Проверка топологии сети – единственный способ гарантировать, что трассировка считывает самую свежую информацию о вашей сети через топологию сети. Для некоторых типов трассировки необходимо, чтобы подсеть, которую вы трассируете, была без измененных областей. Более подробно см. в разделе Жизненный цикл подсети.

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

ERROR 002041: One or more dirty areas were discovered.
[[ElectricDistributionLine: {C0060506-AG17-4B64-B2E0-9162BE613C05}]]
Failed to execute (Trace).

В перечисленных ниже сценариях ошибка из-за несогласованности в результатах трассировки не возникает:

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

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

Запуск трассировки без отметки опции Проверить согласованность может привести к непредсказуемым результатам. В качестве примера рассмотрим следующий сценарий: из сети удаляется объект, который нарушает единственный путь между местоположениями A и B. Для удаленного объекта создается измененная область, но перед проверкой топологии сети выполняется трассировка для поиска подключенных объектов, начиная с местоположения A, при снятой отметке у опции Проверить согласованность. В этом сценарии трассировка достигает местоположения B, и инструмент выполняется без предупреждений. Местоположение B было достигнуто, так как удаление объекта, связывающего A с B не было отражено в топологии сети при выполнении операции проверки.

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

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

Опция настройкиОписание

Проверить согласованность

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

Обеспечение возможности размещения непространственных объектов

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

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

ERROR 003326: Unlocatable objects discovered.
[[GasDistributionJunctionObject: {4F860903-PK17-5c15-Y2W0-3512BP436C00}]]
Failed to execute (Trace).

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

Более подробно см. Размещаемость.

Опция настройкиОписание

Проверить размещаемость

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

Управление трассировкой

При трассировке используются барьеры для установки положения остановки; объекты далее этого положения не будут трассированы. Результаты трассировки не будут включать сетевые объекты дальше этого барьера, но они могут (дополнительно) включать сам барьер. Другие параметры, такие как Разрешить неопределенный поток и подобные, которые находятся в секции Проходимость, помогают определить, что управляет проходимостью путей сети.

Разрешать неопределенный поток

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

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

Опция настройкиОписание

Разрешать неопределенный поток

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

Проходимость

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

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

Более подробно см. в разделе Барьеры.

Настройка функций

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

Также можно для каждой функции добавить фильтр атрибутов сети; когда он указан, функция будет применяться только к объектам, которые удовлетворяют условиям фильтра атрибутов сети. Фильтры в функциях используются для введения условного требования - например, можно вычислить сумму длин всех линий, атрибут Phases Current, который включает значения A, B и С.

Примечание:

Конфигурации трассировки, использующие разделяемые сетевые атрибуты с функциями (Add, Average, Count, Max, Min и Subtract), возвращают разделяемые результаты на основе элементов ребер. Например, использование функции в трассировке подключенных для подсчета атрибута shape length возвращает число, исходя из отдельных объектов-ребер, а не всю линию. Более подробно см. в разделе Разделяемые атрибуты сети.

Управление получаемыми результатами

Для управления тем, что возвращается в результатах трассировки, используются выходные фильтры и типы результатов.

Выходные фильтры

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

Есть два типа фильтров Выходные в инструменте Трассировка: Выходные типы оборудования и Выходные условия.

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

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

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

В связи с этим поведением атрибутов сети в выходных условиях, чтобы возвратить в результатах только сужающие трубы, необходимо также использовать фильтр Выходной тип оборудования. Например, в предоставленной Esri инженерной газовой сети из класса PipelineLine, в группе оборудования Distribution Pipe будет указан тип оборудования Plastic PE. С двумя фильтрами, IsPinchable = True AND AssetType = Plastic PE, результаты трассировки будут включать только пластиковые стягивающиеся трубы PE.

Можно применять несколько Выходных условий с помощью параметра Комбинировать использование. Оба типа выходных данных можно использовать, и можно настроить более одного выходного типа. Сочетая выходные типы, вы можете, например, выводить в результатах 12-дюймовые сужающиеся трубы Plastic PE, давление в которых выше 80 PSI.

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

Типы результатов

Дополнительный параметр Типы результатов позволяет определять тип результатов, возвращаемых трассировкой.

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

ПараметрОпции

Типы результатов

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

Примечание:

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

  • Для опции Связность требуется ArcGIS Enterprise версии 10.9.1 или выше.
  • Для опций Объекты и Связи прикрепления к структуре и содержания требуется ArcGIS Enterprise версии 11.1 или выше.

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

Просмотрите изображения ниже, чтобы сравнить различия между выборкой и агрегированной геометрией в типе результата при трассировке вниз по течению. Сеть ниже содержит пять линейных объектов (представленных как f1, f2, f3, f4 и f5), которые состоят из девяти элементов рёбер (представленных как e1, e2, e3 и т.д.).

В этом примере, который включает в себя барьерные элементы, результат выбора возвращает семь точечных объектов и пять линейных объектов, состоящих из девяти элементов рёбер (f1::e1,e2,e3, f2::e1,e2 и f5::e1,e2). Агрегированная геометрия возвращает в качестве результата те же объекты, но не включая элементы ребер f1::e1,e2 и f5::e2.

Результаты трассировки вниз по течению при использовании опций выборки и агрегированной геометрии

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

Приведенные ниже примеры показывают разницу в результатах трассировки при использовании параметра Включить объекты барьеров для включения или исключения барьерных элементов в результатах трассировки. В данном примере как начальная точка, так и барьер расположены вдоль ребра. Если эта опция включена, результат выборки возвращает шесть точечных и пять линейных объектов, состоящих из девяти элементов ребер (f1::e1,e2,e3, f2::e1,e2, f3::e1, f4::e1 и f5::e1,e2). Результат агрегированной геометрии возвращает те же пять объектов, но исключает элементы ребер f1::e2 и f5::e2. Геометрия части возвращается для элемента ребра f1::e2. Результаты выборки не изменятся, если исключить объекты-барьеры, сняв отметку Включить объекты барьеров; но в результатах агрегированной геометрии будут дополнительно исключены f1::e2.

Сравнение результатов трассировки при включенной и выключенной опции Включить объекты барьеров

Когда для типа результата выбрана опция Агрегированная геометрия, появляются шесть дополнительных параметров, определяющих режим вывода результатов трассировки:

  • Очистить все результаты предыдущих трассировок
  • Синтезировать геометрию
  • Имя трассировки
  • Агрегированные точки
  • Агрегированные линии
  • Агрегированные полигоны

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

ПараметрОпции

Очистить все результаты предыдущих трассировок

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

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

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

Подробнее о том, как синтезировать геометрию для объектов-ребер в трассировке

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

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

ПараметрОпции

Синтезировать геометрию

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

Примечание:

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

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

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

  • Trace_Results_Aggregated_Lines – класс объектов линий
  • Trace_Results_Aggregated_Points – класс объектов-мультиточек
  • Trace_Results_Aggregated_Polygons – класс полигональных объектов

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

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

Внимание:

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

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

ПараметрОпции

Тип выборки

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

Опция типов результатов Связность возвращает результаты трассировки в виде графа связности сетевых объектов, соединенных геометрическим совпадением или соединениями связности. Когда выбрана эта опция, связность выводится в файл .json в заданном расположении; этот файл можно проанализировать и импортировать в другие системы для построения собственного графического представления данных. Информация о связности возвращается только для сетевых объектов, возвращенных трассировкой. Выходной файл .json содержит следующую информацию для всех пройденных сетевых объектов в разделе connctivity:

  • fromNetworkSourceId
  • fromGlobalId
  • fromObjectId
  • fromTerminalId
  • fromGeometry
  • viaNetworkSourceId
  • viaGlobalId
  • viaObjectId
  • viaPositionFrom
  • viaPositionTo
  • viaGeometry
  • toNetworkSourceId
  • toGlobalId
  • toObjectId
  • toTerminalId
  • toGeometry

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

  • networkSourceId
  • globalId
  • objectId
  • assetGroupCode
  • assetTypeCode

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

  • terminalId

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

  • positionFrom
  • positionTo

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

Информация, возвращаемая с помощью опции Включить геометрию (отсутствует для объектов соединения и края):

  • geometry

Информация, возвращенная с помощью опции Включить описания доменов:

  • networkSourceName
  • assetGroupName
  • assetTypeName
  • networkAttributeDescriptions(когда указаны Итоговые атрибуты сети)
  • Дополнительная информация возвращается для точечных объектов и объектов соединений.

    • terminalName

Информация, возвращаемая с помощью опции Итоговые атрибуты сети:

  • networkAttributeValues

Информация, возвращаемая с помощью опции Поля результатов:

  • fieldValues

Опция Связи прикрепления к структуре и содержания возвращает информацию о соединениях для пройденных сетевых объектов, которые связаны посредством содержания и прикрепления к структуре в указанном выходном файле .json. Выходной файл .json содержит следующую информацию для всех пройденных сетевых объектов в разделе associations:

  • associationType
  • fromNetworkSourceId
  • fromGlobalId
  • fromTerminalId
  • toNetworkSourceId
  • toGlobalId
  • toTerminalId

Информация, возвращенная с помощью опции Включить описания доменов:

  • fromNetworkSourceName
  • fromTerminalName
  • toNetworkSourceName
  • toTerminalName

Дополнительные параметры включаются, когда выбраны определенные опции Типов результатов:

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

Когда выбраны опции Связность, Элементы, Объекты или Связи содержания и прикрепления к структуре, выходной файл .json включает элемент sourceMapping, расположенный в нижней части файла. Элемент позволяет вам узнать имя слоя, связанного с каждым networkSourceId.

"sourceMapping": {
		"1": "UN_6_Associations",
		"2": "UN_6_SystemJunctions",
		"4": "Structure Junction",
		"5": "Structure Line",
		"6": "Structure Boundary",
		"7": "Structure Junction Object",
		"8": "Structure Edge Object",
		"9": "Electric Distribution Device",
		"10": "Electric Distribution Line",
		"11": "Electric Distribution Assembly",
		"12": "Electric Distribution Junction",
		"13": "Electric Distribution SubnetLine",
		"14": "Electric Distribution Junction Object",
		"15": "Electric Distribution Edge Object"
	},

Работа с побитовыми операторами

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

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

Побитовые операторы, которые используются в конфигурации трассировки:

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

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

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

Бинарное значениеКод (десятичное значение)Описание (значение фазы)

001

1

C

010

2

B

100

4

A

011

3

BC

101

5

AC

110

6

AB

111

7

ABC

Пример домена кодированных значений фазы

Например, чтобы найти все сетевые объекты в подсети со значением Phases Current, включающим A, выполняется трассировка подсети в электрической распределительной специализированной сети. Начальная точка задается на точке обслуживания со значением Phases Current для A (100), а приведенная ниже конфигурация трассировки указывается как барьер фильтра.

Барьер фильтра настроен на исключение объектов и элементов, не включающих фазу A, из результата трассировки. Чтобы убедиться, что объекты барьеров не включаются в результаты трассировки, опция трассировки Включить объекты барьеров должна быть установлена на false. Результаты трассировки включают объекты подсети, имеющие значение Phases Current для A или значение Phases Current, включающее A. Любые обнаруженные объекты подсети, не имеющие значения Phases Current , включающего A, рассматриваются как барьеры и не включаются в результат.

Filter Barriers
Name: Phases Current
Operator: Does not include any (Bitwise AND equals False)
Type: Specific value
Value: 4 //code for A (100)

В таблице ниже представлено руководство, помогающее проиллюстрировать сценарии, в которых побитовый оператор будет считаться истинным и служить барьером в трассировке. Например, рассмотрим сценарий, в котором поле Phase на устройстве содержит значение сетевого атрибута AB (110), а сравниваемое значение из конфигурации трассировки — ABC (111):

  • При использовании оператора Includes the values это будет оценено как ложное и не будет действовать как барьер, поскольку в значении сетевого атрибута отсутствуют все биты. Бит C (001) отсутствует в AB (110).
  • Если вы используете оператор Includes any для той же конфигурации, это будет иметь значение true, поскольку некоторые биты значения конфигурации присутствуют в сетевом атрибуте. Бит A (100) и бит B (010) присутствуют в ABC (111).
  • Использование оператора Does not include the values также будет оценено как истинное, поскольку значение сетевого атрибута AB (110) не включает бит C (001), даже если присутствуют A (100) и B (010).
  • Наконец, использование оператора Does not include any в этом примере конфигурации будет оцениваться как ложное, когда он встретит значение сетевого атрибута AB (110), поскольку значение конфигурации содержит совпадающие биты A (100) и B (010). Чтобы это было оценено как истинное, A (100), B (010) и C (001) должны отсутствовать.

Значение атрибута сетиЗначение конфигурацииВключает в себя значенияВключает любоеНе включает значенияНе включает в себя ничего

ABC (111)

A (100)

True

True

False

False

AC (101)

BC (011)

False

True

True

False

C (001)

B (010)

False

False

True

True

AB (110)

ABC (111)

False

True

True

False

Выполнение вычислений для трассируемых сетевых объектов

Модуль Инженерные сети предоставляет расширенную функциональность, известную как распространение атрибутов, которая используется при обновлении или трассировке подсети.

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

Более подробно см. Распространение атрибута и Замена атрибута.

Загрузка именованных конфигураций трассировки

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

ПараметрОпции

Использовать конфигурацию трассировки

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

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

Примечание:

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

Более подробно об именованных конфигурациях трассировки