--------------------------------------------------------------------------------
         HOW SHOULD YOU INSTALL SQUV?

         by A. Sainz Dalda (asainz@themis.iac.es)
         November 2005 
--------------------------------------------------------------------------------

--- Introduction ---

SQUV is a set of procedures and functions written in IDL. They are given in a
tar-file. In this file there is EVERYTHING that the user needs. However, IDL has 
its own intrinsic procedures and functions, and maybe the behavior of a few
can change from one IDL version to other. In this case the only one possibility 
is to change the SQUV's source code, i.e. to change the original code of SQUV.

The SQUV procedures and functions have been tested in IDL 5.4, 5.6 and 6.0 using
Linux OS under Intel architecture. 


--- Installing SQUV ---

The tar-file is called all_reduction.YYYYMMDD.tar.

In your Linux prompt (hereafter '$>') type:

$> pwd                                          (1)
   anydirectory                                 (2) 
$> mkdir all_reduction                          (3)
$> cp all_reduction.YYYYMMDD.tar all_reduction/ (4)
$> cd all_reduction/                            (5)
$> tar xvf all_reduction.YYYYMMDD.tar .         (6)

(1) To know where you are
(2) Linux asnwers : anydirectory (e.g. /home, /scratch/themis)
(3) Create the SQUV directory (e.g. all_reduction)
(4) Copy tar-file to the SQUV directory
(5) Change to SQUV directory
(6) Unpack the tar-file

That's all!!!


--- Starting SQUV ---

The user has three possibilities

I) Under IDL session ('idl>' means the IDL session prompt)

$> idl                                          (1)
idl> !path='anydirectory/all_reduction/'        (2)
idl> iu_red                                     (3)

(1) Start the  IDL session from Linux prompt. You can start the IDL
in any directory, it is NOT necessary to be at the SQUV directory.
(2) Set the IDL path, e.g. 'anydirectory/all_reduction/'. In this way,
IDL uses ONLY the procedures and routines found in this directory
 and, of course,  its own intrisic procedures and routines.
(3) Start the reduction user interface, i.e. the SQUV Graphic User
Interface.


II) From the Linux prompt

$> more start_squv                               (1)    
   !path='/home/asainz/all_reduction/'
   iu_red
   exit
$> vi start_squv                                 (2)
$> more start_squv                               (3)
   !path='/anydirectory/all_reduction/'
   iu_red
   exit
$> idl start_squv                                (4)

(1) Check the start_squv file.
(2) Maybe the user have another SQUV directory, hence
s/he has to change the start_squv file using an editor.
(3) Check the start_squv file again.
(4) Start start_squv in IDL session.


III) Another possibility is to put the SQUV icon in the user's 
desktop.

$> cd /anydirectory/all_reduction/               (1)
$> more SQUV.desktop                             (2)
   [Desktop Entry]
   Comment=
   Comment[es]=
   Encoding=UTF-8
   Exec=idl  ~/all_reduction/start_squv          (2.1)
   GenericName=SPTOOLS
   GenericName[es]=SPTOOLS
   Icon=/home/asainz/all_reduction/SQUV_icon.png (2.2)
   MimeType=
   Name=SQUV
   Name[es]=SQUV
   Path=
   ServiceTypes=
   SwallowExec=
   SwallowTitle=
   Terminal=false
   TerminalOptions=
   Type=Application
   X-KDE-SubstituteUID=false
   X-KDE-Username=
$> vi SQUV.desktop                               (3)
$> cp SQUV.desktop ~/Desktop/                    (4)

(1) The SQUV.desktop and SQUV's icon is given with the 
SQUV tar-file.
(2) Maybe the user wants to check the executable command (2.1)
and the icon path (2.2)
(3) Change these values with your prefered editor
(4) Copy SQUV.desktop to Desktop directorey (usally /home/username/Desktop)

Maybe user has to restart his/her session.
Click on the SQUV icon and enjoy it!!