The use_ligotools script is provided to make it easy to
set up environment variables (LIGOTOOLS, PATH, etc.)
to use LIGOtools. It returns a list of commands appropriate for the
shell from which it is called (sh, bash,
ksh, csh, or tcsh); thus, it should be
called from any of these shells by executing eval `<path>/use_ligotools`,
where <path> is the directory in which the
use_ligotools script is located. Normally this is
$LIGOTOOLS/bin, but obviously you can't just type this if the
LIGOTOOLS environment variable has not yet been set! (If
use_ligotools happens to be in a directory in your
PATH, then you can simply execute eval `use_ligotools`.)
use_ligotools follows symbolic links to determine the base
LIGOtools directory in which it actually resides. (So
use_ligotools will not work if you copy it to anywhere else,
but you can create a symbolic link to it and use that symbolic
link.)
Specifically, use_ligotools returns commands to set
LIGOTOOLS and to add the LIGOtools bin,
lib, and matlab directories to the PATH,
LD_LIBRARY_PATH, and MATLABPATH environment
variables, respectively. If LIGOTOOLS was already set, then
use_ligotools replaces the corresponding path
elements; otherwise it simply appends the path elements. Thus, it is
safe to call use_ligotools multiple times, either for the
same LIGOtools instance (in which case there is no net change in the
environment variables) or for different LIGOtools instances (in which
case use_ligotools acts as an "un-setup" script for the first
before setting up the second).