Сводка
Вычисляет определенные пути между известными источниками и назначениями.
Иллюстрация
Использование
Этот инструмент портала для анализа растров доступен, если вы выполнили вход в ArcGIS Enterprise
портал с расширением 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 (Дополнительный) | Определяет то, как в вычислениях оптимального пути будут интерпретированы значения и зоны во входных данных объектов назначения.
| String |
Производные выходные данные
| Name | Объяснение | Тип данных |
| outputRaster | Выходной растр. | Растровый слой |
Пример кода
В данном примере вычисляется стоимость перемещения к назначениям.
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")В данном примере вычисляется стоимость перемещения к назначениям.
#-------------------------------------------------------------------------------
# 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)Environments
Информация о лицензиях
- Basic: Требуется ArcGIS Image Server
- Standard: Требуется ArcGIS Image Server
- Advanced: Требуется ArcGIS Image Server