Отмывка (Инструменты Spatial Analyst)

Уровень лицензии:BasicStandardAdvanced

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

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

Более подробно об инструменте Отмывка (Hillshade)

Рисунок

Иллюстрация отмывки
OutRas = Hillshade(InRas1, 99, 33)

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

Синтаксис

Hillshade (in_raster, {azimuth}, {altitude}, {model_shadows}, {z_factor})
ПараметрОбъяснениеТип данных
in_raster

Входной растр поверхности.

Raster Layer
azimuth
(дополнительно)

Азимут положения источника света.

Азимут выражается в положительных градусах от 0 до 360, измеряемых по часовой стрелке от направления на север.

Значение по умолчанию равно 315 градусам.

Double
altitude
(дополнительно)

Угол высоты источника света над горизонтом.

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

Значение по умолчанию равно 45 градусам.

Double
model_shadows
(дополнительно)

Тип создаваемой отмывки рельефа.

  • NO_SHADOWSВыходной растр содержит только локальные углы освещения. Эффекты теней не учитываются.Выходные значения могут быть в диапазоне от 0 до 255, где 0 представляет самые темные области, а 255 – самые яркие.
  • SHADOWS В выходном растре с отмывкой учитываются локальные углы освещения и тени.Выходные значения могут быть в диапазоне от 0 до 255, где 0 представляет теневые области, а 255 – самые яркие.
Boolean
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

Выходной растр отмывки.

Растр отмывки содержит целочисленные значения в диапазоне от 0 до 255.

Raster

Пример кода

Отмывка. Пример 1 (окно Python)

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

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outHillShade = HillShade("elevation", 180, 75, "SHADOWS", 1)
outHillShade.save("C:/sapyexamples/output/outhillshd01")
Отмывка. Пример 2 (автономный скрипт)

В этом примере создается растр отмывки, включающий тени. Заданы определенные углы азимута и широты, также задан коэффициент z для конвертации z единиц из футов в метры.

# Name: HillShade_Ex_02.py
# Description: Computes hillshade values for a raster 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
inRaster = "elevation"
azimuth = 180
altitude = 75
modelShadows = "SHADOWS"
zFactor = 0.348

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

# Execute HillShade
outHillShade = HillShade(inRaster, azimuth, altitude, modelShadows, zFactor)

# Save the output 
outHillShade.save("C:/sapyexamples/output/outhillshd02")

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

Связанные темы

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

ArcGIS for Desktop Basic: Требует Дополнительный модуль Spatial Analyst или 3D Analyst
ArcGIS for Desktop Standard: Требует Дополнительный модуль Spatial Analyst или 3D Analyst
ArcGIS for Desktop Advanced: Требует Дополнительный модуль Spatial Analyst или 3D Analyst
6/5/2014