NAME
rrp2orb - RRP Mini-SEED to Antelope ORB module
SYNOPSIS
rrp2orb [options] -ring ringfile 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
rrp2orb reads Mini-SEED records from an RRP (Ring Replication
Protocol) ring file and sends them to an ORB as packet type 'SEED'.
OPTIONS
-
-V
Print the program version and exit.
-
-h
Print the program help/usage and exit.
-
-v
Be more verbose. This flag can be used multiple times ("-v -v" or
"-vv") for more verbosity.
-
-m match
Specify a regular expression to limit which records are sent to the
ORB to only those which match. The match pattern is compared to
the SEED record source parameters in the following
form: 'NET_STA_LOC_CHAN'.
-
-n code
Change the network code of the data records (after matching) before
sending them to the ORB.
-
-ring ringfile (required)
Specify the ring file from which to read Mini-SEED records. This is a
required parameter.
-
-mod interval
Save the ring reader status file (reader position) every
interval packets. By default the status file will be saved
every 100 packets.
-
-ext readerid
Use the readerid as an extension on the reader's status file.
This reader ID must be unique for each reader of the ring file. If
not specified it will default to ".ringstat". If two ring readers are
running concurrently and using the default (or same) status file
extension (readerid) mayhem will ensue, or at least the readers
might be confused about their actual read position on restart.
-
-MD mappingdb
Use the specified database for mapping SEED names to CSS database
names. If the channel names do not exist in the specified database
they will be inserted. The database should be specified using an
absolute path.
-
-CD calibdb
Copy calib, calper and segtype from the calibration table in the
specified database. Recommended if the data will be processed
directly from the ORB since this information is not available
in the data stream. A mapping database must also be specified
using the -MD option. The database should be specified using an
absolute path.
-
-r
Use the database specified with the -MD option to remap input net,
sta, chan, and loc codes to local sta and chan codes. This can be
helpful when processing this data with programs that do not
recognize the loc code in the source name.
-
ORB
A required argument. Specifies the location of the ORB server in
[host]:[port] format. If 'host' is omitted 'localhost' is assumed.
If 'port' is omitted the default ORB port is assumed.
RRP
The RRP system was designed by and being used to deliver data from the
NEIC.
A ring reader's status file is always written to the same directory as
the ring file itself and is named "<ringfile><readerid>". As an
example, the default reader id is ".ringstat", for a reader using the
default ID reading a ring file at:
/data/import/ringfile
the reader's status file will be written to:
/data/import/ringfile.ringstat
AUTHOR
Chad Trabant
IRIS Data Management Center
Antelope User Group Contributed Software