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

Сводка

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

Иллюстрация

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

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

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

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

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

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

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

Синтаксис

arcpy.ra.DetermineTravelCostPathAsPolyline(inputSourceRasterOrFeatures, inputCostRaster, inputDestinationRasterOrFeatures, outputPolylineName, {pathType}, {destinationField})
ParameterОбъяснениеТип данных
inputSourceRasterOrFeatures

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

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

Raster Layer; Image Service; Feature Layer; String
inputCostRaster

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

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

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

Raster Layer; Image Service; String
inputDestinationRasterOrFeatures

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

Raster Layer; Image Service; Feature Layer; String
outputPolylineName

Имя выходного полилинейного сервиса объектов.

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

Каждый путь (или линия) имеет уникальный номер и дополнительное поле в таблице атрибутов с названием DestID, которое соединяет его с уникальным идентификатором в растре назначений.

Поскольку каждый путь представлен уникальной линией, в местах, где пути проходят по одному маршруту, может находиться несколько линий.

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

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

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

Значения, используемые для получения значений местоположений адресатов.

Входные векторные данные должны включать по крайней мере одно целочисленное поле.

Field

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

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

Выходные полилинейные объекты.

Класс пространственных объектов

Пример кода

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

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

import arcpy

arcpy.DetermineTravelCostPathAsPolyline_ra(
    "https://myserver/rest/services/sources/ImageServer", 
    "https://myserver/rest/services/costsurface/ImageServer", 
    "https://myserver/rest/services/destination/ImageServer", 
    "outpath", "BEST_SINGLE")
DetermineTravelCostPathAsPolyline, пример 2 (автономный скрипт)

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

#-------------------------------------------------------------------------------
# Name: DetermineTravelCostPathAsPolyline_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'
inputDestinationLayer = 
    'https://MyPortal.esri.com/server/rest/services/Hosted/destinationras/ImageServer'
outputName = 'outTravelPaths'
pathType = 'BEST_SINGLE'

arcpy.DetermineTravelCostPathAsPolyline_ra(inputSourceLayer, inputCostLayer,
                                           inputDestinationLayer, outputName, pathType)

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

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

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