Installing and running COSMOS
At the telescope
On Santa Barbara Street
Elsewhere

At the telescope

At the present time, the COSMOS2 software is located at the Baade Telescope in /home/llama/aoemler/cosmos2. Programs must be run on llama unless you want to transfer everything to burro. See Running on Burro for instructions how to do that.

Running on llama

Before running any programs, you must execute the following commands:
  • cd ~
  • tar -xzvf /home/aoemler/cosmos2/Cospar.tgz 
  • source /home/aoemler/cosmos/llama-setup
If you wish to use the IRAF routines display8 and combine8, you must execute the following lines at the cl prompt, or put them in your login.cl file:
  • task imcombine8 = "/home/aoemler/cosmos2/bin/imcombine8.cl"
  • task display8 = "/home/aoemler/cosmos2/bin/display8.cl"
Remember to execute "source /home/aoemler/cosmos/llama-setup" in any new windows that you open or put it in your shell startup script.

Running on burro

If you need to run on burro, you must do the following.

On Santa Barbara Street


The COSMOS2 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/COSMOS2

Installing COSMOS2 on your own machine

COSMOS2 is know to work on Redhat 8, Redhat 9, and Fedora Core 1 and 4 and on Mac OS 10.3 and 10.4. The latest version and the latest patch are listed below, and may be downloaded as gzipped tarfiles.
Distribution Version2.02 DOWNLOAD
Patch Feb 07 2006 DOWNLOAD README

After installing COSMOS2 you should always look for and install the latest patches in order to keep COSMOS up to date with the latest bug fixes and improvements.

Dependancies

Besides the usual stuff, you will need:
If you wish to use the gui programs setcosdir. defineobs, and viewspectra, you will also need the following perl modules:

Installation

  1. Retrieve the COSMOS2 tarfile.
  2. On your system, create a directory into which the COSMOS2 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-cosmos2-directory"
  4. move the tarfile to this directory
  5. extract the tarfile  tar -xzvf cosmos2.tgz
  6. execute cd source
  7. You are now ready to build the executable files, but first make sure that the library files (and possibly their associated include files) that are needed are in the expected locations, which are specified in the Makefile. The libraries in question are:
    1. libpgplot
    2. libcpgplot
    3. libcfitsio
    4. libX11
If they are not, you must do one of the following:
  • copy the files into $COSMOS_HOME/lib
  • create symbolic links to the files in $COSMOS_HOME/lib, (and $COSMOS_HOME/include)
  • edit the Makefile definitions of PGLIB, FITSLIB, and XLIB, (and PGINC, FITSINC, XINC)
  • specify the locations on the make command line, as seen below,

Now, you are ready to execute the make command

    make -f Makefile.system ["PGLIB = pgplot-dir XLIB =
 Xll-dir FITSLIB = fits-dir PGINC = pgplot.h-dir XINC = X11.h-dir FITSINC = fits.h-dir"]

where system is either "Mac" or "linux", and the options in backets are only needed if the above mentioned library and header files are not in their expected locations. 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 and header 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:
setenv COSMOS_HOME "/home/joe-user/my-cosmos2-directory"
source $COSMOS_HOME/cosmos2-setup
setenv COSMOS_PAR_DIR "/home/joe-user/my-Cospar-directory"
 where my-cosmos2-directory and my-cospar-directory are the locations you have chosen for the      cosmos2 software and the Cospar files.
2. Move the Cospar directory to the location you have chosen, as described above.

3. 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
  task display8 = "/home/joe_user/my-cosmos-directory/
                bin/display8.cl"

      task imcombine8 = "/home/joe_user/my-cosmos-directory/
                       bin/imcombine8.cl"
 The html documentation will be available on your own computer  at
 $COSMOS_HOME/docs/COSMOS2.html.

Installing patches

To install the latest patch, download the patch file to $COSMOS_HOME, then

tar -xzvf patchname.tgz
cd source
make -f patchname.system
Where system is either Mac or linux.  Depending on which programs are being updated, you may need to include one or more of the PGLIB, PGINC, XLIB, XINC, FITSLIB, AND FITSINC options described above for the system installation. After unpacking the tarfile, there will be a file in $COSMOS_HOME called patchname.readme with a description of the changes included in this patch.

Need some help?

If you have trouble with installing or running COSMOS, please
  1. Make sure that you have the latest version and latest patch file
  2. Make sure that you have carefully read all of the documentation
  3. If things still don't work, you can contact Greg Walth (gwalth@ociw.edu) or Dan Kelson (kelson@ociw.edu) for assistance.

Back to the Table of Contents