Section 4: LAYERED PACKAGES

What are layered or external packages?

 	Layered or external packages are IRAF software packages that are
"layered" on the distributed IRAF system.  You must first install IRAF and
be sure it is running properly.  Only then you can install any layered pack-
ages.  The layered packages use the full functionality and portability aspects
of IRAF, and are a straightforward way for 3rd party developers to develop
code within the IRAF environment.
	The NOAO package within the IRAF distributed system is really a layered
package and can be used by 3rd party developers as a template for software
development.
	Layered packages are also a convenient way for the IRAF project to
make new software available to our users before the next major release.  In
this way the software gets more extensive testing before being included in a
release while the users benefit from the new capabilities.

What layered packages are available? How do I get them?

 There are many layered packages available, ranging from very large packages
to those that are just a couple of tasks (the IRAF project sometimes exports
preliminary version of new software as layered software).
Here is a list of known layered packages from outside the IRAF project.
    STSDAS - the Space Telescope Science Data Analysis System consists of
        applications software, utility packages, and support software used to
        calibrate and analyze data from the Hubble Space Telescope.  Available
        from stsci.edu in the software/stsdas directory.
    TABLES - the STSDAS TABLES package, used for support of the TABLES format
        used by the STSDAS and PROS packages and NOAO.DIGIPHOT.  Distributed
        separately from STSDAS as of v1.3; available from stsci.edu in the
        software/stsdas directory.
    XRAY - the SAO Post-Reduction Off-line Software (PROS) package for analysis
        of reduced X-ray data.  The PROS software includes spatial, spectral,
        timing, data I/O and conversion routines, plotting applications and
        general algorithms for performing arithmetic operations with imaging
	data.  Available from sao-ftp.harvard.edu in the pub/pros directory.
    EUV - analysis software for data from the Extreme Ultraviolet Explorer.
        Available from cea-ftp.cea.berkeley.edu in the pub/software directory.
    FTOOLS - a collection of utility programs to create, examine, or
        modify data files in the FITS (Flexible Image Transport System) format.
        Available from legacy.gsfc.nasa.gov in the software/ftools/release
        directory.
    RVSAO - Harvard-Smithsonian CfA package for obtaining radial velocities
        from spectra.  Available from cfa-ftp.harvard.edu in the /pub/iraf
        directory.
    GRASP - a GONG Reduction and Analysis Software Package for the reduction and
        analysis of GONG data in particular and helioseismic imaging data in
        general.  Available from helios.tuc.noao.edu (140.252.8.105) in
        pub/gong/grasp_soft.
    CTIO - a collection of tasks developed and distributed by CTIO.  Available
        from iraf.noao.edu in the iraf/extern directory, see the ctio.readme
        file for installation instructions.
    MEM0C - Maximum Entropy Method Package for image restoration, developed
        by Dr. Nailong Wu. Available from iraf.noao.edu in the contrib
        directory.
Here is a list of layered packages distributed by the IRAF project.  All
of these packages are available in the iraf/extern directory on the node
iraf.noao.edu (140.252.1.1).  Each package has a [package_name].readme
file associated with it that provides installation instructions.
    ADCCDROM (31 March 1993) - a package containing tasks to read the ADC
	CD-ROM (text format) with a variety of sorting choices (you must have
	Volume 1 available and mounted somewhere in the IRAF network as a
	directory tree).   See adccdrom.readme.
    COLOR (14 March 1996) -  a prototype package for creating RGB composite
        images from IRAF images.  See color.readme.
    CRUTIL (v1.4, 06 Jan 2000) - Cosmic ray removal utility package.
    DIGIPHOTX (10 May 1999) - Current DIGIPHOT package software distributed as
	an external package for distributing bug fixes and for older platforms.
	See digiphotx.readme.
    DIGIPHOTX (10 May 1999) - a new version of the NOAO.DIGIPHOT package (that
	will be included in the next release of IRAF) that contains the DAOPHOT
	II algorithms, a new curve of growth task, several new tasks in the
	PTOOLSX package, and minor enhancements and bug fixes.
	See digiphotx.readme.
    ESOWFI (v1.1, 31 Jan 1999) - ESO WFI Mosaic reduction package.
    FINDER (v2.2, 11 Feb 2000) - Determine accurate positions for objects on
	CCD frames using the Space Telescope Guide Star Catalogue as reference
	stars.
    FITSUTIL (03 Dec 1999) - FITS file format utilities.
    FOCAS (03 Sep 1999) - the Faint Object Classification and Analysis System,
	for creating and manipulating catalogs of objects from digital
	astronomical images.  See readme.focas.  A separate FAQ is available
	for this package at in the iraf archive 'iraf/extern' subdirectory as
	focas.faq.
    GMISC (25 Jan 2000) - Contains the development versions of those Gemini
        reduction packages, scripts, and tasks written by the NOAO IRAF group.
    ICE (v1.8.1, 02 Feb 2000) - The IRAF Control Environment ccdacq package
	supports CCD data acquisition from within the IRAF environment.
    IFOCAS (17 Nov 1999) - IRAF faint object classification and analysis
	system.  Used to detect and catalog objects in images.
    IMCNV (20 Dec 1999) - Image conversion utilities, these tasks are all
	installed in V2.11.  See imcnv.readme.
    IMMATCHX (20 Dec 1999) - Image matching package, these tasks are all
	installed in V2.11.  See immatchx.readme.
    MFILTERS (18 Jul 1996) - Median/Modal Filtering package.  See
	mfilters.readme.
    MSCRED (v3.2.3, January 2000) - CCD mosaic reduction package.
    NMISC (v12-p6, 18 Jan 2000) - a selection of new NOAO tasks being made
	available prior to the next release.  The current tasks in this package
	are KPNOFOCUS, PSFMEASURE, SURFIT, SPECFOCUS, STARFOCUS, and XREGISTER.
    SPECTIME (v1.0, October 20, 1999) - Spectral exposure time calculator.
    SPPTOOLS (28 Oct 1995) - an ad hoc external package primarily of
	interest to IRAF developers working in SPP.  Various tasks in this
	package will print the calling sequences of procedures within tasks,
	format code according to accepted standards, create / query identifier
	databases, and create / rename external packages.  Of special interest
	is the spplint task that can be used to check the code for certain
	types of programming errors.
    VOL (22 Feb 1995) - a suite of prototype tasks used for volume rendering.
	See readme.vol.
Other software, not considered layered software, that the reader may
find useful is listed below.  These are available from iraf.noao.edu
in the named directory.
    SAOIMAGE - an X window system pseudocolor display program for greyscale
        images, developed originally by Mike VanHilst while at SAO.  Can be
        used standalone or as an image display server with IRAF.  See the
        saoimage.readme file for installation instructions.  Available from
	the iraf/contrib/saoimage directory with associated files, pre-compiled
	binaries for various architectures.
    CBIND.C - C bindings for IMFORT programming on Unix hosts. See the file
	cbind.readme, available from the iraf/misc directory as the file
	cbind.c, and ANSI C version is available as cbind.ansi.c.

How can I get the CTIO package?

 The CTIO package is available from the IRAF network archive.  Since this
is an layered package on IRAF you must have a running IRAF system before you
can install this package.
     % ftp iraf.noao.edu (or 140.252.1.1)
     ftp> log in as anonymous
     ftp> use your email address as the password
     ftp> cd iraf/extern
     ftp> binary
     ftp> get ctio.readme
     ftp> get ctio.tar.Z
     ftp> quit
Installation questions can be directed to http://iraf.net.

What is the STSDAS package? How can I get it?

 The STSDAS package is a science software package maintained and distributed
by the Space Telescope Science Institute and consists of applications software,
utility packages, and support software used to calibrate and analyze data from
the Hubble Space Telescope.  It is an layered package on the distributed IRAF
system, so you must have IRAF installed and running before you can install
STSDAS.  Note that STSDAS also requires the TABLES package.
The package is available by anonymous FTP to ftp.stsci.edu from the
/pub/software/stsdas directory or from our archive's /contrib directory.
Questions should be directed to help@stsci.edu.

I need the TABLES package. How can I get it?

 The STSDAS TABLES package, which supports the TABLES format used by
the STSDAS and PROS packages and IRAF.NOAO.DIGIPHOT, is distributed by the
Space Telescope Science Institute.  It is available separately from STSDAS
as of v1.3. This is an layered package on the distributed IRAF system so you
must have a running IRAF system before you can install TABLES.
TABLES is available from stsci.edu in the software/stsdas directory.  Questions
should be directed to help@stsci.edu.  Binaries of the latest version for
most architectures are available in the contrib directory.

What is PROS/XRAY package? How can I get it?

 XRAY is the SAO Post-Reduction Off-line Software (PROS) package for analysis
of reduced X-ray data.  The PROS software includes spatial, spectral, timing,
data I/O and conversion routines, plotting applications and general algorithms
for performing arithmetic operations with imaging data.
The package is available from sao-ftp.harvard.edu in the pub/pros directory.
Questions should be directed to hotseat@cfa.harvard.edu.

What is the EUV package? How can I get it?

 The EUV package is analysis software for data from the Extreme Ultraviolet
Explorer.  It is available from cea-ftp.cea.berkeley.edu in the pub/software
directory.  Questions should be directed to egoinfo@cea.berkeley.edu.

How can I contribute my own software to IRAF so others can use it?

 Users are encouraged to put their software in our ftp 'contrib' directory
for distribution to other users.  A 'readme' file describing what the
software is, how it's installed, and especially who to contact with
questions or problems should also be put in the directory with the same
name as the package itself.  New versions of the software can be installed
in the contrib directory at any time.  Alternatively, small programs, CL
scripts and such can be posted to the adass.iraf.sources newsgroup.
	We suggest that external packages be formatted as a standard layered
package, this will make it much easier for others to install and minimize
problems.  Users can create a new package by using any existing layered
package as a template and editing/renaming the appropriate files.  Feel
free to contact the IRAF group if you have any questions about how a package
is created or installed.