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

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

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

Прежние версии:

Этот инструмент является Устаревшим и будет удален в будущих версиях.

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

Иллюстрация

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

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

  • Этот инструмент портала для анализа растров доступен, если вы вошли в портал 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

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