Уклон (Spatial Analyst)
Резюме
Определяет уклон (градиент, или скорость максимального изменения значения z) для каждой ячейки поверхности растра.
Рисунок
Использование
-
Уклон - это степень максимального изменения в z-значении, определяемого из каждой ячейки.
-
В тех случаях, когда z-значения поверхности выражены в единицах измерения, отличающихся от наземных единиц измерения x,y, для корректировки вычислений уклона существенным представляется использование коэффициента по z.
-
Диапазон выходных значений зависит от типа единиц измерения.
- Для градусов диапазон значений уклона составляет от 0 до 90.
- Для процентного увеличения диапазон составляет от 0 до бесконечности. Плоская поверхность соответствует значению 0 процентов, уклон поверхности в 45 градусов соответствует 100 процентам подъема, и по мере того, как поверхность становится более вертикальной, процент подъема все больше и больше увеличивается. Более подробно о диапазоне выходных значений см. раздел Как работает инструмент Уклон (Slope) .
-
Если центральная ячейка в окне размером 3 x 3 имеет значение NoData, соответствующая ей выходная ячейка будет также иметь значение NoData.
-
Если какие-либо ячейки из окрестности имеют значение NoData, им присваивается значение центральной ячейки; затем вычисляется уклон.
Синтаксис
Параметр | Объяснение | Тип данных |
in_raster |
Входной растр поверхности. | Raster Layer |
output_measurement (дополнительно) |
Определяет единицы измерения (градусы или проценты) выходных данных инструмента Уклон.
| String |
z_factor (дополнительно) | Количество наземных единиц измерения координат x,y в одной единице измерения z-значения поверхности. Коэффициент z (z-factor) приводит в соответствие единицы измерения z-значений в том случае, если они отличаются от единиц измерения координат x,y входной поверхности. При вычислении результирующей выходной поверхности z-значения входной поверхности умножаются на коэффициент по z. Если координаты x,y и z-значения приведены в одной и той же системе координат, коэффициент z равен 1. Это значение используется по умолчанию. Если координаты x,y и z-значения приведены в отличающихся единицах измерения, для коэффициента по z должно быть задано соответствующее значение, или же результаты будут некорректными. Например, если единицы измерения для z-значений – футы, а координаты x,y приведены в метрах, для преобразования z-значений из футов в метры вы должны использовать коэффициент по z, равный 0,3048 (1 фут = 0,3048 метра). | Double |
Возвращено значение
Имя | Объяснение | Тип данных |
out_raster |
Выходной растр уклона. | Raster |
Пример кода
В этом примере определяются значения уклона входного растра поверхности.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outSlope = Slope("elevation", "DEGREE", 0.3043)
outSlope.save("C:/sapyexamples/output/outslope01")
В этом примере определяются значения уклона входного растра поверхности.
# Name: _Ex_02.py
# Description: Identifies the rate of maximum change
# in z-value from each cell.
# 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
inRaster = "elevation"
outMeasurement = "DEGREE"
zFactor = 0.3043
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute Slope
outSlope = Slope(inRaster, outMeasurement, zFactor)
# Save the output
outSlope.save("C:/sapyexamples/output/outslope02")