Help for SHADY2

PURPOSE

SHADY2 shades a image as though it were being illuminated by a source
at a given azimuth and elevation.
EXECUTION

Example:
To shade the input image as though it were illuminated by a sun in the 
northeast at an elevation of 10 degrees above the horizon, enter

VICAR> SHADY2 inp=input.img out=output.img azimuth=45.0 elev=10.0
OPERATION

SHADY2 uses the four nearest neighbors around each pixel to compute a
local normal.  The cosine between this vector and the illumination
vector is computed and multiplied by SCALE to obtain the output DN.  The
subroutine STACKA is used to allocate buffers so that no size restrictions
exist.
HISTORY

Written by:  M.A. Girard, 25 July 1978
Cognizant programmer:  M. O'Shaughnessy

Revisions: 
J.H. Reimer, 10 April 1983  
	Original documentation
J.H. Reimer, 1 July 1985
	Converted to VICAR2 format
M. O'Shaughnessy, 9 October 1989
	Extended documentation, upgraded SHADY2 to r2lib, 
	wrote unit test procedure
Ron Alley, 7 February 2000
        Made BYTE the default output data format, with HALF optional.

PARAMETERS:


INP

Name of input image file

OUT

Name of output image file

SIZE

Standard VICAR size field

SL

Starting line

SS

Starting sample

NL

Number of lines

NS

Number of samples

OFORMAT

Output image format (BYTE or HALF)

AZIMUTH

Azimuth of light source

ELEV

Elevation of light source

SSCALE

Sample scale (ft/pixel)

LSCALE

Line scale (ft/pixel)

ZSCALE

Vertical scale (ft/dn)

SCALE

DN scale factor

See Examples:


Cognizant Programmer: