|
|
<!DOCTYPE html>
|
|
|
|
|
|
<html >
|
|
|
<head>
|
|
|
<meta charset="utf-8" />
|
|
|
<title>slinktool — SeisComP Release documentation</title>
|
|
|
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
|
|
|
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
|
|
|
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css" />
|
|
|
<script type="text/javascript" src="../_static/seiscomp.js"></script>
|
|
|
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
|
|
|
<script src="../_static/jquery.js"></script>
|
|
|
<script src="../_static/underscore.js"></script>
|
|
|
<script src="../_static/doctools.js"></script>
|
|
|
<script src="../_static/language_data.js"></script>
|
|
|
<link rel="shortcut icon" href="../_static/favicon.ico"/>
|
|
|
<link rel="index" title="Index" href="../genindex.html" />
|
|
|
<link rel="search" title="Search" href="../search.html" />
|
|
|
<link rel="next" title="Inventory" href="../toc/inventory.html" />
|
|
|
<link rel="prev" title="slarchive" href="slarchive.html" />
|
|
|
</head>
|
|
|
<body>
|
|
|
<div class="header">
|
|
|
<div class="container">
|
|
|
<div class="brand">
|
|
|
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
|
|
|
<!-- span class="title">SeisComP Release</span -->
|
|
|
<span class="version">5.3.0</span>
|
|
|
</div>
|
|
|
</div>
|
|
|
</div>
|
|
|
<div class="nav">
|
|
|
<div class="container">
|
|
|
<div class="content"><a class="pull-right" id="sidebar-toggle">TOC</a>
|
|
|
|
|
|
<div class="related" role="navigation" aria-label="related navigation">
|
|
|
<ul>
|
|
|
<li class="right">
|
|
|
<a href="../genindex.html" title="General Index"
|
|
|
accesskey="I">
|
|
|
index
|
|
|
</a>
|
|
|
</li>
|
|
|
<li class="right">
|
|
|
<a href="../toc/inventory.html" title="Inventory"
|
|
|
accesskey="N">
|
|
|
next
|
|
|
</a>
|
|
|
</li>
|
|
|
<li class="right">
|
|
|
<a href="slarchive.html" title="slarchive"
|
|
|
accesskey="P">
|
|
|
previous
|
|
|
</a>
|
|
|
</li>
|
|
|
<li class="nav-item nav-item-0">
|
|
|
<a href="../index.html">Home</a>
|
|
|
</li>
|
|
|
<li class="nav-item nav-item-1">
|
|
|
<a href="../modules.html" >Modules</a>
|
|
|
</li>
|
|
|
<li class="nav-item nav-item-2">
|
|
|
<a href="../toc/acquisition.html" accesskey="U">Acquisition</a>
|
|
|
</li>
|
|
|
</ul>
|
|
|
</div>
|
|
|
</div>
|
|
|
</div>
|
|
|
</div>
|
|
|
<div class="container">
|
|
|
<div class="fitted content" id="anchors-container">
|
|
|
<div class="body" role="main">
|
|
|
|
|
|
<div class="section" id="slinktool">
|
|
|
<span id="id1"></span><h1>slinktool<a class="headerlink" href="#slinktool" title="Permalink to this headline">¶</a></h1>
|
|
|
<p><strong>SeedLink query interface module</strong></p>
|
|
|
<div class="section" id="description">
|
|
|
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
|
|
<p>slinktool connects to a <a class="reference internal" href="seedlink.html#seedlink"><span class="std std-ref">seedlink</span></a> server and queries the server for information
|
|
|
or requests data using uni-station or multi-station mode and prints information
|
|
|
about the packets received. All received packets can optionally be dumped to a
|
|
|
single file or saved in custom directory and file layouts.</p>
|
|
|
</div>
|
|
|
<div class="section" id="examples">
|
|
|
<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
|
|
|
<div class="section" id="all-station-uni-station-mode">
|
|
|
<h3>All-station/Uni-station mode<a class="headerlink" href="#all-station-uni-station-mode" title="Permalink to this headline">¶</a></h3>
|
|
|
<p>The following would connect to a SeedLink server at slink.host.com port 18000 and
|
|
|
configure the link in all-station/uni-station mode, exactly which data are received
|
|
|
depends on the data being served by the SeedLink server on that particular port.
|
|
|
Additionally, all of the received packets are appended to the file ‘data.mseed’
|
|
|
and each packet received is reported on the standard output.</p>
|
|
|
<div class="highlight-rst notranslate"><div class="highlight"><pre><span></span>slinktool -v -o data.mseed slink.host.com:18000
|
|
|
</pre></div>
|
|
|
</div>
|
|
|
<p>The ‘-s’ argument could be used to indicate selectors to limit the type of packets
|
|
|
sent by the SeedLink server (without selectors all packet types are sent). The
|
|
|
following would limit this connection to BHZ channel waveform data with a location
|
|
|
code of 10 (see an explanation of SeedLink selectors below). Additionally another
|
|
|
verbose flag is given, causing slinktool to report detailed header information
|
|
|
from data records.</p>
|
|
|
<div class="highlight-rst notranslate"><div class="highlight"><pre><span></span>slinktool -vv -s 10BHZ.D -o data.mseed slink.host.com:18000
|
|
|
</pre></div>
|
|
|
</div>
|
|
|
</div>
|
|
|
<div class="section" id="multi-station-mode">
|
|
|
<h3>Multi-station mode<a class="headerlink" href="#multi-station-mode" title="Permalink to this headline">¶</a></h3>
|
|
|
<p>The following example would connect to a SeedLink server on localhost port 18010
|
|
|
and configure the link in multi-station mode. Each station specified with the ‘-S’
|
|
|
argument will be requested, optionally specifying selectors for each station.</p>
|
|
|
<div class="highlight-rst notranslate"><div class="highlight"><pre><span></span>slinktool -v -S GE\_WLF,MN\_AQU:00???,IU\_KONO:BHZ.D :18010
|
|
|
</pre></div>
|
|
|
</div>
|
|
|
<p>This would request all data from the GEOFON station WLF as no selectors were indicated,
|
|
|
MedNet station AQU with location code 00 and all streams and waveform data from the
|
|
|
IU network station KONO from stream BHZ.
|
|
|
A variety of different data selections can be made simultaneously.</p>
|
|
|
<p>Examples:</p>
|
|
|
<ul>
|
|
|
<li><p>Horizontal BH channels, data only:</p>
|
|
|
<div class="highlight-rst notranslate"><div class="highlight"><pre><span></span>-s 'BHE.D BHN.D' -S 'GE\_STU,GE\_MALT,GE\_WLF'
|
|
|
</pre></div>
|
|
|
</div>
|
|
|
</li>
|
|
|
<li><p>Vertical channels only:</p>
|
|
|
<div class="highlight-rst notranslate"><div class="highlight"><pre><span></span>-s BHZ -S GE\_STU,GE\_WLF,GE\_RUE,GE\_EIL
|
|
|
</pre></div>
|
|
|
</div>
|
|
|
</li>
|
|
|
</ul>
|
|
|
</div>
|
|
|
<div class="section" id="wildcarding-network-and-station-codes">
|
|
|
<h3>Wildcarding network and station codes<a class="headerlink" href="#wildcarding-network-and-station-codes" title="Permalink to this headline">¶</a></h3>
|
|
|
<p>Some SeedLink implementations support wildcarding of the network and station codes.
|
|
|
If this is the case, the only two wildcard characters recognized are ‘*’ for
|
|
|
one or more characters and ‘?’ for any single character.</p>
|
|
|
<p>As an example, all US network data can be requested using the following syntax</p>
|
|
|
<div class="highlight-rst notranslate"><div class="highlight"><pre><span></span>-S 'US\_\*'
|
|
|
</pre></div>
|
|
|
</div>
|
|
|
</div>
|
|
|
</div>
|
|
|
<div class="section" id="seedlink-selectors">
|
|
|
<h2>Seedlink Selectors<a class="headerlink" href="#seedlink-selectors" title="Permalink to this headline">¶</a></h2>
|
|
|
<p>SeedLink selectors are used to request specific types of data within a given data
|
|
|
stream, in effect limiting the default action of sending all data types.
|
|
|
A data packet is sent to the client if it matches any positive selector
|
|
|
(without leading “!”) and doesn’t match any negative selectors (with a leading “!”).
|
|
|
The 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, implying anything in
|
|
|
that field. It is also possible to use “?” in place of L and S as a single character
|
|
|
wildcard. Multiple selectors are separated by space(s).</p>
|
|
|
<p>Examples:</p>
|
|
|
<div class="highlight-rst notranslate"><div class="highlight"><pre><span></span>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 & detection records of all channels
|
|
|
!LCQ !LEP - exclude LCQ and LEP channels
|
|
|
!L !T - exclude log and timing records
|
|
|
</pre></div>
|
|
|
</div>
|
|
|
</div>
|
|
|
<div class="section" id="archiving-data">
|
|
|
<h2>Archiving Data<a class="headerlink" href="#archiving-data" title="Permalink to this headline">¶</a></h2>
|
|
|
<p>Using the ‘-A format’ option received data can be saved in a custom directory and
|
|
|
file structure. The archive format argument is expanded for each packet processed
|
|
|
using the following flags:</p>
|
|
|
<div class="highlight-rst notranslate"><div class="highlight"><pre><span></span>n : network code, white space removed
|
|
|
s : station code, white space removed
|
|
|
l : location code, white space removed
|
|
|
c : channel code, white space removed
|
|
|
Y : year, 4 digits
|
|
|
y : year, 2 digits zero padded
|
|
|
j : day of year, 3 digits zero padded
|
|
|
H : hour, 2 digits zero padded
|
|
|
M : minute, 2 digits zero padded
|
|
|
S : second, 2 digits zero padded
|
|
|
F : fractional seconds, 4 digits zero padded
|
|
|
% : the percent (%) character
|
|
|
# : the number (#) character
|
|
|
t : single character type code:
|
|
|
D - waveform data packet
|
|
|
E - detection packet
|
|
|
C - calibration packet
|
|
|
T - timing packet
|
|
|
L - log packet
|
|
|
O - opaque data packet
|
|
|
U - unknown/general packet
|
|
|
I - INFO packet
|
|
|
? - unidentifiable packet
|
|
|
</pre></div>
|
|
|
</div>
|
|
|
<p>The flags are prefaced with either the % or # modifier. The % modifier indicates
|
|
|
a defining flag while the # indicates a non-defining flag. All received packets
|
|
|
with the same set of defining flags will be saved to the same file. Non-defining
|
|
|
flags will be expanded using the values in the first packet received for the
|
|
|
resulting file name.</p>
|
|
|
<p>Time flags are based on the start time of the given packet.</p>
|
|
|
<p>For example, the format string:</p>
|
|
|
<div class="highlight-rst notranslate"><div class="highlight"><pre><span></span>/archive/%n/%s/%n.%s.%l.%c.%Y.%j
|
|
|
</pre></div>
|
|
|
</div>
|
|
|
<p>would be expanded to day length files named something like:</p>
|
|
|
<div class="highlight-rst notranslate"><div class="highlight"><pre><span></span>/archive/NL/HGN/NL.HGN..BHE.2003.055
|
|
|
</pre></div>
|
|
|
</div>
|
|
|
<p>Using non-defining flags the format string:</p>
|
|
|
<div class="highlight-rst notranslate"><div class="highlight"><pre><span></span>/data/%n.%s.%Y.%j.%H:#M:#S.miniseed
|
|
|
</pre></div>
|
|
|
</div>
|
|
|
<p>would be expanded to:</p>
|
|
|
<div class="highlight-rst notranslate"><div class="highlight"><pre><span></span>/data/NL.HGN.2003.044.14:17:54.miniseed
|
|
|
</pre></div>
|
|
|
</div>
|
|
|
<p>resulting in hour length files because the minute and second are specified with the non-defining modifier. The minute and second fields are from the first packet in the file.</p>
|
|
|
</div>
|
|
|
<div class="section" id="stream-list-file">
|
|
|
<h2>Stream List File<a class="headerlink" href="#stream-list-file" title="Permalink to this headline">¶</a></h2>
|
|
|
<p>The stream list file used with the ‘-l’ option is expected to define a data stream
|
|
|
on each line. The format of each line is:</p>
|
|
|
<div class="highlight-rst notranslate"><div class="highlight"><pre><span></span>Network Station [selectors]
|
|
|
</pre></div>
|
|
|
</div>
|
|
|
<p>The selectors are optional. If default selectors are also specified (with the ‘-s’ option),
|
|
|
they they will be used when no selectors are specified for a given stream.</p>
|
|
|
<p>Example:</p>
|
|
|
<div class="highlight-rst notranslate"><div class="highlight"><pre><span></span>---- Begin example file -----
|
|
|
# Comment lines begin with a '#' or '\*'
|
|
|
# Example stream list file for use with the -l argument of slclient or
|
|
|
# with the sl\_read\_streamlist() libslink function.
|
|
|
GE ISP BH?.D
|
|
|
NL HGN
|
|
|
MN AQU BH? HH?
|
|
|
---- End example file -----
|
|
|
</pre></div>
|
|
|
</div>
|
|
|
<div class="admonition note">
|
|
|
<p class="admonition-title">Note</p>
|
|
|
<p>All diagnostic output from slinktool is printed to standard error (stderr).
|
|
|
Exceptions are when</p>
|
|
|
<ul class="simple">
|
|
|
<li><p>Printing miniSEED packet details with the <em>-p</em> option.</p></li>
|
|
|
<li><p>Printing unpacked samples with the <em>-u</em> option.</p></li>
|
|
|
<li><p>Printing the raw or formatted responses to INFO requests.</p></li>
|
|
|
</ul>
|
|
|
</div>
|
|
|
</div>
|
|
|
<div class="section" id="author-of-slinktool">
|
|
|
<h2>Author of slinktool<a class="headerlink" href="#author-of-slinktool" title="Permalink to this headline">¶</a></h2>
|
|
|
<p>Chad Trabant</p>
|
|
|
<p>ORFEUS Data Center/EC-Project MEREDIAN</p>
|
|
|
<p>IRIS Data Management Center</p>
|
|
|
<p>Original source code: <a class="reference external" href="https://github.com/iris-edu/slinktool/tree/master/doc">https://github.com/iris-edu/slinktool/tree/master/doc</a></p>
|
|
|
</div>
|
|
|
<div class="section" id="command-line-options">
|
|
|
<h2>Command-Line Options<a class="headerlink" href="#command-line-options" title="Permalink to this headline">¶</a></h2>
|
|
|
<p><strong class="program">slinktool [OPTION]... [host][:][port]</strong></p>
|
|
|
<p>Address ([host][:][port]) is a required argument. It specifies the address
|
|
|
of the SeedLink server in host:port format. Either the host, port or both
|
|
|
can be omitted. If host is omitted then localhost is assumed,
|
|
|
i.e. ‘:18000’ implies ‘localhost:18000’. If the port is omitted,
|
|
|
then 18000 is assumed, i.e. ‘localhost’ implies ‘localhost:18000’.
|
|
|
If only ‘:’ is specified, ‘localhost:18000’ is assumed.</p>
|
|
|
<div class="section" id="general-program-options">
|
|
|
<h3>General program options<a class="headerlink" href="#general-program-options" title="Permalink to this headline">¶</a></h3>
|
|
|
<dl class="option">
|
|
|
<dt id="cmdoption-slinktool-v">
|
|
|
<code class="sig-name descname">-V</code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-slinktool-v" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>Print program version and exit.</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="option">
|
|
|
<dt id="cmdoption-slinktool-h">
|
|
|
<code class="sig-name descname">-h</code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-slinktool-h" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>Print program usage and exit.</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="option">
|
|
|
<dt id="id2">
|
|
|
<code class="sig-name descname">-v</code><code class="sig-prename descclassname"></code><a class="headerlink" href="#id2" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>Be more verbose. This flag can be used multiple times (“-v -v” or “-vv”)
|
|
|
for more verbosity. One flag: report basic handshaking (link configuration) details and
|
|
|
briefly report each packet received. Two flags: report the details of the handshaking,
|
|
|
each packet received and detailed connection diagnostics.</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="option">
|
|
|
<dt id="cmdoption-slinktool-p">
|
|
|
<code class="sig-name descname">-P</code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-slinktool-p" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>Ping the server, report the server ID and exit.</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="option">
|
|
|
<dt id="id3">
|
|
|
<code class="sig-name descname">-p</code><code class="sig-prename descclassname"></code><a class="headerlink" href="#id3" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>Print details of received Mini-SEED data records. This flag can be used multiple times
|
|
|
(“-p -p” or “-pp”) for more detail. One flag: a single summary line
|
|
|
for each data packet received. Two flags: details of the Mini-SEED data records received,
|
|
|
including information from fixed header and 100/1000/1001 blockettes.</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="option">
|
|
|
<dt id="cmdoption-slinktool-u">
|
|
|
<code class="sig-name descname">-u</code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-slinktool-u" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>Print unpacked samples of data packets.</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="option">
|
|
|
<dt id="cmdoption-slinktool-nd">
|
|
|
<code class="sig-name descname">-nd</code><code class="sig-prename descclassname"> delay</code><a class="headerlink" href="#cmdoption-slinktool-nd" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>The network reconnect delay for the connection to the SeedLink server.
|
|
|
If the connection breaks for any reason this will govern how soon a reconnection should
|
|
|
be attempted.</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="option">
|
|
|
<dt id="cmdoption-slinktool-nt">
|
|
|
<code class="sig-name descname">-nt</code><code class="sig-prename descclassname"> timeout</code><a class="headerlink" href="#cmdoption-slinktool-nt" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>The network timeout (in seconds) for the connection to the SeedLink server. If no data
|
|
|
[or keep alive packets?] are received in this time range the connection is closed and
|
|
|
re-established (after the reconnect delay has expired). The default value is 600 seconds.
|
|
|
A value of 0 disables the timeout.</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="option">
|
|
|
<dt id="cmdoption-slinktool-k">
|
|
|
<code class="sig-name descname">-k</code><code class="sig-prename descclassname"> interval</code><a class="headerlink" href="#cmdoption-slinktool-k" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>Interval at which keepalive (heartbeat) packets are sent to the server.
|
|
|
Keepalive packets are only sent if nothing is received within the interval.</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="option">
|
|
|
<dt id="cmdoption-slinktool-x">
|
|
|
<code class="sig-name descname">-x</code><code class="sig-prename descclassname"> sfile[:interval]</code><a class="headerlink" href="#cmdoption-slinktool-x" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>Save/restore stream state information to this file.</p>
|
|
|
<p>During client shutdown the last received sequence numbers and time stamps (start times)
|
|
|
for each data stream will be saved in this file. If this file exists upon startup the information
|
|
|
will be used to resume the data streams from the point at which they were stopped. In this way the
|
|
|
client can be stopped and started without data loss, assuming the data are still available on the
|
|
|
server. If an interval is specified the state will be saved every interval in that packets are
|
|
|
received. Otherwise the state will be saved only on normal program termination.</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="option">
|
|
|
<dt id="cmdoption-slinktool-d">
|
|
|
<code class="sig-name descname">-d</code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-slinktool-d" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>Configure the connection in “dial-up” mode. The remote server will close the connection when
|
|
|
it has sent all of the data in its buffers for the selected data streams. This is opposed to
|
|
|
the normal behavior of waiting indefinitely for data.</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="option">
|
|
|
<dt id="cmdoption-slinktool-b">
|
|
|
<code class="sig-name descname">-b</code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-slinktool-b" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>Configure the connection in “batch” mode.</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
</div>
|
|
|
<div class="section" id="data-stream-selection">
|
|
|
<h3>Data stream selection<a class="headerlink" href="#data-stream-selection" title="Permalink to this headline">¶</a></h3>
|
|
|
<dl class="option">
|
|
|
<dt id="cmdoption-slinktool-s">
|
|
|
<code class="sig-name descname">-s</code><code class="sig-prename descclassname"> selector</code><a class="headerlink" href="#cmdoption-slinktool-s" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>Selectors for uni-station or default for multi-station mode</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="option">
|
|
|
<dt id="cmdoption-slinktool-l">
|
|
|
<code class="sig-name descname">-l</code><code class="sig-prename descclassname"> listfile</code><a class="headerlink" href="#cmdoption-slinktool-l" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>Read a stream list from this file for multi-station mode</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="option">
|
|
|
<dt id="id4">
|
|
|
<code class="sig-name descname">-S</code><code class="sig-prename descclassname"> streams</code><a class="headerlink" href="#id4" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>Define a stream list for multi-station mode.</p>
|
|
|
<p>‘streams’ = ‘stream1[:selectors1],stream2[:selectors2],…’</p>
|
|
|
<p>‘stream’ is in NET_STA format, for example:</p>
|
|
|
<p>-S “IU_KONO:BHE BHN,GE_WLF,MN_AQU:HH?.D”</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="option">
|
|
|
<dt id="cmdoption-slinktool-tw">
|
|
|
<code class="sig-name descname">-tw</code><code class="sig-prename descclassname"> begin:[end]</code><a class="headerlink" href="#cmdoption-slinktool-tw" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>Specify a time window in year,month,day,hour,min,sec format.</p>
|
|
|
<p>Example: -tw 2002,08,05,14,00,00:2002,08,05,14,15,00</p>
|
|
|
<p>The end time is optional, but the colon must be present.</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
</div>
|
|
|
<div class="section" id="data-saving-options">
|
|
|
<h3>Data saving options<a class="headerlink" href="#data-saving-options" title="Permalink to this headline">¶</a></h3>
|
|
|
<dl class="option">
|
|
|
<dt id="cmdoption-slinktool-o">
|
|
|
<code class="sig-name descname">-o</code><code class="sig-prename descclassname"> dumpfile</code><a class="headerlink" href="#cmdoption-slinktool-o" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>Write all received records to this file</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="option">
|
|
|
<dt id="cmdoption-slinktool-a">
|
|
|
<code class="sig-name descname">-A</code><code class="sig-prename descclassname"> format</code><a class="headerlink" href="#cmdoption-slinktool-a" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>If specified, all received packets (Mini-SEED records) will be appended to a directory/file
|
|
|
structure defined by format. All directories implied in the format string will be created if
|
|
|
necessary.</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="option">
|
|
|
<dt id="cmdoption-slinktool-sds">
|
|
|
<code class="sig-name descname">-SDS</code><code class="sig-prename descclassname"> SDSdir</code><a class="headerlink" href="#cmdoption-slinktool-sds" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>If specified, all received packets (Mini-SEED records) will be saved into a Simple Data
|
|
|
Structure (SDS) dir/file structure starting at the specified directory. This directory and
|
|
|
all subdirectories will be created if necessary. This option is a preset of the ‘-A’ option.
|
|
|
The SDS dir/file structure is:</p>
|
|
|
<p><SDSdir>/<YEAR>/<NET>/<STA>/<CHAN.TYPE>/NET.STA.LOC.CHAN.TYPE.YEAR.DAY</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="option">
|
|
|
<dt id="cmdoption-slinktool-bud">
|
|
|
<code class="sig-name descname">-BUD</code><code class="sig-prename descclassname"> BUDdir</code><a class="headerlink" href="#cmdoption-slinktool-bud" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>If specified, all received waveform data packets (Mini-SEED data records) will be saved into
|
|
|
a Buffer of Uniform Data (BUD) dir/file structure starting at the specified directory.
|
|
|
This directory and all subdirectories will be created if necessary. This option is a preset
|
|
|
of the ‘-A’ option. The BUD dir/file structure is:</p>
|
|
|
<p><BUDdir>/<NET>/<STA>/STA.NET.LOC.CHAN.YEAR.DAY</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
</div>
|
|
|
<div class="section" id="data-server">
|
|
|
<h3>Data server<a class="headerlink" href="#data-server" title="Permalink to this headline">¶</a></h3>
|
|
|
<dl class="option">
|
|
|
<dt id="cmdoption-slinktool-i">
|
|
|
<code class="sig-name descname">-i</code><code class="sig-prename descclassname"> type</code><a class="headerlink" href="#cmdoption-slinktool-i" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>Send info request, type is one of the following:</p>
|
|
|
<p>ID, CAPABILITIES, STATIONS, STREAMS, GAPS, CONNECTIONS, ALL</p>
|
|
|
<p>The returned raw XML is displayed when using this option.</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="option">
|
|
|
<dt id="id5">
|
|
|
<code class="sig-name descname">-I</code><code class="sig-prename descclassname"></code><a class="headerlink" href="#id5" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>Print formatted server id and version</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="option">
|
|
|
<dt id="id6">
|
|
|
<code class="sig-name descname">-L</code><code class="sig-prename descclassname"></code><a class="headerlink" href="#id6" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>Print formatted station list (if supported by server)</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="option">
|
|
|
<dt id="cmdoption-slinktool-q">
|
|
|
<code class="sig-name descname">-Q</code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-slinktool-q" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>Print formatted stream list (if supported by server)</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="option">
|
|
|
<dt id="cmdoption-slinktool-g">
|
|
|
<code class="sig-name descname">-G</code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-slinktool-g" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>Print formatted gap list (if supported by server)</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="option">
|
|
|
<dt id="cmdoption-slinktool-c">
|
|
|
<code class="sig-name descname">-C</code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-slinktool-c" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>Print formatted connection list (if supported by server)</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
</div>
|
|
|
</div>
|
|
|
</div>
|
|
|
|
|
|
|
|
|
<div id="anchors-bottom"></div>
|
|
|
</div>
|
|
|
|
|
|
<div class="sidebar" role="navigation" aria-label="main navigation">
|
|
|
<div id="anchors-top"></div>
|
|
|
<div id="anchors" class="content">
|
|
|
<div id="searchbox" style="display: none" role="search">
|
|
|
<h3 id="searchlabel">Quick search</h3>
|
|
|
<div class="searchformwrapper">
|
|
|
<form class="search" action="../search.html" method="get">
|
|
|
<input type="text" name="q" aria-labelledby="searchlabel" />
|
|
|
<input type="submit" value="Go" />
|
|
|
</form>
|
|
|
</div>
|
|
|
</div>
|
|
|
<script>$('#searchbox').show(0);</script>
|
|
|
<h3><a href="../index.html">Table of Contents</a></h3>
|
|
|
<ul>
|
|
|
<li><a class="reference internal" href="#">slinktool</a><ul>
|
|
|
<li><a class="reference internal" href="#description">Description</a></li>
|
|
|
<li><a class="reference internal" href="#examples">Examples</a><ul>
|
|
|
<li><a class="reference internal" href="#all-station-uni-station-mode">All-station/Uni-station mode</a></li>
|
|
|
<li><a class="reference internal" href="#multi-station-mode">Multi-station mode</a></li>
|
|
|
<li><a class="reference internal" href="#wildcarding-network-and-station-codes">Wildcarding network and station codes</a></li>
|
|
|
</ul>
|
|
|
</li>
|
|
|
<li><a class="reference internal" href="#seedlink-selectors">Seedlink Selectors</a></li>
|
|
|
<li><a class="reference internal" href="#archiving-data">Archiving Data</a></li>
|
|
|
<li><a class="reference internal" href="#stream-list-file">Stream List File</a></li>
|
|
|
<li><a class="reference internal" href="#author-of-slinktool">Author of slinktool</a></li>
|
|
|
<li><a class="reference internal" href="#command-line-options">Command-Line Options</a><ul>
|
|
|
<li><a class="reference internal" href="#general-program-options">General program options</a></li>
|
|
|
<li><a class="reference internal" href="#data-stream-selection">Data stream selection</a></li>
|
|
|
<li><a class="reference internal" href="#data-saving-options">Data saving options</a></li>
|
|
|
<li><a class="reference internal" href="#data-server">Data server</a></li>
|
|
|
</ul>
|
|
|
</li>
|
|
|
</ul>
|
|
|
</li>
|
|
|
</ul>
|
|
|
|
|
|
<h4>Previous topic</h4>
|
|
|
<p class="topless"><a href="slarchive.html"
|
|
|
title="previous chapter">slarchive</a></p>
|
|
|
<h4>Next topic</h4>
|
|
|
<p class="topless"><a href="../toc/inventory.html"
|
|
|
title="next chapter">Inventory</a></p>
|
|
|
<div role="note" aria-label="source link">
|
|
|
<h3>This Page</h3>
|
|
|
<ul class="this-page-menu">
|
|
|
<li><a href="../_sources/apps/slinktool.rst.txt"
|
|
|
rel="nofollow">Show Source</a></li>
|
|
|
</ul>
|
|
|
</div>
|
|
|
</div>
|
|
|
</div>
|
|
|
</div>
|
|
|
</div>
|
|
|
<div class="footer">
|
|
|
<div class="container">
|
|
|
<div class="horizontal layout content">
|
|
|
<a class="fade-in" href="https://www.gempa.de" target="_blank">
|
|
|
<img class="brand" src="../_static/brands/gempa.svg"/>
|
|
|
</a>
|
|
|
<div class="stretched align-center fitted content">
|
|
|
<div>
|
|
|
Version <b>5.3.0</b> Release
|
|
|
</div>
|
|
|
<div class="copyright">
|
|
|
Copyright © gempa GmbH, GFZ Potsdam.
|
|
|
</div>
|
|
|
</div>
|
|
|
<a class="fade-in" href="https://www.gfz-potsdam.de" target="_blank">
|
|
|
<img class="brand" src="../_static/brands/gfz.svg"/>
|
|
|
</a>
|
|
|
</div>
|
|
|
</div>
|
|
|
</div>
|
|
|
</body>
|
|
|
</html> |