Доступно с лицензией Spatial Analyst.
Краткая информация
Вычисляет наименьшую суммарную стоимость перемещения для каждой ячейки от или до источника с наименьшей стоимостью по поверхности стоимости.
Более подробно о работе инструментов стоимостного расстояния
Иллюстрация
Использование
Входные данные источников могут быть представлены классом объектов или растром.
Когда входные данные источников – растр, набор ячеек источников состоит из всех ячеек в растре источников, которые имеют действительные значения. Ячейки, имеющие значение NoData, не включаются в набор источников. Нулевое значение рассматривается как истинный источник. Исходный растр можно легко создать с помощью инструментов извлечения.
Когда входные данные источников представлены классом пространственных объектов, местоположения источников внутренне конвертируются в растр до выполнения анализа. Разрешение растра можно настраивать с помощью параметра среды Размер ячейки. Выходное разрешение по умолчанию будет соответствовать разрешению входного растра стоимости.
При использовании данных полигонального объекта в качестве входных исходных данных следует особенно тщательно выбирать способ обработки размера выходной ячейки, если его можно охарактеризовать как грубый относительно подробных сведений во входных данных. Процесс внутренней растеризации задействует тот же Метод присвоения значений ячейкам по умолчанию, что и инструмент Полигон в растр, т.е. Метод центра ячейки. Это означает, что данные, не расположенные по центру ячейки, не будут включены в промежуточные растеризованные исходные выходные данные, поэтому они не будут представлены в расчетах расстояния. Например, если источником является ряд небольших полигонов (например периметры знаний), которые невелики относительно размера выходной ячейки, возможно, что только некоторые из них попадут по центру выходных растровых ячеек, и, видимо, большинство остальных объекты будут потеряны в анализе.
Во избежание этой ситуации в качестве промежуточного шага можно напрямую растеризовать входные объекты с помощью инструмента Полигон в растр и задать Поле приоритета. Затем используйте полученные выходные данные в качестве входных для того инструмента расстояний, который вам требуется. Кроме того, можно выбрать небольшой размер ячейки, чтобы получить достаточный объем данных из входных объектов.
Если входные данные источника являются объектом, по умолчанию используется первое доступное поле. Если доступных полей нет, используется поле ObjectID (например, OID или FID, в зависимости от типа входных данных объекта).
Ячейки со значением NoData во Входном растре стоимости ведут себя как барьеры в инструментах стоимостной поверхности. Любой ячейке, которой присвоено значение NoData на входной поверхности стоимости, будет присвоено значение NoData на всех выходных растрах (стоимость расстояния, распределение и направление).
Если входные данные источников и растр стоимости имеют различные экстенты, по умолчанию выходной экстент будет определяться как пересечение двух растров. Чтобы получить поверхность стоимостного расстояния для всего экстента, выберите опцию Объединение входных данных на выходных параметров среды Экстент.
Максимальное расстояние задаётся в тех же единицах стоимости, что используются и на входном растре стоимости.
Для выходного растра расстояния, расстояние с наименьшей стоимостью (или минимальное суммарное стоимостное расстояние) ячейки от или до набора исходных местоположений – это нижняя граница расстояний с наименьшей стоимостью от ячейки до всех исходных местоположений.
Растр стоимости не может содержать нулевые значения, так как алгоритм представляет собой мультипликативный процесс. Если ваш растр стоимости содержит нулевые значения, и они представляют области наименьшей стоимости, замените нулевые значения на небольшие положительные числа (например 0,01) перед запуском инструмента Стоимостное расстояние, воспользовавшись инструментом Условие. Если ячейки с нулевыми значениями представляют области, которые должны быть исключены из анализа, замените нулевые значения на значения NoData перед запуском инструмента Стоимостное расстояние, воспользовавшись инструментом Установить ноль.
Характеристики источника или объектов, перемещающихся от или к источнику, могут управляться определенными параметрами. Параметр Множитель стоимости источника определяет режим перемещения или магнитуды источника, Начальная стоимость источника задает начальную стоимость до начала движения, Коэффициент сопротивления источника является динамической настройкой, учитывающей влияние накопленной стоимости, например, симуляция степени усталости альпиниста, а Емкость источника задает количество стоимости может накопить источник до достижения предела. Направление движения определяет, начинает ли объект движение от источника к другим местоположениям или наоборот, к источнику.
Если задана Начальная стоимость источника, а Направление движения выбрано как Движение от источника, исходным местоположениям на выходной поверхности стоимостного расстояния будет присвоено значение Начальной стоимости источника; иначе, им будет присвоено значение 0.
Если какие-либо параметры характеристик источника определены с помощью поля, характеристики источника будут применяться на основе источник-к-источнику, в соответствии с информацией в данном поле для исходных данных. Если используется ключевое слово или константа, они применяются ко всем источникам.
См. раздел Параметры среды анализа и Spatial Analyst для получения дополнительной информации о среде геообработки данного инструмента.
Синтаксис
CostDistance (in_source_data, in_cost_raster, {maximum_distance}, {out_backlink_raster}, {source_cost_multiplier}, {source_start_cost}, {source_resistance_rate}, {source_capacity}, {source_direction})| Параметр | Объяснение | Тип данных |
in_source_data | Входные местоположения источников. Растр или набор пространственных данных, определяющий ячейки или местоположения, от или до которых вычисляются стоимостные расстояния с наименьшей стоимостью перемещения от всех ячеек. Для растров входной тип может быть целочисленным или с плавающей точкой. | Raster Layer; Feature Layer |
in_cost_raster | Растр, определяющий полное сопротивление или стоимость движения в плоскости через каждую ячейку. Значение в каждой ячейке представляет стоимость движения через ячейку по поверхности стоимости, выраженную на единицу расстояния. Для получения общей стоимости прохождения через ячейку, значение каждой ячейки умножается на разрешение ячейки, с учетом возможности движения по диагонали. Значения на входном растре стоимости могут быть представлены целыми числами или числами с плавающей точкой, но они не могут быть отрицательными (стоимость не может быть отрицательной). | Raster Layer |
maximum_distance (Дополнительный) | Определяет пороговое значение суммарной стоимости перемещения, которое не может быть превышено. Если значение суммарного стоимостного расстояния превышает это значение, выходной ячейке будет присвоено значение NoData. Максимальное расстояние определяет экстент, для которого вычисляются совокупные стоимостные расстояния. Значение по умолчанию равно расстоянию до границы выходного растра. | Double |
out_backlink_raster (Дополнительный) | Выходной растр стоимостного направления. Растр направления содержит значения от 0 до 8, которые определяют направление или следующую соседнюю ячейку вдоль оптимального пути с наименьшей суммарной стоимостью перемещения из каждой ячейки до ближайшего (в терминах стоимости) источника. Если маршрут должен пройти через правую соседнюю ячейку, ячейке будет присвоено значение 1, значение 2 будет присвоено нижней правой диагональной ячейке, и так далее по часовой стрелке. Значение 0 резервируется для ячеек источников.  | Raster Dataset |
source_cost_multiplier (Дополнительный) | Множитель, применяемый к значениям стоимости. Позволяет управлять режимом перемещения или магнитудой источника. Чем больше множитель, тем выше стоимость перемещения по каждой ячейке. Значения должны быть больше нуля. Значение по умолчанию равно 1. | Double; Field |
source_start_cost (Дополнительный) | Начальная стоимость, от которой начинаются вычисления стоимости. Позволяет задавать фиксированную стоимость, связанную с источником. Вместо начала вычисления стоимости с нуля, алгоритм стоимости начинает со значения, заданного параметром source_start_cost. Значения должны быть больше или равны нулю. Значение по умолчанию равно 0. | Double; Field |
source_resistance_rate (Дополнительный) | Этот параметр симулирует возрастание усилия для преодоления стоимостей по мере повышения накопленной стоимости. Он используется для моделирования усталости путешествующего. Возрастающая накопленная стоимость для достижения ячейки умножается на степень сопротивляемости и добавляется к стоимости перемещения в последующую ячейку. Это модифицированная версия формулы начисления сложных процентов, которая используется для вычисления предполагаемой стоимости перемещения по ячейке. По мере увеличения степени сопротивления, увеличивается стоимость ячеек, посещаемых в последнюю очередь. Чем выше степень сопротивления, тем больше дополнительной стоимости добавляется для достижения следующей ячейки, которая складывается при каждом последующем передвижении. Поскольку степень сопротивления похожа по свойствам на общий темп роста, и значения накопленной стоимости очень велики, рекомендуется использовать небольшие значения степени сопротивления, например, 0,02, 0,005 или даже меньше, в зависимости от значений накопленной стоимости. Значения должны быть больше или равны нулю. Значение по умолчанию равно 0. | Double; Field |
source_capacity (Дополнительный) | Задает для перемещающегося объекта емкость стоимости источника. Вычисление стоимости продолжается для каждого источника, пока не будет достигнута указанная емкость. Значения должны быть больше нуля. Емкость по умолчанию равна расстоянию до границы выходного растра. | Double; Field |
source_direction (Дополнительный) | Задает направление перемещающегося объекта при применении коэффициента сопротивления источника и начальной стоимости источника.
Укажите ключевое слово FROM_SOURCE, либо TO_SOURCE, которое будет применено ко всем источникам, или выберите поле во входных данных, содержащее ключевые слова для определения направления перемещения для каждого источника. Поле должно содержать строки FROM_SOURCE или TO_SOURCE. | String; Field |
Возвращаемое значение
| Название | Объяснение | Тип данных |
| out_distance_raster | Выходной растр стоимостного расстояния. Растр стоимостного расстояния определяет, для каждой ячейки, наименьшее суммарное стоимостное расстояние по поверхности стоимости до установленных положений источников. Источник может быть представлен ячейкой, набором ячеек или векторным объектом. Выходной растр представлен числами с плавающей точкой. | Raster |
Пример кода
CostDistance, пример 1 (окно Python)
На следующем скрипте Python Window показано, как использовать инструмент CostDistance.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outCostDist = CostDistance("source.shp", "elevation", "", "backlink", "Multiplier", "StartCost", "Resistance", 500000)
outCostDist.save("C:/sapyexamples/output/costdist")
CostDistance, пример 2 (автономный скрипт)
Вычисление растра расстояния с наименьшей стоимостью накопления из исходных местоположений точечного шейп-файла.
# Name: CostDistance_Ex_02.py
# Description: Calculates for each cell the least accumulative cost distance
# to the nearest source over a cost surface.
# Requirements: Spatial Analyst Extension
# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *
# Set environment settings
env.workspace = "C:/sapyexamples/data"
# Set local variables
inSourceData = "source.shp"
inCostRaster = "elevation"
maxDistance = ""
outBkLinkRaster = "C:/sapyexamples/output/outbklink"
multiplier = "Multiplier"
startCost = "StartCost"
resistance = "Resistance"
capacity = 500000
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute CostDistance
outCostDistance = CostDistance(inSourceData, inCostRaster, maxDistance, outBkLinkRaster, multiplier, startCost,
resistance, capacity)
# Save the output
outCostDistance.save("C:/sapyexamples/output/outcostdist")
Параметры среды
Информация о лицензиях
- ArcGIS Desktop Basic: Требует Spatial Analyst
- ArcGIS Desktop Standard: Требует Spatial Analyst
- ArcGIS Desktop Advanced: Требует Spatial Analyst