SCRUG-NA/2025
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

[seiscomp, scanloc] Install, add .gitignore

Browse Source
This commit is contained in:
Dirk Rössler
2025-10-09 15:07:02 +02:00
commit 20f5301bb1
2848 changed files with 1315858 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2711
share/doc/scanloc/html/base/CHANGELOG.html Normal file
View File

File diff suppressed because it is too large Load Diff

524
share/doc/scanloc/html/base/auxiliary.html Normal file
View File

@ -0,0 +1,524 @@
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>Auxiliary Scripts &#8212; scanloc: Phase Associator documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/gempa.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=fa44fd50" />
<link rel="stylesheet" type="text/css" href="../_static/gempa.css?v=c960eebf" />
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/gempa.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=b3ba4146"></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="Dense Travel-Time Tables" href="locsat-tables.html" />
<link rel="prev" title="Change Log" href="changelog.html" />
</head>
<body>
<div class="header">
<div class="container">
<img class="background" src="../_static/icon.png"/>
<div class="content">
<span class="title">scanloc: Phase Associator </span>
<span class="version">2025.281#4efc2c878</span></h1>
</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="locsat-tables.html" title="Dense Travel-Time Tables"
accesskey="N">
next
</a>
</li>
<li class="right">
<a href="changelog.html" title="Change Log"
accesskey="P">
previous
</a>
</li>
<li class="nav-item nav-item-0">
<a href="../index.html">Home</a>
</li>
</ul>
</div>
</div>
</div>
</div>
<div class="container">
<div class="fitted content" id="anchors-container">
<div class="body" role="main">
<section id="auxiliary-scripts">
<span id="sec-scanloc-aux-tools"></span><h1>Auxiliary Scripts<a class="headerlink" href="#auxiliary-scripts" title="Permalink to this heading"></a></h1>
<p>The scanloc package also ships with auxiliary scripts for real-time or non-real-time
playbacks and tuning. For these tools, the usual options (<a class="reference internal" href="../apps/global.html#cmdoption-h"><code class="xref std std-option docutils literal notranslate"><span class="pre">-h</span></code></a>,
<a class="reference internal" href="../apps/global.html#cmdoption-debug"><code class="xref std std-option docutils literal notranslate"><span class="pre">--debug</span></code></a>, etc.) apply. Read the <a class="reference internal" href="../apps/scanloc.html#scanloc-example"><span class="std std-ref">Real-Time Applications</span></a> section for
example applications.</p>
<section id="dump-picks">
<span id="sec-scanloc-dump-picks"></span><h2>dump_picks<a class="headerlink" href="#dump-picks" title="Permalink to this heading"></a></h2>
<p><strong class="program">dump_picks</strong> reads picks and amplitudes from a database and writes them
to file or the command line in the given format, by default XML (<a class="reference internal" href="glossary.html#term-SCML"><span class="xref std std-term">SCML</span></a>).
Control the database request to filter by</p>
<ul class="simple">
<li><p>Author (<a class="reference internal" href="#cmdoption-author"><code class="xref std std-option docutils literal notranslate"><span class="pre">--author</span></code></a>) contributing the object,</p></li>
<li><p>Comparison with inventory (<a class="reference internal" href="#cmdoption-c"><code class="xref std std-option docutils literal notranslate"><span class="pre">--check-inventory</span></code></a>),</p></li>
<li><p>Object evaluation mode (<a class="reference internal" href="#cmdoption-m"><code class="xref std std-option docutils literal notranslate"><span class="pre">--manual</span></code></a>, <a class="reference internal" href="#cmdoption-a"><code class="xref std std-option docutils literal notranslate"><span class="pre">--automatic</span></code></a>),</p></li>
<li><p>Region of contributing station (<a class="reference internal" href="#cmdoption-r"><code class="xref std std-option docutils literal notranslate"><span class="pre">--region</span></code></a>),</p></li>
<li><p>Time (<a class="reference internal" href="#cmdoption-t"><code class="xref std std-option docutils literal notranslate"><span class="pre">--time-window</span></code></a>, <a class="reference internal" href="#cmdoption-hours"><code class="xref std std-option docutils literal notranslate"><span class="pre">--hours</span></code></a>, <a class="reference internal" href="#cmdoption-start"><code class="xref std std-option docutils literal notranslate"><span class="pre">--start</span></code></a>).</p></li>
</ul>
<section id="applications">
<h3>Applications<a class="headerlink" href="#applications" title="Permalink to this heading"></a></h3>
<ul class="simple">
<li><p>Dump picks and amplitudes in XML for further analysis or feeding into another
module such as <a class="reference internal" href="../apps/scanloc.html#scanloc"><span class="std std-ref">scanloc</span></a>.</p></li>
<li><p>Printing statistics and useful information of the retrieved pick and amplitude
set with <a class="reference internal" href="#cmdoption-print"><code class="xref std std-option docutils literal notranslate"><span class="pre">--print</span></code></a>.</p></li>
<li><p>Fetch waveforms for picks from SDS archive, a CAPS or FDSN server by
generating stream lists from picks with time windows like with
<span id="id1"><em>scevtstreams</em> [<a class="reference internal" href="references.html#id256" title="scevtstreams. SeisComP module. URL: https://docs.gempa.de/seiscomp/current/apps/scevtstreams.html.">20</a>]</span> but for picks independent of events and origins.
Consider the option <a class="reference internal" href="#cmdoption-type"><code class="xref std std-option docutils literal notranslate"><span class="pre">--type</span></code></a> for choosing the type and
<a class="reference internal" href="#cmdoption-margin"><code class="xref std std-option docutils literal notranslate"><span class="pre">--margin</span></code></a> for the time margin.</p></li>
</ul>
<div class="admonition hint">
<p class="admonition-title">Hint</p>
<ul class="simple">
<li><p>For retrieving events or origins with picks, amplitudes, etc. from a
database use <span id="id2"><em>scxmldump</em> [<a class="reference internal" href="references.html#id284" title="scxmldump. SeisComP module. URL: https://docs.gempa.de/seiscomp/current/apps/scxmldump.html.">26</a>]</span>.</p></li>
<li><p>Multiple <a class="reference internal" href="glossary.html#term-SCML"><span class="xref std std-term">SCML</span></a> files can be merged into one using
<span id="id3"><em>scxmlmerge</em> [<a class="reference internal" href="references.html#id285" title="scxmlmerge. SeisComP module. URL: https://docs.gempa.de/seiscomp/current/apps/scxmlmerge.html.">27</a>]</span>.</p></li>
</ul>
</div>
</section>
<section id="examples">
<h3>Examples<a class="headerlink" href="#examples" title="Permalink to this heading"></a></h3>
<ul>
<li><p>Print command-line help:</p>
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>dump_picks<span class="w"> </span>-h
</pre></div>
</div>
</li>
<li><p>Extract all picks and amplitudes for the given time span made by author
‘l1autopick’:</p>
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>dump_picks<span class="w"> </span>-t<span class="w"> </span><span class="m">2022</span>-01-20T13:52:00~2022-01-20T13:57:00<span class="w"> </span>-d<span class="w"> </span>localhost<span class="w"> </span>--author<span class="w"> </span>l1autopick
</pre></div>
</div>
</li>
<li><p>Dump the streams of picks with time windows fetching the corresponding data
from a local CAPS server <span id="id4">[<a class="reference internal" href="references.html#id116" title="CAPS. gempa module. URL: https://docs.gempa.de/caps/current/index.html.">1</a>]</span>.</p>
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>dump_picks<span class="w"> </span>-d<span class="w"> </span>localhost<span class="w"> </span>--type<span class="w"> </span><span class="m">2</span><span class="w"> </span>--margin<span class="w"> </span><span class="m">60</span><span class="w"> </span><span class="p">|</span><span class="w"> </span>capstool<span class="w"> </span>-H<span class="w"> </span>localhost<span class="w"> </span>-o<span class="w"> </span>data.mseed
</pre></div>
</div>
</li>
<li><p>Dump the streams of picks with time windows fetching the corresponding data
from a local SDS archive</p>
<div class="highlight-bash notranslate"><div class="highlight"><pre><span></span>dump_picks<span class="w"> </span>-d<span class="w"> </span>localhost<span class="w"> </span>--type<span class="w"> </span><span class="m">1</span><span class="w"> </span>--margin<span class="w"> </span><span class="m">60</span><span class="w"> </span><span class="p">|</span><span class="w"> </span>scart<span class="w"> </span>-dsE<span class="w"> </span>-l<span class="w"> </span>-<span class="w"> </span>/archive<span class="w"> </span>-o<span class="w"> </span>data.mseed
</pre></div>
</div>
</li>
</ul>
</section>
<section id="command-line-options">
<h3>Command-Line Options<a class="headerlink" href="#command-line-options" title="Permalink to this heading"></a></h3>
<p><strong class="program">dump_picks [options]</strong></p>
<section id="dump">
<h4>Dump<a class="headerlink" href="#dump" title="Permalink to this heading"></a></h4>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-hours">
<span class="sig-name descname"><span class="pre">--hours</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-hours" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>double</em></p>
<p>Start search hours before now considering object time, not creation time.
If set, <a class="reference internal" href="#cmdoption-t"><code class="xref std std-option docutils literal notranslate"><span class="pre">--time-window</span></code></a>, <a class="reference internal" href="#cmdoption-start"><code class="xref std std-option docutils literal notranslate"><span class="pre">--start</span></code></a>, <a class="reference internal" href="#cmdoption-end"><code class="xref std std-option docutils literal notranslate"><span class="pre">--end</span></code></a> are ignored.
The hours are added to the minutes if set.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-minutes">
<span class="sig-name descname"><span class="pre">--minutes</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-minutes" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>double</em></p>
<p>Start search minutes before now considering object time, not creation time.
The minutes are added to the hours if set.
If set, <a class="reference internal" href="#cmdoption-t"><code class="xref std std-option docutils literal notranslate"><span class="pre">--time-window</span></code></a>, <a class="reference internal" href="#cmdoption-start"><code class="xref std std-option docutils literal notranslate"><span class="pre">--start</span></code></a>, <a class="reference internal" href="#cmdoption-end"><code class="xref std std-option docutils literal notranslate"><span class="pre">--end</span></code></a> are ignored.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-start">
<span class="sig-name descname"><span class="pre">--start</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-start" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>Default: <code class="docutils literal notranslate"><span class="pre">1970-01-01</span> <span class="pre">00:00:00.000</span></code></p>
<p>Start time of search until now considering object time, not creation time.
If set, <a class="reference internal" href="#cmdoption-t"><code class="xref std std-option docutils literal notranslate"><span class="pre">--time-window</span></code></a> is ignored.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-end">
<span class="sig-name descname"><span class="pre">--end</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-end" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>Default: <code class="docutils literal notranslate"><span class="pre">now</span></code></p>
<p>End time of search considering object time, not creation time. If set,
<a class="reference internal" href="#cmdoption-t"><code class="xref std std-option docutils literal notranslate"><span class="pre">--time-window</span></code></a> is ignored.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-t">
<span id="cmdoption-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">arg</span></span><a class="headerlink" href="#cmdoption-t" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>Default: <code class="docutils literal notranslate"><span class="pre">1970-01-01T00:00:00~now</span></code></p>
<p>Specify time window to search picks and amplitudes by their time. Use one
single string which must be enclosed by quotes in case of spaces in the time
string. Times are of course in UTC and separated by a tilde ‘~’.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-maximum-delay">
<span class="sig-name descname"><span class="pre">--maximum-delay</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-maximum-delay" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>double</em></p>
<p>Unit: <code class="docutils literal notranslate"><span class="pre">s</span></code></p>
<p>Maximum allowed delay of picks or amplitudes, hence the difference between
creation time and actual time value. Allows identification of picks found in
real time.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-r">
<span id="cmdoption-region"></span><span class="sig-name descname"><span class="pre">-r</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">--region</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-r" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>Unit: <code class="docutils literal notranslate"><span class="pre">deg</span></code></p>
<p>Default: <code class="docutils literal notranslate"><span class="pre">-90,-180,90,180</span></code></p>
<p>Dump picks only from sensors in given region. Implies loading an inventory.</p>
<p>Format: minLat,minLon,maxLat,maxLon</p>
<p>Default: -90,-180,90,180 if not set.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-c">
<span id="cmdoption-check-inventory"></span><span class="sig-name descname"><span class="pre">-c</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">--check-inventory</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-c" title="Permalink to this definition"></a></dt>
<dd><p>Dump picks only when corresponding streams are found in inventory.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-O">
<span id="cmdoption-origin"></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">--origin</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-O" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>Origin ID. Dump all picks associated with the origin that has the given
origin ID.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-m">
<span id="cmdoption-manual"></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">--manual</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-m" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>boolean</em></p>
<p>Dump only manual picks.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-a">
<span id="cmdoption-automatic"></span><span class="sig-name descname"><span class="pre">-a</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">--automatic</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-a" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>boolean</em></p>
<p>Dump only automatic picks.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-n">
<span id="cmdoption-no-amp"></span><span class="sig-name descname"><span class="pre">-n</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">--no-amp</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-n" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>boolean</em></p>
<p>Do not dump amplitudes from picks. Amplitudes are not required by scanloc.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-author">
<span class="sig-name descname"><span class="pre">--author</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-author" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>Filter picks by author. Author information can be extracted from
XML files using the <strong class="program">playback_picks</strong> option <a class="reference internal" href="#cmdoption-print"><code class="xref std std-option docutils literal notranslate"><span class="pre">--print</span></code></a>.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-net-sta">
<span class="sig-name descname"><span class="pre">--net-sta</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-net-sta" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>Filter picks and amplitudes by network code or network and station code.
Format: NET or NET.STA. Network and station information can be extracted from
XML files using the <strong class="program">playback_picks</strong> along with <a class="reference internal" href="#cmdoption-print"><code class="xref std std-option docutils literal notranslate"><span class="pre">--print</span></code></a>,
or inventory (<span id="id5"><em>scinv</em> [<a class="reference internal" href="references.html#id260" title="scinv. SeisComP module. URL: https://docs.gempa.de/seiscomp/current/apps/scinv.html.">21</a>]</span>), waveforms (<span id="id6"><em>scart</em> [<a class="reference internal" href="references.html#id241" title="scart. SeisComP module. URL: https://docs.gempa.de/seiscomp/current/apps/scart.html.">13</a>]</span>) or
bindings configuration (<span id="id7"><em>scdumpcfg</em> [<a class="reference internal" href="references.html#id249" title="scdumpcfg. SeisComP module. URL: https://docs.gempa.de/seiscomp/current/apps/scdumpcfg.html.">18</a>]</span>).</p>
</dd></dl>
</section>
<section id="output">
<h4>Output<a class="headerlink" href="#output" title="Permalink to this heading"></a></h4>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-o">
<span id="cmdoption-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 class="pre">arg</span></span><a class="headerlink" href="#cmdoption-o" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>Name of output file. If not given, all data is written to stdout.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-type">
<span class="sig-name descname"><span class="pre">--type</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-type" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>Default: <code class="docutils literal notranslate"><span class="pre">0</span></code></p>
<p>Type of output format.
0 / scml: SCML containing all objects (default if option is not used)</p>
<p>1 / streams: Time windows and streams for all picks like in scevtstreams</p>
<p>2 / caps: Time windows and streams in capstool format</p>
<p>3 / fdsnws: Time windows and streams in FDSN dataselect webservice POST format</p>
<p>Except for type 0, only picks are considered ignoring all other objects.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-f">
<span id="cmdoption-formatted"></span><span class="sig-name descname"><span class="pre">-f</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">--formatted</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-f" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>boolean</em></p>
<p>Output formatted XML. Default is unformatted. Applies only for type 0.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-margin">
<span class="sig-name descname"><span class="pre">--margin</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-margin" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>Unit: <code class="docutils literal notranslate"><span class="pre">s</span></code></p>
<p>Default: <code class="docutils literal notranslate"><span class="pre">300</span></code></p>
<p>Time margin applied around pick times along with –type = [1:]. Use 2
comma-separted values (before,after) for asymmetric margins, e.g.
–margin 120,300.</p>
</dd></dl>
</section>
</section>
</section>
<section id="playback-picks">
<span id="sec-scanloc-playback-picks"></span><h2>playback_picks<a class="headerlink" href="#playback-picks" title="Permalink to this heading"></a></h2>
<p><strong class="program">playback_picks</strong> plays back picks, amplitudes and origins from XML files
at normal or different speed and sends them to the messaging system. It can also
be used to print statistics and information extracted from the read XML file.
<strong class="program">playback_picks</strong> supports multiple pipelines by defining the message
groups into which objects are injected. The script allows controlling:</p>
<ul class="simple">
<li><p>Message groups: Append the message groups for sending picks and amplitudes.</p></li>
<li><p>Mode (<a class="reference internal" href="#cmdoption-mode"><code class="xref std std-option docutils literal notranslate"><span class="pre">--mode</span></code></a>): In real-time mode a constant number of seconds is added
to the creation and reference times before sending an object to the messaging
for mimicking real-time situations at current time. The seconds to add is
derived from the time of the first object. Default mode is <em>historic</em>.</p></li>
<li><p>Speed (<a class="reference internal" href="#cmdoption-speed"><code class="xref std std-option docutils literal notranslate"><span class="pre">--speed</span></code></a>): The speed factor to use.</p></li>
<li><p>Start (<a class="reference internal" href="#cmdoption-j"><code class="xref std std-option docutils literal notranslate"><span class="pre">--jump</span></code></a>): Ignore the first objects within the given number of
seconds.</p></li>
<li><p>Timing (<a class="reference internal" href="../apps/scanloc.html#cmdoption-timing"><code class="xref std std-option docutils literal notranslate"><span class="pre">--timing</span></code></a>): Define the sorting of the objects. Default is
<em>creationTime</em>. Consider the comments on timing in section
<a class="reference internal" href="../apps/scanloc.html#scanloc-example"><span class="std std-ref">Real-Time Applications</span></a>.</p></li>
</ul>
<div class="admonition important">
<p class="admonition-title">Important</p>
<p>‘creationTime’ should be considered for playing back origins since their
actual origin time values are always before picks and amplitudes.</p>
</div>
<section id="id8">
<h3>Examples<a class="headerlink" href="#id8" title="Permalink to this heading"></a></h3>
<ul>
<li><p>Print the command-line help:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>playback_picks<span class="w"> </span>-h
</pre></div>
</div>
</li>
<li><p>Just print statistics of the read XML including author information and stream
codes on which picks and amplitudes were measured. The NSLC information can be
used to extract waveforms or to set up corresponding bindings:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>playback_picks<span class="w"> </span>--print<span class="w"> </span>picks.xml
</pre></div>
</div>
</li>
<li><p>Make a playback injecting picks and origins into different message groups but
amplitudes into the same default group, e.g., of different pipelines.
‘creationTime’ is used as a time reference since origin times are before times
of picks and amplitudes and considering ‘pickTime’ would distort the order of
the objects unrealistically:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>playback_picks<span class="w"> </span>origins.xml<span class="w"> </span>l1picks.xml:L1PICK:AMPLITUDE:L1LOCATION<span class="w"> </span>--timing<span class="w"> </span>creationTime
</pre></div>
</div>
</li>
</ul>
</section>
<section id="id9">
<h3>Command-Line Options<a class="headerlink" href="#id9" title="Permalink to this heading"></a></h3>
<p><strong class="program">playback_picks [options]</strong></p>
<section id="playback">
<h4>Playback<a class="headerlink" href="#playback" title="Permalink to this heading"></a></h4>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-authors">
<span class="sig-name descname"><span class="pre">--authors</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-authors" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>list:string</em></p>
<p>Default: <code class="docutils literal notranslate"><span class="pre">None</span></code></p>
<p>Author of objects to filter before playing back. Objects from all other
authors are ignored. Separate multiple authors by comma.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-j">
<span id="cmdoption-jump"></span><span class="sig-name descname"><span class="pre">-j</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">--jump</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-j" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>double</em></p>
<p>Unit: <code class="docutils literal notranslate"><span class="pre">minute</span></code></p>
<p>Jump in time by given value ignoring the corresponding objects.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-list">
<span class="sig-name descname"><span class="pre">--list</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-list" title="Permalink to this definition"></a></dt>
<dd><p>Just list important pick information from the read XML file and then exit
without playing back. The sorting of the list depends on ‘–timing’.
Information include: phase hint, pick time, stream ID, author, time to
previous pick, delay.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-mode">
<span class="sig-name descname"><span class="pre">--mode</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-mode" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">historic</span></code></p>
<p>Type: <em>string</em></p>
<p>Values: <code class="docutils literal notranslate"><span class="pre">historic,</span> <span class="pre">realTime</span></code></p>
<p>Playback mode. ‘realTime’ mimics current situation, ‘historic’ preserves all
times.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-0">
<span id="cmdoption-object"></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">--object</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-0" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>list:string</em></p>
<p>Default: <code class="docutils literal notranslate"><span class="pre">None</span></code></p>
<p>Values: <code class="docutils literal notranslate"><span class="pre">pick,amplitude,origin</span></code></p>
<p>Limit the playback to the given list of objects.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-print">
<span class="sig-name descname"><span class="pre">--print</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-print" title="Permalink to this definition"></a></dt>
<dd><p>Just print some statistics of the read XML file and then exit without playing
back. The list of stream codes (NSLC) is printed to stdout. All other
information is printed to stderr. The NSLC information can be used, e.g., for
filtering waveforms (<span id="id10"><em>scart</em> [<a class="reference internal" href="references.html#id241" title="scart. SeisComP module. URL: https://docs.gempa.de/seiscomp/current/apps/scart.html.">13</a>]</span>) or inventory (<span id="id11"><em>invextr</em> [<a class="reference internal" href="references.html#id166" title="invextr. SeisComP module. URL: https://docs.gempa.de/seiscomp/current/apps/invextr.html.">9</a>]</span>), for
creating global bindings or applying author filtering, e.g., in
<a class="reference internal" href="#sec-scanloc-dump-picks"><span class="std std-ref">dump_picks</span></a>.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-speed">
<span class="sig-name descname"><span class="pre">--speed</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-speed" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">1</span></code></p>
<p>Type: <em>double</em></p>
<p>Speed of playback.</p>
<p>1: true speed.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-timing">
<span class="sig-name descname"><span class="pre">--timing</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-timing" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">creationTime</span></code></p>
<p>Type: <em>string</em></p>
<p>Values: <code class="docutils literal notranslate"><span class="pre">pickTime,creationTime</span></code></p>
<p>Timing reference: ‘pickTime’ plays back in order of actual times of picks,
amplitudes and origins, ‘creationTime’ considers their creation times instead.
Use ‘pickTime’ if creation times are not representative of the order of
objects, e.g., when created in playbacks. ‘creationTime’ should be considered
for playing back origins since their actual origin time values are always
before picks and amplitudes.</p>
</dd></dl>
</section>
</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="#">Auxiliary Scripts</a><ul>
<li><a class="reference internal" href="#dump-picks">dump_picks</a><ul>
<li><a class="reference internal" href="#applications">Applications</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="#dump">Dump</a></li>
<li><a class="reference internal" href="#output">Output</a></li>
</ul>
</li>
</ul>
</li>
<li><a class="reference internal" href="#playback-picks">playback_picks</a><ul>
<li><a class="reference internal" href="#id8">Examples</a></li>
<li><a class="reference internal" href="#id9">Command-Line Options</a><ul>
<li><a class="reference internal" href="#playback">Playback</a></li>
</ul>
</li>
</ul>
</li>
</ul>
</li>
</ul>
</div>
<div>
<h4>Previous topic</h4>
<p class="topless"><a href="changelog.html"
title="previous chapter">Change Log</a></p>
</div>
<div>
<h4>Next topic</h4>
<p class="topless"><a href="locsat-tables.html"
title="next chapter">Dense Travel-Time Tables</a></p>
</div>
<div role="note" aria-label="source link">
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="../_sources/base/auxiliary.rst.txt"
rel="nofollow">Show Source</a></li>
</ul>
</div>
</div>
</div>
</div>
</div>
<div class="footer">
<div class="container">
<div class="content">
Release <b></b> version <b>2025.281#4efc2c878</b>
<div class="copyright">
&copy; Copyright <a href="https://www.gempa.de">2014, gempa GmbH.</a>
</div>
</div>
</div>
</div>
</body>
</html>

2735
share/doc/scanloc/html/base/changelog.html Normal file
View File

File diff suppressed because it is too large Load Diff

1339
share/doc/scanloc/html/base/glossary.html Normal file
View File

File diff suppressed because it is too large Load Diff

392
share/doc/scanloc/html/base/gradients.html Normal file
View File

@ -0,0 +1,392 @@
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>Color Gradients &#8212; scanloc: Phase Associator documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/gempa.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=fa44fd50" />
<link rel="stylesheet" type="text/css" href="../_static/gempa.css?v=c960eebf" />
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/gempa.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=b3ba4146"></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" />
</head>
<body>
<div class="header">
<div class="container">
<img class="background" src="../_static/icon.png"/>
<div class="content">
<span class="title">scanloc: Phase Associator </span>
<span class="version">2025.281#4efc2c878</span></h1>
</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="nav-item nav-item-0">
<a href="../index.html">Home</a>
</li>
</ul>
</div>
</div>
</div>
</div>
<div class="container">
<div class="fitted content" id="anchors-container">
<div class="body" role="main">
<section id="color-gradients">
<span id="gradients"></span><h1>Color Gradients<a class="headerlink" href="#color-gradients" title="Permalink to this heading"></a></h1>
<section id="overview">
<h2>Overview<a class="headerlink" href="#overview" title="Permalink to this heading"></a></h2>
<p>A number of pre-defined color gradients are available for gempa modules.
These gradients can be used when displaying color-coded values such as grids,
spectrograms or heat-maps. The following is an overview of pre-defined
gradients along with the name of the gradient which can be used in
configurations. The gradients are grouped into:</p>
<ul class="simple">
<li><p><a class="reference internal" href="#gradients-fullspectrum"><span class="std std-ref">Full spectrum</span></a></p></li>
<li><p><a class="reference internal" href="#gradients-darkyellow"><span class="std std-ref">Dark to yellow</span></a></p></li>
<li><p><a class="reference internal" href="#gradients-blackandwhite"><span class="std std-ref">Black and white</span></a></p></li>
<li><p><a class="reference internal" href="#gradients-singlecolor"><span class="std std-ref">Single color</span></a></p></li>
<li><p><a class="reference internal" href="#gradients-threecolor"><span class="std std-ref">Three color</span></a></p></li>
</ul>
</section>
<section id="list-of-gradients">
<h2>List of Gradients<a class="headerlink" href="#list-of-gradients" title="Permalink to this heading"></a></h2>
<section id="full-spectrum">
<span id="gradients-fullspectrum"></span><h3>Full spectrum<a class="headerlink" href="#full-spectrum" title="Permalink to this heading"></a></h3>
<p>Gradients that use the full spectrum of colors.</p>
<section id="default">
<span id="gradients-default"></span><h4>Default<a class="headerlink" href="#default" title="Permalink to this heading"></a></h4>
<ul class="simple">
<li><p>Configuration name: <code class="xref std std-option docutils literal notranslate"><span class="pre">Default</span></code></p></li>
</ul>
<figure class="align-default">
<a class="reference internal image-reference" href="../_images/Default.png"><img alt="overview of the Default color-gradient" src="../_images/Default.png" style="width: 420px;" /></a>
</figure>
<figure class="align-default" id="id1">
<a class="reference internal image-reference" href="../_images/Default_.png"><img alt="example spectrogram using the Default gradient" src="../_images/Default_.png" style="width: 420px;" /></a>
<figcaption>
<p><span class="caption-text">Figure 15: Example spectrogram using the “Default” color-gradient.</span><a class="headerlink" href="#id1" title="Permalink to this image"></a></p>
</figcaption>
</figure>
</section>
<section id="spectrum">
<span id="gradients-spectrum"></span><h4>Spectrum<a class="headerlink" href="#spectrum" title="Permalink to this heading"></a></h4>
<ul class="simple">
<li><p>Configuration name: <code class="xref std std-option docutils literal notranslate"><span class="pre">Spectrum</span></code></p></li>
</ul>
<figure class="align-default">
<a class="reference internal image-reference" href="../_images/Spectrum.png"><img alt="overview of the Spectrum color-gradient" src="../_images/Spectrum.png" style="width: 420px;" /></a>
</figure>
<figure class="align-default" id="id2">
<a class="reference internal image-reference" href="../_images/Spectrum_.png"><img alt="example spectrogram using the Spectrum gradient" src="../_images/Spectrum_.png" style="width: 420px;" /></a>
<figcaption>
<p><span class="caption-text">Figure 17: Example spectrogram using the “Spectrum” color-gradient.</span><a class="headerlink" href="#id2" title="Permalink to this image"></a></p>
</figcaption>
</figure>
</section>
<section id="circle">
<span id="gradients-circle"></span><h4>Circle<a class="headerlink" href="#circle" title="Permalink to this heading"></a></h4>
<ul class="simple">
<li><p>Configuration name: <code class="xref std std-option docutils literal notranslate"><span class="pre">Circle</span></code></p></li>
</ul>
<figure class="align-default">
<a class="reference internal image-reference" href="../_images/Circle.png"><img alt="overview of the Circle color-gradient" src="../_images/Circle.png" style="width: 420px;" /></a>
</figure>
<figure class="align-default" id="id3">
<a class="reference internal image-reference" href="../_images/Circle_.png"><img alt="example spectrogram using the Circle gradient" src="../_images/Circle_.png" style="width: 420px;" /></a>
<figcaption>
<p><span class="caption-text">Figure 19: Example spectrogram using the “Circle” color-gradient.</span><a class="headerlink" href="#id3" title="Permalink to this image"></a></p>
</figcaption>
</figure>
</section>
</section>
<section id="dark-to-yellow">
<span id="gradients-darkyellow"></span><h3>Dark to yellow<a class="headerlink" href="#dark-to-yellow" title="Permalink to this heading"></a></h3>
<p>Gradients optically resembling fire with increased energy beeing displayed by
bright yellow tones.</p>
<section id="blackbody">
<span id="gradients-blackbody"></span><h4>BlackBody<a class="headerlink" href="#blackbody" title="Permalink to this heading"></a></h4>
<ul class="simple">
<li><p>Configuration name: <code class="xref std std-option docutils literal notranslate"><span class="pre">BlackBody</span></code></p></li>
</ul>
<figure class="align-default">
<a class="reference internal image-reference" href="../_images/BlackBody.png"><img alt="overview of the BlackBody color-gradient" src="../_images/BlackBody.png" style="width: 420px;" /></a>
</figure>
<figure class="align-default" id="id4">
<a class="reference internal image-reference" href="../_images/BlackBody_.png"><img alt="example spectrogram using the BlackBody gradient" src="../_images/BlackBody_.png" style="width: 420px;" /></a>
<figcaption>
<p><span class="caption-text">Figure 21: Example spectrogram using the “BlackBody” color-gradient.</span><a class="headerlink" href="#id4" title="Permalink to this image"></a></p>
</figcaption>
</figure>
</section>
<section id="inferno">
<span id="gradients-inferno"></span><h4>Inferno<a class="headerlink" href="#inferno" title="Permalink to this heading"></a></h4>
<ul class="simple">
<li><p>Configuration name: <code class="xref std std-option docutils literal notranslate"><span class="pre">Inferno</span></code></p></li>
</ul>
<figure class="align-default">
<a class="reference internal image-reference" href="../_images/Inferno.png"><img alt="overview of the Inferno color-gradient" src="../_images/Inferno.png" style="width: 420px;" /></a>
</figure>
<figure class="align-default" id="id5">
<a class="reference internal image-reference" href="../_images/Inferno_.png"><img alt="example spectrogram using the Inferno gradient" src="../_images/Inferno_.png" style="width: 420px;" /></a>
<figcaption>
<p><span class="caption-text">Figure 23: Example spectrogram using the “Inferno” color-gradient.</span><a class="headerlink" href="#id5" title="Permalink to this image"></a></p>
</figcaption>
</figure>
</section>
<section id="plasma">
<span id="gradients-plasma"></span><h4>Plasma<a class="headerlink" href="#plasma" title="Permalink to this heading"></a></h4>
<ul class="simple">
<li><p>Configuration name: <code class="xref std std-option docutils literal notranslate"><span class="pre">Plasma</span></code></p></li>
</ul>
<figure class="align-default">
<a class="reference internal image-reference" href="../_images/Plasma.png"><img alt="overview of the Plasma color-gradient" src="../_images/Plasma.png" style="width: 420px;" /></a>
</figure>
<figure class="align-default" id="id6">
<a class="reference internal image-reference" href="../_images/Plasma_.png"><img alt="example spectrogram using the Plasma gradient" src="../_images/Plasma_.png" style="width: 420px;" /></a>
<figcaption>
<p><span class="caption-text">Figure 25: Example spectrogram using the “Plasma” color-gradient.</span><a class="headerlink" href="#id6" title="Permalink to this image"></a></p>
</figcaption>
</figure>
</section>
</section>
<section id="black-and-white">
<span id="gradients-blackandwhite"></span><h3>Black and white<a class="headerlink" href="#black-and-white" title="Permalink to this heading"></a></h3>
<p>For a maximum contrast there are these two gradients that just use black and
white.</p>
<section id="blackwhite">
<span id="gradients-blackwhite"></span><h4>BlackWhite<a class="headerlink" href="#blackwhite" title="Permalink to this heading"></a></h4>
<ul class="simple">
<li><p>Configuration name: <code class="xref std std-option docutils literal notranslate"><span class="pre">BlackWhite</span></code></p></li>
</ul>
<figure class="align-default">
<a class="reference internal image-reference" href="../_images/BlackWhite.png"><img alt="overview of the BlackWhite color-gradient" src="../_images/BlackWhite.png" style="width: 420px;" /></a>
</figure>
<figure class="align-default" id="id7">
<a class="reference internal image-reference" href="../_images/BlackWhite_.png"><img alt="example spectrogram using the BlackWhite gradient" src="../_images/BlackWhite_.png" style="width: 420px;" /></a>
<figcaption>
<p><span class="caption-text">Figure 27: Example spectrogram using the “BlackWhite” color-gradient.</span><a class="headerlink" href="#id7" title="Permalink to this image"></a></p>
</figcaption>
</figure>
</section>
<section id="whiteblack">
<span id="gradients-whiteblack"></span><h4>WhiteBlack<a class="headerlink" href="#whiteblack" title="Permalink to this heading"></a></h4>
<ul class="simple">
<li><p>Configuration name: <code class="xref std std-option docutils literal notranslate"><span class="pre">WhiteBlack</span></code></p></li>
</ul>
<figure class="align-default">
<a class="reference internal image-reference" href="../_images/WhiteBlack.png"><img alt="overview of the WhiteBlack color-gradient" src="../_images/WhiteBlack.png" style="width: 420px;" /></a>
</figure>
<figure class="align-default" id="id8">
<a class="reference internal image-reference" href="../_images/WhiteBlack_.png"><img alt="example spectrogram using the WhiteBlack gradient" src="../_images/WhiteBlack_.png" style="width: 420px;" /></a>
<figcaption>
<p><span class="caption-text">Figure 29: Example spectrogram using the “WhiteBlack” color-gradient.</span><a class="headerlink" href="#id8" title="Permalink to this image"></a></p>
</figcaption>
</figure>
</section>
</section>
<section id="single-color">
<span id="gradients-singlecolor"></span><h3>Single color<a class="headerlink" href="#single-color" title="Permalink to this heading"></a></h3>
<p>The single color gradients have the same benefit as the
<a class="reference internal" href="#gradients-blackwhite"><span class="std std-ref">black and white gradients</span></a> and are of a high contrast.</p>
<section id="bluepurple">
<span id="gradients-bluepurple"></span><h4>BluePurple<a class="headerlink" href="#bluepurple" title="Permalink to this heading"></a></h4>
<ul class="simple">
<li><p>Configuration name: <code class="xref std std-option docutils literal notranslate"><span class="pre">BuPu</span></code></p></li>
</ul>
<figure class="align-default">
<a class="reference internal image-reference" href="../_images/BluePurple.png"><img alt="overview of the BluePurple color-gradient" src="../_images/BluePurple.png" style="width: 420px;" /></a>
</figure>
<figure class="align-default" id="id9">
<a class="reference internal image-reference" href="../_images/BluePurple_.png"><img alt="example spectrogram using the BluePurple gradient" src="../_images/BluePurple_.png" style="width: 420px;" /></a>
<figcaption>
<p><span class="caption-text">Figure 31: Example spectrogram using the “BluePurple” color-gradient.</span><a class="headerlink" href="#id9" title="Permalink to this image"></a></p>
</figcaption>
</figure>
</section>
<section id="blues">
<span id="gradients-blues"></span><h4>Blues<a class="headerlink" href="#blues" title="Permalink to this heading"></a></h4>
<ul class="simple">
<li><p>Configuration name: <code class="xref std std-option docutils literal notranslate"><span class="pre">Blues</span></code></p></li>
</ul>
<figure class="align-default">
<a class="reference internal image-reference" href="../_images/Blues.png"><img alt="overview of the Blues color-gradient" src="../_images/Blues.png" style="width: 420px;" /></a>
</figure>
<figure class="align-default" id="id10">
<a class="reference internal image-reference" href="../_images/Blues_.png"><img alt="example spectrogram using the Blues gradient" src="../_images/Blues_.png" style="width: 420px;" /></a>
<figcaption>
<p><span class="caption-text">Figure 33: Example spectrogram using the “Blues” color-gradient.</span><a class="headerlink" href="#id10" title="Permalink to this image"></a></p>
</figcaption>
</figure>
</section>
<section id="purplered">
<span id="gradients-purplered"></span><h4>PurpleRed<a class="headerlink" href="#purplered" title="Permalink to this heading"></a></h4>
<ul class="simple">
<li><p>Configuration name: <code class="xref std std-option docutils literal notranslate"><span class="pre">PuRd</span></code></p></li>
</ul>
<figure class="align-default">
<a class="reference internal image-reference" href="../_images/PurpleRed.png"><img alt="overview of the PurpleRed color-gradient" src="../_images/PurpleRed.png" style="width: 420px;" /></a>
</figure>
<figure class="align-default" id="id11">
<a class="reference internal image-reference" href="../_images/PurpleRed_.png"><img alt="example spectrogram using the PurpleRed gradient" src="../_images/PurpleRed_.png" style="width: 420px;" /></a>
<figcaption>
<p><span class="caption-text">Figure 35: Example spectrogram using the “PurpleRed” color-gradient.</span><a class="headerlink" href="#id11" title="Permalink to this image"></a></p>
</figcaption>
</figure>
</section>
</section>
<section id="three-color">
<span id="gradients-threecolor"></span><h3>Three color<a class="headerlink" href="#three-color" title="Permalink to this heading"></a></h3>
<p>Gradients allowing to distinguish more details than
<a class="reference internal" href="#gradients-singlecolor"><span class="std std-ref">single colored</span></a>.</p>
<section id="redyellowblue">
<span id="gradients-redyellowblue"></span><h4>RedYellowBlue<a class="headerlink" href="#redyellowblue" title="Permalink to this heading"></a></h4>
<ul class="simple">
<li><p>Configuration name: <code class="xref std std-option docutils literal notranslate"><span class="pre">RdYlBu</span></code></p></li>
</ul>
<figure class="align-default">
<a class="reference internal image-reference" href="../_images/RedYellowBlue.png"><img alt="overview of the RedYellowBlue color-gradient" src="../_images/RedYellowBlue.png" style="width: 420px;" /></a>
</figure>
<figure class="align-default" id="id12">
<a class="reference internal image-reference" href="../_images/RedYellowBlue_.png"><img alt="example spectrogram using the RedYellowBlue gradient" src="../_images/RedYellowBlue_.png" style="width: 420px;" /></a>
<figcaption>
<p><span class="caption-text">Figure 37: Example spectrogram using the “RedYellowBlue” color-gradient.</span><a class="headerlink" href="#id12" title="Permalink to this image"></a></p>
</figcaption>
</figure>
</section>
<section id="parula">
<span id="gradients-parula"></span><h4>Parula<a class="headerlink" href="#parula" title="Permalink to this heading"></a></h4>
<ul class="simple">
<li><p>Configuration name: <code class="xref std std-option docutils literal notranslate"><span class="pre">Parula</span></code></p></li>
</ul>
<figure class="align-default">
<a class="reference internal image-reference" href="../_images/Parula.png"><img alt="overview of the Parula color-gradient" src="../_images/Parula.png" style="width: 420px;" /></a>
</figure>
<figure class="align-default" id="id13">
<a class="reference internal image-reference" href="../_images/Parula_.png"><img alt="example spectrogram using the Parula gradient" src="../_images/Parula_.png" style="width: 420px;" /></a>
<figcaption>
<p><span class="caption-text">Figure 39: Example spectrogram using the “Parula” color-gradient.</span><a class="headerlink" href="#id13" title="Permalink to this image"></a></p>
</figcaption>
</figure>
</section>
<section id="viridis">
<span id="gradients-viridis"></span><h4>Viridis<a class="headerlink" href="#viridis" title="Permalink to this heading"></a></h4>
<ul class="simple">
<li><p>Configuration name: <code class="xref std std-option docutils literal notranslate"><span class="pre">Viridis</span></code></p></li>
</ul>
<figure class="align-default">
<a class="reference internal image-reference" href="../_images/Viridis.png"><img alt="overview of the Viridis color-gradient" src="../_images/Viridis.png" style="width: 420px;" /></a>
</figure>
<figure class="align-default" id="id14">
<a class="reference internal image-reference" href="../_images/Viridis_.png"><img alt="example spectrogram using the Viridis gradient" src="../_images/Viridis_.png" style="width: 420px;" /></a>
<figcaption>
<p><span class="caption-text">Figure 41: Example spectrogram using the “Viridis” color-gradient.</span><a class="headerlink" href="#id14" title="Permalink to this image"></a></p>
</figcaption>
</figure>
</section>
</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="#">Color Gradients</a><ul>
<li><a class="reference internal" href="#overview">Overview</a></li>
<li><a class="reference internal" href="#list-of-gradients">List of Gradients</a><ul>
<li><a class="reference internal" href="#full-spectrum">Full spectrum</a><ul>
<li><a class="reference internal" href="#default">Default</a></li>
<li><a class="reference internal" href="#spectrum">Spectrum</a></li>
<li><a class="reference internal" href="#circle">Circle</a></li>
</ul>
</li>
<li><a class="reference internal" href="#dark-to-yellow">Dark to yellow</a><ul>
<li><a class="reference internal" href="#blackbody">BlackBody</a></li>
<li><a class="reference internal" href="#inferno">Inferno</a></li>
<li><a class="reference internal" href="#plasma">Plasma</a></li>
</ul>
</li>
<li><a class="reference internal" href="#black-and-white">Black and white</a><ul>
<li><a class="reference internal" href="#blackwhite">BlackWhite</a></li>
<li><a class="reference internal" href="#whiteblack">WhiteBlack</a></li>
</ul>
</li>
<li><a class="reference internal" href="#single-color">Single color</a><ul>
<li><a class="reference internal" href="#bluepurple">BluePurple</a></li>
<li><a class="reference internal" href="#blues">Blues</a></li>
<li><a class="reference internal" href="#purplered">PurpleRed</a></li>
</ul>
</li>
<li><a class="reference internal" href="#three-color">Three color</a><ul>
<li><a class="reference internal" href="#redyellowblue">RedYellowBlue</a></li>
<li><a class="reference internal" href="#parula">Parula</a></li>
<li><a class="reference internal" href="#viridis">Viridis</a></li>
</ul>
</li>
</ul>
</li>
</ul>
</li>
</ul>
</div>
<div role="note" aria-label="source link">
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="../_sources/base/gradients.rst.txt"
rel="nofollow">Show Source</a></li>
</ul>
</div>
</div>
</div>
</div>
</div>
<div class="footer">
<div class="container">
<div class="content">
Release <b></b> version <b>2025.281#4efc2c878</b>
<div class="copyright">
&copy; Copyright <a href="https://www.gempa.de">2014, gempa GmbH.</a>
</div>
</div>
</div>
</div>
</body>
</html>

209
share/doc/scanloc/html/base/introduction.html Normal file
View File

@ -0,0 +1,209 @@
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>Introduction &#8212; scanloc: Phase Associator documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/gempa.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=fa44fd50" />
<link rel="stylesheet" type="text/css" href="../_static/gempa.css?v=c960eebf" />
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/gempa.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=b3ba4146"></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="scanloc" href="../apps/scanloc.html" />
<link rel="prev" title="scanloc documentation" href="../index.html" />
</head>
<body>
<div class="header">
<div class="container">
<img class="background" src="../_static/icon.png"/>
<div class="content">
<span class="title">scanloc: Phase Associator </span>
<span class="version">2025.281#4efc2c878</span></h1>
</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="../apps/scanloc.html" title="scanloc"
accesskey="N">
next
</a>
</li>
<li class="right">
<a href="../index.html" title="scanloc documentation"
accesskey="P">
previous
</a>
</li>
<li class="nav-item nav-item-0">
<a href="../index.html">Home</a>
</li>
</ul>
</div>
</div>
</div>
</div>
<div class="container">
<div class="fitted content" id="anchors-container">
<div class="body" role="main">
<section id="introduction">
<h1>Introduction<a class="headerlink" href="#introduction" title="Permalink to this heading"></a></h1>
<p>scanloc for <cite>SeisComP</cite> <span id="id1">[<a class="reference internal" href="references.html#id292" title="Helmholtz-Centre Potsdam - GFZ German Research Centre for Geosciences and gempa GmbH. The SeisComP seismological software package. GFZ Data Services. 2008. URL: https://www.seiscomp.de, doi:10.5880/GFZ.2.4.2020.003.">39</a>]</span> is optimzed for monitoring local and
micro seismicity within small as
well as large seismic monitoring networks in low and high seismicity environments.
Typical networks consist of 5 to 20 stations
and sometimes even many more were the station distances are in the range of
hundreds of meters to tens of kilometers.</p>
<p>scanloc makes use of the cluster search algorithm DBSCAN <span id="id2">[<a class="reference internal" href="references.html#id125" title="DBSCAN. Data clustering algorithm. URL: http://en.wikipedia.org/wiki/DBSCAN.">2</a>]</span> to
associate detected seismic phases to one or many potential seismic events.
While the cluster search itself is based on P phases only, in a second step S
picks and more P phases are associated to better locate the event.</p>
<p>In order to provide high-quality picks from S phases, a new
<a class="reference internal" href="sphase-detector.html#scanloc-spicker"><span class="std std-ref">S-phase picker</span></a> is distributed
along with scanloc. The S picker allows to identify S phases on the horizontal
components or on the vertical components if the horizontals should be unavailable.
A <a class="reference internal" href="sphase-detector.html#scanloc-spick-debugger"><span class="std std-ref">user-friendly debugger GUI</span></a> allows the interactive
tuning of the S picker configuration parameters based on waveforms.</p>
<p><a class="reference internal" href="auxiliary.html#sec-scanloc-aux-tools"><span class="std std-ref">Additonal auxiliary tools</span></a> ship with the scanloc
package to support detailed tuning and realistic playbacks.</p>
<section id="applications">
<h2>Applications<a class="headerlink" href="#applications" title="Permalink to this heading"></a></h2>
<p>scanloc is a backbone module in <cite>SeisComP</cite> systems for many applications including</p>
<ul class="simple">
<li><p>Real-time monitoring of local and regional earthquakes,</p></li>
<li><p>Re-processing of historical data for more complete seismicity catalogs,</p></li>
<li><p>Monitoring of natural and induced seismicity in industrial environments e.g. at</p>
<ul>
<li><p>geothermal plants,</p></li>
<li><p>oil and gas production,</p></li>
<li><p>underground gas storages,</p></li>
<li><p>open and deep mines,</p></li>
</ul>
</li>
<li><p>Integration of <a class="reference internal" href="../apps/scanloc.html#scanloc-zero-weight"><span class="std std-ref">teleseismic events</span></a> detected by
local monitoring networks</p></li>
<li><p><a class="reference internal" href="../apps/scanloc.html#scanloc-assoc"><span class="std std-ref">Association of P and S phases</span></a> to detections by other
instances e.g. <span id="id3"><em>ccloc</em> [<a class="reference internal" href="references.html#id122" title="ccloc. gempa module. URL: https://docs.gempa.de/ccloc/current/index.html.">8</a>]</span> or <span id="id4"><em>LAMBDA</em> [<a class="reference internal" href="references.html#id176" title="LAMBDA. gempa module. URL: https://docs.gempa.de/lambda/current/index.html.">4</a>]</span>.</p></li>
</ul>
</section>
<section id="examples-from-science">
<h2>Examples from science<a class="headerlink" href="#examples-from-science" title="Permalink to this heading"></a></h2>
<p>scanloc has been routinely applied, demonstrated, promoted and discussed with
scientists and the SeisComP community in scientific publications and at
international science conferences.</p>
<p>Examples:</p>
<ol class="arabic simple">
<li><p>A.F. Bell, P.C. La Femina, M. Ruiz, F. Amelung, M. Bagnardi, C. J. Bean, B.
Bernard, C. Ebinger, M. Gleeson, J. R. Grannell, S. Hernandez, M. Higgins, C.
Liorzou, P. Lundgren, N. J. Meier, M. Möllhoff, S.-J. Oliva, A. G. Ruiz and
M. J. Stock: Caldera resurgence during the 2018 eruption of Sierra Negra
volcano, Galápagos Islands, 2021, Nat. Commun., 12, 1397,
<a class="reference external" href="https://doi.org/10.1038/s41467-021-21596-4">doi: 10.1038/s41467-021-21596-4</a>.</p></li>
<li><p>F. Grigoli, L. Scarabello, M. Boese, B. Weber, S. Wiemer, J. F. Clinton:
Pick- and waveform-based techniques for real-time detection of induced seismicity,
2018, Geophys. J. Int., 213:2, <a class="reference external" href="https://doi.org/10.1093/gji/ggy019">doi: 0.1093/gji/ggy019</a>.</p></li>
<li><p>J. Clinton, F. Grigoli, T. Diehl, T. Kraft, L. Scarabello, M. Hermann, P. Kaestli,
M. Boese, S. Wiemer: Advanced Real-time Monitoring for Natural and Induced
seismic sequences, 2018, Geophyscial Research Abracts, EGU General Assembly,
Vol. 20,
<a class="reference external" href="https://meetingorganizer.copernicus.org/EGU2018/EGU2018-9480.pdf">abstract: EGU2018-9480-2</a>.</p></li>
<li><p>F. Grigoli, M. Boese, L. Scarabello, T. Diehl, B. Weber, S. Wiemer, J. F. Clinton:
Picking vs Waveform based detection and location methods for induced seismicity
monitoring, 2018, JpGU2018, Japan,
<a class="reference external" href="https://confit.atlas.jp/guide/event/jpgu2018/subject/SSS03-05/detail">abstract: SSS03-05</a>.</p></li>
<li><p>F. Grigoli, M. Boese, L. Scarabello, T. Diehl, B. Weber, S. Wiemer, J. F. Clinton:
Picking vs Waveform based detection and location methods for induced seismicity
monitoring, 2017, Geophyscial Research Abracts, EGU General Assembly, Vol. 19,
<a class="reference external" href="https://meetingorganizer.copernicus.org/EGU2017/EGU2017-10562.pdf">abstract: EGU2017-10562</a>.</p></li>
<li><p>D. Roessler, J. Becker, E. Ellguth, R. Henneberger, S. Herrnkind, B. Weber:
Cluster-search based monitoring of local earthquakes in SeisComP3, 2016,
AG Seismology - 42. meeting, Bad Salzschlirf, Germany</p></li>
<li><p>D. Roessler, E. Ellguth, S. Herrnkind, B. Weber, R. Henneberger, H. Blanck:
Cluster-search based monitoring of local earthquakes in SeisComP3, 2016,
AGU Fall Meeting, San Francisco, USA,
<a class="reference external" href="https://agu.confex.com/agu/fm16/meetingapp.cgi/Paper/119780">abstract S31E-06</a>.</p></li>
</ol>
</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="#">Introduction</a><ul>
<li><a class="reference internal" href="#applications">Applications</a></li>
<li><a class="reference internal" href="#examples-from-science">Examples from science</a></li>
</ul>
</li>
</ul>
</div>
<div>
<h4>Previous topic</h4>
<p class="topless"><a href="../index.html"
title="previous chapter"><cite>scanloc</cite> documentation</a></p>
</div>
<div>
<h4>Next topic</h4>
<p class="topless"><a href="../apps/scanloc.html"
title="next chapter">scanloc</a></p>
</div>
<div role="note" aria-label="source link">
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="../_sources/base/introduction.rst.txt"
rel="nofollow">Show Source</a></li>
</ul>
</div>
</div>
</div>
</div>
</div>
<div class="footer">
<div class="container">
<div class="content">
Release <b></b> version <b>2025.281#4efc2c878</b>
<div class="copyright">
&copy; Copyright <a href="https://www.gempa.de">2014, gempa GmbH.</a>
</div>
</div>
</div>
</div>
</body>
</html>

187
share/doc/scanloc/html/base/locsat-tables.html Normal file
View File

@ -0,0 +1,187 @@
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>Dense Travel-Time Tables &#8212; scanloc: Phase Associator documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/gempa.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=fa44fd50" />
<link rel="stylesheet" type="text/css" href="../_static/gempa.css?v=c960eebf" />
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/gempa.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=b3ba4146"></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="Advanced S-Phase Detector" href="sphase-detector.html" />
<link rel="prev" title="Auxiliary Scripts" href="auxiliary.html" />
</head>
<body>
<div class="header">
<div class="container">
<img class="background" src="../_static/icon.png"/>
<div class="content">
<span class="title">scanloc: Phase Associator </span>
<span class="version">2025.281#4efc2c878</span></h1>
</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="sphase-detector.html" title="Advanced S-Phase Detector"
accesskey="N">
next
</a>
</li>
<li class="right">
<a href="auxiliary.html" title="Auxiliary Scripts"
accesskey="P">
previous
</a>
</li>
<li class="nav-item nav-item-0">
<a href="../index.html">Home</a>
</li>
</ul>
</div>
</div>
</div>
</div>
<div class="container">
<div class="fitted content" id="anchors-container">
<div class="body" role="main">
<section id="dense-travel-time-tables">
<span id="scanloc-ttt"></span><h1>Dense Travel-Time Tables<a class="headerlink" href="#dense-travel-time-tables" title="Permalink to this heading"></a></h1>
<p>The default travel time tables of SeisComP for <span id="id1"><em>LOCSAT</em> [<a class="reference internal" href="references.html#id180" title="LOCSAT. SeisComP locator. URL: https://docs.gempa.de/seiscomp/current/apps/global_locsat.html.">5</a>]</span> provide the
times in intervals of 1 degree epicentral distance. Thus, the curvature of the
travel-time curve at closer distance is not well imaged potentially resulting in
wrong locations or missing event solutions. Therefore, the LOCSAT tables,
<em>iasp91_scanloc</em>, based on the IASP91 model with higher spacial sampling are
added to the scanloc package. The table files are located in
<code class="file docutils literal notranslate"><span class="pre">$SEISCOMP_ROOT/share/locsat/tables</span></code>. They may be used along with scanloc
and any other module which uses LOCSAT travel-time tables such as <span id="id2"><em>scolv</em> [<a class="reference internal" href="references.html#id268" title="scolv. SeisComP module. URL: https://docs.gempa.de/seiscomp/current/apps/scolv.html.">24</a>]</span>,
<span id="id3"><em>scautoloc</em> [<a class="reference internal" href="references.html#id238" title="scautoloc. SeisComP module. URL: https://docs.gempa.de/seiscomp/current/apps/scautoloc.html.">14</a>]</span>, <span id="id4"><em>screloc</em> [<a class="reference internal" href="references.html#id275" title="screloc. SeisComP module. URL: https://docs.gempa.de/seiscomp/current/apps/screloc.html.">25</a>]</span> or even the locator <span id="id5"><em>StdLoc</em> [<a class="reference internal" href="references.html#id306" title="StdLoc. SeisComP locator. URL: https://docs.gempa.de/seiscomp/current/apps/global_stdloc.html.">7</a>]</span>.</p>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>gempa may provide additional travel-time tables as a service based on custom
velocity models. <a class="reference external" href="https://www.gempa.de/contact/">Contact</a> us for any
related request.</p>
</div>
<figure class="align-center" id="id8">
<span id="fig-ttt-scanloc"></span><a class="reference internal image-reference" href="../_images/ttt_scanloc_P_5km.png"><img alt="../_images/ttt_scanloc_P_5km.png" src="../_images/ttt_scanloc_P_5km.png" style="width: 18cm;" /></a>
<figcaption>
<p><span class="caption-text">Figure 42: Differences between P-wave travel times in the standard iasp91 tables for LOCSAT
and the iasp91_scanloc tables provided with scanloc for an event at 5 km depth.</span><a class="headerlink" href="#id8" title="Permalink to this image"></a></p>
</figcaption>
</figure>
<section id="application-in-scanloc">
<h2>Application in scanloc<a class="headerlink" href="#application-in-scanloc" title="Permalink to this heading"></a></h2>
<p>Configure the scanloc parameters <a class="reference internal" href="../apps/scanloc.html#confval-association.table"><code class="xref std std-confval docutils literal notranslate"><span class="pre">association.table</span></code></a> and
<a class="reference internal" href="../apps/scanloc.html#confval-locator.profile"><code class="xref std std-confval docutils literal notranslate"><span class="pre">locator.profile</span></code></a> with <em>iasp91_scanloc</em> for using these LOCSAT tables
in scanloc along with LOCSAT:</p>
<div class="highlight-params notranslate"><div class="highlight"><pre><span></span># Type of travel-time tables for phase association. May be different from locator.
# Use e.g. libtau or LOCSAT.
association.tableType = LOCSAT
# Name of travel-time table used for phase association. May be different from locator
# profile.
association.table = iasp91_scanloc
# The locator type to use
locator.type = LOCSAT
# The locator profile to use
locator.profile = iasp91_scanloc
</pre></div>
</div>
<p>Alternatively, you may use the tables along with <span id="id6"><em>StdLoc</em> [<a class="reference internal" href="references.html#id306" title="StdLoc. SeisComP locator. URL: https://docs.gempa.de/seiscomp/current/apps/global_stdloc.html.">7</a>]</span>.</p>
</section>
<section id="application-in-other-modules">
<h2>Application in other modules<a class="headerlink" href="#application-in-other-modules" title="Permalink to this heading"></a></h2>
<p>In order to visualize the travel times or for using the tables in applications
like <span id="id7"><em>scolv</em> [<a class="reference internal" href="references.html#id268" title="scolv. SeisComP module. URL: https://docs.gempa.de/seiscomp/current/apps/scolv.html.">24</a>]</span> add the tables to your global module configuration:</p>
<div class="highlight-params notranslate"><div class="highlight"><pre><span></span>ttt.LOCSAT.tables = iasp91_scanloc
LOCSAT.profiles = iasp91_scanloc
</pre></div>
</div>
<p>More specific parameters may exist along with your application.</p>
</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="#">Dense Travel-Time Tables</a><ul>
<li><a class="reference internal" href="#application-in-scanloc">Application in scanloc</a></li>
<li><a class="reference internal" href="#application-in-other-modules">Application in other modules</a></li>
</ul>
</li>
</ul>
</div>
<div>
<h4>Previous topic</h4>
<p class="topless"><a href="auxiliary.html"
title="previous chapter">Auxiliary Scripts</a></p>
</div>
<div>
<h4>Next topic</h4>
<p class="topless"><a href="sphase-detector.html"
title="next chapter">Advanced S-Phase Detector</a></p>
</div>
<div role="note" aria-label="source link">
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="../_sources/base/locsat-tables.rst.txt"
rel="nofollow">Show Source</a></li>
</ul>
</div>
</div>
</div>
</div>
</div>
<div class="footer">
<div class="container">
<div class="content">
Release <b></b> version <b>2025.281#4efc2c878</b>
<div class="copyright">
&copy; Copyright <a href="https://www.gempa.de">2014, gempa GmbH.</a>
</div>
</div>
</div>
</div>
</body>
</html>

282
share/doc/scanloc/html/base/references.html Normal file
View File

@ -0,0 +1,282 @@
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>References &#8212; scanloc: Phase Associator documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/gempa.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=fa44fd50" />
<link rel="stylesheet" type="text/css" href="../_static/gempa.css?v=c960eebf" />
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/gempa.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=b3ba4146"></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="Change Log" href="changelog.html" />
<link rel="prev" title="Glossary" href="glossary.html" />
</head>
<body>
<div class="header">
<div class="container">
<img class="background" src="../_static/icon.png"/>
<div class="content">
<span class="title">scanloc: Phase Associator </span>
<span class="version">2025.281#4efc2c878</span></h1>
</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="changelog.html" title="Change Log"
accesskey="N">
next
</a>
</li>
<li class="right">
<a href="glossary.html" title="Glossary"
accesskey="P">
previous
</a>
</li>
<li class="nav-item nav-item-0">
<a href="../index.html">Home</a>
</li>
</ul>
</div>
</div>
</div>
</div>
<div class="container">
<div class="fitted content" id="anchors-container">
<div class="body" role="main">
<section id="references">
<h1>References<a class="headerlink" href="#references" title="Permalink to this heading"></a></h1>
<div class="docutils container" id="id1">
<div role="list" class="citation-list">
<div class="citation" id="id116" role="doc-biblioentry">
<span class="label"><span class="fn-bracket">[</span>1<span class="fn-bracket">]</span></span>
<p>CAPS. gempa module. URL: <a class="reference external" href="https://docs.gempa.de/caps/current/index.html">https://docs.gempa.de/caps/current/index.html</a>.</p>
</div>
<div class="citation" id="id125" role="doc-biblioentry">
<span class="label"><span class="fn-bracket">[</span>2<span class="fn-bracket">]</span></span>
<p>DBSCAN. Data clustering algorithm. URL: <a class="reference external" href="http://en.wikipedia.org/wiki/DBSCAN">http://en.wikipedia.org/wiki/DBSCAN</a>.</p>
</div>
<div class="citation" id="id159" role="doc-biblioentry">
<span class="label"><span class="fn-bracket">[</span>3<span class="fn-bracket">]</span></span>
<p>Hypo71. SeisComP locator. URL: <a class="reference external" href="https://docs.gempa.de/seiscomp/current/apps/global_hypo71.html">https://docs.gempa.de/seiscomp/current/apps/global_hypo71.html</a>.</p>
</div>
<div class="citation" id="id176" role="doc-biblioentry">
<span class="label"><span class="fn-bracket">[</span>4<span class="fn-bracket">]</span></span>
<p>LAMBDA. gempa module. URL: <a class="reference external" href="https://docs.gempa.de/lambda/current/index.html">https://docs.gempa.de/lambda/current/index.html</a>.</p>
</div>
<div class="citation" id="id180" role="doc-biblioentry">
<span class="label"><span class="fn-bracket">[</span>5<span class="fn-bracket">]</span></span>
<p>LOCSAT. SeisComP locator. URL: <a class="reference external" href="https://docs.gempa.de/seiscomp/current/apps/global_locsat.html">https://docs.gempa.de/seiscomp/current/apps/global_locsat.html</a>.</p>
</div>
<div class="citation" id="id290" role="doc-biblioentry">
<span class="label"><span class="fn-bracket">[</span>6<span class="fn-bracket">]</span></span>
<p>SeisComP documentation. start page. URL: <a class="reference external" href="https://docs.gempa.de/seiscomp/current/index.html">https://docs.gempa.de/seiscomp/current/index.html</a>.</p>
</div>
<div class="citation" id="id306" role="doc-biblioentry">
<span class="label"><span class="fn-bracket">[</span>7<span class="fn-bracket">]</span></span>
<p>StdLoc. SeisComP locator. URL: <a class="reference external" href="https://docs.gempa.de/seiscomp/current/apps/global_stdloc.html">https://docs.gempa.de/seiscomp/current/apps/global_stdloc.html</a>.</p>
</div>
<div class="citation" id="id122" role="doc-biblioentry">
<span class="label"><span class="fn-bracket">[</span>8<span class="fn-bracket">]</span></span>
<p>ccloc. gempa module. URL: <a class="reference external" href="https://docs.gempa.de/ccloc/current/index.html">https://docs.gempa.de/ccloc/current/index.html</a>.</p>
</div>
<div class="citation" id="id166" role="doc-biblioentry">
<span class="label"><span class="fn-bracket">[</span>9<span class="fn-bracket">]</span></span>
<p>invextr. SeisComP module. URL: <a class="reference external" href="https://docs.gempa.de/seiscomp/current/apps/invextr.html">https://docs.gempa.de/seiscomp/current/apps/invextr.html</a>.</p>
</div>
<div class="citation" id="id189" role="doc-biblioentry">
<span class="label"><span class="fn-bracket">[</span>10<span class="fn-bracket">]</span></span>
<p>messaging. SeisComP concept. URL: <a class="reference external" href="https://docs.gempa.de/seiscomp/current/base/concepts/messaging.html">https://docs.gempa.de/seiscomp/current/base/concepts/messaging.html</a>.</p>
</div>
<div class="citation" id="id215" role="doc-biblioentry">
<span class="label"><span class="fn-bracket">[</span>11<span class="fn-bracket">]</span></span>
<p>pipeline. SeisComP3 wiki. URL: <a class="reference external" href="https://www.SeisComP3.org/wiki/recipes/multiple-pick-loc-pipeline">https://www.SeisComP3.org/wiki/recipes/multiple-pick-loc-pipeline</a>.</p>
</div>
<div class="citation" id="id236" role="doc-biblioentry">
<span class="label"><span class="fn-bracket">[</span>12<span class="fn-bracket">]</span></span>
<p>scamp. SeisComP module. URL: <a class="reference external" href="https://docs.gempa.de/seiscomp/current/apps/scamp.html">https://docs.gempa.de/seiscomp/current/apps/scamp.html</a>.</p>
</div>
<div class="citation" id="id241" role="doc-biblioentry">
<span class="label"><span class="fn-bracket">[</span>13<span class="fn-bracket">]</span></span>
<p>scart. SeisComP module. URL: <a class="reference external" href="https://docs.gempa.de/seiscomp/current/apps/scart.html">https://docs.gempa.de/seiscomp/current/apps/scart.html</a>.</p>
</div>
<div class="citation" id="id238" role="doc-biblioentry">
<span class="label"><span class="fn-bracket">[</span>14<span class="fn-bracket">]</span></span>
<p>scautoloc. SeisComP module. URL: <a class="reference external" href="https://docs.gempa.de/seiscomp/current/apps/scautoloc.html">https://docs.gempa.de/seiscomp/current/apps/scautoloc.html</a>.</p>
</div>
<div class="citation" id="id237" role="doc-biblioentry">
<span class="label"><span class="fn-bracket">[</span>15<span class="fn-bracket">]</span></span>
<p>scautopick. SeisComP module. URL: <a class="reference external" href="https://docs.gempa.de/seiscomp/current/apps/scautopick.html">https://docs.gempa.de/seiscomp/current/apps/scautopick.html</a>.</p>
</div>
<div class="citation" id="id246" role="doc-biblioentry">
<span class="label"><span class="fn-bracket">[</span>16<span class="fn-bracket">]</span></span>
<p>scdb. SeisComP module. URL: <a class="reference external" href="https://docs.gempa.de/seiscomp/current/apps/scdb.html">https://docs.gempa.de/seiscomp/current/apps/scdb.html</a>.</p>
</div>
<div class="citation" id="id248" role="doc-biblioentry">
<span class="label"><span class="fn-bracket">[</span>17<span class="fn-bracket">]</span></span>
<p>scdispatch. SeisComP module. URL: <a class="reference external" href="https://docs.gempa.de/seiscomp/current/apps/scdispatch.html">https://docs.gempa.de/seiscomp/current/apps/scdispatch.html</a>.</p>
</div>
<div class="citation" id="id249" role="doc-biblioentry">
<span class="label"><span class="fn-bracket">[</span>18<span class="fn-bracket">]</span></span>
<p>scdumpcfg. SeisComP module. URL: <a class="reference external" href="https://docs.gempa.de/seiscomp/current/apps/scdumpcfg.html">https://docs.gempa.de/seiscomp/current/apps/scdumpcfg.html</a>.</p>
</div>
<div class="citation" id="id253" role="doc-biblioentry">
<span class="label"><span class="fn-bracket">[</span>19<span class="fn-bracket">]</span></span>
<p>scevent. SeisComP module. URL: <a class="reference external" href="https://docs.gempa.de/seiscomp/current/apps/scevent.html">https://docs.gempa.de/seiscomp/current/apps/scevent.html</a>.</p>
</div>
<div class="citation" id="id256" role="doc-biblioentry">
<span class="label"><span class="fn-bracket">[</span>20<span class="fn-bracket">]</span></span>
<p>scevtstreams. SeisComP module. URL: <a class="reference external" href="https://docs.gempa.de/seiscomp/current/apps/scevtstreams.html">https://docs.gempa.de/seiscomp/current/apps/scevtstreams.html</a>.</p>
</div>
<div class="citation" id="id260" role="doc-biblioentry">
<span class="label"><span class="fn-bracket">[</span>21<span class="fn-bracket">]</span></span>
<p>scinv. SeisComP module. URL: <a class="reference external" href="https://docs.gempa.de/seiscomp/current/apps/scinv.html">https://docs.gempa.de/seiscomp/current/apps/scinv.html</a>.</p>
</div>
<div class="citation" id="id262" role="doc-biblioentry">
<span class="label"><span class="fn-bracket">[</span>22<span class="fn-bracket">]</span></span>
<p>scmag. SeisComP module. URL: <a class="reference external" href="https://docs.gempa.de/seiscomp/current/apps/scmag.html">https://docs.gempa.de/seiscomp/current/apps/scmag.html</a>.</p>
</div>
<div class="citation" id="id263" role="doc-biblioentry">
<span class="label"><span class="fn-bracket">[</span>23<span class="fn-bracket">]</span></span>
<p>scmaster. SeisComP module. URL: <a class="reference external" href="https://docs.gempa.de/seiscomp/current/apps/scmaster.html">https://docs.gempa.de/seiscomp/current/apps/scmaster.html</a>.</p>
</div>
<div class="citation" id="id268" role="doc-biblioentry">
<span class="label"><span class="fn-bracket">[</span>24<span class="fn-bracket">]</span></span>
<p>scolv. SeisComP module. URL: <a class="reference external" href="https://docs.gempa.de/seiscomp/current/apps/scolv.html">https://docs.gempa.de/seiscomp/current/apps/scolv.html</a>.</p>
</div>
<div class="citation" id="id275" role="doc-biblioentry">
<span class="label"><span class="fn-bracket">[</span>25<span class="fn-bracket">]</span></span>
<p>screloc. SeisComP module. URL: <a class="reference external" href="https://docs.gempa.de/seiscomp/current/apps/screloc.html">https://docs.gempa.de/seiscomp/current/apps/screloc.html</a>.</p>
</div>
<div class="citation" id="id284" role="doc-biblioentry">
<span class="label"><span class="fn-bracket">[</span>26<span class="fn-bracket">]</span></span>
<p>scxmldump. SeisComP module. URL: <a class="reference external" href="https://docs.gempa.de/seiscomp/current/apps/scxmldump.html">https://docs.gempa.de/seiscomp/current/apps/scxmldump.html</a>.</p>
</div>
<div class="citation" id="id285" role="doc-biblioentry">
<span class="label"><span class="fn-bracket">[</span>27<span class="fn-bracket">]</span></span>
<p>scxmlmerge. SeisComP module. URL: <a class="reference external" href="https://docs.gempa.de/seiscomp/current/apps/scxmlmerge.html">https://docs.gempa.de/seiscomp/current/apps/scxmlmerge.html</a>.</p>
</div>
<div class="citation" id="id288" role="doc-biblioentry">
<span class="label"><span class="fn-bracket">[</span>28<span class="fn-bracket">]</span></span>
<p>seedlink. Real-time waveform server. URL: <a class="reference external" href="https://docs.gempa.de/seiscomp/current/apps/seedlink.html">https://docs.gempa.de/seiscomp/current/apps/seedlink.html</a>.</p>
</div>
<div class="citation" id="id287" role="doc-biblioentry">
<span class="label"><span class="fn-bracket">[</span>29<span class="fn-bracket">]</span></span>
<p>SEED Reference Manual. USGS, 2012. URL: <a class="reference external" href="http://www.fdsn.org/pdf/SEEDManual_V2.4.pdf">http://www.fdsn.org/pdf/SEEDManual_V2.4.pdf</a>.</p>
</div>
<div class="citation" id="id29" role="doc-biblioentry">
<span class="label"><span class="fn-bracket">[</span>30<span class="fn-bracket">]</span></span>
<p>P. Bormann and J. Saul. A Fast, Non-saturating Magnitude Estimator for Great Earthquakes. <em>Seismol. Res. Lett.</em>, 80(5):808 – 816, 2009. <a class="reference external" href="https://doi.org/10.1785/gssrl.80.5.808">doi:10.1785/gssrl.80.5.808</a>.</p>
</div>
<div class="citation" id="id27" role="doc-biblioentry">
<span class="label"><span class="fn-bracket">[</span>31<span class="fn-bracket">]</span></span>
<p>P. Bormann and K. Wylegalla. Quick estimator of the size of great earthquakes. <em>EOS</em>, 86(46):464, 2005.</p>
</div>
<div class="citation" id="id51" role="doc-biblioentry">
<span class="label"><span class="fn-bracket">[</span>32<span class="fn-bracket">]</span></span>
<p>B. Gutenberg and C.F. Richter. Magnitude and Energy of Earthquakes. <em>Annals of Geophysics</em>, 9(1):1 – 15, 1956. URL: <a class="reference external" href="https://resolver.caltech.edu/CaltechAUTHORS:20140130-105324849">https://resolver.caltech.edu/CaltechAUTHORS:20140130-105324849</a>, <a class="reference external" href="https://doi.org/10.4401/ag-5590">doi:10.4401/ag-5590</a>.</p>
</div>
<div class="citation" id="id60" role="doc-biblioentry">
<span class="label"><span class="fn-bracket">[</span>33<span class="fn-bracket">]</span></span>
<p>A. Katsumata. Comparison of Magnitudes Estimated by the Japan Meteorological Agency with Moment Magnitudes for Intermediate and Deep Earthquakes. <em>Bull. Seism. Soc.</em>, 86(3):832 – 842, 1996.</p>
</div>
<div class="citation" id="id201" role="doc-biblioentry">
<span class="label"><span class="fn-bracket">[</span>34<span class="fn-bracket">]</span></span>
<p>A. Lomax. The NonLinLoc Software Guide. Manual. URL: <a class="reference external" href="http://alomax.free.fr/nlloc/">http://alomax.free.fr/nlloc/</a>.</p>
</div>
<div class="citation" id="id81" role="doc-biblioentry">
<span class="label"><span class="fn-bracket">[</span>35<span class="fn-bracket">]</span></span>
<p>C.F. Richter. An instrumental earthquake magnitude scale. <em>Bull. Seismol. Soc. Am.</em>, 1:1 – 32, 1935. URL: <a class="reference external" href="https://resolver.caltech.edu/CaltechAUTHORS:20140804-143558638">https://resolver.caltech.edu/CaltechAUTHORS:20140804-143558638</a>, <a class="reference external" href="https://doi.org/10.1785/BSSA0250010001">doi:10.1785/BSSA0250010001</a>.</p>
</div>
<div class="citation" id="id101" role="doc-biblioentry">
<span class="label"><span class="fn-bracket">[</span>36<span class="fn-bracket">]</span></span>
<p>S. Tsuboi, K. Abe, K. Takano, and Y. Yamanaka. Rapid determination of Mw from broadband P waveforms. <em>Bull. Seismol. Soc. Am.</em>, 1995. <a class="reference external" href="https://doi.org/10.1785/BSSA0850020606">doi:10.1785/BSSA0850020606</a>.</p>
</div>
<div class="citation" id="id104" role="doc-biblioentry">
<span class="label"><span class="fn-bracket">[</span>37<span class="fn-bracket">]</span></span>
<p>R.A. Uhrhammer and E.R. Collins. Synthesis of Wood-Anderson seismograms from broadband digital records. <em>Bull. Seismol. Soc. Am.</em>, 80(3):702–716, 1990. <a class="reference external" href="https://doi.org/10.1785/BSSA0800030702">doi:10.1785/BSSA0800030702</a>.</p>
</div>
<div class="citation" id="id108" role="doc-biblioentry">
<span class="label"><span class="fn-bracket">[</span>38<span class="fn-bracket">]</span></span>
<p>P.M. Whitmore, S. Tsuboi, B. Hirshorn, and T.J. Sokolowski. Magnitude dependent correction for Mwp. <em>Science of Tsunami Hazards</em>, 20(4):, 2002.</p>
</div>
<div class="citation" id="id292" role="doc-biblioentry">
<span class="label"><span class="fn-bracket">[</span>39<span class="fn-bracket">]</span></span>
<p>Helmholtz-Centre Potsdam - GFZ German Research Centre for Geosciences and gempa GmbH. The SeisComP seismological software package. GFZ Data Services. 2008. URL: <a class="reference external" href="https://www.seiscomp.de">https://www.seiscomp.de</a>, <a class="reference external" href="https://doi.org/10.5880/GFZ.2.4.2020.003">doi:10.5880/GFZ.2.4.2020.003</a>.</p>
</div>
</div>
</div>
</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>
<h4>Previous topic</h4>
<p class="topless"><a href="glossary.html"
title="previous chapter">Glossary</a></p>
</div>
<div>
<h4>Next topic</h4>
<p class="topless"><a href="changelog.html"
title="next chapter">Change Log</a></p>
</div>
<div role="note" aria-label="source link">
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="../_sources/base/references.rst.txt"
rel="nofollow">Show Source</a></li>
</ul>
</div>
</div>
</div>
</div>
</div>
<div class="footer">
<div class="container">
<div class="content">
Release <b></b> version <b>2025.281#4efc2c878</b>
<div class="copyright">
&copy; Copyright <a href="https://www.gempa.de">2014, gempa GmbH.</a>
</div>
</div>
</div>
</div>
</body>
</html>

340
share/doc/scanloc/html/base/sphase-detector.html Normal file
View File

@ -0,0 +1,340 @@
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>Advanced S-Phase Detector &#8212; scanloc: Phase Associator documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/gempa.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=fa44fd50" />
<link rel="stylesheet" type="text/css" href="../_static/gempa.css?v=c960eebf" />
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/gempa.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=b3ba4146"></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="prev" title="Dense Travel-Time Tables" href="locsat-tables.html" />
</head>
<body>
<div class="header">
<div class="container">
<img class="background" src="../_static/icon.png"/>
<div class="content">
<span class="title">scanloc: Phase Associator </span>
<span class="version">2025.281#4efc2c878</span></h1>
</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="locsat-tables.html" title="Dense Travel-Time Tables"
accesskey="P">
previous
</a>
</li>
<li class="nav-item nav-item-0">
<a href="../index.html">Home</a>
</li>
</ul>
</div>
</div>
</div>
</div>
<div class="container">
<div class="fitted content" id="anchors-container">
<div class="body" role="main">
<section id="advanced-s-phase-detector">
<span id="scanloc-spicker"></span><h1>Advanced S-Phase Detector<a class="headerlink" href="#advanced-s-phase-detector" title="Permalink to this heading"></a></h1>
<p>The <a class="reference internal" href="../apps/scanloc.html#scanloc"><span class="std std-ref">scanloc</span></a> package provides the enhanced S-phase detectors,
S-AIC and S-AIC-V, as well as the <a class="reference internal" href="#scanloc-spick-debugger"><span class="std std-ref">debugger</span></a>.</p>
<section id="overview">
<h2>Overview<a class="headerlink" href="#overview" title="Permalink to this heading"></a></h2>
<p>The <em>scanloc</em> package includes two S phase pickers: S-AIC and S-AIC-V, enhancing the
performance of the picker with respect to the OpenSource S-L2. Both picker
apply an AIC algorithm in order to detect S phases after a P pick was maked.
Therefore S phases are only detected after a P detection.
Using the S-AIC, S picks are determined on the vectorial sum of the horizontal
componentes (L2 trace).
The S-AIC-V works like the S-AIC but it picks S phases on the vertical component.</p>
<p>The method which was applied to make the pick can be read</p>
<ul class="simple">
<li><p>In the method column of the arrival table in the Location tab of <span id="id1"><em>scolv</em> [<a class="reference internal" href="references.html#id268" title="scolv. SeisComP module. URL: https://docs.gempa.de/seiscomp/current/apps/scolv.html.">24</a>]</span>,</p></li>
<li><p>In the picker window from the letter within brackets following a phase type,</p></li>
<li><p>In the picker window from the hint which appears when hovering over a
pick.</p></li>
</ul>
<figure class="align-center" id="id3">
<span id="scanloc-fig-picker-method"></span><a class="reference internal image-reference" href="../_images/scolv-picker-method.png"><img alt="../_images/scolv-picker-method.png" src="../_images/scolv-picker-method.png" style="width: 10cm;" /></a>
<figcaption>
<p><span class="caption-text">Figure 43: Read the method applied to make a pick in the arrival table of scolv or in
the picker window.</span><a class="headerlink" href="#id3" title="Permalink to this image"></a></p>
</figcaption>
</figure>
<p>The performance of the pickers have been tested by comparison of automatic
with manual picks (see the <a class="reference internal" href="#scanloc-fig-picker-comparison"><span class="std std-ref">Figure showing the comparison</span></a>).</p>
<figure class="align-center" id="id4">
<span id="scanloc-fig-picker-comparison"></span><a class="reference internal image-reference" href="../_images/hist_comp_vgt.png"><img alt="../_images/hist_comp_vgt.png" src="../_images/hist_comp_vgt.png" style="width: 10cm;" /></a>
<figcaption>
<p><span class="caption-text">Figure 44: Performance comparison showing the differences in pick time from manual picks
and the optimally tuned pickers S-L2, S-AIC and S-AIC-V for local earthquakes
in West-Bohemia/Vogtland. The area is typical of local earthquake monitored at
short epicentral distances of a few tens of kilometers. The distribution of
the differences in the automatic pick times with respect to the manual ones
shows the increased performance using the S-AIC.</span><a class="headerlink" href="#id4" title="Permalink to this image"></a></p>
</figcaption>
</figure>
</section>
<section id="picker-configuration">
<h2>Picker configuration<a class="headerlink" href="#picker-configuration" title="Permalink to this heading"></a></h2>
<ol class="arabic">
<li><p><strong>Global module parameters:</strong> Add the plugin <em>saic</em> to the configuration of
<strong class="program">scautopick</strong> or the global
module configuration for making use of the S-AIC or the S-AIC-V:</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><span class="si">${</span><span class="nv">plugins</span><span class="si">}</span>,saic
</pre></div>
</div>
</li>
<li><p><strong>Module parameters:</strong> Activate one of the S-phase ickers (S-L2, S-AIC, S-AIC-V)
by changing the name of the S picker in the module
configuration of <strong class="program">scautopick</strong>. Deactivating <em>killPendingSPickers</em> will allow
to pick S phases even if more P phases were detected before:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="nv">spicker</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s2">&quot;S-AIC&quot;</span>
<span class="nv">killPendingSPickers</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nb">false</span>
</pre></div>
</div>
</li>
<li><p><strong>Bindings parameters:</strong> Configure the S-picker parameters under <em>spicker</em> in
global section of the bindings of <strong class="program">scautopick</strong> e.g. for
<em>S-AIC</em> in local earthquake monitoring. For tuning the values based on actual
data you may use the <a class="reference internal" href="#scanloc-spick-debugger"><span class="std std-ref">graphical debugger</span></a>:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="nv">detecFilter</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s2">&quot;RMHP(10)&gt;&gt;ITAPER(30)&gt;&gt;BW(4,4,20)&gt;&gt;STALTA(0.2,20)&quot;</span>
<span class="nv">timeCorr</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="m">0</span>
spicker.AIC.noiseBegin<span class="w"> </span><span class="o">=</span><span class="w"> </span>-10
spicker.AIC.signalBegin<span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="m">0</span>.5
spicker.AIC.filter<span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s2">&quot;ITAPER(4)&gt;&gt;BW_HP(4,3)&quot;</span>
spicker.AIC.detecFilter<span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s2">&quot;&quot;</span>
spicker.AIC.step<span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="m">0</span>.5
spicker.AIC.minSNR<span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="m">5</span>
spicker.AIC.minCnt<span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="m">5</span>
</pre></div>
</div>
<p>The AIC parameters <em>spicker.AIC.</em> are used for <em>S-AIC</em> and for <em>S-AIC-V</em>.
The parameters of the S-phase pickers can be configured in the global section of the
bindings profile of <strong class="program">scautopick</strong>. The meaning of some parameters are shared
between the S-phase pickers:</p>
<table class="docutils align-default" id="scanloc-table-parameter">
<colgroup>
<col style="width: 15.0%" />
<col style="width: 25.0%" />
<col style="width: 60.0%" />
</colgroup>
<thead>
<tr class="row-odd"><th class="head"><p>Parameter</p></th>
<th class="head"><p>Picker type</p></th>
<th class="head"><p>Description</p></th>
</tr>
</thead>
<tbody>
<tr class="row-even"><td><p><code class="xref std std-confval docutils literal notranslate"><span class="pre">noiseBegin</span></code></p></td>
<td><p>S-AIC, S-AIC-V, S-L2</p></td>
<td><p>Data window added before the p pick on order to compensate
for effects due to the data processing, filtering and to compute the SNR.</p></td>
</tr>
<tr class="row-odd"><td><p><code class="xref std std-confval docutils literal notranslate"><span class="pre">signalBegin</span></code></p></td>
<td><p>S-AIC, S-AIC-V, S-L2</p></td>
<td><p>Start of the data processing relative to the reference P pick.</p></td>
</tr>
<tr class="row-even"><td><p><code class="xref std std-confval docutils literal notranslate"><span class="pre">signalEnd</span></code></p></td>
<td><p>S-AIC, S-AIC-V, S-L2</p></td>
<td><p>End of the data processing relative to the reference P pick.</p></td>
</tr>
<tr class="row-odd"><td><p><code class="xref std std-confval docutils literal notranslate"><span class="pre">filter</span></code></p></td>
<td><p>S-AIC, S-L2</p></td>
<td><p>Filter applied before forming the L2 trace.</p></td>
</tr>
<tr class="row-even"><td><p><code class="xref std std-confval docutils literal notranslate"><span class="pre">detectFilter</span></code></p></td>
<td><p>S-AIC, S-AIC-V, S-L2</p></td>
<td><p>Filter applied on the L2 trace before AIC analysis.</p></td>
</tr>
<tr class="row-odd"><td><p><code class="xref std std-confval docutils literal notranslate"><span class="pre">step</span></code></p></td>
<td><p>S-AIC, S-AIC-V</p></td>
<td><p>Step size in which the time windows are enlarged.</p></td>
</tr>
<tr class="row-even"><td><p><code class="xref std std-confval docutils literal notranslate"><span class="pre">minSNR</span></code></p></td>
<td><p>S-AIC, S-AIC-V, S-L2</p></td>
<td><p>Minimum SNR in order to accept a pick.</p></td>
</tr>
<tr class="row-odd"><td><p><code class="xref std std-confval docutils literal notranslate"><span class="pre">minCnt</span></code></p></td>
<td><p>S-AIC, S-AIC-V</p></td>
<td><p>Minimum number the AIC minimum must be found for subsequent time windows.</p></td>
</tr>
<tr class="row-even"><td><p><code class="xref std std-confval docutils literal notranslate"><span class="pre">uncertainty</span></code></p></td>
<td><p>S-AIC, S-AIC-V</p></td>
<td><p>Pick uncertainty. Unused by the picker but part of the output pick element.</p></td>
</tr>
</tbody>
</table>
</li>
</ol>
</section>
<section id="picker-tuning-debugger">
<span id="scanloc-spick-debugger"></span><h2>Picker tuning: Debugger<a class="headerlink" href="#picker-tuning-debugger" title="Permalink to this heading"></a></h2>
<p>The <a class="reference internal" href="#scanloc-fig-debugger"><span class="std std-ref">debugger GUI</span></a> allows the graphics-assisted tuning
of the S pickers, S-L2, S-AIC, S-AIC-V. In order to make use of the S picker
debugging GUI:</p>
<ol class="arabic">
<li><p><strong>Global module parameters:</strong> Add the plugin <em>spickdbg</em> to the global
configuration of <span id="id2"><em>scolv</em> [<a class="reference internal" href="references.html#id268" title="scolv. SeisComP module. URL: https://docs.gempa.de/seiscomp/current/apps/scolv.html.">24</a>]</span> (<code class="file docutils literal notranslate"><span class="pre">scolv.cfg</span></code>)</p>
<div class="highlight-params notranslate"><div class="highlight"><pre><span></span>plugins = ${plugins}, spickdbg
</pre></div>
</div>
</li>
<li><p><strong>Global bindings:</strong> Configure the initial parameters in the global bindings
of the considered stream. You may adopt parameters from the ones used by the
<em>spicker</em> for a good inital guess.</p></li>
</ol>
<p>The debugger GUI can be started from the picker window of <strong class="program">scolv</strong>.
If there is an existing P pick, the debugger window can be opened with a
right click on the P pick. In the dropdown menu the S picker type can be chosen.</p>
<figure class="align-center" id="id5">
<span id="scanloc-fig-picker-debugger-menu"></span><a class="reference internal image-reference" href="../_images/scolv-picker-debugger-open.png"><img alt="../_images/scolv-picker-debugger-open.png" src="../_images/scolv-picker-debugger-open.png" style="width: 10cm;" /></a>
<figcaption>
<p><span class="caption-text">Figure 45: Selection of S-picker debugger by right-clicking on a P phase.</span><a class="headerlink" href="#id5" title="Permalink to this image"></a></p>
</figcaption>
</figure>
<p>A new pop-up window opens where the P pick (red line) and the newly determined S
pick (light blue line) are shown and the parameters can be tested.</p>
<figure class="align-center" id="id6">
<span id="scanloc-fig-debugger"></span><a class="reference internal image-reference" href="../_images/s-picker-debugger.png"><img alt="../_images/s-picker-debugger.png" src="../_images/s-picker-debugger.png" style="width: 10cm;" /></a>
<figcaption>
<p><span class="caption-text">Figure 46: S-picker debugger example showing the filtered horizontal traces, the
computed L2 trace and the resulting S pick (light blue line).</span><a class="headerlink" href="#id6" title="Permalink to this image"></a></p>
</figcaption>
</figure>
<p>The <a class="reference internal" href="#scanloc-fig-debugger"><span class="std std-ref">example above</span></a> shows the debugger GUI for a local
earthquake:</p>
<ul class="simple">
<li><p><strong>Top traces:</strong> original filtered data.</p></li>
<li><p><strong>Bottom trace:</strong> Resulting trace e.g. L2.</p></li>
<li><p><strong>First red line:</strong> the time of the referenced pick. A pick pick should be selected.</p></li>
<li><p><strong>Additional phase picks</strong> are shown on top of the data.</p></li>
<li><p><strong>Light blue line:</strong> the S pick which would be made based on the selected
parameters. The number next to ‘AIC’ indicates the SNR.</p></li>
<li><p><strong>Lower section:</strong> Parameters which can be adjusted.</p></li>
</ul>
<p>The initial parameters are read from the global binding configuration from the
selected stream. Change the parameters to find the optimum
values. Click on the <em>Update</em> button to apply them in the GUI.
In order to make use of the tested parameters their values must be configured in
the bindings parameter of <strong class="program">scautopick</strong> or the respective alias.</p>
<table class="docutils align-default" id="scanloc-debugger-parameters">
<colgroup>
<col style="width: 15.0%" />
<col style="width: 85.0%" />
</colgroup>
<thead>
<tr class="row-odd"><th class="head"><p>Parameter</p></th>
<th class="head"><p>Description</p></th>
</tr>
</thead>
<tbody>
<tr class="row-even"><td><p>N</p></td>
<td><p>Start of the noise window</p></td>
</tr>
<tr class="row-odd"><td><p>S0</p></td>
<td><p>Start of the AIC window</p></td>
</tr>
<tr class="row-even"><td><p>S1</p></td>
<td><p>End of the AIC window</p></td>
</tr>
<tr class="row-odd"><td><p>AIC0</p></td>
<td><p>Start of the data processing relative to the reference P pick.</p></td>
</tr>
<tr class="row-even"><td><p>AIC</p></td>
<td><p>S pick based on the current parameters with number indicating the SNR.</p></td>
</tr>
<tr class="row-odd"><td><p>AIC1</p></td>
<td><p>End of the data processing when meeting MinSNR and MinCnt.</p></td>
</tr>
<tr class="row-even"><td><p>Pick</p></td>
<td><p>Pick time at AIC.</p></td>
</tr>
</tbody>
</table>
</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="#">Advanced S-Phase Detector</a><ul>
<li><a class="reference internal" href="#overview">Overview</a></li>
<li><a class="reference internal" href="#picker-configuration">Picker configuration</a></li>
<li><a class="reference internal" href="#picker-tuning-debugger">Picker tuning: Debugger</a></li>
</ul>
</li>
</ul>
</div>
<div>
<h4>Previous topic</h4>
<p class="topless"><a href="locsat-tables.html"
title="previous chapter">Dense Travel-Time Tables</a></p>
</div>
<div role="note" aria-label="source link">
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="../_sources/base/sphase-detector.rst.txt"
rel="nofollow">Show Source</a></li>
</ul>
</div>
</div>
</div>
</div>
</div>
<div class="footer">
<div class="container">
<div class="content">
Release <b></b> version <b>2025.281#4efc2c878</b>
<div class="copyright">
&copy; Copyright <a href="https://www.gempa.de">2014, gempa GmbH.</a>
</div>
</div>
</div>
</div>
</body>
</html>