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

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

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

Вместе с этими типами трассировки инструмент Трассировка также включает комплекс расширенной конфигурации для уточнения каждого типа трассировки. Эти настройки позволяют установить проходимость, различать, какие объекты будут возвращены, настраивать выполняемые вычисления. Для сохранения сложных настроек можно использовать 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. Можно задать несколько функций для одной трассировки.

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

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

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

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

Рассмотрим сценарий, включающий дорожную сеть, в этом случае вводится атрибут сети для возврата проложенных троп. Здесь класс 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 в указанном месте, который можно использовать в качестве входных данных для выполнения дополнительного анализа.

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

  • networkSourceId
  • globalId
  • objectId

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

  • positionFrom и positionTo

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

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

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

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

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

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

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