• Antelope Release 5.5 Mac OS X 10.8.5 2015-04-21

 

NAME

slink2orb - SeedLink to Antelope ORB module

SYNOPSIS

slink2orb [-dc database] [-dm database] [-nd delay]
          [-nt timeout] [-k interval] [-pf parameter_file]
          [-S statefile] [-r] [-v] SeedLink 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

slink2orb connects to a SeedLink server, requests data and forwards it to an ORB ring buffer as packet type 'SEED'. All SeedLink data packets are 512-byte Mini-SEED records.

OPTIONS

PARAMETER FILE

An example slink2orb parameter file:

#
#  slink2orb.pf, parameters for the SeedLink to ORB module
#

# Equivalent command line parameters override those specified here
# All parameters are optional

nettimeout    600     # network timeout (seconds), 0 to disable
netdelay      30      # network reconnect delay (seconds)
keepalive     0       # interval to send keepalive requests (seconds)
stateint      300     # interval to save the sequence number (packets)

selectors   BH?.D     # selectors recognized by SeedLink server, see below

stations &Arr{
#       NET_STA         [selectors]
        GE_EIL          BHZ.D  HHZ.D
        IU_KONO         BH?
        MN_AQU
# Some SeedLink servers can accept wildcards for network and station
        TA_*            BHZ
}

#(notes regarding "selectors" from a SeedLink configuration file)
#
#   The "selectors" parameter tells to request packets that match given
#   selectors. This helps to reduce network traffic. A packet is sent to
#   client if it matches any positive selector (without leading "!") and
#   doesn't match any negative selectors (with "!"). General format of
#   selectors is LLSSS.T, where LL is location, SSS is channel, and T is
#   type (one of DECOTL for data, event, calibration, blockette, timing,
#   and log records). "LL", ".T", and "LLSSS." can be omitted, meaning
#   "any". It is also possible to use "?" in place of L and S.
#
#   Some examples:
#   BH?            - BHZ, BHN, BHE (all record types)
#   00BH?.D        - BHZ, BHN, BHE with location code '00' (data records)
#   BH? !E         - BHZ, BHN, BHE (excluding detection records)
#   BH? E          - BHZ, BHN, BHE plus detection records of all channels
#   !LCQ !LEP      - exclude LCQ and LEP channels
#   !L !T          - exclude log and timing records

The parameters are further defined below.

NOTES

Currently, SeedLink only serves 512-byte Mini-SEED records (with an 8 byte SeedLink header). Received records are prepended with an Antelope packet type 'SEED' header and are sent to the ORB, optionally including calib, calper and segtype from a specified database. Wildcard network and station codes Some SeedLink server have enhanced selection capability and are able to handle wildcards ('*' or '?' characters) in the network and station codes. Servers that do not support this will return an error during negotiation. All/Uni-station Vs. Multi-station: All/Uni-station mode is an old connection method used for getting all (or a single station depending on configuration of the server) data streams from a server. Multi-station mode is the method used for requesting specific streams. Most users do not need to know the difference between these modes with the one exception that some SeedLink servers implement uni-station mode as all-station mode, if no network and station selection is made during negotiation these servers will stream all the data to the client (equivalent to wildcarding all the data streams). The SeedLink protocol was originally developed as part of the SeisComP (Seismological Communication Processor) package. For more information see, http://www.gfz-potsdam.de/geofon/

AUTHOR

Chad Trabant
ORFEUS Data Center/EC-Project MEREDIAN
IRIS Data Management Center

Antelope User Group Contributed Software
Printer icon