Трассировать геометрическую сеть

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

Рассчитывает указанную задачу слоя сетевого анализа на основе флагов, барьеров и заданных свойств веса.

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

• Этот инструмент нельзя использовать для наборов сетевых данных (сети, используемые в дополнительном модуле ArcGIS Network Analyst).

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

• В результате применения этого инструмента создается составной слой, который содержит один слой для каждого класса пространственных объектов, включенных во входную геометрическую сеть. Все объекты, возвращаемые в результате трассировки, выделяются в соответствующем слое. Если на карте присутствуют входные слои, выходной составной слой может содержать слои без выделения, то есть пустые слои, в которых трассировка не выявила каких-либо объектов. В ModelBuilder вы можете использовать инструмент Выбрать данные (Select Data) для извлечения конкретных слоев из составного слоя, также вы можете использовать инструмент Создать векторный слой (Make_Feature_Layer) для создания векторного слоя на основе результатов, полученных при использовании инструмента Выбрать данные (Select Data). Используйте инструмент Посчитать строки (Get_Count), чтобы определить, имеются ли в составном слое пустые слои. Эту функцию рекомендуется использовать при публикации модели на ArcGIS for Server, поскольку составные слои не могут быть заданы в качестве типа выходного параметра задачи геообработки. Так как они не могут быть представлены непосредственно в качестве результата, необходимо использовать инструмент Выбрать данные (Select Data), чтобы создать отдельный (не составной) слой для вывода в качестве результата.

• Этот инструмент недоступен для запуска во время редактирования геометрической сети в персональной базе геоданных.

• В отличие от других наборов данных (например, топология или наборы сетевых данных), геометрические сети не содержат связанного слоя. Таким образом, при использовании этого инструмента в ArcMap геометрическую сеть необходимо выбрать на диске. Выбор геометрической сети в качестве входных данных в раскрывающемся списке слоя невозможен.

Синтаксис

TraceGeometricNetwork_management (in_geometric_network, out_network_layer, in_flags, in_trace_task_type, {in_barriers}, {in_junction_weight}, {in_edge_along_digitized_weight}, {in_edge_against_digitized_weight}, {in_disable_from_trace}, {in_trace_ends}, {in_trace_indeterminate_flow}, {in_junction_weight_filter}, {in_junction_weight_range}, {in_junction_weight_range_not}, {in_edge_along_digitized_weight_filter}, {in_edge_against_digitized_weight_filter}, {in_edge_weight_range}, {in_edge_weight_range_not})

Параметр	Объяснение	Тип данных
in_geometric_network	Геометрическая сеть, для которой выполняется трассировка.	Geometric Network
out_network_layer	Имя составного слоя, в котором будут храниться результаты трассировки в виде выделенного набора.	Group Layer
in_flags	Точечные объекты, представляющий набор флагов, который выступает в качестве начальной точки для операции трассировки. Например, если вы хотите провести трассировку вверх по течению, вы используете флаг, чтобы указать точку, с которой нужно начать трассировку. Флаги можно поместить в любой точке вдоль ребер или соединений, однако при наличии в какой-либо точке одновременно соединений и ребер, соединения будут обрабатываться в первую очередь.	Feature Layer
in_trace_task_type	Задача трассировки, которая будет выполнена по определенной геометрической сети. FIND_COMMON_ANCESTORS — Выполняется поиск общих объектов, которые представляют собой поток набора точек в сети, направленный вверх. Необходимо задать направление потока для геометрической сети. FIND_CONNECTED —Выполняет поиск объектов, которые соединены с указанной точкой в сети. FIND_LOOPS — Выполняется поиск петель в сети, которые фиксируются путем определения объектов, которые замыкаются на себя (то есть не могут быть доступны более, чем из одного направления), для каждого соединенного объекта, на котором установлен флаг. FIND_DISCONNECTED — Выполняется поиск всех объектов, которые не соединены с указанной точкой в сети. FIND_PATH_UPSTREAM — Выполняет поиск пути вверх по течению от указанной точки сети. Найденный путь может быть одним из нескольких путей; это зависит от того, содержит сеть петли или нет. Флаги, которые добавляются в сеть, могут быть смешанными: флаги на ребрах и флаги в соединениях. Необходимо определить вес для задания направления трассировки и потока в геометрической сети. Если вес не задан, кратчайший путь определяется наименьшим числом объектов между двумя точками. FIND_PATH — Выполняется поиск пути между двумя или более флагами в сети. Найденный путь может быть одним из нескольких путей между флагами; это зависит от того, содержит сеть циклы или нет. Флаги, которые добавляются в сеть, должны быть либо флагами только на ребрах, либо флагами только в соединениях. Если вес не задан, кратчайший путь определяется наименьшим числом объектов между двумя точками. TRACE_DOWNSTREAM —Выполняется поиск всех сетевых объектов, которые лежат ниже указанной точки по течению (в направлении по течению). Необходимо задать направление потока для геометрической сети. FIND_UPSTREAM_ACCUMULATION — Определяется общая стоимость всех сетевых объектов, которые лежат выше заданной точки по течению. Необходимо определить вес для задания направления трассировки и потока в геометрической сети. TRACE_UPSTREAM — Выполняется поиск всех сетевых объектов, которые лежат выше указанной точки по течению (в направлении против течения). Необходимо задать направление потока для геометрической сети.	String
in_barriers (Дополнительный)	Точечные объекты, представляющие набор барьеров. Барьеры определяют места в сети, трассировка через которые не проходит. Если вы хотите трассировать только часть вашей сети, вы можете изолировать ее с помощью барьеров. Барьеры можно поместить в любой точке вдоль ребер или соединений, однако, при наличии в какой-либо точке одновременно соединений и ребер, соединения будут обрабатываться в первую очередь. Функция будет обрабатываться как неактивная и не будет учитываться при трассировке, если вы не задали значение in_trace_ends параметра TRACE_ENDS для целенаправленного поиска объектов, блокирующих трассировку.	Feature Layer
in_junction_weight (Дополнительный)	Вес соединения, используемый как стоимость перемещения через любое соединение. Вес должен быть заранее определен для данной геометрической сети. Этот параметр отключен или игнорируется в том случае, когда задан один или несколько не зависящих от стоимости типов задач трассировки: FIND_COMMON_ANCESTORS FIND_CONNECTED FIND_LOOPS FIND_DISCONNECTED TRACE_DOWNSTREAM TRACE_UPSTREAM	String
in_edge_along_digitized_weight (Дополнительный)	Вес ребра, используемый как стоимость перемещения через ребро по направлению оцифровки такого ребра. Вес должен быть заранее определен для данной геометрической сети. Этот параметр отключен или игнорируется в том случае, когда задан один или несколько не зависящих от стоимости типов задач трассировки: FIND_COMMON_ANCESTORS FIND_CONNECTED FIND_LOOPS FIND_DISCONNECTED TRACE_DOWNSTREAM TRACE_UPSTREAM	String
in_edge_against_digitized_weight (Дополнительный)	Вес ребра, используемый как стоимость перемещения через ребро против направления оцифровки такого ребра. Вес должен быть заранее определен для данной геометрической сети. Этот параметр отключен или игнорируется в том случае, когда задан один или несколько не зависящих от стоимости типов задач трассировки: FIND_COMMON_ANCESTORS FIND_CONNECTED FIND_LOOPS FIND_DISCONNECTED TRACE_DOWNSTREAM TRACE_UPSTREAM	String
in_disable_from_trace [in_disable_from_trace,...] (Дополнительный)	Список классов пространственных объектов, участие которых в трассировке заблокировано. После настройки отключения класса пространственных объектов операция трассировки обрабатывает все объекты в таком классе пространственных объектов как отключенные или содержащие барьер. Этот параметр рекомендуется использовать для исключения всего класса пространственных объектов из рассмотрения в процессе трассировки. Например, отключив слой распределителей в электросети, задав параметру in_trace_ends значение TRACE_ENDS и выполнив трассировку от заданной точки, вы можете найти распределители, которые необходимо изолировать в сети, и это будут объекты, в которых операция трассировки была остановлена.	String
in_trace_ends (Дополнительный)	Указывает, содержит ли трассировка все объекты или только объекты, блокирующие трассировку. Этот параметр рекомендуется использовать в том случае, когда требуется определить объекты, блокирующие трассировку. Чтобы объекты возвращались из операции трассировки при помощи этого параметра, они должны быть включены в одну из следующих категорий: объект соединен только с одним из объектов геометрической сети ("тупик"). Объект выключен (включая объекты в отключенных классах пространственных объектов). Объект содержит размещенные на нем барьеры. TRACE_ENDS —Включение объектов, блокирующих трассировку. NO_TRACE_ENDS —Включение всех объектов. Это значение используется по умолчанию.	Boolean
in_trace_indeterminate_flow (Дополнительный)	Указывает, содержит ли трассировка все объекты или только объекты, блокирующие трассировку. TRACE_INDETERMINATE_FLOW —Выполнение трассировки объектов с неопределенным или неинициализированным направлением потока. NO_TRACE_INDETERMINATE_FLOW —Трассировка объектов с неопределенным или неинициализированным направлением потока не выполняется. Это значение используется по умолчанию. Учитывается только при задании хотя бы одного типа задачи трассировки, зависимой от потока: FIND_PATH_UPSTREAM TRACE_DOWNSTREAM FIND_UPSTREAM_ACCUMULATION TRACE_UPSTREAM	Boolean
in_junction_weight_filter (Дополнительный)	Вес, который будет использоваться для создания весовой фильтр соединения, который применяется для фильтрации объектов соединения при трассировке.	String
in_junction_weight_range (Дополнительный)	Задает допустимые или недопустимые диапазоны значений веса для сетевых объектов, подлежащих трассировке. Отключен, если задан не зависящий от стоимости тип задач трассировки. для создания весового фильтра необходимо указать допустимые диапазоны веса для объектов. Весовой фильтр может состоять из нескольких диапазонов. При настройке нескольких диапазонов веса, разделите диапазоны запятыми. Большие и меньшие значения в диапазоне разделяются тире. Диапазоны, состоящие из одного значения, не содержат дефиса и разделяются запятыми, например, 0-2,3,6,7-10.	String
in_junction_weight_range_not (Дополнительный)	Применяет логический оператор NOT к заданным диапазонам веса соединения. По умолчанию заданные диапазоны веса соединения определяют объекты соединения, которые могут быть трассированы. Отметив эту опцию, вы тем самым указываете, что объекты соединения, содержащие значения веса в заданных диапазонах, не подлежат трассировке. AS_IS —Диапазоны весов определяют объекты, которые могут быть трассированы. Это значение используется по умолчанию. NOT —Диапазоны весов определяют объекты, которые не могут быть трассированы.	Boolean
in_edge_along_digitized_weight_filter (Дополнительный)	Вес, который будет использоваться для создания весового фильтра по направлению ребра, который применяется для фильтрации объектов ребер при трассировке.	String
in_edge_against_digitized_weight_filter (Дополнительный)	Вес, который будет использоваться для создания весового фильтра против направления ребра, который применяется для фильтрации объектов ребер при трассировке.	String
in_edge_weight_range (Дополнительный)	Задает допустимые или недопустимые диапазоны значений веса для сетевых объектов, подлежащих трассировке. Отключен, если задан не зависящий от стоимости тип задач трассировки. для создания весового фильтра необходимо указать допустимые диапазоны веса для объектов. Весовой фильтр может состоять из нескольких диапазонов. При настройке нескольких диапазонов веса необходимо разделять диапазоны запятыми. Большие и меньшие значения в диапазоне разделяются тире. Диапазоны, состоящие из одного значения, не содержат дефиса и разделяются запятыми, например, 0-2,3,6,7-10.	String
in_edge_weight_range_not (Дополнительный)	Применяет логический оператор NOT к заданным диапазонам весов ребер. По умолчанию заданные диапазоны весов ребер определяют объекты-ребра, которые могут быть трассированы. Отметив эту опцию, вы тем самым указываете, что объекты-ребра, содержащие значения веса в заданных диапазонах, не подлежат трассировке. AS_IS —Диапазоны весов определяют объекты, которые могут быть трассированы. Это значение используется по умолчанию. NOT —Диапазоны весов определяют объекты, которые не могут быть трассированы.	Boolean

Пример кода

TraceGeometricNetwork, пример 1 (автономный скрипт)

Представленный автономный скрипт Python демонстрирует порядок использования функции TraceGeometricNetwork в скрипте Python для выполнения задачи трассировки Найти соединенные объекты в геометрической сети, содержащей флаги и не содержащей барьеры.

# Import arcpy module
import arcpy

# Local variables:
gnVersionFDS_Net = "C:/GeometricNetworks/GeometricNetwork.gdb/gnVersionFDS_with_GN/gnVersionFDS_1_Net"
Flags = "C:/GeometricNetworks/GeometricNetwork.gdb/gnVersionFDS_with_GN/Flags"
gnVersionFDS_1 = "gnVersionFDS_1_Net"

# Process: Trace Geometric Network
arcpy.TraceGeometricNetwork_management(gnVersionFDS_Net, gnVersionFDS_1, Flags, "FIND_CONNECTED", "", "", "", "", "", "NO_TRACE_ENDS", "", "", "", "AS_IS", "", "", "", "AS_IS")

TraceGeometricNetwork, пример 2 (автономный скрипт)

Пример автономного скрипта Python для использования функции TraceGeometricNetwork при выполнении задачи трассировки Найти путь в геометрической сети, содержащей флаги, не содержащей барьеры, содержащей вес с именем Fiction_Factor и весовой фильтр с диапазоном от 1 до 10.

# Import arcpy module
import arcpy

# Local variables:
Water_Net = "C:/GeometricNetworks/Montgomery.gdb/Water/Water_Net"
Flags = "C:/GeometricNetworks/Montgomery.gdb/Water/Flags"
Water_Net_2 = "Water_Net"

# Process: Trace Geometric Network
arcpy.TraceGeometricNetwork_management(Water_Net, Water_Net_2, Flags, "FIND_PATH", "", "", "Friction_Factor", "Friction_Factor", "", "NO_TRACE_ENDS", "", "", "", "AS_IS", "Friction_Factor", "Friction_Factor", "1-10", "AS_IS")

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

Этот инструмент не использует параметры среды геообработки

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

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