摘要
通过考虑光源位置和阴影来创建表面的灰度 3D 制图表达的栅格对象。
语法
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 two purposes:
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 the 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 the slope_type is SCALED. (默认值为 0.024) | Double |
remove_edge_effect |
Using this option will avoid any resampling artifacts that may occur along the edges of a raster. The output pixels along the edge of a raster or beside pixels without a value will be populated with NoData; therefore, it is recommended that this option be used 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) | Boolean |
hillshade_type | 用于控制山体阴影的光源。
(默认值为 0) | Integer |
数据类型 | 说明 |
Raster | 输出栅格。 |
代码示例
本示例将计算给定高程的山体阴影。
from arcpy.ia import *
out_hillshade_raster = Hillshade("elevation.tif", 180, 75, 0.3048)
out_hillshade_raster.save("C:/arcpyExamples/outputs/hillshade.tif")
本示例将计算给定高程的山体阴影。
# 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")