SCRUG-NA/2025
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
7086945aa7e567bfbb4706be44ddca4f6a8a4a9d
2025/share/doc/seiscomp/html/apps/scart.html

532 lines
37 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>scart &#8212; 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/pygments.css?v=72bcf2f2" />
<link rel="stylesheet" type="text/css" href="../_static/seiscomp.css?v=c6da7ce6" />
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<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 data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script src="../_static/doctools.js?v=888ff710"></script>
<script src="../_static/sphinx_highlight.js?v=4825356b"></script>
<link rel="index" title="Index" href="../genindex.html" />
<link rel="search" title="Search" href="../search.html" />
<link rel="next" title="scbulletin" href="scbulletin.html" />
<link rel="prev" title="scalert" href="scalert.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">6.9.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="scbulletin.html" title="scbulletin"
accesskey="N">
next
</a>
</li>
<li class="right">
<a href="scalert.html" title="scalert"
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/utilities.html" accesskey="U">Utilities</a>
</li>
</ul>
</div>
</div>
</div>
</div>
<div class="container">
<div class="fitted content" id="anchors-container">
<div class="body" role="main">
<section id="scart">
<span id="id1"></span><h1>scart<a class="headerlink" href="#scart" title="Permalink to this heading"></a></h1>
<p><strong>Import/export MiniSEED data to/from SDS archives.</strong></p>
<section id="description">
<h2>Description<a class="headerlink" href="#description" title="Permalink to this heading"></a></h2>
<p>The archive tool scart reads and writes <a class="reference internal" href="../base/glossary.html#term-SDS"><span class="xref std std-term">SDS</span></a> archives and files
in miniSEED format and checks miniSEED archives or prints stream information.</p>
<ul class="simple">
<li><p><strong>Dump mode:</strong> Create miniSEED files (multiplexed), e.g. for playbacks, from
<a class="reference internal" href="../base/glossary.html#term-SDS"><span class="xref std std-term">SDS</span></a> structured data (e.g. created by slarchive).</p></li>
<li><p><strong>Dump mode:</strong> Play back records directly out of an SDS structure.</p></li>
<li><p><strong>Import mode:</strong> Import multiplexed miniSEED files into a local SDS waveform
archive.</p></li>
<li><p><strong>Import mode:</strong> Import data using the <a class="reference internal" href="global_recordstream.html#global-recordstream"><span class="std std-ref">RecordStream</span></a> interface
into a local SDS waveform archive.</p></li>
<li><p><strong>Import mode:</strong> Read data from any <a class="reference internal" href="global_recordstream.html#global-recordstream"><span class="std std-ref">RecordStream</span></a> interface
and dump it to file.</p></li>
<li><p><strong>Check mode:</strong> Check an archive of miniSEED files for out-of-order records in
files.</p></li>
</ul>
<div class="admonition warning">
<p class="admonition-title">Warning</p>
<ul class="simple">
<li><p>When creating <a class="reference internal" href="../base/glossary.html#term-SDS"><span class="xref std std-term">SDS</span></a> archives, scart simply appends the new records to
existing ones. Multiple imports of the same data result in duplication.</p></li>
<li><p>Out-of-order imports of waveforms into a SDS archive result in out-of-order
records which may not be processed. Clean your archive using <a class="reference internal" href="scmssort.html#scmssort"><span class="std std-ref">scmssort</span></a>.</p></li>
<li><p><strong>Before importing miniSEED data</strong> into an SDS archive they must be sorted
by time and duplicate records must be removed. Otherwise, the SDS archive
may not be correctly readable by other modules. Therefore, combine scart
with <a class="reference internal" href="scmssort.html#scmssort"><span class="std std-ref">scmssort</span></a> for multiplexing and removal of duplicates.</p></li>
</ul>
</div>
<div class="admonition hint">
<p class="admonition-title">Hint</p>
<p>In dump and import mode output streams may be filtered by</p>
<ul class="simple">
<li><p>Time windows (<code class="xref std std-option docutils literal notranslate"><span class="pre">-t</span></code>),</p></li>
<li><p>Network-station-location-channel (NSLC) lists (<code class="xref std std-option docutils literal notranslate"><span class="pre">--nslc</span></code>) created,
e.g., with</p>
<ul>
<li><p><a class="reference internal" href="scinv.html#scinv"><span class="std std-ref">scinv</span></a> from inventories,</p></li>
<li><p><a class="reference internal" href="scdumpcfg.html#scdumpcfg"><span class="std std-ref">scdumpcfg</span></a> from bindings configuration,</p></li>
<li><p>scart itself from other miniSEED files or achives.</p></li>
</ul>
</li>
</ul>
<p>In dump mode output streams may also be filtered by</p>
<ul class="simple">
<li><p>Time window - stream lists (<code class="xref std std-option docutils literal notranslate"><span class="pre">--list</span></code>, dump mode) generated by
<a class="reference internal" href="scevtstreams.html#scevtstreams"><span class="std std-ref">scevtstreams</span></a> for particular events.</p></li>
</ul>
<p>Time strings may be given in
* ISO time format, e.g., 2023-03-28T15:48:00
* or the ‘old’ SeisComP time format with empty character between date and time, e.g.,
‘2023-03-28 15:48:00’.</p>
<p>When omitting seconds, minutes or hours values of zero are implied.</p>
</div>
</section>
<section id="configuration">
<span id="scart-config"></span><h2>Configuration<a class="headerlink" href="#configuration" title="Permalink to this heading"></a></h2>
<p>scart can make use of <a class="reference internal" href="global_recordstream.html#global-recordstream"><span class="std std-ref">RecordStream</span></a> implementations which are
provided by additional plugins. For loading additional plugins, e.g. the <em>xyz</em>
plugin create and configure <code class="file docutils literal notranslate"><span class="pre">scart.cfg</span></code>:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="nv">plugins</span><span class="w"> </span><span class="o">=</span><span class="w"> </span>xyz
</pre></div>
</div>
</section>
<section id="examples">
<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this heading"></a></h2>
<div class="admonition hint">
<p class="admonition-title">Hint</p>
<p>The usage of wildcards in place of network, station, location or channel code
is allowed in many options (<code class="xref std std-option docutils literal notranslate"><span class="pre">-n</span></code>, <code class="xref std std-option docutils literal notranslate"><span class="pre">-c</span></code>, <code class="xref std std-option docutils literal notranslate"><span class="pre">-l</span></code>,
<code class="xref std std-option docutils literal notranslate"><span class="pre">--list</span></code>, <code class="xref std std-option docutils literal notranslate"><span class="pre">--nslc</span></code>) and follows these rules:</p>
<ul class="simple">
<li><p>Import mode: the wildcards are passed to the <a class="reference internal" href="global_recordstream.html#global-recordstream"><span class="std std-ref">RecordStream</span></a> interface,
that interprets them. Normally both “*” and “?” are supported by RecordStreams.</p></li>
<li><p>Dump mode: the wildcards are interpreted by scart command that supports “*” for
network, station, location codes and “*”, “?”, “(”, “)”, “|” for channel code.</p></li>
</ul>
</div>
<ol class="arabic">
<li><p>Extract data from the default <a class="reference internal" href="../base/glossary.html#term-SDS"><span class="xref std std-term">SDS</span></a> archive in <code class="file docutils literal notranslate"><span class="pre">$SEISCOMP_ROOT/var/lib/archive</span></code>
or from a local <a class="reference internal" href="../base/glossary.html#term-SDS"><span class="xref std std-term">SDS</span></a> archive [SDS archive] into a miniSEED file <code class="file docutils literal notranslate"><span class="pre">file.mseed</span></code>
and sort by end time of the records:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>scart<span class="w"> </span>-dsvE<span class="w"> </span>-t<span class="w"> </span><span class="s1">&#39;[start-time]~[end-time]&#39;</span><span class="w"> </span><span class="o">[</span>SDS<span class="w"> </span>archive<span class="o">]</span><span class="w"> </span>&gt;<span class="w"> </span><span class="o">[</span>file.mseed<span class="o">]</span>
scart<span class="w"> </span>-dsvE<span class="w"> </span>-t<span class="w"> </span><span class="s1">&#39;[start-time]~[end-time]&#39;</span><span class="w"> </span>&gt;<span class="w"> </span>file.mseed
scart<span class="w"> </span>-dsvE<span class="w"> </span>-t<span class="w"> </span><span class="s1">&#39;[start-time]~[end-time]&#39;</span><span class="w"> </span>-n<span class="w"> </span><span class="s1">&#39;[NET1],[NET2]&#39;</span><span class="w"> </span>&gt;<span class="w"> </span>file.mseed
scart<span class="w"> </span>-dsvE<span class="w"> </span>-t<span class="w"> </span><span class="s1">&#39;[start-time]~[end-time]&#39;</span><span class="w"> </span>-n<span class="w"> </span><span class="s1">&#39;[NET]&#39;</span><span class="w"> </span>-c<span class="w"> </span><span class="s1">&#39;(E,H)H(1,2,3)&#39;</span><span class="w"> </span>&gt;<span class="w"> </span>file.mseed
scart<span class="w"> </span>-dsvE<span class="w"> </span>-t<span class="w"> </span><span class="s1">&#39;[start-time]~[end-time]&#39;</span><span class="w"> </span>-n<span class="w"> </span><span class="s1">&#39;[N1.S1.L1.C1],[N2.S2.L2.C2]&#39;</span><span class="w"> </span>&gt;<span class="w"> </span>file.mseed
scart<span class="w"> </span>-dsvE<span class="w"> </span>-t<span class="w"> </span><span class="s1">&#39;[start-time]~[end-time]&#39;</span><span class="w"> </span>--nslc<span class="w"> </span>list.file<span class="w"> </span>&gt;<span class="w"> </span>file.mseed
scart<span class="w"> </span>-dsvE<span class="w"> </span>-t<span class="w"> </span>--list<span class="w"> </span>list.file<span class="w"> </span>&gt;<span class="w"> </span>file.mseed
</pre></div>
</div>
<p>It is possible to achieve the same result of the dump mode using a
combination of the input mode and the <a class="reference internal" href="scmssort.html#scmssort"><span class="std std-ref">scmssort</span></a> command, which allows
to read the input data from any supported <a class="reference internal" href="global_recordstream.html#global-recordstream"><span class="std std-ref">RecordStream</span></a>,
not only an SDS archive:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>scart<span class="w"> </span>-I<span class="w"> </span><span class="o">[</span>record-stream<span class="o">]</span><span class="w"> </span>--list<span class="w"> </span>list.file<span class="w"> </span>--stdout<span class="w"> </span><span class="p">|</span><span class="w"> </span>scmssort<span class="w"> </span>-u<span class="w"> </span>-E<span class="w"> </span>-v<span class="w"> </span>&gt;<span class="w"> </span>file.mseed
</pre></div>
</div>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>Sorting data is computational expensive but required for waveform playbacks.</p>
</div>
</li>
<li><p>Push miniSEED data from file <code class="file docutils literal notranslate"><span class="pre">file.mseed</span></code> or standard input
(stdin) into a local <a class="reference internal" href="../base/glossary.html#term-SDS"><span class="xref std std-term">SDS</span></a> archive or a file. Additionally, you may
check if the records of archived files are correctly ordered, filter by time
and/or with NSLC list and print the output streams:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>scmssort<span class="w"> </span>-u<span class="w"> </span>-E<span class="w"> </span><span class="o">[</span>file.mseed<span class="o">]</span><span class="w"> </span>&gt;<span class="w"> </span>sorted.mseed
scart<span class="w"> </span>-I<span class="w"> </span>sorted.mseed<span class="w"> </span>--with-filecheck<span class="w"> </span><span class="o">[</span>SDS<span class="w"> </span>archive<span class="o">]</span>
scart<span class="w"> </span>-I<span class="w"> </span><span class="o">[</span>file.mseed<span class="o">]</span><span class="w"> </span>-t<span class="w"> </span><span class="s1">&#39;[start-time]~[end-time]&#39;</span><span class="w"> </span>--print-streams<span class="w"> </span>--nslc<span class="w"> </span>list.file<span class="w"> </span>-o<span class="w"> </span><span class="o">[</span>out.mseed<span class="o">]</span>
cat<span class="w"> </span>sorted.mseed<span class="w"> </span><span class="p">|</span><span class="w"> </span>scart<span class="w"> </span>-I<span class="w"> </span>-<span class="w"> </span><span class="o">[</span>SDS<span class="w"> </span>archive<span class="o">]</span>
cat<span class="w"> </span>sorted.mseed<span class="w"> </span><span class="p">|</span><span class="w"> </span>scart<span class="w"> </span><span class="o">[</span>SDS<span class="w"> </span>archive<span class="o">]</span>
</pre></div>
</div>
</li>
<li><p>Collect data using the <a class="reference internal" href="global_recordstream.html#global-recordstream"><span class="std std-ref">RecordStream</span></a> interface (e.g. FDSNWS server)
and write to a miniSEED file or import it into a local <a class="reference internal" href="../base/glossary.html#term-SDS"><span class="xref std std-term">SDS</span></a> archive. The
data streams and the time spans can be defined in several ways. The data streams
(<code class="xref std std-option docutils literal notranslate"><span class="pre">--list</span></code>) can be automatically generated, e.g., by <a class="reference internal" href="scevtstreams.html#scevtstreams"><span class="std std-ref">scevtstreams</span></a>.</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>scart<span class="w"> </span>-I<span class="w"> </span>fdsnws://<span class="o">[</span>server<span class="o">]</span>:80<span class="w"> </span>--list<span class="w"> </span>list.file<span class="w"> </span><span class="o">[</span>SDS<span class="w"> </span>archive<span class="o">]</span>
scart<span class="w"> </span>-I<span class="w"> </span>fdsnws://<span class="o">[</span>server<span class="o">]</span>:80<span class="w"> </span>--list<span class="w"> </span>list.file<span class="w"> </span>-o<span class="w"> </span>file.mseed
scart<span class="w"> </span>-I<span class="w"> </span>fdsnws://<span class="o">[</span>server<span class="o">]</span>:80<span class="w"> </span>-t<span class="w"> </span><span class="s1">&#39;[start-time]~[end-time]&#39;</span><span class="w"> </span>--nslc<span class="w"> </span>list.file<span class="w"> </span><span class="o">[</span>SDS<span class="w"> </span>archive<span class="o">]</span>
scart<span class="w"> </span>-I<span class="w"> </span>fdsnws://<span class="o">[</span>server<span class="o">]</span>:80<span class="w"> </span>-t<span class="w"> </span><span class="s1">&#39;[start-time]~[end-time]&#39;</span><span class="w"> </span>-n<span class="w"> </span><span class="s1">&#39;[NET1],[NET2]&#39;</span><span class="w"> </span><span class="o">[</span>SDS<span class="w"> </span>archive<span class="o">]</span>
scart<span class="w"> </span>-I<span class="w"> </span>fdsnws://<span class="o">[</span>server<span class="o">]</span>:80<span class="w"> </span>-t<span class="w"> </span><span class="s1">&#39;[start-time]~[end-time]&#39;</span><span class="w"> </span>-n<span class="w"> </span><span class="s1">&#39;[NET]&#39;</span><span class="w"> </span>-c<span class="w"> </span><span class="s1">&#39;EH?&#39;</span><span class="w"> </span><span class="o">[</span>SDS<span class="w"> </span>archive<span class="o">]</span>
scart<span class="w"> </span>-I<span class="w"> </span>fdsnws://<span class="o">[</span>server<span class="o">]</span>:80<span class="w"> </span>-t<span class="w"> </span><span class="s1">&#39;[start-time]~[end-time]&#39;</span><span class="w"> </span>-n<span class="w"> </span><span class="s1">&#39;[N1.S1.L1.C1],[N2.S2.L2.C2]&#39;</span><span class="w"> </span><span class="o">[</span>SDS<span class="w"> </span>archive<span class="o">]</span>
</pre></div>
</div>
</li>
<li><p>Check all files of an SDS archive or other directory structure for
miniSEED files with out-of-order records:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>scart<span class="w"> </span>--check<span class="w"> </span><span class="o">[</span>archive<span class="o">]</span>
</pre></div>
</div>
</li>
<li><p>Print stream information from miniSEED files in archives or from
<a class="reference internal" href="../base/glossary.html#term-RecordStream"><span class="xref std std-term">RecordStream</span></a> without actually writing miniSEED data. In dump and
import mode use the <code class="xref std std-option docutils literal notranslate"><span class="pre">--test</span></code> if miniSEED data shall be read but not
written.</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>scart<span class="w"> </span>--print-streams<span class="w"> </span>-I<span class="w"> </span><span class="o">[</span>miniSEED<span class="w"> </span>file<span class="o">]</span><span class="w"> </span>--test
scart<span class="w"> </span>--print-streams<span class="w"> </span>-d<span class="w"> </span>-t<span class="w"> </span><span class="o">[</span><span class="nb">time</span><span class="w"> </span>span<span class="o">]</span><span class="w"> </span>--test<span class="w"> </span><span class="o">[</span>SDS<span class="w"> </span>archive<span class="o">]</span>
scart<span class="w"> </span>--print-streams<span class="w"> </span>--check<span class="w"> </span><span class="o">[</span>archive<span class="o">]</span>
</pre></div>
</div>
<p>The output looks like this:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="c1"># streamID start end records samples samplingRate</span>
GE.RGN..BHZ<span class="w"> </span><span class="m">2022</span>-12-08T15:34:41.895Z<span class="w"> </span><span class="m">2022</span>-12-08T15:52:19.145Z<span class="w"> </span><span class="m">58</span><span class="w"> </span><span class="m">21145</span><span class="w"> </span><span class="m">20</span>.0
</pre></div>
</div>
<p>where the header and the text body are printed to stderr.</p>
</li>
</ol>
</section>
<section id="command-line-options">
<h2>Command-Line Options<a class="headerlink" href="#command-line-options" title="Permalink to this heading"></a></h2>
<p><strong class="program">scart [options] {archive-dir}</strong></p>
<p>The last option has to be the archive directory when dump mode is enabled.
When no archive directory is explicitly given,
$SEISCOMP_ROOT/var/lib/archive or the current directory
is used depending on whether $SEISCOMP_ROOT has been set or not.
The default operation mode is import. That means that a multiplexed
MiniSEED file or another record source such as ArcLink is used to import
records into a SDS structure.</p>
<section id="verbosity">
<h3>Verbosity<a class="headerlink" href="#verbosity" title="Permalink to this heading"></a></h3>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scart-v">
<span id="cmdoption-scart-verbose"></span><span class="sig-name descname"><span class="pre">-v</span></span><span class="sig-prename descclassname"></span><span class="sig-prename descclassname"><span class="pre">,</span> </span><span class="sig-name descname"><span class="pre">--verbose</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-scart-v" title="Permalink to this definition"></a></dt>
<dd><p>Verbose mode.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scart-h">
<span id="cmdoption-scart-help"></span><span class="sig-name descname"><span class="pre">-h</span></span><span class="sig-prename descclassname"></span><span class="sig-prename descclassname"><span class="pre">,</span> </span><span class="sig-name descname"><span class="pre">--help</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-scart-h" title="Permalink to this definition"></a></dt>
<dd><p>Display a help message.</p>
</dd></dl>
</section>
<section id="mode">
<h3>Mode<a class="headerlink" href="#mode" title="Permalink to this heading"></a></h3>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scart-check">
<span class="sig-name descname"><span class="pre">--check</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-scart-check" title="Permalink to this definition"></a></dt>
<dd><p>Check mode. Check all files
in the given directory for erroneous miniSEED records.
All sub-directories are included. If no directory is given,
the default SDS archive is scanned. Checks are only complete
for files containing exactly one stream. More complete checks
are made with scmssort.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scart-d">
<span id="cmdoption-scart-dump"></span><span class="sig-name descname"><span class="pre">-d</span></span><span class="sig-prename descclassname"></span><span class="sig-prename descclassname"><span class="pre">,</span> </span><span class="sig-name descname"><span class="pre">--dump</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-scart-d" title="Permalink to this definition"></a></dt>
<dd><p>Set export (dump) mode. Records are retrieved from an archive and
written to standard output.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scart-I">
<span class="sig-name descname"><span class="pre">-I</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-scart-I" title="Permalink to this definition"></a></dt>
<dd><p>Import mode (default): Specify the recordstream URL to read
the data from for archiving. When using any other
recordstream than file, a stream list file is needed.
Specifying - implies <a class="reference external" href="file://">file://</a>- (stdin). If no mode is
explicitly specified, -I <a class="reference external" href="file://">file://</a>- is assumed.</p>
</dd></dl>
</section>
<section id="processing">
<h3>Processing<a class="headerlink" href="#processing" title="Permalink to this heading"></a></h3>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scart-c">
<span class="sig-name descname"><span class="pre">-c</span></span><span class="sig-prename descclassname"> <span class="pre">channels</span></span><a class="headerlink" href="#cmdoption-scart-c" title="Permalink to this definition"></a></dt>
<dd><p>Channel filter to be applied to the data streams.
Default for Dump: &quot;(B|E|H|M|S)(D|H|L|N)(E|F|N|Z|1|2|3)&quot;
Default for Import: &quot;*&quot;</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scart-E">
<span class="sig-name descname"><span class="pre">-E</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-scart-E" title="Permalink to this definition"></a></dt>
<dd><p>Dump mode: sort records according to their end time.
Default: start time.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scart-files">
<span class="sig-name descname"><span class="pre">--files</span></span><span class="sig-prename descclassname"> <span class="pre">count</span></span><a class="headerlink" href="#cmdoption-scart-files" title="Permalink to this definition"></a></dt>
<dd><p>Dump mode: Specify the number of file handles to cache.
Default: 100.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scart-i">
<span class="sig-name descname"><span class="pre">-i</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-scart-i" title="Permalink to this definition"></a></dt>
<dd><p>Ignore records without data samples.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scart-l">
<span id="cmdoption-scart-list"></span><span class="sig-name descname"><span class="pre">-l</span></span><span class="sig-prename descclassname"></span><span class="sig-prename descclassname"><span class="pre">,</span> </span><span class="sig-name descname"><span class="pre">--list</span></span><span class="sig-prename descclassname"> <span class="pre">file</span></span><a class="headerlink" href="#cmdoption-scart-l" title="Permalink to this definition"></a></dt>
<dd><p>Import, dump mode: Use a stream list file with time windows instead
of defined networks and channels (-n, -c and -t are ignored).
The list can be generated from events by scevtstreams. One
line per stream. Line format: starttime;endtime;streamID
The time format is the same as described in option ‘-t’.</p>
<p>Example:</p>
<p>2019-07-17 02:00:00;2019-07-17 02:10:00;GR.CLL..BH?</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scart-m">
<span id="cmdoption-scart-modify"></span><span class="sig-name descname"><span class="pre">-m</span></span><span class="sig-prename descclassname"></span><span class="sig-prename descclassname"><span class="pre">,</span> </span><span class="sig-name descname"><span class="pre">--modify</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-scart-m" title="Permalink to this definition"></a></dt>
<dd><p>Dump mode: Modify the record time for real time playback.
The first record time is NOW. The relative time of
successive records to the first one are kept.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scart-n">
<span class="sig-name descname"><span class="pre">-n</span></span><span class="sig-prename descclassname"> <span class="pre">networks</span></span><a class="headerlink" href="#cmdoption-scart-n" title="Permalink to this definition"></a></dt>
<dd><p>Import, dump mode: Data stream selection as a comma separated list
&quot;stream1,stream2,streamX&quot; where each stream can be NET or NET.STA
or NET.STA.LOC or NET.STA.LOC.CHA.
If CHA is omitted, it defaults to the value of -c option.
Default: &quot;*&quot;</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scart-nslc">
<span class="sig-name descname"><span class="pre">--nslc</span></span><span class="sig-prename descclassname"> <span class="pre">file</span></span><a class="headerlink" href="#cmdoption-scart-nslc" title="Permalink to this definition"></a></dt>
<dd><p>Import, dump mode: Stream list file to be used instead of
defined networks and channels (-n and -c are ignored)
for filtering the data by the given streams. Dump mode:
Use in combination with -t! One line per stream, line
format: NET.STA.LOC.CHA</p>
<p>Example:</p>
<p>GR.CLL..BH?</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scart-rename">
<span class="sig-name descname"><span class="pre">--rename</span></span><span class="sig-prename descclassname"> <span class="pre">rule</span></span><a class="headerlink" href="#cmdoption-scart-rename" title="Permalink to this definition"></a></dt>
<dd><p>Import, dump mode: Rename stream data according to the provided
rule(s). A rule is &quot;[match-stream:]rename-stream&quot; and match-stream
is optional. match-stream and rename-stream are in the
&quot;NET.STA.LOC.CHA&quot; format. match-stream supports special
charactes &quot;?&quot; &quot;*&quot; &quot;|&quot; &quot;(&quot; &quot;)&quot;. rename-stream supports the
special character &quot;-&quot; that can be used in place of NET, STA,
LOC, CHA codes with the meaning of not renaming those.
&quot;-&quot; can also be used as the last character in CHA code.
Multiple rules can be provided as a comma separated list
or by providing multiple --rename options.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scart-s">
<span id="cmdoption-scart-sort"></span><span class="sig-name descname"><span class="pre">-s</span></span><span class="sig-prename descclassname"></span><span class="sig-prename descclassname"><span class="pre">,</span> </span><span class="sig-name descname"><span class="pre">--sort</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-scart-s" title="Permalink to this definition"></a></dt>
<dd><p>Dump mode: Sort records by [start-]time. To sort records by their
end time use -E.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scart-speed">
<span class="sig-name descname"><span class="pre">--speed</span></span><span class="sig-prename descclassname"> <span class="pre">value</span></span><a class="headerlink" href="#cmdoption-scart-speed" title="Permalink to this definition"></a></dt>
<dd><p>Dump mode: Specify the speed to dump the records. A value of 0 means
no delay otherwise speed is a multiplier of the real time difference
between the records. When feeding the records directly into the replay
pipe a value of 1 (real time) is recommended.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scart-t">
<span id="cmdoption-scart-time-window"></span><span class="sig-name descname"><span class="pre">-t</span></span><span class="sig-prename descclassname"></span><span class="sig-prename descclassname"><span class="pre">,</span> </span><span class="sig-name descname"><span class="pre">--time-window</span></span><span class="sig-prename descclassname"> <span class="pre">timeWindow</span></span><a class="headerlink" href="#cmdoption-scart-t" title="Permalink to this definition"></a></dt>
<dd><p>Import, dump mode: Specify the time window (as one properly
quoted string) to dump records for. Times are UTC and
separated by a tilde &quot;~&quot;. To dump one hour of
waveform data between 2008/01/01 00:00:00 and 2008/01/01
01:00:00 use
&lt;-t 2008-01-01T00:00:00~2008-01-01T01:00:00&gt;.</p>
</dd></dl>
</section>
<section id="output">
<h3>Output<a class="headerlink" href="#output" title="Permalink to this heading"></a></h3>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scart-o">
<span id="cmdoption-scart-output"></span><span class="sig-name descname"><span class="pre">-o</span></span><span class="sig-prename descclassname"></span><span class="sig-prename descclassname"><span class="pre">,</span> </span><span class="sig-name descname"><span class="pre">--output</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-scart-o" title="Permalink to this definition"></a></dt>
<dd><p>Dump, Import mode: Write data to given file instead of creating
a SDS archive. Deactivates --stdout. Deactivated by --test.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scart-print-streams">
<span class="sig-name descname"><span class="pre">--print-streams</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-scart-print-streams" title="Permalink to this definition"></a></dt>
<dd><p>Print stream information only and exit. Works in import, dump
and check mode. Output: NET.STA.LOC.CHA StartTime EndTime.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scart-stdout">
<span class="sig-name descname"><span class="pre">--stdout</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-scart-stdout" title="Permalink to this definition"></a></dt>
<dd><p>Import mode: Write to stdout instead of creating a SDS archive.
Deactivated by --test and --output.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scart-test">
<span class="sig-name descname"><span class="pre">--test</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-scart-test" title="Permalink to this definition"></a></dt>
<dd><p>Test input only, deactivate all miniSEED output. This switch is
useful for debugging and printing stream information with
--print-streams.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scart-with-filecheck">
<span class="sig-name descname"><span class="pre">--with-filecheck</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-scart-with-filecheck" title="Permalink to this definition"></a></dt>
<dd><p>Import mode: Check all accessed files. Unsorted or unreadable
files are reported to stderr. Checks are only complete
for files containing exactly one stream. More complete
checks are made with scmssort.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scart-with-filename">
<span class="sig-name descname"><span class="pre">--with-filename</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-scart-with-filename" title="Permalink to this definition"></a></dt>
<dd><p>Import mode: Print all accessed files to stderr after import.</p>
</dd></dl>
</section>
</section>
</section>
<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" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
<input type="submit" value="Go" />
</form>
</div>
</div>
<script>document.getElementById('searchbox').style.display = "block"</script>
<div>
<h3><a href="../index.html">Table of Contents</a></h3>
<ul>
<li><a class="reference internal" href="#">scart</a><ul>
<li><a class="reference internal" href="#description">Description</a></li>
<li><a class="reference internal" href="#configuration">Configuration</a></li>
<li><a class="reference internal" href="#examples">Examples</a></li>
<li><a class="reference internal" href="#command-line-options">Command-Line Options</a><ul>
<li><a class="reference internal" href="#verbosity">Verbosity</a></li>
<li><a class="reference internal" href="#mode">Mode</a></li>
<li><a class="reference internal" href="#processing">Processing</a></li>
<li><a class="reference internal" href="#output">Output</a></li>
</ul>
</li>
</ul>
</li>
</ul>
</div>
<div>
<h4>Previous topic</h4>
<p class="topless"><a href="scalert.html"
title="previous chapter">scalert</a></p>
</div>
<div>
<h4>Next topic</h4>
<p class="topless"><a href="scbulletin.html"
title="next chapter">scbulletin</a></p>
</div>
<div role="note" aria-label="source link">
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="../_sources/apps/scart.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>6.9.0</b> Release
</div>
<div class="copyright">
Copyright &copy; 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>
Reference in New Issue View Git Blame Copy Permalink