Сводка
Возвращает выбранные объекты сети трассировки на основе связности или проходимости от выбранных начальных точек.
Возможности трассировки сети трассировки позволяют анализировать пути в вашей сети. Проходимость относится к путям, установленным между подключенными или связанными объектами, которые также удовлетворяют требованиям конфигурации.
По умолчанию, результаты трассировки возвращаются в виде выборки и включают целый объект линии. Чтобы возвратить частичные объекты, задайте для параметра Типы результатов значение Агрегировать геометрию. Если начальная точка или барьер размещены на соединении со связностью в средней точке, результаты трассировки возвратят частичные элементы объектов ребер. Если барьер размещен вдоль ребра, результаты трассировки могут остановиться на ближайшем соединении со связностью средней точки. Итоговый набор выборки объектов или входной класс пространственных объектов, созданный трассировкой, может затем быть распространен на другую карту, вид схемы сети или использоваться в качестве входных данных для другого инструмента или для трассировки.
Использование
Топология сети должна быть включена.
При работе с многопользовательской базой геоданных входная сеть трассировки должна поступать из сервиса объекток, сеть трассировки из подключения к базе данных не поддерживается.
Поскольку инструмент Трассировка полагается на топологию сети, результаты трассировки могут быть неточными в случае наличия в экстенте трассировки измененных областей. Сетевая топология для области, трассировка которой будет выполняться, должна быть проверена, чтобы она отражала последние изменения или обновления, выполненные для сети.
При работе с сетевыми атрибутами, назначенными для поля дат для барьеров условий, барьеров функций, функций и выходных условий, значение даты должно быть отформатировано как yyyy-mm-dd hh:mm:ss, например, 2020-10-12 18:45:31.
Синтаксис
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})| Parameter | Объяснение | Тип данных |
in_trace_network | Сеть трассировки, для которой будет запущена трассировка. При работе с многопользовательской базой геоданных входная сеть трассировки должна поступать из сервиса объекток, сеть трассировки из подключения к базе данных не поддерживается. | Trace Network; Trace Network Layer |
trace_type | Определяет тип выполняемой трассировки.
| 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.
| String |
shortest_path_network_attribute_name (Дополнительный) | Имя атрибута сети, который будет использован для вычисления пути. При запуске трассировки типа кратчайший путь, кратчайший путь вычисляется с помощью числового атрибута сети, такого как Длина объекта. Могут быть вычислены пути как на основе стоимости, так и на основе расстояния. Этот параметр является обязательным при запуске трассировки кратчайшего пути. | String |
include_barriers (Дополнительный) | Определяет, будут ли объекты барьеров проходимости включаться в результаты трассировки.
| Boolean |
validate_consistency (Дополнительный) | Определяет, будет ли возвращаться ошибка в случае обнаружения измененных областей для любого из пройденных объектов. Это единственный способ гарантировать, что трассировка проходит через объекты со статусом целостности в сети. Для удаления измененных областей проверьте топологию сети.
| Boolean |
ignore_barriers_at_starting_points (Дополнительный) | Определяет, будут ли в конфигурации трассировки игнорироваться барьеры для начальных точек.
| Boolean |
allow_indeterminate_flow (Дополнительный) | Определяет, будет ли выполняться трассировка объектов с неопределенным или неинициализированным потоком. Этот параметр используется только при запуске трассировки вверх или вниз по течению.
| Boolean |
condition_barriers [Name, Operator, Type, Value, Combine Using,...] (Дополнительный) | Задает условия проходимости барьеров в объекте на основании сравнения с сетевым атрибутом. Барьер условия использует атрибут сети, оператор и тип, а также значение атрибута. Например, остановить трассировку, если атрибут Code объекта равен заданному значению ArtificialPath. Если объект удовлетворяет этому условию, трассировка остановится. При использовании более одного атрибута можно применить параметр Combine Using, чтобы задать условие И или Или. Применяются следующие компоненты барьера условий:
Используются следующие компоненты Operator:
Используются следующие компоненты Type:
Combine Using имеет следующие параметры:
| Value Table |
function_barriers [Function, Attribute, Operator, Value, Use Local Values,...] (Дополнительный) | Задает барьер проходимости на объектах на основе функции. Барьеры функций можно применять, например, для ограничения того, насколько далеко трассировка может уйти от начальной точки, или установки максимального значения, при котором трассировка остановится. Например, длина каждой пройденной линии добавляется к общему пройденному на данный момент расстоянию. Когда общая пройденная длина достигнет указанного значения, трассировка остановится. Применяются следующие компоненты барьера функций:
Используются следующие компоненты Function:
Используются следующие компоненты Operator:
Используются следующие компоненты Use Local Values:
| Value Table |
traversability_scope (Дополнительный) | Устанавливает тип проходимости, который будет применяться. Область проходимости определяет, будут ли применены настройки проходимости для соединений, ребер или для обоих. Например, если в сети туристических троп для барьера условий задана остановка трассировки в случае, когда тип пути гравий и область проходимости задано только по соединениям, трассировка не остановится, даже при обнаружении гравийного пути, поскольку тип пути применяется только к ребрам. Другими словами, этот параметр определяет, должны ли при трассировке игнорироваться соединения, ребра, или и то, и другое.
| String |
functions [[Function, Attribute, Filter Name, Filter Operator, Filter Type, Filter Value],...] (Дополнительный) | Применяет функцию вычисления к результатам трассировки. Компоненты функций следующие:
Компоненты Function следующие:
Например, имеется начальная точка со значением 20. Следующий объект имеет значение 30. Если вы применяете функцию MIN, результатом будет 20. MAX – 30, ADD – 50, AVERAGE – 25, COUNT – 2 и SUBTRACT – -10. Компоненты Filter Operator следующие:
Компоненты Filter Type следующие:
| Value Table |
output_conditions [[Name, Operator, Type, Value, Combine Using],...] (Дополнительный) | Определяет типы возвращаемых объектов в зависимости от сетевого атрибута. Например, если трассировка настроена на фильтрацию всех объектов, кроме Водоотводов, любые трассированные объекты, которым не присвоена категория Водоотвод, не будут включены в результаты. Любые трассированные объекты с этой категорией будут возвращены в итоговом наборе выборки. Если используется более одного атрибута, можно использовать опцию Combine Using, чтобы задать условие И или Или. Компоненты выходных условий следующие:
Компоненты Operator следующие:
Компоненты Type следующие:
Компоненты Combine Using следующие:
| Value Table |
result_types [result_types,...] (Дополнительный) | Задает тип результатов трассировки.
| String |
selection_type | Определяет, как будет применяться выборка и что произойдет, если выборка уже существует.
| String |
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 (Дополнительный) | Определяет, будет ли использоваться существующая конфигурация трассировки для заполнения параметров инструмента Трассировка.
Примечание:Этот параметр требует использования Инженерной сети версии 2 или более поздней. | Boolean |
trace_config_name (Дополнительный) | Определяет имя конфигурации трассировки, которое будет использоваться для задания свойств трассировки. Это параметр активен только в тех случаях, когда параметр use_trace_config задан как USE_TRACE_CONFIGURATION. Примечание:Этот параметр требует использования Инженерной сети версии 2 или более поздней. | String |
Производные выходные данные
| Name | Объяснение | Тип данных |
| updated_trace_network | Обновленная сеть трассировки. | Любое значение |
Пример кода
Запускает трассировку вниз по течению для сети трассировки HydroNetwork с использованием функции Trace.
import arcpy
arcpy.Trace_tn(r"C:\MyProject\NHD.gdb\Hydro\HydroNetwork",
"DOWNSTREAM", r"C:\MyProject\NHD.gdb\TN_Temp_Starting_Points")Environments
Информация о лицензиях
- Basic: Нет
- Standard: Да
- Advanced: Да