==========
   pg2d
==========

Written in C, and uses the PGPLOT and CFITSIO libraries.  It can be recompiled
by issuing 'make' on the command line in the directory after changing pg2d.c.

It takes a FITS file input and outputs a plot of it to the screen or any other
output PGPLOT is compiled to handle.  It takes three mandatory arguments

	pg2d INPUT IMGXFER(0 to 2) COLOR(-6 to 6)

where:
	INPUT is the input FITS file
	INGXFER is an integer from 0 to 2 that sets the image transfer function
		0 = linear scaling
		1 = logarithmic scaling
		2 =  square root scaling
	COLOR is an integer from 1 to 6 that sets the colormap
        1 = Grey
		2 = Rainbow
		3 = Heat (Orangeish)
        4 = Cool (Blueish)
		5 = IRAF
		6 = AIPS
		Negative values will invert the colormaps

Typing pg2d on its own will give a helpful reminder of what's necessary.

It also takes a number of additional options that can be added AFTER the first
three mandatory options, in any order.  They are:
	-f flips y axis
	-l supresses plot labels (ALL of them)
	-n supresses axis number labels
	-p forces coordinates to be in pixel space
	-s supresses color scale wedge

WCS information is somewhat read in but is not well handled at the moment.
'-p' is a helpful switch that will force working in pixel space only.  Pixel
space is defined as (0,0) being in the lower left of the image.  There are an
additional set of options that require a specific format, mainly:
	-r=NNNN,NNNN defines color scaling limits (Floats OK)
	-x=NNNN,NNNN defines x window, in PIXEL COORDINATES ONLY
	-y=NNNN,NNNN defines y window, in PIXEL COORDINATES ONLY

Not using '-r=...' will always report to STDOUT the range values found
automatically.