So you want to do this at home


1. On Santa Barbara Street
2. Elsewhere
3. Undating from previous versions

On Santa Barbara Street


The COSMOS software is installed on pavo, and should be usable from any machine running linux Redhat 9. valpariaso is configured for this, and can be used if your own machine is unsuitable.

Before running any programs, you must do the following:


 The documentation is available locally at www.ociw.edu/~oemler/COSMOS.html.


Elsewhere

Congratulations! You are a pioneer, one of the first to try this.

A gzipped tarfile containing the COSMOS distribution may be downloaded from HERE. This distribution is known to work on Redhat 8 and 9, should work on most other linux systems, and may work on any unix variant.
Dependancies
Besides the usual stuff, you will need:
If you wish to use the gui programs setcosdir. defineobs, view-1dspec, and view-2dspec, you will also need the following perl modules:
Installation
  1. Retrieve the COSMOS tarfile.
  2. On your system, create a directory into which the cosmos system will be installed.
  3. define the environment variable COSMOS_HOME to be that directory, e.g.
    4.    setenv COSMOS_HOME "/home/joe_user/my-cosmos-directory"
  4. move the tarfile to this directory
  5. extract the tarfile  tar -xzvf COSMOS.tgz
  6. execute cd source
  7. You are now ready to build the executable files, by executing   make all
    8. but first make sure that the library files that are needed are in the expected locations, i.e. /lib, /usr/lib, or one of the locations specified in /etc/ld.so.conf or by LD_LIBRARY_PATH. The libraries in question are:
    1. libpgplot
    2. libcpgplot
    3. libcfitsio
    4. libX11
If they are not, you must specify the locations on the make command line:
    make all PGLIB = "pgplot-dir" XLIB = "Xll-dir" FITSLIB = "fits-dir"
With a little luck, you will get no error messages, and at the end you will have a completely installed system. The most likely errors are due to a failure to find all the library files. Check their locations.

Some final tidying:
    1. execute, and copy into your shell startup file (e.g. cshdef, .cshrc) the following commands so that they will be defined in each window you open:
      2. setenv COSMOS_HOME "/home/joe-user/my-cosmos-directory"
      source $COSMOS_HOME/cosmos-setup
    2. If you wish to use the IRAF routines display8 and imcombine8, you must execute the following lines at the cl prompt, or put them in your login.cl file. Note that you must specify the full path to the cosmos directory, since iraf forgets your environment variables, such as COSMOS_HOME
      3. task combine8 = "/home/joe_user/my-cosmos-directory/bin/combine8.cl"
      task display8 = "/home/joe_user/my-cosmos-directory/bin/display8.cl"
    3. The html documentation is available locally at $COSMOS_HOME/docs/COSMOS.html.
    4. If you installed the system into your own account you are done. However, if you installed the system into system directories, or if you intend to use the pipeline script generator process-2spec, you will need to copy the cospar directory, which contains the program parameter files, into you own home directory:  cp -R $COSMOS_HOME/cospar ~/.
Need some help?
Since you are a pioneer, you deserve a little help. If you can't get things to work properly, contact Gus Oemler at oemler@ociw.edu and we'll try to sort things out.

Updating from previous versions

A patch file, for updating to the latest version from the next most recent version, is available HERE. To install this patch, you must have the entire previous distribution installed on your machine. Copy over the patch, then:
cd $COSMOS_HOME
tar -xzvf COSMOSx.xx-patch.tar
then, follow the instructions in the README file to complete the update.

Back to the Table of Contents