------------------------------------------------------------------------------
                                    PGSBOX
------------------------------------------------------------------------------
PGSBOX is a PGPLOT routine (FORTRAN) which draws and labels curvilinear
coordinate grids.  Example PGSBOX grids can be seen at

   http://www.atnf.csiro.au/~mcalabre/pgsbox.html

PGSBOX is provided as part of WCSLIB, available from

   ftp://ftp.atnf.csiro.au/pub/software/wcslib

mirrored at

   ftp://fits.cv.nrao.edu/fits/src/wcs.


Manifest
--------
   Makefile	GNU makefile for compiling PGSBOX.
   README	This file.
   pgsbox.f     PGSBOX source code.
   pgcrvl.f     PGCRVL, a driver routine for PGSBOX provided for backwards
                compatibility.

   pgwcsl.f     Subroutine PGWCSL defines an interface to WCSLIB for PGSBOX to
                draw celestial coordinate grids.
   pgcrfn.f     Subroutine PGCRFN defines separable pairs of non-linear
                coordinate systems for PGSBOX.  Linear, logarithmic and
                power-law axis types are currently defined.  Further types may
                be added as required.

   pgtest.f     Test and demo program and coding example.
   fscan.f      Defines a non-linear coordinate grid for PGTEST.
   lngvel.f     Defines a non-linear coordinate grid for PGTEST.


Usage notes
-----------
The prologue to pgsbox.f contains usage instructions.  pgtest.f serves as a
test and demonstration program and also as a well-documented example of usage.


Installation notes
------------------
A simple-minded GNU makefile is provided; GNU make must be used.  The makefile
compiles pgsbox.o as a dependency of PGTEST.  It assumes that the FORTRAN
version of WCSLIB has been installed as /usr/local/lib/libwcs_f.a.


Author
------
Mark Calabretta, Australia Telescope National Facility
mcalabre@atnf.csiro.au

$Id: README,v 1.2 2001/02/19 02:18:18 mcalabre Exp $
