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 an incremental release of the TABLES/STSDAS software. The source code and binaries for some supported architectures, of TABLES V2.3 can be found in the subdirectory tables_v2.3/. The source code and binaries, for STSDAS V2.3 can be found in the subdirectory stsdas_v2.3/. Source code distributions of older versions of TABLES/STSDAS, such as version 1.3, 2.0, 2.0.1, 2.0.2, 2.1, 2.1.1 and 2.2 can be obtained via anonymous ftp to ra.stsci.edu/pub/stsdas/ Please note that as of STSDAS 1.3, the tables routines have been totally removed and the sole source for those routines is in the TABLES external package. This means that you MUST have the TABLES external package (which MUST be the latest version number, which for STSDAS 2.3 is TABLES 2.3) installed and compiled first before you can compile STSDAS 2.3. **************************IMPORTANT!!!!!!!!********************************* NOTE: STSDAS 2.3 MUST BE COMPILED UNDER IRAF 2.11.1 or later. Earlier versions of IRAF will not work with this version. If you have an older version of IRAF, please download the STSDAS V1.3. If you do not have IRAF, or wish to upgrade your existing IRAF installation, you can get the software free from NOAO's anonymous ftp site at: ftp://iraf.noao.edu/iraf/v211 **************************************************************************** 2. Supported Architectures IRAF V2.11.3 and TABLES/STSDAS V2.3 are available for the following computer operating systems: Operating System {arch} ===================================== Sun Solaris 5.8 ssun Sun Solaris 5.5.1 ssun Sun Sparc 4.1.3 sparc Red Hat 6.1 redhat FreeBSD 2.2.5 freebsd Slackware 3.3 linux Digital Unix 4.0f alpha Digital Unix 5.0a alpha HU-UX B.10.20 hp700 SGI IRIX 6.5 irix 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://ra.stsci.edu/RegistForm.html 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_v2.3/source/ and stsdas_v2.3/source/ contain the source code. The source is available as compressed tar files and appear in 512 kbyte sections to avoid the hassles of having the file transfer die near the end of a long ftp session. Also, uncompressing the file locally will considerably shorten the time it takes to transfer the file. These files are named as follows: TABLES source: tables23.tar.Z.000 compressed form, part 1 0.5 MB tables23.tar.Z.001 compressed form, part 2 0.5 MB . . tables23.tar.Z.nnn compressed form, part n STSDAS source: stsdas23.tar.Z.000 compressed form, part 1 0.5 MB stsdas23.tar.Z.001 compressed form, part 2 0.5 MB . . stsdas23.tar.Z.nnn compressed form, part n You may also wish to compute the checksums on the files you've transferred in order to be sure nothing was corrupted in the transfer. The file CHECKSUMS has both Unix BSD and Sys V checksums for the files as they were computed at STScI. After you have transfered the 512 kb files, you can put them back together and unpack them using the standard Unix `cat', 'uncompress' and 'tar' commands: % cd /usr/local/tables % cat tables23.tar.Z.* | uncompress | tar -xvfp - % cd /usr/local/stsdas % cat stsdas23.tar.Z.* | uncompress | tar -xvfp - 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_v2.3/binaries/ and stsdas_v2.3/binaries/ contain sub-directories with the binaries for each supported architecture. The table in section 2 above gives the name of the sub-directory for your architecture. Download only the files for your architecture. The binaries are also available as a compressed tar files and appear in 512 kbyte sections to avoid the hassles of having the file transfer die near the end of a long ftp session. Also, uncompressing the file locally will considerably shorten the time it takes to transfer the file. These files are named as follows, substitute the mnemonic for your architecture for the word {arch}: TABLES binaries: tables23.bin.{arch}.tar.Z.000 compressed form, part 1 0.5 MB tables23.bin.{arch}.tar.Z.001 compressed form, part 2 0.5 MB . . tables23.bin.{arch}.tar.Z.nnn compressed form, part n STSDAS binaries: stsdas23.bin.{arch}.tar.Z.000 compressed form, part 1 0.5 MB stsdas23.bin.{arch}.tar.Z.001 compressed form, part 2 0.5 MB . . stsdas23.bin.{arch}.tar.Z.nnn compressed form, part n You may also wish to compute the checksums on the files you've transferred in order to be sure nothing was corrupted in the transfer. The file CHECKSUMS has both Unix BSD and Sys V checksums for the files as they were computed at ST STScI. After you have transfered the 512 kb files, you can put them back together and unpack them using the standard Unix `cat', 'uncompress' and 'tar' commands: % cd /usr/local/tables/bin.{arch} % cat tables23.bin.{arch}.tar.Z.* | uncompress | tar -xvfp - % cd /usr/local/stsdas/bin.{arch} % cat stsdas23.bin.{arch}.tar.Z.* | uncompress | tar -xvfp - 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 should 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 (InstallGuide.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.