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

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

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

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

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

Параметры

Подпись	Описание	Тип данных
Входная инженерная сеть	Входная инженерная сеть, куда будут добавлены местоположения трассировки.	Utility Network; Utility Network Layer
Выходной класс пространственных объектов	Выходной класс пространственных объектов, содержащий местоположения трассировки. Если вы указываете имя нового класса объектов, будет создан новый выходной класс объектов. Если вы хотите использовать имеющийся класс, созданный этим инструментом ранее, и присоединить к нему местоположения или перезаписать их, укажите имя имеющегося класса.	Feature Class
Загрузка выбранных объектов (Дополнительный)	Указывает, будут ли выбранные объекты загружены в активную карту как местоположения трассировки. Отмечено - загружает местоположения трассировки на основе выборки на карте. Не отмечено - не загружает местоположения трассировки на основе выборки на карте. Используется по умолчанию. Тем не менее местоположения трассировки можно загрузить с помощью параметра Местоположения трассировки.	Boolean
Очистить местоположения трассировки (Дополнительный)	Определяет, будут ли местоположения трассировки очищены из выходного класса объектов. Отмечено — существующие местоположения трассировки будут очищены. Не отмечено —существующие местоположения трассировки будут сохранены и не очищены. Это значение по умолчанию.	Boolean
Местоположения трассировки (Дополнительный)	Местоположения трассировки будут добавлены к выходному классу объектов. Если вы не используете параметр Загрузка выбранных объектов в активной карте, можно применить этот параметр, чтобы задать объекты инженерной сети, добавляющиеся в качестве местоположений трассировки, указав требующиеся значения в таблице значений. Имеются следующие свойства местоположений трассировки: Имя слоя - слой, участвующий в инженерной сети, который содержит добавляемые местоположения начальных точек и барьеров. Если имеется активная карта, допускается выбор слоев только с карты. Глобальный ID - глобальный ID добавляемого объекта слоя. ID терминала - ID терминала добавляемого объекта слоя. Процент вдоль - процент вдоль значений объекта. Для линейных объектов по умолчанию используется 0.5.	Value Table
Барьер фильтра	Задает поведение барьеров для местоположений трассировки. Отмечено - барьеры ведут себя как барьеры фильтров. Удобно для трассировок подсетей, когда барьеры позволяют сначала оценивать подсеть, а затем применяются при следующем проходе объектов сети, действуя как барьеры фильтров. Не отмечено - барьеры ведут себя как барьеры проходимости. Барьеры проходимости задают экстент подсетей и оцениваются при первом проходе. Это значение по умолчанию. Примечание: Для этого параметра требуется ArcGIS Enterprise 10.9 или более новая версия.	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 - глобальный ID добавляемого объекта слоя. Terminal ID - ID терминала добавляемого объекта слоя. Percent Along - процент вдоль значений объекта. Для линейных объектов по умолчанию используется 0.5.	Value Table
filter_barrier	Задает поведение барьеров для местоположений трассировки. Более подробно о барьерах FILTER_BARRIER—Барьеры ведут себя как барьеры фильтров. Удобно для трассировок подсетей, когда барьеры позволяют сначала оценивать подсеть, а затем применяются при следующем проходе объектов сети, действуя как барьеры фильтров. TRAVERSABILITY_BARRIER—Барьеры ведут себя как барьеры проходимости. Барьеры проходимости задают экстент подсетей и оцениваются при первом проходе. Это значение по умолчанию. Примечание: Для этого параметра требуется ArcGIS Enterprise 10.9 или более новая версия.	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)' '' )

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

Текущая рабочая область, Выходные данные имеют Z-значения

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

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

Параметры

Примечание:

Примечание:

Пример кода

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

Особые случаи

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

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

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