Оптимальный путь как линия (Инструменты Spatial Analyst)

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

Вычисляет оптимальный путь от источника к назначению в виде линии.

Более подробно о соединении местоположений оптимальными путями

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

Инструмент Оптимальный путь как линия создает выходной полилинейный объект, который является оптимальным путем от источника к месту назначения.
Когда входные данные объектов назначений (адресатов) представлены растром, набор ячеек адресатов состоит из всех ячеек значения параметра Входные растровые или векторные данные адресата, которые имеют действительные значения. Ячейки, имеющие значение NoData, не включаются в набор источников. 0 – является допустимым значением. Растр объектов назначения можно создать с помощью инструментов извлечения.
При использовании данных полигонального объекта в качестве входных назначений объекта следует особенно тщательно выбирать способ обработки размера выходной ячейки, если его можно охарактеризовать как грубый относительно подробных сведений во входных данных. Применяется внутренний процесс растеризации с помощью инструмента Полигон в Растр, с настройкой по умолчанию для Метода присвоения значений ячейкам Центра ячейки. Это означает, что данные, не расположенные по центру ячейки, не будут включены в промежуточные растеризованные выходные данные назначения, поэтому не будут представлены в расчётах расстояния. Так, если назначением является ряд небольших полигонов, например периметры знаний, которые невелики относительно размеру выходной ячейки, возможно, что только некоторые из них попадут по центру выходных растровых ячеек, и, видимо, большинство остальных объекты будут потеряны в анализе.

Во избежание такой ситуации в качестве промежуточного шага можно напрямую растеризовать входные объекты с помощью инструмента Объект в растр и задать параметр Поле. Затем используйте полученные выходные данные в качестве входных для того инструмента расстояний, который вам требуется. Кроме того, можно выбрать небольшой размер ячейки, чтобы получить достаточный объем данных из входных объектов.
Перед созданием оптимального пути обычно используется один из следующих инструментов для создания растра накопления расстояния и растра обратного направления: Накопление расстояния или Распределение по расстоянию. Для построения оптимального пути необходимы входные данные: растр накопления расстояния и растр обратного направления.
Оптимальный созданный путь может быть путем потока, основанным на направлении потока D8. Чтобы создать оптимальный путь таким образом, укажите растр направления потока D8 в качестве входного растра для Входного растра обратного направления или направления стока. Также нужно указать Входной растр накопленного расстояния. Если параметр Создать сетевые пути не активирован, для задания пути Входной растр накопленного расстояния не используется. Поэтому при использовании как константного растра, так и цифровой модели рельефа (ЦМР) путь будет одинаковым; меняется только атрибутивное значение в вашем пути. Однако если параметр Создать сетевые пути включен, Входной растр накопленного расстояния должен быть Выходным растром суммарного стока. См. документацию инструмента Направление стока для получения дополнительных сведений о растрах направления потока D8 и документацию инструмента Суммарный сток для создания соответствующего растра.
Выходной полилинейный объект включает поле DestID и поле PathCost. Поле DestID определяет пункт назначения, куда ведет каждая линия. В поле PathCost отображается общая совокупная стоимость каждого пути. Если выходные данные записываются в файловую базу геоданных, в них содержится поле shape_length, где хранится общая длина пути с наименьшей стоимостью.
Для создания путей, пересекающих границу проекции, растры, используемые в качестве входных для параметров Входной Растр Накопления Расстояния и Входной Растр Обратного Направления, должны быть созданы в полном глобальном экстенте либо в цилиндрической проекции, либо в географической выходной системе координат с опцией Геодезический для параметра Метод определения расстояния.
Для создания правильных оптимальных путей игнорируются параметры среды Размер ячейки, Растр привязки, и Экстент. Для создания правильных оптимальных путей игнорируются параметры среды Размер ячейки, Растр привязки, and Экстент. При обработке используются размер ячейки, источник и экстент входных растров обратного направления или направления стока.
Если задан параметр среды Выходная система координат, он применяется во время последующей обработки, чтобы результаты не ухудшались.
См. раздел Параметры среды анализа и Spatial Analyst для получения дополнительной информации о параметрах среды геообработки, применимых к этому инструменту.

Подпись	Объяснение	Тип данных
Входные растровые или векторные объекты назначений	Целочисленный растр или объект (точка, линия или полигон), определяющий местоположения, от которых будет определяться оптимальный путь до источника с наименьшей стоимостью. Если входные данные являются растром, они должны состоять из ячеек с корректными значениями для назначений, а остальным ячейкам должно быть присвоено значение NoData. 0 – является допустимым значением.	Raster Layer; Feature Layer
Входной растр накопленного расстояния	Растр накопления расстояний, который будет использоваться для определения оптимального пути от источников до пунктов назначения. Растр накопления расстояний обычно создаётся с помощью инструментов Накопление расстояния или Распределение по расстоянию. Каждая ячейка в растре накопления расстояния представляет минимальное суммарное стоимостное расстояние по поверхности от каждой ячейки до набора исходных ячеек.	Raster Layer
Входной растр обратного направления или направления стока	Растр обратного направления содержит рассчитанные направления в градусах. Направление определяет следующую ячейку по оптимальному пути до источника с наименьшей накопленной стоимостью, избегая барьеры. Диапазон значений - от 0 до 360 градусов, где значение 0 резервируется для ячеек источников. Направление на восток равно 90 градусам; значения увеличиваются по часовой стрелке (180 - на юг; 270 - на запад; и 360 на север).	Raster Layer
Выходные данные Оптимальный путь как линия	Выходной класс пространственных объектов, который является оптимальным путем или путями.	Feature Class
Поле назначения (Дополнительный)	Целочисленное поле, которое будет использоваться для получения значений для местоположений назначения.	Field
Тип пути (Дополнительный)	Указывает ключевое слово, определяющее то, как в вычислениях оптимального пути будут интерпретированы значения и зоны во входных данных объектов назначения. Каждая зона–В выходном растре определяется и сохраняется маршрут с наименьшей стоимостью перемещения для каждой зоны входных данных объектов назначения. С этой опцией путь с наименьшей стоимостью для каждой зоны начинается в ячейке с наименьшим весом стоимостного расстояния в зоне. Один наилучший–Для всех ячеек на входных данных адресатов путь с наименьшей стоимостью перемещения вычисляется из ячейки, лежащей на маршруте с наименьшей стоимостью перемещения до ячеек источников и имеющей минимальное значение стоимости. Каждая ячейка–На выходном растре определяется и сохраняется маршрут с наименьшей стоимостью перемещения для каждой ячейки, имеющей действительные значения на входных данных объектов назначения. С этой опцией каждая ячейка во входных данных назначения рассматривается по отдельности, и путь с наименьшей стоимостью определяется для каждой ячейки.	String
Создать сетевые пути (Дополнительный)	Указывает, вычисляются ли полные, возможно, перекрывающиеся, пути от пунктов назначения к источникам, либо создаются неперекрывающиеся сетевые пути. Отмечено–Вычисляются неперекрывающиеся сетевые пути. Не отмечено–Вычисляются полные пути от назначений к источникам, которые могут быть перекрывающимися. Используется по умолчанию.	Boolean

OptimalPathAsLine(in_destination_data, in_distance_accumulation_raster, in_back_direction_raster, out_polyline_features, {destination_field}, {path_type}, {create_network_paths})

Имя	Объяснение	Тип данных
in_destination_data	Целочисленный растр или объект (точка, линия или полигон), определяющий местоположения, от которых будет определяться оптимальный путь до источника с наименьшей стоимостью. Если входные данные являются растром, они должны состоять из ячеек с корректными значениями для назначений, а остальным ячейкам должно быть присвоено значение NoData. 0 – является допустимым значением.	Raster Layer; Feature Layer
in_distance_accumulation_raster	Растр накопления расстояний, который будет использоваться для определения оптимального пути от источников до пунктов назначения. Растр накопления расстояний обычно создаётся с помощью инструментов Накопление расстояния или Распределение по расстоянию. Каждая ячейка в растре накопления расстояния представляет минимальное суммарное стоимостное расстояние по поверхности от каждой ячейки до набора исходных ячеек.	Raster Layer
in_back_direction_raster	Растр обратного направления содержит рассчитанные направления в градусах. Направление определяет следующую ячейку по оптимальному пути до источника с наименьшей накопленной стоимостью, избегая барьеры. Диапазон значений - от 0 до 360 градусов, где значение 0 резервируется для ячеек источников. Направление на восток равно 90 градусам; значения увеличиваются по часовой стрелке (180 - на юг; 270 - на запад; и 360 на север).	Raster Layer
out_polyline_features	Выходной класс пространственных объектов, который является оптимальным путем или путями.	Feature Class
destination_field (Дополнительный)	Целочисленное поле, которое будет использоваться для получения значений для местоположений назначения.	Field
path_type (Дополнительный)	Указывает ключевое слово, определяющее то, как в вычислениях оптимального пути будут интерпретированы значения и зоны во входных данных объектов назначения. `EACH_ZONE`–В выходном растре определяется и сохраняется маршрут с наименьшей стоимостью перемещения для каждой зоны входных данных объектов назначения. С этой опцией путь с наименьшей стоимостью для каждой зоны начинается в ячейке с наименьшим весом стоимостного расстояния в зоне. `BEST_SINGLE`–Для всех ячеек на входных данных адресатов путь с наименьшей стоимостью перемещения вычисляется из ячейки, лежащей на маршруте с наименьшей стоимостью перемещения до ячеек источников и имеющей минимальное значение стоимости. `EACH_CELL`–На выходном растре определяется и сохраняется маршрут с наименьшей стоимостью перемещения для каждой ячейки, имеющей действительные значения на входных данных объектов назначения. С этой опцией каждая ячейка во входных данных назначения рассматривается по отдельности, и путь с наименьшей стоимостью определяется для каждой ячейки.	String
create_network_paths (Дополнительный)	Указывает, вычисляются ли полные, возможно, перекрывающиеся, пути от пунктов назначения к источникам, либо создаются неперекрывающиеся сетевые пути. `NETWORK_PATHS`–Вычисляются неперекрывающиеся сетевые пути. `DESTINATIONS_TO_SOURCES`–Вычисляются полные пути от назначений к источникам, которые могут быть перекрывающимися. Используется по умолчанию.	Boolean

Пример кода

OptimalPathAsLine пример 1 (окно Python)

Пример скрипта окна Python для использования функции.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
OptimalPathAsLine("observers.shp", "distaccum.tif", "backdir.tif",
                  "c:/sapyexamples/output/outOptimalPath01.shp")

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

Вычисляет путь с наименьшей стоимостью от источника до назначения.

# Name: OptimalPathAsLine_Ex_02.py
# Description: Calculates the least-cost path from a source to
#              a destination.
# Requirements: Spatial Analyst extension

# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *

# Set environment settings
env.workspace = "C:/sapyexamples/data"

# Set local variables
inDestination = "observers.shp"
inDistAccum = "accumraster.tif"
inBackDir = "backdir2.tif"
outPathFeat = "c:/sapyexamples/output.gdb/optimalfeaturepaths02"
destField = "FID"
method = "EACH_CELL"

# Run
OptimalPathAsLine(inDestination, inDistAccum, inBackDir,
                  outPathFeat, destField, method)

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

Автоподтверждение, Текущая рабочая область, Выходное Z-значение по умолчанию, Географические преобразования, Разрешение M, Допуск M, Выходное ключевое слово конфигурации, Выходная система координат, Наличие выходных значений M, Выходные данные содержат Z значения, Выходной M домен, Выходной XY домен, Выходной Z домен, Временная рабочая область, Разрешение XY, Допуск XY, Разрешение Z, Допуск Z

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