INSTALLATION INSTRUCTIONS
=========================

As seen below there are three different ways to install PyMidas:
as rpm package (requires root access) or as tar package with or without root access.
The latter (tar package without root access) should be preferred.


Requirements
============

PyMidas requires following supporting packages.
If you don't have them installed we suggest you follow the order in which they are listed below.
- Midas 05SEP-pl1.1 or later (for installation see below)
- Readline (the platform must support readline)
- Python - v2.3 or higher (with readline module enabled)
- Distutils (http://www.python.org/sigs/distutils-sig/download.html)

Some platforms have most of these packages already installed in their system directories.
To test whether your Python installation has all modules needed, start Python and try to import them (e.g. import readline).
If you don't get an ImportError, this means that readline and distutils are already installed on your system.
Distutils is normally part of Python development package.


Install as rpm package (only for Fedora Core 2/3 and Enterprise Linux 4 with Python 2.3)
========================================================================================

Installing rpm package has been successfully tested in environment in mentioned in the title above.
Installing rpm package requires root access.
1) PyMidas cannot be installed in system unless MIDAS version 05SEP-pl1.1 or later is available.
   So if needed download unofficial package of MIDAS
   http://www.eso.org/sampo/pymidas/midas-local-05SEP-pl1.1.i386.rpm
   Next install MIDAS. Open new shell and login as root.
   > cd <your download directory>
   > su
   > rpm -i midas-local-05SEP-pl1.1.i386.rpm

2) Download PyMidas
   http://www.eso.org/sampo/pymidas/pymidas-1.0.3-1.i386.rpm

3) Install PyMidas. If not already done in step 1) open new shell and login as root.
   > cd <your download directory>
   > su
   > rpm -i pymidas-1.0-3.i386.rpm

4) Run PyMidas with command 'pymidas' in the new shell you opened in step 1) or 3).


Install as tar package with root access
=======================================

1) PyMidas cannot be installed in system unless Midas version 05SEP-pl1.1 or later is available.
   So if needed download unofficial package of MIDAS
   http://www.eso.org/sampo/pymidas/midas-05SEP-pl1.1.tar.gz

2) Download PyMidas
   http://www.eso.org/sampo/pymidas/pymidas-1.0.3.tar.gz

3) Login as root
   > su

4) Set the following environment variables.
   - MIDASHOME=/usr/local/midas or any place Midas is installed
   - MIDVERS=05SEPpl1.1
   - LD_LIBRARY_PATH = $MIDASHOME/$MIDVERS/lib
   Example: to set an environment variable in tcsh shell, type the following command:
   > setenv LD_LIBRARY_PATH $MIDASHOME/$MIDVERS/lib

5) Follow applicable parts of MIDAS installation instructions
   http://www.eso.org/projects/esomidas/doc/install/installunix/installunix.html 

6) Unpack the installation package and login as root
   > tar -zxvf pymidas-1.0.3.tar.gz
   > su
   > cd pymidas-1.0.3

7) For extra installation options type
   > python setup.py -help

   Default installaton locations are:
   /usr/bin/pymidas --> python PyMidas execute script
   <default python site-packages>/pymidas --> site packages

8) Install PyMidas in default directory
   > python setup.py install

9) Run PyMidas
   > pymidas


Install as tar package without root access
==========================================

1) PyMidas cannot be installed in system unless Midas version 05SEP-pl1.1 or later is available.
   So if needed download unofficial package of MIDAS
   http://www.eso.org/sampo/pymidas/midas-05SEP-pl1.1.tar.gz

2) Download PyMidas
   http://www.eso.org/sampo/pymidas/pymidas-1.0.3.tar.gz

3) Set the following environment variables
   MIDASHOME=/home/xxxx /midas or any place Midas is installed
   MIDVERS=05SEPpl1.1
   LD_LIBRARY_PATH = $MIDASHOME/$MIDVERS/lib
   Example: to set an environment variable in tcsh shell, type the following command:
   > setenv LD_LIBRARY_PATH $MIDASHOME/$MIDVERS/lib

4) Follow applicable parts of MIDAS installation instructions
   http://www.eso.org/projects/esomidas/doc/install/installunix/installunix.html

5) Unpack the installation package
   > tar -zxvf pymidas-1.0.3.tar.gz
   > cd pymidas-1.0.3

6) For extra installation options type
   > python setup.py -help

7) Install PyMidas in your own directory instead of default directory
   > python setup.py install --local=/home/xxxx/mydir

8) Run PyMidas
   > setenv PYTHONPATH /mydir
   > /home/xxxx/mydir/pymidas/pymidas
   Note that the syntax is really this. So if mydir=pymidas you run PyMidas with
   > /home/xxxx/pymidas/pymidas/pymidas