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

Сводка

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

Иллюстрация

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Синтаксис

arcpy.ra.DetermineTravelCostPathsToDestinations(inputDestinationRasterOrFeatures, inputCostDistanceRaster, inputCostBacklinkRaster, outputName, {destinationField}, {pathType})
ParameterОбъяснениеТип данных
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

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

NameОбъяснениеТип данных
outputRaster

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

Растровый слой

Пример кода

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

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

import arcpy

arcpy.DetermineTravelCostPathstoDestinations_ra(
    "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.DetermineTravelCostPathstoDestinations_ra(inputSourceLayer, inputCostLayer,
                                                inputBackLinkLayer, outputName, 
						destField, pathType)

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

  • Basic: Требуется ArcGIS Image Server
  • Standard: Требуется ArcGIS Image Server
  • Advanced: Требуется ArcGIS Image Server

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