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

Сводка

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

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

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

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

Синтаксис

arcpy.un.AddTraceLocations(in_utility_network, out_feature_class, {load_selected_features}, {clear_trace_locations}, {trace_locations}, filter_barrier)
ParameterОбъяснениеТип данных
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 - глобальный 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: Да

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