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

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

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

Подсказка:

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

Иллюстрация

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

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

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

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

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

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

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

Параметры

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

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

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

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

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

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

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

Raster Layer; Image Service; String
Входной растр назначений или объекты назначений

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

Raster Layer; Image Service; Feature Layer; String
Имя выходной полилинии

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

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

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

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

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

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

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

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

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

Field

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

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

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

Feature Class

arcpy.ra.DetermineTravelCostPathAsPolyline(inputSourceRasterOrFeatures, inputCostRaster, inputDestinationRasterOrFeatures, outputPolylineName, {pathType}, {destinationField})
ИмяОписаниеТип данных
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

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

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

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

Feature Class

Пример кода

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

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

import arcpy

arcpy.ra.DetermineTravelCostPathAsPolyline(
    "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.ra.DetermineTravelCostPathAsPolyline(inputSourceLayer, inputCostLayer,
                                           inputDestinationLayer, outputName, pathType)

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

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

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