Installation Instructions for the CALYPSO Package

A prototype IRAF calypso data reduction package, CALYPSO, is now available.
Currently this package provides tasks for bias subtracting and trimming of
Calypso Telescope images as well as for the creation of a normalized flat
field image, and for applying this normalized flat to object frames.  In
addition, a calling script is provided to perform these operations on up
to four sets of images.  There is also a task to create a reduction script
to archive what was done and allow the process to be re-done if needed.
Additional functionality will be added to the CALYPSO package in time.

The installation instructions that follow assume that you have copied the
tar format CALYPSO archive onto your host machine.  The method you use to
copy the file (or remotely access the tar file) is OS dependent and is not
discussed in this document.  If you have any questions, please contact the
CALYPSO group at info@calypso.org.

[1] The package is distributed as a gzipped tar archive; IRAF is distributed
    with a tar reader.  The tar archive may be obtained via the Calypso 
    Telescope Documentation web pages found at:

	URL: http://www.calypso.org

    The calypso.readme file contains these instructions.  Use 'gunzip' to
    uncompress the tar archive after you have downloaded it.

[2] Create a directory to contain the CALYPSO external package files.  This
    directory should be outside the IRAF directory tree and must be owned
    by the IRAF account.  In the following examples, this root directory is
    named usr1:[calypso] (VMS) or  /local/calypso/ (UNIX).  Make the
    appropriate file name substitutions for your site.

[3] Log in as IRAF and edit the extern.pkg file in the hlib$ directory to
    define the package to the CL.  From the IRAF account, outside the CL,
    you can move to this directory with the commands:

	$ set def irafhlib	# VMS example
	% cd $hlib		# UNIX example

    Define the environment variable calypso to be the pathname to the
    calypso root directory.  The '$' character must be escaped in the VMS
    pathname; UNIX pathnames must be terminated with a '/'.  Edit
    extern.pkg to include:

	reset calypso	= usr\$1:[calypso]   	# VMS example
	reset calypso  = /local/calypso/	# UNIX example
	task  $calypso.pkg = calypso$calypso.cl

    Near the end of the hlib$extern.pkg file, update the definition of helpdb
    so it includes the calypso help database, copying the syntax already used
    in the string.  Add this line before the line containing a closing quote:
        
                ,calypso$lib/helpdb.mip\

    NOTE: In IRAF V2.8 the length of the helpdb string cannot exceede 160 
    characters.  A helpdb string longer than 160 characters will cause the
    CL startup process to fail.

[4] Log into the CL from the IRAF account and unpack the archive file.  Change
    directories to the CALYPSO root directory created above and use 'rtar':

	cl> cd calypso
	cl> softools
	cl> rtar -xrf <archive>  where <archive> is the full pathname of the
				 archive file (wherever you downloaded it).

   The archive file can be deleted once the package has been successfully 
   installed.

[5] Currently all the CALYPSO package tasks are scripts and so no bin
    directories are needed and no building is required.  You are done!