Создает класс объектов, используемый в качестве входных данных начальных точек, конечных точек и барьеров для инструмента Трассировка.
Использование
Выходной класс объектов будет иметь такую же схему, как и входные начальные точки, остановочные точки и барьеры, необходимые для работы инструмента Трассировка. Это позволяет указывать другие местоположения трассировки при операциях трассировки в ModelBuilder или Python.
Вы не можете одновременно задать значения для параметров Загрузка выбранных объектов и Отслеживание местоположения — они взаимно исключающие.
Входная инженерная сеть, куда будут добавлены местоположения трассировки.
Важно:
Когда инженерная сеть, указанная для параметра Входная инженерная сеть, содержит специализированную сеть телекоммуникаций, выходные местоположения трассировки включают три дополнительных поля: FIRSTUNIT, LASTUNIT и COLORSCHEME. Эти поля должны быть вручную изменены в выходном классе объектов, чтобы указать идентификаторы единиц в сгруппированных объектах, к которым относится местоположение трассировки.
Utility Network; Utility Network Layer
Выходной класс пространственных объектов
Выходной класс пространственных объектов, содержащий местоположения трассировки.
Если вы задаете имя нового класса объектов, будет создан новый выходной класс объектов. Вы можете указать имя существующего класса объектов и выбрать добавление к любым существующим местоположениям трассировки в классе объектов или перезаписать их, используя параметр Очистить местоположения трассировки.
Примечание:
При работе с версией инженерной сети 7 или более поздней выходной класс пространственных объектов должен быть создан в мобильной, файловой или многопользовательской базе геоданных
Feature Class
Загрузка выбранных объектов
(Дополнительный)
Указывает, будут ли выбранные объекты загружены в активную карту как местоположения трассировки.
Отмечено–Загружает местоположения трассировки на основе выборки на карте.
Не отмечено–Не загружает местоположения трассировки на основе выборки на карте. Используется по умолчанию. Тем не менее местоположения трассировки можно загрузить с помощью параметра Местоположения трассировки.
Boolean
Очистить местоположения трассировки
(Дополнительный)
Определяет, будут ли существующие местоположения трассировки очищены из выходного класса объектов.
Отмечено–Существующие местоположения трассировки будут очищены.
Не отмечено–Существующие местоположения трассировки не будут очищены, они будут сохранены и присоединены. Используется по умолчанию.
Boolean
Местоположения трассировки
(Дополнительный)
Местоположения трассировки будут добавлены к выходному классу объектов. Если вы не используете параметр Загрузка выбранных объектов в активной карте, можно применить этот параметр, чтобы задать объекты инженерной сети, добавляющиеся в качестве местоположений трассировки, указав требующиеся значения в таблице значений.
Столбцы таблицы значений:
Layer Name–The layer that contains the locations to add.
Global ID–The Global ID of the feature for the location to add.
Terminal–The terminal ID of the feature for the location to add.
Percent Along–The percent along value of the feature. For lines and edge objects, the default value is 0.5.
Value Table
Барьер фильтра
Определяет, будут ли местоположения трассировки действовать как фильтры барьеров при использовании в качестве барьеров.
Отмечено–Барьеры будут действовать как барьеры фильтра. Удобно для трассировок подсетей, когда барьеры позволяют сначала оценить подсеть и применяются при втором проходе объектов сети.
Не отмечено–Барьеры будут вести себя как барьеры проходимости, которые определяют экстент подсетей и применяются при первом проходе. Используется по умолчанию.
Входная инженерная сеть, куда будут добавлены местоположения трассировки.
Важно:
Когда инженерная сеть, указанная для параметра in_utility_network, содержит специализированную сеть телекоммуникаций, выходные местоположения трассировки включают три дополнительных поля: FIRSTUNIT, LASTUNIT и COLORSCHEME. Эти поля должны быть вручную изменены в выходном классе объектов, чтобы указать идентификаторы единиц в сгруппированных объектах, к которым относится местоположение трассировки.
Utility Network; Utility Network Layer
out_feature_class
Выходной класс пространственных объектов, содержащий местоположения трассировки. Если вы задаете имя нового класса объектов, будет создан новый выходной класс объектов. Вы можете указать имя существующего класса объектов и выбрать добавление к любым существующим местоположениям трассировки в классе объектов или перезаписать их, используя параметр clear_trace_locations.
Примечание:
При работе с версией инженерной сети 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–The layer that contains the locations to add.
Global ID–The Global ID of the feature for the location to add.
Terminal–The terminal ID of the feature for the location to add.
Percent Along–The percent along value of the feature. For lines and edge objects, the default value is 0.5.
Value Table
filter_barrier
Определяет, будут ли местоположения трассировки действовать как фильтры барьеров при использовании в качестве барьеров.
FILTER_BARRIER–Барьеры будут действовать как барьеры фильтра. Удобно для трассировок подсетей, когда барьеры позволяют сначала оценить подсеть и применяются при втором проходе объектов сети.
TRAVERSABILITY_BARRIER–Барьеры будут вести себя как барьеры проходимости, которые определяют экстент подсетей и применяются при первом проходе. Используется по умолчанию.
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")