LIGO Archive Service
LARS will be a collection of tools and services that provides archival storage for LIGO. It is currently in prototype, hence the lack of substantial content here.
Brian Moe. Email: bmoe at gravity.phys.uwm.edu
There currently is a small set of user tools available through CVS which allow cataloging and sharing small numbers of search results. The documentation is currently weak, as things will likely be changing rapidly.
Right now there is no comprehensive documentation. There is, however, a vision document for the Web Services aspect of Lars.
The user tools are part of packaged as part of lscsoft.
Lars User Tools
The user tools are simple programs that are intended to allow LIGO scientists to catalog and share search results. Users may add descriptions and locations of search results to a simple database. This database may be queried by others to discover result locations. Individual results may be narrowed within a search by specifying a description in the result's LALCache. When found, query results may be listed or data may be presented to the user in a local directory, if sshfs is available.
The simple databases are stored as simple LALCache files and may be shared through CVS, NFS, HTTP, SSH or even FTP. Databases are identified to the utility programs via URLs. Examples are:
- The CVS URL is rather non-standard.
- You will need to find a "real" database URL to use.
- You will obviously need proper permissions.
- "file:" URLs will be accessed via SSH. To use these painlessly, you should have ssh set up to use proxies.
A search database can be specified on the command line, or in the
LARS_DB environment variable. There might be an actual
advertising cache available by doing:
Use this program to find interesting search results and files within serach results.
larsearch --help for more information. If you use
--mount option, there will be sshfs mounts that you will need
to be aware of. These tools currently do no housekeeping of these mounts -- that
currently must be done manually.
User this program to add your own search results to a search database.
The basic invocation is
larsadd [options] DESCRIPTION RESULT_PATH.
larsadd --help for more information. If you do not specify IFOs
or start/end times, these will be inferred from the contents of any LALCache in
the RESULT_PATH. The RESULT_PATH may be a simple directory path or a URL.
There is no formal bug reporting mechanism as of yet. Informally, email may be sent to the project librarian mentioned above.
There are no mailing lists. If you think there should be one, email the project librarian.
For ER1Lars will run with the same functionality as in S5
Post ER1 StatusLars was up throughout ER1, but went unused.
- Be used by at least one analysis
- Add archival functionality
- REST interface
This is prototype quality software and is certain to contain annoying bugs. Feel free to share your feelings.