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

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

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

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

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

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

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

Иллюстрация

Иллюстрация к инструменту Оптимальный путь как полилиния

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

  • Этот инструмент портала для анализа растров доступен, если вы вошли в портал 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

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

Связанные разделы