TABLES and STSDAS Installation Instructions

1. Introduction
2. Supported Architectures
3. Preparing the Top Level TABLES or STSDAS directory
4. Unpacking the Source Code
5. Unpacking the Binaries
6. Creating the bin Link
7. For More Information


1. Introduction

  This directory contains subdirectories for release versions of the TABLES and
STSDAS (Space Telescope Science Data Analysis System) software.  STSDAS is 
layered on the IRAF data analysis package and is used to analyse data from the 
Hubble Space Telescope.  The TABLES package is also an IRAF external package 
that contains tasks that utilize the STSDAS table format. This is a new 
 release of the TABLES/STSDAS software. 

The source code and binaries for some supported architectures, of TABLES V3.3
can be found in the subdirectory tables_v3.3/.  The source code and binaries,
for STSDAS V3.3 can be found in the subdirectory stsdas_v3.3/.  Source code 
distributions of older versions of TABLES/STSDAS can be obtained from
http://stsdas.stsci.edu/old_versions.html

You MUST have the TABLES external package (which MUST 
be the same version number as for STSDAS ) installed 
and compiled first before you can compile STSDAS v3.3.  

**************************IMPORTANT!!!!!!!!*********************************
NOTE:  STSDAS 3.3 MUST BE COMPILED UNDER IRAF 2.12 or later.  Earlier 
versions of IRAF will not work with this version. If you do not have IRAF, 
or wish to upgrade your existing IRAF installation, you can get the software 
free from NOAO's web site at: http://iraf.noao.edu/.
****************************************************************************

2. Supported Architectures

TABLES/STSDAS V3.3 are available for all IRAF architectures in source form but
binaries were built for the following computer 
operating systems:

Operating System        {arch}
=====================================
Sun Solaris 5.8 	ssun
Red Hat 7.3             redhat 	
MacOS X	10.3.5		macosx

If you do acquire a copy of our code via anonymous ftp, would you take a moment
to fill out the registration form at http://www.stsci.edu/resources/software_hardware/stsdas/STSDASRegistrationForm
so that we might have a record of your getting STSDAS?  This helps greatly in 
justifying our existence when budget negotiations happen.

3. Preparing the Top Level TABLES or STSDAS directory

Create directories to contain the TABLES and STSDAS external package files.  
The directories should be outside the IRAF directory tree and must be owned
by the IRAF account.  In the following examples, the root directories are 
named /local/tables/ and /local/stsdas/ (UNIX).  Make the appropriate filename 
substitutions for your site.

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:

	% cd $hlib		# UNIX example

Define the environment variable tables to be the pathname to the tables
root directory.  UNIX pathnames must be terminated with a '/'.  
Edit extern.pkg to include:

	reset tables     = /local/tables/		# UNIX example
	task  tables.pkg = tables$tables.cl

	reset stsdas     = /local/stsdas/		# UNIX example
	task  stsdas.pkg = stsdas$stsdas.cl

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

4. Unpacking the Source Code

The sub-directories tables_v3.3/source/ and stsdas_v3.3/source/ contain 
the source code. 

The source is available as a compressed tar file.  

After you obtain the files, unpack them in the tables and stsdas directories:

	% cd /usr/local/tables
	% gunzip tables33.tar.gz
	% tar -xvfp tables33.tar 
	% cd /usr/local/stsdas
	% gunzip stsdas33.tar.gz
	% tar -xvfp stsdas33.tar


5. Unpacking the Binaries

You must have defined the top-level directories and installed the source code
as outlined in steps 3 and 4 above before installing the binaries.

The sub-directories tables_v3.3/binaries/ and stsdas_v3.3/binaries/ contain 
compressed tar files with binaries for each supported architecture. 
Download only the files for your architecture.

Use the following commands to unpack them in the bin.{arch} directory, where 
{arch} is on of the supported architectures, mentioned above. 

	% cd /usr/local/tables/bin.{arch}
	% gunzip tables33.bin.{arch}.tar.gz
	% tar -xvfp tables33.bin.{arch}.tar
	% cd /usr/local/stsdas/bin.{arch}
	% gunzip stsdas33.bin.{arch}.tar.gz
	% tar -xvfp stsdas33.bin.{arch}.tar

Once the binaries are in place you can delete the tar files to save space, and
the STSDAS package is ready to be run.

6. Creating the bin Link

If you are going to link against the STSDAS libraries, you should unpack the
libraries found in bin.ssun/OBJS.arc.Z by typing the following:

	% cd /usr/local/tables
	% mkpkg {arch}
	% cd /usr/local/stsdas
	% mkpkg {arch}

This will change the architecture from "generic" to {arch}.

7. For More Information

If you have any questions or problems while installing TABLES or STSDAS, or
if you are compiling the binaries from scratch, please refer to the 
"STSDAS Site Manager's Installation Guide and Reference" available as a 
postscript file (install_guide.ps) in the docs/ directory.

Help is also available from the STScI Help Desk, e-mail help@stsci.edu,
telephone (410)338-1082.  When sending e-mail please include in your message:

	1) The Operating System and Architecture of your computer
	2) The version of IRAF you have installed 
	3) The version of TABLES/STSDAS you are installing.