Наверх

Добавить конфигурацию трассировки (Сеть трассировки)

В этом разделе

  1. Сводка
  2. Использование
  3. Синтаксис
  4. Пример кода
  5. Environments
  6. Информация о лицензиях

Сводка

Создает конфигурацию трассировки в сети трассировки.

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

Подробнее о том, как добавить конфигурацию трассировки

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

  • Входная сеть трассировки должна быть версии 2 или более поздней.

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

  • В качестве создателя конфигурации трассировки указана подключенная учетная запись портала.

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

Синтаксис

arcpy.tn.AddTraceConfiguration(in_trace_network, trace_config_name, trace_type, {description}, {tags}, {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})
ParameterОбъяснениеТип данных
in_trace_network

Сети трассировки, которая будет содержать новую конфигурацию трассировки.

Trace Network; Trace Network Layer
trace_config_name

Имя конфигурации трасссировки.

String
trace_type

Задает тип настраиваемой трассировки.

  • CONNECTED —Трассировка подключенных начинается с одной или нескольких начальных точек и распространяется наружу вдоль подключенных объектов.
  • UPSTREAM —Трассировка вверх против течения обнаруживает объекты выше по течению от местоположения в сети. Этот тип трассировки использует направление потока.
  • DOWNSTREAM —Трассировка вниз по течению обнаруживает объекты ниже по течению от местоположения в сети. Этот тип трассировки использует направление потока.
  • SHORTEST_PATH —Трассировки кратчайшего пути находит кратчайший путь между двумя начальными точками сети независимо от направления стока. Стоимость прохождения пути определяется на основе сетевого атрибута, заданного в параметре shortest_path_network_attribute_name.
String
description
(Дополнительный)

Описание конфигурации трассировки.

String
tags
[tags,...]
(Дополнительный)

Набор тегов, используемых для идентификации конфигурации трассировки. Теги могут использоваться в поиске и индексировании.

String
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 —Атрибут меньше значения.

Используются следующие компоненты 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 —Атрибут меньше значения.

Компоненты 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 —Атрибут меньше значения.

Компоненты Type следующие:

  • SPECIFIC_VALUE —Фильтр по заданному значению.
  • NETWORK_ATTRIBUTE —Фильтр по сетевому атрибуту.

Компоненты Combine Using следующие:

  • AND —Комбинировать условия.
  • OR —Использовать, если выполняется любое из условий.
Value Table
result_types
[result_types,...]
(Дополнительный)

Задает тип результатов, которые будет возвращать данная трассировка.

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

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

NameОбъяснениеТип данных
updated_trace_network

Обновленная трассировка сети.

Сеть трассировки

Пример кода

AddTraceConfiguration, пример (окно Python)

Этот пример скрипта добавляет конфигурацию трассировки с именем Upstream_HUC12 в сеть трассировки с именем HydroNetwork.

import arcpy
arcpy.AddTraceConfiguration_un(
        r"HydroNetwork", "Upstream_HUC12", "UPSTREAM", 
        "Upstream trace for HUC12_allow indeterminate", "HUC12;Upstream", 
        "NO_DIRECTION", '', "INCLUDE_BARRIERS", "VALIDATE_CONSISTENCY", 
        "DO_NOT_IGNORE_BARRIERS_AT_STARTING_POINTS", "TRACE_INDETERMINATE_FLOW", 
        None, None, "BOTH_JUNCTIONS_AND_EDGES", None, None, None)

Environments

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

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

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

Связанные разделы

  • Обзор группы инструментов Конфигурация трассировки
  • Поиск инструмента геообработки

Отзыв по этому разделу?

В этом разделе
  1. Сводка
  2. Использование
  3. Синтаксис
  4. Пример кода
  5. Environments
  6. Информация о лицензиях