Grayim

The program "grayim" will display grayscale pictures of WIRE images using PGPLOT routines.

Syntax: grayim ( (FITS file(s)) | list=(file with file list) ) [-invert] [ps=] [bg=] [fg=] [nh=] [nv=] [sf=] [box=i1,i2,j1,j2] [-int] [ch=] [nan=] [of=] [msf=]

list= : an ASCII file containing list of FITS files.
of= : output table file in PostScript format.
nan= : change any NANs to this value.
ps= : PostScript plot file.
bg= : Background level for grayscale stretch.
fg= : Foreground level for grayscale stretch.
nh= : Number of plots horizontally.
nv= : Number of plots vertically.
ch= : Show given channel.
box= : Show only this region of the image.
sf= : Scale factor for lettering on plot (default is 1).
-int : Ask for new levels after plotting (interactive).
-invert : Invert grayscale.
msf= : Multiple stretches (overrides fg=,bg=,nh=,nv=). If "default" then the default values are used, otherwise a file is read containing five pairs of numbers which are the percentiles for the stretches.

The option "msf=" is designed to display a single image with six different stretches on one display screen. "msf=default" will use the default set of values, or you can specify your own file. The stretches are given in terms of percentiles. The first stretch is always 1% to 99%. Your "msf=" file should contain five pairs of numbers on five lines. These numbers refer to percentages for the background limit and foreground limit of the grayscale. For example:
00.01 90.00
01.00 99.99
10.00 90.00
00.01 90.00
20.00 70.00
would give stretches of 0.01% to 90%, 1% to 99.99%, 10% to 90%, etc.