Installation Instructions for the GTCMOS Package

Installing GTCMOS 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 

[1] Download the GTCMOS tar format archive (e.g. gtcmos_v1.3_15032016.tar.gz) onto your 
host machine.

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

[3] # cd /iraf/iraf/extern
    # tar zxvf /path/gtcmos_v1.3_15032016.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 GTCMOS installed, it is recommended that you delete/change the name of the directory.
    ### e.g. cd /iraf/iraf/extern 
    ### \rm -R gtcmos   or  mv gtcmos gtcmos_old 

[4] You can now use gtcmos under cl by just typing
    cl> gtcmos
    gtcmos> 

 Conda installation 

[1] Download the GTCMOS tar format archive (e.g. gtcmos_v1.4_04082016.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/gtcmos_v1.4_04082016.tar.gz    [make sure you have the right path and the filename]

    ### Note: if you have an earlier version of GTCMOS installed, it is recommended that you delete/change the name of the directory.
    ### e.g. cd miniconda3/envs/iraf27/iraf_extern 
    ### \rm -R gtcmos   or  mv gtcmos gtcmos_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 gtcmos = /HOME/USR/miniconda3/envs/iraf27/iraf_extern/gtcmos/
task gtcmos.pkg = gtcmos$gtcmos.cl
reset helpdb= ( envget("helpdb") + ",gtcmos$lib/helpdb.mip" )
reset aproposdb= ( envget("aproposdb") + ",gtcmos$lib/apropos.db" )
 

[5] You can now use gtcmos under cl by just typing
    cl> gtcmos
    gtcmos> 

Updated 2 Nov 2020 by ydm @ inaoep.mx