Instructions for the installation of the PySALT package are below. In order to install PySALT, several other packages have to be installed as well including python, PyRAF, and IRAF. Descriptions and links to each of those packages are included under dependencies. All of the dependent programs are available on the SALT ftp site. If you are downloading the package from outside South Africa, it is suggested that the dependencies be downloaded from their original source.
Installation of the PySALT external package V0.47
-------------------------------------------------
[0] This package requires IRAF version 2.12.2 or later, Pyraf version 1.7
or later and the PyQt4 GUI toolkit.
[1] The package is distributed via the SALT web pages, see
http://www.salt.ac.za
The README file contains these instructions.
[2] To install the package as root, create a directory to contain the
PySALT external package files. This directory should be outside
the IRAF directory tree and must be owned by the IRAF account. In
the following example, this root directory is named
/iraf/extern/pysalt/ (UNIX and Linux). Make the appropriate file
name substitutions for your site.
[a] 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 /iraf/iraf/unix/hlib/
Define the environment variable salt to be the pathname to the salt
root directory. UNIX pathnames must be terminated with a '/'.
Edit extern.pkg to include:
reset pysalt = /iraf/extern/pysalt/
task pysalt.pkg = pysalt$pysalt.cl
Near the end of the hlib$extern.pkg file, update the definition of helpdb
so it includes the salt help database, copying the syntax already used
in the string. Add this line before the line containing a closing quote:
,pysalt$lib/helpdb.mip\
[b] Change directories to the PySALT root directory created above
and unpack the download file pysalt.tar.gz
% cd /iraf/extern/
% tar zxvf <path>/pysalt.tar.gz
where <path> is the relative path from /iraf/extern/pysalt to the
downloaded file.
[4] To install the package under your home directory, unpack the
downloaded file pysalt.tar.gz. Then add the following line to your
loginuser.cl:
reset pysalt = "[your path]"
task pysalt.pkg = "pysalt$pysalt.cl"
reset helpdb = (envget("helpdb") // ",pysalt$lib/helpdb.mip")
[5] (Optional) build the HTML documentation.
Make sure you have Sphinx installed and run.
% cd /iraf/extern/pysalt/doc/
% make html
Then point your webbrowser to:
/iraf/extern/pysalt/doc/build/html/index.html
[6] Please use the SALT help desk for submitting questions:
salthelp@salt.ac.za