Using imcat on IfA public machines

I have installed imcat and it's accompanying documentation in my home directory on galileo (currently /home/group9/kaiser). In order to run it you will need to set the following environment variables:


The executables live in




you must add these to your PATH (probably in your .cshrc or whatever)

To test this, try something like

makerandcat 10

which should generate a lc format catalogue. You may need to rehash to update your search path.


The commands 'contour' and 'plotcat' need to know where to find the pgplot library. You should add


to your LD_LIBRARY_PATH, which is a colon separated list of paths. If you don't already set one, add the line

setenv LD_LIBRARY_PATH /home/group9/kaiser/research/imcat/lib/solaris/pgplot

to your .cshrc or whatever.

You will also need to define a couple of environment variables for pgplot:

setenv PGPLOT_DIR /usr/local/lib/pgplot

setenv PGPLOT_FONT $PGPLOT_DIR/grfont.dat

To test this, try something like

makerandcat 100 | plotcat

which should cause a X-window to pop up containing a plot of 100 randomly placed points.


A couple of commands need the IMCATDIR defined, so also add

setenv IMCATDIR /home/group9/kaiser/research/imcat

to your .cshrc or whatever.


The man pages are currently installed in my home directory. To access them you must add


To your MANPATH environment variable.

If you don't currently set MANPATH explicitly, you will need to add the paths to the regular man pages. For example, I set my MANPATH to be


Type 'man imcat' to see the top-level man page.

Other optional environment variables

See Byte-Ordering, FITS and Imcat regarding optional environment variables you can set to influence how imcat flags bad data and byte order issues.