AIPS HELP file for SHADW in 31DEC24

As of Wed Oct 9 3:38:19 2024

INPUTS

INNAME                             Input image name (name)
INCLASS                            Input image name (class)
INSEQ             0.0     9999.0   Input image name (seq. #)
INDISK            0.0        9.0   Input image disk unit #
OUTNAME                            Output image name (name)
OUTCLASS                           Output image name (class)
OUTSEQ           -1.0     9999.0   Output image name (seq. #)
OUTDISK           0.0        9.0   Output image disk unit #.
BLC                                Bottom left corner of input
TRC                                Top right corner of input
CPARM                              1) sun's azimuth (deg)
                                   2) sun's elevation (deg)
                                   3) surface height scale
                                      factor
                                   4) relative shade brightness

HELP SECTION

SHADW
Task:  Generates the "shadowed" representation of an image.

       Images of up to 1024*1024 pixels (aggregate), can be
       handled.  However, the maximum dimension must not exceed
       4096 pixels.

       The algorithm employs both shadowing and reflectance.

Adverbs:
  INNAME.....Input image name (name).       Standard defaults.
  INCLASS....Input image name (class).      Standard defaults.
  INSEQ......Input image name (seq. #).     0 => highest.
  INDISK.....Disk drive # of input image.   0 => any.
  OUTNAME....Output image name (name).      Standard defaults.
  OUTCLASS...Output image name (class).     Standard defaults.
  OUTSEQ.....Output image name (seq. #).    0 => highest unique.
  OUTDISK....Disk drive # of output image.  0 => highest disk
             number with sufficient space.
  BLC........Bottom right corner in input image of desired
             subimage.  Default is entire image.
  TRC........Top right corner in input image of desired
             subimage.  Default is entire image.
  OPCODE.....User specified operation code.
  CPARM......Control parameters:
             1) the sun's azimuth, in degrees, measured
                anticlockwise from due south (S=0, E=90, N=180,
                W=270 or -90).  Integral multiples of 45 degrees
                provide an exact interpolation and are therefore
                preferred.  Azimuths between -45 and +45 degrees
                will produce faster execution times on machines
                with limited real memory.
             2) the sun's elevation, in degrees, 0 -> 45.
             3) scale factor for the pixel height.  The scaling
                is done in such a way that the peak pixel will
                have this value.  Increasing this will increase
                the shadow lengths.  0 -> 100.
             4) relative shade brightness, used to put texture
                into the shadows.  Use a value between 0 and 1,
                0 gives inky black shadows, 1 removes shadows
                entirely.  A good value is 0.75.

EXPLAIN SECTION