Hillshade

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

Создает растровый объект трехмерного представления поверхности в оттенках серого с учетом расположения источника освещения и теней.

Обсуждение

Дополнительную информацию о работе этой функции см. в статье Отмывка.

Указанный набор растровых данных является временным для растрового объекта. Чтобы сделать его постоянным, вы можете вызвать метод растрового объекта save.

Синтаксис

Hillshade (dem, {azimuth}, {altitude}, {z_factor}, {slope_type}, {ps_power}, {psz_factor}, {remove_edge_effect}, {hillshade_type})

Параметр	Описание	Тип данных
dem	The input elevation raster.	Raster
azimuth	Азимут – это относительное положение источника освещения вдоль горизонта (в градусах). Это положение указано углом источника освещения, измеряемое по часовой стрелке с севера. Азимут 0 градусов указывает на север, 90 градусов – на восток, 180 градусов – на юг, 270 градусов – на запад. Этот параметр корректен только в тех случаях, когда для свойства hillshade_type задано значение TRADITIONAL. Значение по умолчанию – 315 градусов (с северо-запада). (Значение по умолчанию — 315)	Double
altitude	Высота – это угол превышения источника света над горизонтом в диапазоне от 0 до 90 градусов. Значение 0 градусов указывает, что источник освещения находится на горизонте, т.е. на той же горизонтальной плоскости, что и фрейм привязки. Значение 90 градусов указывает, что солнце находится прямо над головой. Этот параметр корректен только в тех случаях, когда для свойства hillshade_type задано значение TRADITIONAL. (Значение по умолчанию — 45)	Double
z_factor	The z-factor is a scaling factor used to convert the elevation values for the following purposes: Convert the elevation units (such as meters or feet) to the horizontal coordinate units of the dataset, which may be feet, meters, or degrees. Add vertical exaggeration for visual effect. If the x,y units and z units are in the same units of measure, the z-factor should be set to 1. The z-values of the input surface are multiplied by the z-factor when calculating the final output surface. (Значение по умолчанию — 1)	Double
slope_type	The inclination of slope can be output as either a value in degrees or percent rise. Specify one of the following: DEGREE, PERCENTRISE, or SCALED. For more information, see Slope function.	Integer
ps_power	Accounts for the altitude changes (or scale) as the viewer zooms in and out on the map display. It is the exponent applied to the pixel size term in the equation that controls the rate at which the z-factor changes to avoid significant loss of relief. This parameter is only valid when slope_type is SCALED. (Значение по умолчанию — 0.664)	Double
psz_factor	Accounts for changes in scale as the viewer zooms in and out on the map display. The value controls the rate at which the z-factor changes. This parameter is only valid when slope_type is SCALED. (Значение по умолчанию — 0.024)	Double
remove_edge_effect	Using this option will avoid any resampling of artifacts that may occur along the edges of a raster. The output pixels along the edge of a raster or next to pixels without a value will be populated with NoData. It is recommended that you use this option only when there are other rasters with overlapping pixels available. When overlapping pixels are available, these areas of NoData will display the overlapping pixel values instead of being blank. False—Bilinear resampling will be applied uniformly to resample the output. True—Bilinear resampling will be used to resample the output, except along the edges of the rasters or next to pixels of NoData. These pixels will be populated with NoData. This will reduce any sharp edge effects that may otherwise occur. (Значение по умолчанию — False)	Boolean
hillshade_type	Определяет источник освещения для отмывки. 0—Вычисляет отмывку с использованием источника света из одного направления. Можно задать azimuth и altitude, чтобы контролировать местоположение источника света. 1—Комбинирует свет из нескольких источников, чтобы улучшить визуализацию рельефа. (Значение по умолчанию — 0)	Integer

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

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

Пример кода

Hillshade пример 1

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

from arcpy.ia import *
out_hillshade_raster = Hillshade("elevation.tif", 180, 75, 0.3048)
out_hillshade_raster.save("C:/arcpyExamples/outputs/hillshade.tif")

Hillshade пример 2

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

# Import the system modules
import arcpy
from arcpy.ia import *

# Set the analysis environments
arcpy.env.workspace = "C:/arcpyExamples/data"

# Set the local variables
in_dem = "elevation.tif"

# Execute the Hillshade function
out_hillshade_raster = Hillshade(in_dem, 180, 75, 0.3048)

# Save the output
out_hillshade_raster.save("C:/arcpyExamples/outputs/hillshade.tif")