Raster Hillshade

Open Table of Contents ToolBox Implementation
Calculates the shading of a terrain raster based on user defined position of the light source (The Sun). The position of the light source is defined with Azimuth (0 to 360) and Altitude (0 to 90). The combination of the Hillshade overlaid with a semi-transparent elevation raster gives more realistic look of the terrain (see example below).

Read more about Hillshade and its importance here.

Inputs:

  • Input raster dataset
  • Output raster name and format
  • Light azimuth (0 to 360)
  • Light altitude(0 to 90)

Output:

  • A floating point raster.

Example:

Source elevation raster

Result Hillshade raster

Elevation raster (50% transparency) over the Hillshade raster

Notes:

  • Initially the name of the output raster defines the raster format
    • no extension specified - ESRI binary GRID
    • .img extension (for example raster1.img) - ERDAS IMAGINE image.
    • .tif extension (for example raster1.tif - Tagged Image File Format (TIFF) image.
  • The initial output raster format can be changed by selecting the desired output in the dialog.
  • Currently only file based rasters are supported. Rasters cannot be stored in a GeoDatabase. After you get the desired result, you can export the raster to a GeoDatabase using the standard ArcGIS tools.
  • The input raster must be in a projected coordinate system.

ToolBox implementation

Command line syntax

ETS_GPRasterHillshade <Input Raster>  <Out Raster> {Light Azimuth} {Light Altitude}

Parameters

Expression Explanation
<Input Raster> A Raster dataset or Raster layer
<Out Raster> A String - the full name of the output raster (A raster with the same full name should not exist). The output raster type depends on the extension of the output file(see Notes above)
{Light Azimuth} A Double representing azimuth of the light source (0 to 360). 0 indicates North, 90 - East, 180 - South, 270 - West
{Light Altitude} A Double representing the altitude of the light source  in degrees (0 to 90)

Scripting syntax

ETS_GPRasterHillshade  (Input Raster,  Out_Raster, Light Azimuth, Light Altitude)

See the explanations above:
<> - required parameter
{} - optional parameter

All ESRI products mentioned are trademarks of Environmental Systems Research Institute, Inc.
Copyright: Ianko Tchoukanski