LIGOtools Package: ldasjob
This package consists of the 'ldasjob'
Tcl library which makes it easy to execute one or more LDAS jobs from
within a Tcl script, plus a few scripts which make use of this library
to query and interpret the cache of frame files visible to a
particular LDAS system: - FrameCacheQuery to return the full
local path of frame file(s) stored on disk, covering a point in time
or a time range
- FrameCacheRanges to summarize the time
range(s) available in the frame data
- FrameCacheDump to print a
directory-by-directory dump of the frame cache info
Author: Peter Shawhan
Version 2.6
Release date: October 28, 2005
History of changes
Notes
- Prior to using the ldasjob package, you must obtain an
LDAS username/password and execute the "ldaspw" utility to
store them in a file in your home directory. The ldaspw
utility encrypts the password, and the file which it creates is
readable only by you. The ldasjob package gets your username and
password from this file when it submits an LDAS job on your behalf.
- Normally, "web-patching" is used to deploy bug fixes and other
minor changes without any action on the part of users. The code looks
for patch files on several LDAS web servers, beginning with
ldas-sw.ligo.caltech.edu and proceeding to others if necessary. You
can override this behavior by setting the WEBPATCH_HOST
environment variable to the address of the web server you want to use
(presumably because it is on your local network), or to "none" to
disable web-patching entirely. Web-patching is always disabled
when running on one of the "ldas-jobs" computers.
Documentation
- Complete
documentation for the Tcl library, with many examples
- Additional examples:
- frame2ilwd --
Reads a specified channel out of a frame file (on your local disk)
and writes out an ilwd file (on your local disk).
- tfcloop2 --
Repeatedly executes LDAS jobs to apply the "tfclusters" search code
to 180-second-long stretches of data, requiring the interferometer
to be locked, as the data becomes available. Developed for the E6
engineering run.
-
Typing FrameCacheQuery, FrameCacheRanges, or FrameCacheDump
without any arguments will print out usage information.
Distribution files
Normally, you should use the ligotools_update utility to
download and install new packages or new versions of existing
packages, since it automatically figures out what packages need to be
updated. However, if you wish to do so manually, then click on the
name of the appropriate distribution file (below) with the
right mouse button and choose "Save Link As..." from
the popup menu. Note that you must save it on your disk with exactly
the same name as it has on this web site. After the file has been
downloaded, do:
ligotools_install <file>
where <file> is the file which was downloaded. This
procedure will be quicker if the environment variable
LIGOTOOLS is set to the main LIGOtools directory.