Оптимальный путь как полилиния (Анализ растра)

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

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

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

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

Инструмент Оптимальный путь как линия предоставляет улучшенную функциональность или производительность.

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

Иллюстрация

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

• Этот инструмент портала для анализа растров доступен, если вы вошли в портал ArcGIS Enterprise с ArcGIS Image Server, настроенным для Анализ растров. Когда инструмент запущен, ArcGIS Pro выступает в качестве клиента, а обработка происходит на серверах, интегрированных с ArcGIS Enterprise. Инструмент портала принимает слои с вашего портала в качестве входных данных и создает выходные данные на вашем портале.

  Входной растровый слой поддерживает слой с портала, URI или URL сервиса изображений или выходные данные инструмента Создать слой из сервера изображений. Входным векторным слоем может быть слой с портала или URI или URL сервиса объектов. Этот инструмент не поддерживает локальные растровые данные или слои. Хотя вы можете использовать локальные векторные данные и слои в качестве входных данных для этого инструмента портала, рекомендуется использовать в качестве входных данных слои с вашего портала.

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

• Если у вас есть исходные объекты, сначала конвертируйте их в набор растровых данных с помощью функции Растеризовать объекты. С помощью имеющегося Растра стоимости, используемого в качестве входного Растра функции растеризации. Это позволит убедиться в том, что объекты правильно конвертированы в сервис изображений с теми же размером ячейки, экстентом и пространственной привязкой.

• Значения NoData, существующие в Исходном растре, не включаются как допустимые для этой функции. Значение 0 рассматривается как допустимое в целевом растре.

• Два входных сервиса изображений требуются для запуска Растр стоимости как полилиния. То, как вы создаете эти входные данные, зависит от типа выполняемого вами анализа.

  • Стоимостный анализ позволяет создать стоимостный путь. Запустите растровые функции Стоимостное направление и Стоимостное расстояние, чтобы создать необходимые вам входные данные.
  • Анализ с использованием евклидова расстояния позволяет создавать прямые линии и линии вокруг барьеров. Запустите инструмент Вычислить расстояние для создания растров Евклидово направление и Евклидово расстояние. Либо запустите растровые функции Евклидово направление и Евклидово расстояние.
  • Анализ стока создает пути стока. Запускает растровую функцию Направление стока с помощью опции D8. Используйте растр направления стока D8 в качестве входного для инструмента Входной растр стоимостного направления. Необходимо также указать Входной растр стоимостного расстояния; Входной растр стоимостного расстояния не используется для определения пути. Независимо от использования константного растра или цифровой модели рельефа (ЦМР), путь будет одинаков; меняется только атрибутивное значение на пути.

• В выходном сервисе объектов есть поле DestID, в котором задается цель, к которой ведет каждая линия.

• В отличие от других инструментов Анализа растра, Стоимостный путь как полилиния не будет учитывать следующие настройки среды: Выходная система координат, Экстент, Размер ячейки и Растр замыкания. Структура растра направления может сильно измениться, если будет изменено разрешение или система координат растра, что приведет к созданию некорректного пути.

Параметры

Диалог

Подпись	Описание	Тип данных
Входной растр назначений или объекты назначений	Сервис изображений или сервис объектов, определяющий ячейки, из которых вычисляется путь с наименьшей стоимостью перемещения до источника, расположенного ближе всего по стоимости перемещения. Если входные данные представлены сервисом изображений, они состоят из ячеек, имеющих допустимые значения (нуль является допустимым значением), а остальным ячейкам должно быть присвоено значение NoData.	Raster Layer; Image Service; Feature Layer; String
Входной растр Стоимостного расстояния или Евклидова расстояния	Растр стоимостного расстояния или растр Евклидова расстояния, используемый для определения маршрута с наименьшей стоимостью из источников к назначениям.	Raster Layer; Image Service; String
Входной растр Стоимостного направления, Обратного направления или Направления стока	Имя растра, используемого для определения пути возвращения к источнику по маршруту с наименьшей стоимостью перемещения либо кратчайшего пути. Для каждой ячейки на растре направления значение определяет соседнюю ячейку, которая является следующей при перемещении из ячейки до ячейки источника.	Raster Layer; Image Service; String
Имя выходной полилинии	Выходной сервис объектов, в котором хранится путь наименьшей стоимости.	String
Тип пути (Дополнительный)	Определяет, как в вычислениях оптимального пути будут интерпретированы значения и зоны во входных данных объектов назначения. Один наилучший—Для всех ячеек входных данных назначений путь с наименьшей стоимостью перемещения вычисляется из ячейки, лежащей на пути с наименьшей стоимостью до ячеек источников и имеющей минимальное значение стоимости. Каждая зона—В выходном растре определяется и сохраняется путь с наименьшей стоимостью для каждой зоны входных данных объектов назначения. С этой опцией путь с наименьшей стоимостью для каждой зоны начинается в ячейке с наименьшим весом стоимостного расстояния в зоне. Каждая ячейка—В выходном растре определяется и сохраняется путь с наименьшей стоимостью для каждой ячейки, имеющей действительные значения во входных данных объектов назначения. С этой опцией каждая ячейка входных данных объектов назначения рассматривается по отдельности, и путь с наименьшей стоимостью перемещения вычисляется от каждой ячейки назначения.	String
Поле назначения (Дополнительный)	Поле, значения в котором используются для получения значений местоположений адресатов.	Field

Производные выходные данные

Подпись	Описание	Тип данных
Выходной полилинейный объект	Полининейные объекты.	Feature Layer

Python

arcpy.ra.CostPathAsPolyline(inputDestinationRasterOrFeatures, inputCostDistanceRaster, inputCostBacklinkRaster, outputPolylineName, {pathType}, {destinationField})

Имя	Описание	Тип данных
inputDestinationRasterOrFeatures	Сервис изображений или сервис объектов, определяющий ячейки, из которых вычисляется путь с наименьшей стоимостью перемещения до источника, расположенного ближе всего по стоимости перемещения. Если входные данные представлены сервисом изображений, они состоят из ячеек, имеющих допустимые значения (нуль является допустимым значением), а остальным ячейкам должно быть присвоено значение NoData.	Raster Layer; Image Service; Feature Layer; String
inputCostDistanceRaster	Растр стоимостного расстояния или растр Евклидова расстояния, используемый для определения маршрута с наименьшей стоимостью из источников к назначениям.	Raster Layer; Image Service; String
inputCostBacklinkRaster	Имя растра, используемого для определения пути возвращения к источнику по маршруту с наименьшей стоимостью перемещения либо кратчайшего пути. Для каждой ячейки на растре направления значение определяет соседнюю ячейку, которая является следующей при перемещении из ячейки до ячейки источника.	Raster Layer; Image Service; String
outputPolylineName	Выходной сервис объектов, в котором хранится путь наименьшей стоимости.	String
pathType (Дополнительный)	Определяет, как в вычислениях оптимального пути будут интерпретированы значения и зоны во входных данных объектов назначения. BEST_SINGLE—Для всех ячеек входных данных назначений путь с наименьшей стоимостью перемещения вычисляется из ячейки, лежащей на пути с наименьшей стоимостью до ячеек источников и имеющей минимальное значение стоимости. EACH_ZONE—В выходном растре определяется и сохраняется путь с наименьшей стоимостью для каждой зоны входных данных объектов назначения. С этой опцией путь с наименьшей стоимостью для каждой зоны начинается в ячейке с наименьшим весом стоимостного расстояния в зоне. EACH_CELL—В выходном растре определяется и сохраняется путь с наименьшей стоимостью для каждой ячейки, имеющей действительные значения во входных данных объектов назначения. С этой опцией каждая ячейка входных данных объектов назначения рассматривается по отдельности, и путь с наименьшей стоимостью перемещения вычисляется от каждой ячейки назначения.	String
destinationField (Дополнительный)	Поле, значения в котором используются для получения значений местоположений адресатов.	Field

Производные выходные данные

Имя	Описание	Тип данных
outputPolylineFeatures	Полининейные объекты.	Feature Layer

Пример кода

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

Окно скрипта Python и демонстрация выполнения функции CostPathAsPoyline.

import arcpy

arcpy.ra.CostPathAsPolyline(
    "https://myserver/rest/services/destination/ImageServer", 
    "https://myserver/rest/services/costsurface/ImageServer", 
    "https://myserver/rest/services/direction/ImageServer", 
    "outpath", "BEST_SINGLE")

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

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

#-------------------------------------------------------------------------------
# Name: CostPathAsPolyline_Ex_02.py
# Description: Calculates the least-cost path from a source to a destination.
# Requirements: ArcGIS Image Server

# Import system modules
import arcpy

# Set local variables
inputDestinationLayer =
    'https://MyPortal.esri.com/server/rest/services/Hosted/destination/ImageServer'
inputCostLayer =
    'https://MyPortal.esri.com/server/rest/services/Hosted/costraster/ImageServer'
inputDirectionLayer = 
    'https://MyPortal.esri.com/server/rest/services/Hosted/direction/ImageServer'
outputName = 'outTravelPaths'
pathType = 'BEST_SINGLE'

arcpy.ra.CostPathAsPolyline(inputDestinationLayer, inputCostLayer,
                            inputDirectionLayer, outputName, pathType)

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

Выходная система координат

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

• Basic: Обязательно ArcGIS Image Server
• Standard: Обязательно ArcGIS Image Server
• Advanced: Обязательно ArcGIS Image Server