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

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

Вычисляет маршрут с наименьшей стоимостью перемещения от исходного объекта до объекта назначения.

Прежние версии:

Этот инструмент является устаревшим и будет удален в будущих версиях.

Инструмент [Оптимальный путь как линия] (optimal-path-as-line.yml)предоставляет улучшенную функциональность или производительность.

Более подробно о создании пути с наименьшей стоимостью

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

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

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

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

CostPathAsPolyline(in_destination_data, in_cost_distance_raster, in_cost_backlink_raster, out_polyline_features, {path_type}, {destination_field}, {force_flow_direction_convention})

Имя	Объяснение	Тип данных
in_destination_data	Растр или набор пространственных данных, определяющие ячейки, из которых вычисляется путь с наименьшей стоимостью перемещения до источника, расположенного ближе всего по стоимости перемещения. Если входные данные являются растром, они должны состоять из ячеек с корректными значениями для назначений, а остальным ячейкам должно быть присвоено значение NoData. 0 – является допустимым значением.	Raster Layer; Feature Layer
in_cost_distance_raster	Растр стоимостного расстояния, используемый для определения маршрута с наименьшей стоимостью из источников к назначениям. Растр стоимостного расстояния обычно создается с помощью инструментов Стоимостное расстояние, Распределение по стоимостному расстоянию или Стоимостное направление. Растр стоимостного расстояния хранит для каждой ячейки расстояние с минимальной совокупной стоимостью перемещения по поверхности стоимости из каждой ячейки до набора ячеек источников.	Raster Layer
in_cost_backlink_raster	Растр стоимостного направления, который используется для определения пути возвращения к исходной точке по пути с наименьшей стоимостью или кратчайшему пути. Для каждой ячейки в растре стоимостного направления, обратного направления или направления потока, это значение указывает соседнюю ячейку, которая будет следующей на пути от ячейки к исходной ячейке.	Raster Layer
out_polyline_features	Выходной класс объектов, в котором хранится путь наименьшей стоимости.	Feature Class
path_type (Дополнительный)	Указывает ключевое слово, определяющее то, как в вычислениях оптимального пути будут интерпретированы значения и зоны во входных данных объектов назначения. `BEST_SINGLE`–Для всех ячеек во входных данных назначений путь с наименьшей стоимостью вычисляется из ячейки, лежащей на пути с наименьшей стоимостью перемещения до ячеек источников и имеющей минимальное значение стоимости. Эта опция используется по умолчанию. `EACH_ZONE`–В выходном растре определяется и сохраняется путь с наименьшей стоимостью для каждой зоны входных данных объектов назначения. С этой опцией путь с наименьшей стоимостью для каждой зоны начинается в ячейке с наименьшим весом стоимостного расстояния в зоне. `EACH_CELL`–В выходном растре определяется и сохраняется путь с наименьшей стоимостью для каждой ячейки, имеющей действительные значения во входных данных объектов назначения. С этой опцией каждая ячейка во входных данных назначения рассматривается по отдельности, и путь с наименьшей стоимостью определяется для каждой ячейки.	String
destination_field (Дополнительный)	Поле, используемое для получения значений местоположений адресатов. Если входные целевые данные являются объектом, они должны содержать по крайней мере одно допустимое целочисленное поле. Первое целочисленное поле в этой таблице атрибутов используется по умолчанию. Если указан растр, то по умолчанию используется поле `Value`.	Field
force_flow_direction_convention (Дополнительный)	Определяет, будет ли входной растр направления обрабатываться как растр направления стока. Растры направления стока должны содержать целочисленные значения в диапазоне от 0 до 255. `FLOW_DIRECTION`–Значение параметра `in_cost_backlink_raster` будет рассматриваться как растр направления стока. Это является необходимым, если значение растра направления стока не превышает 8. `INPUT_RANGE`–Значение параметра `in_cost_backlink_raster` будет интерпретироваться в зависимости от диапазона значений и от того, являются ли значения целочисленными или числами с плавающей точкой. Для диапазона значений 0-8 значение будет рассматриваться как растр обратной ссылки. Для значений в диапазоне от 0 до 255 значение будет рассматриваться в качестве растра направления стока. Для значений в диапазоне от 0 до 360 и чисел с плавающей точкой значение будет рассматриваться в качестве растра обратного направления. Эта опция используется по умолчанию.	Boolean

Пример кода

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

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

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
CostPathAsPolyline("observers", "costdistraster", "backlink2", "c:/sapyexamples/output/outcostpth01.shp")

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

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

# Name: CostPathAsPolyline_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"
inCostDistRaster = "costdistraster"
inBacklink = "backlink2"
outCostPathFeat = "c:/sapyexamples/output.gdb/outcostpathfeat02"
method = "EACH_CELL"
destField = "FID"

# Run
CostPathAsPolyline(inDestination, inCostDistRaster, inBacklink,
                   outCostPathFeat, method, destField)

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

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

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

Basic: Требуется Spatial Analyst
Standard: Требуется Spatial Analyst
Advanced: Требуется Spatial Analyst