vheq(1)

PROGRAM
vheq - Performs histogram equalization of a BYTE grey-level image.

SYNTAX

vheq

-i  input image

-o  resulting output image

[-p]
    invert image

[-V]
    Gives the version for vheq

[-U]
    Gives the usage for vheq

[-P]
    Prompts for command line options

[-A [file1]]
    Creates the answer file called vheq.ans or file1

[-a [file1]]
    Uses vheq.ans or file1 as the answer file

DESCRIPTION
vheq performs a histogram equalization of the grey levels in a BYTE image. Histogram equalization is often useful in improving the appearance of an image that has poor contrast.

The output image can be inverted using the -p photonegative argument. This is useful when looking for faint features on a dark background, such as is often done with astronomical images.

REQUIRED ARGUMENTS

-i  type: infile
    desc: input image

-o  type: outfile
    desc: resulting output image

OPTIONAL ARGUMENTS

-p  type: boolean
    desc: invert image
    default: false

EXAMPLES
vheq -i moon.xv -o moon.heq.xv -p 1

will histogram equalize the image "moon.xv" and produce a photonegative output of that result in "moon.heq.xv".

SEE ALSO
intro(1), verror(3), vgparms(3), vutils(3), lvheq(3) vhstr(1)

RESTRICTIONS
vheq operates only on BYTE images.

COPYRIGHT
Copyright 1991, University of New Mexico. All rights reserved.