Трассировка (Сеть трассировки)

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

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

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

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

Более подробно о трассировке в сети трассировки

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

• Топология сети должна быть включена.

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

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

• При работе с сетевыми атрибутами, назначенными полю дат для барьеров условий, барьеров функции, функций и выходных условий, формат значения даты должен быть отформатирован как yyyy-mm-dd hh:mm:ss, например, 2020-10-12 18:45:31.

Параметры

Диалог

Подпись	Описание	Тип данных
Входная сеть трассировки	Сеть трассировки, для которой будет запущена трассировка. При работе с многопользовательской базой геоданных входная сеть трассировки должна поступать из сервиса объектов, сеть трассировки из подключения к базе данных не поддерживается.	Trace Network; Trace Network Layer
Тип трассировки	Определяет тип выполняемой трассировки. Подключенная — будет использована трассировка подключенных, которая начинается с одной или нескольких начальных точек и распространяется наружу вдоль подключенных объектов. Вверх по течению —- будет использована трассировка вверх по течению, которая обнаруживает объекты выше по течению от местоположения в сети. Такой тип трассировки требует задания направления потока. Вниз по течению — будет использована трассировка вниз по течению, которая обнаруживает объекты ниже по течению от местоположения в сети. Такой тип трассировки требует задания направления потока. Кратчайший путь —- будет использован кратчайший путь трассировки, который находит кратчайший путь между двумя начальными точками сети независимо от направления стока. Стоимость прохождения этого пути определяется на основе атрибута сети, заданного для параметра Имя сетевого атрибута кратчайшего пути. Подключенный—Будет применена Трассировка подключенных, которая начинается с одной или нескольких начальных точек и распространяется наружу вдоль подключенных объектов. Вверх по течению—Будет использована трассировка вверх по течению, которая обнаруживает объекты выше по течению от местоположения в сети. Такой тип трассировки требует задания направления потока. Вниз по течению—Будет использована трассировка вниз по течению, которая обнаруживает объекты ниже по течению от местоположения в сети. Такой тип трассировки требует задания направления потока. Кратчайший путь—Будет использован кратчайший путь трассировки, который находит кратчайший путь между двумя начальными точками сети независимо от направления стока. Стоимость прохождения пути определяется на основе сетевого атрибута, заданного в параметре shortest_path_network_attribute_name.	String
Начальные точки	Слой объектов, созданный с помощью вкладки Начальные точки панели Трассировка местоположений, таблица или класс пространственных объектов, содержащий одну или более записей, представляющих начальные точки трассировки. Класс объектов TN_Temp_Starting_Points используется по умолчанию и создается в базе геоданных проекта по умолчанию, когда вы создаете начальные точки с помощью инструмента Начальные точки на панели Местоположения трассировки.	Feature Layer; Table View
Барьеры (Дополнительный)	Таблица или класс объектов, содержащие один или несколько объектов, представляющих барьеры трассировки, которые не дают трассировке пройти далее этой точки. Класс объектов TN_Temp_Barriers используется по умолчанию и создается в базе геоданных проекта по умолчанию, когда барьеры создаются с помощью вкладки Барьеры на панели Местоположения трассировки.	Feature Layer; Table View
Направление пути (Дополнительный)	Определяет направление пути трассировки. Стоимость прохождения пути определяется на основе атрибута сети, заданного в параметре Имя сетевого атрибута кратчайшего пути. Этот параметр используется только при запуске трассировки типа Кратчайший путь. Нет направления—Поиск пути между двумя начальными точками выполняется независимо от направления потока. Используется по умолчанию. Путь вверх по течению—Будет использоваться путь вверх по течению между двумя начальными точками. Путь вниз по течению—Будет использоваться путь вниз по течению между двумя начальными точками.	String
Имя сетевого атрибута кратчайшего пути (Дополнительный)	Имя атрибута сети, который будет использован для вычисления пути. При запуске трассировки типа кратчайший путь, кратчайший путь вычисляется с помощью числового атрибута сети, такого как Длина объекта. Могут быть вычислены пути как на основе стоимости, так и на основе расстояния. Этот параметр является обязательным при запуске трассировки кратчайшего пути.	String
Включить объекты барьеров (Дополнительный)	Определяет, будут ли объекты барьеров проходимости включены в результаты трассировки. Отмечено – объекты барьеров проходимости будут включены в результаты трассировки. Используется по умолчанию. Не отмечено – объекты барьеров проходимости не будут включены в результаты трассировки.	Boolean
Проверить согласованность (Дополнительный)	Определяет, будет ли возвращаться ошибка в случае обнаружения измененных областей для любого из возвращенных объектов. Это единственный способ гарантировать, что трассировка проходит через объекты со статусом целостности в сети. Для удаления измененных областей проверьте топологию сети. Отмечено — трассировка возвратит ошибку в случае обнаружения измененных областей для любого из пройденных объектов. Не отмечено — трассировка возвращает результаты независимо от обнаружения измененных областей для любых из возвращенных объектов. Используется по умолчанию.	Boolean
Игнорировать барьеры в начальных точках (Дополнительный)	Определяет, будут ли в конфигурации трассировки игнорироваться барьеры для начальных точек. Отмечено – барьеры в начальных точках будут проигнорированы при трассировке. Не отмечено – барьеры в начальных точках не будут проигнорированы при трассировке. Используется по умолчанию.	Boolean
Разрешать неопределенный поток (Дополнительный)	Определяет, будет ли выполняться трассировка объектов с неопределенным или неинициализированным потоком. Этот параметр используется только при запуске трассировки вверх или вниз по течению. Отмечено - трассировка объектов с неопределенным или неинициализированным потоком будет выполняться. Не отмечено - трассировка объектов с неопределенным или неинициализированным потоком не будет выполняться. Используется по умолчанию.	Boolean
Барьеры условий (Дополнительный)	Задает условия проходимости барьеров в объекте на основании сравнения с сетевым атрибутом. Барьер условия использует атрибут сети, оператор и тип, а также значение атрибута. Например, остановите трассировку, если атрибут Code объекта равен определенному значению ArtificialPath. Если объект удовлетворяет этому условию, трассировка остановится. При использовании более одного атрибута, можно применить параметр Комбинировать использование, чтобы задать условие И или Или. Применяются следующие компоненты барьера условий: Имя – фильтр по любому сетевому атрибуту, заданному в системе. Оператор – выбрать среди различных операторов. Тип – выбрать определенное значение или сетевой атрибут из значений, указанных в компоненте Имя. Значение – задайте определенное значение для типа входного атрибута, которое может вызвать прерывание на основании значения оператора. Комбинировать использование - задайте это значение, если собираетесь добавить несколько атрибутов. Вы можете комбинировать их, используя условие И или Или. Компоненты Оператора следующие: Равно – атрибут равен значению. Не равно – атрибут не равен значению. Больше – атрибут больше значения. Больше или равно – атрибут больше или равен значению. Меньше – атрибут меньше значения. Меньше или равно – атрибут меньше или равен значению. Компоненты Типа следующие: Заданное значение – включает фильтр по заданному значению. Сетевой атрибут – включает фильтр по атрибуту сети. Компоненты Объединенного использования следующие: И — Объединение барьеров условий. Или — используется если выполняется любое из барьеров условий. Равно—Атрибут равен значению. Не равно—Атрибут не равен значению. Больше—Атрибут больше значения. Больше или равно—Атрибут больше или равен значению. Меньше—Атрибут меньше значения. Меньше или равно—Атрибут меньше или равен значению. Определенное значение—Фильтр по определенному значению. Атрибут сети—Фильтр по сетевому атрибуту. И—Комбинировать барьеры условий. Или—Используйте, если выполняется любой из барьеров условий.	Value Table
Барьеры функции (Дополнительный)	Задает барьер проходимости на объектах на основе функции. Барьеры функций можно применять, например, для ограничения того, насколько далеко трассировка может уйти от начальной точки, или установки максимального значения, при котором трассировка остановится. Например, длина каждой пройденной линии добавляется к общему пройденному на данный момент расстоянию. Когда общая пройденная длина достигнет указанного значения, трассировка остановится. Применяются следующие компоненты барьера функций: Функция – выбрать среди различных функций вычисления. Атрибут – фильтр по любому сетевому атрибуту, заданному в системе. Оператор – выбрать среди различных операторов. Значение – укажите определенное значение типа входного атрибута, которое, если будет найдено, может вызвать прерывание. Использовать локальные значения – вычисляет значения в каждом направлении, в отличие от общего глобального значения. Например, барьер функций, вычисляет сумму длин объектов, при которой трассировка прекращается, если достигнуто значение, большее или равное 4. В общем случае, после того, как вы прошли два ребра со значениями 2, вы уже достигли суммы длин геометрий, равной 4, поэтому трассировка останавливается. Если используются локальные значения, изменяются локальные значения вдоль каждого пути, и трассировка продолжается. Функциональные компоненты следующие: Минимум – минимальное из входных значений. Максимум – максимальное из входных значений. Добавить – сумма входных значений. Среднее – среднее входных значений. Количество – количество пространственных объектов. Вычесть – разница между входными значениями. Например, у вас есть объект начальной точки со значением 20. Следующий объект имеет значение 30. Если вы используете функцию минимума, результат равен 20, максимум - 30, добавить - 50, среднее - 25, количество - 2 и разность -10. Компоненты Оператора следующие: Равно – атрибут равен значению. Не равно – атрибут не равен значению. Больше – атрибут больше значения. Больше или равно – атрибут больше или равен значению. Меньше – атрибут меньше значения. Меньше или равно – атрибут меньше или равен значению. Компоненты Использовать локальные значения Отмечено — будут использоваться локальные значения. Не отмечено — будут использоваться глобальные значения. Используется по умолчанию. Среднее—Среднее входных значений. Количество—Число объектов. Max—Максимальное из входных значений. Минимум—Минимальное из входных значений. Добавить—Добавить значения. Вычесть—Вычесть значения. Равно—Атрибут равен значению. Не равно—Атрибут не равен значению. Больше—Атрибут больше значения. Больше или равно—Атрибут больше или равен значению. Меньше—Атрибут меньше значения. Меньше или равно—Атрибут меньше или равен значению.	Value Table
Применить проходимость к (Дополнительный)	Задает тип проходимости, который будет применен. Область проходимости определяет, будут ли применены настройки проходимости для соединений, ребер или для обоих. Например, если в сети туристических троп для барьера условий задана остановка трассировки в случае, когда атрибут типа поверхности содержит значение гравия а для области проходимости заданы только соединения, трассировка не будет останавливаться даже при достижении ребра со значением в поле типа поверхности, так как атрибут типа поверхности относится только к ребрам. И соединения, и ребра—Проходимость будет применима как к соединениям, так и к ребрам. Используется по умолчанию. Только соединения—Проходимость будет применена только к соединениям. Только ребра—Проходимость будет применена только к ребрам.	String
Функции (Дополнительный)	Функция или функции вычисления, которые будут применяться к результатам трассировки. Функциональные компоненты следующие: Функция – выбрать среди различных функций вычисления. Атрибут – фильтр по любому сетевому атрибуту, заданному в системе. Имя фильтра – фильтрация результатов функции по имени атрибута. Оператор фильтра – выбрать среди различных операторов. Тип фильтра – выбрать среди различных типов фильтра. Значение фильтра – введите определенное значение атрибута входного фильтра. Опции Функционального компонента следующие: Мин. — минимальное из входных значений. Макс — максимальное из входных значений. Добавить — сумма входных значений. Среднее – среднее входных значений. Количество – количество пространственных объектов. Вычесть – разница между входными значениями. Например, у вас есть объект начальной точки со значением 20. Следующий объект имеет значение 30. Если используется функция Мин, результатом будет 20. Макс равно 30, Добавить равно 50, Среднее равно 25, Количество равно 2, а Разность равно -10. Параметры компонента Оператор фильтра следующие: Равно – атрибут равен значению. Не равно – атрибут не равен значению. Больше – атрибут больше значения. Больше или равно – атрибут больше или равен значению. Меньше – атрибут меньше значения. Меньше или равно – атрибут меньше или равен значению. Параметры компонента Тип фильтра следующие: Заданное значение – включает фильтр по заданному значению. Сетевой атрибут — фильтр по сетевому атрибуту Среднее—Среднее входных значений. Количество—Число объектов. Max—Максимальное из входных значений. Минимум—Минимальное из входных значений. Добавить—Cумма значений. Вычесть—Разница значений. Равно—Атрибут равен значению. Не равно—Атрибут не равен значению. Больше—Атрибут больше значения. Больше или равно—Атрибут больше или равен значению. Меньше—Атрибут меньше значения. Меньше или равно—Атрибут меньше или равен значению.	Value Table
Выходные условия (Дополнительный)	Определяет типы возвращаемых объектов в зависимости от сетевого атрибута. Например, если трассировка настроена на фильтрацию всех объектов, кроме Водоотводов, любые трассированные объекты, которым не присвоена категория Водоотвод, не будут включены в результаты. Любые трассированные объекты с этой категорией будут возвращены в итоговом наборе выборки. Компоненты выходных условий следующие: Имя – фильтр по любому сетевому атрибуту, заданному в системе. Оператор – выбрать среди различных операторов. Тип – выбрать определенное значение или сетевой атрибут из значений, указанных в компоненте Имя. Значение – задайте определенное значение для типа входного атрибута, которое может вызвать прерывание на основании значения оператора. Комбинировать использование - задайте это значение, если собираетесь добавить несколько атрибутов. Вы можете комбинировать их, используя условие И или Или. Параметры компонента Оператор следующие: Равно – атрибут равен значению. Не равно – атрибут не равен значению. Больше – атрибут больше значения. Больше или равно – атрибут больше или равен значению. Меньше – атрибут меньше значения. Меньше или равно – атрибут меньше или равен значению. Параметры компонента Тип следующие: Заданное значение – включает фильтр по заданному значению. Сетевой атрибут – включает фильтр по атрибуту сети. Равно—Атрибут равен значению. Не равно—Атрибут не равен значению. Больше—Атрибут больше значения. Больше или равно—Атрибут больше или равен значению. Меньше—Атрибут меньше значения. Меньше или равно—Атрибут меньше или равен значению.	Value Table
Типы результатов (Дополнительный)	Задает тип результатов, которые будет возвращать данная трассировка. Выборка—Результаты трассировки будут возвращаться в виде набора выборки соответствующих сетевых объектов. Используется по умолчанию. Агрегированная геометрия—Результаты трассировки будут агрегироваться по типу геометрии и сохраняться в классах объектов, отображающихся в слоях активной карты. Слои сетевых объектов—Результаты трассировки будут добавляться к векторным слоям, как набор выборок в групповом слое. Связность—Результаты трассировки будут возвращены в виде графа связности в указанный выходной файл .json. Эта опция активирует параметр Выходной JSON. Элементы—Результаты трассировки будут возвращены в виде информации на основе объектов в указанный выходной файл .json. Эта опция активирует параметр Выходной JSON.	String
Тип выборки	Определяет, как будет применяться выборка и что произойдет, если есть текущая выборка. Новая выборка—Результирующая выборка заменит текущую. Используется по умолчанию. Добавить к текущей выборке—Результирующая выборка добавится к текущей, если она есть. Если никакой выборки нет, данная опция работает так же, как и опция создания новой выборки. Удалить из текущей выборки—Результирующая выборка будет удалена из текущей. Если во входном слое объекты не были выбраны, выбор данной опции не приведет ни к какому результату. Выбрать поднабор из текущей выборки—Результирующая выборка будет комбинирована с существующей. Выбранными останутся только те записи, которые являются общими для обеих выборок. Переключить текущую выборку—Результирующая выборка будет переключена. Результаты, которые были выбраны, удаляются из текущей выборки, а все ранее не выбранные записи добавляются к текущей выборке. Если никакой выборки нет, данная опция работает так же, как и опция создания новой выборки.	String
Очистить все результаты предыдущих трассировок (Дополнительный)	Определяет, будет ли содержимое вырезано из или добавлено к классам объектов, которые выбраны для хранения агрегированной геометрии. Этот параметр используется только для типа результата Агрегированная геометрия. Отмечено – классы объектов, хранящие агрегированную геометрию трассировки, будут усечены. Будет записана только выходная геометрия из текущей операции трассировки. Используется по умолчанию. Не отмечено – выходная геометрия текущей операции трассировки будет присоединена к классам объектов, хранящим агрегированную геометрию.	Boolean
Имя трассировки (Дополнительный)	Имя операции трассировки. Это значение хранится в поле TRACENAME выходного класса объектов, способствуя идентификации результатов трассировки. Этот параметр используется только для типа результата Агрегированная геометрия.	String
Агрегированные точки (Дополнительный)	Выходной класс мультиточечных объектов, содержащий агрегированную результирующую геометрию. По умолчанию параметр заполняется сгенерированным системой классом объектов Trace_Results_Aggregated_Points, который будет сохраняться в базе геоданных проекта по умолчанию. Этот класс объектов будет создан автоматически, если он не существует. Существующий класс объектов также может использоваться для хранения агрегированной геометрии. При использовании класса объектов, отличного от класса объектов по умолчанию, это должен быть класс мультиточечных объектов, содержащий текстовое поле TRACENAME. Этот параметр используется только для типа результата Агрегированная геометрия.	Feature Class
Агрегированные линии (Дополнительный)	Выходной класс полилинейных объектов, содержащий агрегированную результирующую геометрию. По умолчанию параметр заполняется сгенерированным системой классом объектов Trace_Results_Aggregated_Lines, который будет сохраняться в базе геоданных проекта по умолчанию. Этот класс объектов будет создан автоматически, если он не существует. Существующий класс объектов также может использоваться для хранения агрегированной геометрии. При использовании класса объектов, отличного от класса объектов по умолчанию, это должен быть класс полилинейных объектов, содержащий текстовое поле TRACENAME. Этот параметр используется только для типа результата Агрегированная геометрия.	Feature Class
Имя выходного составного слоя (Дополнительный)	Имя выходного группового слоя, который содержит векторные слои с выборками объектов, возвращенными трассировкой. Слой обеспечивает доступ к работе с выходными данными трассировки в ModelBuilder и Python. Этот параметр применим только для типа результатов сетевой слой.	Group Layer
Использовать конфигурацию трассировки (Дополнительный)	Определяет, будет ли использоваться существующая именованная конфигурация трассировки для заполнения параметров инструмента Трассировка. Отмечено — существующая именованная конфигурация трассировки будет использоваться для задания свойств трассировки. Будут проигнорированы все параметры, за исключением параметров Имя конфигурации трассировки, Начальные точки и Барьеры. Не отмечено — существующая именованная конфигурация трассировки будет использоваться для задания свойств трассировки. Используется по умолчанию. Примечание: Этот параметр требует использования Инженерной сети версии 2 или более поздней.	Boolean
Имя конфигурации трассировки (Дополнительный)	Имя конфигурации трассировки, которое будет использоваться для задания свойств трассировки. Этот параметр будет активен только в случае, если отмечен параметр Использовать конфигурацию трассировки. Примечание: Этот параметр требует использования Инженерной сети версии 2 или более поздней.	String
Выходной JSON (Дополнительный)	Название и местоположение, для создания файла .json.	File

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

Подпись	Описание	Тип данных
Обновленная сеть трассировки	Обновленная трассировка сети.	Any Value

Python

arcpy.tn.Trace(in_trace_network, trace_type, starting_points, {barriers}, {path_direction}, {shortest_path_network_attribute_name}, {include_barriers}, {validate_consistency}, {ignore_barriers_at_starting_points}, {allow_indeterminate_flow}, {condition_barriers}, {function_barriers}, {traversability_scope}, {functions}, {output_conditions}, {result_types}, selection_type, {clear_all_previous_trace_results}, {trace_name}, {aggregated_points}, {aggregated_lines}, {out_network_layer}, {use_trace_config}, {trace_config_name}, {out_json_file})

Имя	Описание	Тип данных
in_trace_network	Сеть трассировки, для которой будет запущена трассировка. При работе с многопользовательской базой геоданных входная сеть трассировки должна поступать из сервиса объектов, сеть трассировки из подключения к базе данных не поддерживается.	Trace Network; Trace Network Layer
trace_type	Определяет тип выполняемой трассировки. CONNECTED—Будет применена Трассировка подключенных, которая начинается с одной или нескольких начальных точек и распространяется наружу вдоль подключенных объектов. UPSTREAM—Будет использована трассировка вверх по течению, которая обнаруживает объекты выше по течению от местоположения в сети. Такой тип трассировки требует задания направления потока. DOWNSTREAM—Будет использована трассировка вниз по течению, которая обнаруживает объекты ниже по течению от местоположения в сети. Такой тип трассировки требует задания направления потока. SHORTEST_PATH—Будет использован кратчайший путь трассировки, который находит кратчайший путь между двумя начальными точками сети независимо от направления стока. Стоимость прохождения пути определяется на основе сетевого атрибута, заданного в параметре shortest_path_network_attribute_name.	String
starting_points	Слой объектов, созданный с помощью вкладки Начальные точки панели Трассировка местоположений, таблица или класс пространственных объектов, содержащий одну или более записей, представляющих начальные точки трассировки. Класс объектов TN_Temp_Starting_Points используется по умолчанию и создается в базе геоданных проекта по умолчанию, когда вы создаете начальные точки с помощью инструмента Начальные точки на панели Местоположения трассировки.	Feature Layer; Table View
barriers (Дополнительный)	Таблица или класс объектов, содержащие один или несколько объектов, представляющих барьеры трассировки, которые не дают трассировке пройти далее этой точки. Класс объектов TN_Temp_Barriers используется по умолчанию и создается в базе геоданных проекта по умолчанию, когда барьеры создаются с помощью вкладки Барьеры на панели Местоположения трассировки.	Feature Layer; Table View
path_direction (Дополнительный)	Определяет направление пути трассировки. Стоимость прохождения пути определяется на основе значения параметра shortest_path_network_attribute_name. Этот параметр учитывается только при запуске трассировки типа SHORTEST_PATH. NO_DIRECTION—Поиск пути между двумя начальными точками выполняется независимо от направления потока. Используется по умолчанию. PATH_UPSTREAM—Будет использоваться путь вверх по течению между двумя начальными точками. PATH_DOWNSTREAM—Будет использоваться путь вниз по течению между двумя начальными точками.	String
shortest_path_network_attribute_name (Дополнительный)	Имя атрибута сети, который будет использован для вычисления пути. При запуске трассировки типа кратчайший путь, кратчайший путь вычисляется с помощью числового атрибута сети, такого как Длина объекта. Могут быть вычислены пути как на основе стоимости, так и на основе расстояния. Этот параметр является обязательным при запуске трассировки кратчайшего пути.	String
include_barriers (Дополнительный)	Определяет, будут ли объекты барьеров проходимости включены в результаты трассировки. INCLUDE_BARRIERS—Объекты барьеров проходимости будут включаться в результаты трассировки. Используется по умолчанию. EXCLUDE_BARRIERS—Объекты барьеров проходимости не будут включаться в результаты трассировки.	Boolean
validate_consistency (Дополнительный)	Определяет, будет ли возвращаться ошибка в случае обнаружения измененных областей для любого из возвращенных объектов. Это единственный способ гарантировать, что трассировка проходит через объекты со статусом целостности в сети. Для удаления измененных областей проверьте топологию сети. VALIDATE_CONSISTENCY—Трассировка возвратит ошибку в случае обнаружения измененных областей для любого из возвращенных объектов. DO_NOT_VALIDATE_CONSISTENCY—Трассировка возвращает результаты независимо от обнаружения измененных областей для любых из возвращенных объектов. Используется по умолчанию.	Boolean
ignore_barriers_at_starting_points (Дополнительный)	Определяет, будут ли в конфигурации трассировки игнорироваться барьеры для начальных точек. IGNORE_BARRIERS_AT_STARTING_POINTS—Барьеры в начальных точках будут проигнорированы при трассировке. DO_NOT_IGNORE_BARRIERS_AT_STARTING_POINTS—Барьеры в начальных точках не будут проигнорированы при трассировке. Используется по умолчанию.	Boolean
allow_indeterminate_flow (Дополнительный)	Определяет, будет ли выполняться трассировка объектов с неопределенным или неинициализированным потоком. Этот параметр используется только при запуске трассировки вверх или вниз по течению. TRACE_INDETERMINATE_FLOW—Трассировка объектов с неопределенным или неинициализированным потоком будет выполняться. IGNORE_INDETERMINATE_FLOW—Трассировка объектов с неопределенным или неинициализированным потоком выполняться не будет. Используется по умолчанию.	Boolean
condition_barriers [Name, Operator, Type, Value, Combine Using,...] (Дополнительный)	Задает условия проходимости барьеров в объекте на основании сравнения с сетевым атрибутом. Барьер условия использует атрибут сети, оператор и тип, а также значение атрибута. Например, остановите трассировку, если атрибут Code объекта равен определенному значению ArtificialPath. Если объект удовлетворяет этому условию, трассировка остановится. При использовании более одного атрибута можно применить компонент Combine Using, чтобы задать условие либо И, либо Или. Применяются следующие компоненты барьера условий: Name – фильтр по любому из атрибутов сети, определенному в системе. Operator – выбрать среди различных операторов. Type – выбрать определенное значение или сетевой атрибут из значений, указанных в компоненте Name. Value - задайте определенное значение для типа входного атрибута, которое может вызвать прерывание на основании значения оператора. Combine Using — задайте это значение, если собираетесь добавить несколько атрибутов. Вы можете комбинировать их, используя условие И или Или. Компоненты Operator следующие: IS_EQUAL_TO—Атрибут равен значению. DOES_NOT_EQUAL—Атрибут не равен значению. IS_GREATER_THAN—Атрибут больше значения. IS_GREATER_THAN_OR_EQUAL_TO—Атрибут больше или равен значению. IS_LESS_THAN—Атрибут меньше значения. IS_LESS_THAN_OR_EQUAL_TO—Атрибут меньше или равен значению. Компоненты Type следующие: SPECIFIC_VALUE—Фильтр по определенному значению. NETWORK_ATTRIBUTE—Фильтр по сетевому атрибуту. Компонент Combine Using следующий: AND—Комбинировать барьеры условий. OR—Используйте, если выполняется любой из барьеров условий.	Value Table
function_barriers [Function, Attribute, Operator, Value, Use Local Values,...] (Дополнительный)	Задает барьер проходимости на объектах на основе функции. Барьеры функций можно применять, например, для ограничения того, насколько далеко трассировка может уйти от начальной точки, или установки максимального значения, при котором трассировка остановится. Например, длина каждой пройденной линии добавляется к общему пройденному на данный момент расстоянию. Когда общая пройденная длина достигнет указанного значения, трассировка остановится. Применяются следующие компоненты барьера функций: Function - выбрать среди различных функций вычисления. Attribute - фильтр по любому сетевому атрибуту, заданному в системе. Operator - выбрать среди различных операторов. Value – укажите определенное значение типа входного атрибута, которое, если будет найдено, может вызвать прерывание. Use Local Values – вычисляет значения в каждом направлении, в противоположность общему глобальному значению. Например, барьер функций, вычисляет сумму длин объектов, при которой трассировка прекращается, если достигнуто значение, большее или равное 4. В общем случае, после того, как вы прошли два ребра со значениями 2, вы уже достигли суммы длин геометрий, равной 4, поэтому трассировка останавливается. Если используются локальные значения, изменяются локальные значения вдоль каждого пути, и трассировка продолжается. Компоненты Function следующие: AVERAGE—Среднее входных значений. COUNT—Число объектов. MAX—Максимальное из входных значений. MIN—Минимальное из входных значений. ADD—Добавить значения. SUBTRACT—Вычесть значения. Компоненты Operator следующие: IS_EQUAL_TO—Атрибут равен значению. DOES_NOT_EQUAL—Атрибут не равен значению. IS_GREATER_THAN—Атрибут больше значения. IS_GREATER_THAN_OR_EQUAL_TO—Атрибут больше или равен значению. IS_LESS_THAN—Атрибут меньше значения. IS_LESS_THAN_OR_EQUAL_TO—Атрибут меньше или равен значению. Компоненты Use Local Values следующие: TRUE—Использовать локальные значения. FALSE—Использовать глобальные значения. Используется по умолчанию.	Value Table
traversability_scope (Дополнительный)	Задает тип проходимости, который будет применен. Область проходимости определяет, будут ли применены настройки проходимости для соединений, ребер или для обоих. Например, если в сети туристических троп для барьера условий задана остановка трассировки в случае, когда тип пути гравий и область проходимости задано только по соединениям, трассировка не остановится, даже при обнаружении гравийного пути, поскольку тип пути применяется только к ребрам. BOTH_JUNCTIONS_AND_EDGES—Проходимость будет применима как к соединениям, так и к ребрам. Используется по умолчанию. JUNCTIONS_ONLY—Проходимость будет применена только к соединениям. EDGES_ONLY—Проходимость будет применена только к ребрам.	String
functions [[Function, Attribute, Filter Name, Filter Operator, Filter Type, Filter Value],...] (Дополнительный)	Функция или функции вычисления, которые будут применяться к результатам трассировки. Функциональные компоненты следующие: Function - выбрать среди различных функций вычисления. Attribute - фильтр по любому сетевому атрибуту, заданному в системе. Filter Name – фильтрация результатов функции по имени атрибута. Filter Operator - выбрать среди различных операторов. Filter Type – выбрать среди различных типов фильтра. Filter Value – введите определенное значение атрибута входного фильтра. Параметры компонента Function следующие: AVERAGE—Среднее входных значений. COUNT—Число объектов. MAX—Максимальное из входных значений. MIN—Минимальное из входных значений. ADD—Cумма значений. SUBTRACT—Разница значений. Например, у вас есть объект начальной точки со значением 20. Следующий объект имеет значение 30. Если вы используете функцию MIN, результат равен 20. MAX равен 30, ADD равен 50, AVERAGE равен 25, COUNT равен 2, а SUBTRACT равен -10. Параметры компонента Filter Operator следующие: IS_EQUAL_TO—Атрибут равен значению. DOES_NOT_EQUAL—Атрибут не равен значению. IS_GREATER_THAN—Атрибут больше значения. IS_GREATER_THAN_OR_EQUAL_TO—Атрибут больше или равен значению. IS_LESS_THAN—Атрибут меньше значения. IS_LESS_THAN_OR_EQUAL_TO—Атрибут меньше или равен значению. Параметры компонента Filter Type следующие: SPECIFIC_VALUE—Фильтр по определенному значению. NETWORK_ATTRIBUTE—Фильтр по сетевому атрибуту.	Value Table
output_conditions [[Name, Operator, Type, Value, Combine Using],...] (Дополнительный)	Определяет типы возвращаемых объектов в зависимости от сетевого атрибута. Например, если трассировка настроена на фильтрацию всех объектов, кроме Водоотводов, любые трассированные объекты, которым не присвоена категория Водоотвод, не будут включены в результаты. Любые трассированные объекты с этой категорией будут возвращены в итоговом наборе выборки. Если используется более одного атрибута, можно использовать опцию Combine Using, чтобы задать условие либо И, либо Или. Компоненты выходных условий следующие: Name – фильтр по любому из атрибутов сети, определенному в системе. Operator - выбрать среди различных операторов. Type — выберите конкретное значение или сетевой атрибут из значения, указанного в компоненте Name. Value – укажите определенное значение типа входного атрибута, которое может вызвать прекращение трассировки на основании значения оператора. Combine Using — задайте это значение, если собираетесь добавить несколько атрибутов. Вы можете комбинировать их, используя условие И или Или. Параметры компонента Operator следующие: IS_EQUAL_TO—Атрибут равен значению. DOES_NOT_EQUAL—Атрибут не равен значению. IS_GREATER_THAN—Атрибут больше значения. IS_GREATER_THAN_OR_EQUAL_TO—Атрибут больше или равен значению. IS_LESS_THAN—Атрибут меньше значения. IS_LESS_THAN_OR_EQUAL_TO—Атрибут меньше или равен значению. Параметры компонента Type следующие: SPECIFIC_VALUE—Фильтр по определенному значению. NETWORK_ATTRIBUTE—Фильтр по сетевому атрибуту. Параметры компонента Combine Using следующие: AND—Комбинирование условий. OR—Используйте, если выполняется любое из условий.	Value Table
result_types [result_types,...] (Дополнительный)	Задает тип результатов, которые будет возвращать данная трассировка. SELECTION—Результаты трассировки будут возвращаться в виде набора выборки соответствующих сетевых объектов. Используется по умолчанию. AGGREGATED_GEOMETRY—Результаты трассировки будут агрегироваться по типу геометрии и сохраняться в классах объектов, отображающихся в слоях активной карты. NETWORK_LAYERS—Результаты трассировки будут добавляться к векторным слоям, как набор выборок в групповом слое. CONNECTIVITY—Результаты трассировки будут возвращены в виде графа связности в указанный выходной файл .json. Эта опция активирует параметр out_json_file. ELEMENTS—Результаты трассировки будут возвращены в виде элементов объекта в указанный выходной файл .json. Эта опция активирует параметр out_json_file.	String
selection_type	Определяет, как будет применяться выборка и что произойдет, если есть текущая выборка. NEW_SELECTION—Результирующая выборка заменит текущую. Используется по умолчанию. ADD_TO_SELECTION—Результирующая выборка добавится к текущей, если она есть. Если никакой выборки нет, данная опция работает так же, как и опция создания новой выборки. REMOVE_FROM_SELECTION—Результирующая выборка будет удалена из текущей. Если во входном слое объекты не были выбраны, выбор данной опции не приведет ни к какому результату. SUBSET_SELECTION—Результирующая выборка будет комбинирована с существующей. Выбранными останутся только те записи, которые являются общими для обеих выборок. SWITCH_SELECTION—Результирующая выборка будет переключена. Результаты, которые были выбраны, удаляются из текущей выборки, а все ранее не выбранные записи добавляются к текущей выборке. Если никакой выборки нет, данная опция работает так же, как и опция создания новой выборки.	String
clear_all_previous_trace_results (Дополнительный)	Определяет, будет ли содержимое вырезано из или добавлено к классам объектов, которые выбраны для хранения агрегированной геометрии. Этот параметр используется только для типа результата Агрегированная геометрия. CLEAR_ALL_PREVIOUS_TRACE_RESULTS—Классы объектов, хранящие агрегированную геометрию трассировки, будут усечены. Будет записана только выходная геометрия из текущей операции трассировки. Используется по умолчанию. DO_NOT_CLEAR_ALL_PREVIOUS_TRACE_RESULTS—Выходная геометрия текущей операции трассировки будет присоединена к классам объектов, хранящим агрегированную геометрию.	Boolean
trace_name (Дополнительный)	Имя операции трассировки. Это значение хранится в поле TRACENAME выходного класса объектов, способствуя идентификации результатов трассировки. Этот параметр используется только для типа результата Агрегированная геометрия.	String
aggregated_points (Дополнительный)	Выходной класс мультиточечных объектов, содержащий агрегированную результирующую геометрию. По умолчанию параметр заполняется сгенерированным системой классом объектов Trace_Results_Aggregated_Points, который будет сохраняться в базе геоданных проекта по умолчанию. Этот класс объектов будет создан автоматически, если он не существует. Существующий класс объектов также может использоваться для хранения агрегированной геометрии. При использовании класса объектов, отличного от класса объектов по умолчанию, это должен быть класс мультиточечных объектов, содержащий текстовое поле TRACENAME. Этот параметр используется только для типа результата Агрегированная геометрия.	Feature Class
aggregated_lines (Дополнительный)	Выходной класс полилинейных объектов, содержащий агрегированную результирующую геометрию. По умолчанию параметр заполняется сгенерированным системой классом объектов Trace_Results_Aggregated_Lines, который будет сохраняться в базе геоданных проекта по умолчанию. Этот класс объектов будет создан автоматически, если он не существует. Существующий класс объектов также может использоваться для хранения агрегированной геометрии. При использовании класса объектов, отличного от класса объектов по умолчанию, это должен быть класс полилинейных объектов, содержащий текстовое поле TRACENAME. Этот параметр используется только для типа результата Агрегированная геометрия.	Feature Class
out_network_layer (Дополнительный)	Имя выходного группового слоя, который содержит векторные слои с выборками объектов, возвращенными трассировкой. Слой обеспечивает доступ к работе с выходными данными трассировки в ModelBuilder и Python. Этот параметр применим только для типа результатов сетевой слой.	Group Layer
use_trace_config (Дополнительный)	Определяет, будет ли использоваться существующая именованная конфигурация трассировки для заполнения параметров инструмента Трассировка. USE_TRACE_CONFIGURATION—Существующая именованная конфигурация трассировки будет использоваться для задания свойств трассировки. Будут проигнорированы все параметры, за исключением trace_config_name, starting_points и barriers. DO_NOT_USE_TRACE_CONFIGURATION—Существующая именованная конфигурация трассировки не будет использоваться для определения свойств трассировки. Используется по умолчанию. Примечание: Этот параметр требует использования Инженерной сети версии 2 или более поздней.	Boolean
trace_config_name (Дополнительный)	Имя конфигурации трассировки, которое будет использоваться для задания свойств трассировки. Этот параметр включается только если параметр use_trace_config имеет значение USE_TRACE_CONFIGURATION. Примечание: Этот параметр требует использования Инженерной сети версии 2 или более поздней.	String
out_json_file (Дополнительный)	Название и местоположение, для создания файла .json.	File

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

Имя	Описание	Тип данных
updated_trace_network	Обновленная трассировка сети.	Any Value

Пример кода

Пример трассировки (окно Python)

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

import arcpy

tn = r"C:\MyProject\NHD.gdb\Hydro\HydroNetwork"
trace = arcpy.tn.Trace(
    tn, "DOWNSTREAM", r"C:\Projects\Default.gdb\TN_Temp_Starting_Points", 
    r"C:\Projects\Default.gdb\TN_Temp_Barriers", "NO_DIRECTION", "", 
    "INCLUDE_BARRIERS", "VALIDATE_CONSISTENCY", 
    "DO_NOT_IGNORE_BARRIERS_AT_STARTING_POINTS", "IGNORE_INDETERMINATE_FLOW", 
    None, "ADD 'Shape length' IS_EQUAL_TO 500 true", "BOTH_JUNCTIONS_AND_EDGES", 
    None, None, "NETWORK_LAYERS", "NEW_SELECTION", 
    "CLEAR_ALL_PREVIOUS_TRACE_RESULTS", "", "", "", "MyTraceResult"
)

Параметры среды

Этот инструмент не использует параметры среды геообработки

Информация о лицензиях

• Basic: Нет
• Standard: Да
• Advanced: Да