NAME
liss2orb - read data in LISS format
SYNOPSIS
liss2orb [-D file]
[-d db]
[-m match] [-r]
[-s pktsize]
[-t timeout]
[-v] liss-server orb
SUPPORT
Contributed code: NO BRTT support.
THIS PIECE OF SOFTWARE WAS CONTRIBUTED BY THE ANTELOPE USER COMMUNITY. BRTT DISCLAIMS ALL OWNERSHIP, LIABILITY, AND SUPPORT FOR THIS PIECE OF SOFTWARE.
FOR HELP WITH THIS PIECE OF SOFTWARE, PLEASE CONTACT THE CONTRIBUTING AUTHOR.
DESCRIPTION
liss2orb reads seismic data in LISS format from a
liss-server
and sends it to an
orb ring buffer.
OPTIONS
-
-D raw
write raw packets into file as they're received, for debugging.
-
-d db
Copy calib, calper and segtype from the calibration table in the
specified database db. (Since this information is not available from the
data feed, it has to be obtained from a static database; this database
can be generated using seed2db(1) and the corresponding dataless seed
volume from the IRIS DMC).
-
-m match
Only packets with srcname containing the regular expression match
are forwarded to the orbserver(1).
-
-r
Use the local foreignkeys database to remap input net, sta, chan, and loc codes
to local sta and chan codes. This makes orbmonrtd(1) and other programs which
don't recognize the loc code in the source name work better.
-
-s pktsize
liss2orb attempts to derive the individual packet size by looking at
the size specified by the internal 1000 blockette.
However, some of these 1000 blockettes from certain servers are known to be wrong.
In this case, the user must explicitly specify the size of the incoming packets.
Currently, at least, all packets are
512 bytes, except for packets from the GT network, where packets
are all 256 bytes, and except for the IRIS DMC, which makes 4096 byte packets.
-
-t timeout
Specify a timeout on the read. This should not be necessary.
-
-v
Be more verbose, mentioning each packet copied.
EXAMPLE
Read data from an kono.iu.liss.org remote site. Select data only for
BHZ, BHN, BHE channels and store them in a bbarray:9999 ORB. Fill in
calib, calper and segtype from the calibration table of the database
asl.
% liss2orb -d asl -m "BH[ZNE]" kono.iu.liss.org bbarray:9999
BUGS AND CAVEATS
The individual packets are SEED data blocks which
contain a blockette 1000. This 1000 blockette should specify the
data block size, but currently (9/15/1999) some servers provide
blockettes with the wrong size. In these cases, the size must be
derived from an explicit command line argument.
AUTHOR
Marina Glushko
Daniel Quinlan
Antelope User Group Contributed Software