AIPS NRAO AIPS HELP file for HISEQ in 31DEC24



As of Tue Apr 23 6:59:05 2024


HISEQ: Translates image intensities by histogram equalization

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
PIXRANGE                           Range of input intensities
                                   to include
NBOXES            0.0     1000.0   Number of intensity intervals
                                   used on output.  0 => 1000
DOHIST           -3.0        1.0   >0 => record intensities in
                                   history file

HELP SECTION

HISEQ
Task:  This task converts an image from regular units to a histogram
       equalized form.  The output image will have a flat histogram in
       the range 0 to 1.  NOTE: this operation is not linear and hence
       the output intensities no longer have physical meaning.
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.
  PIXRANGE...Range of image intensities to include; those below or equal
             PIXR(1) are assigned -0.5/NBOXES and those above or equal
             PIXR(2) are assigned 1 + 0.5/NBOXES on output.  NOTE:
             PIXR(1) and PIXR(2) are not included in the histogram.
             This is to avoid a pure zero background (for example)
             altering the remaining histogram.  The default is lowest to
             highest value in the image.  If you wish those pixels to be
             included in the histogram, then set PIXR(1) slightly less
             than the lowest and PIXR(2) slightly  greater vthan the
             highest.
  NBOXES.....Number of intensity intervals used: 10 - 1000.  0 => 1000.
  DOHIST.....>0 => record the peak intensity of each box Warning - this
             will generate a lot of history entries.

EXPLAIN SECTION


AIPS