Synopsis

datalinkclient [-vV] [--help] [-h=<host>] [-m=<match>] [--max=<maxRecords>] [-o=<outputFile>] [-p=<port>] [--timeout=<timeoutSec>]

Description

Datalinkclient is an example client that can connect to a datalink service and stream miniseed to a file.

The datalink protocol is specified here:

Options

-h, --host=<host>

host to connect to, defaults to IRIS, rtserve.iris.washington.edu

--help

display a help message

-m, --match=<match>

match pattern, as a regular expression. For miniseed the conventions is NN_SSS_LL_CCC/MSEED

--max=<maxRecords>

number of packets to receive before ending the connection

-o, --out=<outputFile>

Output file (default: print to console)

-p, --port=<port>

port to connect to, defaults to IRIS, 18000

--timeout=<timeoutSec>

timeout seconds, defaults to 120

-v, --verbose

Verbose

-V, --version

Print version and exit

Examples

Ask for a few packets of HH. data from station CO.BIRD, and output to a file.

> datalinkclient -m CO_BIRD_00_HH./MSEED --max 3 -o bird.mseed -v
initConnection to rtserve.iris.washington.edu:18000
Connection made
sendId
send 'ID seisFile:unknown:42:java | '
not bytes available 0
readPacket
readPacket(): blocking read for 3 bytes, available=53
Server ID: ID DataLink 2020.075 :: DLPROTO:1.0 PACKETSIZE:512
send 'MATCH | CO_BIRD_00_HH./MSEED'
send 'STREAM | '
readPacket(): blocking read for 3 bytes, available=0
Response: OK
readPacket(): blocking read for 3 bytes, available=0
D CO.BIRD.00.HHE 2021,062,17:26:17.9600  3.14 314
readPacket(): blocking read for 3 bytes, available=6050
D CO.BIRD.00.HHE 2021,062,17:26:21.1000  3.09 309
send 'ENDSTREAM | '
readPacket(): blocking read for 3 bytes, available=5445
D CO.BIRD.00.HHE 2021,062,17:26:24.1900  3.01 301
readPacket(): blocking read for 3 bytes, available=4840
D CO.BIRD.00.HHE 2021,062,17:26:27.2000  3.1 310
readPacket(): blocking read for 3 bytes, available=4235
D CO.BIRD.00.HHE 2021,062,17:26:30.3000  3.01 301
readPacket(): blocking read for 3 bytes, available=3630
D CO.BIRD.00.HHE 2021,062,17:26:33.3100  2.98 298
readPacket(): blocking read for 3 bytes, available=3025
D CO.BIRD.00.HHE 2021,062,17:26:36.2900  2.97 297
readPacket(): blocking read for 3 bytes, available=2420
D CO.BIRD.00.HHE 2021,062,17:26:39.2600  3.16 316
readPacket(): blocking read for 3 bytes, available=1815
D CO.BIRD.00.HHE 2021,062,17:26:42.4200  3.23 323
readPacket(): blocking read for 3 bytes, available=1210
D CO.BIRD.00.HHE 2021,062,17:26:45.6500  3.14 314
readPacket(): blocking read for 3 bytes, available=605
D CO.BIRD.00.HHE 2021,062,17:26:48.7900  3.28 328
readPacket(): blocking read for 3 bytes, available=0