Коридор наименьшей стоимости (Spatial Analyst)

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

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

Более подробно о соединении местоположений коридорами

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

  • Входные растры должны представлять собой растры накопления расстояния и растры обратного направления, выдаваемые инструментами Накопление расстояния или Распределения расстояний.

  • Используйте версию стоимости, основанную на растрах накопления расстояния. Единицами растра могут быть, но не обязательно, доллары на метр, предпочтение на фут или минуты на метр в зависимости от приложения. Эти единицы стоимости зафиксированы на поверхности стоимости. Более подробную информацию см. в Корректировка пройденного расстояния с использованием поверхности стоимости.

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

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

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

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

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

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

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

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

  • Если формат выходного растра .crf, этот инструмент поддерживает параметр среды хранения растровых изображений Пирамида. Пирамиды будут созданы в выходных данных по умолчанию. Для любого другого формата вывода этот параметр среды не поддерживается, и пирамиды создаваться не будут.

  • См. раздел Параметры среды анализа и Spatial Analyst для получения дополнительной информации о среде геообработки данного инструмента.

Параметры

ПодписьОписаниеТип данных
Входной растр расстояния с накопленной стоимостью 1

Входной растр, отображающий совокупное стоимостное расстояние от первого источника.

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

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

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

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

Raster Layer
Входной растр расстояния с накопленной стоимостью 2

Входной растр, отображающий совокупное стоимостное расстояние от второго источника.

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

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

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

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

Raster Layer
Метод порогового значения

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

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

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

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

Этот параметр будет активен, только если для параметра Метод порогового значения задано значение Процент наименьшей стоимости или Накопленная стоимость.

Double

Возвращаемое значение

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

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

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

Raster

LeastCostCorridor(in_accumulative_cost_distance_raster1, in_back_direction_raster1, in_accumulative_cost_distance_raster2, in_back_direction_raster2, threshold_method, threshold)
ИмяОписаниеТип данных
in_accumulative_cost_distance_raster1

Входной растр, отображающий совокупное стоимостное расстояние от первого источника.

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

Raster Layer
in_back_direction_raster1

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

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

Raster Layer
in_accumulative_cost_distance_raster2

Входной растр, отображающий совокупное стоимостное расстояние от второго источника.

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

Raster Layer
in_back_direction_raster2

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

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

Raster Layer
threshold_method

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

  • NO_THRESHOLDПорог не применяется, и полученный коридор будет охватывать весь экстент входных растров. Используется по умолчанию.
  • PERCENT_OF_LEAST_COSTПорог будет определяться как процент от минимального значения суммированных растров расстояний с накопленной стоимостью.
  • ACCUMULATIVE_COSTПороговое значение будет задано в единицах расстояний с накопленной стоимостью.
String
threshold

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

Если для параметра threshold_method задано значение PERCENT_OF_LEAST_COST, это значение будет указывать процентное увеличение, применяемое к минимальному значению суммированных растров расстояний накопленной стоимости. Если для параметра threshold_method задано значение ACCUMULATIVE_COST, это значение находит ячейки, суммарная накопленная стоимость которых не превышает значения, включаемое в коридор.

Этот параметр включается только тогда, когда параметр threshold_method имеет значение PERCENT_OF_LEAST_COST или ACCUMULATIVE_COST.

Double

Возвращаемое значение

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

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

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

Raster

Пример кода

Коридор наименьшей стоимости пример 1 (окно Python)

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

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/arcpyexamples/data"
out_LCC_raster = LeastCostCorridor("DistAccumRaster1.tif", "BackDirRaster1.tif",
                                   "DistAccumRaster2.tif", "BackDirRaster2.tif") 
out_LCC_raster.save("c:/arcpyexamples/output/corridor.tif")
Коридор наименьшей стоимости пример 2 (автономный скрипт)

Вычислить коридор между двумя областями.

# Name: LeastCostCorridor_Ex_02.py
# Description: Calculates a potential wildlife corridor between two known 
#               protected areas.
# Requirements: Spatial Analyst Extension

# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *

# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

# Set environment settings
env.workspace = "C:/arcpyexamples/data"

# Set local variables
in_accumulative_cost_distance_raster1 = "distaccum_s1.tif"
in_back_direction_raster1 = "backdir_s1.tif"
in_accumulative_cost_distance_raster2 = "distaccum_s2.tif"
in_back_direction_raster2 = "backdir_s2.tif"
threshold_method = "ACCUMULATIVE_COST" 
threshold = 500

# Run Least Cost Corridor
out_LCC_raster = LeastCostCorridor(
    in_accumulative_cost_distance_raster1, in_back_direction_raster1, 
    in_accumulative_cost_distance_raster2, in_back_direction_raster2, 
    "ACCUMULATIVE_COST", "500")

# Save the output 
out_LCC_raster.save("c:/arcpyexamples/output/corridor.tif")

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