16.27. hillshadeΒΆ

The hillshade tool reads in a DEM and outputs an image of that DEM as though it were a three-dimensional surface, with every pixel shaded as though it were illuminated by a light from a specified location.


hillshade -a 300 -e 30 dem.tif -o hillshaded.tif

See an illustration in Section 6.2.6.

View these side-by-side with stereo_gui (Section 16.67):

stereo_gui dem.tif hillshaded.tif

Command-line options for hillshade:

--input-file <filename>

Explicitly specify the input file.

-o, --output-file <filename>

Specify the output file.


Azimuth is relative to geographic East, not +x in the image.

-a, --azimuth <number-in-degrees (default: 300)>

Sets the direction that the light source is coming from (in degrees). Zero degrees is to the right, with positive degrees counter-clockwise.

-e, --elevation <number-in-degrees (default: 20)>

Set the elevation of the light source (in degrees).

-s, --scale <arg (default: 0)>

Set the scale of a pixel (in the same units as the DTM height values).

--nodata-value <arg>

Remap the DEM default value to the min altitude value.

--blur <arg>

Pre-blur the DEM with the specified sigma.

--threads <integer (default: 0)>

Select the number of threads to use for each process. If 0, use the value in ~/.vwrc.

--cache-size-mb <integer (default = 1024)>

Set the system cache size, in MB.

--tile-size <integer (default: 256 256)>

Image tile size used for multi-threaded processing.


Tell GDAL to not create bigtiffs.

--tif-compress <None|LZW|Deflate|Packbits (default: LZW)>

TIFF compression method.

-v, --version

Display the version of software.

-h, --help

Display this help message.