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

Доступно с лицензией Spatial Analyst.

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

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

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

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

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

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

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

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

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

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

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

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

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

• См. раздел Среда анализа и 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

Python

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

Пример кода

Least Cost Corridor пример 1 (окно Python)

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

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")

Least Cost Corridor, пример 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")

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

Автоматическое подтверждение, Сжатие, Текущая рабочая область, Выходное ключевое слово CONFIG, Коэффициент параллельной обработки, Временная рабочая область, Размер листа

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

• Basic: Обязательно Spatial Analyst
• Standard: Обязательно Spatial Analyst
• Advanced: Обязательно Spatial Analyst