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:

PATH

The executables live in

/home/group9/kaiser/research/imcat/bin/solaris

and

/home/group9/kaiser/research/imcat/bin/scripts

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.

LD_LIBRARY_PATH

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

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

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.

IMCATDIR

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

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

to your .cshrc or whatever.

MANPATH

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

/home/group9/kaiser/man

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

/home/group9/kaiser/man:/usr/man:/opt/local/man:/opt/gnu/man:/opt/SUNWspro/man:/usr/man:/opt/X11R6.1/man:/usr/openwin/share/man

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.