|
|
<!DOCTYPE html>
|
|
|
|
|
|
<html >
|
|
|
<head>
|
|
|
<meta charset="utf-8" />
|
|
|
<title>scmssort — 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="scorgls" href="scorgls.html" />
|
|
|
<link rel="prev" title="scmapcut" href="scmapcut.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="scorgls.html" title="scorgls"
|
|
|
accesskey="N">
|
|
|
next
|
|
|
</a>
|
|
|
</li>
|
|
|
<li class="right">
|
|
|
<a href="scmapcut.html" title="scmapcut"
|
|
|
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">
|
|
|
|
|
|
<div class="section" id="scmssort">
|
|
|
<span id="id1"></span><h1>scmssort<a class="headerlink" href="#scmssort" title="Permalink to this headline">¶</a></h1>
|
|
|
<p><strong>Read and manipulate miniSEED records</strong></p>
|
|
|
<div class="section" id="description">
|
|
|
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
|
|
<p>scmssort reads unsorted (and possibly multiplexed) MiniSEED files and sorts
|
|
|
the individual records by time. This is useful e.g. for simulating data
|
|
|
acquisition and playbacks. Removing of duplicate data and trimming of time
|
|
|
window is available.</p>
|
|
|
<p>scmssort reads single files and output to the command line. Cat many files
|
|
|
to read them at the same time. In this way huge amount of data can be processed
|
|
|
efficiently.</p>
|
|
|
<p>Applications to miniSEED records:</p>
|
|
|
<ul class="simple">
|
|
|
<li><p>Sort records by time, e.g. for playbacks.</p></li>
|
|
|
<li><p>Remove duplicate records from files and clean waveform archives.</p></li>
|
|
|
<li><p>Filter data records, i.e. keep or remove them, based on</p>
|
|
|
<ul>
|
|
|
<li><p>time windows,</p></li>
|
|
|
<li><p>stream lists where each line has the format NET.STA.LOC.CHA including regular
|
|
|
expressions. Such stream lists can be generated, e.g., using <a class="reference internal" href="scinv.html#scinv"><span class="std std-ref">scinv</span></a>.</p></li>
|
|
|
</ul>
|
|
|
</li>
|
|
|
</ul>
|
|
|
<div class="admonition hint">
|
|
|
<p class="admonition-title">Hint</p>
|
|
|
<ul class="simple">
|
|
|
<li><p>Combine with <a class="reference internal" href="scart.html#scart"><span class="std std-ref">scart</span></a> or <a class="reference internal" href="msrtsimul.html#msrtsimul"><span class="std std-ref">msrtsimul</span></a> to archive data or to make
|
|
|
playbacks with real-time simulations.</p></li>
|
|
|
<li><p>Filter data by stream IDs using NSLC lists which can be generated using
|
|
|
<a class="reference internal" href="scinv.html#scinv"><span class="std std-ref">scinv</span></a>.</p></li>
|
|
|
</ul>
|
|
|
</div>
|
|
|
</div>
|
|
|
<div class="section" id="examples">
|
|
|
<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</a></h2>
|
|
|
<ol class="arabic">
|
|
|
<li><p>Read a single miniSEED data file. The records are sorted by endtime and
|
|
|
duplicates are removed.</p>
|
|
|
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>scmssort -vuE unsorted.mseed > sorted.mseed
|
|
|
</pre></div>
|
|
|
</div>
|
|
|
</li>
|
|
|
<li><p>Read all files ending with “.mseed” at the same time. The data are trimmed
|
|
|
to a time window and duplicated data are removed.</p>
|
|
|
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>cat *.mseed <span class="p">|</span> scmssort -vuE -t <span class="s1">'2020-03-28 15:48~2020-03-28 16:18'</span> > sorted.mseed
|
|
|
</pre></div>
|
|
|
</div>
|
|
|
</li>
|
|
|
<li><p>Remove streams listed by stream code and sort records by end time. Stream
|
|
|
lists can be generated, e.g., by <a class="reference internal" href="scinv.html#scinv"><span class="std std-ref">scinv</span></a>.</p>
|
|
|
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>scmssort -vuE --rm -l stream-list.txt test.mseed > sorted.mseed
|
|
|
</pre></div>
|
|
|
</div>
|
|
|
</li>
|
|
|
<li><p>Extract streams by time and stream code and sort records by end time.</p>
|
|
|
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="nb">echo</span> CX.PB01..BH? <span class="p">|</span> scmssort -vuE -t <span class="s1">'2007-03-28 15:48~2007-03-28 16:18'</span> -l - test.mseed > sorted.mseed
|
|
|
scmssort -vuE -t <span class="s1">'2007-03-28 15:48~2007-03-28 16:18'</span> -l stream-list.txt test.mseed > sorted.mseed
|
|
|
</pre></div>
|
|
|
</div>
|
|
|
</li>
|
|
|
</ol>
|
|
|
</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">scmssort [options] input</strong></p>
|
|
|
<div class="section" id="options">
|
|
|
<h3>Options<a class="headerlink" href="#options" title="Permalink to this headline">¶</a></h3>
|
|
|
<dl class="option">
|
|
|
<dt id="cmdoption-scmssort-h">
|
|
|
<code class="sig-name descname">-h</code><code class="sig-prename descclassname"></code><code class="sig-prename descclassname">, </code><code class="sig-name descname">--help</code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-scmssort-h" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>Show the command-line help and exit.</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="option">
|
|
|
<dt id="cmdoption-scmssort-e">
|
|
|
<code class="sig-name descname">-E</code><code class="sig-prename descclassname"></code><code class="sig-prename descclassname">, </code><code class="sig-name descname">--sort-by-end-time</code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-scmssort-e" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>Sort by end time.</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="option">
|
|
|
<dt id="cmdoption-scmssort-l">
|
|
|
<code class="sig-name descname">-l</code><code class="sig-prename descclassname"></code><code class="sig-prename descclassname">, </code><code class="sig-name descname">--list</code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-scmssort-l" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>File with streams to filter the records. One stream per
|
|
|
line. Instead of a file read the from stdin (-). Line
|
|
|
format: NET.STA.LOC.CHA - wildcards and regular expressions
|
|
|
are considered. Example: CX.*..BH? .</p>
|
|
|
<p>NSLC lists may be generated, e.g., using scinv.</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="option">
|
|
|
<dt id="cmdoption-scmssort-r">
|
|
|
<code class="sig-name descname">-r</code><code class="sig-prename descclassname"></code><code class="sig-prename descclassname">, </code><code class="sig-name descname">--rm</code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-scmssort-r" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>Remove all traces in stream list given by –list
|
|
|
instead of keeping them.</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="option">
|
|
|
<dt id="cmdoption-scmssort-t">
|
|
|
<code class="sig-name descname">-t</code><code class="sig-prename descclassname"></code><code class="sig-prename descclassname">, </code><code class="sig-name descname">--time-window</code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-scmssort-t" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>Specify time window (as one -properly quoted- string).
|
|
|
Times are of course UTC and separated by a tilde ~</p>
|
|
|
<p>Example:</p>
|
|
|
<p>‘2020-03-28 15:48~2020-03-28 16:18’</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="option">
|
|
|
<dt id="cmdoption-scmssort-u">
|
|
|
<code class="sig-name descname">-u</code><code class="sig-prename descclassname"></code><code class="sig-prename descclassname">, </code><code class="sig-name descname">--uniqueness</code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-scmssort-u" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>Ensure uniqueness of output, i.e. skip duplicate records.</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="option">
|
|
|
<dt id="cmdoption-scmssort-v">
|
|
|
<code class="sig-name descname">-v</code><code class="sig-prename descclassname"></code><code class="sig-prename descclassname">, </code><code class="sig-name descname">--verbose</code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-scmssort-v" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>Run in verbose mode.</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="#">scmssort</a><ul>
|
|
|
<li><a class="reference internal" href="#description">Description</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="#options">Options</a></li>
|
|
|
</ul>
|
|
|
</li>
|
|
|
</ul>
|
|
|
</li>
|
|
|
</ul>
|
|
|
|
|
|
<h4>Previous topic</h4>
|
|
|
<p class="topless"><a href="scmapcut.html"
|
|
|
title="previous chapter">scmapcut</a></p>
|
|
|
<h4>Next topic</h4>
|
|
|
<p class="topless"><a href="scorgls.html"
|
|
|
title="next chapter">scorgls</a></p>
|
|
|
<div role="note" aria-label="source link">
|
|
|
<h3>This Page</h3>
|
|
|
<ul class="this-page-menu">
|
|
|
<li><a href="../_sources/apps/scmssort.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> |