Добавить местоположения трассировки (Инженерная сеть)

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

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

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

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

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

Параметры

ПодписьОписаниеТип данных
Входная инженерная сеть

Входная инженерная сеть, куда будут добавлены местоположения трассировки.

Utility Network; Utility Network Layer
Выходной класс пространственных объектов

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

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

Feature Class
Загрузка выбранных объектов
(Дополнительный)

Указывает, будут ли выбранные объекты загружены в активную карту как местоположения трассировки.

  • Отмечено - загружает местоположения трассировки на основе выборки на карте.
  • Не отмечено - не загружает местоположения трассировки на основе выборки на карте. Это значение по умолчанию Тем не менее местоположения трассировки можно загрузить с помощью параметра Местоположения трассировки.

Boolean
Очистить местоположения трассировки
(Дополнительный)

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

  • Отмечено — существующие местоположения трассировки будут очищены.
  • Не отмечено — существующие местоположения трассировки будут сохранены и не очищены. Это значение по умолчанию

Boolean
Местоположения трассировки
(Дополнительный)

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

Имеются следующие свойства местоположений трассировки:

  • Имя слоя - слой, участвующий в инженерной сети, который содержит добавляемые местоположения начальных точек и барьеров. Если имеется активная карта, допускается выбор слоев только с карты.
  • Глобальный ID - глобальный ID добавляемого объекта слоя.
  • ID терминала - ID терминала добавляемого объекта слоя.
  • Процент вдоль - процент вдоль значений объекта. Для линейных объектов по умолчанию используется 0.5.

Value Table
Барьер фильтра

Определяет, будут ли барьеры для местоположений трассировки действовать как барьеры фильтра.

  • Отмечено - барьеры будут действовать как барьеры фильтра. Удобно для трассировок подсетей, когда барьеры позволяют сначала оценить подсеть и применяются при втором проходе объектов сети.
  • Не отмечено - барьеры не будут вести себя как барьеры фильтра; они будут вести себя как барьеры проходимости, которые определяют экстент подсетей и применяются при первом проходе. Это значение по умолчанию

Примечание:

Для этого параметра требуется ArcGIS Enterprise 10.8.1 или более новая версия.

Boolean

arcpy.un.AddTraceLocations(in_utility_network, out_feature_class, {load_selected_features}, {clear_trace_locations}, {trace_locations}, filter_barrier)
ИмяОписаниеТип данных
in_utility_network

Входная инженерная сеть, куда будут добавлены местоположения трассировки.

Utility Network; Utility Network Layer
out_feature_class

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

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

Feature Class
load_selected_features
(Дополнительный)

Указывает, будут ли выбранные объекты загружены в активную карту как местоположения трассировки.

  • LOAD_SELECTED_FEATURESЗагружает местоположения трассировки на основе выборки на карте.
  • DO_NOT_LOAD_SELECTED_FEATURESНе загружает местоположения трассировки на основе выборки на карте. Это значение по умолчанию Тем не менее местоположения трассировки можно загрузить с помощью параметра trace_locations.
Boolean
clear_trace_locations
(Дополнительный)

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

  • CLEAR_LOCATIONSСуществующие местоположения трассировки будут очищены.
  • KEEP_LOCATIONSСуществующие местоположения трассировки будут сохранены и не очищены. Это значение по умолчанию
Boolean
trace_locations
[[Layer Name, Global ID, Terminal ID, Percent Along],...]
(Дополнительный)

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

Имеются следующие свойства местоположений трассировки:

  • Layer Name - слой или класс объектов, участвующий в инженерной сети, который содержит добавляемые местоположения начальных точек и барьеров. Если имеется активная карта, допускается выбор слоев только с карты; если нет, используется имя класса пространственных объектов.
  • Global ID - Global ID объекта для добавляемого местоположения.
  • Terminal ID - ID терминала объекта для добавляемого местоположения.
  • Percent Along - процент от значения объекта. Для линейных объектов по умолчанию используется 0.5.

Value Table
filter_barrier

Определяет, будут ли барьеры для местоположений трассировки действовать как барьеры фильтра.

Более подробно о барьерах

  • FILTER_BARRIERБарьеры будут действовать как барьеры фильтра. Удобно для трассировок подсетей, когда барьеры позволяют сначала оценить подсеть и применяются при втором проходе объектов сети.
  • TRAVERSABILITY_BARRIERБарьеры будут вести себя как барьеры проходимости, которые определяют экстент подсетей и применяются при первом проходе. Это значение по умолчанию
Примечание:

Для этого параметра требуется ArcGIS Enterprise 10.8.1 или более новая версия.

Boolean

Пример кода

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

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

import arcpy
arcpy.env.outputZFlag = "Enabled"
arcpy.AddTraceLocations_un("Naperville Electric UN", 
                           r"C:\MyUNProject\MyUNProject.gdb\TraceLocations",
                           "LOAD_SELECTED_FEATURES")
AddTraceLocations, пример 2 (автономный скрипт)

Добавляет местоположения трассировки к имеющемуся классу объектов TraceLocations без использования активной карты.


import arcpy

# Set the outputZFlag environment to Enabled
arcpy.env.outputZFlag = "Enabled"

# AddTraceLocations
arcpy.AddTraceLocations_un(r"http://utilitynetwork.esri.com/server/rest/services/NapervilleElectric/FeatureServer/9", 
                           r"C:\MyUNProject\MyUNProject.gdb\TraceLocations",
                           "DO_NOT_LOAD_SELECTED_FEATURES",
                           "KEEP_LOCATIONS",
                           r"'Circuit Breaker' {DDB0765D-860A-4054-908D-9360E1A32F74} '(3/Load)' '';'Circuit Breaker' {4849D307-6413-40B7-B672-716AF50EE6E6} '(3/Load)' '' )

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

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

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