[seiscomp, scanloc] Install, add .gitignore
This commit is contained in:
532
share/doc/seiscomp/html/apps/scart.html
Normal file
532
share/doc/seiscomp/html/apps/scart.html
Normal file
@ -0,0 +1,532 @@
|
||||
<!DOCTYPE html>
|
||||
|
||||
<html lang="en">
|
||||
<head>
|
||||
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
|
||||
|
||||
<title>scart — 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">'[start-time]~[end-time]'</span><span class="w"> </span><span class="o">[</span>SDS<span class="w"> </span>archive<span class="o">]</span><span class="w"> </span>><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">'[start-time]~[end-time]'</span><span class="w"> </span>><span class="w"> </span>file.mseed
|
||||
scart<span class="w"> </span>-dsvE<span class="w"> </span>-t<span class="w"> </span><span class="s1">'[start-time]~[end-time]'</span><span class="w"> </span>-n<span class="w"> </span><span class="s1">'[NET1],[NET2]'</span><span class="w"> </span>><span class="w"> </span>file.mseed
|
||||
scart<span class="w"> </span>-dsvE<span class="w"> </span>-t<span class="w"> </span><span class="s1">'[start-time]~[end-time]'</span><span class="w"> </span>-n<span class="w"> </span><span class="s1">'[NET]'</span><span class="w"> </span>-c<span class="w"> </span><span class="s1">'(E,H)H(1,2,3)'</span><span class="w"> </span>><span class="w"> </span>file.mseed
|
||||
scart<span class="w"> </span>-dsvE<span class="w"> </span>-t<span class="w"> </span><span class="s1">'[start-time]~[end-time]'</span><span class="w"> </span>-n<span class="w"> </span><span class="s1">'[N1.S1.L1.C1],[N2.S2.L2.C2]'</span><span class="w"> </span>><span class="w"> </span>file.mseed
|
||||
scart<span class="w"> </span>-dsvE<span class="w"> </span>-t<span class="w"> </span><span class="s1">'[start-time]~[end-time]'</span><span class="w"> </span>--nslc<span class="w"> </span>list.file<span class="w"> </span>><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>><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>><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>><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">'[start-time]~[end-time]'</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">'[start-time]~[end-time]'</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">'[start-time]~[end-time]'</span><span class="w"> </span>-n<span class="w"> </span><span class="s1">'[NET1],[NET2]'</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">'[start-time]~[end-time]'</span><span class="w"> </span>-n<span class="w"> </span><span class="s1">'[NET]'</span><span class="w"> </span>-c<span class="w"> </span><span class="s1">'EH?'</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">'[start-time]~[end-time]'</span><span class="w"> </span>-n<span class="w"> </span><span class="s1">'[N1.S1.L1.C1],[N2.S2.L2.C2]'</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: "(B|E|H|M|S)(D|H|L|N)(E|F|N|Z|1|2|3)"
|
||||
Default for Import: "*"</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
|
||||
"stream1,stream2,streamX" 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: "*"</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 "[match-stream:]rename-stream" and match-stream
|
||||
is optional. match-stream and rename-stream are in the
|
||||
"NET.STA.LOC.CHA" format. match-stream supports special
|
||||
charactes "?" "*" "|" "(" ")". rename-stream supports the
|
||||
special character "-" that can be used in place of NET, STA,
|
||||
LOC, CHA codes with the meaning of not renaming those.
|
||||
"-" 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 "~". To dump one hour of
|
||||
waveform data between 2008/01/01 00:00:00 and 2008/01/01
|
||||
01:00:00 use
|
||||
<-t 2008-01-01T00:00:00~2008-01-01T01:00:00>.</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 © 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
Block a user