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

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

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

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

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

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

Параметры

Диалог

Подпись	Описание	Тип данных
Входная инженерная сеть	Входная инженерная сеть, куда будут добавлены местоположения трассировки.	Utility Network; Utility Network Layer
Выходной класс объектов	Выходной класс пространственных объектов, содержащий местоположения трассировки. Если вы задаете имя нового класса объектов, будет создан новый выходной класс объектов. Примечание: При работе с utility network версии 7 или более поздней выходной класс пространственных объектов должен быть создан в мобильной, файловой или многопользовательской базе геоданных Если вы хотите использовать имеющийся класс, созданный этим инструментом ранее, и присоединить к нему местоположения или перезаписать их, укажите имя имеющегося класса.	Feature Class
Загрузка выбранных объектов (Дополнительный)	Указывает, будут ли выбранные объекты загружены в активную карту как местоположения трассировки. Отмечено - загружает местоположения трассировки на основе выборки на карте. Не отмечено - не загружает местоположения трассировки на основе выборки на карте. Это значение по умолчанию Тем не менее местоположения трассировки можно загрузить с помощью параметра Местоположения трассировки.	Boolean
Очистить местоположения трассировки (Дополнительный)	Определяет, будут ли существующие местоположения трассировки очищены из выходного класса объектов. Отмечено — существующие местоположения трассировки будут очищены. Не отмечено — существующие местоположения трассировки будут сохранены и не очищены. Это значение по умолчанию	Boolean
Местоположения трассировки (Дополнительный)	Местоположения трассировки будут добавлены к выходному классу объектов. Если вы не используете параметр Загрузка выбранных объектов в активной карте, можно применить этот параметр, чтобы задать объекты инженерной сети, добавляющиеся в качестве местоположений трассировки, указав требующиеся значения в таблице значений. Имеются следующие свойства местоположений трассировки: Имя слоя - слой, участвующий в инженерной сети, который содержит добавляемые местоположения начальных точек и барьеров. Если имеется активная карта, допускается выбор слоев только с карты. Глобальный ID - Глобальный идентификатор объекта слоя для добавляемого местоположения. ID терминала - ID терминала объекта слоя для добавляемого местоположения. Процент вдоль - процент вдоль значений объекта. Для линейных объектов по умолчанию используется 0.5.	Value Table
Барьер фильтра	Определяет, будут ли барьеры для местоположений трассировки действовать как барьеры фильтра. Отмечено - барьеры будут действовать как барьеры фильтра. Удобно для трассировок подсетей, когда барьеры позволяют сначала оценить подсеть и применяются при втором проходе объектов сети. Не отмечено - барьеры не будут вести себя как барьеры фильтра; они будут вести себя как барьеры проходимости, которые определяют экстент подсетей и применяются при первом проходе. Это значение по умолчанию Примечание: Для этого параметра требуется ArcGIS Enterprise 10.8.1 или более новая версия.	Boolean

Python

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	Выходной класс пространственных объектов, содержащий местоположения трассировки. Если вы задаете имя нового класса объектов, будет создан новый выходной класс объектов. Примечание: При работе с utility network версии 7 или более поздней выходной класс пространственных объектов должен быть создан в мобильной, файловой или многопользовательской базе геоданных Если вы хотите использовать имеющийся класс, созданный этим инструментом ранее, и присоединить к нему местоположения или перезаписать их, укажите имя имеющегося класса.	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 - глобальный идентификатор объекта для добавляемого местоположения. 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.un.AddTraceLocations("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.un.AddTraceLocations(r"http://landbase.mydomain.com/server/rest/services/NapervilleElectric/FeatureServer/9", 
                           r"C:\Project\MyUNProject.gdb\TraceLocations",
                           "DO_NOT_LOAD_SELECTED_FEATURES",
                           "KEEP_LOCATIONS",
                           "'Circuit Breaker' {DDB0765D-860A-4054-908D-9360E1A32F74} '(3/Load)' #";"'ElecDist Line' {67C0534B-A80D-4E5F-8926-5FB5F887A5F2} # 0.25","TRAVERSABILITY_BARRIER")

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

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

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

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