03/29/2001

		NOAO Deep Wide-Field Survey Support Tasks
		-----------------------------------------

	The NDWFS archive server machine relies on a web-based interface to
the IRAF CUTOUT task for creating on-the-fly FITS images of small regions
around points of interest in the survey data.  Details about this facility
and other client access options may be found at

	http://archive.noao.edu/ndwfs/data-cutout.html

NOAO users and the survey team can access these cutout images using the
web interface or the NDWFSGET task as part of the internal package used for
reducing the survey data.  For collaborators of the NDWFS or others who 
might find this facility useful we are also releasing the tasks for personal
use, a more extensive catalog-access and survey package is in preparation.

The tasks included with this release are:

    ndwfsget -- Extract FITS cutout images from the NDWFS survey
      cutout -- Extract FITS cutout images from a survey using WCS coords

The CUTOUT task is the low-level interface to the survey data, providing
one or more cutout images.  The NDWFSGET task is a higher-level task which
interfaces with the NDWFS archive server directly, providing a more con-
venient interface to the survey from an IRAF environment.

See below for installation instructions.  Users should contact IRAF site
support at iraf@noao.edu or 520/318-8160 with any problems or questions.


-------------------------------------------------------------------------------
First Release: March 29, 2001
-------------------------------------------------------------------------------


Installation Instructions


[1] To build the tasks, you must first download and unpack the source tafile
    in a directory someplace.  For example, if installing for general use at
    the site you might create a /iraf/extern/cutout directory, if this
    is for personal use then perhaps a 'cutout' sub-directory of your
    normal iraf login directory.  For this example we'll assume the tasks
    are being installed site-wide, so as the 'iraf' user:

	% mkdir /iraf/extern/cutout		# make the directory
	% cd /iraf/extern/cutout		# go there
        % ftp iraf.noao.edu (140.252.1.1)	# download the source tarfile
        login: anonymous
        password: [your email address]
        ftp> cd iraf/extern
        ftp> get cutout.readme
        ftp> binary
        ftp> get cutout.tar.Z
        ftp> quit
        % uncompress cutout.tar.Z		# uncompress tar file
        % tar -xvf cutout.tar			# unpack the tar file

    The cutout.readme file contains these instructions and any post-release
    information.

[2] The next step is to build the executable.  As the 'iraf' user the
    proper environment is usually defined already, but as any other user
    you must first define something like

	% setenv iraf /iraf/iraf/		# trailing '/' required
	% source $iraf/unix/hlib/irafuser.csh	# pick up other use definitions
	% setenv IRAFARCH ssun			# set system architecture

    The to build the executable simply issue the command:

	% mkpkg

    Note that the `iraf' and `IRAFARCH' definitions above must be correct
    for your system.  If you are unsure of the values you can do a
    "show iraf" and "show arch" command in the CL to check (the 'arch' 
    value will include a leading '.' which should NOT be used in the IRAFARCH
    definition).

[3] The x_cutout.e binary should now be built and contains both the CUTOUT
    and NDWFSGET tasks.  To use these they must first be declared as tasks
    in the system.  This can be done in one of two ways:

    a)  For a site-wide definition the 'iraf' user would declare the task
 	in the hlib$extern.pkg file as something like

	    task cutout 	= /iraf/extern/cutout/x_cutout.e
	    task ndwfsget 	= /iraf/extern/cutout/x_cutout.e

	The two tasks will then be visible from the top-level CL menu of
	packages.

    b)  For a private installation the same task declarations will need to		be made either in the login.cl or loginuser.cl file before the 
	final 'keep' statement.  If they are put in the loginuser.cl file
	the tasks will be part of the 'user' package.

[4] Help pages will not be installed as with normal external packages.  To
    view the documentation of either task one could simply:

	cl> cd /iraf/extern/cutout
	cl> help cutout.hlp file+		    # to view help page, or
	cl> help cutout.hlp file+ | lprint	    # make a hardcopy



This should complete the installation.   Please feel free to contact site
support (iraf@noao.edu) if you have any problems or questions with this
software or it's installation.