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

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

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

Подсказка:

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

Иллюстрация

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

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

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

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

  • Одним из примеров применения данного инструмента является поиск стоимости перемещения для путешествий в определенные пункты назначения.

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

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

  • Каждому пути с наименьшей стоимостью присваивается значение, встречающееся в процессе сканирования. Конечной ячейке исходного источника (из которого были получены стоимостное расстояние и направление) стоимостного пути присваивается значение, равное единице, первому пути присваивается значение, равное трем, второму - значение четыре, и так далее. Значение, равное двум, резервируется для объединяемых участков путей, которые являются фрагментами общего оптимального пути.

  • Когда входные данные объектов назначений представлены сервисом изображений, набор ячеек назначений состоит из всех ячеек во входном сервисе изображений или в векторных данных объектов назначения, которые имеют допустимые значения. Ячейки, имеющие значение NoData, не включаются в набор источников. Нулевое значение рассматривается как истинное назначение.

  • Если входные данные источника являются сервисом объектов, по умолчанию используется первое доступное корректное поле. Если допустимых полей нет, по умолчанию используется поле ObjectID (например, OID или FID).

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

    Пример опции Каждая зона с объединенными путями
    Пример опции Каждая зона с объединенными путями
  • Инструмент Определить стоимостные пути перемещения к назначениям игнорирует параметр среды Размер ячейки и будет использовать размер ячейки Входного растра стоимостного направления для выходного растра. Структура растра направления может сильно измениться, если будет изменено его разрешение. Чтобы избежать ошибок, при использовании этого инструмента не следует устанавливать параметр размера ячейки.

  • Инструмент Определить стоимостные пути перемещения к назначениям может быть также использован для извлечения пути с наименьшей сопротивляемостью при движении вниз по цифровой модели рельефа ЦМР (DEM). В этом случае используйте ЦМР в качестве Входного растра стоимостного расстояния и выходные данные инструмента Направление стока в качестве Входного растра стоимостного направления. Допустимыми значениями растра направления стока являются 1, 2, 4, 8, 16, 32, 64 и 128, а допустимыми значениями растра обратного направления – от 0 до 360. Оба этих сервиса изображений допустимы.

  • Если входные данные назначений представляют собой векторные данные, то они должны включать по крайней мере одно корректное поле таблицы атрибутов.

Параметры

ПодписьОписаниеТип данных
Входной растр назначений или объекты назначений

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

Если входные данные представлены сервисом изображений, они состоят из ячеек, имеющих допустимые значения (нуль является допустимым значением), а остальным ячейкам должно быть присвоено значение NoData.

Raster Layer; Image Service; Feature Layer; String
Входной растр стоимостного расстояния

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

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

Raster Layer; Image Service; String
Входной растр стоимостного направления

Имя растра стоимостного направления, используемого для определения пути возвращения к источнику по маршруту с наименьшей стоимостью перемещения.

Для каждой ячейки на растре направления значение определяет соседнюю ячейку, которая является следующей ячейкой на пути с наименьшей стоимостью перемещения из ячейки до единственной ячейки источника или набора ячеек источников.

Raster Layer; Image Service; String
Выходное имя

Имя выходного сервиса растра путей стоимости перемещения.

Имя слоя по умолчанию зависит от имени инструмента и имени входного слоя. Если имя слоя уже используется, появится запрос ввести новое имя.

String
Поле назначения
(Дополнительный)

Поле в слое назначений, содержащее значения, определяющие каждое назначение.

Входной сервис объектов должен содержать по крайней мере одно корректное поле.

String
Тип пути
(Дополнительный)

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

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

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

ПодписьОписаниеТип данных
Выходной растр

Выходной растр.

Raster Layer

arcpy.ra.DetermineTravelCostPathsToDestinations(inputDestinationRasterOrFeatures, inputCostDistanceRaster, inputCostBacklinkRaster, outputName, {destinationField}, {pathType})
ИмяОписаниеТип данных
inputDestinationRasterOrFeatures

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

Если входные данные представлены сервисом изображений, они состоят из ячеек, имеющих допустимые значения (нуль является допустимым значением), а остальным ячейкам должно быть присвоено значение NoData.

Raster Layer; Image Service; Feature Layer; String
inputCostDistanceRaster

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

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

Raster Layer; Image Service; String
inputCostBacklinkRaster

Имя растра стоимостного направления, используемого для определения пути возвращения к источнику по маршруту с наименьшей стоимостью перемещения.

Для каждой ячейки на растре направления значение определяет соседнюю ячейку, которая является следующей ячейкой на пути с наименьшей стоимостью перемещения из ячейки до единственной ячейки источника или набора ячеек источников.

Raster Layer; Image Service; String
outputName

Имя выходного сервиса растра путей стоимости перемещения.

Имя слоя по умолчанию зависит от имени инструмента и имени входного слоя. Если имя слоя уже используется, появится запрос ввести новое имя.

String
destinationField
(Дополнительный)

Поле в слое назначений, содержащее значения, определяющие каждое назначение.

Входной сервис объектов должен содержать по крайней мере одно корректное поле.

String
pathType
(Дополнительный)

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

  • EACH_CELLВ выходном растре определяется и сохраняется путь с наименьшей стоимостью для каждой ячейки, имеющей действительные значения во входных данных объектов назначения. С этой опцией каждая ячейка во входных данных объектов назначения рассматривается по отдельности, и путь с наименьшей стоимостью перемещения вычисляется для каждой ячейки назначения. Это значение по умолчанию
  • EACH_ZONEВ выходном растре определяется и сохраняется путь с наименьшей стоимостью для каждой зоны входных данных объектов назначения. С этой опцией путь с наименьшей стоимостью перемещения для каждой зоны начинается в ячейке с наименьшим весом стоимостного расстояния в зоне.
  • BEST_SINGLEДля всех ячеек во входных данных назначений путь с наименьшей стоимостью вычисляется из ячейки, лежащей на пути с наименьшей стоимостью перемещения до ячеек источников и имеющей минимальное значение стоимости.
String

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

ИмяОписаниеТип данных
outputRaster

Выходной растр.

Raster Layer

Пример кода

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

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

import arcpy

arcpy.ra.DetermineTravelCostPathstoDestinations(
    "https://myserver/rest/services/sources/ImageServer", 
    "https://myserver/rest/services/costsurface/ImageServer", 
    "https://myserver/rest/services/backlinkras/ImageServer", 
    "outpath", "destField", "EACH_ZONE")
DetermineOptimumTravelCostNetwork, пример 2 (автономный скрипт)

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

#-------------------------------------------------------------------------------
# Name: DetermineTravelCostPathstoDestinations_Ex_02.py
# Description: Calculates the optimum travel cost path.
# Requirements: ArcGIS Image Server

# Import system modules
import arcpy

# Set local variables
inputSourceLayer =
    'https://MyPortal.esri.com/server/rest/services/Hosted/sources/ImageServer'
inputCostLayer =
    'https://MyPortal.esri.com/server/rest/services/Hosted/costraster/ImageServer'
inputBackLinkLayer = 
    'https://MyPortal.esri.com/server/rest/services/Hosted/backlinkras/ImageServer'
outputName = 'outTravelPathsRaster'
destField = 'dest1'
pathType = 'BEST_SINGLE'

arcpy.ra.DetermineTravelCostPathstoDestinations(inputSourceLayer, inputCostLayer,
                                                inputBackLinkLayer, outputName, 
                                                destField, pathType)

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

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

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