Оптимальный путь как растр (Анализ растра)

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

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

Иллюстрация

Рабочий процесс Оптимальный путь как растр

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

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

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

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

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

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

  • Перед созданием оптимального пути обычно используется один из следующих инструментов для создания растра накопления расстояния и растра обратного направления: Накопление расстояния или Распределение по расстоянию. Это необходимые входные данные для создания оптимального пути.

  • Оптимальный созданный путь может быть путем потока, основанным на направлении потока D8. Чтобы создать оптимальный путь таким образом, укажите растр направления потока D8 в качестве входного растра для Входного растра обратного направления или направления стока. Необходимо также указать Входной растр накопленного расстояния; Входной растр накопленного расстояния не используется для определения пути. Независимо от использования константного растра или цифровой модели рельефа (ЦМР), путь будет одинаков; меняется только атрибутивное значение на пути. См. инструмент Направление стока для получения дополнительных сведений о растрах направления стока D8.

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

  • Для создания оптимального пути параметр среды Размер ячейки игнорируется, а для вычисления выходного растра используется размер ячейки Входного растра стоимостного направления. Структура растра направления может сильно измениться, если будет изменено его разрешение. Чтобы избежать ошибок, при использовании этого инструмента не следует устанавливать параметр размера ячейки.

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

Параметры

ПодписьОписаниеТип данных
Входные растровые или векторные данные назначения

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

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

Raster Layer; Feature Layer
Входной растр накопленного расстояния

Растр накопленного расстояния используется для определения оптимального пути от источников до пунктов назначения.

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

Raster Layer
Входной растр обратного направления или направления стока

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

Диапазон значений – от 0 до 360 градусов. Значение 0 резервируется для ячеек источников. Направление прямо на восток (вправо) в градусах считается равным 90 градусам; значения увеличиваются по часовой стрелке (180 – на юг; 270 – на запад; и 360 на север).

Raster Layer
Выходное имя растра

Имя выходного растрового сервиса, содержащего оптимальные пути.

String
Поле назначения
(Дополнительный)

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

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

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

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

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

ПодписьОписаниеТип данных
Выходной растр

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

Raster

arcpy.ra.OptimalPathAsRaster(inputDestinationRasterOrFeatures, inputDistanceAccumulationRaster, inputBackDirectionRaster, outputRasterName, {destinationField}, {pathType})
ИмяОписаниеТип данных
inputDestinationRasterOrFeatures

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

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

Raster Layer; Feature Layer
inputDistanceAccumulationRaster

Растр накопленного расстояния используется для определения оптимального пути от источников до пунктов назначения.

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

Raster Layer
inputBackDirectionRaster

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

Диапазон значений – от 0 до 360 градусов. Значение 0 резервируется для ячеек источников. Направление прямо на восток (вправо) в градусах считается равным 90 градусам; значения увеличиваются по часовой стрелке (180 – на юг; 270 – на запад; и 360 на север).

Raster Layer
outputRasterName

Имя выходного растрового сервиса, содержащего оптимальные пути.

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

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

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

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

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

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

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

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

Raster

Пример кода

Optimal Path As Raster, пример 1 (окно Python)

Следующий скрипт окна Python демонстрирует, как использовать инструмент OptimalPathAsRaster.

import arcpy

arcpy.ra.OptimalPathAsRaster(
    "https://myserver/rest/services/destination/ImageServer", 
    "https://myserver/rest/services/accumulationraster/ImageServer", 
    "https://myserver/rest/services/backdirection/ImageServer", 
    "outpath")
Optimal Path As Raster, пример 2 (автономный скрипт)

Рассчитайте оптимальный путь от пункта назначения до исходных пунктов.

#-------------------------------------------------------------------------------
# Name: OptimalPathAsRaster_Ex_02.py
# Description: Calculates the optimal path from a source to a destination.
# Requirements: ArcGIS Image Server

# Import system modules
import arcpy

# Set local variables
inputDestinationLayer =
    'https://MyPortal.esri.com/server/rest/services/Hosted/destination/ImageServer'
inputAccumulationLayer =
    'https://MyPortal.esri.com/server/rest/services/Hosted/costaccumulation/ImageServer'
inputDirectionLayer = 
    'https://MyPortal.esri.com/server/rest/services/Hosted/backdirection/ImageServer'
outOptimalPathName = 'OptimalPath'

arcpy.ra.OptimalPathAsRaster(inputDestinationLayer, inputAccumulationLayer,
                            inputDirectionLayer, outOptimalPathName)

Параметры среды

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

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

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