Installation Instructions for the INAOE Package

Installing INAOE pipeline requires just "untarring" the code in the extern directory of IRAF.
In the classical mode, IRAF is installed as root in the system directory, whereas the modern
conda installation is done as a user itself in your user directory. The main difference between
these two installations is the directory structure, especially the location and name of the external
package directory. Instructions for both kind of installations are given below.

Detailed instructions:
 Classical installation 

The installation instructions that follow assume that you have copied the
tar format INAOE archive onto your host machine. 

[1] The package is available at http://www.inaoep.mx/~ydm/inaoe_iraf_v1.tar.gz

[2] Login as root [or iraf] (in most systems use the command "su" or "sudo su")

[3] # cd /iraf/iraf/extern
    # tar zxvf /path/inaoe_iraf_v1.tar.gz    
              [make sure you have the right path and the filename]

    ### Note 1: if /iraf is not defined in your system, locate the 
                iraf root directory and establish a symbolic link as shown below
    ### Let us assume the iraf root directory is /home/iraf 
    ### ln -s /home/iraf  /iraf

    ### Note 2: if you have an earlier version of INAOE package installed, 
     it is recommended that you delete/change the name of the directory.
    ### e.g. cd /iraf/iraf/extern 
    ### \rm -R inaoe    or  mv inaoe inaoe_old 

 Conda installation 

[1] Download the INAOE tar format archive (e.g. inaoe_iraf_v1.tar.gz) onto your host machine.

[2] Locate your IRAF directory in the conda installation.
    It is usually miniconda3/envs/iraf27 in your home directory (you can find out
    the directory structure by typing "cd ctio" from the cl terminal, followed by "pwd")

[3] # cd miniconda3/envs/iraf27/iraf_extern
    # tar zxvf /path/inaoe_iraf_v1.tar.gz    [make sure you have the right path and the filename]

    ### Note: if you have an earlier version of INAOE installed, it is recommended that you delete/change the name of the directory.
    ### e.g. cd miniconda3/envs/iraf27/iraf_extern
    ### \rm -R inaoe or  mv inaoe inaoe_old

[4] Edit the miniconda3/envs/iraf27/extern.pkg and add carefully the following lines, preferrably
    near the end of the file (just follow the syntaxis of already defined external packages e.g. ctio.
    Replace /HOME/USR/ with your home directory path)

reset inaoe = /HOME/USR/miniconda3/envs/iraf27/iraf_extern/inaoe/
task inaoe.pkg = inaoe$inaoe.cl
reset helpdb= ( envget("helpdb") + ",inaoe$lib/helpdb.mip" )
reset aproposdb= ( envget("aproposdb") + ",inaoe$lib/apropos.db" )

You can now use inaoe under cl by just typing
    cl> inaoe 

     +-------------------- INAOE IRAF Package -------------------+
     |             Version 1.0, APR 24, 2016                     |
     |            Tested with IRAF v2.16 on Fedora               |
     |    Developed by Divakara Mayya at INAOE, Puebla, Mexico   |
     |                                                           |
     |    Type  help  before using it for the first time         |
     |                                                           |
     |                                                           |
     |Please contact ydm@inaoep.mx if you have questions/comments|
     +-----------------------------------------------------------+
 
      camila.  canica.  imanal.  misc.    osiris.  spanal.  

    inaoe> 

Updated 2 Nov 2020 by ydm @ inaoep.mx