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

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

Несколько типов трассировки доступны в инструменте Трассировка:

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

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

Включение барьеров в результаты

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ERROR 002041: One or more dirty areas were discovered.
[[NHDFlowline: {0DBFACDA-45D6-BA67-33CE-A750BE632C05}]]
Failed to execute (Trace).

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

Примечание:

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

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

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

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

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

  • Если отмечено – то инструмент выдает ошибку, при пересечении измененными областями объектов трассировки. Используется по умолчанию.
  • Если не отмечено – то измененные области игнорируются.

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

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

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

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

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

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

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

Дополнительные опции

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

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

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

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

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

Примечание:

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

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

Чтобы контролировать то, что возвращается в результате трассировки, предусмотрены два параметра: Выходные условия и Типы результатов.

Выходные условия

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

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

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

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

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

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

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

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

Примечание:

В многопользовательских базах геоданных для опции Связность требуется ArcGIS Enterprise версии 10.9.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 и f5::e1,e2). Агрегированная геометрия возвращает в качестве результата те же три объекта, не включая элементы ребер f1::e1,e2 и f5::e2. Результаты выборки не изменятся, если исключить объекты барьеры, не отметив Включение объектов барьеров, однако результаты агрегированной геометрии не будут включать f1::e2.

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

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

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

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

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

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

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

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

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

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

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

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

Примечание:

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

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

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

Тип выборки

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

Опция типов результатов Сетевые слои позволяет вам возвращать результаты трассировки в виде выборок, примененных к векторным слоям в составном слое. Если эта опция выбрана в ArcGIS Pro, на карту добавляется новый составной слой. Векторные слои создаются только для классов, которые содержат объекты, возвращенные трассировкой. Каждый векторный слой содержит выборку объектов, возвращенных трассировкой и которые можно использовать для работы с результатами трассировки в ModelBuilder и Python.

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

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

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

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

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

  • networkSourceId
  • globalId
  • objectId

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

  • positionFrom и positionTo

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

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

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

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

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

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

Примечание:

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

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