SeedLink¶
SeedLink Client¶
SeedLink is a TCP/IP-based data transmission protocol that allows near-real-time access to data from thousands of geophysical monitoring instruments. See data keywords list and channel id syntax for options.
-
SeedLink!(S, chans, KWs)
-
SeedLink!(S, chans, patts, KWs)
-
S = SeedLink(chans, KWs)
u
specifies the URL without “http://”Initiate a SeedLink session in DATA mode to feed data from channels chans
with
selection patterns patts
to SeisData structure S
. A handle to a TCP
connection is appended to S.c
.Data are periodically parsed until the
connection is closed. One SeisData object can support multiple connections,
provided that each connection’s streams feed unique channels.
Argument Syntax¶
chans
Channel specification can use any of the following options:
- A comma-separated String where each pattern follows the syntax NET.STA.LOC.CHA.DFLAG, e.g. UW.TDH..EHZ.D. Use “?” to match any single character.
- An Array{String,1} with one pattern per entry, following the above syntax.
- The name of a configuration text file, with one channel pattern per line; see Channel Configuration File syntax.
patts Data selection patterns. See SeedLink documentation; syntax is identical.
Special Rules¶
- SeedLink follows unusual rules for wild cards in
sta
andpatts
: *
is not a valid SeedLink wild card.- The LOC and CHA fields can be left blank in
sta
to select all locations and channels.
- SeedLink follows unusual rules for wild cards in
- DO NOT feed one data channel with multiple SeedLink streams. This can have severe consequences:
- A channel fed by multiple live streams will have many small time sequences out of order.
merge!
is not guaranteed to fix it. - SeedLink will almost certainly crash.
- Your data may be corrupted.
- The Julia interpreter can freeze, requiring
kill -9
on the process. - This is not an “issue”. There will never be a workaround. It’s what happens when one intentionally causes TCP congestion on one’s own machine while writing to open data streams in memory. Hint: don’t do this.
- A channel fed by multiple live streams will have many small time sequences out of order.
Special Methods¶
close(S.c[i])
ends SeedLink connectioni
.!deleteat(S.c, i)
removes a handle to closed SeedLink connectioni
.
SeedLink Utilities¶
-
SL_info
(v, url)¶
Retrieve SeedLink information at verbosity level v from url. Returns XML as a string. Valid strings for L are ID, CAPABILITIES, STATIONS, STREAMS, GAPS, CONNECTIONS, ALL.
-
has_sta
(sta[, u=url, port=n])¶
u
specifies the URL without “http://”Check that streams exist at url for stations sta, formatted NET.STA. Use “?” to match any single character. Returns true for stations that exist. sta can also be the name of a valid config file or a 1d string array.
Returns a BitArray with one value per entry in sta.
-
has_stream
(cha::Union{String, Array{String, 1}}, u::String)¶
u
specifies the URL without “http://”Check that streams with recent data exist at url u for channel spec cha, formatted NET.STA.LOC.CHA.DFLAG, e.g. “UW.TDH..EHZ.D, CC.HOOD..BH?.E”. Use “?” to match any single character. Returns true for streams with recent data.
cha can also be the name of a valid config file.
-
has_stream
(sta::Array{String, 1}, sel::Array{String, 1}, u::String, port=N::Int, gap=G::Real)
u
specifies the URL without “http://”If two arrays are passed to has_stream, the first should be formatted as SeedLink STATION patterns (formated “SSSSS NN”, e.g. [“TDH UW”, “VALT CC”]); the second be an array of SeedLink selector patterns (formatted LLCCC.D, e.g. [“??EHZ.D”, “??BH?.?”]).