Installing WCSTools as an IRAF Package

To install WCSTools as a package in your local IRAF system, take the following steps:

The package is distributed as a compressed tar archive The tar archive may be obtained by anonymous ftp or http. The .readme file includes these installation directions.
To obtain the package via ftp click here or (assuming a UNIX computer), type the following commands:

	    % ftp cfa-ftp.harvard.edu
	    login: anonymous
	    password: [your user name]
	    ftp> cd pub/iraf
	    ftp> get wcstools-3.7.0.iraf.readme
	    ftp> binary
	    ftp> get wcstools-3.7.0.iraf.tar.gz
	    ftp> quit
	    % ls -l
	    -rw-r--r--  1 mink          xxxx xxx xx xx:xx wcstools-3.7.0.iraf.readme
	    -rw-r--r--  1 mink        xxxxxx xxx xx xx:xx wcstools-3.7.0.iraf.tar.gz

To obtain the package from our web server, click here

Create a directory to contain the WCSTools external package files. This directory may be outside the IRAF directory tree and must be readable by anyone who will need to use it in IRAF. In the following examples, this root directory is named /local/wcstools/. Make the appropriate file name substitutions for your site.
Log in as IRAF and edit the extern.pkg file in the iraf$unix/hlib directory to define the package to the CL. From the IRAF account, outside the CL, you can move to this directory with the command:
```
            % cd $hlib
```
Define the environment variable wcstools to be the pathname to the wcstools root directory. UNIX pathnames must be terminated with a '/'. Edit extern.pkg to include:
```
            reset wcstools	= /wcstools-3.7.0/
            task  wcstools.pkg	= wcstools$wcstools.cl
```
Near the end of the hlib$extern.pkg file, update the definition of helpdb so it includes the rvsao help database, copying the syntax already used in the string. Add this line before the line containing a closing quote:
```
 
	    ,wcstools$lib/helpdb.mip\
```

Add to hlib$clpackage.men the package description:

 
            wcstools - Utilities to manipulate FITS and IRAF image WCS

Unpack the tar file into the WCSTOOLS root directory. On a UNIX system, where ftpdir is the pathname of the directory into which the package was ftp'ed and irafpkg is the directory below which you wish to install wcstools
```
	    % cd /local
	    % zcat $ftpdir/wcstools-3.7.0.iraf.tar.gz | tar xvf -
	     (or maybe gzcat on a non-Linux system)
```
The archive file can be deleted once the package has been successfully installed.
If you already have WCSTools installed somewhere else on your system, simply cd to the new wcstools directory and
```
	    rm bin.[arch]
	    ln -s  bin.[arch]
```
for example
```
	    ln -s /usr/local/bin bin.solaris
```
Type "cl" or "ecl" to log in to IRAF and skip to step 10.
If you don't already have WCSTools installed on your system, continue.
Type "cl" or "ecl" to log in to IRAF, cd wcstools to get to the wcstools package directory.
To put compiled executables in the appropriate binary directory, type
```
	    ecl> mkpkg 
```
for the architecture of the computer you are using.
For Solaris, for example,
```
	    ecl> mkpkg ssun
```
or Red Hat Linux
```
	    ecl> mkpkg redhat
```
Make the package by typing
```
	    ecl> mkpkg update
```
If you want to support multiple architectures from the same IRAF, type
```
	    ecl> mkpkg clean
	    ecl> mkpkg 
	    ecl> mkpkg update
```
Report any compilation errors to dmink@cfa.harvard.edu
Type
```
	    ecl> wcstools
```
to load the package.
Type
```
	    ecl> help wcstools
```
to list all of the tasks available with brief descriptions. Some names have been modified to avoid clashes with commonly used IRAF tasks, such as delhead to dhead.
Help files only exist for some of the tasks. Typing a WCSTools task name with no arguments almost always generates a list of possible command line arguments with their descriptions. The task name followed by "help" *always* lists the options, and the task name followed by "version" lists the version number and date.
Almost-up-to-date hypertext help is available on the World Wide Web at http://tdc-www.harvard.edu/software/wcstools
Mail Doug Mink if you have any further questions.