[installation] Change to nightly

This commit is contained in:
2025-10-30 12:04:59 +01:00
parent 2ff097f9d1
commit a31bc45cce
1441 changed files with 60368 additions and 56360 deletions

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>access &#8212; SeisComP Release documentation</title>
<title>access &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -177,7 +177,7 @@
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>bindings2cfg &#8212; SeisComP Release documentation</title>
<title>bindings2cfg &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -319,12 +319,14 @@ This option can be given more than once.</p>
<dt class="sig sig-object std" id="cmdoption-bindings2cfg-content-type">
<span class="sig-name descname"><span class="pre">--content-type</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-bindings2cfg-content-type" title="Permalink to this definition"></a></dt>
<dd><p>Overrides configuration parameter <a class="reference internal" href="global.html#confval-connection.contentType"><code class="xref std std-confval docutils literal notranslate"><span class="pre">connection.contentType</span></code></a>.</p>
<p>Default: <code class="docutils literal notranslate"><span class="pre">binary</span></code></p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-bindings2cfg-start-stop-msg">
<span class="sig-name descname"><span class="pre">--start-stop-msg</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-bindings2cfg-start-stop-msg" title="Permalink to this definition"></a></dt>
<dd><p>Set sending of a start and a stop message.</p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">0</span></code></p>
<p>Set sending of a start and a stop message.</p>
</dd></dl>
</section>
@ -427,7 +429,7 @@ and input database and an input config XML as reference.</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>diskmon &#8212; SeisComP Release documentation</title>
<title>diskmon &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -178,7 +178,7 @@ threshold is exceeded.</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>dlsv2inv &#8212; SeisComP Release documentation</title>
<title>dlsv2inv &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -92,10 +92,6 @@ which should contain the local datacenter where the information comes from.</p>
<p>While importing the attribute <a class="reference internal" href="global.html#confval-datacenterID"><code class="xref std std-confval docutils literal notranslate"><span class="pre">datacenterID</span></code></a> is read and written into
the archive attribute of all networks and stations available in the dataless.
The datacenterID can be overridden with the <code class="docutils literal notranslate"><span class="pre">--dcid</span></code> command-line option.</p>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>Conversion of inventory in <cite>SeisComP</cite> XML to dataless SEED is provided by <a class="reference internal" href="inv2dlsv.html#inv2dlsv"><span class="std std-ref">inv2dlsv</span></a>.</p>
</div>
</section>
<section id="examples">
<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this heading"></a></h2>
@ -375,7 +371,7 @@ ${archive}.</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>ew2sc &#8212; SeisComP Release documentation</title>
<title>ew2sc &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -396,12 +396,14 @@ This option can be given more than once.</p>
<dt class="sig sig-object std" id="cmdoption-ew2sc-content-type">
<span class="sig-name descname"><span class="pre">--content-type</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-ew2sc-content-type" title="Permalink to this definition"></a></dt>
<dd><p>Overrides configuration parameter <a class="reference internal" href="global.html#confval-connection.contentType"><code class="xref std std-confval docutils literal notranslate"><span class="pre">connection.contentType</span></code></a>.</p>
<p>Default: <code class="docutils literal notranslate"><span class="pre">binary</span></code></p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-ew2sc-start-stop-msg">
<span class="sig-name descname"><span class="pre">--start-stop-msg</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-ew2sc-start-stop-msg" title="Permalink to this definition"></a></dt>
<dd><p>Set sending of a start and a stop message.</p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">0</span></code></p>
<p>Set sending of a start and a stop message.</p>
</dd></dl>
</section>
@ -508,7 +510,7 @@ can be queried with &quot;--db-driver-list&quot;.</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>fdsnws &#8212; SeisComP Release documentation</title>
<title>fdsnws &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -77,12 +77,9 @@
<p><strong>Provide FDSN Web Services.</strong></p>
<section id="description">
<h2>Description<a class="headerlink" href="#description" title="Permalink to this heading"></a></h2>
<p>fdsnws is a server that provides event and station information by FDSN Web Services
(<span id="id2"><em>FDSNWS</em> [<a class="reference internal" href="../base/references.html#id110" title="FDSNWS. International Federation of Digital Seismograph Networks. URL: http://www.fdsn.org/webservices/.">8</a>]</span>)
from a SeisComP database and waveforms from a <a class="reference internal" href="global_recordstream.html#global-recordstream"><span class="std std-ref">RecordStream</span></a> source.
Also it may be configured to serve data
availability information as described in the IRIS DMC FDSNWS availability Web
Service Documentation (<span id="id3"><em>IRIS DMC</em> [<a class="reference internal" href="../base/references.html#id139" title="IRIS DMC. FDSNWS availability Web Service Documentation. URL: https://service.iris.edu/fdsnws/availability/1/.">12</a>]</span>).</p>
<p>fdsnws is a server that provides event, station and data availability
information by FDSN Web Services (<span id="id2"><em>FDSNWS</em> [<a class="reference internal" href="../base/references.html#id135" title="FDSNWS. International Federation of Digital Seismograph Networks. URL: http://www.fdsn.org/webservices/.">8</a>]</span>) from a SeisComP database and
waveforms from a <a class="reference internal" href="global_recordstream.html#global-recordstream"><span class="std std-ref">RecordStream</span></a> source.</p>
<div class="admonition caution">
<p class="admonition-title">Caution</p>
<p>If you expose the FDSN Web Service as a public service, make sure that
@ -121,7 +118,7 @@ into the database.</p>
</table>
<p>The available services can be reached from the fdsnws start page. The services
also provide an interactive URL builder constructing the request URL based on
user inputs. The FDSN specifications can be found on <span id="id4"><em>FDSNWS</em> [<a class="reference internal" href="../base/references.html#id110" title="FDSNWS. International Federation of Digital Seismograph Networks. URL: http://www.fdsn.org/webservices/.">8</a>]</span>.</p>
user inputs. The FDSN specifications can be found on <span id="id3"><em>FDSNWS</em> [<a class="reference internal" href="../base/references.html#id135" title="FDSNWS. International Federation of Digital Seismograph Networks. URL: http://www.fdsn.org/webservices/.">8</a>]</span>.</p>
<p><strong>URL</strong></p>
<ul class="simple">
<li><p><a class="reference external" href="http://localhost:8080/fdsnws">http://localhost:8080/fdsnws</a></p></li>
@ -220,8 +217,8 @@ information depth level is selectable</p></li>
<li><p>Optionally handles time-based conditional HTTP-GET requests as specified by
<a class="reference external" href="https://tools.ietf.org/html/rfc7232">RFC 7232</a>.</p></li>
</ul>
<section id="id5">
<h4>URL<a class="headerlink" href="#id5" title="Permalink to this heading"></a></h4>
<section id="id4">
<h4>URL<a class="headerlink" href="#id4" title="Permalink to this heading"></a></h4>
<ul class="simple">
<li><p><a class="reference external" href="http://localhost:8080/fdsnws/station/1/builder">http://localhost:8080/fdsnws/station/1/builder</a></p></li>
<li><p><a class="reference external" href="http://localhost:8080/fdsnws/station/1/query">http://localhost:8080/fdsnws/station/1/query</a></p></li>
@ -229,16 +226,16 @@ information depth level is selectable</p></li>
<li><p><a class="reference external" href="http://localhost:8080/fdsnws/station/1/application.wadl">http://localhost:8080/fdsnws/station/1/application.wadl</a></p></li>
</ul>
</section>
<section id="id6">
<h4>Example<a class="headerlink" href="#id6" title="Permalink to this heading"></a></h4>
<section id="id5">
<h4>Example<a class="headerlink" href="#id5" title="Permalink to this heading"></a></h4>
<ul>
<li><p>Request URL for querying the information for the GE network on response level:</p>
<p><a class="reference external" href="http://localhost:8080/fdsnws/station/1/query?net=GE&amp;cha=BH%3F&amp;level=response&amp;nodata=404">http://localhost:8080/fdsnws/station/1/query?net=GE&amp;cha=BH%3F&amp;level=response&amp;nodata=404</a></p>
</li>
</ul>
</section>
<section id="id7">
<h4>Feature Notes<a class="headerlink" href="#id7" title="Permalink to this heading"></a></h4>
<section id="id6">
<h4>Feature Notes<a class="headerlink" href="#id6" title="Permalink to this heading"></a></h4>
<ul class="simple">
<li><p>To enable FDSNXML or StationXML support load the plugin <code class="docutils literal notranslate"><span class="pre">fdsnxml</span></code>. The
plugin is loaded by default configuration.</p></li>
@ -271,8 +268,8 @@ would be much too expensive.</p></li>
<li><p>Request type: HTTP-GET</p></li>
<li><p>Events may be filtered e.g. by hypocenter, time and magnitude</p></li>
</ul>
<section id="id8">
<h4>URL<a class="headerlink" href="#id8" title="Permalink to this heading"></a></h4>
<section id="id7">
<h4>URL<a class="headerlink" href="#id7" title="Permalink to this heading"></a></h4>
<ul class="simple">
<li><p><a class="reference external" href="http://localhost:8080/fdsnws/event/1/builder">http://localhost:8080/fdsnws/event/1/builder</a></p></li>
<li><p><a class="reference external" href="http://localhost:8080/fdsnws/event/1/query">http://localhost:8080/fdsnws/event/1/query</a></p></li>
@ -282,8 +279,8 @@ would be much too expensive.</p></li>
<li><p><a class="reference external" href="http://localhost:8080/fdsnws/event/1/application.wadl">http://localhost:8080/fdsnws/event/1/application.wadl</a></p></li>
</ul>
</section>
<section id="id9">
<h4>Example<a class="headerlink" href="#id9" title="Permalink to this heading"></a></h4>
<section id="id8">
<h4>Example<a class="headerlink" href="#id8" title="Permalink to this heading"></a></h4>
<ul>
<li><p>Request URL for fetching the event parameters within 10 degrees around 50°N/11°E
starting on 18 April 2013:</p>
@ -291,8 +288,8 @@ starting on 18 April 2013:</p>
</li>
</ul>
</section>
<section id="id10">
<h4>Feature Notes<a class="headerlink" href="#id10" title="Permalink to this heading"></a></h4>
<section id="id9">
<h4>Feature Notes<a class="headerlink" href="#id9" title="Permalink to this heading"></a></h4>
<ul class="simple">
<li><p><cite>SeisComP</cite> does not distinguish between catalogs and contributors, but
supports agencyIDs. Hence, if specified, the value of the <code class="docutils literal notranslate"><span class="pre">contributor</span></code>
@ -334,15 +331,12 @@ with <code class="docutils literal notranslate"><span class="pre">includearrival
what time series data is available at the DMC archive. The availability information
can be created by <a class="reference internal" href="scardac.html#scardac"><span class="std std-ref">scardac</span></a> in the <cite>SeisComP</cite> database from where it is
fetched by fdsnws.</p>
<p>The availability service is no official standard yet. This implementation aims
to be compatible with the IRIS DMC availability FDSN Web Service
(<span id="id11"><em>IRIS DMC</em> [<a class="reference internal" href="../base/references.html#id139" title="IRIS DMC. FDSNWS availability Web Service Documentation. URL: https://service.iris.edu/fdsnws/availability/1/.">12</a>]</span>) implementation.</p>
<ul class="simple">
<li><p>request type: HTTP-GET, HTTP-POST</p></li>
<li><p>results may be filtered e.g. by channel code, time and quality</p></li>
</ul>
<section id="id12">
<h4>URL<a class="headerlink" href="#id12" title="Permalink to this heading"></a></h4>
<section id="id10">
<h4>URL<a class="headerlink" href="#id10" title="Permalink to this heading"></a></h4>
<ul class="simple">
<li><p><a class="reference external" href="http://localhost:8080/ext/availability/1/extent">http://localhost:8080/ext/availability/1/extent</a> - Produces list of available
time extents (earliest to latest) for selected channels (network, station,
@ -375,8 +369,8 @@ form your data time span requests</p></li>
<p>Use <a class="reference internal" href="scardac.html#scardac"><span class="std std-ref">scardac</span></a> for creating the availability information.</p>
</div>
</section>
<section id="id13">
<h4>Feature Notes<a class="headerlink" href="#id13" title="Permalink to this heading"></a></h4>
<section id="id11">
<h4>Feature Notes<a class="headerlink" href="#id11" title="Permalink to this heading"></a></h4>
<ul>
<li><p>The IRISWS availability implementation truncates the time spans of the returned
data extents and segments to the requested start and end times (if any). This
@ -602,15 +596,15 @@ station AAI (assuming that we are authorized to get data of this station).</p>
<li><p>The first step is to obtain the token from an authentication service.
Assuming that the token is saved in “token.asc”, credentials of the
temporary account can be requested using one of the following commands:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>sysop@host:~$<span class="w"> </span>wget<span class="w"> </span>--post-file<span class="w"> </span>token.asc<span class="w"> </span>https://geofon.gfz-potsdam.de/fdsnws/dataselect/1/auth<span class="w"> </span>-O<span class="w"> </span>cred.txt
sysop@host:~$<span class="w"> </span>curl<span class="w"> </span>--data-binary<span class="w"> </span>@token.asc<span class="w"> </span>https://geofon.gfz-potsdam.de/fdsnws/dataselect/1/auth<span class="w"> </span>-o<span class="w"> </span>cred.txt
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>sysop@host:~$<span class="w"> </span>wget<span class="w"> </span>--post-file<span class="w"> </span>token.asc<span class="w"> </span>https://geofon.gfz.de/fdsnws/dataselect/1/auth<span class="w"> </span>-O<span class="w"> </span>cred.txt
sysop@host:~$<span class="w"> </span>curl<span class="w"> </span>--data-binary<span class="w"> </span>@token.asc<span class="w"> </span>https://geofon.gfz.de/fdsnws/dataselect/1/auth<span class="w"> </span>-o<span class="w"> </span>cred.txt
</pre></div>
</div>
</li>
<li><p>The resulting file “cred.txt” contains username and password separated by
a colon, so one can conveniently use a shell expansion:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>sysop@host:~$<span class="w"> </span>wget<span class="w"> </span><span class="s2">&quot;http://`cat cred.txt`@geofon.gfz-potsdam.de/fdsnws/dataselect/1/queryauth?starttime=2015-12-15T16:00:00Z&amp;endtime=2015-12-15T16:10:00Z&amp;network=IA&amp;station=AAI&quot;</span><span class="w"> </span>-O<span class="w"> </span>data.mseed
sysop@host:~$<span class="w"> </span>curl<span class="w"> </span>--digest<span class="w"> </span><span class="s2">&quot;http://`cat cred.txt`@geofon.gfz-potsdam.de/fdsnws/dataselect/1/queryauth?starttime=2015-12-15T16:00:00Z&amp;endtime=2015-12-15T16:10:00Z&amp;network=IA&amp;station=AAI&quot;</span><span class="w"> </span>-o<span class="w"> </span>data.mseed
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>sysop@host:~$<span class="w"> </span>wget<span class="w"> </span><span class="s2">&quot;http://`cat cred.txt`@geofon.gfz.de/fdsnws/dataselect/1/queryauth?starttime=2015-12-15T16:00:00Z&amp;endtime=2015-12-15T16:10:00Z&amp;network=IA&amp;station=AAI&quot;</span><span class="w"> </span>-O<span class="w"> </span>data.mseed
sysop@host:~$<span class="w"> </span>curl<span class="w"> </span>--digest<span class="w"> </span><span class="s2">&quot;http://`cat cred.txt`@geofon.gfz.de/fdsnws/dataselect/1/queryauth?starttime=2015-12-15T16:00:00Z&amp;endtime=2015-12-15T16:10:00Z&amp;network=IA&amp;station=AAI&quot;</span><span class="w"> </span>-o<span class="w"> </span>data.mseed
</pre></div>
</div>
</li>
@ -704,7 +698,7 @@ requests per day.</p>
</section>
<section id="related-modules">
<span id="sec-fdsnws-related"></span><h2>Related Modules<a class="headerlink" href="#related-modules" title="Permalink to this heading"></a></h2>
<p><a class="reference internal" href="../base/glossary.html#term-GEOFON"><span class="xref std std-term">GEOFON</span></a> maintains scripts for FDSNWS <span id="id14">[<a class="reference internal" href="../base/references.html#id115" title="FDSNWS scripts. SeisComP. URL: https://www.seiscomp.de/seiscomp3/doc/applications/fdsnws_scripts.html.">7</a>]</span>:</p>
<p><a class="reference internal" href="../base/glossary.html#term-GEOFON"><span class="xref std std-term">GEOFON</span></a> maintains scripts for FDSNWS <span id="id12">[<a class="reference internal" href="../base/references.html#id140" title="FDSNWS scripts. SeisComP. URL: https://www.seiscomp.de/seiscomp3/doc/applications/fdsnws_scripts.html.">7</a>]</span>:</p>
<ul class="simple">
<li><p>The <strong class="program">fdsnws_fetch</strong> client is a convenient tool for requesting
waveforms from a FDSN web service hosted by <a class="reference internal" href="../base/glossary.html#term-EIDA"><span class="xref std std-term">EIDA</span></a> nodes.</p></li>
@ -715,8 +709,8 @@ from a FDSN web service hosted by <a class="reference internal" href="../base/gl
</section>
<section id="public-fdsn-web-servers">
<h2>Public FDSN Web Servers<a class="headerlink" href="#public-fdsn-web-servers" title="Permalink to this heading"></a></h2>
<p>IRIS maintains a list of data centers (<span id="id15"><em>FDSN data centers</em> [<a class="reference internal" href="../base/references.html#id112" title="FDSN data centers. International Federation of Digital Seismograph Networks. URL: https://www.fdsn.org/webservices/datacenters/.">6</a>]</span>)
supporting FDSN Web Services (<span id="id16"><em>FDSNWS</em> [<a class="reference internal" href="../base/references.html#id110" title="FDSNWS. International Federation of Digital Seismograph Networks. URL: http://www.fdsn.org/webservices/.">8</a>]</span>).</p>
<p>IRIS maintains a list of data centers (<span id="id13"><em>FDSN data centers</em> [<a class="reference internal" href="../base/references.html#id137" title="FDSN data centers. International Federation of Digital Seismograph Networks. URL: https://www.fdsn.org/webservices/datacenters/.">6</a>]</span>)
supporting FDSN Web Services (<span id="id14"><em>FDSNWS</em> [<a class="reference internal" href="../base/references.html#id135" title="FDSNWS. International Federation of Digital Seismograph Networks. URL: http://www.fdsn.org/webservices/.">8</a>]</span>).</p>
</section>
<section id="module-configuration">
<span id="fdsnws-configuration"></span><h2>Module Configuration<a class="headerlink" href="#module-configuration" title="Permalink to this heading"></a></h2>
@ -772,10 +766,10 @@ fdsnws-event to limit main memory consumption.</p>
<dd><p>Type: <em>int</em></p>
<p>Unit: <em>s</em></p>
<p>Restrict end time of requests to current time - realtimeGap
seconds. Negative values allowed. Used in fdsnws-dataselect.
WARNING: If this value is unset and a realtime recordsource
(e.g. slink) is used, requests may block if end time in future
is requested.</p>
seconds. Negative values are allowed. Used in fdsnws-dataselect.</p>
<p>WARNING: If this value is unset and a real-time RecordStream
(e.g. slink) is used, requests may block if end times in the
future are requested.</p>
</dd></dl>
<dl class="std confval">
@ -796,7 +790,7 @@ connection with a large request.</p>
<p>Set the number of bytes to buffer for each chunk of waveform data
served to the client. The lower the buffer the higher the overhead
of Python Twisted. The higher the buffer the higher the memory
usage per request. 100kB seems to be a good trade-off.</p>
usage per request. 100 kB seems to be a good trade-off.</p>
</dd></dl>
<dl class="std confval">
@ -814,14 +808,14 @@ specification, the passwords have to be stored in plain text.</p>
<dt class="sig sig-object std" id="confval-accessLog">
<span class="sig-name descname"><span class="pre">accessLog</span></span><a class="headerlink" href="#confval-accessLog" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>Path to access log file. If unset no access log is created.</p>
<p>Path to access log file. If unset, no access log is created.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-requestLog">
<span class="sig-name descname"><span class="pre">requestLog</span></span><a class="headerlink" href="#confval-requestLog" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>Path to request log file. If unset no request log is created.</p>
<p>Path to request log file. If unset, no request log is created.</p>
</dd></dl>
<dl class="std confval">
@ -839,8 +833,9 @@ specification, the passwords have to be stored in plain text.</p>
<p>List of domain names Cross-Origin Resource Sharing (CORS)
request may originate from. A value of * allows any web page
to embed your service. An empty value will switch of CORS
requests entirely. An example of multiple domains might be:
<a class="reference external" href="https://test.domain.de">https://test.domain.de</a>, <a class="reference external" href="https://production.domain.de">https://production.domain.de</a>.</p>
requests entirely.</p>
<p>Example of multiple domains:</p>
<p><a class="reference external" href="https://test.domain.de">https://test.domain.de</a>, <a class="reference external" href="https://production.domain.de">https://production.domain.de</a>.</p>
</dd></dl>
<dl class="std confval">
@ -891,6 +886,7 @@ creationInfo element.</p>
<dt class="sig sig-object std" id="confval-evaluationMode">
<span class="sig-name descname"><span class="pre">evaluationMode</span></span><a class="headerlink" href="#confval-evaluationMode" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>Values: <code class="docutils literal notranslate"><span class="pre">,automatic,manual</span></code></p>
<p>If set, the event service will only return events having a
preferred origin with a matching evaluationMode property.</p>
</dd></dl>
@ -899,6 +895,7 @@ preferred origin with a matching evaluationMode property.</p>
<dt class="sig sig-object std" id="confval-eventFormats">
<span class="sig-name descname"><span class="pre">eventFormats</span></span><a class="headerlink" href="#confval-eventFormats" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>list:string</em></p>
<p>Values: <code class="docutils literal notranslate"><span class="pre">csv,qml,qml-rt,sc3ml,text,xml</span></code></p>
<p>List of enabled event formats. If unspecified, all supported
formats are enabled.</p>
</dd></dl>
@ -939,14 +936,14 @@ standard FDSNWS extension served under fdsnws/ext/availability.</p>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-stationFilter">
<span class="sig-name descname"><span class="pre">stationFilter</span></span><a class="headerlink" href="#confval-stationFilter" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<dd><p>Type: <em>file</em></p>
<p>Path to station inventory filter file.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-dataSelectFilter">
<span class="sig-name descname"><span class="pre">dataSelectFilter</span></span><a class="headerlink" href="#confval-dataSelectFilter" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<dd><p>Type: <em>file</em></p>
<p>Path to dataselect inventory filter file.</p>
</dd></dl>
@ -1078,6 +1075,54 @@ extent service.</p>
<p>List of revoked token IDs.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-jwt.enable">
<span class="sig-name descname"><span class="pre">jwt.enable</span></span><a class="headerlink" href="#confval-jwt.enable" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">false</span></code></p>
<p>Type: <em>boolean</em></p>
<p>Enable JWT extension.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-jwt.issuers">
<span class="sig-name descname"><span class="pre">jwt.issuers</span></span><a class="headerlink" href="#confval-jwt.issuers" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">https://geofon.gfz.de/eas2,https://login.earthscope.org/</span></code></p>
<p>Type: <em>list:string</em></p>
<p>List of issuer URLs.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-jwt.audience">
<span class="sig-name descname"><span class="pre">jwt.audience</span></span><a class="headerlink" href="#confval-jwt.audience" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">eas,fdsn</span></code></p>
<p>Type: <em>list:string</em></p>
<p>List of valid audience.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-jwt.algorithms">
<span class="sig-name descname"><span class="pre">jwt.algorithms</span></span><a class="headerlink" href="#confval-jwt.algorithms" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">RS256</span></code></p>
<p>Type: <em>list:string</em></p>
<p>List of allowed algorithms.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-jwt.updateMinSeconds">
<span class="sig-name descname"><span class="pre">jwt.updateMinSeconds</span></span><a class="headerlink" href="#confval-jwt.updateMinSeconds" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">300</span></code></p>
<p>Type: <em>int</em></p>
<p>Minimum time to wait between requesting updated keys from a key server.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-jwt.updateMaxSeconds">
<span class="sig-name descname"><span class="pre">jwt.updateMaxSeconds</span></span><a class="headerlink" href="#confval-jwt.updateMaxSeconds" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">86400</span></code></p>
<p>Type: <em>int</em></p>
<p>Maximum time to cache received keys.</p>
</dd></dl>
</section>
<section id="command-line-options">
<h2>Command-Line Options<a class="headerlink" href="#command-line-options" title="Permalink to this heading"></a></h2>
@ -1256,12 +1301,12 @@ can be queried with &quot;--db-driver-list&quot;.</p>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-fdsnws-I">
<span id="cmdoption-fdsnws-record-url"></span><span class="sig-name descname"><span class="pre">-I</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">--record-url</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-fdsnws-I" title="Permalink to this definition"></a></dt>
<dd><p>The recordstream source URL, format:
<dd><p>The RecordStream source URL. Format:
[<a class="reference external" href="service://">service://</a>]location[#type].
&quot;service&quot; is the name of the recordstream driver
&quot;service&quot; is the name of the RecordStream driver
which can be queried with &quot;--record-driver-list&quot;.
If &quot;service&quot; is not given, &quot;<a class="reference external" href="file://">file://</a>&quot; is
used.</p>
used and simply the name of a miniSEED file can be given.</p>
</dd></dl>
<dl class="std option">
@ -1311,21 +1356,21 @@ used.</p>
</ul>
</li>
<li><a class="reference internal" href="#station">Station</a><ul>
<li><a class="reference internal" href="#id5">URL</a></li>
<li><a class="reference internal" href="#id6">Example</a></li>
<li><a class="reference internal" href="#id7">Feature Notes</a></li>
<li><a class="reference internal" href="#id4">URL</a></li>
<li><a class="reference internal" href="#id5">Example</a></li>
<li><a class="reference internal" href="#id6">Feature Notes</a></li>
</ul>
</li>
<li><a class="reference internal" href="#event">Event</a><ul>
<li><a class="reference internal" href="#id8">URL</a></li>
<li><a class="reference internal" href="#id9">Example</a></li>
<li><a class="reference internal" href="#id10">Feature Notes</a></li>
<li><a class="reference internal" href="#id7">URL</a></li>
<li><a class="reference internal" href="#id8">Example</a></li>
<li><a class="reference internal" href="#id9">Feature Notes</a></li>
</ul>
</li>
<li><a class="reference internal" href="#data-availability">Data Availability</a><ul>
<li><a class="reference internal" href="#id12">URL</a></li>
<li><a class="reference internal" href="#id10">URL</a></li>
<li><a class="reference internal" href="#examples">Examples</a></li>
<li><a class="reference internal" href="#id13">Feature Notes</a></li>
<li><a class="reference internal" href="#id11">Feature Notes</a></li>
</ul>
</li>
</ul>
@ -1384,7 +1429,7 @@ used.</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>fdsnxml2inv &#8212; SeisComP Release documentation</title>
<title>fdsnxml2inv &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -328,7 +328,7 @@ when converting from StationXML.</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

File diff suppressed because it is too large Load Diff

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>FixedHypocenter &#8212; SeisComP Release documentation</title>
<title>FixedHypocenter &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -77,7 +77,7 @@
<p>Locator for re-computing source time with fixed hypocenter</p>
<section id="description">
<h2>Description<a class="headerlink" href="#description" title="Permalink to this heading"></a></h2>
<p>Mining-related events are useful as ground truth events (<span id="id1">Bondár and McLaughlin [<a class="reference internal" href="../base/references.html#id12" title="I. Bondár and K.L. McLaughlin. A new ground truth data set for seismic studies. Seismol. Res. Lett., 3:465 - 472, 2009. doi:10.1785/gssrl.80.3.465.">34</a>]</span>)
<p>Mining-related events are useful as ground truth events (<span id="id1">Bondár and McLaughlin [<a class="reference internal" href="../base/references.html#id19" title="I. Bondár and K.L. McLaughlin. A new ground truth data set for seismic studies. Seismol. Res. Lett., 3:465 - 472, 2009. doi:10.1785/gssrl.80.3.465.">42</a>]</span>)
because the epicentre and depth can be constrained by physical inspection.
Unless a local seismograph network with accurate timing also locates the event,
and that information is available, the origin time must be estimated in order
@ -93,29 +93,29 @@ origin time determination.</p>
the practise of the Comprehensive Test Ban Treaty Organization (CTBTO).</p></li>
<li><p>Adaptation of a procedure which is compatible with the other locators supported by <cite>SeisComP</cite>.</p></li>
<li><p>Adaptation of a procedure which can reproduce results of legacy locators currently
in use, such as GENLOC <span id="id2">Pavlis <em>et al.</em> [<a class="reference internal" href="../base/references.html#id60" title="G.L. Pavlis, F. Vernon, D. Harvey, and D. Quinlan. Lsqr: an algorithm for sparse linear equations and sparse least squares. ACM Transactions on Mathematical Software, 1:43 - 71, 1982. doi:10.1145/355984.355989.">55</a>]</span> and GRL, a
in use, such as GENLOC <span id="id2">Pavlis <em>et al.</em> [<a class="reference internal" href="../base/references.html#id78" title="G.L. Pavlis, F. Vernon, D. Harvey, and D. Quinlan. Lsqr: an algorithm for sparse linear equations and sparse least squares. ACM Transactions on Mathematical Software, 1:43 - 71, 1982. doi:10.1145/355984.355989.">64</a>]</span> and GRL, a
grid-based locator developed at the Canadian Hazards Information Service (CHIS).</p></li>
</ul>
<p>The implementation of this locator by <a class="reference internal" href="../base/glossary.html#term-gempa-GmbH"><span class="xref std std-term">gempa GmbH</span></a> was initiated and has received
initial funding from <span id="id3"><em>Natural Resources Canada (NRCAN), Earthquakes Canada</em> [<a class="reference internal" href="../base/references.html#id173" title="Natural Resources Canada (NRCAN), Earthquakes Canada. URL: https://earthquakescanada.nrcan.gc.ca/index-en.php.">17</a>]</span>.</p>
initial funding from <span id="id3"><em>Natural Resources Canada (NRCAN), Earthquakes Canada</em> [<a class="reference internal" href="../base/references.html#id202" title="Natural Resources Canada (NRCAN), Earthquakes Canada. URL: https://earthquakescanada.nrcan.gc.ca/index-en.php.">18</a>]</span>.</p>
</section>
<section id="methodology">
<h2>Methodology<a class="headerlink" href="#methodology" title="Permalink to this heading"></a></h2>
<p>Given the measured arrival times <img class="math" src="../_images/math/ef0cc8a9abcd91d4c81e277fda15f02f61283b8a.png" alt="t_i^k"/> of phase <img class="math" src="../_images/math/9630132210b904754c9ab272b61cb527d12263ca.png" alt="k"/> at
station <img class="math" src="../_images/math/5aa339d4daf45a810dda332e3c80a0698e526e04.png" alt="i"/>, most methods of earthquake hypocentre location involve
<p>Given the measured arrival times <img class="math" src="../_images/math/ef0cc8a9abcd91d4c81e277fda15f02f61283b8a.svg" alt="t_i^k"/> of phase <img class="math" src="../_images/math/9630132210b904754c9ab272b61cb527d12263ca.svg" alt="k"/> at
station <img class="math" src="../_images/math/5aa339d4daf45a810dda332e3c80a0698e526e04.svg" alt="i"/>, most methods of earthquake hypocentre location involve
minimization of the weighted squared sum of the residuals. That is,
minimization of:</p>
<div class="math">
<p><img src="../_images/math/66bfccc625b603ecc69ebbaf5e79849a6f90985a.png" alt="|r_w|^2 = \sum_{i=1}^N {w_i^2 [ t_i^k - \tau - T_{model}^k(r_i,x) ]^2}"/></p>
<p><img src="../_images/math/66bfccc625b603ecc69ebbaf5e79849a6f90985a.svg" alt="|r_w|^2 = \sum_{i=1}^N {w_i^2 [ t_i^k - \tau - T_{model}^k(r_i,x) ]^2}"/></p>
</div><p>The residuals are computed by subtracting the expected arrival times
<img class="math" src="../_images/math/4cd887dff87ad1c4fe54e94c441379b895433dc5.png" alt="\tau - T_{model}^k(r_i,x)"/> based on a velocity model applied at the
<img class="math" src="../_images/math/4cd887dff87ad1c4fe54e94c441379b895433dc5.svg" alt="\tau - T_{model}^k(r_i,x)"/> based on a velocity model applied at the
coordinates of each station
<img class="math" src="../_images/math/dbc4c429b48dd94e41ee866e1edbf0abededae3a.png" alt="r_i"/>.</p>
<img class="math" src="../_images/math/dbc4c429b48dd94e41ee866e1edbf0abededae3a.svg" alt="r_i"/>.</p>
<p>Typically the weights can be a combination of the inverse of the
estimated pick uncertainty <img class="math" src="../_images/math/68d8fad26c73ee49f100be287592043b3d020379.png" alt="1/{\sigma}_i"/>, a distance term
<img class="math" src="../_images/math/1bdf84b56ea19c568b70e6dc45392b954d63a0ea.png" alt="d^k(\Delta)"/> and/or a residual weight term <img class="math" src="../_images/math/cf90d710bc5e654f04f2197992b5658a393a8c93.png" alt="p(r_i)"/>.
estimated pick uncertainty <img class="math" src="../_images/math/68d8fad26c73ee49f100be287592043b3d020379.svg" alt="1/{\sigma}_i"/>, a distance term
<img class="math" src="../_images/math/1bdf84b56ea19c568b70e6dc45392b954d63a0ea.svg" alt="d^k(\Delta)"/> and/or a residual weight term <img class="math" src="../_images/math/cf90d710bc5e654f04f2197992b5658a393a8c93.svg" alt="p(r_i)"/>.
Alternative weighting schemes can be applied but in this
implementation we weight by pick uncertainty alone: <img class="math" src="../_images/math/eb6982d524ed71f7530ce3eb31b4814c1aef31b1.png" alt="w_i=\frac{1}{{\sigma}_i}"/>.</p>
implementation we weight by pick uncertainty alone: <img class="math" src="../_images/math/eb6982d524ed71f7530ce3eb31b4814c1aef31b1.svg" alt="w_i=\frac{1}{{\sigma}_i}"/>.</p>
<p>In the general case, the model is a nonlinear function of its inputs, and there
is no analytic solution for the origin time and hypocenter that minimize the
norm. Typically, the solution is found iteratively, based on an initial guess
@ -125,85 +125,85 @@ When the hypocenter is in fact accurately constrained, the modeled travel time
is a constant, so we can project each phase arrival back to an equivalent origin
time</p>
<div class="math">
<p><img src="../_images/math/e07cf5ca46edb86938c9b742583b78cf5dfd5a2c.png" alt="\tau_i^k = t_i^k - T_{model}^k (r_i,x)"/></p>
<p><img src="../_images/math/e07cf5ca46edb86938c9b742583b78cf5dfd5a2c.svg" alt="\tau_i^k = t_i^k - T_{model}^k (r_i,x)"/></p>
</div><p>so that we only have to find which minimizes:</p>
<div class="math">
<p><img src="../_images/math/ce91df5771b45d3d22d0246721cb9eda678dc1ea.png" alt="|r_w|^2 = \sum_{i=1}^{N}w_i^2 [\tau_i^k - \tau]^2"/></p>
<p><img src="../_images/math/ce91df5771b45d3d22d0246721cb9eda678dc1ea.svg" alt="|r_w|^2 = \sum_{i=1}^{N}w_i^2 [\tau_i^k - \tau]^2"/></p>
</div><p>The residuals are minimized by:</p>
<div class="math">
<p><img src="../_images/math/a3c64e2d4f039151334ad193c4df506d7c5a4d27.png" alt="\tau = \frac{\sum_{i=1}^{N}w_i^2 (\tau_i^k)^2}{\sum_{i=1}^{N}w_i^2}."/></p>
<p><img src="../_images/math/a3c64e2d4f039151334ad193c4df506d7c5a4d27.svg" alt="\tau = \frac{\sum_{i=1}^{N}w_i^2 (\tau_i^k)^2}{\sum_{i=1}^{N}w_i^2}."/></p>
</div><p>Thus, the origin time is simply the weighted mean of the equivalent origin
times, according to the velocity model, associated with the arrivals.</p>
<p>The standard error of this estimate is:</p>
<div class="math">
<p><img src="../_images/math/450e7d546e262c19d94b8fdfc9f5d971d36f7a1b.png" alt="\sigma = \sqrt{\frac{\sum_{i=1}^{N}w_i^2 [\tau_i^k - \tau]^2}{\sum_{i=1}^{N}w_i^2}}."/></p>
<p><img src="../_images/math/450e7d546e262c19d94b8fdfc9f5d971d36f7a1b.svg" alt="\sigma = \sqrt{\frac{\sum_{i=1}^{N}w_i^2 [\tau_i^k - \tau]^2}{\sum_{i=1}^{N}w_i^2}}."/></p>
</div><p>The methodology for estimating error intervals and ellipses recommended for
standard processing at the CTBTO (<span id="id4">Lee and Lahr [<a class="reference internal" href="../base/references.html#id51" title="W.H. Lee and J.C. Lahr. Hypo71 (revised): a computer program for determining local earthquake hypocentral parameters, magnitude, and first motion pattern of local earthquakes. US Geol. Survey Open-file Report 75-311, 1975. URL: https://pubs.er.usgs.gov/publication/ofr75311, doi:10.3133/ofr75311.">51</a>]</span>) is that of
<span id="id5">Jordan and Sverdrup [<a class="reference internal" href="../base/references.html#id41" title="T.H. Jordan and K.A. Sverdrup. Teleseismic location techniques and their application to earthquake clusters in the south-central pacific. Bull. Seismol. Soc. Am., 4:1105 1130, 1981. doi:10.1785/BSSA0710041105.">47</a>]</span> and is implemented
in LOCSAT (<span id="id6">Bratt and Bache [<a class="reference internal" href="../base/references.html#id20" title="S.R. Bratt and T.C. Bache. Locating events with a sparse network of regional arrays. Bull. Seismol. Soc. Am., 78(2):780 - 798, 1988. URL: https://pubs.geoscienceworld.org/ssa/bssa/article-pdf/78/2/780/5334120/bssa0780020780.pdf, doi:10.1785/BSSA0780020780.">41</a>]</span>).
Uncertainty is represented by a set of points <img class="math" src="../_images/math/c24babb8b2b84f2c211a040b48c4e2e04bb74871.png" alt="x_e"/> around the final estimate
<img class="math" src="../_images/math/4d932942be8cf79d3cda089d58de1a45ca6f8597.png" alt="x_f"/> satisfying:</p>
standard processing at the CTBTO (<span id="id4">Lee and Lahr [<a class="reference internal" href="../base/references.html#id69" title="W.H. Lee and J.C. Lahr. Hypo71 (revised): a computer program for determining local earthquake hypocentral parameters, magnitude, and first motion pattern of local earthquakes. US Geol. Survey Open-file Report 75-311, 1975. URL: https://pubs.er.usgs.gov/publication/ofr75311, doi:10.3133/ofr75311.">59</a>]</span>) is that of
<span id="id5">Jordan and Sverdrup [<a class="reference internal" href="../base/references.html#id56" title="T.H. Jordan and K.A. Sverdrup. Teleseismic location techniques and their application to earthquake clusters in the south-central pacific. Bull. Seismol. Soc. Am., 4:1105 1130, 1981. doi:10.1785/BSSA0710041105.">55</a>]</span> and is implemented
in LOCSAT (<span id="id6">Bratt and Bache [<a class="reference internal" href="../base/references.html#id31" title="S.R. Bratt and T.C. Bache. Locating events with a sparse network of regional arrays. Bull. Seismol. Soc. Am., 78(2):780 - 798, 1988. URL: https://pubs.geoscienceworld.org/ssa/bssa/article-pdf/78/2/780/5334120/bssa0780020780.pdf, doi:10.1785/BSSA0780020780.">49</a>]</span>).
Uncertainty is represented by a set of points <img class="math" src="../_images/math/c24babb8b2b84f2c211a040b48c4e2e04bb74871.svg" alt="x_e"/> around the final estimate
<img class="math" src="../_images/math/4d932942be8cf79d3cda089d58de1a45ca6f8597.svg" alt="x_f"/> satisfying:</p>
<div class="math">
<p><img src="../_images/math/b5359fb7461e8422b3d0ea043241d3902ed8c878.png" alt="\kappa_p^2 &amp;= (x_e - x_f)^TC_m(x_e-x_f), \\
<p><img src="../_images/math/b5359fb7461e8422b3d0ea043241d3902ed8c878.svg" alt="\kappa_p^2 &amp;= (x_e - x_f)^TC_m(x_e-x_f), \\
\kappa_p^2 &amp;= Ms^2F_p(M,K+N-M), \\
s^2 &amp;= \frac{Ks_K^2+|r_w|^2}{K+N-M}"/></p>
</div><p>where:</p>
<ul>
<li><p><img class="math" src="../_images/math/4577806854ed7741af5ad0aa1abe2909567a3083.png" alt="C_m"/>: Covariance matrix, corresponding to the final hypocentre estimate <img class="math" src="../_images/math/4d932942be8cf79d3cda089d58de1a45ca6f8597.png" alt="x_f"/>.</p></li>
<li><p><img class="math" src="../_images/math/8ab4b82ece5a67cb801cf339bca8ff343a570c2e.png" alt="s^2"/>: Ratio of actual to assumed.</p></li>
<li><p><img class="math" src="../_images/math/2255befd84ee2fcea10694752b43e60d80a4f992.png" alt="\kappa_p^2"/>: The “confidence coefficient” at probability <img class="math" src="../_images/math/27dc86f9f1b1c3435b2403a869b5870c582facea.png" alt="\rho"/>.</p></li>
<li><p><img class="math" src="../_images/math/86991529ca92ae0a8532508be15f15400052d4a4.png" alt="F_p(m,n)"/>: Fisher-Snedecor quantile function (inverse cumulative F-distribution)
<li><p><img class="math" src="../_images/math/4577806854ed7741af5ad0aa1abe2909567a3083.svg" alt="C_m"/>: Covariance matrix, corresponding to the final hypocentre estimate <img class="math" src="../_images/math/4d932942be8cf79d3cda089d58de1a45ca6f8597.svg" alt="x_f"/>.</p></li>
<li><p><img class="math" src="../_images/math/8ab4b82ece5a67cb801cf339bca8ff343a570c2e.svg" alt="s^2"/>: Ratio of actual to assumed.</p></li>
<li><p><img class="math" src="../_images/math/2255befd84ee2fcea10694752b43e60d80a4f992.svg" alt="\kappa_p^2"/>: The “confidence coefficient” at probability <img class="math" src="../_images/math/27dc86f9f1b1c3435b2403a869b5870c582facea.svg" alt="\rho"/>.</p></li>
<li><p><img class="math" src="../_images/math/86991529ca92ae0a8532508be15f15400052d4a4.svg" alt="F_p(m,n)"/>: Fisher-Snedecor quantile function (inverse cumulative F-distribution)
for and degrees of freedom of numerator and denominator sum of squares,
respectively, and probability.</p></li>
<li><p><img class="math" src="../_images/math/141bbefb74014fc5e43499901bf78607ae335583.png" alt="p"/>: Confidence level: the desired probability that the true epicentre should
<li><p><img class="math" src="../_images/math/141bbefb74014fc5e43499901bf78607ae335583.svg" alt="p"/>: Confidence level: the desired probability that the true epicentre should
fall within the uncertainty bounds.</p></li>
<li><p><img class="math" src="../_images/math/3bfb3a64189a14b2704f4610827762d5e3145114.png" alt="N"/>: Sum of all arrival time, azimuth or slowness estimates. Here, only
<li><p><img class="math" src="../_images/math/3bfb3a64189a14b2704f4610827762d5e3145114.svg" alt="N"/>: Sum of all arrival time, azimuth or slowness estimates. Here, only
arrival times are considered for inversion.</p></li>
<li><p><img class="math" src="../_images/math/4abba779877abb276b98ccb2b4ba9bf2e41947ab.png" alt="M"/>: Number of fitted parameters:</p>
<li><p><img class="math" src="../_images/math/4abba779877abb276b98ccb2b4ba9bf2e41947ab.svg" alt="M"/>: Number of fitted parameters:</p>
<ul class="simple">
<li><p>3: error ellipsoid</p></li>
<li><p>2: error ellipse</p></li>
<li><p>1: depth or time error bounds.</p></li>
</ul>
<p>Here, <img class="math" src="../_images/math/dabb61ecc4da8df35c00e765a39fd383714b573a.png" alt="M = 1"/> as we only invert for the time.</p>
<p>Here, <img class="math" src="../_images/math/dabb61ecc4da8df35c00e765a39fd383714b573a.svg" alt="M = 1"/> as we only invert for the time.</p>
</li>
<li><p><img class="math" src="../_images/math/8caebcef0e5d5769000618e5116d6051c25bd98e.png" alt="s_K^2"/>: A prior estimate of the ratio of actual to assumed data variances; typically set to 1.</p></li>
<li><p><img class="math" src="../_images/math/52ddc0cde6d632f631533173562fe3ca375b1f32.png" alt="K"/>: Number of degrees of freedom in prior estimate <img class="math" src="../_images/math/8caebcef0e5d5769000618e5116d6051c25bd98e.png" alt="s_K^2"/>.
<img class="math" src="../_images/math/52ddc0cde6d632f631533173562fe3ca375b1f32.png" alt="K"/> can be configured by <a class="reference internal" href="#confval-FixedHypocenter.degreesOfFreedom"><code class="xref std std-confval docutils literal notranslate"><span class="pre">FixedHypocenter.degreesOfFreedom</span></code></a>.</p></li>
<li><p><img class="math" src="../_images/math/4fa53fbce202dca5a7572c6eb0dd0b33bd9e601b.png" alt="r_w"/>: Vector of weighted residuals.</p></li>
<li><p><img class="math" src="../_images/math/8caebcef0e5d5769000618e5116d6051c25bd98e.svg" alt="s_K^2"/>: A prior estimate of the ratio of actual to assumed data variances; typically set to 1.</p></li>
<li><p><img class="math" src="../_images/math/52ddc0cde6d632f631533173562fe3ca375b1f32.svg" alt="K"/>: Number of degrees of freedom in prior estimate <img class="math" src="../_images/math/8caebcef0e5d5769000618e5116d6051c25bd98e.svg" alt="s_K^2"/>.
<img class="math" src="../_images/math/52ddc0cde6d632f631533173562fe3ca375b1f32.svg" alt="K"/> can be configured by <a class="reference internal" href="#confval-FixedHypocenter.degreesOfFreedom"><code class="xref std std-confval docutils literal notranslate"><span class="pre">FixedHypocenter.degreesOfFreedom</span></code></a>.</p></li>
<li><p><img class="math" src="../_images/math/4fa53fbce202dca5a7572c6eb0dd0b33bd9e601b.svg" alt="r_w"/>: Vector of weighted residuals.</p></li>
</ul>
<p>Although this formulation is complex it is useful it because allows the analyst to
balance a priori and a posteriori estimates of the ratio of actual to assumed
data variances.</p>
<p>The covariance matrix in the general case is computed from the weighted sensitivity
matrix <img class="math" src="../_images/math/93b581f18e6ddf1ae1ab7475c44b41837e648994.png" alt="A_w"/>, the row-weighted matrix of partial derivatives of arrival
matrix <img class="math" src="../_images/math/93b581f18e6ddf1ae1ab7475c44b41837e648994.svg" alt="A_w"/>, the row-weighted matrix of partial derivatives of arrival
time with respect to the solution coordinates.</p>
<div class="math">
<p><img src="../_images/math/746b9634c2f299dd2005c85460e58fae6d08a49e.png" alt="C_m = A^T_wA_w"/></p>
<p><img src="../_images/math/746b9634c2f299dd2005c85460e58fae6d08a49e.svg" alt="C_m = A^T_wA_w"/></p>
</div><p>However, when origin time is the only coordinate, the partial derivatives with
respect to origin time are unity, the weighted sensitivity matrix is simply a
row vector of weights, and the time-time covariance
<img class="math" src="../_images/math/95c69b0bc6dae384ad6ff06f0ec8ecaaf23987e4.png" alt="c_{tt}"/> is simply the sum of the squares of these weights.</p>
<img class="math" src="../_images/math/95c69b0bc6dae384ad6ff06f0ec8ecaaf23987e4.svg" alt="c_{tt}"/> is simply the sum of the squares of these weights.</p>
<div class="math">
<p><img src="../_images/math/3a34284a39272ffe88e206a0c9e216e716d08a39.png" alt="c_{tt} = \sum_{i=1}^{N}w_i^2"/></p>
<p><img src="../_images/math/3a34284a39272ffe88e206a0c9e216e716d08a39.svg" alt="c_{tt} = \sum_{i=1}^{N}w_i^2"/></p>
</div><p>It is recommended that fixed-hypocentre origin time confidence intervals be
estimated using the method of <span id="id7">Jordan and Sverdrup [<a class="reference internal" href="../base/references.html#id41" title="T.H. Jordan and K.A. Sverdrup. Teleseismic location techniques and their application to earthquake clusters in the south-central pacific. Bull. Seismol. Soc. Am., 4:1105 1130, 1981. doi:10.1785/BSSA0710041105.">47</a>]</span> for error ellipsoids,
estimated using the method of <span id="id7">Jordan and Sverdrup [<a class="reference internal" href="../base/references.html#id56" title="T.H. Jordan and K.A. Sverdrup. Teleseismic location techniques and their application to earthquake clusters in the south-central pacific. Bull. Seismol. Soc. Am., 4:1105 1130, 1981. doi:10.1785/BSSA0710041105.">55</a>]</span> for error ellipsoids,
that is, that the time error bounds be represented using</p>
<div class="math">
<p><img src="../_images/math/6d03a1b7af5b2b4b70c5442100e5e890ecc841ae.png" alt="\Delta t_p &amp;= \sqrt{ \frac{\kappa_p^2}{c_{tt}} } \\
<p><img src="../_images/math/6d03a1b7af5b2b4b70c5442100e5e890ecc841ae.svg" alt="\Delta t_p &amp;= \sqrt{ \frac{\kappa_p^2}{c_{tt}} } \\
&amp;= \sqrt{ \frac{F_p(1,K+N-1)}{K+N-1} \frac{Ks_K^2 + \sum_{i=1}^{N}w_i^2 [\tau_i^k-\tau]^2}{\sum_{i=1}^{N}w_i^2}}."/></p>
</div><p>In addition to recording arrival weights and residuals, distances and azimuths,
and other details of origin quality, the details of a ground-truth-level (GT1)
fixed-hypocentre origin time estimate are recorded as:</p>
<ul class="simple">
<li><p>origin.time = <img class="math" src="../_images/math/914b2d4b6659b86d3153d5510839dfb254dfc8a3.png" alt="\tau"/></p></li>
<li><p>origin.time_errors.uncertainty = <img class="math" src="../_images/math/c65793dc2e246814b66c7cdd4e3a1c6dc504bbfc.png" alt="\Delta t_p"/></p></li>
<li><p>origin.time_errors.confidence_level = <img class="math" src="../_images/math/13f30937182d0536a97f9f716e6024b4c3951b86.png" alt="100p"/></p></li>
<li><p>origin.quality.standard_error = <img class="math" src="../_images/math/b52df27bfb0b1e3af0c2c68a7b9da459178c2a7d.png" alt="\sigma"/></p></li>
<li><p>origin.time = <img class="math" src="../_images/math/914b2d4b6659b86d3153d5510839dfb254dfc8a3.svg" alt="\tau"/></p></li>
<li><p>origin.time_errors.uncertainty = <img class="math" src="../_images/math/c65793dc2e246814b66c7cdd4e3a1c6dc504bbfc.svg" alt="\Delta t_p"/></p></li>
<li><p>origin.time_errors.confidence_level = <img class="math" src="../_images/math/13f30937182d0536a97f9f716e6024b4c3951b86.svg" alt="100p"/></p></li>
<li><p>origin.quality.standard_error = <img class="math" src="../_images/math/b52df27bfb0b1e3af0c2c68a7b9da459178c2a7d.svg" alt="\sigma"/></p></li>
<li><p>origin.quality.ground_truth_level = GT1</p></li>
</ul>
<p>For the sake of reproducibility, a comment is added to every new <a class="reference internal" href="../base/glossary.html#term-origin"><span class="xref std std-term">origin</span></a>
reporting <img class="math" src="../_images/math/52ddc0cde6d632f631533173562fe3ca375b1f32.png" alt="K"/>, <img class="math" src="../_images/math/93ad30f90f5091591a2dc0895c6171abda508e06.png" alt="s_K"/> and <img class="math" src="../_images/math/e2e0165baaf165355d3e4661b14d1558d9bde02b.png" alt="\kappa_p"/>.</p>
reporting <img class="math" src="../_images/math/52ddc0cde6d632f631533173562fe3ca375b1f32.svg" alt="K"/>, <img class="math" src="../_images/math/93ad30f90f5091591a2dc0895c6171abda508e06.svg" alt="s_K"/> and <img class="math" src="../_images/math/e2e0165baaf165355d3e4661b14d1558d9bde02b.svg" alt="\kappa_p"/>.</p>
</section>
<section id="application">
<h2>Application<a class="headerlink" href="#application" title="Permalink to this heading"></a></h2>
@ -264,6 +264,38 @@ Other interfaces might be added via plugins. Please check their
documentation for the required interface name.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-FixedHypocenter.lat">
<span class="sig-name descname"><span class="pre">FixedHypocenter.lat</span></span><a class="headerlink" href="#confval-FixedHypocenter.lat" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>double</em></p>
<p>The fixed latitude to use. If not set then this
value is read from the input origin.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-FixedHypocenter.lon">
<span class="sig-name descname"><span class="pre">FixedHypocenter.lon</span></span><a class="headerlink" href="#confval-FixedHypocenter.lon" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>double</em></p>
<p>The fixed longitude to use. If not set then this
value is read from the input origin.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-FixedHypocenter.depth">
<span class="sig-name descname"><span class="pre">FixedHypocenter.depth</span></span><a class="headerlink" href="#confval-FixedHypocenter.depth" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>double</em></p>
<p>The fixed depth to use. If not set then this
value is read from the input origin.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-FixedHypocenter.time">
<span class="sig-name descname"><span class="pre">FixedHypocenter.time</span></span><a class="headerlink" href="#confval-FixedHypocenter.time" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>The fixed time to use. If not set then this
value is read from the input origin.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-FixedHypocenter.usePickUncertainties">
<span class="sig-name descname"><span class="pre">FixedHypocenter.usePickUncertainties</span></span><a class="headerlink" href="#confval-FixedHypocenter.usePickUncertainties" title="Permalink to this definition"></a></dt>
@ -364,7 +396,7 @@ not going to be used or if they are absent.</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>FX-DFX &#8212; SeisComP Release documentation</title>
<title>FX-DFX &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -86,7 +86,7 @@ azimuth is referred to as only azimuth.</p>
<section id="algorithm">
<h2>Algorithm<a class="headerlink" href="#algorithm" title="Permalink to this heading"></a></h2>
<p>The algorithm computes polarization attributes for a three-component station using
a modification to the <span id="id1">Jurkevics [<a class="reference internal" href="../base/references.html#id42" title="A. Jurkevics. Polarization analysis of three-component array data. Bull. Seismol. Soc. Am., 78(5):1725-1743, 1988. doi:10.1785/BSSA0710041105.">48</a>]</span> algorithm. Some of these attributes are
a modification to the <span id="id1">Jurkevics [<a class="reference internal" href="../base/references.html#id57" title="A. Jurkevics. Polarization analysis of three-component array data. Bull. Seismol. Soc. Am., 78(5):1725-1743, 1988. doi:10.1785/BSSA0710041105.">56</a>]</span> algorithm. Some of these attributes are
then used to determine detection azimuth (seazp = P-type azimuth in degrees),
detection slowness and azimuth/slowness uncertainties (inang1 = emergence (incidence)
angle and rect = rectilinearity).</p>
@ -169,7 +169,7 @@ is added as a comment to the resulting pick. The comment ID is
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>GUI &#8212; SeisComP Release documentation</title>
<title>GUI &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -245,7 +245,7 @@ Styles are:</p>
</tr>
</thead>
<tbody>
<tr class="row-even"><td><p><a class="reference internal" href="slmon.html#confval-title"><code class="xref std std-confval docutils literal notranslate"><span class="pre">title</span></code></a></p></td>
<tr class="row-even"><td><p><a class="reference internal" href="slmon2.html#confval-title"><code class="xref std std-confval docutils literal notranslate"><span class="pre">title</span></code></a></p></td>
<td><p>Title</p></td>
<td><p>title = Faults</p></td>
</tr>
@ -949,10 +949,11 @@ conversion specifier. Valid specifiers are</p>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-map.format">
<span class="sig-name descname"><span class="pre">map.format</span></span><a class="headerlink" href="#confval-map.format" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">Rectangular</span></code></p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">rectangular</span></code></p>
<p>Type: <em>string</em></p>
<p>Projection of the map tiles configured in map.location.
Note: Additional projections may be available by plugins.</p>
<p>Values: <code class="docutils literal notranslate"><span class="pre">rectangular,mercator</span></code></p>
<p>Projection of the map tiles configured in &quot;map.location&quot;.</p>
<p>Note: Additional projections may be available by plugins.</p>
</dd></dl>
<dl class="std confval">
@ -1000,6 +1001,21 @@ is &quot;grid&quot; and the name of the cities
layer is &quot;cities&quot;.</p>
</dd></dl>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p><strong>map.mercator.*</strong>
<em>Parameters specifically related to maps loaded with</em>
<em>mercator projection.</em></p>
</div>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-map.mercator.discrete">
<span class="sig-name descname"><span class="pre">map.mercator.discrete</span></span><a class="headerlink" href="#confval-map.mercator.discrete" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">false</span></code></p>
<p>Type: <em>boolean</em></p>
<p>Only support discrete zoom levels. The parameter impacts
the effect of &quot;map.zoom.sensitivity&quot;.</p>
</dd></dl>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p><strong>map.layers.events.*</strong>
@ -1020,7 +1036,7 @@ by scolv.</p>
<p class="admonition-title">Note</p>
<p><strong>map.layers.fep.*</strong>
<em>Configuration for the fep layer showing the polygons</em>
<em>of FEP (FLinn-Engdahl-Polygon) files on maps if they</em>
<em>of FEP (Flinn-Engdahl-Polygon) files on maps if they</em>
<em>exist in &#64;DATADIR&#64;/fep or &#64;CONFIGDIR&#64;/fep.</em></p>
</div>
<dl class="std confval">
@ -1037,9 +1053,9 @@ by scolv.</p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">-1</span></code></p>
<p>Type: <em>int</em></p>
<p>Maximum number of cities to be rendered. If
cityPopulationWeight is less or equal than 0 then
all cities are rendered ordered by population count,
highest first.
&quot;scheme.map.cityPopulationWeight&quot; is less
or equal than 0 then all cities are rendered ordered
by population count, highest first.
To show the N most populated places in the visible
map region, set
&quot;scheme.map.cityPopulationWeight&quot; to 0
@ -1057,16 +1073,17 @@ and set this parameter to N.</p>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p><strong>scheme.*</strong>
<em>This group defines various options for color, pen, brush, font, etc. for SeisComP</em>
<em>graphical user interfaces. There are various conventions to</em>
<em>define colors, fonts and gradients.</em>
<em>This group defines various options controlling the look and feel</em>
<em>of graphical modules. The options include symbols, units,</em>
<em>precision, color, pen, brush, font, etc. There are various</em>
<em>conventions to define colors, fonts and gradients.</em>
**
<em>Colors are defined in HTML</em>
<em>convention, e.g. as rgb values, hexadecimal numbers or color</em>
<em>keyword names defined by W3C. If rgb or rgba is used, it must</em>
<em>be quoted because the comma is handled as list separator by</em>
<em>the configuration.</em>
<em>Examples: “rgb(255,0,0)”, FF00FF40, green.</em>
<em>Examples: “rgb(0,128,0)”, 00800040, green.</em>
**
<em>Gradients are configured as lists of tuples where each tuple</em>
<em>is colon separated in the form value:color. Value is either</em>
@ -1093,10 +1110,20 @@ and set this parameter to N.</p>
<dt class="sig sig-object std" id="confval-scheme.tabPosition">
<span class="sig-name descname"><span class="pre">scheme.tabPosition</span></span><a class="headerlink" href="#confval-scheme.tabPosition" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>Set position if tab bar. An unset value lets the application
decide where to place the tab bar. This option might not be
supported by all applications. Valid positions are: off, north,
south, east, west</p>
<p>Values: <code class="docutils literal notranslate"><span class="pre">off,north,south,east,west</span></code></p>
<p>The position of tab bar of GUI applications like scolv.
An unset value lets the application decide where to place
the tab bar. This option might not be supported by all
applications. Valid positions are: off, north, south,
east, west.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-scheme.distanceHypocentral">
<span class="sig-name descname"><span class="pre">scheme.distanceHypocentral</span></span><a class="headerlink" href="#confval-scheme.distanceHypocentral" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">false</span></code></p>
<p>Type: <em>boolean</em></p>
<p>Show hypocentral instead of epicentral distances.</p>
</dd></dl>
<dl class="std confval">
@ -1105,7 +1132,7 @@ south, east, west</p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">8</span></code></p>
<p>Type: <em>int</em></p>
<p>Unit: <em>px</em></p>
<p>The station symbol size (e.g. in scmv).</p>
<p>The station symbol size, e.g., in scmv.</p>
</dd></dl>
<dl class="std confval">
@ -1114,8 +1141,38 @@ south, east, west</p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">9</span></code></p>
<p>Type: <em>int</em></p>
<p>Unit: <em>px</em></p>
<p>The origin symbol minimum size. The formula to compute the
size of the origin symbol is: 4.9*(M-1.2).</p>
<p>The minimum symbol size of origins. The size is scaled
with magnitude according to
&quot;scheme.mag.originSymbolScaleMag&quot;.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-scheme.map.originSymbolMinMag">
<span class="sig-name descname"><span class="pre">scheme.map.originSymbolMinMag</span></span><a class="headerlink" href="#confval-scheme.map.originSymbolMinMag" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">1.2</span></code></p>
<p>Type: <em>double</em></p>
<p>The minimum magnitude to be represented by an origin
symbol. The symbol size of origins with this or lower
magnitude is configured by
&quot;scheme.mag.originSymbolMinSize&quot;. For origins
with larger magnitudes the symbol sizes are scaled according
to &quot;scheme.mag.originSymbolScaleMag&quot;.</p>
<p>Starting from the minimum magnitude legends explaining
magnitudes will show eight symbols in steps of one
magnitude.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-scheme.map.originSymbolScaleMag">
<span class="sig-name descname"><span class="pre">scheme.map.originSymbolScaleMag</span></span><a class="headerlink" href="#confval-scheme.map.originSymbolScaleMag" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">4.9</span></code></p>
<p>Type: <em>double</em></p>
<p>Unit: <em>px/magnitude</em></p>
<p>The factor for scaling the symbol size of origins with
some magnitude as:
&quot;scheme.mag.originSymbolScaleMag&quot; * (magnitude - &quot;scheme.mag.originSymbolMinMag&quot;).</p>
<p>The color of origins symbols is controlled by the parameters
&quot;scheme.colors.originSymbol.*&quot;.</p>
</dd></dl>
<dl class="std confval">
@ -1187,8 +1244,12 @@ option.</p>
<span class="sig-name descname"><span class="pre">scheme.map.projection</span></span><a class="headerlink" href="#confval-scheme.map.projection" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">Rectangular</span></code></p>
<p>Type: <em>string</em></p>
<p>SeisComP ships with the rectangular projection built-in.
<p>Values: <code class="docutils literal notranslate"><span class="pre">Rectangular,Mercator</span></code></p>
<p>The projection for showing maps. SeisComP ships with
Rectangular and Mercator.
Other projections may be provided through plugins.</p>
<p>The visible latitude range of maps shown with Mercator
is limited to -85 - +85 deg.</p>
</dd></dl>
<dl class="std confval">
@ -1208,6 +1269,22 @@ Other projections may be provided through plugins.</p>
<p>Minimum screen distance to plot a polygon or polyline line segment.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-scheme.map.maxZoom">
<span class="sig-name descname"><span class="pre">scheme.map.maxZoom</span></span><a class="headerlink" href="#confval-scheme.map.maxZoom" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">24</span></code></p>
<p>Type: <em>float</em></p>
<p>Range: <code class="docutils literal notranslate"><span class="pre">1:24</span></code></p>
<p>Maximum allowed zoom level.</p>
</dd></dl>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p><strong>scheme.colors.*</strong>
<em>Colors can be configured as rgb, rgba. hexadecimal numbers or color keyword names</em>
<em>defined by W3C. If a color is unset, SeisComP applications</em>
<em>attempt to read it from your Desktop theme.</em></p>
</div>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-scheme.colors.background">
<span class="sig-name descname"><span class="pre">scheme.colors.background</span></span><a class="headerlink" href="#confval-scheme.colors.background" title="Permalink to this definition"></a></dt>
@ -1306,7 +1383,9 @@ connecting the origin and a station).</p>
<span class="sig-name descname"><span class="pre">scheme.colors.map.directivity.style</span></span><a class="headerlink" href="#confval-scheme.colors.map.directivity.style" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">DotLine</span></code></p>
<p>Type: <em>string</em></p>
<p>The style of the pen. Supported values are: NoPen, SolidLine, DashLine, DotLine, DashDotLine, DashDotDotLine.</p>
<p>Values: <code class="docutils literal notranslate"><span class="pre">NoPen,</span> <span class="pre">SolidLine,DashLine,DotLine,DashDotLine,DashDotDotLine</span></code></p>
<p>The style of the pen. Supported values are:
NoPen, SolidLine, DashLine, DotLine, DashDotLine, DashDotDotLine.</p>
</dd></dl>
<dl class="std confval">
@ -1336,7 +1415,10 @@ connecting the origin and a station).</p>
<span class="sig-name descname"><span class="pre">scheme.colors.map.grid.style</span></span><a class="headerlink" href="#confval-scheme.colors.map.grid.style" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">DotLine</span></code></p>
<p>Type: <em>string</em></p>
<p>The style of the pen. Supported values are: NoPen, SolidLine, DashLine, DotLine, DashDotLine, DashDotDotLine.</p>
<p>Values: <code class="docutils literal notranslate"><span class="pre">NoPen,SolidLine,DashLine,DotLine,DashDotLine,DashDotDotLine</span></code></p>
<p>The style of the pen. Supported values are:
NoPen, SolidLine, DashLine, DotLine, DashDotLine,
DashDotDotLine.</p>
</dd></dl>
<dl class="std confval">
@ -1382,6 +1464,7 @@ connecting the origin and a station).</p>
<span class="sig-name descname"><span class="pre">scheme.colors.map.annotations.normalText.style</span></span><a class="headerlink" href="#confval-scheme.colors.map.annotations.normalText.style" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">SolidLine</span></code></p>
<p>Type: <em>string</em></p>
<p>Values: <code class="docutils literal notranslate"><span class="pre">NoPen,SolidLine,DashLine,DotLine,DashDotLine,DashDotDotLine</span></code></p>
<p>The style of the pen. Supported values are:
NoPen, SolidLine, DashLine, DotLine, DashDotLine, DashDotDotLine.</p>
</dd></dl>
@ -1413,6 +1496,7 @@ NoPen, SolidLine, DashLine, DotLine, DashDotLine, DashDotDotLine.</p>
<span class="sig-name descname"><span class="pre">scheme.colors.map.annotations.normalBorder.style</span></span><a class="headerlink" href="#confval-scheme.colors.map.annotations.normalBorder.style" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">SolidLine</span></code></p>
<p>Type: <em>string</em></p>
<p>Values: <code class="docutils literal notranslate"><span class="pre">NoPen,SolidLine,DashLine,DotLine,DashDotLine,DashDotDotLine</span></code></p>
<p>The style of the pen. Supported values are:
NoPen, SolidLine, DashLine, DotLine, DashDotLine, DashDotDotLine.</p>
</dd></dl>
@ -1444,6 +1528,7 @@ NoPen, SolidLine, DashLine, DotLine, DashDotLine, DashDotDotLine.</p>
<span class="sig-name descname"><span class="pre">scheme.colors.map.annotations.normalBackground.style</span></span><a class="headerlink" href="#confval-scheme.colors.map.annotations.normalBackground.style" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">solid</span></code></p>
<p>Type: <em>string</em></p>
<p>Values: <code class="docutils literal notranslate"><span class="pre">solid,dense1,dense2,dense3,dense4,dense5,dense6,dense7,nobrush,horizontal,vertical,cross,bdiag,fdiag,diagcross</span></code></p>
<p>The style of the brush. Supported values are, e.g.:
solid, dense1, dense7, horizontal, vertical,
cross, bdiag, fdiag, diagcross.</p>
@ -1467,6 +1552,7 @@ cross, bdiag, fdiag, diagcross.</p>
<span class="sig-name descname"><span class="pre">scheme.colors.map.annotations.highlightedText.style</span></span><a class="headerlink" href="#confval-scheme.colors.map.annotations.highlightedText.style" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">SolidLine</span></code></p>
<p>Type: <em>string</em></p>
<p>Values: <code class="docutils literal notranslate"><span class="pre">NoPen,SolidLine,DashLine,DotLine,DashDotLine,DashDotDotLine</span></code></p>
<p>The style of the pen. Supported values are:
NoPen, SolidLine, DashLine, DotLine, DashDotLine, DashDotDotLine.</p>
</dd></dl>
@ -1498,6 +1584,7 @@ NoPen, SolidLine, DashLine, DotLine, DashDotLine, DashDotDotLine.</p>
<span class="sig-name descname"><span class="pre">scheme.colors.map.annotations.highlightedBorder.style</span></span><a class="headerlink" href="#confval-scheme.colors.map.annotations.highlightedBorder.style" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">SolidLine</span></code></p>
<p>Type: <em>string</em></p>
<p>Values: <code class="docutils literal notranslate"><span class="pre">NoPen,SolidLine,DashLine,DotLine,DashDotLine,DashDotDotLine</span></code></p>
<p>The style of the pen. Supported values are:
NoPen, SolidLine, DashLine, DotLine, DashDotLine, DashDotDotLine.</p>
</dd></dl>
@ -1529,6 +1616,7 @@ NoPen, SolidLine, DashLine, DotLine, DashDotLine, DashDotDotLine.</p>
<span class="sig-name descname"><span class="pre">scheme.colors.map.annotations.highlightedBackground.style</span></span><a class="headerlink" href="#confval-scheme.colors.map.annotations.highlightedBackground.style" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">solid</span></code></p>
<p>Type: <em>string</em></p>
<p>Values: <code class="docutils literal notranslate"><span class="pre">solid,dense1,dense2,dense3,dense4,dense5,dense6,dense7,nobrush,horizontal,vertical,cross,bdiag,fdiag,diagcross</span></code></p>
<p>The style of the brush. Supported values are, e.g.:
solid, dense1, dense7, horizontal, vertical,
cross, bdiag, fdiag, diagcross.</p>
@ -1547,7 +1635,7 @@ cross, bdiag, fdiag, diagcross.</p>
<span class="sig-name descname"><span class="pre">scheme.colors.records.alternateForeground</span></span><a class="headerlink" href="#confval-scheme.colors.records.alternateForeground" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">808080</span></code></p>
<p>Type: <em>color</em></p>
<p>A general trace color of the alternate trace (eg scheli).</p>
<p>A general trace color of the alternate trace, e.g., scheli.</p>
</dd></dl>
<dl class="std confval">
@ -1622,6 +1710,7 @@ cross, bdiag, fdiag, diagcross.</p>
<dt class="sig sig-object std" id="confval-scheme.colors.records.borders.standard.pen.style">
<span class="sig-name descname"><span class="pre">scheme.colors.records.borders.standard.pen.style</span></span><a class="headerlink" href="#confval-scheme.colors.records.borders.standard.pen.style" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>Values: <code class="docutils literal notranslate"><span class="pre">NoPen,SolidLine,DashLine,DotLine,DashDotLine,DashDotDotLine</span></code></p>
<p>The style of the pen. Supported values are:
NoPen, SolidLine, DashLine, DotLine, DashDotLine, DashDotDotLine.</p>
</dd></dl>
@ -1637,7 +1726,7 @@ NoPen, SolidLine, DashLine, DotLine, DashDotLine, DashDotDotLine.</p>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p><strong>scheme.colors.records.borders.standard.brush.*</strong>
<em>Defines the brush of the enlcosed area.</em></p>
<em>Defines the brush of the enclosed area.</em></p>
</div>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-scheme.colors.records.borders.standard.brush.color">
@ -1650,6 +1739,7 @@ NoPen, SolidLine, DashLine, DotLine, DashDotLine, DashDotDotLine.</p>
<dt class="sig sig-object std" id="confval-scheme.colors.records.borders.standard.brush.style">
<span class="sig-name descname"><span class="pre">scheme.colors.records.borders.standard.brush.style</span></span><a class="headerlink" href="#confval-scheme.colors.records.borders.standard.brush.style" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>Values: <code class="docutils literal notranslate"><span class="pre">solid,dense1,dense2,dense3,dense4,dense5,dense6,dense7,nobrush,horizontal,vertical,cross,bdiag,fdiag,diagcross</span></code></p>
<p>The style of the brush. Supported values are, e.g.:
solid, dense1, dense7, horizontal, vertical,
cross, bdiag, fdiag, diagcross.</p>
@ -1676,6 +1766,7 @@ cross, bdiag, fdiag, diagcross.</p>
<dt class="sig sig-object std" id="confval-scheme.colors.records.borders.signatureValid.pen.style">
<span class="sig-name descname"><span class="pre">scheme.colors.records.borders.signatureValid.pen.style</span></span><a class="headerlink" href="#confval-scheme.colors.records.borders.signatureValid.pen.style" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>Values: <code class="docutils literal notranslate"><span class="pre">NoPen,SolidLine,DashLine,DotLine,DashDotLine,DashDotDotLine</span></code></p>
<p>The style of the pen. Supported values are:
NoPen, SolidLine, DashLine, DotLine, DashDotLine, DashDotDotLine.</p>
</dd></dl>
@ -1704,6 +1795,7 @@ NoPen, SolidLine, DashLine, DotLine, DashDotLine, DashDotDotLine.</p>
<dt class="sig sig-object std" id="confval-scheme.colors.records.borders.signatureValid.brush.style">
<span class="sig-name descname"><span class="pre">scheme.colors.records.borders.signatureValid.brush.style</span></span><a class="headerlink" href="#confval-scheme.colors.records.borders.signatureValid.brush.style" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>Values: <code class="docutils literal notranslate"><span class="pre">solid,dense1,dense2,dense3,dense4,dense5,dense6,dense7,nobrush,horizontal,vertical,cross,bdiag,fdiag,diagcross</span></code></p>
<p>The style of the pen. Supported values are, e.g.:
solid, dense1, dense7, horizontal, vertical,
cross, bdiag, fdiag, diagcross.</p>
@ -1730,6 +1822,7 @@ cross, bdiag, fdiag, diagcross.</p>
<dt class="sig sig-object std" id="confval-scheme.colors.records.borders.signatureInvalid.pen.style">
<span class="sig-name descname"><span class="pre">scheme.colors.records.borders.signatureInvalid.pen.style</span></span><a class="headerlink" href="#confval-scheme.colors.records.borders.signatureInvalid.pen.style" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>Values: <code class="docutils literal notranslate"><span class="pre">NoPen,SolidLine,DashLine,DotLine,DashDotLine,DashDotDotLine</span></code></p>
<p>The style of the pen. Supported values are:
NoPen, SolidLine, DashLine, DotLine, DashDotLine, DashDotDotLine.</p>
</dd></dl>
@ -1758,6 +1851,7 @@ NoPen, SolidLine, DashLine, DotLine, DashDotLine, DashDotDotLine.</p>
<dt class="sig sig-object std" id="confval-scheme.colors.records.borders.signatureInvalid.brush.style">
<span class="sig-name descname"><span class="pre">scheme.colors.records.borders.signatureInvalid.brush.style</span></span><a class="headerlink" href="#confval-scheme.colors.records.borders.signatureInvalid.brush.style" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>Values: <code class="docutils literal notranslate"><span class="pre">solid,dense1,dense2,dense3,dense4,dense5,dense6,dense7,nobrush,horizontal,vertical,cross,bdiag,fdiag,diagcross</span></code></p>
<p>The style of the pen. Supported values are, e.g.:
solid, dense1, dense7, horizontal, vertical,
cross, bdiag, fdiag, diagcross.</p>
@ -1781,6 +1875,7 @@ cross, bdiag, fdiag, diagcross.</p>
<span class="sig-name descname"><span class="pre">scheme.colors.records.offset.style</span></span><a class="headerlink" href="#confval-scheme.colors.records.offset.style" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">SolidLine</span></code></p>
<p>Type: <em>string</em></p>
<p>Values: <code class="docutils literal notranslate"><span class="pre">NoPen,SolidLine,DashLine,DotLine,DashDotLine,DashDotDotLine</span></code></p>
<p>The style of the pen. Supported values are: NoPen, SolidLine, DashLine, DotLine, DashDotLine, DashDotDotLine.</p>
</dd></dl>
@ -1811,6 +1906,7 @@ cross, bdiag, fdiag, diagcross.</p>
<span class="sig-name descname"><span class="pre">scheme.colors.records.gridPen.style</span></span><a class="headerlink" href="#confval-scheme.colors.records.gridPen.style" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">DashLine</span></code></p>
<p>Type: <em>string</em></p>
<p>Values: <code class="docutils literal notranslate"><span class="pre">NoPen,SolidLine,DashLine,DotLine,DashDotLine,DashDotDotLine</span></code></p>
<p>The style of the pen. Supported values are: NoPen, SolidLine, DashLine, DotLine, DashDotLine, DashDotDotLine.</p>
</dd></dl>
@ -1841,6 +1937,7 @@ cross, bdiag, fdiag, diagcross.</p>
<span class="sig-name descname"><span class="pre">scheme.colors.records.subGridPen.style</span></span><a class="headerlink" href="#confval-scheme.colors.records.subGridPen.style" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">DotLine</span></code></p>
<p>Type: <em>string</em></p>
<p>Values: <code class="docutils literal notranslate"><span class="pre">NoPen,SolidLine,DashLine,DotLine,DashDotLine,DashDotDotLine</span></code></p>
<p>The style of the pen. Supported values are: NoPen, SolidLine, DashLine, DotLine, DashDotLine, DashDotDotLine.</p>
</dd></dl>
@ -1970,7 +2067,7 @@ e.g. residual plot of scolv, manual picker, …)</p>
<p>The gradient of arrivals residuals. A gradient is defined as
a list of tuples separated by colon where the first item is
the value and the second is the color. Colors can be given in
rgb notation or hexadecimal. When rgb is used double quotes are needed to
rgb notation or hexadecimal. When rgb is used, double quotes are needed to
protect the comma inside the rgb definition, e.g.
-8:&quot;rgb(0,0,100)&quot;, -4:&quot;rgb(0,0,255)&quot;, -3:&quot;rgb(100,100,255)&quot;, …</p>
</dd></dl>
@ -2019,7 +2116,7 @@ protect the comma inside the rgb definition, e.g.
<span class="sig-name descname"><span class="pre">scheme.colors.stations.associated</span></span><a class="headerlink" href="#confval-scheme.colors.stations.associated" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">82AD58</span></code></p>
<p>Type: <em>color</em></p>
<p>The color of associated stations (e.g. in scmv).</p>
<p>The color of associated stations, e.g., in scmv.</p>
</dd></dl>
<dl class="std confval">
@ -2252,7 +2349,7 @@ protect the comma inside the rgb definition, e.g.
<span class="sig-name descname"><span class="pre">scheme.colors.recordView.selectedTraceZoom</span></span><a class="headerlink" href="#confval-scheme.colors.recordView.selectedTraceZoom" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">C0C0FFC0</span></code></p>
<p>Type: <em>color</em></p>
<p>The color of the selected zoom area (e.g. manual picker).</p>
<p>The color of the selected zoom area, e.g., in scolv picker.</p>
</dd></dl>
<dl class="std confval">
@ -2283,6 +2380,13 @@ protect the comma inside the rgb definition, e.g.
<p>The map legend header color.</p>
</dd></dl>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p><strong>scheme.colors.originSymbol.*</strong>
<em>Parameters controlling the color of origin symbols. The</em>
<em>size is controlled by the parameters</em>
<em>“scheme.mag.originSymbol</em>”.*</p>
</div>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-scheme.colors.originSymbol.classic">
<span class="sig-name descname"><span class="pre">scheme.colors.originSymbol.classic</span></span><a class="headerlink" href="#confval-scheme.colors.originSymbol.classic" title="Permalink to this definition"></a></dt>
@ -2311,7 +2415,7 @@ the depth steps and the color for a depth &lt;= input is used.</p>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p><strong>scheme.colors.originStatus.*</strong>
<em>The origin status colors (e.g. in event list).</em></p>
<em>The origin status colors, e.g., in event lists.</em></p>
</div>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-scheme.colors.originStatus.automatic">
@ -2353,7 +2457,7 @@ the depth steps and the color for a depth &lt;= input is used.</p>
<span class="sig-name descname"><span class="pre">scheme.marker.lineWidth</span></span><a class="headerlink" href="#confval-scheme.marker.lineWidth" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>int</em></p>
<p>Unit: <em>px</em></p>
<p>The line width of the marker (e.g. picks of manual picker).</p>
<p>The line width of the marker, e.g., picks of scolv picker).</p>
</dd></dl>
<dl class="std confval">
@ -2362,7 +2466,7 @@ the depth steps and the color for a depth &lt;= input is used.</p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">1</span></code></p>
<p>Type: <em>int</em></p>
<p>Unit: <em>px</em></p>
<p>The line width of the records / traces.</p>
<p>The line width of the records/traces.</p>
</dd></dl>
<dl class="std confval">
@ -2370,7 +2474,7 @@ the depth steps and the color for a depth &lt;= input is used.</p>
<span class="sig-name descname"><span class="pre">scheme.records.antiAliasing</span></span><a class="headerlink" href="#confval-scheme.records.antiAliasing" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">true</span></code></p>
<p>Type: <em>boolean</em></p>
<p>Configures antialiasing of records / traces. Antialiasing
<p>Configures antialiasing of records/traces. Antialiasing
needs more two times to storage space as non antialiasing
but it improves visual quality.</p>
</dd></dl>
@ -2380,9 +2484,28 @@ but it improves visual quality.</p>
<span class="sig-name descname"><span class="pre">scheme.records.optimize</span></span><a class="headerlink" href="#confval-scheme.records.optimize" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">true</span></code></p>
<p>Type: <em>boolean</em></p>
<p>Configures optimization of trace polylines. If activated
then lines on the same pixel line or same pixel row
collapse into single lines.</p>
<p>Configures optimization of trace polylines. If activated,
lines on the same pixel line or same pixel row collapse
into single lines.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-scheme.records.showEngineeringValues">
<span class="sig-name descname"><span class="pre">scheme.records.showEngineeringValues</span></span><a class="headerlink" href="#confval-scheme.records.showEngineeringValues" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">true</span></code></p>
<p>Type: <em>boolean</em></p>
<p>Shows numerical values in the vertical axis and the min/mean
values between 0 and 1000 with a unit prefix such as
m (milli) or M (mega).</p>
<p>Supported prefixes are:
Q (queta = 10**30), R (ronna = 10**27), Y (yotta = 10**24),
Z (zetta = 10**21), E (exa = 10**18), P (peta = 10**15),
T (tera = 10**12), G (giga = 10**9), M (mega = 10**6),
k (kilo = 10**3),
m (milli = 10**-3), µ (micro = 10**-6), n (nano = 10**-9),
p (pico = 10**-12), f (femto = 10**-15), a (atto = 10**-18),
z (zepto = 10**-21), y (yocto = 10**-24), r (ronto = 10**-27),
q (quekto = 10**-30).</p>
</dd></dl>
<dl class="std confval">
@ -2390,6 +2513,7 @@ collapse into single lines.</p>
<span class="sig-name descname"><span class="pre">scheme.records.borders.drawMode</span></span><a class="headerlink" href="#confval-scheme.records.borders.drawMode" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">box</span></code></p>
<p>Type: <em>string</em></p>
<p>Values: <code class="docutils literal notranslate"><span class="pre">topline,box,bottomline</span></code></p>
<p>Mode for drawing record borders as box or line on top or
bottom.</p>
<p>Supported values: &quot;topline&quot;,&quot;box&quot;,&quot;bottomline&quot;</p>
@ -2405,14 +2529,15 @@ bottom.</p>
<dt class="sig sig-object std" id="confval-scheme.fonts.base.family">
<span class="sig-name descname"><span class="pre">scheme.fonts.base.family</span></span><a class="headerlink" href="#confval-scheme.fonts.base.family" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>Sets the family name of the font. The name is case insensitive and may include a foundry name.</p>
<p>Sets the family name of the font. The name is case
insensitive and may include a foundry name.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-scheme.fonts.base.size">
<span class="sig-name descname"><span class="pre">scheme.fonts.base.size</span></span><a class="headerlink" href="#confval-scheme.fonts.base.size" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>int</em></p>
<p>Defines the point size of the font</p>
<p>Defines the point size of the font.</p>
</dd></dl>
<dl class="std confval">
@ -2450,13 +2575,15 @@ bottom.</p>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p><strong>scheme.fonts.small.*</strong>
<em>The smallest available font. If undefined the point size is 2 points smaller than the base font.</em></p>
<em>The smallest available font. If undefined, the point</em>
<em>size is 2 points smaller than the base font.</em></p>
</div>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-scheme.fonts.small.family">
<span class="sig-name descname"><span class="pre">scheme.fonts.small.family</span></span><a class="headerlink" href="#confval-scheme.fonts.small.family" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>Sets the family name of the font. The name is case insensitive and may include a foundry name.</p>
<p>Sets the family name of the font. The name is case
insensitive and may include a foundry name.</p>
</dd></dl>
<dl class="std confval">
@ -2501,20 +2628,22 @@ bottom.</p>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p><strong>scheme.fonts.normal.*</strong>
<em>The default text font. If undefined the point size is 2 points larger than the base font.</em></p>
<em>The default text font. If undefined, the point size is 2</em>
<em>points larger than the base font.</em></p>
</div>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-scheme.fonts.normal.family">
<span class="sig-name descname"><span class="pre">scheme.fonts.normal.family</span></span><a class="headerlink" href="#confval-scheme.fonts.normal.family" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>Sets the family name of the font. The name is case insensitive and may include a foundry name.</p>
<p>Sets the family name of the font. The name is case
insensitive and may include a foundry name.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-scheme.fonts.normal.size">
<span class="sig-name descname"><span class="pre">scheme.fonts.normal.size</span></span><a class="headerlink" href="#confval-scheme.fonts.normal.size" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>int</em></p>
<p>Defines the point size of the font</p>
<p>Defines the point size of the font.</p>
</dd></dl>
<dl class="std confval">
@ -2552,13 +2681,15 @@ bottom.</p>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p><strong>scheme.fonts.large.*</strong>
<em>The largest text font. If undefined the point size is 6 points larger than the base font.</em></p>
<em>The largest text font. If undefined, the point size is 6</em>
<em>points larger than the base font.</em></p>
</div>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-scheme.fonts.large.family">
<span class="sig-name descname"><span class="pre">scheme.fonts.large.family</span></span><a class="headerlink" href="#confval-scheme.fonts.large.family" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>Sets the family name of the font. The name is case insensitive and may include a foundry name.</p>
<p>Sets the family name of the font. The name is case
insensitive and may include a foundry name.</p>
</dd></dl>
<dl class="std confval">
@ -2603,13 +2734,15 @@ bottom.</p>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p><strong>scheme.fonts.highlight.*</strong>
<em>Font used to highlight text. If undefined it equals the normal font except for a bold font face.</em></p>
<em>Font used to highlight text. If undefined, it equals the</em>
<em>normal font except for a bold font face.</em></p>
</div>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-scheme.fonts.highlight.family">
<span class="sig-name descname"><span class="pre">scheme.fonts.highlight.family</span></span><a class="headerlink" href="#confval-scheme.fonts.highlight.family" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>Sets the family name of the font. The name is case insensitive and may include a foundry name.</p>
<p>Sets the family name of the font. The name is case
insensitive and may include a foundry name.</p>
</dd></dl>
<dl class="std confval">
@ -2654,20 +2787,22 @@ bottom.</p>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p><strong>scheme.fonts.heading1.*</strong>
<em>The largest heading font. If undefined it uses a bold font face and a font size twice as large as the normal font.</em></p>
<em>The largest heading font. If undefined, it uses a bold</em>
<em>font face and a font size twice as large as the normal font.</em></p>
</div>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-scheme.fonts.heading1.family">
<span class="sig-name descname"><span class="pre">scheme.fonts.heading1.family</span></span><a class="headerlink" href="#confval-scheme.fonts.heading1.family" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>Sets the family name of the font. The name is case insensitive and may include a foundry name.</p>
<p>Sets the family name of the font. The name is case
insensitive and may include a foundry name.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-scheme.fonts.heading1.size">
<span class="sig-name descname"><span class="pre">scheme.fonts.heading1.size</span></span><a class="headerlink" href="#confval-scheme.fonts.heading1.size" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>int</em></p>
<p>Defines the point size of the font</p>
<p>Defines the point size of the font.</p>
</dd></dl>
<dl class="std confval">
@ -2705,20 +2840,22 @@ bottom.</p>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p><strong>scheme.fonts.heading2.*</strong>
<em>The second largest heading font. If undefined it uses a bold font face and a font size twice as large as the base font.</em></p>
<em>The second largest heading font. If undefined, it uses a</em>
<em>bold font face and a font size twice as large as the base font.</em></p>
</div>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-scheme.fonts.heading2.family">
<span class="sig-name descname"><span class="pre">scheme.fonts.heading2.family</span></span><a class="headerlink" href="#confval-scheme.fonts.heading2.family" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>Sets the family name of the font. The name is case insensitive and may include a foundry name.</p>
<p>Sets the family name of the font. The name is case
insensitive and may include a foundry name.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-scheme.fonts.heading2.size">
<span class="sig-name descname"><span class="pre">scheme.fonts.heading2.size</span></span><a class="headerlink" href="#confval-scheme.fonts.heading2.size" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>int</em></p>
<p>Defines the point size of the font</p>
<p>Defines the point size of the font.</p>
</dd></dl>
<dl class="std confval">
@ -2756,13 +2893,15 @@ bottom.</p>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p><strong>scheme.fonts.heading3.*</strong>
<em>The smallest heading font. If undefined it uses a bold font face and a font size 4 points larger than the base font.</em></p>
<em>The smallest heading font. If undefined, it uses a bold</em>
<em>font face and a font size 4 points larger than the base font.</em></p>
</div>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-scheme.fonts.heading3.family">
<span class="sig-name descname"><span class="pre">scheme.fonts.heading3.family</span></span><a class="headerlink" href="#confval-scheme.fonts.heading3.family" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>Sets the family name of the font. The name is case insensitive and may include a foundry name.</p>
<p>Sets the family name of the font. The name is case
insensitive and may include a foundry name.</p>
</dd></dl>
<dl class="std confval">
@ -2807,20 +2946,22 @@ bottom.</p>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p><strong>scheme.fonts.cityLabels.*</strong>
<em>Font used for city labels. If undefined it equals the base font.</em></p>
<em>Font used for city labels. If undefined, it equals the</em>
<em>base font.</em></p>
</div>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-scheme.fonts.cityLabels.family">
<span class="sig-name descname"><span class="pre">scheme.fonts.cityLabels.family</span></span><a class="headerlink" href="#confval-scheme.fonts.cityLabels.family" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>Sets the family name of the font. The name is case insensitive and may include a foundry name.</p>
<p>Sets the family name of the font. The name is case
insensitive and may include a foundry name.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-scheme.fonts.cityLabels.size">
<span class="sig-name descname"><span class="pre">scheme.fonts.cityLabels.size</span></span><a class="headerlink" href="#confval-scheme.fonts.cityLabels.size" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>int</em></p>
<p>Defines the point size of the font</p>
<p>Defines the point size of the font.</p>
</dd></dl>
<dl class="std confval">
@ -2858,20 +2999,23 @@ bottom.</p>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p><strong>scheme.fonts.splashVersion.*</strong>
<em>Font used for version string in the splash dialog shown at application startup. If undefined it equals the base font with a bold font face and a font size of 12.</em></p>
<em>Font used for version string in the splash dialog shown</em>
<em>at application startup. If undefined, it equals the base</em>
<em>font with a bold font face and a font size of 12.</em></p>
</div>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-scheme.fonts.splashVersion.family">
<span class="sig-name descname"><span class="pre">scheme.fonts.splashVersion.family</span></span><a class="headerlink" href="#confval-scheme.fonts.splashVersion.family" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>Sets the family name of the font. The name is case insensitive and may include a foundry name.</p>
<p>Sets the family name of the font. The name is case
insensitive and may include a foundry name.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-scheme.fonts.splashVersion.size">
<span class="sig-name descname"><span class="pre">scheme.fonts.splashVersion.size</span></span><a class="headerlink" href="#confval-scheme.fonts.splashVersion.size" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>int</em></p>
<p>Defines the point size of the font</p>
<p>Defines the point size of the font.</p>
</dd></dl>
<dl class="std confval">
@ -2909,13 +3053,16 @@ bottom.</p>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p><strong>scheme.fonts.splashMessage.*</strong>
<em>Font used for the message text in the splash dialog shown at application startup. If undefined it equals the base font with a font size of 12.</em></p>
<em>Font used for the message text in the splash dialog</em>
<em>shown at application startup. If undefined, it equals</em>
<em>the base font with a font size of 12.</em></p>
</div>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-scheme.fonts.splashMessage.family">
<span class="sig-name descname"><span class="pre">scheme.fonts.splashMessage.family</span></span><a class="headerlink" href="#confval-scheme.fonts.splashMessage.family" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>Sets the family name of the font. The name is case insensitive and may include a foundry name.</p>
<p>Sets the family name of the font. The name is case
insensitive and may include a foundry name.</p>
</dd></dl>
<dl class="std confval">
@ -2957,6 +3104,12 @@ bottom.</p>
<p><em>No description available</em></p>
</dd></dl>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p><strong>scheme.precision.*</strong>
<em>Display values with the precisions configured as the number</em>
<em>of decimal places.</em></p>
</div>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-scheme.precision.depth">
<span class="sig-name descname"><span class="pre">scheme.precision.depth</span></span><a class="headerlink" href="#confval-scheme.precision.depth" title="Permalink to this definition"></a></dt>
@ -2979,7 +3132,7 @@ parameter only applies if scheme.unit.distanceInKM = true.</p>
<span class="sig-name descname"><span class="pre">scheme.precision.location</span></span><a class="headerlink" href="#confval-scheme.precision.location" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">2</span></code></p>
<p>Type: <em>int</em></p>
<p>The precision of lat/lon values.</p>
<p>The precision of latitude/longintude values.</p>
</dd></dl>
<dl class="std confval">
@ -2995,7 +3148,8 @@ parameter only applies if scheme.unit.distanceInKM = true.</p>
<span class="sig-name descname"><span class="pre">scheme.precision.originTime</span></span><a class="headerlink" href="#confval-scheme.precision.originTime" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">0</span></code></p>
<p>Type: <em>int</em></p>
<p>The precision of origin times.</p>
<p>The precision of origin times and creation times of
origins and focal mechanisms.</p>
</dd></dl>
<dl class="std confval">
@ -3011,7 +3165,8 @@ parameter only applies if scheme.unit.distanceInKM = true.</p>
<span class="sig-name descname"><span class="pre">scheme.precision.traceValues</span></span><a class="headerlink" href="#confval-scheme.precision.traceValues" 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>int</em></p>
<p>Precision of displayed offset/amp in all trace widgets.</p>
<p>Precision of displayed offset/amplitude in all trace
widgets.</p>
</dd></dl>
<dl class="std confval">
@ -3027,7 +3182,8 @@ parameter only applies if scheme.unit.distanceInKM = true.</p>
<span class="sig-name descname"><span class="pre">scheme.precision.uncertainties</span></span><a class="headerlink" href="#confval-scheme.precision.uncertainties" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">0</span></code></p>
<p>Type: <em>int</em></p>
<p>Precision of uncertainty values, e.g. latitude errors.</p>
<p>Precision of uncertainty values, e.g., for latitude and
longitude.</p>
</dd></dl>
<dl class="std confval">
@ -3043,7 +3199,9 @@ parameter only applies if scheme.unit.distanceInKM = true.</p>
<span class="sig-name descname"><span class="pre">scheme.dateTime.useLocalTime</span></span><a class="headerlink" href="#confval-scheme.dateTime.useLocalTime" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">false</span></code></p>
<p>Type: <em>boolean</em></p>
<p>Display times in localtime or UTC (default).</p>
<p>Display times in localtime. If disabled all times are
shown in UTC which is also the time zone of all values
stored in the database.</p>
</dd></dl>
<div class="admonition note">
@ -3126,7 +3284,8 @@ parameter only applies if scheme.unit.distanceInKM = true.</p>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p><strong>events.timeAgo.*</strong>
<em>Defines maximum age of events to load. The value of all parameters are aggregated.</em></p>
<em>Defines maximum age of events to load. The value of all</em>
<em>parameters are aggregated.</em></p>
</div>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-events.timeAgo.days">
@ -3205,11 +3364,10 @@ The entry with a leading &quot;&#64;&quot; is selected as default filter.</p>
<span class="sig-name descname"><span class="pre">eventlist.visibleColumns</span></span><a class="headerlink" href="#confval-eventlist.visibleColumns" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">M,MType,Phases,RMS,Lat,Lon,Depth,Stat,Agency,Region,ID</span></code></p>
<p>Type: <em>list:string</em></p>
<p>Values: <code class="docutils literal notranslate"><span class="pre">TimeAgo,Certainty,Type,M,MType,RMS,AzGap,Phases,Lat,Lon,Depth,DType,Stat,FM,Origins,Agency,Author,Region,ID</span></code></p>
<p>Configure the columns of the event list that are visible
initially. The first column containing the origin time is
always visible and cannot be hidden. Possible values are:</p>
<p>Certainty, Type, M, MType, RMS, AzGap, Phases, Lat, Lon, Depth, DType,
Stat, FM, Origins, Agency, Author, Region, ID.</p>
always visible and cannot be hidden.</p>
<p>Custom columns can be added by eventlist.customColumn.* or
eventlist.scripts.* parameters.</p>
</dd></dl>
@ -3274,6 +3432,15 @@ E.g. &quot;foo:#000,bar:red&quot;.</p>
<em>Custom columns showing parameters extracted by scripts e.g.</em>
<em>from origins or events.</em></p>
</div>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-eventlist.scripts.export">
<span class="sig-name descname"><span class="pre">eventlist.scripts.export</span></span><a class="headerlink" href="#confval-eventlist.scripts.export" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>file</em></p>
<p>Defines the export script to be called with the selected
event IDs in stdin when the corresponding action is triggered
from the context menu of the list of events.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-eventlist.scripts.columns">
<span class="sig-name descname"><span class="pre">eventlist.scripts.columns</span></span><a class="headerlink" href="#confval-eventlist.scripts.columns" title="Permalink to this definition"></a></dt>
@ -3305,7 +3472,7 @@ eventlist.scripts.column.c.value1<span class="w"> </span><span class="o">=</span
<dl class="std confval">
<dt class="sig sig-object std" id="confval-eventlist.scripts.column.-name.script">
<span class="sig-name descname"><span class="pre">eventlist.scripts.column.$name.script</span></span><a class="headerlink" href="#confval-eventlist.scripts.column.-name.script" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>path</em></p>
<dd><p>Type: <em>file</em></p>
<p>External script to invoke for each event list entry. The object represented by the
list entry is serialized to XML and passed to the script on stdin. If the return
code of the script is 0 (success) then the script result is read from stdout and
@ -3532,6 +3699,20 @@ option.</p>
<p>Maximum depth</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-eventlist.filter.database.minphasecount">
<span class="sig-name descname"><span class="pre">eventlist.filter.database.minphasecount</span></span><a class="headerlink" href="#confval-eventlist.filter.database.minphasecount" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>int</em></p>
<p>Minimum number of phases</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-eventlist.filter.database.maxphasecount">
<span class="sig-name descname"><span class="pre">eventlist.filter.database.maxphasecount</span></span><a class="headerlink" href="#confval-eventlist.filter.database.maxphasecount" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>int</em></p>
<p>Maximum number of phases</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-eventlist.filter.database.minmag">
<span class="sig-name descname"><span class="pre">eventlist.filter.database.minmag</span></span><a class="headerlink" href="#confval-eventlist.filter.database.minmag" title="Permalink to this definition"></a></dt>
@ -3546,6 +3727,43 @@ option.</p>
<p>Maximum magnitude</p>
</dd></dl>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p><strong>eventlist.timeAgo.*</strong>
<em>Parameters controlling the appearance of the TimeAgo column.</em></p>
</div>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-eventlist.timeAgo.interval">
<span class="sig-name descname"><span class="pre">eventlist.timeAgo.interval</span></span><a class="headerlink" href="#confval-eventlist.timeAgo.interval" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">1.0</span></code></p>
<p>Type: <em>double</em></p>
<p>Unit: <em>s</em></p>
<p>Update interval in seconds.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-eventlist.timeAgo.background.gradient">
<span class="sig-name descname"><span class="pre">eventlist.timeAgo.background.gradient</span></span><a class="headerlink" href="#confval-eventlist.timeAgo.background.gradient" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>gradient</em></p>
<p>Unit: <em>s:color</em></p>
<p>Mapping of time values in seconds to colors used as
cell backgroud color. E.g., a mapping from green
over yellow (5min), red (10min) to
transparent (30min) can be expressed as
&quot;0:40FF40FF,300:FFFF40FF,600:FF4040FF,1800:FF4040FF,1801:00000000&quot;.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-eventlist.timeAgo.background.discrete">
<span class="sig-name descname"><span class="pre">eventlist.timeAgo.background.discrete</span></span><a class="headerlink" href="#confval-eventlist.timeAgo.background.discrete" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">true</span></code></p>
<p>Type: <em>boolean</em></p>
<p>If time ago value falls between two color positions,
the resulting color will be interpolated linearly
between both colors by default. When the discrete
flag is set, the interpolation will be disabled.</p>
</dd></dl>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p><strong>eventedit.*</strong>
@ -3563,8 +3781,9 @@ option.</p>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-eventedit.origin.visibleColumns">
<span class="sig-name descname"><span class="pre">eventedit.origin.visibleColumns</span></span><a class="headerlink" href="#confval-eventedit.origin.visibleColumns" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">Phases,</span> <span class="pre">Lat,</span> <span class="pre">Lon,</span> <span class="pre">Depth,</span> <span class="pre">DType,</span> <span class="pre">RMS,</span> <span class="pre">AzGap,</span> <span class="pre">Stat,</span> <span class="pre">Method,</span> <span class="pre">Agency,</span> <span class="pre">Author,</span> <span class="pre">Region,</span> <span class="pre">ID</span></code></p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">Phases,Lat,Lon,Depth,DType,RMS,AzGap,Stat,Method,Agency,Author,Region,ID</span></code></p>
<p>Type: <em>list:string</em></p>
<p>Values: <code class="docutils literal notranslate"><span class="pre">Phases,Lat,Lon,Depth,DType,RMS,AzGap,Stat,Method,Agency,Author,Region,ID</span></code></p>
<p>Configure the columns of the event edit origin table
that are visible initially. Origin creation time and
origin time are always visible.
@ -3597,32 +3816,36 @@ header.</p>
<span class="sig-name descname"><span class="pre">eventedit.origin.customColumn.pos</span></span><a class="headerlink" href="#confval-eventedit.origin.customColumn.pos" 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>int</em></p>
<p>Position of the column. If the configured position is less than 0 or if it
exceeds the total number of columns then the column is appended to the right.</p>
<p>Position of the column. If the configured position
is less than 0 or if it exceeds the total number of
columns, then the column is appended to the right.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-eventedit.origin.customColumn.default">
<span class="sig-name descname"><span class="pre">eventedit.origin.customColumn.default</span></span><a class="headerlink" href="#confval-eventedit.origin.customColumn.default" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>Default value to display if the specified origin or event comment id was not found.</p>
<p>Default value to display if the specified origin or
event comment id was not found.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-eventedit.origin.customColumn.colors">
<span class="sig-name descname"><span class="pre">eventedit.origin.customColumn.colors</span></span><a class="headerlink" href="#confval-eventedit.origin.customColumn.colors" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>list:string</em></p>
<p>Mapping of comment values to colors used as text color. E.g. &quot;foo:#000,bar:red&quot;.</p>
<p>Mapping of comment values to colors used as text
color. E.g. &quot;foo:#000,bar:red&quot;.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-eventedit.fm.visibleColumns">
<span class="sig-name descname"><span class="pre">eventedit.fm.visibleColumns</span></span><a class="headerlink" href="#confval-eventedit.fm.visibleColumns" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">Depth,</span> <span class="pre">M,</span> <span class="pre">Count,</span> <span class="pre">Misfit,</span> <span class="pre">STDR,</span> <span class="pre">AzGap,</span> <span class="pre">Stat,</span> <span class="pre">DC,</span> <span class="pre">CLVD,</span> <span class="pre">ISO,</span> <span class="pre">S1,</span> <span class="pre">D1,</span> <span class="pre">R1,</span> <span class="pre">S2,</span> <span class="pre">D2,</span> <span class="pre">R2,</span> <span class="pre">Agency,</span> <span class="pre">Author</span></code></p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">Depth,M,Count,Misfit,STDR,AzGap,Stat,DC,CLVD,ISO,S1,D1,R1,S2,D2,R2,Agency,Author</span></code></p>
<p>Type: <em>list:string</em></p>
<p>Values: <code class="docutils literal notranslate"><span class="pre">Depth,M,Count,Misfit,STDR,AzGap,Stat,DC,CLVD,ISO,S1,D1,R1,S2,D2,R2,Agency,Author</span></code></p>
<p>Configure the columns of the event edit focal mechanism
tab that are visible initially.
Possible values are: Depth, M, Count, Misfit, STDR,
tab that are visible initially.</p>
<p>Possible values are: Depth, M, Count, Misfit, STDR,
AzGap, Stat, DC, CLVD, ISO, S1,
D1, R1, S2, D2, R2, Agency, Author</p>
</dd></dl>
@ -3661,7 +3884,8 @@ text color in case of an active alert. E.g. &quot;0:00FF00,900:FF0000&quot;.</p>
<span class="sig-name descname"><span class="pre">eventsummary.alertTimer.textSize</span></span><a class="headerlink" href="#confval-eventsummary.alertTimer.textSize" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>int</em></p>
<p>Unit: <em>pt</em></p>
<p>The text size of the time ago label in case of an active alert.</p>
<p>The text size of the time ago label in case of an active
alert.</p>
</dd></dl>
</section>
@ -3751,7 +3975,7 @@ text color in case of an active alert. E.g. &quot;0:00FF00,900:FF0000&quot;.</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>homogeneous &#8212; SeisComP Release documentation</title>
<title>homogeneous &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -93,26 +93,26 @@ and click on the green button to add a table profile.</p></li>
<code class="xref std std-confval docutils literal notranslate"><span class="pre">ttt.homogeneous.tables</span></code></p></li>
</ol>
<p>Example configuration:</p>
<div class="highlight-params notranslate"><div class="highlight"><pre><span></span># The list of supported model names per interface.
ttt.homogeneous.tables = &quot;5&quot;
<div class="highlight-properties notranslate"><div class="highlight"><pre><span></span><span class="c1"># The list of supported model names per interface.</span>
<span class="na">ttt.homogeneous.tables</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">&quot;5&quot;</span>
# Geographic origin of the region. Expects 2 values: latitude, longitude.
ttt.homogeneous.5.origin = 51, 12
<span class="c1"># Geographic origin of the region. Expects 2 values: latitude, longitude.</span>
<span class="na">ttt.homogeneous.5.origin</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">51, 12</span>
# Radius validity of the region.
ttt.homogeneous.5.radius = 1
<span class="c1"># Radius validity of the region.</span>
<span class="na">ttt.homogeneous.5.radius</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">1</span>
# Min Depth validity of the region.
ttt.homogeneous.5.minDepth = 0
<span class="c1"># Min Depth validity of the region.</span>
<span class="na">ttt.homogeneous.5.minDepth</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">0</span>
# Max Depth validity of the region.
ttt.homogeneous.5.maxDepth = 2
<span class="c1"># Max Depth validity of the region.</span>
<span class="na">ttt.homogeneous.5.maxDepth</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">2</span>
# P wave velocity.
ttt.homogeneous.5.P-velocity = 5
<span class="c1"># P wave velocity.</span>
<span class="na">ttt.homogeneous.5.P-velocity</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">5</span>
# S wave velocity.
ttt.homogeneous.5.S-velocity = 3
<span class="c1"># S wave velocity.</span>
<span class="na">ttt.homogeneous.5.S-velocity</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">3</span>
</pre></div>
</div>
</section>
@ -187,7 +187,7 @@ interfaces.</p></li>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>Hypo71 &#8212; SeisComP Release documentation</title>
<title>Hypo71 &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -77,7 +77,7 @@
<p>The traditional Hypo71PC locator with SeisComP.</p>
<section id="description">
<h2>Description<a class="headerlink" href="#description" title="Permalink to this heading"></a></h2>
<p>The Hypo71 locator algorithm by Fred Klein locator (<span id="id1">Lee and Lahr [<a class="reference internal" href="../base/references.html#id51" title="W.H. Lee and J.C. Lahr. Hypo71 (revised): a computer program for determining local earthquake hypocentral parameters, magnitude, and first motion pattern of local earthquakes. US Geol. Survey Open-file Report 75-311, 1975. URL: https://pubs.er.usgs.gov/publication/ofr75311, doi:10.3133/ofr75311.">51</a>]</span>) has
<p>The Hypo71 locator algorithm by Fred Klein locator (<span id="id1">Lee and Lahr [<a class="reference internal" href="../base/references.html#id69" title="W.H. Lee and J.C. Lahr. Hypo71 (revised): a computer program for determining local earthquake hypocentral parameters, magnitude, and first motion pattern of local earthquakes. US Geol. Survey Open-file Report 75-311, 1975. URL: https://pubs.er.usgs.gov/publication/ofr75311, doi:10.3133/ofr75311.">59</a>]</span>) has
been implemented into <cite>SeisComP</cite> through the plugin mechanism. The plugin <em>hypo71</em>
contains the LocatorInterface implementation for Hypo71.
This plugin uses a slightly modified Hypo71 version from Alexandre Nercessian (IPGP)
@ -85,7 +85,7 @@ which allows negative earthquake depth (above sea level) and negative stations
altitude (below sea level - OBS).</p>
<p>The development of this plugin was co-financed by the European Union and
<a class="reference external" href="http://www.developpement-durable.gouv.fr">le Ministère de lEcologie, du Développement Durable, des Transports et du Logement</a>
and developed by <span id="id2"><em>OVSM, Interreg Caraibes</em> [<a class="reference internal" href="../base/references.html#id179" title="OVSM, Interreg Caraibes. URL: https://www.interreg-caraibes.com.">18</a>]</span> / <span id="id3"><em>IPGP</em> [<a class="reference internal" href="../base/references.html#id142" title="IPGP. URL: http://www.ipgp.fr.">11</a>]</span>.</p>
and developed by <span id="id2"><em>OVSM, Interreg Caraibes</em> [<a class="reference internal" href="../base/references.html#id208" title="OVSM, Interreg Caraibes. URL: https://www.interreg-caraibes.com.">19</a>]</span> / <span id="id3"><em>IPGP</em> [<a class="reference internal" href="../base/references.html#id170" title="IPGP. URL: http://www.ipgp.fr.">11</a>]</span>.</p>
</section>
<section id="how-it-works">
<h2>How it works<a class="headerlink" href="#how-it-works" title="Permalink to this heading"></a></h2>
@ -406,8 +406,8 @@ combo box.</p>
<section id="more">
<h2>More<a class="headerlink" href="#more" title="Permalink to this heading"></a></h2>
<ul class="simple">
<li><p>Take a look at Fred Klein HYPOINVERSE Earthquake Location software (<span id="id4">Klein [<a class="reference internal" href="../base/references.html#id47" title="F.W. Klein. Users guide to HYPOINVERSE-2000, a Fortran program to solve for earthquake locations and magnitudes. US Geological Survey, 2002-171:, 2002. URL: https://www.usgs.gov/node/279394, doi:10.3133/ofr02171.">50</a>]</span>),</p></li>
<li><p>Hypo71PC original manual and binary are available on USGS website (<span id="id5">Lee and Lahr [<a class="reference internal" href="../base/references.html#id51" title="W.H. Lee and J.C. Lahr. Hypo71 (revised): a computer program for determining local earthquake hypocentral parameters, magnitude, and first motion pattern of local earthquakes. US Geol. Survey Open-file Report 75-311, 1975. URL: https://pubs.er.usgs.gov/publication/ofr75311, doi:10.3133/ofr75311.">51</a>]</span>).</p></li>
<li><p>Take a look at Fred Klein HYPOINVERSE Earthquake Location software (<span id="id4">Klein [<a class="reference internal" href="../base/references.html#id63" title="F.W. Klein. Users guide to HYPOINVERSE-2000, a Fortran program to solve for earthquake locations and magnitudes. US Geological Survey, 2002-171:, 2002. URL: https://www.usgs.gov/node/279394, doi:10.3133/ofr02171.">58</a>]</span>),</p></li>
<li><p>Hypo71PC original manual and binary are available on USGS website (<span id="id5">Lee and Lahr [<a class="reference internal" href="../base/references.html#id69" title="W.H. Lee and J.C. Lahr. Hypo71 (revised): a computer program for determining local earthquake hypocentral parameters, magnitude, and first motion pattern of local earthquakes. US Geol. Survey Open-file Report 75-311, 1975. URL: https://pubs.er.usgs.gov/publication/ofr75311, doi:10.3133/ofr75311.">59</a>]</span>).</p></li>
</ul>
</section>
<section id="module-configuration">
@ -421,7 +421,7 @@ combo box.</p>
<dt class="sig sig-object std" id="confval-hypo71.logFile">
<span class="sig-name descname"><span class="pre">hypo71.logFile</span></span><a class="headerlink" href="#confval-hypo71.logFile" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">&#64;LOGDIR&#64;/HYPO71.LOG</span></code></p>
<p>Type: <em>string</em></p>
<p>Type: <em>file</em></p>
<p>Temporary file used by Hypo71 to store calculation logs.</p>
</dd></dl>
@ -429,7 +429,7 @@ combo box.</p>
<dt class="sig sig-object std" id="confval-hypo71.inputFile">
<span class="sig-name descname"><span class="pre">hypo71.inputFile</span></span><a class="headerlink" href="#confval-hypo71.inputFile" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">&#64;DATADIR&#64;/hypo71/HYPO71.INP</span></code></p>
<p>Type: <em>string</em></p>
<p>Type: <em>file</em></p>
<p>Temporary file to write Hypo71 input data to.</p>
</dd></dl>
@ -437,7 +437,7 @@ combo box.</p>
<dt class="sig sig-object std" id="confval-hypo71.outputFile">
<span class="sig-name descname"><span class="pre">hypo71.outputFile</span></span><a class="headerlink" href="#confval-hypo71.outputFile" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">&#64;DATADIR&#64;/hypo71/HYPO71.PRT</span></code></p>
<p>Type: <em>string</em></p>
<p>Type: <em>file</em></p>
<p>Temporary output file to read Hypo71 location data from.</p>
</dd></dl>
@ -445,17 +445,19 @@ combo box.</p>
<dt class="sig sig-object std" id="confval-hypo71.defaultControlFile">
<span class="sig-name descname"><span class="pre">hypo71.defaultControlFile</span></span><a class="headerlink" href="#confval-hypo71.defaultControlFile" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">&#64;DATADIR&#64;/hypo71/profiles/default.hypo71.conf</span></code></p>
<p>Type: <em>string</em></p>
<p>Hypo71 default profile.
If no custom profile is specified, this profile will be used by the plugin when proceeding to a localization.</p>
<p>Type: <em>file</em></p>
<p>Hypo71 default profile. If no custom profile is specified,
this profile will be used by the plugin when proceeding to a
localization.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-hypo71.hypo71ScriptFile">
<span class="sig-name descname"><span class="pre">hypo71.hypo71ScriptFile</span></span><a class="headerlink" href="#confval-hypo71.hypo71ScriptFile" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">&#64;DATADIR&#64;/hypo71/run.sh</span></code></p>
<p>Type: <em>string</em></p>
<p>Bash script executed when calling the Hypo71 locator plugin for locating the earthquake.</p>
<p>Type: <em>file</em></p>
<p>Bash script executed when calling the Hypo71 locator plugin
for locating the earthquake.</p>
</dd></dl>
<dl class="std confval">
@ -471,20 +473,22 @@ Each profile can have different velocity or parameters.</p>
<dt class="sig sig-object std" id="confval-hypo71.publicID">
<span class="sig-name descname"><span class="pre">hypo71.publicID</span></span><a class="headerlink" href="#confval-hypo71.publicID" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>Custom patternID to use when generating origin publicID</p>
<p>Custom patternID to use when generating origin publicID.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-hypo71.useHypo71PatternID">
<span class="sig-name descname"><span class="pre">hypo71.useHypo71PatternID</span></span><a class="headerlink" href="#confval-hypo71.useHypo71PatternID" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>boolean</em></p>
<p>Specifies if the given publicD should be used for generating origin publicID</p>
<p>Specifies if the given public ID shall be used for
generating origin publicID.</p>
</dd></dl>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p><strong>hypo71.profile.*</strong>
<em>Profiles containing the profile-specific velocity model and the Hypo71 parameters.</em></p>
<em>Profiles containing the profile-specific velocity model and</em>
<em>the Hypo71 parameters.</em></p>
</div>
<div class="admonition note">
<p class="admonition-title">Note</p>
@ -518,7 +522,7 @@ It is generally the locators name (Hypo71).</p>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-hypo71.profile.-name.controlFile">
<span class="sig-name descname"><span class="pre">hypo71.profile.$name.controlFile</span></span><a class="headerlink" href="#confval-hypo71.profile.-name.controlFile" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<dd><p>Type: <em>file</em></p>
<p>File containing the profile parameters.</p>
</dd></dl>
@ -606,7 +610,7 @@ use this fixed depth only as starting point (true).</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>iLoc &#8212; SeisComP Release documentation</title>
<title>iLoc &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -78,7 +78,7 @@
<section id="description">
<h2>Description<a class="headerlink" href="#description" title="Permalink to this heading"></a></h2>
<p>iLoc is a locator developed by István Bondár which has been integrated into
<cite>SeisComP</cite> by <span id="id1"><em>gempa GmbH</em> [<a class="reference internal" href="../base/references.html#id122" title="gempa GmbH. The SeisComP development and maintenance company. URL: https://www.gempa.de/.">28</a>]</span>. It is invoked by the wrapper plugin <em>lociloc</em> - the
<cite>SeisComP</cite> by <span id="id1"><em>gempa GmbH</em> [<a class="reference internal" href="../base/references.html#id147" title="gempa GmbH. The SeisComP development and maintenance company. URL: https://www.gempa.de.">31</a>]</span>. It is invoked by the wrapper plugin <em>lociloc</em> - the
interface between <cite>SeisComP</cite> and iLoc.
Read the sections <a class="reference internal" href="#iloc-setup"><span class="std std-ref">Setup in SeisComP</span></a> and <a class="reference internal" href="#iloc-application"><span class="std std-ref">Application in SeisComP</span></a> for
configuring and using iLoc in <cite>SeisComP</cite>.</p>
@ -87,10 +87,10 @@ configuring and using iLoc in <cite>SeisComP</cite>.</p>
<p>iLoc is a locator tool for locating seismic, hydroacoustic and
infrasound sources
based on <a class="reference internal" href="../base/glossary.html#term-pick"><span class="xref std std-term">phase picks</span></a>. iLoc is based on the location
algorithm developed by <span id="id2">Bondár and McLaughlin [<a class="reference internal" href="../base/references.html#id12" title="I. Bondár and K.L. McLaughlin. A new ground truth data set for seismic studies. Seismol. Res. Lett., 3:465 - 472, 2009. doi:10.1785/gssrl.80.3.465.">34</a>]</span> and implemented at the
International Seismological Center, (<span id="id3"><em>ISC</em> [<a class="reference internal" href="../base/references.html#id140" title="ISC. International Seismological Centre. URL: http://www.isc.ac.uk/.">14</a>]</span>, <span id="id4">Bondár <em>et al.</em> [<a class="reference internal" href="../base/references.html#id16" title="I. Bondár, P. Mónus, C. Czanik, M. Kiszely, Z. Gráczer, Z. Wéber, and the AlpArrayWorking Group. Relocation of Seismicity in the Pannonian Basin Using a Global 3D Velocity Model. Seismol. Res. Lett., 6:2284 2293, 2018. doi:10.1785/0220180143.">36</a>]</span>)
with numerous new features added (<span id="id5">Bondár <em>et al.</em> [<a class="reference internal" href="../base/references.html#id16" title="I. Bondár, P. Mónus, C. Czanik, M. Kiszely, Z. Gráczer, Z. Wéber, and the AlpArrayWorking Group. Relocation of Seismicity in the Pannonian Basin Using a Global 3D Velocity Model. Seismol. Res. Lett., 6:2284 2293, 2018. doi:10.1785/0220180143.">36</a>]</span>).
The stand-alone iLoc code can be downloaded from the <span id="id6"></span>
algorithm developed by <span id="id2">Bondár and McLaughlin [<a class="reference internal" href="../base/references.html#id19" title="I. Bondár and K.L. McLaughlin. A new ground truth data set for seismic studies. Seismol. Res. Lett., 3:465 - 472, 2009. doi:10.1785/gssrl.80.3.465.">42</a>]</span> and implemented at the
International Seismological Center, (<span id="id3"><em>ISC</em> [<a class="reference internal" href="../base/references.html#id167" title="ISC. International Seismological Centre. URL: http://www.isc.ac.uk/.">13</a>]</span>, <span id="id4">Bondár <em>et al.</em> [<a class="reference internal" href="../base/references.html#id23" title="I. Bondár, P. Mónus, C. Czanik, M. Kiszely, Z. Gráczer, Z. Wéber, and the AlpArrayWorking Group. Relocation of Seismicity in the Pannonian Basin Using a Global 3D Velocity Model. Seismol. Res. Lett., 6:2284 2293, 2018. doi:10.1785/0220180143.">44</a>]</span>)
with numerous new features added (<span id="id5">Bondár <em>et al.</em> [<a class="reference internal" href="../base/references.html#id23" title="I. Bondár, P. Mónus, C. Czanik, M. Kiszely, Z. Gráczer, Z. Wéber, and the AlpArrayWorking Group. Relocation of Seismicity in the Pannonian Basin Using a Global 3D Velocity Model. Seismol. Res. Lett., 6:2284 2293, 2018. doi:10.1785/0220180143.">44</a>]</span>).
The stand-alone iLoc code can be downloaded from the <span id="id6"><em>iLoc source code</em> [<a class="reference internal" href="../base/references.html#id169" title="iLoc source code. GitHub. URL: https://github.com/IstvanBondar/iLoc.">34</a>]</span>
software repository.</p>
<p>Among the major advantages of using iLoc is that it can</p>
<ul class="simple">
@ -111,7 +111,7 @@ hypocenter depth;</p></li>
<ul class="simple">
<li><p>Originally developed for U.S. Air Force Research Laboratory, today the standard
at the International Seismological Centre (ISC) replacing previous routines</p></li>
<li><p>Open source, download website: <span id="id7"></span></p></li>
<li><p>Open source, download website: <span id="id7"><em>iLoc source code</em> [<a class="reference internal" href="../base/references.html#id169" title="iLoc source code. GitHub. URL: https://github.com/IstvanBondar/iLoc.">34</a>]</span></p></li>
<li><p>Integrated first in SeisComP3 in 2019</p></li>
<li><p>Basis of the EMSC crowd-source locator, CsLoc since 2019</p></li>
<li><p>EMSC standard as of 2022</p></li>
@ -137,12 +137,12 @@ Attempts for free-depth solution only if there is depth resolution</p></li>
<h3>Algorithms<a class="headerlink" href="#algorithms" title="Permalink to this heading"></a></h3>
<p>This section describes some of the principles. The full description of the applied
algorithms can be found in the iLoc documentation provided along with the package
on the <span id="id8"></span> website.</p>
on the <span id="id8"><em>iLoc source code</em> [<a class="reference internal" href="../base/references.html#id169" title="iLoc source code. GitHub. URL: https://github.com/IstvanBondar/iLoc.">34</a>]</span> website.</p>
<section id="neighbourhood-algorithm">
<h4>Neighbourhood algorithm<a class="headerlink" href="#neighbourhood-algorithm" title="Permalink to this heading"></a></h4>
<p>Linearized inversion algorithms are quite sensitive to the initial guess. In order
to find an initial hypocenter guess for the linearized inversion the Neigbourhood
Algorithm (<span id="id9">Sambridge [<a class="reference internal" href="../base/references.html#id73" title="M. Sambridge. Geophysical inversion with a neighbourhood algorithm. I. Searching the parameter space. Geophys. J. Int., 2:479 494, 1999. doi:10.1046/j.1365-246X.1999.00876.x.">60</a>]</span>; <span id="id10">Sambridge and Kennett [<a class="reference internal" href="../base/references.html#id74" title="M. Sambridge and B.L.N. Kennett. Seismic event location: non-linear inversion using a neighbourhood algorithm. Pure and Applied Geophysics, 151(1):241 257, 2001. doi:10.1007/PL00001158.">61</a>]</span>) is performed
Algorithm (<span id="id9">Sambridge [<a class="reference internal" href="../base/references.html#id94" title="M. Sambridge. Geophysical inversion with a neighbourhood algorithm. I. Searching the parameter space. Geophys. J. Int., 2:479 494, 1999. doi:10.1046/j.1365-246X.1999.00876.x.">69</a>]</span>; <span id="id10">Sambridge and Kennett [<a class="reference internal" href="../base/references.html#id95" title="M. Sambridge and B.L.N. Kennett. Seismic event location: non-linear inversion using a neighbourhood algorithm. Pure and Applied Geophysics, 151(1):241 257, 2001. doi:10.1007/PL00001158.">70</a>]</span>) is performed
around the starting hypocentre if <a class="reference internal" href="#confval-iLoc.profile.-name.DoGridSearch"><code class="xref std std-confval docutils literal notranslate"><span class="pre">iLoc.profile.$name.DoGridSearch</span></code></a> is active.</p>
<p>During the NA search, we identify the phases with respect to each trial hypocenter
and calculate the misfit of the trial hypocenter. The misfit is defined as the sum
@ -172,24 +172,24 @@ and to a lesser extent near-regional secondary phases. iLoc attempts for a free-
solution if the set of :term:arrivals meets at least one of the following conditions:</p>
<ul class="simple">
<li><p>Number of pairs of defining P and depth phases
<img class="math" src="../_images/math/cd836da15c805704a25218271107e7935265b89e.png" alt="\le"/> <a class="reference internal" href="#confval-iLoc.profile.-name.MinDepthPhases"><code class="xref std std-confval docutils literal notranslate"><span class="pre">iLoc.profile.$name.MinDepthPhases</span></code></a></p></li>
<img class="math" src="../_images/math/cd836da15c805704a25218271107e7935265b89e.svg" alt="\le"/> <a class="reference internal" href="#confval-iLoc.profile.-name.MinDepthPhases"><code class="xref std std-confval docutils literal notranslate"><span class="pre">iLoc.profile.$name.MinDepthPhases</span></code></a></p></li>
<li><p>Number of pairs of defining P and core phases
<img class="math" src="../_images/math/cd836da15c805704a25218271107e7935265b89e.png" alt="\le"/> <a class="reference internal" href="#confval-iLoc.profile.-name.MinCorePhases"><code class="xref std std-confval docutils literal notranslate"><span class="pre">iLoc.profile.$name.MinCorePhases</span></code></a></p></li>
<img class="math" src="../_images/math/cd836da15c805704a25218271107e7935265b89e.svg" alt="\le"/> <a class="reference internal" href="#confval-iLoc.profile.-name.MinCorePhases"><code class="xref std std-confval docutils literal notranslate"><span class="pre">iLoc.profile.$name.MinCorePhases</span></code></a></p></li>
<li><p>Number of pairs of defining P and S phases
<img class="math" src="../_images/math/cd836da15c805704a25218271107e7935265b89e.png" alt="\le"/> <a class="reference internal" href="#confval-iLoc.profile.-name.MinSPpairs"><code class="xref std std-confval docutils literal notranslate"><span class="pre">iLoc.profile.$name.MinSPpairs</span></code></a>
<img class="math" src="../_images/math/cd836da15c805704a25218271107e7935265b89e.svg" alt="\le"/> <a class="reference internal" href="#confval-iLoc.profile.-name.MinSPpairs"><code class="xref std std-confval docutils literal notranslate"><span class="pre">iLoc.profile.$name.MinSPpairs</span></code></a>
within a regional distance of <a class="reference internal" href="#confval-iLoc.profile.-name.MaxLocalDistDeg"><code class="xref std std-confval docutils literal notranslate"><span class="pre">iLoc.profile.$name.MaxLocalDistDeg</span></code></a>
degree</p></li>
<li><p>Number of defining P phases
<img class="math" src="../_images/math/cd836da15c805704a25218271107e7935265b89e.png" alt="\le"/> <a class="reference internal" href="#confval-iLoc.profile.-name.MinLocalStations"><code class="xref std std-confval docutils literal notranslate"><span class="pre">iLoc.profile.$name.MinLocalStations</span></code></a>
<img class="math" src="../_images/math/cd836da15c805704a25218271107e7935265b89e.svg" alt="\le"/> <a class="reference internal" href="#confval-iLoc.profile.-name.MinLocalStations"><code class="xref std std-confval docutils literal notranslate"><span class="pre">iLoc.profile.$name.MinLocalStations</span></code></a>
within a local distance of <a class="reference internal" href="#confval-iLoc.profile.-name.MinLocalStations"><code class="xref std std-confval docutils literal notranslate"><span class="pre">iLoc.profile.$name.MinLocalStations</span></code></a>
degree.</p></li>
</ul>
<p>If there is insufficient depth resolution provided by the data, or the depth uncertainty
for a free-depth solution exceeds a threshold, the hypocentre depth is set to the depth
from the default depth grid if a grid point for the epicentre location exists; otherwise
it is set to a depth <span id="id11">Bolton <em>et al.</em> [<a class="reference internal" href="../base/references.html#id9" title="M.K. Bolton, D.A. Storchak, and J. Harris. Updating default depth in the isc bulletin. Phys. Earth Planet. Int., 1:27 - 45, 2006. doi:10.1016/j.pepi.2006.03.004.">33</a>]</span> assigned to
it is set to a depth <span id="id11">Bolton <em>et al.</em> [<a class="reference internal" href="../base/references.html#id16" title="M.K. Bolton, D.A. Storchak, and J. Harris. Updating default depth in the isc bulletin. Phys. Earth Planet. Int., 1:27 - 45, 2006. doi:10.1016/j.pepi.2006.03.004.">41</a>]</span> assigned to
the corresponding Flinn-Engdahl geographic
region (<span id="id12">Young <em>et al.</em> [<a class="reference internal" href="../base/references.html#id86" title="J.B. Young, B.W. Presgrave, H. Aichele, D.A. Wiens, and E.A. Flinn. The Flinn-Engdahl Regionalisation Scheme: The 1995 revision. Phys. Earth Planet. Int., 96:223 - 297, 1996. doi:10.1016/0031-9201(96)03141-X.">66</a>]</span>). The default depth grid (<span id="id13">Bondár and Storchak [<a class="reference internal" href="../base/references.html#id14" title="I. Bondár and D. Storchak. Improved location procedures at the International Seismological Centre. Geophys. J. Int., 3:1220 1244, 2011. doi:10.1111/j.1365-246X.2011.05107.x.">37</a>]</span>)
region (<span id="id12">Young <em>et al.</em> [<a class="reference internal" href="../base/references.html#id109" title="J.B. Young, B.W. Presgrave, H. Aichele, D.A. Wiens, and E.A. Flinn. The Flinn-Engdahl Regionalisation Scheme: The 1995 revision. Phys. Earth Planet. Int., 96:223 - 297, 1996. doi:10.1016/0031-9201(96)03141-X.">75</a>]</span>). The default depth grid (<span id="id13">Bondár and Storchak [<a class="reference internal" href="../base/references.html#id21" title="I. Bondár and D. Storchak. Improved location procedures at the International Seismological Centre. Geophys. J. Int., 3:1220 1244, 2011. doi:10.1111/j.1365-246X.2011.05107.x.">45</a>]</span>)
is defined on a 0.5º x 0.5º grid as the median of all depths in the cell, provided
that there were at least five events in the cell, and the 7525 percent quartile
range was less than 100 km. The latter constraint is imposed to avoid regions with
@ -212,23 +212,23 @@ Finally, the user can fix the depth to the initial depth.</p>
<h4>Linearized inversion<a class="headerlink" href="#linearized-inversion" title="Permalink to this heading"></a></h4>
<p>Once the Neighbourhood search get close to the global optimum, iloc switches
to an iterative linearized least-squares inversion of travel-time, azimuth and
slowness observations (<span id="id14">Bondár and McLaughlin [<a class="reference internal" href="../base/references.html#id13" title="I. Bondár and K.L. McLaughlin. Seismic location bias and uncertainty in the presence of correlated and non-gaussian travel-time errors. Bull. Seismol. Soc. Am., 1:172 193, 2009. doi:10.1785/0120080922.">35</a>]</span>; <span id="id15">Bondár and Storchak [<a class="reference internal" href="../base/references.html#id14" title="I. Bondár and D. Storchak. Improved location procedures at the International Seismological Centre. Geophys. J. Int., 3:1220 1244, 2011. doi:10.1111/j.1365-246X.2011.05107.x.">37</a>]</span>) to obtain the final solution
slowness observations (<span id="id14">Bondár and McLaughlin [<a class="reference internal" href="../base/references.html#id20" title="I. Bondár and K.L. McLaughlin. Seismic location bias and uncertainty in the presence of correlated and non-gaussian travel-time errors. Bull. Seismol. Soc. Am., 1:172 193, 2009. doi:10.1785/0120080922.">43</a>]</span>; <span id="id15">Bondár and Storchak [<a class="reference internal" href="../base/references.html#id21" title="I. Bondár and D. Storchak. Improved location procedures at the International Seismological Centre. Geophys. J. Int., 3:1220 1244, 2011. doi:10.1111/j.1365-246X.2011.05107.x.">45</a>]</span>) to obtain the final solution
for the hypocenter.</p>
<p>The convergence test after (<span id="id16">Paige and Saunders [<a class="reference internal" href="../base/references.html#id59" title="C. Paige and M. Saunders. Lsqr: an algorithm for sparse linear equations and sparse least squares. ACM Transactions on Mathematical Software, 1:43 - 71, 1982. doi:10.1145/355984.355989.">54</a>]</span>) is
<p>The convergence test after (<span id="id16">Paige and Saunders [<a class="reference internal" href="../base/references.html#id77" title="C. Paige and M. Saunders. Lsqr: an algorithm for sparse linear equations and sparse least squares. ACM Transactions on Mathematical Software, 1:43 - 71, 1982. doi:10.1145/355984.355989.">63</a>]</span>) is
applied after every iteration. Once a convergent solution is obtained, the location
uncertainty is defined by the a posteriori model covariance matrix. The model
covariance matrix yields the four-dimensional error ellipsoid whose projections
provide the two-dimensional error ellipse and one-dimensional errors for depth
and origin time. These uncertainties are scaled to the 90% confidence level
(<span id="id17">Jordan and Sverdrup [<a class="reference internal" href="../base/references.html#id41" title="T.H. Jordan and K.A. Sverdrup. Teleseismic location techniques and their application to earthquake clusters in the south-central pacific. Bull. Seismol. Soc. Am., 4:1105 1130, 1981. doi:10.1785/BSSA0710041105.">47</a>]</span>).</p>
(<span id="id17">Jordan and Sverdrup [<a class="reference internal" href="../base/references.html#id56" title="T.H. Jordan and K.A. Sverdrup. Teleseismic location techniques and their application to earthquake clusters in the south-central pacific. Bull. Seismol. Soc. Am., 4:1105 1130, 1981. doi:10.1785/BSSA0710041105.">55</a>]</span>).</p>
<p>The final hypocentre is tested against the
ground truth selection criteria (<span id="id18">Bondár and McLaughlin [<a class="reference internal" href="../base/references.html#id12" title="I. Bondár and K.L. McLaughlin. A new ground truth data set for seismic studies. Seismol. Res. Lett., 3:465 - 472, 2009. doi:10.1785/gssrl.80.3.465.">34</a>]</span>),
ground truth selection criteria (<span id="id18">Bondár and McLaughlin [<a class="reference internal" href="../base/references.html#id19" title="I. Bondár and K.L. McLaughlin. A new ground truth data set for seismic studies. Seismol. Res. Lett., 3:465 - 472, 2009. doi:10.1785/gssrl.80.3.465.">42</a>]</span>),
and it is reported as
a GT5candidate if the solution meets the GT5 criteria.</p>
<p>Some important parameters are:</p>
<ul class="simple">
<li><p><a class="reference internal" href="#confval-iLoc.profile.-name.SigmaThreshold"><code class="xref std std-confval docutils literal notranslate"><span class="pre">iLoc.profile.$name.SigmaThreshold</span></code></a>: Residuals that exceed
<img class="math" src="../_images/math/07995ff78d6ae4e3ecb50d9c0740eb0addf47d94.png" alt="abs(Sigmathreshold * PriorMeasError)"/> are made non-defining.</p></li>
<img class="math" src="../_images/math/07995ff78d6ae4e3ecb50d9c0740eb0addf47d94.svg" alt="abs(Sigmathreshold * PriorMeasError)"/> are made non-defining.</p></li>
<li><p><a class="reference internal" href="#confval-iLoc.profile.-name.MinNdefPhases"><code class="xref std std-confval docutils literal notranslate"><span class="pre">iLoc.profile.$name.MinNdefPhases</span></code></a>: Minimum number of observations
required to attempt for a solution.</p></li>
</ul>
@ -241,7 +241,7 @@ be used in the location.</p>
<h3>Integration into <cite>SeisComP</cite><a class="headerlink" href="#integration-into-scname" title="Permalink to this heading"></a></h3>
<ul class="simple">
<li><p>Integration of iLoc into <cite>SeisComP</cite> is provided by an external library of
routines (<span id="id19"></span>).</p></li>
routines (<span id="id19"><em>iLoc source code</em> [<a class="reference internal" href="../base/references.html#id169" title="iLoc source code. GitHub. URL: https://github.com/IstvanBondar/iLoc.">34</a>]</span>).</p></li>
<li><p><cite>SeisComP</cite> modules call iLoc routines by passing the objects via the plugin
<em>lociloc</em> installed in <code class="file docutils literal notranslate"><span class="pre">&#64;DATADIR&#64;/plugins/lociloc.so</span></code>.</p></li>
<li><p>iLoc returns objects to <cite>SeisComP</cite> for integration.</p></li>
@ -252,27 +252,44 @@ the configuration in <cite>SeisComP</cite>.</p>
</section>
<section id="velocity-models">
<h3>Velocity models<a class="headerlink" href="#velocity-models" title="Permalink to this heading"></a></h3>
<p>iLoc ships with the global models <em>iasp91</em> and <em>ak135</em> as well as with regional
seismic travel-time tables, RSTT, which, if activated by configuration, replaces
the global models in areas where they are defined.</p>
<p>iLoc ships with the global velocity models <em>iasp91</em> and <em>ak135</em> as well as with
regional seismic travel-time tables, RSTT, which, if activated by configuration,
replace the global models in areas where they are defined.</p>
<section id="global-models">
<span id="iloc-velocity-global"></span><h4>Global models<a class="headerlink" href="#global-models" title="Permalink to this heading"></a></h4>
<p>The global models <em>iasp91</em> and <em>ak135</em> and RSTT are available by default without
further configuration.</p>
<p>The global Earth velocity models <em>iasp91</em> and <em>ak135</em> as well as <em>RSTT</em>
(section <a class="reference internal" href="#iloc-velocity-rstt"><span class="std std-ref">RSTT</span></a>) are available and applicable by default
without further configuration if the default iLoc profile names <em>iasp91</em>
and <em>ak135</em>, respectively, are considered. The same is true if explicit iLoc
profiles using <em>iasp91</em> or <em>ak135</em> for the profile names are added to the iLoc
configuration. Any other global model can be added, by explicitly adding an iLoc
profile as set out in section <a class="reference internal" href="#iloc-setup"><span class="std std-ref">Setup in SeisComP</span></a>. The respective model name is
configured in <a class="reference internal" href="#confval-iLoc.profile.-name.globalModel"><code class="xref std std-confval docutils literal notranslate"><span class="pre">iLoc.profile.$name.globalModel</span></code></a>.</p>
<p>Similar to <a class="reference internal" href="global_locsat.html#global-locsat"><span class="std std-ref">LOCSAT</span></a> the global models require travel-time tables for
each phase which is to be considered. The table files are located in
<a class="reference internal" href="#confval-iLoc.auxDir"><code class="xref std std-confval docutils literal notranslate"><span class="pre">iLoc.auxDir</span></code></a><code class="file docutils literal notranslate"><span class="pre">/[model</span> <span class="pre">name]</span></code>.</p>
<p>If available, corrections for Earths
ellipticity are considered from
<a class="reference internal" href="#confval-iLoc.auxDir"><code class="xref std std-confval docutils literal notranslate"><span class="pre">iLoc.auxDir</span></code></a><code class="file docutils literal notranslate"><span class="pre">/[model</span> <span class="pre">name]/ELCOR.dat</span></code>, e.g.,
<code class="file docutils literal notranslate"><span class="pre">&#64;DATADIR&#64;/iloc/iLocAuxDir/iasp91/ELCOR.dat</span></code>.</p>
</section>
<section id="rstt">
<span id="iloc-velocity-rstt"></span><h4>RSTT<a class="headerlink" href="#rstt" title="Permalink to this heading"></a></h4>
<p>RSTT are available in <code class="file docutils literal notranslate"><span class="pre">&#64;DATADIR&#64;/iloc/RSTTmodels/pdu202009Du.geotess</span></code>.
<p>RSTT are available in <code class="file docutils literal notranslate"><span class="pre">&#64;DATADIR&#64;/iloc/RSTTmodels/pdu202009Du.geotess</span></code> and
applied by default.
Custom RSTT can be integrated into iLoc and provided to <cite>SeisComP</cite>.
For adding custom RSTT to iLoc read the original iLoc documentation from the
<span id="id20"></span> software repository.</p>
<span id="id20"><em>iLoc source code</em> [<a class="reference internal" href="../base/references.html#id169" title="iLoc source code. GitHub. URL: https://github.com/IstvanBondar/iLoc.">34</a>]</span> software repository.</p>
<p>The usage of RSTT is controlled per iLoc profile by global configuration
parameters</p>
<ul class="simple">
<li><p><a class="reference internal" href="#confval-iLoc.profile.-name.UseRSTT"><code class="xref std std-confval docutils literal notranslate"><span class="pre">iLoc.profile.$name.UseRSTT</span></code></a></p></li>
<li><p><a class="reference internal" href="#confval-iLoc.profile.-name.UseRSTTPnSn"><code class="xref std std-confval docutils literal notranslate"><span class="pre">iLoc.profile.$name.UseRSTTPnSn</span></code></a></p></li>
<li><p><a class="reference internal" href="#confval-iLoc.profile.-name.UseRSTTPgLg"><code class="xref std std-confval docutils literal notranslate"><span class="pre">iLoc.profile.$name.UseRSTTPgLg</span></code></a></p></li>
<li><p><a class="reference internal" href="#confval-iLoc.profile.-name.UseRSTT"><code class="xref std std-confval docutils literal notranslate"><span class="pre">iLoc.profile.$name.UseRSTT</span></code></a>,</p></li>
<li><p><a class="reference internal" href="#confval-iLoc.profile.-name.UseRSTTPnSn"><code class="xref std std-confval docutils literal notranslate"><span class="pre">iLoc.profile.$name.UseRSTTPnSn</span></code></a>,</p></li>
<li><p><a class="reference internal" href="#confval-iLoc.profile.-name.UseRSTTPgLg"><code class="xref std std-confval docutils literal notranslate"><span class="pre">iLoc.profile.$name.UseRSTTPgLg</span></code></a>.</p></li>
</ul>
<p>In order to adjust these configuration parameters for the <em>iasp91</em>,
<em>ak135</em> or any other model, the profile must be added first as set out
in section <a class="reference internal" href="#iloc-setup"><span class="std std-ref">Setup in SeisComP</span></a>.</p>
</section>
<section id="local-velocity-models">
<span id="iloc-velocity-local"></span><h4>Local velocity models<a class="headerlink" href="#local-velocity-models" title="Permalink to this heading"></a></h4>
@ -290,8 +307,8 @@ parameters</p>
<span class="w"> </span><span class="na">77.500</span><span class="w"> </span><span class="s">8.0400 4.4800 x</span>
</pre></div>
</div>
<p>Once added, the velocity can be configured in <cite>SeisComP</cite> as set out in section
<a class="reference internal" href="#iloc-setup"><span class="std std-ref">Setup in SeisComP</span></a>.</p>
<p>Once added, the velocity can be configured along with iLoc profiles as set out
in section <a class="reference internal" href="#iloc-setup"><span class="std std-ref">Setup in SeisComP</span></a>.</p>
</section>
</section>
<section id="station-elevation">
@ -299,7 +316,7 @@ parameters</p>
<p>iLoc considers station elevation. It calculates the elevation correction,
<em>elevationCorrection</em>, for a station as</p>
<div class="math">
<p><img src="../_images/math/5f9c3c10facedc7a9d6e72dcdc5f421acb20e77c.png" alt="elevationCorrection = \frac{\sqrt{1 - (surfVel * p)^2} * elev}{surfVel}"/></p>
<p><img src="../_images/math/5f9c3c10facedc7a9d6e72dcdc5f421acb20e77c.svg" alt="elevationCorrection = \frac{\sqrt{1 - (surfVel * p)^2} * elev}{surfVel}"/></p>
</div><p>where</p>
<ul class="simple">
<li><p><em>elev</em>: elevation of the station</p></li>
@ -336,21 +353,21 @@ Read the section <a class="reference internal" href="../base/references.html#sec
</pre></div>
</div>
<p>In case the variable is undefined, follow the instructions in section
<span class="xref std std-ref">getting-started-variables</span>.</p>
<a class="reference internal" href="../base/getting-started.html#getting-started-variables"><span class="std std-ref">Environment variables</span></a>.</p>
<p>After <em>$SEISCOMP_ROOT</em> is defined you may install the software dependencies
for iLoc using the <a class="reference internal" href="../base/installation.html#software-dependencies"><span class="std std-ref">install scripts</span></a> or simply
the <a class="reference internal" href="seiscomp.html#seiscomp"><span class="std std-ref">seiscomp</span></a> script:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>seiscomp<span class="w"> </span>install-deps<span class="w"> </span>iloc
</pre></div>
</div>
<p>The install scripts will fetch auxiliary files from <span id="id21"></span>
<p>The install scripts will fetch auxiliary files from <span id="id21"><em>iLoc source code</em> [<a class="reference internal" href="../base/references.html#id169" title="iLoc source code. GitHub. URL: https://github.com/IstvanBondar/iLoc.">34</a>]</span>
and install them in <code class="file docutils literal notranslate"><span class="pre">&#64;DATADIR&#64;/iloc/iLocAuxDir</span></code>. For manual download and
installation read the install scripts located in
<code class="file docutils literal notranslate"><span class="pre">&#64;DATADIR&#64;/deps/[os]/[version]/install-iloc.sh</span></code>.</p>
<div class="admonition note">
<p class="admonition-title">Note</p>
<ul class="simple">
<li><p>Check the <span id="id22"></span> website for updates before downloading
<li><p>Check the <span id="id22"><em>iLoc source code</em> [<a class="reference internal" href="../base/references.html#id169" title="iLoc source code. GitHub. URL: https://github.com/IstvanBondar/iLoc.">34</a>]</span> website for updates before downloading
the file since the version number, hence the name of the download file
may change.</p></li>
<li><p>Instead of generating the <code class="file docutils literal notranslate"><span class="pre">SEISCOMP_ROOT/share/iloc/iLocAuxDir</span></code>
@ -459,8 +476,8 @@ phase is p or Pn and not P but <cite>SeisComP</cite> provides P.</p>
<dt class="sig sig-object std" id="confval-iLoc.auxDir">
<span class="sig-name descname"><span class="pre">iLoc.auxDir</span></span><a class="headerlink" href="#confval-iLoc.auxDir" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">&#64;DATADIR&#64;/iloc/iLocAuxDir</span></code></p>
<p>Type: <em>string</em></p>
<p>iLoc directory for auxialiary files and directories. Some
<p>Type: <em>directory</em></p>
<p>iLoc directory for auxiliary files and directories. Some
of them must be provided from the iLoc website. Read the
documentation for their installation.</p>
</dd></dl>
@ -490,9 +507,9 @@ is disabled.</p>
<span class="sig-name descname"><span class="pre">iLoc.profiles</span></span><a class="headerlink" href="#confval-iLoc.profiles" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">iasp91,ak135</span></code></p>
<p>Type: <em>list:string</em></p>
<p>iLoc profile name.
Multiples names may be set separated by comma.
Each profile can have different velocity or parameters.</p>
<p>List of iLoc profile name(s). Separate multiple names by comma.
Each profile can have different velocity or parameters. The
must be defined separate by iLoc profiles.</p>
</dd></dl>
<div class="admonition note">
@ -538,7 +555,7 @@ unset, the name of the profile is considered instead.</p>
<span class="sig-name descname"><span class="pre">iLoc.profile.$name.UseRSTT</span></span><a class="headerlink" href="#confval-iLoc.profile.-name.UseRSTT" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">false</span></code></p>
<p>Type: <em>boolean</em></p>
<p>Use regional seismic travel-time tables</p>
<p>Use regional seismic travel-time tables.</p>
</dd></dl>
<dl class="std confval">
@ -546,7 +563,7 @@ unset, the name of the profile is considered instead.</p>
<span class="sig-name descname"><span class="pre">iLoc.profile.$name.UseRSTTPnSn</span></span><a class="headerlink" href="#confval-iLoc.profile.-name.UseRSTTPnSn" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">true</span></code></p>
<p>Type: <em>boolean</em></p>
<p>Use regional seismic travel-time tables for Pn and Sn</p>
<p>Use regional seismic travel-time tables for Pn and Sn.</p>
</dd></dl>
<dl class="std confval">
@ -554,7 +571,7 @@ unset, the name of the profile is considered instead.</p>
<span class="sig-name descname"><span class="pre">iLoc.profile.$name.UseRSTTPgLg</span></span><a class="headerlink" href="#confval-iLoc.profile.-name.UseRSTTPgLg" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">true</span></code></p>
<p>Type: <em>boolean</em></p>
<p>Use regional seismic travel-time tables for Pg and Lg</p>
<p>Use regional seismic travel-time tables for Pg and Lg.</p>
</dd></dl>
<dl class="std confval">
@ -568,7 +585,7 @@ unset, the name of the profile is considered instead.</p>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-iLoc.profile.-name.LocalVmodel">
<span class="sig-name descname"><span class="pre">iLoc.profile.$name.LocalVmodel</span></span><a class="headerlink" href="#confval-iLoc.profile.-name.LocalVmodel" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<dd><p>Type: <em>file</em></p>
<p>Full path to a file containing the local velocity model.
Requires: UseLocalTT = true. Empty string or unset or
UseLocalTT = false disables using a local model in
@ -592,7 +609,7 @@ velocity model.</p>
<span class="sig-name descname"><span class="pre">iLoc.profile.$name.DoGridSearch</span></span><a class="headerlink" href="#confval-iLoc.profile.-name.DoGridSearch" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">true</span></code></p>
<p>Type: <em>boolean</em></p>
<p>Perform neighbourhood algorithm</p>
<p>Perform neighbourhood algorithm.</p>
</dd></dl>
<dl class="std confval">
@ -602,7 +619,7 @@ velocity model.</p>
<p>Type: <em>float</em></p>
<p>Unit: <em>deg</em></p>
<p>Neighbourhood Algorithm: Search radius around initial
epicentre</p>
epicentre.</p>
</dd></dl>
<dl class="std confval">
@ -612,7 +629,7 @@ epicentre</p>
<p>Type: <em>float</em></p>
<p>Unit: <em>km</em></p>
<p>Neighbourhood Algorithm: Search radius around initial
depth</p>
depth.</p>
</dd></dl>
<dl class="std confval">
@ -622,7 +639,7 @@ depth</p>
<p>Type: <em>float</em></p>
<p>Unit: <em>s</em></p>
<p>Neighbourhood Algorithm: Search radius around initial
origin time</p>
origin time.</p>
</dd></dl>
<dl class="std confval">
@ -630,49 +647,50 @@ origin time</p>
<span class="sig-name descname"><span class="pre">iLoc.profile.$name.NAlpNorm</span></span><a class="headerlink" href="#confval-iLoc.profile.-name.NAlpNorm" 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>float</em></p>
<p>Range: <code class="docutils literal notranslate"><span class="pre">1:2</span></code></p>
<p>Neighbourhood Algorithm: p-value for norm to compute
misfit [1,2]</p>
misfit.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-iLoc.profile.-name.NAiterMax">
<span class="sig-name descname"><span class="pre">iLoc.profile.$name.NAiterMax</span></span><a class="headerlink" href="#confval-iLoc.profile.-name.NAiterMax" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">5</span></code></p>
<p>Type: <em>integer</em></p>
<p>Neighbourhood Algorithm: Maximum number of iterations</p>
<p>Type: <em>int</em></p>
<p>Neighbourhood Algorithm: Maximum number of iterations.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-iLoc.profile.-name.NAcells">
<span class="sig-name descname"><span class="pre">iLoc.profile.$name.NAcells</span></span><a class="headerlink" href="#confval-iLoc.profile.-name.NAcells" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">25</span></code></p>
<p>Type: <em>integer</em></p>
<p>Type: <em>int</em></p>
<p>Neighbourhood Algorithm: Number of cells to be resampled
at each iteration</p>
at each iteration.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-iLoc.profile.-name.NAinitialSample">
<span class="sig-name descname"><span class="pre">iLoc.profile.$name.NAinitialSample</span></span><a class="headerlink" href="#confval-iLoc.profile.-name.NAinitialSample" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">1000</span></code></p>
<p>Type: <em>integer</em></p>
<p>Neighbourhood Algorithm: Size of initial sample</p>
<p>Type: <em>int</em></p>
<p>Neighbourhood Algorithm: Size of initial sample.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-iLoc.profile.-name.NAnextSample">
<span class="sig-name descname"><span class="pre">iLoc.profile.$name.NAnextSample</span></span><a class="headerlink" href="#confval-iLoc.profile.-name.NAnextSample" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">100</span></code></p>
<p>Type: <em>integer</em></p>
<p>Neighbourhood Algorithm: Size of subsequent samples</p>
<p>Type: <em>int</em></p>
<p>Neighbourhood Algorithm: Size of subsequent samples.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-iLoc.profile.-name.MinDepthPhases">
<span class="sig-name descname"><span class="pre">iLoc.profile.$name.MinDepthPhases</span></span><a class="headerlink" href="#confval-iLoc.profile.-name.MinDepthPhases" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">3</span></code></p>
<p>Type: <em>integer</em></p>
<p>Depth resolution: Minimum number of depth phases for depdp</p>
<p>Type: <em>int</em></p>
<p>Depth resolution: Minimum number of depth phases.</p>
</dd></dl>
<dl class="std confval">
@ -681,15 +699,15 @@ at each iteration</p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">0.2</span></code></p>
<p>Type: <em>float</em></p>
<p>Unit: <em>deg</em></p>
<p>Depth resolution: Maximum local distance</p>
<p>Depth resolution: Maximum local distance.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-iLoc.profile.-name.MinLocalStations">
<span class="sig-name descname"><span class="pre">iLoc.profile.$name.MinLocalStations</span></span><a class="headerlink" href="#confval-iLoc.profile.-name.MinLocalStations" 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>integer</em></p>
<p>Depth resolution: Minimum number of local defining stations</p>
<p>Type: <em>int</em></p>
<p>Depth resolution: Minimum number of local defining stations.</p>
</dd></dl>
<dl class="std confval">
@ -698,22 +716,23 @@ at each iteration</p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">2.0</span></code></p>
<p>Type: <em>float</em></p>
<p>Unit: <em>deg</em></p>
<p>Depth resolution: Maximum distance for using S-P travel-time differences.</p>
<p>Depth resolution: Maximum epicentral distance for
using S-P travel-time differences.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-iLoc.profile.-name.MinSPpairs">
<span class="sig-name descname"><span class="pre">iLoc.profile.$name.MinSPpairs</span></span><a class="headerlink" href="#confval-iLoc.profile.-name.MinSPpairs" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">3</span></code></p>
<p>Type: <em>integer</em></p>
<p>Depth resolution: Minimum number of defining S-P phase pairs</p>
<p>Type: <em>int</em></p>
<p>Depth resolution: Minimum number of defining S-P phase pairs.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-iLoc.profile.-name.MinCorePhases">
<span class="sig-name descname"><span class="pre">iLoc.profile.$name.MinCorePhases</span></span><a class="headerlink" href="#confval-iLoc.profile.-name.MinCorePhases" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">3</span></code></p>
<p>Type: <em>integer</em></p>
<p>Type: <em>int</em></p>
<p>Depth resolution: Minimum number of defining core reflection phases</p>
</dd></dl>
@ -723,7 +742,7 @@ at each iteration</p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">30.0</span></code></p>
<p>Type: <em>float</em></p>
<p>Unit: <em>km</em></p>
<p>Depth resolution: Maximum depth error for crustal free-depth</p>
<p>Depth resolution: Maximum depth error for crustal free-depth.</p>
</dd></dl>
<dl class="std confval">
@ -732,7 +751,7 @@ at each iteration</p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">60.0</span></code></p>
<p>Type: <em>float</em></p>
<p>Unit: <em>km</em></p>
<p>Depth resolution: Maximum depth error for deep free-depth</p>
<p>Depth resolution: Maximum depth error for deep free-depth.</p>
</dd></dl>
<dl class="std confval">
@ -740,7 +759,7 @@ at each iteration</p>
<span class="sig-name descname"><span class="pre">iLoc.profile.$name.DoCorrelatedErrors</span></span><a class="headerlink" href="#confval-iLoc.profile.-name.DoCorrelatedErrors" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">true</span></code></p>
<p>Type: <em>boolean</em></p>
<p>Linearized inversion: Account for correlated errors</p>
<p>Linearized inversion: Account for correlated errors.</p>
</dd></dl>
<dl class="std confval">
@ -749,7 +768,7 @@ at each iteration</p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">6.0</span></code></p>
<p>Type: <em>float</em></p>
<p>Unit: <em>s</em></p>
<p>Linearized inversion: Used to exclude big residuals from solution</p>
<p>Linearized inversion: Used to exclude big residuals from solution.</p>
</dd></dl>
<dl class="std confval">
@ -757,31 +776,31 @@ at each iteration</p>
<span class="sig-name descname"><span class="pre">iLoc.profile.$name.AllowDamping</span></span><a class="headerlink" href="#confval-iLoc.profile.-name.AllowDamping" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">true</span></code></p>
<p>Type: <em>boolean</em></p>
<p>Linearized inversion: Allow damping of model vector</p>
<p>Linearized inversion: Allow damping of model vector.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-iLoc.profile.-name.MinIterations">
<span class="sig-name descname"><span class="pre">iLoc.profile.$name.MinIterations</span></span><a class="headerlink" href="#confval-iLoc.profile.-name.MinIterations" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">4</span></code></p>
<p>Type: <em>integer</em></p>
<p>Linearized inversion: Minimum number of iterations</p>
<p>Type: <em>int</em></p>
<p>Linearized inversion: Minimum number of iterations.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-iLoc.profile.-name.MaxIterations">
<span class="sig-name descname"><span class="pre">iLoc.profile.$name.MaxIterations</span></span><a class="headerlink" href="#confval-iLoc.profile.-name.MaxIterations" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">20</span></code></p>
<p>Type: <em>integer</em></p>
<p>Linearized inversion: Maximum number of iterations</p>
<p>Type: <em>int</em></p>
<p>Linearized inversion: Maximum number of iterations.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-iLoc.profile.-name.MinNdefPhases">
<span class="sig-name descname"><span class="pre">iLoc.profile.$name.MinNdefPhases</span></span><a class="headerlink" href="#confval-iLoc.profile.-name.MinNdefPhases" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">4</span></code></p>
<p>Type: <em>integer</em></p>
<p>Linearized inversion: Minimum number of defining phases</p>
<p>Type: <em>int</em></p>
<p>Linearized inversion: Minimum number of defining phases.</p>
</dd></dl>
<dl class="std confval">
@ -876,7 +895,7 @@ profile.</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>LocExt &#8212; SeisComP Release documentation</title>
<title>LocExt &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -251,7 +251,7 @@ and path to a script separated by colon.</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>LocRouter &#8212; SeisComP Release documentation</title>
<title>LocRouter &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -239,7 +239,7 @@ as <a class="reference internal" href="scolv.html#scolv"><span class="std std-re
<dl class="std confval">
<dt class="sig sig-object std" id="confval-RouterLocator.regions">
<span class="sig-name descname"><span class="pre">RouterLocator.regions</span></span><a class="headerlink" href="#confval-RouterLocator.regions" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<dd><p>Type: <em>file</em></p>
<p>A GeoJSON or BNA file defining locator profiles by region.
Supported polygon attributes:</p>
<p>name: Name of polygon</p>
@ -338,7 +338,7 @@ Supported polygon attributes:</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>LOCSAT &#8212; SeisComP Release documentation</title>
<title>LOCSAT &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -87,22 +87,31 @@ source time and hypocenter coordinates from phase picks considering:</p>
<li><p>Phase-specfic travel-time tables.</p></li>
</ul>
<p>The LOCSAT <a class="reference internal" href="#locsat-li"><span class="std std-ref">locator interface</span></a> implements a wrapper for the
LocSAT locator by <span id="id1">Bratt and Nagy [<a class="reference internal" href="../base/references.html#id21" title="S.R. Bratt and W. Nagy. The LocSAT Program. Science Applications International Corporation (SAIC), San Diego, 1991.">42</a>]</span> (according to the README file shipped
LocSAT locator by <span id="id1">Bratt and Nagy [<a class="reference internal" href="../base/references.html#id32" title="S.R. Bratt and W. Nagy. The LocSAT Program. Science Applications International Corporation (SAIC), San Diego, 1991.">50</a>]</span> (according to the README file shipped
with the LocSAT distribution) referred to as <strong>LOCSAT</strong> in <cite>SeisComP</cite>. The LOCSAT
<a class="reference internal" href="#locsat-tti"><span class="std std-ref">travel-time interface</span></a> provides travel time for specfic
phases, epicentral distance, soure depth and station elevation.</p>
</section>
<section id="locator-interface">
<span id="locsat-li"></span><h2>Locator Interface<a class="headerlink" href="#locator-interface" title="Permalink to this heading"></a></h2>
<p>LOCSAT provides the hypocenter parameters through the locator interface.</p>
<p>LOCSAT provides the hypocenter parameters through the locator interface. Instead
of specifying an Earth model, LOCSAT queries travel times via the
<a class="reference internal" href="#locsat-tti"><span class="std std-ref">LOCSAT travel-time interface</span></a> which makes use of
<a class="reference internal" href="#locsat-ttt"><span class="std std-ref">pre-defined travel-time tables</span></a>. Note the
<span class="xref std std-ref">limitations</span>.</p>
<p>Use “LOCSAT” as a value for the locator interface along with a profile when
configurable, e.g., by <a class="reference internal" href="scolv.html#scolv"><span class="std std-ref">scolv</span></a>, <a class="reference internal" href="scautoloc.html#scautoloc"><span class="std std-ref">scautoloc</span></a> or <a class="reference internal" href="screloc.html#screloc"><span class="std std-ref">screloc</span></a>.</p>
</section>
<section id="travel-time-interface">
<span id="locsat-tti"></span><h2>Travel-Time Interface<a class="headerlink" href="#travel-time-interface" title="Permalink to this heading"></a></h2>
<p>LOCSAT provides an interface for computing travel times based on coordinates and
depth. The times are plotted on waveforms, e.g., blue marks in
<a class="reference internal" href="scolv.html#scolv-sec-waveform-review"><span class="std std-ref">scolv picker window</span></a>.</p>
<p>LOCSAT provides an interface for computing travel times based on station and
source coordinates with non-negative source depths. Note the
<span class="xref std std-ref">limitations</span>.</p>
<p>The travel times are used for predicting phase arrival times in various
applications such as <a class="reference internal" href="scautoloc.html#scautoloc"><span class="std std-ref">scautoloc</span></a> or <a class="reference internal" href="scolv.html#scolv"><span class="std std-ref">scolv</span></a>. The times are visualized,
e.g., as blue marks in the <a class="reference internal" href="scolv.html#scolv-sec-waveform-review"><span class="std std-ref">scolv picker window</span></a>.</p>
<p>Use “LOCSAT” as a value for the travel-time interface when configurable, e.g.,
by <a class="reference internal" href="global_fixedhypocenter.html#global-fixedhypocenter"><span class="std std-ref">FixedHypocenter</span></a>.</p>
by <a class="reference internal" href="global_fixedhypocenter.html#global-fixedhypocenter"><span class="std std-ref">FixedHypocenter</span></a> or <a class="reference internal" href="global_stdloc.html#global-stdloc"><span class="std std-ref">StdLoc</span></a>.</p>
</section>
<section id="travel-time-tables">
<span id="locsat-ttt"></span><h2>Travel-Time Tables<a class="headerlink" href="#travel-time-tables" title="Permalink to this heading"></a></h2>
@ -121,16 +130,18 @@ your <cite>SeisComP</cite> modules.</p>
<section id="limitations">
<h3>Limitations<a class="headerlink" href="#limitations" title="Permalink to this heading"></a></h3>
<ol class="arabic">
<li><p>The source depth is limited to non-negative values up to 800 km.</p></li>
<li><p>Only phases for which a travel-time table exists can be considered.</p></li>
<li><p>LOCSAT currently considers travel-time tables for phases which are hard-coded</p>
<ul>
<li><p>seismic body waves: P, Pg, Pb, Pn, Rg, pP, sP, PKP, PP, PKPab, PKPbc, PKPdf,
SKPdf, PcP,
S, Sg, Sb, Sn, Lg, SKS, SS, ScS,</p>
<p>where P and S are the direct P and S phases, respectively, at all distances
no matter the take-off angle at the source.</p>
<li><p>seismic body waves: P, Pb, Pg, Pn, pP, PP, PcP, PKiKP, PKIKP, PKKP, PKP,
PKPab, PKPbc, PKPdf, pPKPab, pPKPbc, pPKPdf,</p>
<p>S, Sb, Sg, Sn, sP, sS, SS, ScP, ScS, SKKP, SKP, SKPdf, SKS, SKSac, SKSdf,
sPKPab, sPKPbc, sPKPdf,</p>
<p>where P and S are the frist-arrival direct P and S phases, respectively, at
all distances no matter the take-off angle at the source.</p>
</li>
<li><p>seismic surface waves: LQ, LR.</p></li>
<li><p>seismic surface waves: LQ, LR, Lg, Rg.</p></li>
<li><p>infrasound: Is, It, Iw.</p></li>
</ul>
</li>
@ -152,12 +163,12 @@ travel-time tables may lead to undesired behavior during location.</p></li>
</li>
<li><p>The considered minimum depth is 0 km. Elevations and depths above datum are
not natively considered. The effects of station elevation can be
<a class="reference internal" href="#locsat-station-elevation"><span class="std std-ref">corrected for empirically</span></a>.</p></li>
<a class="reference internal" href="#locsat-station-elevation"><span class="std std-ref">empirically corrected for</span></a>.</p></li>
</ol>
</section>
<section id="station-elevations">
<span id="locsat-station-elevation"></span><h3>Station elevations<a class="headerlink" href="#station-elevations" title="Permalink to this heading"></a></h3>
<p>LOCSAT does not natively support corrections of travel-time tables for station
<p>LOCSAT does not natively support corrections of travel times for station
elevations. At least checking the code:</p>
<div class="highlight-c notranslate"><div class="highlight"><pre><span></span><span class="n">sta_cor</span><span class="p">[</span><span class="n">i</span><span class="p">]</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mf">0.0</span><span class="p">;</span><span class="w"> </span><span class="cm">/* FIX !!!!!!*/</span>
</pre></div>
@ -165,29 +176,46 @@ elevations. At least checking the code:</p>
<p>However, the <cite>SeisComP</cite> wrapper adds this feature. It allows to define a
<code class="file docutils literal notranslate"><span class="pre">.stacor</span></code> file which defines emperic corrections of observed travel times.
The corrections are provided in seconds and <strong>subtracted</strong> (not added) from
the observation time to be compatible with the NonLinLoc <span id="id2">[<a class="reference internal" href="../base/references.html#id171" title="A. Lomax. The NonLinLoc Software Guide. Manual. URL: http://alomax.free.fr/nlloc/.">52</a>]</span>
the observation time to be compatible with the NonLinLoc <span id="id2">[<a class="reference internal" href="../base/references.html#id200" title="A. Lomax. The NonLinLoc Software Guide. Manual. URL: http://alomax.free.fr/nlloc/.">60</a>]</span>
station correction definitions.</p>
<p>Each LOCSAT profile (travel time table) can have one associated station
correction file. E.g. for adding station corrections to the iasp91 tables, the
file <code class="file docutils literal notranslate"><span class="pre">$SEISCOMP_ROOT/share/locsat/tables/iasp91.stacor</span></code> needs to be created.</p>
<p>A station correction table takes the form:</p>
<div class="highlight-params notranslate"><div class="highlight"><pre><span></span># LOCDELAY code phase numReadings delay
LOCDELAY GE.MORC P 1 -0.1
file <code class="file docutils literal notranslate"><span class="pre">$SEISCOMP_ROOT/share/locsat/tables/iasp91.stacor</span></code> needs to be
created.</p>
<p>Station correction files take the form (example):</p>
<div class="highlight-properties notranslate"><div class="highlight"><pre><span></span><span class="c1"># LOCDELAY code phase numReadings delay</span>
<span class="na">LOCDELAY</span><span class="w"> </span><span class="s">GE.MORC P 1 0.15</span>
<span class="na">LOCDELAY</span><span class="w"> </span><span class="s">IU.ANMO.00 P 1 0.36</span>
<span class="na">LOCDELAY</span><span class="w"> </span><span class="s">IU.KONO.20 P 1 -0.03</span>
</pre></div>
</div>
<p>with</p>
<ul class="simple">
<li><p><strong>code</strong> (<em>string</em>) station code (after all alias evaluations)</p></li>
<li><p><strong>phase</strong> (<em>string</em>) phase type (any of the available travel time tables)</p></li>
<li><p><strong>numReadings</strong> (<em>integer</em>) number of residuals used to calculate mean residual/delay
(not used by NLLoc, included for compatibility with the format of a summary,
phase statistics file)</p></li>
<li><p><strong>delay</strong> (<em>float</em>) delay in seconds, subtracted from observed time</p></li>
<ul>
<li><p><strong>LOCDELAY</strong>: Required fixed string.</p></li>
<li><p><strong>code</strong> (<em>string</em>): Stream code (after all alias evaluations) up to sensor
location code with network and station code as a minium. Exception: If only
a station code is given, then only the station code is checked. This is a
fallback for data centers ignoring network codes and should be used
exceptionally only.</p>
<p>Network, station and
sensor location codes are separated by .. If no sensor location is given, an
empty code is assumed. Wildcards are not supported.</p>
</li>
<li><p><strong>phase</strong> (<em>string</em>): Phase type (any of the available travel time tables)</p></li>
<li><p><strong>numReadings</strong> (<em>integer</em>): Number of residuals used to calculate mean
residual/delay. Not used by LOCSAT, included for compatibility reasons with
<a class="reference internal" href="global_nonlinloc.html#global-nonlinloc"><span class="std std-ref">NonLinLoc</span></a></p></li>
<li><p><strong>delay</strong> (<em>float</em>): Delay in seconds, subtracted from observed time.</p></li>
</ul>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>The fourth column (numReadings) is ignored and just provided for compatibility
reasons with <a class="reference internal" href="global_nonlinloc.html#global-nonlinloc"><span class="std std-ref">NonLinLoc</span></a>.</p>
<ul class="simple">
<li><p>Station corrections are only considered by the locator, not the travel-time
interface. Therefore, they do not find application for locating by
<a class="reference internal" href="global_fixedhypocenter.html#global-fixedhypocenter"><span class="std std-ref">FixedHypocenter</span></a> or for phase association in <a class="reference internal" href="scautoloc.html#scautoloc"><span class="std std-ref">scautoloc</span></a>.</p></li>
<li><p>The example file for station corrections above reflect the format not any
empirically derived relationship and the values themselves have no meaning.</p></li>
</ul>
</div>
</section>
</section>
@ -201,16 +229,16 @@ default profile. However, LOCSAT can be used optionally in other modules such as
<ol class="arabic">
<li><p>Generate your travel-time tables from a custom Earth model, depth and
distance intervals. Use the same format as the defaults as the <em>iasp91</em>
tables. Tools such as <span id="id3"><em>TauP</em> [<a class="reference internal" href="../base/references.html#id274" title="TauP. Toolkit for seismic travel times. URL: https://www.seis.sc.edu/taup/.">25</a>]</span> allow the generation.</p></li>
tables. Tools such as <span id="id3"><em>TauP</em> [<a class="reference internal" href="../base/references.html#id309" title="TauP. Toolkit for seismic travel times. URL: https://www.seis.sc.edu/taup/.">28</a>]</span> allow the generation.</p></li>
<li><p>Add your custom travel-time tables along with station corrections to
<code class="file docutils literal notranslate"><span class="pre">&#64;DATADIR&#64;/locsat/tables/</span></code></p></li>
<li><p>Add your available custom LOCSAT travel-time tables in global configuration,
e.g., to the list of tables of travel-time interfaces</p>
<div class="highlight-params notranslate"><div class="highlight"><pre><span></span>ttt.LOCSAT.tables = iasp91, tab, custom
<div class="highlight-properties notranslate"><div class="highlight"><pre><span></span><span class="na">ttt.LOCSAT.tables</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">iasp91, tab, custom</span>
</pre></div>
</div>
<p>and to the list of locator profiles</p>
<div class="highlight-params notranslate"><div class="highlight"><pre><span></span>LOCSAT.profiles = iasp91, tab, custom
<div class="highlight-properties notranslate"><div class="highlight"><pre><span></span><span class="na">LOCSAT.profiles</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">iasp91, tab, custom</span>
</pre></div>
</div>
<p>and optionally to locators which make use of LOCSAT tables, e.g.,
@ -416,7 +444,7 @@ controlled with this parameter.</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>mb &#8212; SeisComP Release documentation</title>
<title>mb &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -95,7 +95,7 @@ in the global bindings.</p>
<h3>Station Magnitude<a class="headerlink" href="#station-magnitude" title="Permalink to this heading"></a></h3>
<p>The general formula is</p>
<div class="math">
<p><img src="../_images/math/557ff47b5e6e082cc7dd08a231e296efbdf54331.png" alt="mb = \log \left(\frac{A}{T}\right) + Q(h,\Delta) - 3.0"/></p>
<p><img src="../_images/math/557ff47b5e6e082cc7dd08a231e296efbdf54331.svg" alt="mb = \log \left(\frac{A}{T}\right) + Q(h,\Delta) - 3.0"/></p>
</div><p>with A as the displacement amplitude in micrometers, T as the dominant period of
the signal in seconds, Q as a correction term for depth and distance. mb is
usually determined at periods around 1s in adaptation to the use
@ -111,17 +111,17 @@ used for the magnitude calculation.</p>
<ul class="simple">
<li><p>Amplitude unit in <cite>SeisComP</cite>: <strong>nanometers</strong> (nm)</p></li>
<li><p>Time window: 30 s</p></li>
<li><p>Default distance range: 5 - 105 deg, configurable: <a class="reference internal" href="global.html#confval-magnitudes.mb.minDist"><code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.mb.minDist</span></code></a>,
<a class="reference internal" href="global.html#confval-magnitudes.mb.maxDist"><code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.mb.maxDist</span></code></a></p></li>
<li><p>Default distance range: 5 - 105 deg, configurable: <code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.mb.minDist</span></code>,
<code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.mb.maxDist</span></code></p></li>
<li><p>Depth range: no limitation, for depth &lt; 0 km, depth = 0 km is assumed</p></li>
</ul>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>In 2013 the IASPEI commission (<span id="id1">IASPEI [<a class="reference internal" href="../base/references.html#id40" title="IASPEI. Summary of magnitude working group recommendations on standard procedures for determining earthquake magnitudes from digital data. IASPEI Website, 2013. URL: http://www.iaspei.org/commissions/commission-on-seismological-observation-and-interpretation/Summary_WG_recommendations_20130327.pdf.">46</a>]</span>) recommended a minimum distance of
<p>In 2013 the IASPEI commission (<span id="id1">IASPEI [<a class="reference internal" href="../base/references.html#id55" title="IASPEI. Summary of magnitude working group recommendations on standard procedures for determining earthquake magnitudes from digital data. IASPEI Website, 2013. URL: http://www.iaspei.org/commissions/commission-on-seismological-observation-and-interpretation/Summary_WG_recommendations_20130327.pdf.">54</a>]</span>) recommended a minimum distance of
20 deg. However, <a class="reference internal" href="scautoloc.html#scautoloc"><span class="std std-ref">scautoloc</span></a> requires mb amplitudes by default for
considering a pick.
For maintaining consistency, 5 deg is therefore kept as the default
for <a class="reference internal" href="global.html#confval-magnitudes.mb.minDist"><code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.mb.minDist</span></code></a>.</p>
for <code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.mb.minDist</span></code>.</p>
</div>
</section>
<section id="network-magnitude">
@ -204,7 +204,7 @@ for visibility.</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>mB_BB &#8212; SeisComP Release documentation</title>
<title>mB_BB &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -78,58 +78,58 @@
<section id="description">
<h2>Description<a class="headerlink" href="#description" title="Permalink to this heading"></a></h2>
<p>The <strong>mB</strong>/<strong>mB_BB</strong> magnitude has been recommended by the IASPEI commission
(<span id="id1">Bormann and Saul [<a class="reference internal" href="../base/references.html#id18" title="P. Bormann and J. Saul. The new iaspei standard broadband magnitude mb. Seismol. Res. Lett., 5:698 - 705, 2008. doi:10.1785/gssrl.79.5.698.">38</a>]</span>, <span id="id2">Bormann and Saul [<a class="reference internal" href="../base/references.html#id19" title="P. Bormann and J. Saul. A Fast, Non-saturating Magnitude Estimator for Great Earthquakes. Seismol. Res. Lett., 80(5):808 - 816, 2009. doi:10.1785/gssrl.80.5.808.">39</a>]</span>, <span id="id3">IASPEI [<a class="reference internal" href="../base/references.html#id40" title="IASPEI. Summary of magnitude working group recommendations on standard procedures for determining earthquake magnitudes from digital data. IASPEI Website, 2013. URL: http://www.iaspei.org/commissions/commission-on-seismological-observation-and-interpretation/Summary_WG_recommendations_20130327.pdf.">46</a>]</span>).
(<span id="id1">Bormann and Saul [<a class="reference internal" href="../base/references.html#id28" title="P. Bormann and J. Saul. The new iaspei standard broadband magnitude mb. Seismol. Res. Lett., 5:698 - 705, 2008. doi:10.1785/gssrl.79.5.698.">46</a>]</span>, <span id="id2">Bormann and Saul [<a class="reference internal" href="../base/references.html#id29" title="P. Bormann and J. Saul. A Fast, Non-saturating Magnitude Estimator for Great Earthquakes. Seismol. Res. Lett., 80(5):808 - 816, 2009. doi:10.1785/gssrl.80.5.808.">47</a>]</span>, <span id="id3">IASPEI [<a class="reference internal" href="../base/references.html#id55" title="IASPEI. Summary of magnitude working group recommendations on standard procedures for determining earthquake magnitudes from digital data. IASPEI Website, 2013. URL: http://www.iaspei.org/commissions/commission-on-seismological-observation-and-interpretation/Summary_WG_recommendations_20130327.pdf.">54</a>]</span>).
It is based on amplitude measurements of body waves like <a class="reference internal" href="global_mb.html#global-mb"><span class="std std-ref">mb</span></a>, but
with the amplitude measured in a broad frequency range and longer time windows.
Instead of amplitude measurements on displacement data together with the
dominant period, the maximum velocity amplitude Vmax is taken directly from
velocity-proportional records with <img class="math" src="../_images/math/3e38ca2d603956fc616a5148453d32f873cfdbd0.png" alt="V = 2 \pi A/T"/>. The time window for
velocity-proportional records with <img class="math" src="../_images/math/3e38ca2d603956fc616a5148453d32f873cfdbd0.svg" alt="V = 2 \pi A/T"/>. The time window for
the measurement can be determined by the duration of the high-frequency (1-3 Hz)
radiation (<span id="id4">Bormann and Saul [<a class="reference internal" href="../base/references.html#id18" title="P. Bormann and J. Saul. The new iaspei standard broadband magnitude mb. Seismol. Res. Lett., 5:698 - 705, 2008. doi:10.1785/gssrl.79.5.698.">38</a>]</span>). This time window usually contains the phases
radiation (<span id="id4">Bormann and Saul [<a class="reference internal" href="../base/references.html#id28" title="P. Bormann and J. Saul. The new iaspei standard broadband magnitude mb. Seismol. Res. Lett., 5:698 - 705, 2008. doi:10.1785/gssrl.79.5.698.">46</a>]</span>). This time window usually contains the phases
P, pP, sP, PcP, but not PP. According to the long time window and broad
frequency range used for amplitude measurements mB saturates not like mb.</p>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>In <cite>SeisComP</cite> the term <strong>m_B</strong> is a synonym for <strong>mB_BB</strong> which is used
by IASPEI <span id="id5">[<a class="reference internal" href="../base/references.html#id40" title="IASPEI. Summary of magnitude working group recommendations on standard procedures for determining earthquake magnitudes from digital data. IASPEI Website, 2013. URL: http://www.iaspei.org/commissions/commission-on-seismological-observation-and-interpretation/Summary_WG_recommendations_20130327.pdf.">46</a>]</span>.</p>
by IASPEI <span id="id5">[<a class="reference internal" href="../base/references.html#id55" title="IASPEI. Summary of magnitude working group recommendations on standard procedures for determining earthquake magnitudes from digital data. IASPEI Website, 2013. URL: http://www.iaspei.org/commissions/commission-on-seismological-observation-and-interpretation/Summary_WG_recommendations_20130327.pdf.">54</a>]</span>.</p>
</div>
<section id="amplitude">
<h3>Amplitude<a class="headerlink" href="#amplitude" title="Permalink to this heading"></a></h3>
<p>mB amplitudes are calculated on vertical-component displacement seismograms
in accordance with <span id="id6">Bormann and Saul [<a class="reference internal" href="../base/references.html#id18" title="P. Bormann and J. Saul. The new iaspei standard broadband magnitude mb. Seismol. Res. Lett., 5:698 - 705, 2008. doi:10.1785/gssrl.79.5.698.">38</a>]</span> and similar to <a class="reference internal" href="global_mb.html#global-mb"><span class="std std-ref">mb</span></a>.
in accordance with <span id="id6">Bormann and Saul [<a class="reference internal" href="../base/references.html#id28" title="P. Bormann and J. Saul. The new iaspei standard broadband magnitude mb. Seismol. Res. Lett., 5:698 - 705, 2008. doi:10.1785/gssrl.79.5.698.">46</a>]</span> and similar to <a class="reference internal" href="global_mb.html#global-mb"><span class="std std-ref">mb</span></a>.
A default time window of 60 s is considered for amplitude measurements
at stations in the distance range of 5° to 105°.
If the epicentral is known, the length of the time window after the P wave onset
is</p>
<div class="math">
<p><img src="../_images/math/9d9190e1e9d976d40144e676d30933251d58b7a0.png" alt="t = min(\Delta * 11.5, 60)"/></p>
</div><p>where <img class="math" src="../_images/math/6450616b75212cb568e905db49efd0c3dd584648.png" alt="\Delta"/> is the epicentral distance. The methods for measuring
<p><img src="../_images/math/9d9190e1e9d976d40144e676d30933251d58b7a0.svg" alt="t = min(\Delta * 11.5, 60)"/></p>
</div><p>where <img class="math" src="../_images/math/6450616b75212cb568e905db49efd0c3dd584648.svg" alt="\Delta"/> is the epicentral distance. The methods for measuring
amplitudes are configurable in the global bindings.</p>
</section>
<section id="station-magnitude">
<h3>Station Magnitude<a class="headerlink" href="#station-magnitude" title="Permalink to this heading"></a></h3>
<p>The mB station magnitudes are calculated in accordance with <span id="id7">Bormann and Saul [<a class="reference internal" href="../base/references.html#id18" title="P. Bormann and J. Saul. The new iaspei standard broadband magnitude mb. Seismol. Res. Lett., 5:698 - 705, 2008. doi:10.1785/gssrl.79.5.698.">38</a>]</span>.</p>
<p>The mB station magnitudes are calculated in accordance with <span id="id7">Bormann and Saul [<a class="reference internal" href="../base/references.html#id28" title="P. Bormann and J. Saul. The new iaspei standard broadband magnitude mb. Seismol. Res. Lett., 5:698 - 705, 2008. doi:10.1785/gssrl.79.5.698.">46</a>]</span>.</p>
<div class="math">
<p><img src="../_images/math/c4e29d7f89b54eff7de102b648e87d8c0f96afd6.png" alt="mB = \log \left(\frac{A}{2\Pi}\right) + Q(h,\Delta) - 3.0"/></p>
<p><img src="../_images/math/c4e29d7f89b54eff7de102b648e87d8c0f96afd6.svg" alt="mB = \log \left(\frac{A}{2\Pi}\right) + Q(h,\Delta) - 3.0"/></p>
</div><p>with A as the displacement amplitude in micrometers, T as the dominant period of
the signal in seconds, Q as a correction term for depth and distance.</p>
<ul class="simple">
<li><p>Amplitude unit in <cite>SeisComP</cite>: <strong>nanometers/s</strong> (nm/s),</p></li>
<li><p>Time window: 60 s if set by <a class="reference internal" href="scautopick.html#scautopick"><span class="std std-ref">scautopick</span></a>, otherwise 0 s - 11.5 * distance
(deg) with 60 s minimum</p></li>
<li><p>Default distance range: 5 - 105 deg, configurable: <a class="reference internal" href="global.html#confval-magnitudes.mB.minDist"><code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.mB.minDist</span></code></a>,
<a class="reference internal" href="global.html#confval-magnitudes.mB.maxDist"><code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.mB.maxDist</span></code></a>,</p></li>
<li><p>Default distance range: 5 - 105 deg, configurable: <code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.mB.minDist</span></code>,
<code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.mB.maxDist</span></code>,</p></li>
<li><p>Depth range: no limitation.</p></li>
</ul>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>In 2013 the IASPEI commission (<span id="id8">IASPEI [<a class="reference internal" href="../base/references.html#id40" title="IASPEI. Summary of magnitude working group recommendations on standard procedures for determining earthquake magnitudes from digital data. IASPEI Website, 2013. URL: http://www.iaspei.org/commissions/commission-on-seismological-observation-and-interpretation/Summary_WG_recommendations_20130327.pdf.">46</a>]</span>) recommended a minimum
<p>In 2013 the IASPEI commission (<span id="id8">IASPEI [<a class="reference internal" href="../base/references.html#id55" title="IASPEI. Summary of magnitude working group recommendations on standard procedures for determining earthquake magnitudes from digital data. IASPEI Website, 2013. URL: http://www.iaspei.org/commissions/commission-on-seismological-observation-and-interpretation/Summary_WG_recommendations_20130327.pdf.">54</a>]</span>) recommended a minimum
distance of
20 deg. However, the calibration formula (<span id="id9">Bormann and Saul [<a class="reference internal" href="../base/references.html#id18" title="P. Bormann and J. Saul. The new iaspei standard broadband magnitude mb. Seismol. Res. Lett., 5:698 - 705, 2008. doi:10.1785/gssrl.79.5.698.">38</a>]</span>) which is
20 deg. However, the calibration formula (<span id="id9">Bormann and Saul [<a class="reference internal" href="../base/references.html#id28" title="P. Bormann and J. Saul. The new iaspei standard broadband magnitude mb. Seismol. Res. Lett., 5:698 - 705, 2008. doi:10.1785/gssrl.79.5.698.">46</a>]</span>) which is
integrated in
<cite>SeisComP</cite> allows the extension down to 5 deg while maintaining consistent magnitudes
at 20 deg and beyond. Therefore, 5 deg is used as the default in
<a class="reference internal" href="global.html#confval-magnitudes.mB.minDist"><code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.mB.minDist</span></code></a>.</p>
<code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.mB.minDist</span></code>.</p>
</div>
</section>
<section id="network-magnitude">
@ -211,7 +211,7 @@ in the configuration of
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>mb_IDC &#8212; SeisComP Release documentation</title>
<title>mb_IDC &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -88,7 +88,7 @@ between 0.8 and 4.5 Hz and converted to displacement.</p>
<section id="station-magnitude">
<h3>Station Magnitude<a class="headerlink" href="#station-magnitude" title="Permalink to this heading"></a></h3>
<div class="math">
<p><img src="../_images/math/be87b4ff8e5530b3bf22b3e2f2d2f23b57c93bf4.png" alt="mag = \log10(\frac{A}{T}) + Q(\Delta,h)"/></p>
<p><img src="../_images/math/be87b4ff8e5530b3bf22b3e2f2d2f23b57c93bf4.svg" alt="mag = \log10(\frac{A}{T}) + Q(\Delta,h)"/></p>
</div><p>with</p>
<p>A: amplitude of type A5/2</p>
<p>T: period of the signal in seconds</p>
@ -108,7 +108,7 @@ will be calculated.</p>
<section id="station-corrections">
<h3>Station corrections<a class="headerlink" href="#station-corrections" title="Permalink to this heading"></a></h3>
<p>Station magnitudes can be computed with a station specific correction table
which is configured in the global bindings. The parameter <a class="reference internal" href="global.html#confval-magnitudes.mb-IDC-.Q"><code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.mb(IDC).Q</span></code></a>
which is configured in the global bindings. The parameter <code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.mb(IDC).Q</span></code>
takes a path and allows to use placeholders for network code (<code class="code docutils literal notranslate"><span class="pre">{net}</span></code>),
station code (<code class="code docutils literal notranslate"><span class="pre">{sta}</span></code>) and location code (<code class="code docutils literal notranslate"><span class="pre">{loc}</span></code>).</p>
<p>Example:</p>
@ -186,7 +186,7 @@ station code (<code class="code docutils literal notranslate"><span class="pre">
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>Md &#8212; SeisComP Release documentation</title>
<title>Md &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -108,7 +108,7 @@ the time difference between Coda time and P arrival time is stored as Coda durat
the generic formula is applied and the duration magnitude is computed
for a given station, if it fits the criteria (max depth, max distance).</p>
<div class="math">
<p><img src="../_images/math/a3010f147479b84f14b15be9438d4940ab36bca0.png" alt="mag = FMA + FMB \times \log10(period) + (FMF \times period) + (FMD \times epidistkm) + (FMZ \times depth) + STACOR"/></p>
<p><img src="../_images/math/a3010f147479b84f14b15be9438d4940ab36bca0.svg" alt="mag = FMA + FMB \times \log10(period) + (FMF \times period) + (FMD \times epidistkm) + (FMZ \times depth) + STACOR"/></p>
</div></section>
</section>
<section id="plugin">
@ -193,7 +193,7 @@ It provides a new implementations of AmplitudeProcessor and MagnitudeProcessor.<
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>ML &#8212; SeisComP Release documentation</title>
<title>ML &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -78,14 +78,14 @@
<section id="description">
<h2>Description<a class="headerlink" href="#description" title="Permalink to this heading"></a></h2>
<p>ML is the standard local (Richter) magnitude originally designed for
Southern California by <span id="id1">Richter [<a class="reference internal" href="../base/references.html#id62" title="C.F. Richter. An instrumental earthquake magnitude scale. Bull. Seismol. Soc. Am., 1:1 - 32, 1935. URL: https://resolver.caltech.edu/CaltechAUTHORS:20140804-143558638, doi:10.1785/BSSA0250010001.">57</a>]</span>.</p>
Southern California by <span id="id1">Richter [<a class="reference internal" href="../base/references.html#id81" title="C.F. Richter. An instrumental earthquake magnitude scale. Bull. Seismol. Soc. Am., 1:1 - 32, 1935. URL: https://resolver.caltech.edu/CaltechAUTHORS:20140804-143558638, doi:10.1785/BSSA0250010001.">66</a>]</span>.</p>
<p>General (default) conditions apply:</p>
<ul class="simple">
<li><p>Amplitude unit in SeisComP: <strong>millimeter</strong> (mm) by simulation of a <a class="reference internal" href="../base/glossary.html#term-Wood-Anderson-seismometer"><span class="xref std std-term">Wood-Anderson seismometer</span></a>.</p></li>
<li><p>Time window, configurable: 150 s by <a class="reference internal" href="scautopick.html#scautopick"><span class="std std-ref">scautopick</span></a> or distance dependent, configurable.</p></li>
<li><p>Distance type: epicentral distance.</p></li>
<li><p>Distance range: 0 - 8 deg, maximum is configurable:
<a class="reference internal" href="global.html#confval-magnitudes.ML.maxDistanceKm"><code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.ML.maxDistanceKm</span></code></a>,
<code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.ML.maxDist</span></code>,
measurements beyond 8 deg will be strictly ignored.</p></li>
<li><p>Depth range: 0 - 80 km, configurable for amplitude measurements.</p></li>
</ul>
@ -101,15 +101,15 @@ amplitudes are configurable in the global bindings.</p>
<h3>Station Magnitudes<a class="headerlink" href="#station-magnitudes" title="Permalink to this heading"></a></h3>
<p>The individual station ML is calculated using the following formula:</p>
<div class="math">
<p><img src="../_images/math/2ac00af8e0cff8bc51992386e723083d633de181.png" alt="ML = \log10(A) - \log10(A0)"/></p>
<p><img src="../_images/math/2ac00af8e0cff8bc51992386e723083d633de181.svg" alt="ML = \log10(A) - \log10(A0)"/></p>
</div><p><em>A</em> is the measured ML Wood-Anderson amplitude in millimeters. The second term
is the empirical calibration function, which in turn is a function
of the epicentral distance (<span id="id2">Richter [<a class="reference internal" href="../base/references.html#id62" title="C.F. Richter. An instrumental earthquake magnitude scale. Bull. Seismol. Soc. Am., 1:1 - 32, 1935. URL: https://resolver.caltech.edu/CaltechAUTHORS:20140804-143558638, doi:10.1785/BSSA0250010001.">57</a>]</span>). This calibration
of the epicentral distance (<span id="id2">Richter [<a class="reference internal" href="../base/references.html#id81" title="C.F. Richter. An instrumental earthquake magnitude scale. Bull. Seismol. Soc. Am., 1:1 - 32, 1935. URL: https://resolver.caltech.edu/CaltechAUTHORS:20140804-143558638, doi:10.1785/BSSA0250010001.">66</a>]</span>). This calibration
function and distance range can be configured globally or per station using
global bindings or the global module configuration variable
module.trunk.global.magnitudes.ML.logA0 in <code class="file docutils literal notranslate"><span class="pre">global.cfg</span></code>, e.g.</p>
<div class="highlight-params notranslate"><div class="highlight"><pre><span></span>module.trunk.global.magnitudes.ML.logA0 = &quot;0:-1.3,60:-2.8,100:-3.0,400:-4.5,1000:-5.85&quot;
module.trunk.global.magnitudes.ML.maxDistanceKm = &quot;-1&quot;
<div class="highlight-properties notranslate"><div class="highlight"><pre><span></span><span class="na">module.trunk.global.magnitudes.ML.logA0</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">&quot;0:-1.3,60:-2.8,100:-3.0,400:-4.5,1000:-5.85&quot;</span>
<span class="na">module.trunk.global.magnitudes.ML.maxDist</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">1000km</span>
</pre></div>
</div>
<p>The <em>logA0</em> configuration string consists of an arbitrary number of
@ -120,13 +120,13 @@ and the second value corresponds to the <em>log10(A0)</em> term above.</p>
interpolation. E.g. for the above default specification, at a
distance of 80 km the <em>log10(A0)</em> value would be</p>
<div class="math">
<p><img src="../_images/math/6e45a883605015d556a6b6fe63821c64d8263242.png" alt="\log10(A0) &amp;= ((-3.0)-(-2.8))*(80-60)/(100-60)-2.8 \\
<p><img src="../_images/math/6e45a883605015d556a6b6fe63821c64d8263242.svg" alt="\log10(A0) &amp;= ((-3.0)-(-2.8))*(80-60)/(100-60)-2.8 \\
&amp;= -2.9"/></p>
</div><p>In other words, at 80 km distance the magnitude would be</p>
<div class="math">
<p><img src="../_images/math/d201277e64aa494949afae6e3509d37320084dc7.png" alt="ML &amp;= \log10(A) - (-2.9) \\
<p><img src="../_images/math/d201277e64aa494949afae6e3509d37320084dc7.svg" alt="ML &amp;= \log10(A) - (-2.9) \\
&amp;= \log10(A) + 2.9"/></p>
</div><p>which is according to the original Richter formula <span id="id3">[<a class="reference internal" href="../base/references.html#id62" title="C.F. Richter. An instrumental earthquake magnitude scale. Bull. Seismol. Soc. Am., 1:1 - 32, 1935. URL: https://resolver.caltech.edu/CaltechAUTHORS:20140804-143558638, doi:10.1785/BSSA0250010001.">57</a>]</span> if the
</div><p>which is according to the original Richter formula <span id="id3">[<a class="reference internal" href="../base/references.html#id81" title="C.F. Richter. An instrumental earthquake magnitude scale. Bull. Seismol. Soc. Am., 1:1 - 32, 1935. URL: https://resolver.caltech.edu/CaltechAUTHORS:20140804-143558638, doi:10.1785/BSSA0250010001.">66</a>]</span> if the
amplitude is measured in millimeters.</p>
<p>Several distance-value pairs can be configured for different ranges of
epicenter distance.</p>
@ -211,7 +211,7 @@ line per parameter can be added to the global module configuration
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>ML_IDC &#8212; SeisComP Release documentation</title>
<title>ML_IDC &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -84,7 +84,7 @@
<section id="station-magnitude">
<h3>Station Magnitude<a class="headerlink" href="#station-magnitude" title="Permalink to this heading"></a></h3>
<div class="math">
<p><img src="../_images/math/0fa61d5b31e348e0325d65192561b1f1af9c9cdd.png" alt="mag = \log10(A) + B(\Delta)"/></p>
<p><img src="../_images/math/0fa61d5b31e348e0325d65192561b1f1af9c9cdd.svg" alt="mag = \log10(A) + B(\Delta)"/></p>
</div><p>with</p>
<p>A: amplitude of type SBSNR</p>
<p>B: attenuation correction function of epicentral distance in km</p>
@ -95,7 +95,7 @@ will be calculated.</p>
<section id="station-corrections">
<h3>Station corrections<a class="headerlink" href="#station-corrections" title="Permalink to this heading"></a></h3>
<p>Station magnitudes can be computed with a station specific correction table
which is configured in the global bindings. The parameter <a class="reference internal" href="global.html#confval-magnitudes.ML-IDC-.A"><code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.ML(IDC).A</span></code></a>
which is configured in the global bindings. The parameter <code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.ML(IDC).A</span></code>
takes a path and allows to use placeholders for network code (<code class="code docutils literal notranslate"><span class="pre">{net}</span></code>),
station code (<code class="code docutils literal notranslate"><span class="pre">{sta}</span></code>) and location code (<code class="code docutils literal notranslate"><span class="pre">{loc}</span></code>).</p>
<p>Example:</p>
@ -173,7 +173,7 @@ station code (<code class="code docutils literal notranslate"><span class="pre">
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>MLc &#8212; SeisComP Release documentation</title>
<title>MLc &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -101,57 +101,144 @@ measured amplitudes to station magnitudes.</p></li>
<h3>Amplitudes<a class="headerlink" href="#amplitudes" title="Permalink to this heading"></a></h3>
<p>Some general conditions apply for measuring amplitudes:</p>
<ul class="simple">
<li><p>Measured amplitude type: MLc.</p></li>
<li><p>Name amplitude type: MLc.</p></li>
<li><p>Expected unit of gain-corrected input data: m/s. Activate response correction
in global bindings in case data are provided in acceleration.</p></li>
<li><p>Components used for amplitude measurements: both horizontal components
separately.</p></li>
</ul>
<p>The default parameters for measuring MLc amplitudes can be adjusted by global
<p>The parameters for measuring MLc amplitudes can be adjusted by global
binding parameters:</p>
<ul class="simple">
<li><p>Filtering before instrument simulation: <a class="reference internal" href="../base/filter-grammar.html#filter-bw"><span class="std std-ref">BW(3,0.5,12)</span></a>,
configurable by <a class="reference internal" href="global.html#confval-amplitudes.MLc.preFilter"><code class="xref std std-confval docutils literal notranslate"><span class="pre">amplitudes.MLc.preFilter</span></code></a>.</p></li>
<li><p><a class="reference internal" href="../base/glossary.html#term-Wood-Anderson-seismometer"><span class="xref std std-term">Wood-Anderson seismometer</span></a> simulation: yes, can be deactivated by
<a class="reference internal" href="global.html#confval-amplitudes.MLc.applyWoodAnderson"><code class="xref std std-confval docutils literal notranslate"><span class="pre">amplitudes.MLc.applyWoodAnderson</span></code></a>.</p></li>
<li><p>Characteristics of <a class="reference internal" href="../base/glossary.html#term-Wood-Anderson-seismometer"><span class="xref std std-term">Wood-Anderson seismometer</span></a>: according to IASPEI
recommendations. Can be adjusted by <a class="reference internal" href="global.html#confval-2"><code class="xref std std-confval docutils literal notranslate"><span class="pre">amplitudes.WoodAnderson.gain</span></code></a>,
<a class="reference internal" href="global.html#confval-3"><code class="xref std std-confval docutils literal notranslate"><span class="pre">amplitudes.WoodAnderson.T0</span></code></a>, <a class="reference internal" href="global.html#confval-4"><code class="xref std std-confval docutils literal notranslate"><span class="pre">amplitudes.WoodAnderson.h</span></code></a>
in global bindings or global module configuration.</p></li>
<li><p>Amplitude scaling: 1, configure by <a class="reference internal" href="global.html#confval-amplitudes.MLc.amplitudeScale"><code class="xref std std-confval docutils literal notranslate"><span class="pre">amplitudes.MLc.amplitudeScale</span></code></a>
for considering non-default units by magnitude.</p></li>
<li><p>Method applied for measuring amplitudes: absolute maximum, configurable in
global bindings by <a class="reference internal" href="global.html#confval-amplitudes.MLc.measureType"><code class="xref std std-confval docutils literal notranslate"><span class="pre">amplitudes.MLc.measureType</span></code></a>.</p></li>
<li><p>Method for combining amplitude measurements: <em>max</em> (maximum from both
horizontal components), configurable in global bindings by
<a class="reference internal" href="global.html#confval-amplitudes.MLc.combiner"><code class="xref std std-confval docutils literal notranslate"><span class="pre">amplitudes.MLc.combiner</span></code></a>.</p></li>
</ul>
<table class="docutils align-left">
<colgroup>
<col style="width: 22.2%" />
<col style="width: 27.8%" />
<col style="width: 16.7%" />
<col style="width: 33.3%" />
</colgroup>
<thead>
<tr class="row-odd"><th class="head"><p>Topic</p></th>
<th class="head"><p>Parameter</p></th>
<th class="head"><p>Default</p></th>
<th class="head"><p>Comment</p></th>
</tr>
</thead>
<tbody>
<tr class="row-even"><td><p><a class="reference internal" href="../base/filter-grammar.html#filter-grammar"><span class="std std-ref">Filtering</span></a></p></td>
<td><p><code class="xref std std-confval docutils literal notranslate"><span class="pre">amplitudes.MLc.preFilter</span></code></p></td>
<td><p><a class="reference internal" href="../base/filter-grammar.html#filter-bw"><span class="std std-ref">BW(3,0.5,12)</span></a></p></td>
<td><p>Applied before instrument simulation</p></td>
</tr>
<tr class="row-odd"><td><p><a class="reference internal" href="../base/glossary.html#term-Wood-Anderson-seismometer"><span class="xref std std-term">Wood-Anderson simulation</span></a></p></td>
<td><p><code class="xref std std-confval docutils literal notranslate"><span class="pre">amplitudes.MLc.applyWoodAnderson</span></code></p></td>
<td><p>true</p></td>
<td><p>When WA simulation is inactive, measured amplitudes take the units of the gain of the stream on which they were measured.</p></td>
</tr>
<tr class="row-even"><td><p><a class="reference internal" href="../base/glossary.html#term-Wood-Anderson-seismometer"><span class="xref std std-term">Wood-Anderson parameters</span></a></p></td>
<td><p><a class="reference internal" href="global.html#confval-2"><code class="xref std std-confval docutils literal notranslate"><span class="pre">amplitudes.WoodAnderson.gain</span></code></a>, <a class="reference internal" href="global.html#confval-3"><code class="xref std std-confval docutils literal notranslate"><span class="pre">amplitudes.WoodAnderson.T0</span></code></a>, <a class="reference internal" href="global.html#confval-4"><code class="xref std std-confval docutils literal notranslate"><span class="pre">amplitudes.WoodAnderson.h</span></code></a></p></td>
<td><p>2080, 0.8, 0.7</p></td>
<td><p>Defaults: see <a class="reference internal" href="../base/concepts/magnitudes.html#concepts-magnitudes-wa"><span class="std std-ref">IASPEI recommendation</span></a>.</p></td>
</tr>
<tr class="row-odd"><td><p>Amplitude scaling</p></td>
<td><p><code class="xref std std-confval docutils literal notranslate"><span class="pre">amplitudes.MLc.amplitudeScale</span></code></p></td>
<td><p>1</p></td>
<td><p>Apply for scaling measured amplitudes to units required by the magnitude</p></td>
</tr>
<tr class="row-even"><td><p>Amplitude combination</p></td>
<td><p><code class="xref std std-confval docutils literal notranslate"><span class="pre">amplitudes.MLc.combiner</span></code></p></td>
<td><p>max</p></td>
<td><p>Method for combining amplitudes measured on both horizontal components</p></td>
</tr>
</tbody>
</table>
<p>Some additional parameters require you to create an amplitude-type profile for
global binding parameters. Name the profile like the amplitude name, hence MLc:</p>
<ul class="simple">
<li><p>Time window for measuring signal amplitudes [s]: P pick time + 150 s by
<a class="reference internal" href="scautopick.html#scautopick"><span class="std std-ref">scautopick</span></a> or distance [km]/3 km/s + 30 s,
the relevant parameters are: <code class="xref std std-confval docutils literal notranslate"><span class="pre">amplitudes.MLc.signalBegin</span></code>,
<code class="xref std std-confval docutils literal notranslate"><span class="pre">amplitudes.MLc.signalEnd</span></code>. <a class="reference internal" href="../base/time-grammar.html#time-grammar"><span class="std std-ref">Time grammar</span></a> may be
applied for begin and end times.</p></li>
<li><p>Time window for measuring noise amplitudes [s]: 30 s before the P pick,
the relevant parameters are: <code class="xref std std-confval docutils literal notranslate"><span class="pre">amplitudes.MLc.noiseBegin</span></code>,
<code class="xref std std-confval docutils literal notranslate"><span class="pre">amplitudes.MLc.noiseEnd</span></code>. <a class="reference internal" href="../base/time-grammar.html#time-grammar"><span class="std std-ref">Time grammar</span></a> may be
applied for begin and end times.</p></li>
<li><p>Minimum SNR: 0, configurable by <code class="xref std std-confval docutils literal notranslate"><span class="pre">amplitudes.MLc.minSNR</span></code>.</p></li>
<li><p>Distance range: 0 - 8 deg, configurable by <code class="xref std std-confval docutils literal notranslate"><span class="pre">amplitudes.MLc.minDist</span></code>,
<code class="xref std std-confval docutils literal notranslate"><span class="pre">amplitudes.MLc.maxDist</span></code>, stations at distances beyond 8 deg will be strictly
ignored.</p></li>
<li><p>Depth range: &lt;= 80 km, can be adjusted and extended by
<code class="xref std std-confval docutils literal notranslate"><span class="pre">amplitudes.MLc.minDepth</span></code> and <code class="xref std std-confval docutils literal notranslate"><span class="pre">amplitudes.MLc.maxDepth</span></code>.</p></li>
</ul>
<p>Most parameters controlling the amplitude measurements are configurable in
global bindings or global module configuration.</p>
<p>The Wood-Anderson simulation will convert input velocity data to ground
global binding parameters. Name the profile like the amplitude name, hence MLc
replacing $name in the parameters below:</p>
<table class="docutils align-left">
<colgroup>
<col style="width: 22.2%" />
<col style="width: 27.8%" />
<col style="width: 16.7%" />
<col style="width: 33.3%" />
</colgroup>
<thead>
<tr class="row-odd"><th class="head"><p>Topic</p></th>
<th class="head"><p>Parameter</p></th>
<th class="head"><p>Default</p></th>
<th class="head"><p>Comment</p></th>
</tr>
</thead>
<tbody>
<tr class="row-even"><td><p>Minimum distance</p></td>
<td><p><a class="reference internal" href="global.html#confval-amplitudes.-name.minDist"><code class="xref std std-confval docutils literal notranslate"><span class="pre">amplitudes.$name.minDist</span></code></a></p></td>
<td><p>0</p></td>
<td></td>
</tr>
<tr class="row-odd"><td><p>Maximum distance</p></td>
<td><p><a class="reference internal" href="global.html#confval-amplitudes.-name.maxDist"><code class="xref std std-confval docutils literal notranslate"><span class="pre">amplitudes.$name.maxDist</span></code></a></p></td>
<td><p>8</p></td>
<td><p>Cannot be extended beyond default</p></td>
</tr>
<tr class="row-even"><td><p>Minimum source depth</p></td>
<td><p><a class="reference internal" href="global.html#confval-amplitudes.-name.minDepth"><code class="xref std std-confval docutils literal notranslate"><span class="pre">amplitudes.$name.minDepth</span></code></a></p></td>
<td><p>0</p></td>
<td><p>Can be negative</p></td>
</tr>
<tr class="row-odd"><td><p>Maximum source depth</p></td>
<td><p><a class="reference internal" href="global.html#confval-amplitudes.-name.maxDepth"><code class="xref std std-confval docutils literal notranslate"><span class="pre">amplitudes.$name.maxDepth</span></code></a></p></td>
<td><p>80</p></td>
<td><p>Can be extended beyond default</p></td>
</tr>
<tr class="row-even"><td><p>Noise window begin</p></td>
<td><p><a class="reference internal" href="global.html#confval-amplitudes.-name.noiseBegin"><code class="xref std std-confval docutils literal notranslate"><span class="pre">amplitudes.$name.noiseBegin</span></code></a></p></td>
<td><p>-30</p></td>
<td><p>(+++)</p></td>
</tr>
<tr class="row-odd"><td><p>Noise window end</p></td>
<td><p><a class="reference internal" href="global.html#confval-amplitudes.-name.noiseEnd"><code class="xref std std-confval docutils literal notranslate"><span class="pre">amplitudes.$name.noiseEnd</span></code></a></p></td>
<td><p>-5</p></td>
<td><p>(+++)</p></td>
</tr>
<tr class="row-even"><td><p>Signal window begin</p></td>
<td><p><a class="reference internal" href="global.html#confval-amplitudes.-name.signalBegin"><code class="xref std std-confval docutils literal notranslate"><span class="pre">amplitudes.$name.signalBegin</span></code></a></p></td>
<td><p>-5</p></td>
<td><p>(+++)</p></td>
</tr>
<tr class="row-odd"><td><p>Signal window end</p></td>
<td><p><a class="reference internal" href="global.html#confval-amplitudes.-name.signalEnd"><code class="xref std std-confval docutils literal notranslate"><span class="pre">amplitudes.$name.signalEnd</span></code></a></p></td>
<td><p>150 (+) or distance/3+30 (++)</p></td>
<td><p>(<strong>+</strong>) When measured by <a class="reference internal" href="scautopick.html#scautopick"><span class="std std-ref">scautopick</span></a>, (<strong>++</strong>) When measured by <a class="reference internal" href="scamp.html#scamp"><span class="std std-ref">scamp</span></a> or <a class="reference internal" href="scolv.html#scolv"><span class="std std-ref">scolv</span></a> (+++)</p></td>
</tr>
<tr class="row-even"><td><p>Minimum <a class="reference internal" href="../base/glossary.html#term-SNR"><span class="xref std std-term">SNR</span></a></p></td>
<td><p><a class="reference internal" href="global.html#confval-amplitudes.-name.minSNR"><code class="xref std std-confval docutils literal notranslate"><span class="pre">amplitudes.$name.minSNR</span></code></a></p></td>
<td><p>not applied</p></td>
<td><p>Compares the maximum amplitudes measured within the signal and noise windows</p></td>
</tr>
<tr class="row-odd"><td><p>Period range</p></td>
<td><p>NA</p></td>
<td><p>NA</p></td>
<td><p>Period is not measured. A configuration will prevent any MLc amplitude from being measured</p></td>
</tr>
<tr class="row-even"><td><p>Amplitude saturation</p></td>
<td><p><a class="reference internal" href="global.html#confval-amplitudes.-name.saturationThreshold"><code class="xref std std-confval docutils literal notranslate"><span class="pre">amplitudes.$name.saturationThreshold</span></code></a></p></td>
<td><p>false</p></td>
<td><p>Apply for avoiding measurements on clipped data</p></td>
</tr>
<tr class="row-odd"><td><p>Response correction</p></td>
<td><p><a class="reference internal" href="global.html#confval-amplitudes.-name.enableResponses"><code class="xref std std-confval docutils literal notranslate"><span class="pre">amplitudes.$name.enableResponses</span></code></a></p></td>
<td><p>false</p></td>
<td><p>Activate for input units other than nm/s and set <a class="reference internal" href="global.html#confval-amplitudes.-name.resp.minFreq"><code class="xref std std-confval docutils literal notranslate"><span class="pre">amplitudes.$name.resp.minFreq</span></code></a>, <a class="reference internal" href="global.html#confval-amplitudes.-name.resp.maxFreq"><code class="xref std std-confval docutils literal notranslate"><span class="pre">amplitudes.$name.resp.maxFreq</span></code></a></p></td>
</tr>
</tbody>
</table>
<p><strong>(+++)</strong> All values defining the time windows for measuring noise and signal
are relative to P arrival time, read <a class="reference internal" href="../base/time-grammar.html#time-grammar"><span class="std std-ref">Time grammar</span></a>.</p>
<p>The default values are valid for SW-Germany (<span id="id1">Stange [<a class="reference internal" href="../base/references.html#id100" title="S. Stange. ML determination for local and regional events using a sparse network in Southwestern Germany. J. Seismol., 10:247 257, 2006. doi:10.1007/s10950-006-9010-6.">71</a>]</span>).
The Wood-Anderson simulation will convert input velocity data to ground
displacement in mm. The input data may be of a different unit after applying
<a class="reference internal" href="global.html#confval-amplitudes.MLc.preFilter"><code class="xref std std-confval docutils literal notranslate"><span class="pre">amplitudes.MLc.preFilter</span></code></a>, e.g. when integration is applied, and / or
<code class="xref std std-confval docutils literal notranslate"><span class="pre">amplitudes.MLc.preFilter</span></code>, e.g. when integration is applied, and / or
when Wood-Anderson simulation is disabled. Configure
<a class="reference internal" href="global.html#confval-amplitudes.MLc.amplitudeScale"><code class="xref std std-confval docutils literal notranslate"><span class="pre">amplitudes.MLc.amplitudeScale</span></code></a> for converting the unit of the
<code class="xref std std-confval docutils literal notranslate"><span class="pre">amplitudes.MLc.amplitudeScale</span></code> for converting the unit of the
processed data to the unit expected by the
<a class="reference internal" href="#mlc-station-magnitude"><span class="std std-ref">station magnitude calibration</span></a> for the measured
amplitude.</p>
@ -159,106 +246,210 @@ amplitude.</p>
<p class="admonition-title">Note</p>
<p>For comparing MLc amplitudes with <a class="reference internal" href="global_ml.html#global-ml"><span class="std std-ref">ML amplitudes</span></a> set the
global bindings parameters</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">amplitudes</span><span class="o">.</span><span class="n">MLc</span><span class="o">.</span><span class="n">preFilter</span> <span class="o">=</span> <span class="s2">&quot;&quot;</span>
<span class="n">amplitudes</span><span class="o">.</span><span class="n">MLc</span><span class="o">.</span><span class="n">combiner</span> <span class="o">=</span> <span class="n">average</span>
<div class="highlight-properties notranslate"><div class="highlight"><pre><span></span><span class="na">amplitudes.MLc.preFilter</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">&quot;&quot;</span>
<span class="na">amplitudes.MLc.combiner</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">average</span>
</pre></div>
</div>
</div>
</section>
<section id="station-magnitudes">
<span id="mlc-station-magnitude"></span><h3>Station magnitudes<a class="headerlink" href="#station-magnitudes" title="Permalink to this heading"></a></h3>
<p>Default properties, most parameters are configurable in global bindings:</p>
<ul class="simple">
<li><p>Distance type: hypocentral, epicentral can be selected by <a class="reference internal" href="global.html#confval-magnitudes.MLc.distMode"><code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.MLc.distMode</span></code></a>.</p></li>
<li><p>Distance range: 0 - 8 deg, configurable by <a class="reference internal" href="global.html#confval-magnitudes.MLc.minDist"><code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.MLc.minDist</span></code></a>,
<a class="reference internal" href="global.html#confval-magnitudes.MLc.maxDist"><code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.MLc.maxDist</span></code></a>, measurements beyond 8 deg will be strictly
ignored.</p></li>
<li><p>Depth range: &lt;= 80 km, can be extended by <a class="reference internal" href="global.html#confval-magnitudes.MLc.maxDepth"><code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.MLc.maxDepth</span></code></a>.</p></li>
<li><p>Expected amplitude type: MLc, configurable by magnitude alias.</p></li>
<li><p>Expected amplitude unit: millimeter (mm), other units can be assumed by
amplitude scaling with <a class="reference internal" href="global.html#confval-amplitudes.MLc.amplitudeScale"><code class="xref std std-confval docutils literal notranslate"><span class="pre">amplitudes.MLc.amplitudeScale</span></code></a>.</p></li>
<li><p>Magnitude calibration type: parametric, parametric and non-parametric are
available through <a class="reference internal" href="global.html#confval-magnitudes.MLc.calibrationType"><code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.MLc.calibrationType</span></code></a>.</p></li>
<li><p>Calibration function (see below for the equations), configurable by global bindings
depending on the actual calibration type:</p>
<ul>
<li><p>parametric: <a class="reference internal" href="global.html#confval-magnitudes.MLc.parametric.c0"><code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.MLc.parametric.c0</span></code></a>,
<a class="reference internal" href="global.html#confval-magnitudes.MLc.parametric.c1"><code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.MLc.parametric.c1</span></code></a>,
<a class="reference internal" href="global.html#confval-magnitudes.MLc.parametric.c2"><code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.MLc.parametric.c2</span></code></a>,
<a class="reference internal" href="global.html#confval-magnitudes.MLc.parametric.c3"><code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.MLc.parametric.c3</span></code></a>,
<a class="reference internal" href="global.html#confval-magnitudes.MLc.parametric.c4"><code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.MLc.parametric.c4</span></code></a>,
<a class="reference internal" href="global.html#confval-magnitudes.MLc.parametric.c5"><code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.MLc.parametric.c5</span></code></a></p></li>
<li><p>A0: <a class="reference internal" href="global.html#confval-magnitudes.MLc.A0.logA0"><code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.MLc.A0.logA0</span></code></a></p></li>
</ul>
</li>
<li><p>Station correction: none, configurable by a magnitude-type profile in global
bindings with <code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.MLc.offset</span></code> or the equivalent in global
module configuration as <code class="xref std std-confval docutils literal notranslate"><span class="pre">module.trunk.NET.STA.magnitudes.MLc.offset</span></code>.
<p>Station magnitudes are computed from measured amplitudes by applying a
configurable calibration function when the origin is within depths and distance
constraints. The parameters are configurable in global bindings or by global
module parameters when applying
<a class="reference internal" href="../base/concepts/magnitudes.html#concepts-magnitudes-regionalization"><span class="std std-ref">regionalization</span></a>.</p>
<p>Station corrections are configurable by a magnitude-type profile named MLc in
global bindings with <a class="reference internal" href="global.html#confval-magnitudes.-name.offset"><code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.$name.offset</span></code></a> or the equivalent in
global module configuration as <code class="xref std std-confval docutils literal notranslate"><span class="pre">module.trunk.NET.STA.magnitudes.MLc.offset</span></code>.
The latter is not supported by <a class="reference internal" href="scconfig.html#scconfig"><span class="std std-ref">scconfig</span></a> but it reduces the amount of
required bindings.</p></li>
</ul>
required bindings.</p>
<p>The calibration function is considered in one of the forms</p>
<ul>
<li><p>parametric when <a class="reference internal" href="global.html#confval-magnitudes.MLc.calibrationType"><code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.MLc.calibrationType</span></code></a> = “parametric”<a href="#id1"><span class="problematic" id="id2">`</span></a>:</p>
<li><p>Parametric when <code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.MLc.calibrationType</span></code> = “parametric”<a href="#id2"><span class="problematic" id="id3">`</span></a>:</p>
<div class="math">
<p><img src="../_images/math/bfdf8455f23a75bf18652720e491939a20ac8fa6.png" alt="MLc = \log_{10}(A) + c_3 * \log_{10}(r/c_5) + c_2 * (r + c_4) + c_1 + c_0(station)"/></p>
<p><img src="../_images/math/f3e2c61cf74e64278c41c2c01028f3b9fe5d1c8e.svg" alt="MLc = \log_{10}(A) + c_7 * e^{c8 * r} + c_6 * h + c_3 * \log_{10}(r / c_5) + c_2 * (r + c_4) + c_1 + c_0(station)"/></p>
</div><p>where</p>
<ul class="simple">
<li><p><em>A</em>: displacement amplitude measured in unit of mm or as per configuration</p></li>
<li><p><em>r</em>: hypocentral (default) or epicentral distance</p></li>
<li><p><em>c1</em>, <em>c2</em>, <em>c3</em>, <em>c4</em>, <em>c5</em>: general calibration parameters</p></li>
<li><p><em>c1 - c8</em>: general calibration parameters</p></li>
<li><p><em>c0</em>: station-specific correction</p></li>
<li><p><em>r</em>: Hypocentral (default) or epicentral distance as configured by
<a class="reference internal" href="global.html#confval-magnitudes.MLc.distMode"><code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.MLc.distMode</span></code></a>.</p></li>
<code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.MLc.distMode</span></code></p></li>
<li><p>h: (source depth - <code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.MLc.parametric.H</span></code>) when
source depth &gt; <code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.MLc.parametric.H</span></code> but 0 otherwise.</p></li>
</ul>
<p>The default values are valid for SW-Germany (<span id="id3">Stange [<a class="reference internal" href="../base/references.html#id78" title="S. Stange. ML determination for local and regional events using a sparse network in Southwestern Germany. J. Seismol., 10:247 257, 2006. doi:10.1007/s10950-006-9010-6.">62</a>]</span>), c6 and H
have been added for supporting dependency on depth (<span id="id4">Rhoades <em>et al.</em> [<a class="reference internal" href="../base/references.html#id72" title="D.A. Rhoades, A. Christophersen, S. Bourguignon, J. Ristau, and J. Salichon. A DepthDependent Local Magnitude Scale for New Zealand Earthquakes Consistent with Moment Magnitude. Bull. Seismol. Soc. Am., 111(2):10561066, 2020. doi:10.1785/0120200252.">56</a>]</span>).</p>
<p>The default values are valid for SW-Germany (<span id="id4">Stange [<a class="reference internal" href="../base/references.html#id100" title="S. Stange. ML determination for local and regional events using a sparse network in Southwestern Germany. J. Seismol., 10:247 257, 2006. doi:10.1007/s10950-006-9010-6.">71</a>]</span>). <em>c6</em>,
<em>H</em> have been added for supporting dependency on depth (<span id="id5">Rhoades <em>et al.</em> [<a class="reference internal" href="../base/references.html#id93" title="D.A. Rhoades, A. Christophersen, S. Bourguignon, J. Ristau, and J. Salichon. A DepthDependent Local Magnitude Scale for New Zealand Earthquakes Consistent with Moment Magnitude. Bull. Seismol. Soc. Am., 111(2):10561066, 2020. doi:10.1785/0120200252.">65</a>]</span>)
and <em>c7</em>, <em>c8</em> for observations at short distances (<span id="id6">Luckett <em>et al.</em> [<a class="reference internal" href="../base/references.html#id71" title="R. Luckett, L. Ottemöller, A. Butcher, and B. Baptie. Extending local magnitude ml to short distances. Geophys. J. Int., 216:11451156, 2019. doi:10.1093/gji/ggy484.">61</a>]</span>).</p>
</li>
<li><p>log10(A0)-based non-parametric when <a class="reference internal" href="global.html#confval-magnitudes.MLc.calibrationType"><code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.MLc.calibrationType</span></code></a> = “A0”<a href="#id5"><span class="problematic" id="id6">`</span></a>:</p>
<li><p>log10(A0)-based non-parametric when <code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.MLc.calibrationType</span></code> = “A0”<a href="#id7"><span class="problematic" id="id8">`</span></a>:</p>
<div class="math">
<p><img src="../_images/math/ccab4425809584f06dd1ddcaf88fa0b15cb94841.png" alt="MLc = \log_{10}(A) - \log_{10}(A_0)"/></p>
<p><img src="../_images/math/ccab4425809584f06dd1ddcaf88fa0b15cb94841.svg" alt="MLc = \log_{10}(A) - \log_{10}(A_0)"/></p>
</div><p>where</p>
<ul class="simple">
<li><p><img class="math" src="../_images/math/93675c26b872cb6c8401f3a9d037d0e7383ae06b.png" alt="log_{10}(A_0)"/>: distance-dependent correction value. Read
<li><p><img class="math" src="../_images/math/93675c26b872cb6c8401f3a9d037d0e7383ae06b.svg" alt="log_{10}(A_0)"/>: distance-dependent correction value. Read
<a class="reference internal" href="global_mlv.html#global-mlv"><span class="std std-ref">MLv</span></a> for the details.</p></li>
</ul>
</li>
</ul>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>The magnitude calibration function can be regionalized by adjusting global
<ul class="simple">
<li><p>The magnitude calibration function can be regionalized by adjusting global
module configuration parameters in MLc region profiles of
<code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.MLc.region.*</span></code> and in a <em>MLc</em> Magnitude type profile e.g.
in <code class="file docutils literal notranslate"><span class="pre">global.cfg</span></code>.</p>
</div>
<p>The flexibility of the amplitude and magnitude processing allows for MLc to be
applied in various use cases. Examples are given below.</p>
<ul>
<li><p><strong>Default:</strong> Pre-filtered and gain-corrected amplitudes, Wood-Anderson
corrected and measured in mm for Southwestern Germany, <span id="id7">Stange [<a class="reference internal" href="../base/references.html#id78" title="S. Stange. ML determination for local and regional events using a sparse network in Southwestern Germany. J. Seismol., 10:247 257, 2006. doi:10.1007/s10950-006-9010-6.">62</a>]</span>:</p>
<div class="math">
<p><img src="../_images/math/d949c4542df9586bfdd0006602e3f0b3a56fbc5b.png" alt="MLc = \log_{10}(A) + 1.11 * \log_{10}(r) + 0.00095 * r + 0.69 + c_0"/></p>
</div></li>
<li><p>Wood-Anderson-corrected displacement amplitudes measured in mm for
Southern California, <span id="id8">Hutton and Boore [<a class="reference internal" href="../base/references.html#id39" title="L.K. Hutton and D.M. Boore. The ML scale in southern California. Bull. Seismol. Soc. Am,, 77(6):20742094, 1987. URL: https://resolver.caltech.edu/CaltechAUTHORS:20140905-113510505.">45</a>]</span>:</p>
<div class="math">
<p><img src="../_images/math/fe3a90edfdebbbcc8730ea60fd0048e251cda93c.png" alt="MLc = \log_{10}(A) + 1.110 * \log_{10}(r / 100) + 0.00189 * (r - 100) + 3.0"/></p>
</div></li>
<li><p>Pre-filtered velocity amplitudes in units of mym/s (requiring to set
<a class="reference internal" href="global.html#confval-amplitudes.MLc.amplitudeScale"><code class="xref std std-confval docutils literal notranslate"><span class="pre">amplitudes.MLc.amplitudeScale</span></code></a>), no Wood-Anderson correction,
for West Bohemia, e.g. <span id="id9">Hiemer and Roessler [<a class="reference internal" href="../base/references.html#id38" title="S. Hiemer and D. Roessler. Monitoring the West Bohemian earthquake swarm in 2008/2009 by a temporary small-aperture seismic array. J. Seismol., 16:169-182, 2012. doi:10.1007/s10950-011-9256-5.">44</a>]</span>:</p>
<div class="math">
<p><img src="../_images/math/b21da4311b2f4882dbbadbcb617d04c5e5e35e7b.png" alt="MLc = \log_{10}(A) - log_{10}(2\Pi) + 2.1 * \log_{10}(r) - 1.7 + c_0"/></p>
</div></li>
<code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.MLc.region.*</span></code> and in a <em>MLc</em> Magnitude type profile
e.g., in <code class="file docutils literal notranslate"><span class="pre">global.cfg</span></code>.</p></li>
</ul>
<figure class="align-center" id="id13">
<a class="reference internal image-reference" href="../_images/magnitude-calibrations_MLc_s_MLc_hb.png"><img alt="../_images/magnitude-calibrations_MLc_s_MLc_hb.png" src="../_images/magnitude-calibrations_MLc_s_MLc_hb.png" style="width: 18cm;" /></a>
<figcaption>
<p><span class="caption-text">MLc magnitudes for measured amplitude of 1 mm with default magnitude
calibration (<em>MLc_s</em>, <span id="id10">Stange [<a class="reference internal" href="../base/references.html#id78" title="S. Stange. ML determination for local and regional events using a sparse network in Southwestern Germany. J. Seismol., 10:247 257, 2006. doi:10.1007/s10950-006-9010-6.">62</a>]</span>) and calibration values for Southern
California (<em>MLc_hb</em>, <span id="id11">Hutton and Boore [<a class="reference internal" href="../base/references.html#id39" title="L.K. Hutton and D.M. Boore. The ML scale in southern California. Bull. Seismol. Soc. Am,, 77(6):20742094, 1987. URL: https://resolver.caltech.edu/CaltechAUTHORS:20140905-113510505.">45</a>]</span>).</span><a class="headerlink" href="#id13" title="Permalink to this image"></a></p>
</figcaption>
</figure>
</div>
<p>Configurable parameters:</p>
<table class="docutils align-left">
<colgroup>
<col style="width: 22.2%" />
<col style="width: 27.8%" />
<col style="width: 16.7%" />
<col style="width: 33.3%" />
</colgroup>
<thead>
<tr class="row-odd"><th class="head"><p>Topic</p></th>
<th class="head"><p>Parameter</p></th>
<th class="head"><p>Default</p></th>
<th class="head"><p>Comment</p></th>
</tr>
</thead>
<tbody>
<tr class="row-even"><td><p>Distance type</p></td>
<td><p><code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.MLc.distMode</span></code></p></td>
<td><p>hypocentral</p></td>
<td><p>epicentral or hyocentral can be selected</p></td>
</tr>
<tr class="row-odd"><td><p>Minimum distance</p></td>
<td><p><code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.MLc.minDist</span></code></p></td>
<td><p>-1</p></td>
<td></td>
</tr>
<tr class="row-even"><td><p>Maximum distance</p></td>
<td><p><code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.MLc.maxDist</span></code></p></td>
<td><p>8</p></td>
<td><p>Measurements beyond 8 deg are strictly ignored</p></td>
</tr>
<tr class="row-odd"><td><p>Minimum source depth</p></td>
<td><p><code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.MLc.minDepth</span></code></p></td>
<td><p>-10</p></td>
<td></td>
</tr>
<tr class="row-even"><td><p>Maximum source depth</p></td>
<td><p><code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.MLc.maxDepth</span></code></p></td>
<td><p>80</p></td>
<td><p>Can be extended beyond default</p></td>
</tr>
<tr class="row-odd"><td><p>Period range</p></td>
<td><p>NA</p></td>
<td><p>NA</p></td>
<td><p>Period is not measured. A configuration will prevent any MLc magnitude from being computed</p></td>
</tr>
<tr class="row-even"><td><p>Amplitude type</p></td>
<td></td>
<td><p>MLc</p></td>
<td><p>Configurable by <a class="reference internal" href="../base/concepts/magnitudes.html#concepts-magnitudes-aliases"><span class="std std-ref">amplitude and magnitude alias</span></a></p></td>
</tr>
<tr class="row-odd"><td><p>Amplitude unit</p></td>
<td></td>
<td><p>mm</p></td>
<td><p>other units can be assumed by amplitude scaling with <code class="xref std std-confval docutils literal notranslate"><span class="pre">amplitudes.MLc.amplitudeScale</span></code></p></td>
</tr>
<tr class="row-even"><td><p>Magnitude calibration type</p></td>
<td><p><code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.MLc.calibrationType</span></code></p></td>
<td><p>parametric</p></td>
<td><p>parametric and A0 (non-parametric) are available</p></td>
</tr>
<tr class="row-odd"><td><p>Linear magnitude correction</p></td>
<td><p><a class="reference internal" href="global.html#confval-magnitudes.-name.multiplier"><code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.$name.multiplier</span></code></a></p></td>
<td><p>1.0</p></td>
<td><p>Configure station corrections more conveniently configurable in global module configuration as <code class="xref std std-confval docutils literal notranslate"><span class="pre">module.trunk.NET.STA.magnitudes.MLc.multiplier</span></code></p></td>
</tr>
<tr class="row-even"><td><p>Constant magnitude correction</p></td>
<td><p><a class="reference internal" href="global.html#confval-magnitudes.-name.offset"><code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.$name.offset</span></code></a></p></td>
<td><p>0.0</p></td>
<td><p>Configure station corrections more conveniently configurable in global module configuration as <code class="xref std std-confval docutils literal notranslate"><span class="pre">module.trunk.NET.STA.magnitudes.MLc.offset</span></code></p></td>
</tr>
<tr class="row-odd"><td></td>
<td></td>
<td></td>
<td></td>
</tr>
<tr class="row-even"><td><p><strong>parametric</strong> calibration</p></td>
<td></td>
<td></td>
<td><p>Parameters are used for <code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.MLc.calibrationType</span></code> = parametric</p></td>
</tr>
<tr class="row-odd"><td></td>
<td><p><code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.MLc.parametric.c0</span></code></p></td>
<td><p>0.0</p></td>
<td></td>
</tr>
<tr class="row-even"><td></td>
<td><p><code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.MLc.parametric.c1</span></code></p></td>
<td><p>0.69</p></td>
<td></td>
</tr>
<tr class="row-odd"><td></td>
<td><p><code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.MLc.parametric.c2</span></code></p></td>
<td><p>0.00095</p></td>
<td></td>
</tr>
<tr class="row-even"><td></td>
<td><p><code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.MLc.parametric.c3</span></code></p></td>
<td><p>1.11</p></td>
<td></td>
</tr>
<tr class="row-odd"><td></td>
<td><p><code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.MLc.parametric.c4</span></code></p></td>
<td><p>0.0</p></td>
<td></td>
</tr>
<tr class="row-even"><td></td>
<td><p><code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.MLc.parametric.c5</span></code></p></td>
<td><p>1.0</p></td>
<td></td>
</tr>
<tr class="row-odd"><td></td>
<td><p><code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.MLc.parametric.c6</span></code></p></td>
<td><p>0.0</p></td>
<td><p>see <span id="id9">Rhoades <em>et al.</em> [<a class="reference internal" href="../base/references.html#id93" title="D.A. Rhoades, A. Christophersen, S. Bourguignon, J. Ristau, and J. Salichon. A DepthDependent Local Magnitude Scale for New Zealand Earthquakes Consistent with Moment Magnitude. Bull. Seismol. Soc. Am., 111(2):10561066, 2020. doi:10.1785/0120200252.">65</a>]</span></p></td>
</tr>
<tr class="row-even"><td></td>
<td><p><code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.MLc.parametric.H</span></code></p></td>
<td><p>40.0</p></td>
<td><p>see <span id="id10">Rhoades <em>et al.</em> [<a class="reference internal" href="../base/references.html#id93" title="D.A. Rhoades, A. Christophersen, S. Bourguignon, J. Ristau, and J. Salichon. A DepthDependent Local Magnitude Scale for New Zealand Earthquakes Consistent with Moment Magnitude. Bull. Seismol. Soc. Am., 111(2):10561066, 2020. doi:10.1785/0120200252.">65</a>]</span></p></td>
</tr>
<tr class="row-odd"><td></td>
<td><p><code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.MLc.parametric.c7</span></code></p></td>
<td><p>0.0</p></td>
<td><p>see <span id="id11">Luckett <em>et al.</em> [<a class="reference internal" href="../base/references.html#id71" title="R. Luckett, L. Ottemöller, A. Butcher, and B. Baptie. Extending local magnitude ml to short distances. Geophys. J. Int., 216:11451156, 2019. doi:10.1093/gji/ggy484.">61</a>]</span></p></td>
</tr>
<tr class="row-even"><td></td>
<td><p><code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.MLc.parametric.c8</span></code></p></td>
<td><p>0.0</p></td>
<td><p>see <span id="id12">Luckett <em>et al.</em> [<a class="reference internal" href="../base/references.html#id71" title="R. Luckett, L. Ottemöller, A. Butcher, and B. Baptie. Extending local magnitude ml to short distances. Geophys. J. Int., 216:11451156, 2019. doi:10.1093/gji/ggy484.">61</a>]</span></p></td>
</tr>
<tr class="row-odd"><td></td>
<td></td>
<td></td>
<td></td>
</tr>
<tr class="row-even"><td><p><strong>non-parametric</strong> calibration</p></td>
<td></td>
<td></td>
<td><p>Parameters are used for <code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.MLc.calibrationType</span></code> = A0</p></td>
</tr>
<tr class="row-odd"><td></td>
<td><p><code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.MLc.A0.logA0</span></code></p></td>
<td><p>0:-1.3,60:-2.8,100:-3.0,400:-4.5,1000:-5.85</p></td>
<td><p>from <a class="reference internal" href="global_ml.html#global-ml"><span class="std std-ref">ML magnitude</span></a></p></td>
</tr>
</tbody>
</table>
</section>
<section id="network-magnitude">
<h3>Network magnitude<a class="headerlink" href="#network-magnitude" title="Permalink to this heading"></a></h3>
@ -273,25 +464,57 @@ method can be adjusted in <a class="reference internal" href="scmag.html#scmag">
<h3>Moment magnitude<a class="headerlink" href="#moment-magnitude" title="Permalink to this heading"></a></h3>
<p>MLc can be scaled to a moment magnitude, Mw(MLc), by a magnitude-type profile in
global module configuration. Read the
<a class="reference internal" href="../base/tutorials/magnitude-regionalization.html#tutorials-mags-moment"><span class="std std-ref">Tutorial on moment magnitudes</span></a> for the details.</p>
<a class="reference internal" href="../base/tutorials/amplitudes-magnitudes.html#tutorials-mags-moment"><span class="std std-ref">Tutorial on moment magnitudes</span></a> for the details.</p>
</section>
<section id="magnitude-aliases">
<h3>Magnitude aliases<a class="headerlink" href="#magnitude-aliases" title="Permalink to this heading"></a></h3>
<p>Magnitude aliases can be created by <a class="reference internal" href="global.html#confval-magnitudes.aliases"><code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.aliases</span></code></a> in
global module configuration in order to derive other magnitude types from
<section id="aliases">
<h3>Aliases<a class="headerlink" href="#aliases" title="Permalink to this heading"></a></h3>
<p>Amplitude and magnitude aliases can be created by <a class="reference internal" href="global.html#confval-magnitudes.aliases"><code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.aliases</span></code></a>
and <a class="reference internal" href="global.html#confval-amplitudes.aliases"><code class="xref std std-confval docutils literal notranslate"><span class="pre">amplitudes.aliases</span></code></a>, respectively, in global module configuration
in order to derive other magnitude types from
original amplitudes and magnitudes. The actual amplitude and magnitude
parameters of the aliases will be configured in global bindings or by
magnitude-type profiles in global module configuration. Read the
<a class="reference internal" href="../base/tutorials/magnitude-regionalization.html#tutorials-magnitude-aliases"><span class="std std-ref">Tutorial on magnitude aliases</span></a> for the
<a class="reference internal" href="../base/tutorials/amplitudes-magnitudes.html#tutorials-magnitude-aliases"><span class="std std-ref">Tutorial on magnitude aliases</span></a> for the
details.</p>
</section>
<section id="regionalization">
<h3>Regionalization<a class="headerlink" href="#regionalization" title="Permalink to this heading"></a></h3>
<p>Regionalization may be achieved by a magnitude-type profile in global module
configuration. Read the
<a class="reference internal" href="../base/tutorials/magnitude-regionalization.html#tutorials-magnitude-region"><span class="std std-ref">Tutorial on regionalization</span></a> for the details.</p>
<a class="reference internal" href="../base/tutorials/amplitudes-magnitudes.html#tutorials-magnitude-region"><span class="std std-ref">Tutorial on regionalization</span></a> for the details.</p>
</section>
</section>
<section id="examples">
<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this heading"></a></h2>
<p>The flexibility of the amplitude and magnitude processing allows for MLc to be
applied in various use cases. Examples are given below.</p>
<ul>
<li><p><strong>Default:</strong> Pre-filtered and gain-corrected amplitudes, Wood-Anderson
corrected and measured in mm for Southwestern Germany, <span id="id13">Stange [<a class="reference internal" href="../base/references.html#id100" title="S. Stange. ML determination for local and regional events using a sparse network in Southwestern Germany. J. Seismol., 10:247 257, 2006. doi:10.1007/s10950-006-9010-6.">71</a>]</span>:</p>
<div class="math">
<p><img src="../_images/math/d949c4542df9586bfdd0006602e3f0b3a56fbc5b.svg" alt="MLc = \log_{10}(A) + 1.11 * \log_{10}(r) + 0.00095 * r + 0.69 + c_0"/></p>
</div></li>
<li><p>Wood-Anderson-corrected displacement amplitudes measured in mm for
Southern California, <span id="id14">Hutton and Boore [<a class="reference internal" href="../base/references.html#id54" title="L.K. Hutton and D.M. Boore. The ML scale in southern California. Bull. Seismol. Soc. Am,, 77(6):20742094, 1987. URL: https://resolver.caltech.edu/CaltechAUTHORS:20140905-113510505.">53</a>]</span>:</p>
<div class="math">
<p><img src="../_images/math/fe3a90edfdebbbcc8730ea60fd0048e251cda93c.svg" alt="MLc = \log_{10}(A) + 1.110 * \log_{10}(r / 100) + 0.00189 * (r - 100) + 3.0"/></p>
</div></li>
<li><p>Pre-filtered velocity amplitudes in units of mym/s (requiring to set
<code class="xref std std-confval docutils literal notranslate"><span class="pre">amplitudes.MLc.amplitudeScale</span></code>), no Wood-Anderson correction,
for West Bohemia, e.g. <span id="id15">Hiemer and Roessler [<a class="reference internal" href="../base/references.html#id53" title="S. Hiemer and D. Roessler. Monitoring the West Bohemian earthquake swarm in 2008/2009 by a temporary small-aperture seismic array. J. Seismol., 16:169-182, 2012. doi:10.1007/s10950-011-9256-5.">52</a>]</span>:</p>
<div class="math">
<p><img src="../_images/math/b21da4311b2f4882dbbadbcb617d04c5e5e35e7b.svg" alt="MLc = \log_{10}(A) - log_{10}(2\Pi) + 2.1 * \log_{10}(r) - 1.7 + c_0"/></p>
</div></li>
</ul>
<figure class="align-center" id="id18">
<a class="reference internal image-reference" href="../_images/magnitude-calibrations_MLc_s_MLc_hb.png"><img alt="../_images/magnitude-calibrations_MLc_s_MLc_hb.png" src="../_images/magnitude-calibrations_MLc_s_MLc_hb.png" style="width: 18cm;" /></a>
<figcaption>
<p><span class="caption-text">MLc magnitudes for measured amplitude of 1 mm with default magnitude
calibration (<em>MLc_s</em>, <span id="id16">Stange [<a class="reference internal" href="../base/references.html#id100" title="S. Stange. ML determination for local and regional events using a sparse network in Southwestern Germany. J. Seismol., 10:247 257, 2006. doi:10.1007/s10950-006-9010-6.">71</a>]</span>) and calibration values for Southern
California (<em>MLc_hb</em>, <span id="id17">Hutton and Boore [<a class="reference internal" href="../base/references.html#id54" title="L.K. Hutton and D.M. Boore. The ML scale in southern California. Bull. Seismol. Soc. Am,, 77(6):20742094, 1987. URL: https://resolver.caltech.edu/CaltechAUTHORS:20140905-113510505.">53</a>]</span>).</span><a class="headerlink" href="#id18" title="Permalink to this image"></a></p>
</figcaption>
</figure>
</section>
<section id="setup">
<h2>Setup<a class="headerlink" href="#setup" title="Permalink to this heading"></a></h2>
<ol class="arabic">
@ -300,8 +523,8 @@ similar
to <a class="reference internal" href="global_ml.html#global-ml"><span class="std std-ref">ML</span></a>. Instead of configuring lots of global bindings profiles
or station bindings one line per parameter can be added to the global module
configuration (<code class="file docutils literal notranslate"><span class="pre">global.cfg</span></code>) which takes the form</p>
<div class="highlight-params notranslate"><div class="highlight"><pre><span></span>module.trunk.NET.STA.amplitudes.MLc.preFilter = value
module.trunk.NET.STA.magnitudes.MLc.parametric.c0 = value
<div class="highlight-properties notranslate"><div class="highlight"><pre><span></span><span class="na">module.trunk.NET.STA.amplitudes.MLc.preFilter</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">value</span>
<span class="na">module.trunk.NET.STA.magnitudes.MLc.parametric.c0</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">value</span>
</pre></div>
</div>
</li>
@ -310,7 +533,7 @@ computed by automatic modules, e.g. of <a class="reference internal" href="scamp
<li><p>Configure <a class="reference internal" href="scmag.html#scmag"><span class="std std-ref">scmag</span></a> (<a class="reference internal" href="scmag.html#confval-magnitudes.average"><code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.average</span></code></a> in <code class="file docutils literal notranslate"><span class="pre">scmag.cfg</span></code>)
for choosing the method to form the
network magnitude from station magnitudes, e.g.</p>
<div class="highlight-params notranslate"><div class="highlight"><pre><span></span>magnitudes.average = MLc:median
<div class="highlight-properties notranslate"><div class="highlight"><pre><span></span><span class="na">magnitudes.average</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">MLc:median</span>
</pre></div>
</div>
</li>
@ -320,11 +543,6 @@ MLc become the preferred magnitude.</p></li>
<li><p>Set defaults/visibility of MLc in <a class="reference internal" href="../base/glossary.html#term-GUI"><span class="xref std std-term">GUI</span></a> modules, e.g. <a class="reference internal" href="scolv.html#scolv"><span class="std std-ref">scolv</span></a>
or <a class="reference internal" href="scesv.html#scesv"><span class="std std-ref">scesv</span></a>.</p></li>
</ol>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>All default values for bindings configuration parameters are from
<span id="id12">Stange [<a class="reference internal" href="../base/references.html#id78" title="S. Stange. ML determination for local and regional events using a sparse network in Southwestern Germany. J. Seismol., 10:247 257, 2006. doi:10.1007/s10950-006-9010-6.">62</a>]</span>.</p>
</div>
</section>
</section>
@ -354,10 +572,11 @@ or <a class="reference internal" href="scesv.html#scesv"><span class="std std-re
<li><a class="reference internal" href="#station-magnitudes">Station magnitudes</a></li>
<li><a class="reference internal" href="#network-magnitude">Network magnitude</a></li>
<li><a class="reference internal" href="#moment-magnitude">Moment magnitude</a></li>
<li><a class="reference internal" href="#magnitude-aliases">Magnitude aliases</a></li>
<li><a class="reference internal" href="#aliases">Aliases</a></li>
<li><a class="reference internal" href="#regionalization">Regionalization</a></li>
</ul>
</li>
<li><a class="reference internal" href="#examples">Examples</a></li>
<li><a class="reference internal" href="#setup">Setup</a></li>
</ul>
</li>
@ -393,7 +612,7 @@ or <a class="reference internal" href="scesv.html#scesv"><span class="std std-re
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>MLh &#8212; SeisComP Release documentation</title>
<title>MLh &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -96,7 +96,7 @@ with two. So in the end we get real zero-to-peak values.</p>
<h3>Station Magnitude<a class="headerlink" href="#station-magnitude" title="Permalink to this heading"></a></h3>
<p>The MLh plugin calculates the individual station magnitude using the following formula:</p>
<div class="math">
<p><img src="../_images/math/4cfbd65af2e9b33bf217b7f95d186fabbf6a6db7.png" alt="mag = \log10(waamp1) + A \times hypdistkm + B"/></p>
<p><img src="../_images/math/4cfbd65af2e9b33bf217b7f95d186fabbf6a6db7.svg" alt="mag = \log10(waamp1) + A \times hypdistkm + B"/></p>
</div><p>waampl is the amplitude produced by the MLh plugin. Hypdistkm is the distance
from the sensor to the hypocenter in kilometers. A and B are parameters that
can be configured in a config file. Several pairs of A and B can be configured
@ -186,7 +186,7 @@ and in <a class="reference internal" href="scesv.html#scesv"><span class="std st
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>MLr &#8212; SeisComP Release documentation</title>
<title>MLr &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -77,10 +77,10 @@
<p>The GNS/Geonet local magnitude</p>
<section id="description">
<h2>Description<a class="headerlink" href="#description" title="Permalink to this heading"></a></h2>
<p>The MLr magnitude provides a GNS/Geonet local magnitude (<span id="id1">Ristau <em>et al.</em> [<a class="reference internal" href="../base/references.html#id64" title="J. Ristau, D. Harte, and J. Salichon. A Revised Local Magnitude (ML) Scale for New Zealand Earthquakes. Bull. Seismol. Soc. Am., 106(2):, 2016. doi:10.1785/0120150293.">58</a>]</span>).
<p>The MLr magnitude provides a GNS/Geonet local magnitude (<span id="id1">Ristau <em>et al.</em> [<a class="reference internal" href="../base/references.html#id85" title="J. Ristau, D. Harte, and J. Salichon. A Revised Local Magnitude (ML) Scale for New Zealand Earthquakes. Bull. Seismol. Soc. Am., 106(2):, 2016. doi:10.1785/0120150293.">67</a>]</span>).
MLr magnitudes are implemented by the <em>mlr</em> plugin.
It is a modified version of the gempa ML magnitude developed
at the Liverpool developer meeting (<span id="id2"><em>gempa GmbH</em> [<a class="reference internal" href="../base/references.html#id122" title="gempa GmbH. The SeisComP development and maintenance company. URL: https://www.gempa.de/.">28</a>]</span>) based on the SED
at the Liverpool developer meeting (<span id="id2"><em>gempa GmbH</em> [<a class="reference internal" href="../base/references.html#id147" title="gempa GmbH. The SeisComP development and maintenance company. URL: https://www.gempa.de.">31</a>]</span>) based on the SED
<a class="reference internal" href="global_mlh.html#global-mlh"><span class="std std-ref">MLh</span></a> magnitude.
The <em>mlr</em> plugin is designed to use the MLv station amplitudes for computing
MLr magnitudes.
@ -95,9 +95,9 @@ The magnitude uses a station correction term and the hypocentral distance.</p>
<p>The <em>mLr</em> plugin calculates individual MLr station local magnitudes from
<a class="reference internal" href="global_mlv.html#global-mlv"><span class="std std-ref">MLv</span></a> amplitudes as:</p>
<div class="math">
<p><img src="../_images/math/3b314bd56ab94770a2a623ebc60d9d2527f3eda6.png" alt="MLr = \log10(waampl) - \log10(waamplRef)"/></p>
<p><img src="../_images/math/3b314bd56ab94770a2a623ebc60d9d2527f3eda6.svg" alt="MLr = \log10(waampl) - \log10(waamplRef)"/></p>
</div><div class="math">
<p><img src="../_images/math/af651135a1453eaa75fcec6a10fd5195d34d83b0.png" alt="\log10(waamplRef)= 0.2869 - 1.272 \times 1^{-3} \times hypdistkm - 1.493 \times \log10(hypdistkm) + StationCorrection"/></p>
<p><img src="../_images/math/af651135a1453eaa75fcec6a10fd5195d34d83b0.svg" alt="\log10(waamplRef)= 0.2869 - 1.272 \times 1^{-3} \times hypdistkm - 1.493 \times \log10(hypdistkm) + StationCorrection"/></p>
</div><p>with</p>
<ul>
<li><p><em>waampl:</em> the <a class="reference internal" href="global_mlv.html#global-mlv"><span class="std std-ref">MLv</span></a> amplitude.</p></li>
@ -191,7 +191,7 @@ and in <a class="reference internal" href="scesv.html#scesv"><span class="std st
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>MLv &#8212; SeisComP Release documentation</title>
<title>MLv &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -77,14 +77,15 @@
<p>Local (Richter) magnitude measured on the vertical component</p>
<section id="description">
<h2>Description<a class="headerlink" href="#description" title="Permalink to this heading"></a></h2>
<p>MLv is the local (Richter) magnitude (<span id="id1">Richter [<a class="reference internal" href="../base/references.html#id62" title="C.F. Richter. An instrumental earthquake magnitude scale. Bull. Seismol. Soc. Am., 1:1 - 32, 1935. URL: https://resolver.caltech.edu/CaltechAUTHORS:20140804-143558638, doi:10.1785/BSSA0250010001.">57</a>]</span>) computed from amplitudes measured on the
vertical component.</p>
<p>MLv is the local (Richter) magnitude (<span id="id1">Richter [<a class="reference internal" href="../base/references.html#id81" title="C.F. Richter. An instrumental earthquake magnitude scale. Bull. Seismol. Soc. Am., 1:1 - 32, 1935. URL: https://resolver.caltech.edu/CaltechAUTHORS:20140804-143558638, doi:10.1785/BSSA0250010001.">66</a>]</span>) computed from
amplitudes measured on the vertical component.</p>
<p>General (default) conditions apply:</p>
<ul class="simple">
<li><p>Amplitude unit in SeisComP: <strong>millimeter</strong> (mm) by simulation of a <a class="reference internal" href="../base/glossary.html#term-Wood-Anderson-seismometer"><span class="xref std std-term">Wood-Anderson seismometer</span></a>.</p></li>
<li><p>Amplitude unit in SeisComP: <strong>millimeter</strong> (mm) by simulation of a
<a class="reference internal" href="../base/glossary.html#term-Wood-Anderson-seismometer"><span class="xref std std-term">Wood-Anderson seismometer</span></a>.</p></li>
<li><p>Time window: 150 s by <a class="reference internal" href="scautopick.html#scautopick"><span class="std std-ref">scautopick</span></a> or distance dependent, configurable.</p></li>
<li><p>Default distance range: 0 - 8 deg, maximum is configurable
<a class="reference internal" href="global.html#confval-magnitudes.MLv.maxDistanceKm"><code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.MLv.maxDistanceKm</span></code></a>, measurements beyond 8 deg will be
<code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.MLv.maxDist</span></code>, measurements beyond 8 deg will be
strictly ignored.</p></li>
<li><p>Depth range: no limitation.</p></li>
</ul>
@ -97,17 +98,17 @@ for measuring amplitudes are configurable in the global bindings.</p>
<section id="station-magnitudes">
<h3>Station Magnitudes<a class="headerlink" href="#station-magnitudes" title="Permalink to this heading"></a></h3>
<p>The individual station MLv is calculated up to the epicentral distance
<a class="reference internal" href="global.html#confval-magnitudes.MLv.maxDistanceKm"><code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.MLv.maxDistanceKm</span></code></a> using the following formula:</p>
<code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.MLv.maxDist</span></code> using the following formula:</p>
<div class="math">
<p><img src="../_images/math/f73f0c80f57e4c0aa9f75af47267f7aa55522b40.png" alt="MLv = \log10(A) - \log10(A0)"/></p>
<p><img src="../_images/math/f73f0c80f57e4c0aa9f75af47267f7aa55522b40.svg" alt="MLv = \log10(A) - \log10(A0)"/></p>
</div><p>A is the MLv Wood-Anderson amplitude in millimeters. The second term
is the empirical calibration function, which in turn is a function
of the epicentral distance (see <span id="id2">Richter [<a class="reference internal" href="../base/references.html#id62" title="C.F. Richter. An instrumental earthquake magnitude scale. Bull. Seismol. Soc. Am., 1:1 - 32, 1935. URL: https://resolver.caltech.edu/CaltechAUTHORS:20140804-143558638, doi:10.1785/BSSA0250010001.">57</a>]</span>). This calibration
of the epicentral distance (see <span id="id2">Richter [<a class="reference internal" href="../base/references.html#id81" title="C.F. Richter. An instrumental earthquake magnitude scale. Bull. Seismol. Soc. Am., 1:1 - 32, 1935. URL: https://resolver.caltech.edu/CaltechAUTHORS:20140804-143558638, doi:10.1785/BSSA0250010001.">66</a>]</span>). This calibration
function can be configured globally or per station using global
bindings or the global module configuration variable
module.trunk.global.magnitudes.MLv.logA0 in <code class="file docutils literal notranslate"><span class="pre">global.cfg</span></code>, e.g.</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">module</span><span class="o">.</span><span class="n">trunk</span><span class="o">.</span><span class="k">global</span><span class="o">.</span><span class="n">magnitudes</span><span class="o">.</span><span class="n">MLv</span><span class="o">.</span><span class="n">logA0</span> <span class="o">=</span> <span class="s2">&quot;0:-1.3,60:-2.8,100:-3.0,400:-4.5,1000:-5.85&quot;</span>
<span class="n">module</span><span class="o">.</span><span class="n">trunk</span><span class="o">.</span><span class="k">global</span><span class="o">.</span><span class="n">magnitudes</span><span class="o">.</span><span class="n">MLv</span><span class="o">.</span><span class="n">maxDistanceKm</span> <span class="o">=</span> <span class="s2">&quot;-1&quot;</span>
<span class="n">module</span><span class="o">.</span><span class="n">trunk</span><span class="o">.</span><span class="k">global</span><span class="o">.</span><span class="n">magnitudes</span><span class="o">.</span><span class="n">MLv</span><span class="o">.</span><span class="n">maxDist</span> <span class="o">=</span> <span class="mi">1000</span><span class="n">km</span>
</pre></div>
</div>
<p>The logA0 configuration string consists of an arbitrary number of
@ -117,13 +118,13 @@ and the value corresponds to the <em>log10(A0)</em> term above.</p>
interpolation. E.g. for the above default specification, at a
distance of 80 km the <em>log10(A0)</em> value would be</p>
<div class="math">
<p><img src="../_images/math/6e45a883605015d556a6b6fe63821c64d8263242.png" alt="\log10(A0) &amp;= ((-3.0)-(-2.8))*(80-60)/(100-60)-2.8 \\
<p><img src="../_images/math/6e45a883605015d556a6b6fe63821c64d8263242.svg" alt="\log10(A0) &amp;= ((-3.0)-(-2.8))*(80-60)/(100-60)-2.8 \\
&amp;= -2.9"/></p>
</div><p>In other words, at 80 km distance the magnitude would be</p>
<div class="math">
<p><img src="../_images/math/e43775c444e67a786957a45f52e1b6a4b4d757a8.png" alt="MLv &amp;= \log10(A) - (-2.9) \\
<p><img src="../_images/math/e43775c444e67a786957a45f52e1b6a4b4d757a8.svg" alt="MLv &amp;= \log10(A) - (-2.9) \\
&amp;= \log10(A) + 2.9"/></p>
</div><p>which is according to the original Richter formula <span id="id3">[<a class="reference internal" href="../base/references.html#id62" title="C.F. Richter. An instrumental earthquake magnitude scale. Bull. Seismol. Soc. Am., 1:1 - 32, 1935. URL: https://resolver.caltech.edu/CaltechAUTHORS:20140804-143558638, doi:10.1785/BSSA0250010001.">57</a>]</span> if the
</div><p>which is according to the original Richter formula <span id="id3">[<a class="reference internal" href="../base/references.html#id81" title="C.F. Richter. An instrumental earthquake magnitude scale. Bull. Seismol. Soc. Am., 1:1 - 32, 1935. URL: https://resolver.caltech.edu/CaltechAUTHORS:20140804-143558638, doi:10.1785/BSSA0250010001.">66</a>]</span> if the
amplitude is measured in millimeters.</p>
</section>
<section id="network-magnitude">
@ -141,18 +142,18 @@ per network or per station using the configuration variables. Instead configurin
lots of global bindings profiles or station bindings one line per parameter can be
added to the global module configuration (<code class="file docutils literal notranslate"><span class="pre">global.cfg</span></code>), e.g.</p>
<p>global:</p>
<div class="highlight-params notranslate"><div class="highlight"><pre><span></span>module.trunk.global.magnitudes.MLv.logA0 = &quot;0:-1.3,60:-2.8,100:-3.0,400:-4.5,1000:-5.85&quot;
module.trunk.global.magnitudes.MLv.maxDistanceKm = -1
<div class="highlight-properties notranslate"><div class="highlight"><pre><span></span><span class="na">module.trunk.global.magnitudes.MLv.logA0</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">&quot;0:-1.3,60:-2.8,100:-3.0,400:-4.5,1000:-5.85&quot;</span>
<span class="na">module.trunk.global.magnitudes.MLv.maxDist</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">1000km</span>
</pre></div>
</div>
<p>or per network:</p>
<div class="highlight-params notranslate"><div class="highlight"><pre><span></span>module.trunk.GR.magnitudes.MLv.logA0 = &quot;0:-1.3,60:-2.8,100:-3.0,400:-4.5,1000:-5.85&quot;
module.trunk.GR.magnitudes.MLv.maxDistanceKm = -1
<div class="highlight-properties notranslate"><div class="highlight"><pre><span></span><span class="na">module.trunk.GR.magnitudes.MLv.logA0</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">&quot;0:-1.3,60:-2.8,100:-3.0,400:-4.5,1000:-5.85&quot;</span>
<span class="na">module.trunk.GR.magnitudes.MLv.maxDist</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">1000km</span>
</pre></div>
</div>
<p>or per station:</p>
<div class="highlight-params notranslate"><div class="highlight"><pre><span></span>module.trunk.GR.MOX.magnitudes.MLv.logA0 = &quot;0:-1.3,60:-2.8,100:-3.0,400:-4.5,1000:-5.85&quot;
module.trunk.GR.MOX.magnitudes.MLv.maxDistanceKm = -1
<div class="highlight-properties notranslate"><div class="highlight"><pre><span></span><span class="na">module.trunk.GR.MOX.magnitudes.MLv.logA0</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">&quot;0:-1.3,60:-2.8,100:-3.0,400:-4.5,1000:-5.85&quot;</span>
<span class="na">module.trunk.GR.MOX.magnitudes.MLv.maxDist</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">1000km</span>
</pre></div>
</div>
<p>Set the configuration and calibration parameters in the global bindings. By
@ -223,7 +224,7 @@ default MLv is computed by <a class="reference internal" href="scautopick.html#s
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>MN &#8212; SeisComP Release documentation</title>
<title>MN &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -77,7 +77,7 @@
<p>Nuttli magnitude for Canada and other Cratonic regions</p>
<section id="description">
<h2>Description<a class="headerlink" href="#description" title="Permalink to this heading"></a></h2>
<p>MN is the Nuttli magnitude <span id="id1">[<a class="reference internal" href="../base/references.html#id58" title="O.W. Nuttli. Seismic wave attenuation and magnitude relations for eastern north america. J. Geophys. Res., 5:876 - 885, 1973. doi:10.1029/JB078i005p00876.">53</a>]</span> for Canada and other Cratonic
<p>MN is the Nuttli magnitude <span id="id1">[<a class="reference internal" href="../base/references.html#id76" title="O.W. Nuttli. Seismic wave attenuation and magnitude relations for eastern north america. J. Geophys. Res., 5:876 - 885, 1973. doi:10.1029/JB078i005p00876.">62</a>]</span> for Canada and other Cratonic
regions. It is implemented by the <em>nuttli</em> plugin according to the
Geological Survey of Canada (NRCan).</p>
<p>For measuring AMN amplitudes and for computing MN magnitudes <cite>SeisComP</cite> provides
@ -120,47 +120,6 @@ region-specific calibration parameters in the global module configuration
<p>Adjust MN-specific global bindings parameters in the magnitude section and define
the region polygons in the global module configuration (magnitude section).</p>
</section>
</section>
<section id="module-configuration">
<span id="global-mn-configuration"></span><h2>Module Configuration<a class="headerlink" href="#module-configuration" title="Permalink to this heading"></a></h2>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p><strong>amplitudes.MN.*</strong>
<em>Amplitude control parameters for MN (Nuttli magnitude).</em></p>
</div>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-amplitudes.MN.velocityModel">
<span class="sig-name descname"><span class="pre">amplitudes.MN.velocityModel</span></span><a class="headerlink" href="#confval-amplitudes.MN.velocityModel" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">iasp91</span></code></p>
<p>Type: <em>string</em></p>
<p>The travel time table set compiled for LocSAT. The tables
are located in &quot;share/locsat/tables/[vmodel].*&quot;.</p>
</dd></dl>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p><strong>magnitudes.MN.*</strong>
<em>Regionalization of MN (Nuttli magnitude).</em></p>
</div>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-magnitudes.MN.region">
<span class="sig-name descname"><span class="pre">magnitudes.MN.region</span></span><a class="headerlink" href="#confval-magnitudes.MN.region" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">&#64;DATADIR&#64;/magnitudes/MN/MN.bna</span></code></p>
<p>Type: <em>path</em></p>
<p>The path to the BNA file which defines the valid region
for the MN magnitude. Note that the entire path from
source to receiver must lie entirely within the polygon(s).</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-magnitudes.MN.offsetMw">
<span class="sig-name descname"><span class="pre">magnitudes.MN.offsetMw</span></span><a class="headerlink" href="#confval-magnitudes.MN.offsetMw" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>double</em></p>
<p>The offset applied to the MN network magnitude to
estimate Mw(MN). If not configured then no Mw estimation
will be applied.</p>
</dd></dl>
</section>
</section>
@ -194,7 +153,6 @@ will be applied.</p>
<li><a class="reference internal" href="#scmag">scmag</a></li>
</ul>
</li>
<li><a class="reference internal" href="#module-configuration">Module Configuration</a></li>
</ul>
</li>
</ul>
@ -229,7 +187,7 @@ will be applied.</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>Ms_20 &#8212; SeisComP Release documentation</title>
<title>Ms_20 &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -87,24 +87,24 @@ corrected for the instrument response of a <a class="reference internal" href=".
<section id="station-magnitude">
<h3>Station Magnitude<a class="headerlink" href="#station-magnitude" title="Permalink to this heading"></a></h3>
<p>Ms_20 is the surface-wave magnitude at 20 s period based on the recommendations
by the IASPEI magnitude working group issued on 27 March, 2013 (<span id="id1">IASPEI [<a class="reference internal" href="../base/references.html#id40" title="IASPEI. Summary of magnitude working group recommendations on standard procedures for determining earthquake magnitudes from digital data. IASPEI Website, 2013. URL: http://www.iaspei.org/commissions/commission-on-seismological-observation-and-interpretation/Summary_WG_recommendations_20130327.pdf.">46</a>]</span>).</p>
by the IASPEI magnitude working group issued on 27 March, 2013 (<span id="id1">IASPEI [<a class="reference internal" href="../base/references.html#id55" title="IASPEI. Summary of magnitude working group recommendations on standard procedures for determining earthquake magnitudes from digital data. IASPEI Website, 2013. URL: http://www.iaspei.org/commissions/commission-on-seismological-observation-and-interpretation/Summary_WG_recommendations_20130327.pdf.">54</a>]</span>).</p>
<div class="math">
<p><img src="../_images/math/e09fa212079ab87241b0d94c484f2a485283c708.png" alt="M_s = \log \left(\frac{A}{T}\right) + 1.66 \log(\Delta) + 0.3"/></p>
<p><img src="../_images/math/e09fa212079ab87241b0d94c484f2a485283c708.svg" alt="M_s = \log \left(\frac{A}{T}\right) + 1.66 \log(\Delta) + 0.3"/></p>
</div><p>with</p>
<p>A: <a class="reference internal" href="../base/glossary.html#term-WWSSN_LP"><span class="xref std std-term">WWSSN_LP</span></a> corrected ground displacement in units of nm measured on the vertical-component
seismogram as the maximum absolute trace amplitude of a surface wave at periods between
18 s and 22 s,</p>
<p>T: period of the surface wave in seconds.</p>
<p>The term <em>Ms_20</em> is chosen in accordance with the IASPEI standard as of 2013 (<span id="id2">IASPEI [<a class="reference internal" href="../base/references.html#id40" title="IASPEI. Summary of magnitude working group recommendations on standard procedures for determining earthquake magnitudes from digital data. IASPEI Website, 2013. URL: http://www.iaspei.org/commissions/commission-on-seismological-observation-and-interpretation/Summary_WG_recommendations_20130327.pdf.">46</a>]</span>).
<p>The term <em>Ms_20</em> is chosen in accordance with the IASPEI standard as of 2013 (<span id="id2">IASPEI [<a class="reference internal" href="../base/references.html#id55" title="IASPEI. Summary of magnitude working group recommendations on standard procedures for determining earthquake magnitudes from digital data. IASPEI Website, 2013. URL: http://www.iaspei.org/commissions/commission-on-seismological-observation-and-interpretation/Summary_WG_recommendations_20130327.pdf.">54</a>]</span>).
Alternatively, the term <em>Ms(20)</em> may be used.</p>
<ul class="simple">
<li><p>Amplitude unit in <cite>SeisComP</cite>: <strong>nanometer</strong> (nm)</p></li>
<li><p>Time window: 0 s - distance (km) / 3.5 km/s + 30 s</p></li>
<li><p>Period range: 18 s - 22 s, configurable: <a class="reference internal" href="global.html#confval-magnitudes.Ms_20.lowerPeriod"><code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.Ms_20.lowerPeriod</span></code></a>,
<a class="reference internal" href="global.html#confval-magnitudes.Ms_20.upperPeriod"><code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.Ms_20.upperPeriod</span></code></a></p></li>
<li><p>Default distance range: 20 - 160 deg, configurable: <a class="reference internal" href="global.html#confval-magnitudes.Ms_20.minDist"><code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.Ms_20.minDist</span></code></a>,
<a class="reference internal" href="global.html#confval-magnitudes.Ms_20.maxDist"><code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.Ms_20.maxDist</span></code></a></p></li>
<li><p>Depth range: &lt;= 100 km, configurable: <a class="reference internal" href="global.html#confval-magnitudes.Ms_20.maxDepth"><code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.Ms_20.maxDepth</span></code></a></p></li>
<li><p>Period range: 18 s - 22 s, configurable: <code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.Ms_20.lowerPeriod</span></code>,
<code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.Ms_20.upperPeriod</span></code></p></li>
<li><p>Default distance range: 20 - 160 deg, configurable: <code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.Ms_20.minDist</span></code>,
<code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.Ms_20.maxDist</span></code></p></li>
<li><p>Depth range: &lt;= 100 km, configurable: <code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.Ms_20.maxDepth</span></code></p></li>
</ul>
</section>
<section id="network-magnitude">
@ -184,7 +184,7 @@ Ms_20 to the list of computed amplitudes and magnitudes in the configuration of
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>NonLinLoc &#8212; SeisComP Release documentation</title>
<title>NonLinLoc &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -443,8 +443,8 @@ java<span class="w"> </span>-classpath<span class="w"> </span><span class="nv">$
<dt class="sig sig-object std" id="confval-NonLinLoc.outputPath">
<span class="sig-name descname"><span class="pre">NonLinLoc.outputPath</span></span><a class="headerlink" href="#confval-NonLinLoc.outputPath" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">/tmp/sc3.nll</span></code></p>
<p>Type: <em>path</em></p>
<p>Defines the output path for all native NonLinLoc input and output files.</p>
<p>Type: <em>directory</em></p>
<p>Defines the output directory for all native NonLinLoc input and output files.</p>
</dd></dl>
<dl class="std confval">
@ -469,8 +469,9 @@ Setting to false reduces file i/o and saves disk space.</p>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-NonLinLoc.controlFile">
<span class="sig-name descname"><span class="pre">NonLinLoc.controlFile</span></span><a class="headerlink" href="#confval-NonLinLoc.controlFile" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>path</em></p>
<p>The default NonLinLoc control file to use.</p>
<dd><p>Type: <em>file</em></p>
<p>The default NonLinLoc control file to use. Parameters
therein are overridden per profile.</p>
</dd></dl>
<dl class="std confval">
@ -532,7 +533,7 @@ NonLinLoc.profile.c.value1<span class="w"> </span><span class="o">=</span><span
<dt class="sig sig-object std" id="confval-NonLinLoc.profile.-name.earthModelID">
<span class="sig-name descname"><span class="pre">NonLinLoc.profile.$name.earthModelID</span></span><a class="headerlink" href="#confval-NonLinLoc.profile.-name.earthModelID" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>earthModelID that is stored in the created origin.</p>
<p>Earth model ID stored in the created origin.</p>
</dd></dl>
<dl class="std confval">
@ -540,14 +541,20 @@ NonLinLoc.profile.c.value1<span class="w"> </span><span class="o">=</span><span
<span class="sig-name descname"><span class="pre">NonLinLoc.profile.$name.methodID</span></span><a class="headerlink" href="#confval-NonLinLoc.profile.-name.methodID" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">NonLinLoc</span></code></p>
<p>Type: <em>string</em></p>
<p>methodID that is stored in the created origin.</p>
<p>Method ID stored in the created origin.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-NonLinLoc.profile.-name.tablePath">
<span class="sig-name descname"><span class="pre">NonLinLoc.profile.$name.tablePath</span></span><a class="headerlink" href="#confval-NonLinLoc.profile.-name.tablePath" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>path</em></p>
<p>Path to travel time tables (grids).</p>
<p>Path to travel time tables (grids) including the
full path and the names of the table files before
the phase name.</p>
<p>Example:</p>
<p>&#64;DATADIR&#64;/nonlinloc/iasp91/iasp91 for P and S tables
files
seiscomp/share/nonlinloc/iasp91/iasp91.[PS].*</p>
</dd></dl>
<dl class="std confval">
@ -563,15 +570,15 @@ that use the same station code.
To overcome this limitation this parameter could be set in a more general way, for
example &#64;NET&#64;_&#64;STA&#64;_&#64;LOC&#64;. In this way NonLinLoc will look for
travel time table (grid) files of the form: tablePath.P.&#64;NET&#64;_&#64;STA&#64;_&#64;LOC&#64;.time.*
Where &#64;NET&#64; &#64;STA&#64; &#64;LOC&#64; are just placeholder for the actual codes</p>
Where &#64;NET&#64; &#64;STA&#64; &#64;LOC&#64; are just placeholder for the actual codes.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-NonLinLoc.profile.-name.controlFile">
<span class="sig-name descname"><span class="pre">NonLinLoc.profile.$name.controlFile</span></span><a class="headerlink" href="#confval-NonLinLoc.profile.-name.controlFile" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>path</em></p>
<p>Control file of the current profile. If not set, the default
control file will be used instead.</p>
<dd><p>Type: <em>file</em></p>
<p>Control file of the current profile overriding
parameters of the default control file.</p>
</dd></dl>
<dl class="std confval">
@ -579,9 +586,8 @@ control file will be used instead.</p>
<span class="sig-name descname"><span class="pre">NonLinLoc.profile.$name.transform</span></span><a class="headerlink" href="#confval-NonLinLoc.profile.-name.transform" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">GLOBAL</span></code></p>
<p>Type: <em>string</em></p>
<p>Transformation type of the configured region. Supported are
SIMPLE and GLOBAL.</p>
<p>Default: GLOBAL is assumed.</p>
<p>Transformation type of the configured region.
Supported are SIMPLE and GLOBAL.</p>
</dd></dl>
<dl class="std confval">
@ -591,10 +597,16 @@ SIMPLE and GLOBAL.</p>
<p>Defines the 4 corner values of the epicentral region for selecting the profile.
The original epicentre must be within the region.</p>
<p>If transform is GLOBAL: min_lat, min_lon, max_lat, max_lon.
The values define the geographic corner coordinates. Unit is degree.</p>
<p>If transform is SIMPLE: xmin, ymin, xmax, ymax.
The values define the region relative to the configured origin.
Unit is km.</p>
The values define the geographic corner coordinates.
Unit: degree.</p>
<p>If transform is SIMPLE: min_x, min_y, max_x, max_y.
The values define the region relative to the origin
configured with &quot;origin&quot;.
Unit: km.</p>
<p>When this parameter is empty, the generated NonLinLoc
configuration is automatically overwritten with
TRANS GLOBAL.
Otherwise TRANS from &quot;controlFile&quot; applies.</p>
</dd></dl>
<dl class="std confval">
@ -603,8 +615,7 @@ Unit is km.</p>
<dd><p>Type: <em>list:double</em></p>
<p>Unit: <em>deg</em></p>
<p>Only used for transformation SIMPLE. Expects 2 values: latitude, longitude.
The value define the geographic origin of the area spanned by region.
Unit is degree.</p>
The value define the geographic origin of the area spanned by region.</p>
</dd></dl>
<dl class="std confval">
@ -612,8 +623,8 @@ Unit is degree.</p>
<span class="sig-name descname"><span class="pre">NonLinLoc.profile.$name.rotation</span></span><a class="headerlink" href="#confval-NonLinLoc.profile.-name.rotation" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>double</em></p>
<p>Unit: <em>deg</em></p>
<p>Only used for transformation SIMPLE. Defines the rotation around the
origin of the defined region.</p>
<p>Only used for transformation SIMPLE. Defines the
rotation around the origin of the defined region.</p>
</dd></dl>
</section>
@ -688,7 +699,7 @@ origin of the defined region.</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>RecordStream &#8212; SeisComP Release documentation</title>
<title>RecordStream &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -175,7 +175,7 @@ URL encoded parameters are:</p>
<h4>Examples<a class="headerlink" href="#examples" title="Permalink to this heading"></a></h4>
<ul class="simple">
<li><p><code class="docutils literal notranslate"><span class="pre">slink://</span></code></p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">slink://geofon.gfz-potsdam.de?timeout=60&amp;retries=5</span></code></p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">slink://geofon.gfz.de?timeout=60&amp;retries=5</span></code></p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">slink://localhost:18000</span></code></p></li>
</ul>
</section>
@ -198,7 +198,7 @@ URL encoded parameters are:</p>
<h4>Examples<a class="headerlink" href="#id2" title="Permalink to this heading"></a></h4>
<ul class="simple">
<li><p><code class="docutils literal notranslate"><span class="pre">arclink://</span></code></p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">arclink://geofon.gfz-potsdam.de?user=foo&amp;pwd=secret</span></code></p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">arclink://geofon.gfz.de?user=foo&amp;pwd=secret</span></code></p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">arclink://localhost:18042</span></code></p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">arclink://localhost?dump=test.mseed</span></code></p></li>
</ul>
@ -225,7 +225,7 @@ it needs to be complete up until the <cite>query</cite> resource.</p>
<ul class="simple">
<li><p><code class="docutils literal notranslate"><span class="pre">fdsnws://service.iris.edu</span></code></p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">fdsnws://service.iris.edu:80/fdsnws/dataselect/1/query</span></code></p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">fdsnwss://geofon.gfz-potsdam.de</span></code></p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">fdsnwss://geofon.gfz.de</span></code></p></li>
</ul>
</section>
</section>
@ -733,7 +733,7 @@ stream scheme.</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>StdLoc &#8212; SeisComP Release documentation</title>
<title>StdLoc &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -83,7 +83,11 @@ are generic enough to work at larger scales as well.</p>
</section>
<section id="plugin">
<h2>Plugin<a class="headerlink" href="#plugin" title="Permalink to this heading"></a></h2>
<p>To enable StdLoc the plugin <code class="docutils literal notranslate"><span class="pre">stdloc</span></code> must be loaded.</p>
<p>To enable StdLoc the plugin <code class="docutils literal notranslate"><span class="pre">stdloc</span></code> must be loaded. Add this value to the
global configuration parameter <a class="reference internal" href="global.html#confval-plugins"><code class="xref std std-confval docutils literal notranslate"><span class="pre">plugins</span></code></a> as or similar to</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>,stdloc
</pre></div>
</div>
</section>
<section id="how-does-it-work">
<h2>How does it work?<a class="headerlink" href="#how-does-it-work" title="Permalink to this heading"></a></h2>
@ -97,11 +101,9 @@ is used in combination with a pick associator: it provides the initial location
estimate and StdLoc will improve it. When used in <a class="reference internal" href="scolv.html#scolv"><span class="std std-ref">scolv</span></a> or <a class="reference internal" href="screloc.html#screloc"><span class="std std-ref">screloc</span></a>,
the location of the origin to be relocated is used as starting estimate.
The configuration doesnt require any mandatory parameters:</p>
<blockquote>
<div><div class="highlight-params notranslate"><div class="highlight"><pre><span></span>method = LeastSquares
<div class="highlight-params notranslate"><div class="highlight"><pre><span></span>method = LeastSquares
</pre></div>
</div>
</div></blockquote>
</li>
<li><p>GridSearch: finds the source parameters by evaluating the hypocenter probability
of each point in a grid and returning the maximum likelihood hypocenter.
@ -112,14 +114,12 @@ difficult to locate via other methods or to verify the uncertainty of a solution
The following example configuration computes a grid search around the average
location of the picked stations. The grid points are spaced apart 0.5km
horizontally and 2km vertically.</p>
<blockquote>
<div><div class="highlight-params notranslate"><div class="highlight"><pre><span></span>method = GridSearch
<div class="highlight-params notranslate"><div class="highlight"><pre><span></span>method = GridSearch
GridSearch.center = auto,auto,15
GridSearch.size = 40,40,30
GridSearch.numPoints = 81,81,16
</pre></div>
</div>
</div></blockquote>
</li>
<li><p>GridSearch+LeastSquares: this method can be used in very complex networks where
a bad initial location estimates can get LeastSquares stuck in a local minimum.
@ -129,14 +129,12 @@ likelihood solution. This method is intended to be used in <a class="reference i
<a class="reference internal" href="scolv.html#scolv"><span class="std std-ref">scolv</span></a> to relocate existing events.
The following example configuration returns the best among the 75 (5x5x3)
LeastSquares solutions, computed for every point in the grid.</p>
<blockquote>
<div><div class="highlight-params notranslate"><div class="highlight"><pre><span></span>method = GridSearch+LeastSquares
<div class="highlight-params notranslate"><div class="highlight"><pre><span></span>method = GridSearch+LeastSquares
GridSearch.center = auto,auto,15
GridSearch.size = 100,100,30
GridSearch.numPoints = 5,5,3
</pre></div>
</div>
</div></blockquote>
</li>
<li><p>OctTree: this method produces similar results to GridSearch but it is extremely
faster and it follows the NonLinLoc approach. The OctTree search starts by
@ -154,8 +152,7 @@ This method is intended to be used in <a class="reference internal" href="screlo
relocate existing events.
The following example is a plausible configuration for the entire Swiss
network:</p>
<blockquote>
<div><div class="highlight-params notranslate"><div class="highlight"><pre><span></span>method = OctTree
<div class="highlight-params notranslate"><div class="highlight"><pre><span></span>method = OctTree
GridSearch.center = 47.0,8.5,50
GridSearch.size = 700,700,100
GridSearch.numPoints = 21,21,11
@ -163,7 +160,6 @@ OctTree.maxIterations = 100000
OctTree.minCellSize = 0.001
</pre></div>
</div>
</div></blockquote>
<p>However in this example we are at the size limit for a flat earth study
geometry and for bigger regions <cite>GridSearch.center</cite> should be set to
<cite>auto</cite> and <cite>GridSearch.size</cite> to a smaller size.</p>
@ -175,8 +171,7 @@ This method is intended to be used in <a class="reference internal" href="screlo
relocate existing events.
The following example is a plausible configuration for the entire Swiss
network:</p>
<blockquote>
<div><div class="highlight-params notranslate"><div class="highlight"><pre><span></span>method = OctTree+LeastSquares
<div class="highlight-params notranslate"><div class="highlight"><pre><span></span>method = OctTree+LeastSquares
GridSearch.center = 47.0,8.5,50
GridSearch.size = 700,700,100
GridSearch.numPoints = 21,21,11
@ -184,7 +179,6 @@ OctTree.maxIterations = 10000
OctTree.minCellSize = 1.0
</pre></div>
</div>
</div></blockquote>
<p>However in this example we are at the size limit for a flat earth study
geometry and for bigger regions <cite>GridSearch.center</cite> should be set to
<cite>auto</cite> and <cite>GridSearch.size</cite> to a smaller size.</p>
@ -200,9 +194,9 @@ search algorithm is based on NonLibLoc by Antony Lomax.</p>
simplifications that are common for regional seismicity have to be removed.
In particular the locator should take into consideration:</p>
<ul class="simple">
<li><p>station elevation and even negative elevation (e.g. borehole sensors)</p></li>
<li><p>earthquake location can be above a seismic sensor (e.g. borehole sensors)</p></li>
<li><p>possible negative earthquake depth (above surface)</p></li>
<li><p>Station elevation and even negative elevation (e.g. borehole sensors)</p></li>
<li><p>Earthquake location can be above a seismic sensor (e.g. borehole sensors)</p></li>
<li><p>Possible negative earthquake depth (above surface).</p></li>
</ul>
<p>More importantly the travel time tables used by the locator must be able to take
into consideration all the above too.</p>
@ -248,6 +242,7 @@ StdLoc.profile.c.value1<span class="w"> </span><span class="o">=</span><span cla
<span class="sig-name descname"><span class="pre">StdLoc.profile.$name.method</span></span><a class="headerlink" href="#confval-StdLoc.profile.-name.method" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">LeastSquares</span></code></p>
<p>Type: <em>string</em></p>
<p>Values: <code class="docutils literal notranslate"><span class="pre">LeastSquares,GridSearch,OctTree,GridSearch+LeastSquares,OctTree+LeastSquares</span></code></p>
<p>The location method to use: LeastSquares, GridSearch,
OctTree, GridSearch+LeastSquares or OctTree+LeastSquares.</p>
</dd></dl>
@ -319,6 +314,7 @@ applies.</p>
<span class="sig-name descname"><span class="pre">StdLoc.profile.$name.confLevel</span></span><a class="headerlink" href="#confval-StdLoc.profile.-name.confLevel" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">0.9</span></code></p>
<p>Type: <em>double</em></p>
<p>Range: <code class="docutils literal notranslate"><span class="pre">0.5:1.0</span></code></p>
<p>Confidence level, between 0.5 and 1.0, used in
computing the hypocenter confidence ellipsoid.</p>
</dd></dl>
@ -377,6 +373,7 @@ and the point will be in the grid center.</p>
<span class="sig-name descname"><span class="pre">StdLoc.profile.$name.GridSearch.misfitType</span></span><a class="headerlink" href="#confval-StdLoc.profile.-name.GridSearch.misfitType" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">L1</span></code></p>
<p>Type: <em>string</em></p>
<p>Values: <code class="docutils literal notranslate"><span class="pre">L1,L2</span></code></p>
<p>The type of misfit to use, from which
the likelihood function is derived: L1 or L2 norm.
L1 is less sensitive to outliers and so more
@ -472,6 +469,7 @@ system of equations.</p>
<span class="sig-name descname"><span class="pre">StdLoc.profile.$name.LeastSquares.solverType</span></span><a class="headerlink" href="#confval-StdLoc.profile.-name.LeastSquares.solverType" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">LSMR</span></code></p>
<p>Type: <em>string</em></p>
<p>Values: <code class="docutils literal notranslate"><span class="pre">LSMR,LSQR</span></code></p>
<p>Algorithm to use: either LSMR or LSQR.</p>
</dd></dl>
@ -539,7 +537,7 @@ system of equations.</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>import_inv &#8212; SeisComP Release documentation</title>
<title>import_inv &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,12 +12,12 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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="inv2dlsv" href="inv2dlsv.html" />
<link rel="next" title="invextr" href="invextr.html" />
<link rel="prev" title="fdsnxml2inv" href="fdsnxml2inv.html" />
</head>
<body>
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -43,7 +43,7 @@
</a>
</li>
<li class="right">
<a href="inv2dlsv.html" title="inv2dlsv"
<a href="invextr.html" title="invextr"
accesskey="N">
next
</a>
@ -96,19 +96,15 @@ an input format such as</p>
<td><p><span class="xref std std-ref">scml2inv</span></p></td>
<td><p><a class="reference internal" href="../base/concepts/inventory.html#concepts-inventory"><span class="std std-ref">SeisComP inventory XML</span></a>, schema: <code class="file docutils literal notranslate"><span class="pre">$SEISCOMP_ROOT/share/xml/</span></code></p></td>
</tr>
<tr class="row-odd"><td><p>sc3</p></td>
<td><p><span class="xref std std-ref">sc32inv</span></p></td>
<td><p>Alias for scml for backwards compatibility to SeisComP3</p></td>
</tr>
<tr class="row-even"><td><p>arclink</p></td>
<tr class="row-odd"><td><p>arclink</p></td>
<td><p><span class="xref std std-ref">arclink2inv</span></p></td>
<td><p>Arclink inventory XML</p></td>
</tr>
<tr class="row-odd"><td><p>dlsv</p></td>
<tr class="row-even"><td><p>dlsv</p></td>
<td><p><a class="reference internal" href="dlsv2inv.html#dlsv2inv"><span class="std std-ref">dlsv2inv</span></a></p></td>
<td><p><a class="reference external" href="http://www.iris.edu/data/dataless.htm">dataless SEED</a></p></td>
</tr>
<tr class="row-even"><td><p>fdsnxml</p></td>
<tr class="row-odd"><td><p>fdsnxml</p></td>
<td><p><a class="reference internal" href="fdsnxml2inv.html#fdsnxml2inv"><span class="std std-ref">fdsnxml2inv</span></a></p></td>
<td><p><a class="reference external" href="http://www.fdsn.org/xml/station/">FDSN StationXML</a></p></td>
</tr>
@ -345,8 +341,8 @@ Equivalent to --verbosity=4 --console=1 .</p>
</div>
<div>
<h4>Next topic</h4>
<p class="topless"><a href="inv2dlsv.html"
title="next chapter">inv2dlsv</a></p>
<p class="topless"><a href="invextr.html"
title="next chapter">invextr</a></p>
</div>
<div role="note" aria-label="source link">
<h3>This Page</h3>
@ -367,7 +363,7 @@ Equivalent to --verbosity=4 --console=1 .</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>invextr &#8212; SeisComP Release documentation</title>
<title>invextr &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,21 +12,21 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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="scinv" href="scinv.html" />
<link rel="prev" title="inv2dlsv" href="inv2dlsv.html" />
<link rel="prev" title="import_inv" href="import_inv.html" />
</head>
<body>
<div class="header">
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -49,7 +49,7 @@
</a>
</li>
<li class="right">
<a href="inv2dlsv.html" title="inv2dlsv"
<a href="import_inv.html" title="import_inv"
accesskey="P">
previous
</a>
@ -74,41 +74,49 @@
<section id="invextr">
<span id="id1"></span><h1>invextr<a class="headerlink" href="#invextr" title="Permalink to this heading"></a></h1>
<p><strong>Extract channels from inventory.</strong></p>
<p><strong>Extract and clean or remove streams from inventory.</strong></p>
<section id="description">
<h2>Description<a class="headerlink" href="#description" title="Permalink to this heading"></a></h2>
<p>invextr reads and modifies inventory XML provided as file or on stdin:</p>
<ul class="simple">
<li><p>Extract or remove networks, stations and channels based on</p>
<ul>
<li><p>channel IDs</p></li>
<li><p>geographic region</p></li>
<li><p>time</p></li>
<li><p>Extract or remove networks, stations, sensor locations and channels based on</p>
<ul class="simple">
<li><p>stream IDs,</p></li>
<li><p>geographic region,</p></li>
<li><p>time.</p></li>
</ul>
</li>
<li><p>Clean inventories from unused objects such as data loggers, sensors or
instrument responses.</p></li>
<li><p>Clean inventories from unreferenced objects such as data loggers, sensors or
instrument responses when extracting.</p>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>Cleaning inventory may also be achieved by merging inventories with
<a class="reference internal" href="scinv.html#scinv"><span class="std std-ref">scinv</span></a>.</p>
</div>
</li>
</ul>
<p>The important parameters are:</p>
<ul class="simple">
<li><p>Channel ID list (required)</p></li>
<li><p>Stream ID list (<code class="xref std std-option docutils literal notranslate"><span class="pre">--chans</span></code>, <code class="xref std std-option docutils literal notranslate"><span class="pre">--nslc</span></code>). Without a stream ID,
only unreferenced objects are removed when extracting.</p></li>
<li><p>Input file or stdin</p></li>
<li><p>Output file or stdout</p></li>
<li><p>Region bounding box (optional)</p></li>
<li><p>Output file (<code class="xref std std-option docutils literal notranslate"><span class="pre">--output</span></code>) or stdout</p></li>
<li><p>Region bounding box (<code class="xref std std-option docutils literal notranslate"><span class="pre">--region</span></code>, optional)</p></li>
</ul>
<p>whereas the output file defaults to stdout and the input file to
<p>where the output XML defaults to stdout and the input file to
stdin if not given.</p>
<p>The optional region box will be used to filter the read inventory based on the
coordinates of sensor locations. Only stations with sensor locations within the
region will be considered. All others will be ignored.</p>
<p>A channel ID is a simple string that is matched against the final channel ID
in the inventory. This final channel ID is constructed by joining the codes of
<p>A stream ID is a simple string that is matched against the final stream ID
in the inventory. This final stream ID is constructed by joining the codes of
all stages with a dot where the stages are network, station, location and
channel.</p>
<p>The content of the resulting inventory may be listed using <a class="reference internal" href="scinv.html#scinv"><span class="std std-ref">scinv</span></a>.</p>
<section id="examples">
<h3>Examples<a class="headerlink" href="#examples" title="Permalink to this heading"></a></h3>
<p>Suppose an inventory with network GE, a station MORC and several channels:</p>
<p>Suppose an inventory with network GE, a station MORC with one sensor locations
and several channels:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>network<span class="w"> </span>GE
<span class="w"> </span>station<span class="w"> </span>MORC
<span class="w"> </span>location<span class="w"> </span>__
@ -121,15 +129,21 @@ channel.</p>
</pre></div>
</div>
<ul>
<li><p>The IDs are matched against streams passed with chans.</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>invextr<span class="w"> </span>--chans<span class="w"> </span><span class="s2">&quot;GE*&quot;</span><span class="w"> </span>inv.xml
<li><p>Just clean inventory from unreferenced objects such as data loggers, sensors
or instrument responses.</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>invextr<span class="w"> </span>inventory.xml<span class="w"> </span>-o<span class="w"> </span>inventory-cleaned.xml
</pre></div>
</div>
</li>
<li><p>The IDs are matched against streams passed with <code class="xref std std-option docutils literal notranslate"><span class="pre">--chans</span></code>:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>invextr<span class="w"> </span>--chans<span class="w"> </span><span class="s2">&quot;GE*&quot;</span><span class="w"> </span>inventory.xml
</pre></div>
</div>
<p>All streams are passed and nothing is filtered because GE* matches all
available IDs and region filter is not used. Since <code class="file docutils literal notranslate"><span class="pre">inv.xml</span></code> only
contains stations from the GE network the option <code class="xref std std-option docutils literal notranslate"><span class="pre">--chans</span></code> is not
useful here at all.</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="w"> </span>invextr<span class="w"> </span>-r<span class="w"> </span><span class="m">0</span>,-180,90,180<span class="w"> </span>inv.xml
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="w"> </span>invextr<span class="w"> </span>-r<span class="w"> </span><span class="m">0</span>,-180,90,180<span class="w"> </span>inventory.xml
All<span class="w"> </span>streams<span class="w"> </span>located<span class="w"> </span><span class="k">in</span><span class="w"> </span>the<span class="w"> </span>northern<span class="w"> </span>hemisphere<span class="w"> </span>are<span class="w"> </span>passed<span class="w"> </span>as<span class="w"> </span>commanded<span class="w"> </span>by<span class="w"> </span>the
region<span class="w"> </span>bounding<span class="w"> </span>box.
@ -137,29 +151,28 @@ region<span class="w"> </span>bounding<span class="w"> </span>box.
</div>
</li>
<li><p>Nothing is filtered again because <em>MORC</em> matches all available IDs.</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>invextr<span class="w"> </span>--chans<span class="w"> </span><span class="s2">&quot;*MORC*&quot;</span><span class="w"> </span>inv.xml
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>invextr<span class="w"> </span>--chans<span class="w"> </span><span class="s2">&quot;*MORC*&quot;</span><span class="w"> </span>inventory.xml
</pre></div>
</div>
</li>
<li><p>Everything is filtered because GE.MORC does not match with any ID. To make it
work, an asterisk needs to be appended: GE.MORC* or GE.MORC.*.</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>invextr<span class="w"> </span>--chans<span class="w"> </span><span class="s2">&quot;GE.MORC&quot;</span><span class="w"> </span>inv.xml
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>invextr<span class="w"> </span>--chans<span class="w"> </span><span class="s2">&quot;GE.MORC&quot;</span><span class="w"> </span>inventory.xml
</pre></div>
</div>
</li>
<li><p>To extract all vertical components, use:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>invextr<span class="w"> </span>--chans<span class="w"> </span><span class="s2">&quot;*Z&quot;</span><span class="w"> </span>inv.xml
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>invextr<span class="w"> </span>--chans<span class="w"> </span><span class="s2">&quot;*Z&quot;</span><span class="w"> </span>inventory.xml
</pre></div>
</div>
</li>
<li><p>To extract BHN and LHZ, use:</p></li>
</ul>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>invextr<span class="w"> </span>--chans<span class="w"> </span><span class="s2">&quot;*BHN,*LHZ&quot;</span><span class="w"> </span>inv.xml
<li><p>To extract BHN and LHZ, use:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>invextr<span class="w"> </span>--chans<span class="w"> </span><span class="s2">&quot;*BHN,*LHZ&quot;</span><span class="w"> </span>inventory.xml
</pre></div>
</div>
<ul>
</li>
<li><p>To remove all HH and SH channels, use:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>invextr<span class="w"> </span>--rm<span class="w"> </span>--chans<span class="w"> </span><span class="s2">&quot;*HH?,*SH?&quot;</span><span class="w"> </span>inv.xml
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>invextr<span class="w"> </span>--rm<span class="w"> </span>--chans<span class="w"> </span><span class="s2">&quot;*HH?,*SH?&quot;</span><span class="w"> </span>inventory.xml
</pre></div>
</div>
</li>
@ -316,10 +329,14 @@ that time will be ignored.</p>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-invextr-chans">
<span class="sig-name descname"><span class="pre">--chans</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-invextr-chans" title="Permalink to this definition"></a></dt>
<dd><p>A comma separated list of channel IDs to extract
which can contain wildcards. Default: *.*.*.* meaning
all streams.</p>
<p>Example: invextr --chans &quot;GE.*.*.BHZ,GE.MORC.*.*&quot; inv.xml</p>
<dd><p>A comma separated list of streams to extract or remove (--rm)
which can contain wildcards. Avoiding confusion with files
names due to SHELL extension requires to enclose stream codes
by quotes. Default: *.*.*.* meaning all streams. Unreferenced
sensors, data loggers and resonses are removed when extracting.
A comma separated list of channel IDs to extract which may
contain wildcards. Default: *.*.*.* meaning all streams.</p>
<p>Example: invextr --chans &quot;GE.*.*.BHZ,GE.MORC.*.*&quot; inventory.xml</p>
</dd></dl>
<dl class="std option">
@ -333,7 +350,7 @@ Wildcards can be used. --chans is ignored.</p>
<dt class="sig sig-object std" id="cmdoption-invextr-r">
<span id="cmdoption-invextr-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-invextr-r" title="Permalink to this definition"></a></dt>
<dd><p>Filter streams by geographic region given as
&quot;South, East, North, West&quot;. Region is unused by default.</p>
&quot;South,West,North,East&quot;. Region is unused by default.</p>
</dd></dl>
<dl class="std option">
@ -344,10 +361,20 @@ extracting them.</p>
<p>Example: invextr --rm --chans &quot;GE.*&quot; inv.xml</p>
</dd></dl>
</section>
<section id="output">
<h3>Output<a class="headerlink" href="#output" title="Permalink to this heading"></a></h3>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-invextr-f">
<span id="cmdoption-invextr-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-invextr-f" title="Permalink to this definition"></a></dt>
<dd><p>Enables formatted XML output.</p>
<dd><p>Enable formatted XML output.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-invextr-o">
<span id="cmdoption-invextr-output"></span><span class="sig-name descname"><span class="pre">-o</span></span><span class="sig-prename descclassname"></span><span class="sig-prename descclassname"><span class="pre">,</span> </span><span class="sig-name descname"><span class="pre">--output</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-invextr-o" title="Permalink to this definition"></a></dt>
<dd><p>Name of output file. If not given or -, output is sent to
stdout.</p>
</dd></dl>
</section>
@ -384,6 +411,7 @@ extracting them.</p>
<li><a class="reference internal" href="#generic">Generic</a></li>
<li><a class="reference internal" href="#verbosity">Verbosity</a></li>
<li><a class="reference internal" href="#extract">Extract</a></li>
<li><a class="reference internal" href="#output">Output</a></li>
</ul>
</li>
</ul>
@ -393,8 +421,8 @@ extracting them.</p>
</div>
<div>
<h4>Previous topic</h4>
<p class="topless"><a href="inv2dlsv.html"
title="previous chapter">inv2dlsv</a></p>
<p class="topless"><a href="import_inv.html"
title="previous chapter">import_inv</a></p>
</div>
<div>
<h4>Next topic</h4>
@ -420,7 +448,7 @@ extracting them.</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>kernel &#8212; SeisComP Release documentation</title>
<title>kernel &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -193,7 +193,7 @@ unencrypted bind address. The format is
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>msrtsimul &#8212; SeisComP Release documentation</title>
<title>msrtsimul &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -98,7 +98,7 @@ wrong times are archived.</p></li>
512 bytes. msrtsimul issues a warning when detecting a record of other size.</p></li>
<li><p>Data available in other record sizes can be repacked to 512 bytes by
external software such as <strong class="program">msrepack</strong> available with
<span id="id2"><em>libmseed - The miniSEED data format library</em> [<a class="reference internal" href="../base/references.html#id147" title="libmseed - The miniSEED data format library. GitHub, 2017. URL: https://github.com/EarthScope/libmseed/wiki.">32</a>]</span>.</p></li>
<span id="id2"><em>libmseed - The miniSEED data format library</em> [<a class="reference internal" href="../base/references.html#id176" title="libmseed - The miniSEED data format library. GitHub, 2017. URL: https://github.com/EarthScope/libmseed/wiki.">40</a>]</span>.</p></li>
<li><p>Applications other than standard <a class="reference internal" href="seedlink.html#seedlink"><span class="std std-ref">seedlink</span></a> in <cite>SeisComP</cite> or
<a class="reference internal" href="seedlink.html#seedlink"><span class="std std-ref">seedlink</span></a> compiled specifically may accept other record sizes. For
accepting these records use msrtsimul with <code class="xref std std-option docutils literal notranslate"><span class="pre">--unlimited</span></code>.</p></li>
@ -160,7 +160,7 @@ msrtsimul<span class="w"> </span>...
<h3>Examples<a class="headerlink" href="#examples" title="Permalink to this heading"></a></h3>
<ol class="arabic">
<li><p>Playback miniSEED waveforms in real time with verbose output:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>$<span class="w"> </span>msrtsimul<span class="w"> </span>-v<span class="w"> </span>miniSEED-file
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>msrtsimul<span class="w"> </span>-v<span class="w"> </span>miniSEED-file
</pre></div>
</div>
</li>
@ -178,18 +178,6 @@ to be started with the option <em>playback</em>:</p>
</ol>
</section>
</section>
<section id="module-configuration">
<span id="msrtsimul-configuration"></span><h2>Module Configuration<a class="headerlink" href="#module-configuration" title="Permalink to this heading"></a></h2>
<div class="line-block">
<div class="line"><code class="file docutils literal notranslate"><span class="pre">etc/defaults/global.cfg</span></code></div>
<div class="line"><code class="file docutils literal notranslate"><span class="pre">etc/defaults/msrtsimul.cfg</span></code></div>
<div class="line"><code class="file docutils literal notranslate"><span class="pre">etc/global.cfg</span></code></div>
<div class="line"><code class="file docutils literal notranslate"><span class="pre">etc/msrtsimul.cfg</span></code></div>
<div class="line"><code class="file docutils literal notranslate"><span class="pre">~/.seiscomp/global.cfg</span></code></div>
<div class="line"><code class="file docutils literal notranslate"><span class="pre">~/.seiscomp/msrtsimul.cfg</span></code></div>
</div>
<p>msrtsimul inherits <a class="reference internal" href="global.html#global-configuration"><span class="std std-ref">global options</span></a>.</p>
</section>
<section id="command-line-options">
<h2>Command-Line Options<a class="headerlink" href="#command-line-options" title="Permalink to this heading"></a></h2>
<p><strong class="program">msrtsimul [OPTION] miniSEED-file</strong></p>
@ -226,13 +214,15 @@ specific mseedfifo path.</p>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-msrtsimul-j">
<span id="cmdoption-msrtsimul-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">float</span></span><a class="headerlink" href="#cmdoption-msrtsimul-j" title="Permalink to this definition"></a></dt>
<dd><p>Minutes to skip at the beginning.</p>
<dd><p>Unit: <em>minutes</em></p>
<p>Minutes to skip at the beginning.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-msrtsimul-m">
<span id="cmdoption-msrtsimul-mode"></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">--mode</span></span><span class="sig-prename descclassname"> <span class="pre">string</span></span><a class="headerlink" href="#cmdoption-msrtsimul-m" title="Permalink to this definition"></a></dt>
<dd><p>Playback mode: choose between realtime and historic</p>
<dd><p>Values: <code class="docutils literal notranslate"><span class="pre">realtime,historic</span></code></p>
<p>Playback mode: choose between realtime and historic</p>
</dd></dl>
<dl class="std option">
@ -258,7 +248,8 @@ in the standard mseedfifo path.</p>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-msrtsimul-u">
<span id="cmdoption-msrtsimul-unlimited"></span><span class="sig-name descname"><span class="pre">-u</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">--unlimited</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-msrtsimul-u" title="Permalink to this definition"></a></dt>
<dd><p>Allow miniSEED records which are not 512 bytes.</p>
<dd><p>Allow miniSEED records which are not 512 bytes. By default
seedlink supports 512 bytes only.</p>
</dd></dl>
</section>
@ -293,7 +284,6 @@ in the standard mseedfifo path.</p>
<li><a class="reference internal" href="#examples">Examples</a></li>
</ul>
</li>
<li><a class="reference internal" href="#module-configuration">Module Configuration</a></li>
<li><a class="reference internal" href="#command-line-options">Command-Line Options</a><ul>
<li><a class="reference internal" href="#verbosity">Verbosity</a></li>
<li><a class="reference internal" href="#playback">Playback</a></li>
@ -333,7 +323,7 @@ in the standard mseedfifo path.</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>ql2sc &#8212; SeisComP Release documentation</title>
<title>ql2sc &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -77,10 +77,10 @@
<p><strong>QuakeLink (gempa GmbH) to SeisComP event parameter exchange.</strong></p>
<section id="description">
<h2>Description<a class="headerlink" href="#description" title="Permalink to this heading"></a></h2>
<p>ql2sc manages the import of SeisComP objects from one or several QuakeLink servers
into a SeisComP system in real time. Like <a class="reference internal" href="scimex.html#scimex"><span class="std std-ref">scimex</span></a> but contrary to
<a class="reference internal" href="scimport.html#scimport"><span class="std std-ref">scimport</span></a> the exchange of the SeisComP objects is event based. This means no
messages will be exchanged until the exporting system has produced an event.</p>
<p>ql2sc manages the import of SeisComP objects from one or several QuakeLink
servers into a SeisComP system in real time. Like <a class="reference internal" href="scimex.html#scimex"><span class="std std-ref">scimex</span></a> but contrary to
<a class="reference internal" href="scimport.html#scimport"><span class="std std-ref">scimport</span></a> the exchange of the SeisComP objects is event based. This means
no messages will be exchanged until the exporting system has produced an event.</p>
<p>The user may control at various levels which information to import. Whenever
possible server-side filters should be preferred to reduce both the network
bandwidth consumption as well as the CPU and memory utilization on the local
@ -191,12 +191,11 @@ reprocess the solution but to add them to the local catalog.</p>
<ul class="simple">
<li><p>Picks and Amplitudes to the <code class="docutils literal notranslate"><span class="pre">IMPORT_GROUP</span></code> group to prevent processing by
the local locator and amplitude processor</p></li>
<li><p>Origins (including its StationMagnitude and Magnitude children) to the
<code class="docutils literal notranslate"><span class="pre">LOCATION</span></code> to allow event association.</p></li>
<li><p>FocalMechanisms to the <code class="docutils literal notranslate"><span class="pre">FOCMECH</span></code> group to trigger processing by specialized
applications, e.g., graphical user interfaces for strong motion analysis or
tsunami risk assessment.</p></li>
<li><p>Origins and FocalMechanisms to the <code class="docutils literal notranslate"><span class="pre">LOCATION</span></code> group to allow event association.</p></li>
</ul>
<p>A common deviation from the default is to route FocalMechanisms to the <code class="docutils literal notranslate"><span class="pre">FOCMECH</span></code>
group to trigger processing by specialized applications, e.g., graphical user
interfaces for strong motion analysis or tsunami risk assessment.</p>
<p>We dont route events at all. With the help of <a class="reference internal" href="scevent.html#scevent"><span class="std std-ref">scevent</span></a> locations are
either associated to existing events or will create new events with local
settings.</p>
@ -307,7 +306,7 @@ happen that the imported event ID is different from the event ID of the local
system. The input host configuration parameter <code class="xref std std-confval docutils literal notranslate"><span class="pre">syncEventAttributes</span></code>
controls that behaviour. It is set to true by default which means that imported
event attributes are going to be imported as well. ql2sc does not update
directly the attributes but commandates scevent in as many cases as possible
directly the attributes but commands scevent in as many cases as possible
to do so. To find the matching local event it takes the first occurrence which
has associated the currently imported preferred origin.</p>
<section id="limitations">
@ -373,14 +372,6 @@ the publicID prefix of <code class="docutils literal notranslate"><span class="p
<p>Number of seconds to fetch missed updates on start up.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-cacheSize">
<span class="sig-name descname"><span class="pre">cacheSize</span></span><a class="headerlink" href="#confval-cacheSize" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">5000</span></code></p>
<p>Type: <em>int</em></p>
<p>Number of public objects to cache.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-batchSize">
<span class="sig-name descname"><span class="pre">batchSize</span></span><a class="headerlink" href="#confval-batchSize" title="Permalink to this definition"></a></dt>
@ -502,7 +493,7 @@ if set to a value greater than zero.</p>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-host.-name.keepAlive">
<span class="sig-name descname"><span class="pre">host.$name.keepAlive</span></span><a class="headerlink" href="#confval-host.-name.keepAlive" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">false</span></code></p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">true</span></code></p>
<p>Type: <em>boolean</em></p>
<p>Request server to send keep alive message every 30s to
prevent connection reset by firewalls on long idle
@ -514,11 +505,19 @@ connection if no alive message is received within 60s.</p>
<dt class="sig sig-object std" id="confval-host.-name.filter">
<span class="sig-name descname"><span class="pre">host.$name.filter</span></span><a class="headerlink" href="#confval-host.-name.filter" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>SQL like WHERE clause to filter the result set.</p>
<p>clause := condition[ AND|OR [(]clause[)]] __
condition := MAG|DEPTH|LAT|LON|PHASES|OTIME|UPDATED [op float|time]|[IS [NOT] NULL] __
op := =|&gt;|&gt;=|&lt;|&lt;=|eq|gt|ge|lt|ge __
time := %Y,%m,%d[,%H,%M,%S,%f]</p>
<p>Server-side SQL like WHERE clause to filter the result set. The actual
available parameters depend on the QuakeLink server version. Use
telnet host port followed by help select to connect to a QuakeLink
server an request available parameters.</p>
<p>clause := condition[ AND|OR [(]clause[)]]
condition := MAG|DEPTH|LAT|LON|PHASES|DIST(lat,lon) op {float} |
DIST(lat,lon) IN [{float}, {float}] |
UPDATED|OTIME op time |
AGENCY|AUTHOR|STATUS|ESTATUS|EMODE|TYPE|CTYPE|DTYPE|REGION|MAG_T op string |
MAG|DEPTH|LAT|LON|PHASES|OTIME|UPDATED IS [NOT] NULL
FELT|NOT FELT
op := =|!=|&gt;|&gt;=|&lt;|&lt;=|eq|gt|ge|lt|ge
time := %Y,%m,%d[,%H,%M,%S[,%f]]</p>
</dd></dl>
<dl class="std confval">
@ -758,12 +757,14 @@ This option can be given more than once.</p>
<dt class="sig sig-object std" id="cmdoption-ql2sc-content-type">
<span class="sig-name descname"><span class="pre">--content-type</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-ql2sc-content-type" title="Permalink to this definition"></a></dt>
<dd><p>Overrides configuration parameter <a class="reference internal" href="global.html#confval-connection.contentType"><code class="xref std std-confval docutils literal notranslate"><span class="pre">connection.contentType</span></code></a>.</p>
<p>Default: <code class="docutils literal notranslate"><span class="pre">binary</span></code></p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-ql2sc-start-stop-msg">
<span class="sig-name descname"><span class="pre">--start-stop-msg</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-ql2sc-start-stop-msg" title="Permalink to this definition"></a></dt>
<dd><p>Set sending of a start and a stop message.</p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">0</span></code></p>
<p>Set sending of a start and a stop message.</p>
</dd></dl>
</section>
@ -867,7 +868,7 @@ can be queried with &quot;--db-driver-list&quot;.</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>scalert &#8212; SeisComP Release documentation</title>
<title>scalert &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -171,7 +171,7 @@ ignored.</p>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-scripts.pick">
<span class="sig-name descname"><span class="pre">scripts.pick</span></span><a class="headerlink" href="#confval-scripts.pick" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<dd><p>Type: <em>file</em></p>
<p>The script to be called when a pick
arrives. Network-, station code, pick publicID are passed
as parameters $1, $2, $3.</p>
@ -180,7 +180,7 @@ as parameters $1, $2, $3.</p>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-scripts.amplitude">
<span class="sig-name descname"><span class="pre">scripts.amplitude</span></span><a class="headerlink" href="#confval-scripts.amplitude" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<dd><p>Type: <em>file</em></p>
<p>The script to be called when an amplitude
arrives. Network-, station code, amplitude and amplitude
public ID are passed as parameters $1, $2, $3, $4.</p>
@ -189,7 +189,7 @@ public ID are passed as parameters $1, $2, $3, $4.</p>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-scripts.alert">
<span class="sig-name descname"><span class="pre">scripts.alert</span></span><a class="headerlink" href="#confval-scripts.alert" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<dd><p>Type: <em>file</em></p>
<p>The script to be called when a preliminary
origin arrives. Latitude and longitude are passed as
parameters $1 and $2.</p>
@ -198,7 +198,7 @@ parameters $1 and $2.</p>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-scripts.event">
<span class="sig-name descname"><span class="pre">scripts.event</span></span><a class="headerlink" href="#confval-scripts.event" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<dd><p>Type: <em>file</em></p>
<p>The script to be called when an event has been
declared. The message string, a flag (1=new event,
0=update event), the EventID, the arrival count and the
@ -425,12 +425,14 @@ This option can be given more than once.</p>
<dt class="sig sig-object std" id="cmdoption-scalert-content-type">
<span class="sig-name descname"><span class="pre">--content-type</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scalert-content-type" title="Permalink to this definition"></a></dt>
<dd><p>Overrides configuration parameter <a class="reference internal" href="global.html#confval-connection.contentType"><code class="xref std std-confval docutils literal notranslate"><span class="pre">connection.contentType</span></code></a>.</p>
<p>Default: <code class="docutils literal notranslate"><span class="pre">binary</span></code></p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scalert-start-stop-msg">
<span class="sig-name descname"><span class="pre">--start-stop-msg</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scalert-start-stop-msg" title="Permalink to this definition"></a></dt>
<dd><p>Set sending of a start and a stop message.</p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">0</span></code></p>
<p>Set sending of a start and a stop message.</p>
</dd></dl>
</section>
@ -476,7 +478,8 @@ can be queried with &quot;--db-driver-list&quot;.</p>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scalert-amp-type">
<span class="sig-name descname"><span class="pre">--amp-type</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scalert-amp-type" title="Permalink to this definition"></a></dt>
<dd><p>Specify the amplitude type to listen to.</p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">snr</span></code></p>
<p>Specify the amplitude type to listen to.</p>
</dd></dl>
<dl class="std option">
@ -593,7 +596,7 @@ alert scripts scvoice will exit.</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>scamp &#8212; SeisComP Release documentation</title>
<title>scamp &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -113,15 +113,15 @@ various magnitude types must typically match exactly. Exceptions:</p>
<section id="local-distances">
<h3>Local distances<a class="headerlink" href="#local-distances" title="Permalink to this heading"></a></h3>
<dl class="simple">
<dt><a class="reference internal" href="../base/glossary.html#term-magnitude-duration-Md"><span class="xref std std-term">Md</span></a></dt><dd><p>Duration magnitude as described in HYPOINVERSE (<span id="id2">Klein [<a class="reference internal" href="../base/references.html#id47" title="F.W. Klein. Users guide to HYPOINVERSE-2000, a Fortran program to solve for earthquake locations and magnitudes. US Geological Survey, 2002-171:, 2002. URL: https://www.usgs.gov/node/279394, doi:10.3133/ofr02171.">50</a>]</span>).</p>
<dt><a class="reference internal" href="../base/glossary.html#term-magnitude-duration-Md"><span class="xref std std-term">Md</span></a></dt><dd><p>Duration magnitude as described in HYPOINVERSE (<span id="id2">Klein [<a class="reference internal" href="../base/references.html#id63" title="F.W. Klein. Users guide to HYPOINVERSE-2000, a Fortran program to solve for earthquake locations and magnitudes. US Geological Survey, 2002-171:, 2002. URL: https://www.usgs.gov/node/279394, doi:10.3133/ofr02171.">58</a>]</span>).</p>
</dd>
<dt><a class="reference internal" href="../base/glossary.html#term-magnitude-JMA-M_JMA"><span class="xref std std-term">Mjma</span></a></dt><dd><p>Mjma is computed on displacement data using body waves of period &lt; 30s.</p>
</dd>
<dt><a class="reference internal" href="../base/glossary.html#term-magnitude-local-ML"><span class="xref std std-term">ML</span></a></dt><dd><p>Local (Richter) magnitude calculated on the horizontal components using a
correction term to fit with the standard ML (<span id="id3">Richter [<a class="reference internal" href="../base/references.html#id62" title="C.F. Richter. An instrumental earthquake magnitude scale. Bull. Seismol. Soc. Am., 1:1 - 32, 1935. URL: https://resolver.caltech.edu/CaltechAUTHORS:20140804-143558638, doi:10.1785/BSSA0250010001.">57</a>]</span>).</p>
correction term to fit with the standard ML (<span id="id3">Richter [<a class="reference internal" href="../base/references.html#id81" title="C.F. Richter. An instrumental earthquake magnitude scale. Bull. Seismol. Soc. Am., 1:1 - 32, 1935. URL: https://resolver.caltech.edu/CaltechAUTHORS:20140804-143558638, doi:10.1785/BSSA0250010001.">66</a>]</span>).</p>
</dd>
<dt><a class="reference internal" href="../base/glossary.html#term-magnitude-local-custom-MLc"><span class="xref std std-term">MLc</span></a></dt><dd><p>Local custom magnitude calculated on the horizontal components according to
Hessian Earthquake Service and <span id="id4">Stange [<a class="reference internal" href="../base/references.html#id78" title="S. Stange. ML determination for local and regional events using a sparse network in Southwestern Germany. J. Seismol., 10:247 257, 2006. doi:10.1007/s10950-006-9010-6.">62</a>]</span></p>
Hessian Earthquake Service and <span id="id4">Stange [<a class="reference internal" href="../base/references.html#id100" title="S. Stange. ML determination for local and regional events using a sparse network in Southwestern Germany. J. Seismol., 10:247 257, 2006. doi:10.1007/s10950-006-9010-6.">71</a>]</span></p>
</dd>
<dt><a class="reference internal" href="../base/glossary.html#term-magnitude-local-horizontal-MLh"><span class="xref std std-term">MLh</span></a></dt><dd><p>Local magnitude calculated on the horizontal components according to SED
specifications.</p>
@ -129,7 +129,7 @@ specifications.</p>
<dt><a class="reference internal" href="../base/glossary.html#term-magnitude-local-vertical-MLv"><span class="xref std std-term">MLv</span></a></dt><dd><p>Local magnitude calculated on the vertical component using a correction term
to fit with the standard ML.</p>
</dd>
<dt>AMN for <a class="reference internal" href="../base/glossary.html#term-magnitude-Nuttli-MN"><span class="xref std std-term">MN</span></a></dt><dd><p>Nuttli magnitude for Canada and other Cratonic regions (<span id="id5">Nuttli [<a class="reference internal" href="../base/references.html#id58" title="O.W. Nuttli. Seismic wave attenuation and magnitude relations for eastern north america. J. Geophys. Res., 5:876 - 885, 1973. doi:10.1029/JB078i005p00876.">53</a>]</span>).</p>
<dt>AMN for <a class="reference internal" href="../base/glossary.html#term-magnitude-Nuttli-MN"><span class="xref std std-term">MN</span></a></dt><dd><p>Nuttli magnitude for Canada and other Cratonic regions (<span id="id5">Nuttli [<a class="reference internal" href="../base/references.html#id76" title="O.W. Nuttli. Seismic wave attenuation and magnitude relations for eastern north america. J. Geophys. Res., 5:876 - 885, 1973. doi:10.1029/JB078i005p00876.">62</a>]</span>).</p>
</dd>
</dl>
</section>
@ -140,9 +140,9 @@ to fit with the standard ML.</p>
</dd>
<dt><a class="reference internal" href="../base/glossary.html#term-magnitude-cumulative-body-wave-mBc"><span class="xref std std-term">mBc</span></a></dt><dd><p>Cumulative body wave magnitude</p>
</dd>
<dt><a class="reference internal" href="../base/glossary.html#term-magnitude-broadband-body-wave-mB"><span class="xref std std-term">mB</span></a></dt><dd><p>Broad band body wave magnitude after <span id="id6">Bormann and Saul [<a class="reference internal" href="../base/references.html#id18" title="P. Bormann and J. Saul. The new iaspei standard broadband magnitude mb. Seismol. Res. Lett., 5:698 - 705, 2008. doi:10.1785/gssrl.79.5.698.">38</a>]</span></p>
<dt><a class="reference internal" href="../base/glossary.html#term-magnitude-broadband-body-wave-mB"><span class="xref std std-term">mB</span></a></dt><dd><p>Broad band body wave magnitude after <span id="id6">Bormann and Saul [<a class="reference internal" href="../base/references.html#id28" title="P. Bormann and J. Saul. The new iaspei standard broadband magnitude mb. Seismol. Res. Lett., 5:698 - 705, 2008. doi:10.1785/gssrl.79.5.698.">46</a>]</span></p>
</dd>
<dt><a class="reference internal" href="../base/glossary.html#term-magnitude-broadband-P-wave-moment-Mwp"><span class="xref std std-term">Mwp</span></a></dt><dd><p>The body wave magnitude of <span id="id7">Tsuboi <em>et al.</em> [<a class="reference internal" href="../base/references.html#id79" title="S. Tsuboi, K. Abe, K. Takano, and Y. Yamanaka. Rapid determination of Mw from broadband P waveforms. Bull. Seismol. Soc. Am., 1995. doi:10.1785/BSSA0850020606.">63</a>]</span></p>
<dt><a class="reference internal" href="../base/glossary.html#term-magnitude-broadband-P-wave-moment-Mwp"><span class="xref std std-term">Mwp</span></a></dt><dd><p>The body wave magnitude of <span id="id7">Tsuboi <em>et al.</em> [<a class="reference internal" href="../base/references.html#id101" title="S. Tsuboi, K. Abe, K. Takano, and Y. Yamanaka. Rapid determination of Mw from broadband P waveforms. Bull. Seismol. Soc. Am., 1995. doi:10.1785/BSSA0850020606.">72</a>]</span></p>
</dd>
<dt><a class="reference internal" href="../base/glossary.html#term-magnitude-surface-wave-Ms_20"><span class="xref std std-term">Ms_20</span></a></dt><dd><p>Surface-wave magnitude at 20 s period</p>
</dd>
@ -433,12 +433,14 @@ This option can be given more than once.</p>
<dt class="sig sig-object std" id="cmdoption-scamp-content-type">
<span class="sig-name descname"><span class="pre">--content-type</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scamp-content-type" title="Permalink to this definition"></a></dt>
<dd><p>Overrides configuration parameter <a class="reference internal" href="global.html#confval-connection.contentType"><code class="xref std std-confval docutils literal notranslate"><span class="pre">connection.contentType</span></code></a>.</p>
<p>Default: <code class="docutils literal notranslate"><span class="pre">binary</span></code></p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scamp-start-stop-msg">
<span class="sig-name descname"><span class="pre">--start-stop-msg</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scamp-start-stop-msg" title="Permalink to this definition"></a></dt>
<dd><p>Set sending of a start and a stop message.</p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">0</span></code></p>
<p>Set sending of a start and a stop message.</p>
</dd></dl>
<dl class="std option">
@ -496,12 +498,12 @@ can be queried with &quot;--db-driver-list&quot;.</p>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scamp-I">
<span id="cmdoption-scamp-record-url"></span><span class="sig-name descname"><span class="pre">-I</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">--record-url</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scamp-I" title="Permalink to this definition"></a></dt>
<dd><p>The recordstream source URL, format:
<dd><p>The RecordStream source URL. Format:
[<a class="reference external" href="service://">service://</a>]location[#type].
&quot;service&quot; is the name of the recordstream driver
&quot;service&quot; is the name of the RecordStream driver
which can be queried with &quot;--record-driver-list&quot;.
If &quot;service&quot; is not given, &quot;<a class="reference external" href="file://">file://</a>&quot; is
used.</p>
used and simply the name of a miniSEED file can be given.</p>
</dd></dl>
<dl class="std option">
@ -522,7 +524,8 @@ used.</p>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scamp-ep">
<span class="sig-name descname"><span class="pre">--ep</span></span><span class="sig-prename descclassname"> <span class="pre">file</span></span><a class="headerlink" href="#cmdoption-scamp-ep" title="Permalink to this definition"></a></dt>
<dd><p>Defines an event parameters XML file to be read and processed. This
<dd><p>Defines an event parameters XML file to be read and
processed. Use - to read from stdin. This
implies offline mode and only processes all origins contained
in that file. It computes amplitudes for all picks associated
with an origin and outputs an XML file that additionally
@ -572,6 +575,16 @@ with new inventory information. Waveform access is required.</p>
document will be output.</p>
</dd></dl>
</section>
<section id="output">
<h3>Output<a class="headerlink" href="#output" title="Permalink to this heading"></a></h3>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scamp-f">
<span id="cmdoption-scamp-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-scamp-f" title="Permalink to this definition"></a></dt>
<dd><p>Use formatted XML output along with --ep. Otherwise XML
is unformatted.</p>
</dd></dl>
</section>
</section>
</section>
@ -614,6 +627,7 @@ document will be output.</p>
<li><a class="reference internal" href="#records">Records</a></li>
<li><a class="reference internal" href="#input">Input</a></li>
<li><a class="reference internal" href="#reprocess">Reprocess</a></li>
<li><a class="reference internal" href="#output">Output</a></li>
</ul>
</li>
</ul>
@ -650,7 +664,7 @@ document will be output.</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>scardac &#8212; SeisComP Release documentation</title>
<title>scardac &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -101,7 +101,7 @@ provided in different formats)</p></li>
<section id="non-sds-archives">
<span id="scarcac-non-sds"></span><h3>Non-SDS archives<a class="headerlink" href="#non-sds-archives" title="Permalink to this heading"></a></h3>
<p>scardac can be extended by plugins to scan non-SDS archives. For example the
<code class="docutils literal notranslate"><span class="pre">daccaps</span></code> plugin provided by <span id="id2"><em>CAPS</em> [<a class="reference internal" href="../base/references.html#id91" title="CAPS. gempa module. URL: https://docs.gempa.de/caps/current/index.html.">3</a>]</span> allows scanning archives generated
<code class="docutils literal notranslate"><span class="pre">daccaps</span></code> plugin provided by <span id="id2"><em>CAPS</em> [<a class="reference internal" href="../base/references.html#id116" title="CAPS. gempa module. URL: https://docs.gempa.de/caps/current/index.html.">3</a>]</span> allows scanning archives generated
by a CAPS server. Plugins are added to the global module configuration, e.g.:</p>
<div class="highlight-properties notranslate"><div class="highlight"><pre><span></span><span class="na">plugins</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">${plugins}, daccaps</span>
</pre></div>
@ -670,7 +670,7 @@ length of 2.5s followed by 50 overlaps with an overlap of
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>scart &#8212; SeisComP Release documentation</title>
<title>scart &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -516,7 +516,7 @@ checks are made with scmssort.</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>scautoloc &#8212; SeisComP Release documentation</title>
<title>scautoloc &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -88,8 +88,8 @@ as input. Phase picks and amplitudes are usually created by <a class="reference
but can also be provided by other means.</p>
<p>scautoloc normally runs as a <a class="reference internal" href="#sec-scautoloc-daemon-mode"><span class="std std-ref">daemon</span></a>
continuously reading picks and amplitudes and processing them in real time. An
<a class="reference internal" href="#sec-scautoloc-offline-mode"><span class="std std-ref">offline mode</span></a> is available as well, e.g., for
playbacks on demand.</p>
<a class="reference internal" href="#sec-scautoloc-offline-mode"><span class="std std-ref">offline mode and non-real-time processing</span></a>
are available as well, e.g., for playbacks on demand.</p>
</section>
<section id="location-procedure">
<h2>Location procedure<a class="headerlink" href="#location-procedure" title="Permalink to this heading"></a></h2>
@ -367,28 +367,63 @@ the server. Log files are written as usual. This mode can be used to test
new parameter settings before implementation in the real-time system. It also
provides a simple way to log picks from a real-time system to the pick log.</p>
</section>
<section id="real-time-proessing">
<h2>Real-Time Proessing<a class="headerlink" href="#real-time-proessing" title="Permalink to this heading"></a></h2>
<section id="daemon-mode">
<span id="sec-scautoloc-daemon-mode"></span><h2>Daemon Mode<a class="headerlink" href="#daemon-mode" title="Permalink to this heading"></a></h2>
<p>For running scautoloc continuously in the background as a daemon it must be
enabled and started:</p>
<span id="sec-scautoloc-daemon-mode"></span><h3>Daemon Mode<a class="headerlink" href="#daemon-mode" title="Permalink to this heading"></a></h3>
<p>For running scautoloc continuously in real time and in the background as a
daemon it must be enabled and started:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>seiscomp<span class="w"> </span><span class="nb">enable</span><span class="w"> </span>scautoloc
seiscomp<span class="w"> </span>start<span class="w"> </span>scautoloc
</pre></div>
</div>
</section>
<section id="offline-mode">
<span id="sec-scautoloc-offline-mode"></span><h2>Offline Mode<a class="headerlink" href="#offline-mode" title="Permalink to this heading"></a></h2>
<p>scautoloc normally runs as a daemon in the background, continuously reading
picks and amplitudes and processing them in real time. However, scautoloc
may also be operated in offline mode. This is useful for debugging. Offline
mode is activated by adding the command-line parameter <code class="xref std std-option docutils literal notranslate"><span class="pre">--ep</span></code> or
<code class="xref std std-option docutils literal notranslate"><span class="pre">--offline</span></code>. When operated in offline mode,
<section id="on-demand-proessing">
<h3>On-demand proessing<a class="headerlink" href="#on-demand-proessing" title="Permalink to this heading"></a></h3>
<p>You may execute scautoloc on the command-line on demand giving the
possibility to use specific command-line options.</p>
<p>Example:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>scautoloc<span class="w"> </span>--debug
</pre></div>
</div>
</section>
</section>
<section id="non-real-time-processing">
<span id="sec-scautoloc-offline-mode"></span><h2>Non-real Time Processing<a class="headerlink" href="#non-real-time-processing" title="Permalink to this heading"></a></h2>
<p>scautoloc normally runs in real time as a daemon in the background, continuously
receiving and processing picks and amplitudes from messaging in real time.
However, scautoloc may also be operated in non-real-time/offline mode. This is
useful for fast playbacks or debugging and tuning. Non-real-time processing is
activated by adding the command-line parameter <code class="xref std std-option docutils literal notranslate"><span class="pre">--ep</span></code> and, for
offline mode, <code class="xref std std-option docutils literal notranslate"><span class="pre">--offline</span></code>. Then,
scautoloc will not connect to the messaging. Instead, it reads picks from a
<a class="reference internal" href="../base/glossary.html#term-SCML"><span class="xref std std-term">SCML</span></a> file provided with <code class="xref std std-option docutils literal notranslate"><span class="pre">--ep</span></code> or from standard input in the pick file
format. The station coordinates are read from the inventory in the database or
from the file either defined in <a class="reference internal" href="#confval-autoloc.stationLocations"><code class="xref std std-confval docutils literal notranslate"><span class="pre">autoloc.stationLocations</span></code></a> or
-\-station-locations .</p>
<p>Example for entries in a pick file</p>
<a class="reference internal" href="../base/glossary.html#term-SCML"><span class="xref std std-term">SCML</span></a> file provided with <code class="xref std std-option docutils literal notranslate"><span class="pre">--ep</span></code> or from standard input in the
<em>pick file format</em>. The station coordinates are read from the inventory in the
database or from the file either defined in <a class="reference internal" href="#confval-autoloc.stationLocations"><code class="xref std std-confval docutils literal notranslate"><span class="pre">autoloc.stationLocations</span></code></a>
or <code class="xref std std-option docutils literal notranslate"><span class="pre">--station-locations</span></code>.</p>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>When picks are created in real time, they are generally not in order of pick
time but in the order of creation time because of data latencies. Therefore,
processing of picks created in real time may result in differences to
playbacks of picks created in non-real-time playbacks.</p>
</div>
<section id="non-real-time-playback-from-xml">
<h3>Non-real-time playback from XML<a class="headerlink" href="#non-real-time-playback-from-xml" title="Permalink to this heading"></a></h3>
<p>Non-real-time playback may be based on picks and amplitudes (snr and mb) in an
<a class="reference internal" href="../base/glossary.html#term-SCML"><span class="xref std std-term">SCML</span></a> file. The database must be specified explicitly since it cannot be
received from the messaging. All picks, amplitudes and resulting origins are
output to stdout in SCML which can be redirected to an unformatted or formatted
file, <code class="file docutils literal notranslate"><span class="pre">origins.xml</span></code>.</p>
<p>Example:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>scautoloc<span class="w"> </span>-d<span class="w"> </span><span class="o">[</span>database<span class="o">]</span><span class="w"> </span>--ep<span class="w"> </span>picks.xml<span class="w"> </span>-f<span class="w"> </span>&gt;<span class="w"> </span>origins.xml
</pre></div>
</div>
</section>
<section id="offline-mode">
<h3>Offline mode<a class="headerlink" href="#offline-mode" title="Permalink to this heading"></a></h3>
<p>Offline mode works with <code class="xref std std-option docutils literal notranslate"><span class="pre">--offline</span></code> and picks are to be provided in the
<em>pick file format</em>:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="m">2008</span>-09-25<span class="w"> </span><span class="m">00</span>:20:16.6<span class="w"> </span>SK<span class="w"> </span>LIKS<span class="w"> </span>EH<span class="w"> </span>__<span class="w"> </span><span class="m">4</span>.6<span class="w"> </span><span class="m">196</span>.953<span class="w"> </span><span class="m">1</span>.1<span class="w"> </span>A<span class="w"> </span><span class="o">[</span>id<span class="o">]</span>
<span class="m">2008</span>-09-25<span class="w"> </span><span class="m">00</span>:20:33.5<span class="w"> </span>SJ<span class="w"> </span>BEO<span class="w"> </span>BH<span class="w"> </span>__<span class="w"> </span><span class="m">3</span>.0<span class="w"> </span><span class="m">479</span>.042<span class="w"> </span><span class="m">0</span>.9<span class="w"> </span>A<span class="w"> </span><span class="o">[</span>id<span class="o">]</span>
<span class="m">2008</span>-09-25<span class="w"> </span><span class="m">00</span>:21:00.1<span class="w"> </span>CX<span class="w"> </span>MNMCX<span class="w"> </span>BH<span class="w"> </span>__<span class="w"> </span><span class="m">21</span>.0<span class="w"> </span><span class="m">407</span>.358<span class="w"> </span><span class="m">0</span>.7<span class="w"> </span>A<span class="w"> </span><span class="o">[</span>id<span class="o">]</span>
@ -406,14 +441,13 @@ from the file either defined in <a class="reference internal" href="#confval-aut
</div>
<p>where [id] is a placeholder for the real pick id which has been omitted in this
example.</p>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>In the above example some of the picks are not in right order of
time because of data latencies. In offline mode scautoloc will not connect to
the database, in consequence the station coordinates cannot be read from the
database and thus have to be supplied via a file. The station coordinates file
has a simple format with one line per entry, consisting of 5 columns: network
code, station code, latitude, longitude, elevation (in meters). Example:</p>
<p>In offline mode scautoloc will not connect to the database. In consequence
station coordinates cannot be read from the database and must be supplied via
a station coordinates file. This file has a simple format with one line per
station, consisting of 5 columns:
network code, station code, latitude, longitude, elevation (in meters).
Sensor locations are not treated separately.</p>
<p>Example of a station coordinates file:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>GE<span class="w"> </span>APE<span class="w"> </span><span class="m">37</span>.0689<span class="w"> </span><span class="m">25</span>.5306<span class="w"> </span><span class="m">620</span>.0
GE<span class="w"> </span>BANI<span class="w"> </span>-4.5330<span class="w"> </span><span class="m">129</span>.9000<span class="w"> </span><span class="m">0</span>.0
GE<span class="w"> </span>BKB<span class="w"> </span>-1.2558<span class="w"> </span><span class="m">116</span>.9155<span class="w"> </span><span class="m">0</span>.0
@ -424,9 +458,9 @@ GE<span class="w"> </span>CEU<span class="w"> </span><span class="m">35</span>.8
GE<span class="w"> </span>CISI<span class="w"> </span>-7.5557<span class="w"> </span><span class="m">107</span>.8153<span class="w"> </span><span class="m">0</span>.0
</pre></div>
</div>
</div>
<p>The location of this file is specified in <a class="reference internal" href="#confval-autoloc.stationLocations"><code class="xref std std-confval docutils literal notranslate"><span class="pre">autoloc.stationLocations</span></code></a> or on the
command line using -\-station-locations</p>
<p>The name of this file is configured in <a class="reference internal" href="#confval-autoloc.stationLocations"><code class="xref std std-confval docutils literal notranslate"><span class="pre">autoloc.stationLocations</span></code></a> or
passed on the command line using <code class="xref std std-option docutils literal notranslate"><span class="pre">--station-locations</span></code>.</p>
</section>
</section>
<section id="scautopick-and-scautoloc-interaction">
<h2>scautopick and scautoloc Interaction<a class="headerlink" href="#scautopick-and-scautoloc-interaction" title="Permalink to this heading"></a></h2>
@ -435,7 +469,7 @@ chain, <a class="reference internal" href="scautopick.html#scautopick"><span cla
information needed by scautoloc can be supplied by <a class="reference internal" href="scautopick.html#scautopick"><span class="std std-ref">scautopick</span></a> and received
by <strong class="program">scautoloc</strong> through the message group defined by
<code class="xref std std-confval docutils literal notranslate"><span class="pre">connection.subscription</span></code> or through <a class="reference internal" href="../base/glossary.html#term-SCML"><span class="xref std std-term">SCML</span></a> (<code class="xref std std-option docutils literal notranslate"><span class="pre">--ep</span></code>,
<code class="xref std std-option docutils literal notranslate"><span class="pre">-i</span></code>). This document explains current
<code class="xref std std-option docutils literal notranslate"><span class="pre">--input</span></code>). This document explains current
implicit dependencies between these two utilities and is meant as a guide
especially for those who plan to modify or replace one or both of these
utilities by own developments.</p>
@ -577,7 +611,7 @@ possibly to a different value.</p>
<dt class="sig sig-object std" id="confval-buffer.originKeep">
<span class="sig-name descname"><span class="pre">buffer.originKeep</span></span><a class="headerlink" href="#confval-buffer.originKeep" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">86400</span></code></p>
<p>Type: <em>integer</em></p>
<p>Type: <em>int</em></p>
<p>Unit: <em>s</em></p>
<p>Time to keep origins in buffer.</p>
</dd></dl>
@ -586,7 +620,7 @@ possibly to a different value.</p>
<dt class="sig sig-object std" id="confval-buffer.cleanupInterval">
<span class="sig-name descname"><span class="pre">buffer.cleanupInterval</span></span><a class="headerlink" href="#confval-buffer.cleanupInterval" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">3600</span></code></p>
<p>Type: <em>integer</em></p>
<p>Type: <em>int</em></p>
<p>Unit: <em>s</em></p>
<p>Clean-up interval for removing old/unused objects.</p>
</dd></dl>
@ -618,7 +652,7 @@ possibly to a different value.</p>
<dt class="sig sig-object std" id="confval-autoloc.minPhaseCount">
<span class="sig-name descname"><span class="pre">autoloc.minPhaseCount</span></span><a class="headerlink" href="#confval-autoloc.minPhaseCount" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">6</span></code></p>
<p>Type: <em>integer</em></p>
<p>Type: <em>int</em></p>
<p>Minimum number of phases for reporting origins.</p>
</dd></dl>
@ -655,7 +689,7 @@ The secondary gap is the maximum of the sum of 2 station gaps.</p>
<dt class="sig sig-object std" id="confval-autoloc.minStaCountIgnorePKP">
<span class="sig-name descname"><span class="pre">autoloc.minStaCountIgnorePKP</span></span><a class="headerlink" href="#confval-autoloc.minStaCountIgnorePKP" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">15</span></code></p>
<p>Type: <em>integer</em></p>
<p>Type: <em>int</em></p>
<p>If the station count for stations at &lt; 105 degrees distance
exceeds this number, no picks at &gt; 105 degrees will be
used in location. They will be loosely associated, though.</p>
@ -686,7 +720,7 @@ amplitude object. If it is empty, the pick SNR is 10.</p>
<dt class="sig sig-object std" id="confval-autoloc.grid">
<span class="sig-name descname"><span class="pre">autoloc.grid</span></span><a class="headerlink" href="#confval-autoloc.grid" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">&#64;DATADIR&#64;/scautoloc/grid.conf</span></code></p>
<p>Type: <em>path</em></p>
<p>Type: <em>file</em></p>
<p>Location of the grid file for nucleating origins.</p>
</dd></dl>
@ -694,14 +728,14 @@ amplitude object. If it is empty, the pick SNR is 10.</p>
<dt class="sig sig-object std" id="confval-autoloc.stationConfig">
<span class="sig-name descname"><span class="pre">autoloc.stationConfig</span></span><a class="headerlink" href="#confval-autoloc.stationConfig" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">&#64;DATADIR&#64;/scautoloc/station.conf</span></code></p>
<p>Type: <em>path</em></p>
<p>Type: <em>file</em></p>
<p>Location of the station configuration file for nucleating origins.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-autoloc.stationLocations">
<span class="sig-name descname"><span class="pre">autoloc.stationLocations</span></span><a class="headerlink" href="#confval-autoloc.stationLocations" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>path</em></p>
<dd><p>Type: <em>file</em></p>
<p>The station file to be used when in offline mode.
If no file is given the database is used. An example is given
in &quot;&#64;DATADIR&#64;/scautoloc/station-locations.conf&quot;.</p>
@ -791,7 +825,7 @@ N is the arrival count of the origin.</p>
<dt class="sig sig-object std" id="confval-autoloc.pickLog">
<span class="sig-name descname"><span class="pre">autoloc.pickLog</span></span><a class="headerlink" href="#confval-autoloc.pickLog" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">&#64;LOGDIR&#64;/autoloc-picklog</span></code></p>
<p>Type: <em>string</em></p>
<p>Type: <em>file</em></p>
<p>Location of pick log file containing information about received
picks. Activate &quot;pickLogEnable&quot; for writing the files.</p>
</dd></dl>
@ -836,7 +870,7 @@ BOTH minAmplitude and minSNR need to be exceeded!</p>
<dt class="sig sig-object std" id="confval-autoloc.xxl.minPhaseCount">
<span class="sig-name descname"><span class="pre">autoloc.xxl.minPhaseCount</span></span><a class="headerlink" href="#confval-autoloc.xxl.minPhaseCount" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">4</span></code></p>
<p>Type: <em>integer</em></p>
<p>Type: <em>int</em></p>
<p>Minimum number of XXL picks for forming an origin.
Must be &gt;= 4.</p>
</dd></dl>
@ -1026,12 +1060,14 @@ This option can be given more than once.</p>
<dt class="sig sig-object std" id="cmdoption-scautoloc-content-type">
<span class="sig-name descname"><span class="pre">--content-type</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scautoloc-content-type" title="Permalink to this definition"></a></dt>
<dd><p>Overrides configuration parameter <a class="reference internal" href="global.html#confval-connection.contentType"><code class="xref std std-confval docutils literal notranslate"><span class="pre">connection.contentType</span></code></a>.</p>
<p>Default: <code class="docutils literal notranslate"><span class="pre">binary</span></code></p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scautoloc-start-stop-msg">
<span class="sig-name descname"><span class="pre">--start-stop-msg</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scautoloc-start-stop-msg" title="Permalink to this definition"></a></dt>
<dd><p>Set sending of a start and a stop message.</p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">0</span></code></p>
<p>Set sending of a start and a stop message.</p>
</dd></dl>
</section>
@ -1116,9 +1152,9 @@ station-locations.conf file can be provided. This implies
<dt class="sig sig-object std" id="cmdoption-scautoloc-ep">
<span class="sig-name descname"><span class="pre">--ep</span></span><span class="sig-prename descclassname"> <span class="pre">file</span></span><a class="headerlink" href="#cmdoption-scautoloc-ep" title="Permalink to this definition"></a></dt>
<dd><p>Name of input XML file (SCML) with all picks and origins for
offline processing. The database connection is not received
from messaging and must be provided. Results are sent in XML
to stdout.</p>
offline processing. Use - to read from stdin. The
database connection is not received from messaging and must
be provided. Results are sent in XML to stdout.</p>
</dd></dl>
</section>
@ -1161,126 +1197,157 @@ even when disabled by configuration.</p>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scautoloc-default-depth">
<span class="sig-name descname"><span class="pre">--default-depth</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scautoloc-default-depth" title="Permalink to this definition"></a></dt>
<dd><p>Default depth for comparison with the depth after locating.</p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">10</span></code></p>
<p>Default depth for comparison with the depth after locating.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scautoloc-max-sgap">
<span class="sig-name descname"><span class="pre">--max-sgap</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scautoloc-max-sgap" title="Permalink to this definition"></a></dt>
<dd><p>Maximum secondary azimuthal gap for an origin to be reported.
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">360</span></code></p>
<p>Maximum secondary azimuthal gap for an origin to be reported.
The secondary gap is the maximum of the sum of 2 station gaps.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scautoloc-max-rms">
<span class="sig-name descname"><span class="pre">--max-rms</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scautoloc-max-rms" title="Permalink to this definition"></a></dt>
<dd><p>Maximum travel-time RMS for a location to be reported.</p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">3.5</span></code></p>
<p>Maximum travel-time RMS for a location to be reported.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scautoloc-max-residual">
<span class="sig-name descname"><span class="pre">--max-residual</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scautoloc-max-residual" title="Permalink to this definition"></a></dt>
<dd><p>Maximum travel-time residual (unweighted) for a pick at a
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">3</span></code></p>
<p>Maximum travel-time residual (unweighted) for a pick at a
station to be used.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scautoloc-max-station-distance">
<span class="sig-name descname"><span class="pre">--max-station-distance</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scautoloc-max-station-distance" title="Permalink to this definition"></a></dt>
<dd><p>Maximum distance of stations to be used.</p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">5</span></code></p>
<p>Maximum distance of stations to be used.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scautoloc-max-nucleation-distance-default">
<span class="sig-name descname"><span class="pre">--max-nucleation-distance-default</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scautoloc-max-nucleation-distance-default" title="Permalink to this definition"></a></dt>
<dd><p>Default maximum distance of stations to be used for nucleating new origins.</p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">180</span></code></p>
<p>Default maximum distance of stations to be used for nucleating new origins.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scautoloc-min-pick-affinity">
<span class="sig-name descname"><span class="pre">--min-pick-affinity</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scautoloc-min-pick-affinity" title="Permalink to this definition"></a></dt>
<dd></dd></dl>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">0.05</span></code></p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scautoloc-min-phase-count">
<span class="sig-name descname"><span class="pre">--min-phase-count</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scautoloc-min-phase-count" title="Permalink to this definition"></a></dt>
<dd><p>Minimum number of picks for an origin to be reported.</p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">4</span></code></p>
<p>Minimum number of picks for an origin to be reported.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scautoloc-min-score">
<span class="sig-name descname"><span class="pre">--min-score</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scautoloc-min-score" title="Permalink to this definition"></a></dt>
<dd><p>Minimum score for an origin to be reported.</p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">8</span></code></p>
<p>Minimum score for an origin to be reported.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scautoloc-min-pick-snr">
<span class="sig-name descname"><span class="pre">--min-pick-snr</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scautoloc-min-pick-snr" title="Permalink to this definition"></a></dt>
<dd><p>Minimum SNR for a pick to be processed.</p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">3</span></code></p>
<p>Minimum SNR for a pick to be processed.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scautoloc-threshold-xxl">
<span class="sig-name descname"><span class="pre">--threshold-xxl</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scautoloc-threshold-xxl" title="Permalink to this definition"></a></dt>
<dd><p>An amplitude exceeding this threshold will flag the pick as XXL.</p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">10000000</span></code></p>
<p>An amplitude exceeding this threshold will flag the pick as XXL.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scautoloc-min-phase-count-xxl">
<span class="sig-name descname"><span class="pre">--min-phase-count-xxl</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scautoloc-min-phase-count-xxl" title="Permalink to this definition"></a></dt>
<dd><p>Minimum number of picks for an XXL origin to be reported.</p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">4</span></code></p>
<p>Minimum number of picks for an XXL origin to be reported.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scautoloc-max-distance-xxl">
<span class="sig-name descname"><span class="pre">--max-distance-xxl</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scautoloc-max-distance-xxl" title="Permalink to this definition"></a></dt>
<dd></dd></dl>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">15</span></code></p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scautoloc-min-sta-count-ignore-pkp">
<span class="sig-name descname"><span class="pre">--min-sta-count-ignore-pkp</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scautoloc-min-sta-count-ignore-pkp" title="Permalink to this definition"></a></dt>
<dd><p>Minimum station count for which we ignore PKP phases.</p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">15</span></code></p>
<p>Minimum station count for which we ignore PKP phases.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scautoloc-min-score-bypass-nucleator">
<span class="sig-name descname"><span class="pre">--min-score-bypass-nucleator</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scautoloc-min-score-bypass-nucleator" title="Permalink to this definition"></a></dt>
<dd><p>Minimum score at which the nucleator is bypassed.</p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">40</span></code></p>
<p>Minimum score at which the nucleator is bypassed.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scautoloc-keep-events-timespan">
<span class="sig-name descname"><span class="pre">--keep-events-timespan</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scautoloc-keep-events-timespan" title="Permalink to this definition"></a></dt>
<dd><p>The timespan to keep historical events.</p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">86400</span></code></p>
<p>The timespan to keep historical events.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scautoloc-cleanup-interval">
<span class="sig-name descname"><span class="pre">--cleanup-interval</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scautoloc-cleanup-interval" title="Permalink to this definition"></a></dt>
<dd><p>The object cleanup interval in seconds.</p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">3600</span></code></p>
<p>The object cleanup interval in seconds.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scautoloc-max-age">
<span class="sig-name descname"><span class="pre">--max-age</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scautoloc-max-age" title="Permalink to this definition"></a></dt>
<dd><p>During cleanup all pick objects older than maxAge (in seconds)
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">3784320000</span></code></p>
<p>During cleanup all pick objects older than maxAge (in seconds)
are removed (maxAge == 0 disables cleanup).</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scautoloc-wakeup-interval">
<span class="sig-name descname"><span class="pre">--wakeup-interval</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scautoloc-wakeup-interval" title="Permalink to this definition"></a></dt>
<dd><p>The interval in seconds to check pending operations.</p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">5</span></code></p>
<p>Unit: <em>s</em></p>
<p>The interval in seconds to check pending operations.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scautoloc-dynamic-pick-threshold-interval">
<span class="sig-name descname"><span class="pre">--dynamic-pick-threshold-interval</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scautoloc-dynamic-pick-threshold-interval" title="Permalink to this definition"></a></dt>
<dd><p>The interval in seconds in which to check for extraordinarily
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">60</span></code></p>
<p>The interval in seconds in which to check for extraordinarily
high pick activity, resulting in a dynamically increased
pick threshold.</p>
</dd></dl>
</section>
<section id="output">
<h3>Output<a class="headerlink" href="#output" title="Permalink to this heading"></a></h3>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scautoloc-f">
<span id="cmdoption-scautoloc-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-scautoloc-f" title="Permalink to this definition"></a></dt>
<dd><p>Use formatted XML output along with --ep. Otherwise XML
is unformatted.</p>
</dd></dl>
</section>
</section>
</section>
@ -1322,8 +1389,16 @@ pick threshold.</p>
<li><a class="reference internal" href="#publication-interval">Publication Interval</a></li>
<li><a class="reference internal" href="#housekeeping">Housekeeping</a></li>
<li><a class="reference internal" href="#test-mode">Test Mode</a></li>
<li><a class="reference internal" href="#real-time-proessing">Real-Time Proessing</a><ul>
<li><a class="reference internal" href="#daemon-mode">Daemon Mode</a></li>
<li><a class="reference internal" href="#offline-mode">Offline Mode</a></li>
<li><a class="reference internal" href="#on-demand-proessing">On-demand proessing</a></li>
</ul>
</li>
<li><a class="reference internal" href="#non-real-time-processing">Non-real Time Processing</a><ul>
<li><a class="reference internal" href="#non-real-time-playback-from-xml">Non-real-time playback from XML</a></li>
<li><a class="reference internal" href="#offline-mode">Offline mode</a></li>
</ul>
</li>
<li><a class="reference internal" href="#scautopick-and-scautoloc-interaction">scautopick and scautoloc Interaction</a><ul>
<li><a class="reference internal" href="#picks">Picks</a></li>
<li><a class="reference internal" href="#amplitudes">Amplitudes</a></li>
@ -1340,6 +1415,7 @@ pick threshold.</p>
<li><a class="reference internal" href="#id2">Mode</a></li>
<li><a class="reference internal" href="#input">Input</a></li>
<li><a class="reference internal" href="#settings">Settings</a></li>
<li><a class="reference internal" href="#output">Output</a></li>
</ul>
</li>
</ul>
@ -1376,7 +1452,7 @@ pick threshold.</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>scautopick &#8212; SeisComP Release documentation</title>
<title>scautopick &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -133,17 +133,17 @@ detection until</p>
or <a class="reference internal" href="#confval-detecFilter"><code class="xref std std-confval docutils literal notranslate"><span class="pre">detecFilter</span></code></a> in binding configuration) fall below the
<a class="reference internal" href="#confval-thresholds.triggerOff"><code class="xref std std-confval docutils literal notranslate"><span class="pre">thresholds.triggerOff</span></code></a> (module configuration) or <a class="reference internal" href="#confval-trigOff"><code class="xref std std-confval docutils literal notranslate"><span class="pre">trigOff</span></code></a>
(binding configuration) and</p></li>
<li><p>Amplitudes, <img class="math" src="../_images/math/aacc7f12eb22a023f357a646e0f454316582b412.png" alt="A_{trigger}"/>, measured after filtering reach or
exceed a threshold determined by <img class="math" src="../_images/math/c203316b956d1d1200e7495212052b0d3f3d5694.png" alt="T_{minOffset}"/> (<a class="reference internal" href="#confval-thresholds.minAmplOffset"><code class="xref std std-confval docutils literal notranslate"><span class="pre">thresholds.minAmplOffset</span></code></a>),
<img class="math" src="../_images/math/db59170f9358afd576a6d3e9d83c93e57d72f3d5.png" alt="T_{dead}"/> (<a class="reference internal" href="#confval-thresholds.deadTime"><code class="xref std std-confval docutils literal notranslate"><span class="pre">thresholds.deadTime</span></code></a>) and the amplitude of the
previous pick, <img class="math" src="../_images/math/62931c5a91442d18740e07a2f6025ba3c19a8cc4.png" alt="A_{prev}"/>:</p>
<li><p>Amplitudes, <img class="math" src="../_images/math/aacc7f12eb22a023f357a646e0f454316582b412.svg" alt="A_{trigger}"/>, measured after filtering reach or
exceed a threshold determined by <img class="math" src="../_images/math/c203316b956d1d1200e7495212052b0d3f3d5694.svg" alt="T_{minOffset}"/> (<a class="reference internal" href="#confval-thresholds.minAmplOffset"><code class="xref std std-confval docutils literal notranslate"><span class="pre">thresholds.minAmplOffset</span></code></a>),
<img class="math" src="../_images/math/db59170f9358afd576a6d3e9d83c93e57d72f3d5.svg" alt="T_{dead}"/> (<a class="reference internal" href="#confval-thresholds.deadTime"><code class="xref std std-confval docutils literal notranslate"><span class="pre">thresholds.deadTime</span></code></a>) and the amplitude of the
previous pick, <img class="math" src="../_images/math/62931c5a91442d18740e07a2f6025ba3c19a8cc4.svg" alt="A_{prev}"/>:</p>
<div class="math">
<p><img src="../_images/math/801626e9d679a20daf87d213b35a8e61afa3c7c3.png" alt="A_{trigger} \ge T_{minOffset} + A_{prev} * exp\left(-(dt/T_{dead})^2\right)"/></p>
</div><p>if <img class="math" src="../_images/math/23218412e257e23a8ae16da8fdd171f6d9272dc4.png" alt="T_{dead} &gt; 0"/>. Otherwise:</p>
<p><img src="../_images/math/801626e9d679a20daf87d213b35a8e61afa3c7c3.svg" alt="A_{trigger} \ge T_{minOffset} + A_{prev} * exp\left(-(dt/T_{dead})^2\right)"/></p>
</div><p>if <img class="math" src="../_images/math/23218412e257e23a8ae16da8fdd171f6d9272dc4.svg" alt="T_{dead} &gt; 0"/>. Otherwise:</p>
<div class="math">
<p><img src="../_images/math/add6f0e77c4f4c6f2b44d93f5bc1eba13c64f3a2.png" alt="A_{trigger} \ge T_{minOffset}"/></p>
</div><p>Here, <img class="math" src="../_images/math/a679bbf1184a6019c0b0085a592d1c7fc64335cf.png" alt="dt"/> is the time passed since the last pick.
<img class="math" src="../_images/math/c203316b956d1d1200e7495212052b0d3f3d5694.png" alt="T_{minOffset}"/> (<a class="reference internal" href="#confval-thresholds.minAmplOffset"><code class="xref std std-confval docutils literal notranslate"><span class="pre">thresholds.minAmplOffset</span></code></a>) is typically similar to
<p><img src="../_images/math/add6f0e77c4f4c6f2b44d93f5bc1eba13c64f3a2.svg" alt="A_{trigger} \ge T_{minOffset}"/></p>
</div><p>Here, <img class="math" src="../_images/math/a679bbf1184a6019c0b0085a592d1c7fc64335cf.svg" alt="dt"/> is the time passed since the last pick.
<img class="math" src="../_images/math/c203316b956d1d1200e7495212052b0d3f3d5694.svg" alt="T_{minOffset}"/> (<a class="reference internal" href="#confval-thresholds.minAmplOffset"><code class="xref std std-confval docutils literal notranslate"><span class="pre">thresholds.minAmplOffset</span></code></a>) is typically similar to
the trigger threshold, <a class="reference internal" href="#confval-thresholds.triggerOn"><code class="xref std std-confval docutils literal notranslate"><span class="pre">thresholds.triggerOn</span></code></a> (module configuration) or
<a class="reference internal" href="#confval-trigOn"><code class="xref std std-confval docutils literal notranslate"><span class="pre">trigOn</span></code></a> (binding configuration).</p>
</li>
@ -384,11 +384,10 @@ values (bindings) override this value.</p>
<dt class="sig sig-object std" id="confval-picker">
<span class="sig-name descname"><span class="pre">picker</span></span><a class="headerlink" href="#confval-picker" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>Values: <code class="docutils literal notranslate"><span class="pre">AIC,BK,GFZ</span></code></p>
<p>The re-picker to use. By default only simple detections
are emitted as picks. To enable re-picking on a time window around
the detection, an algorithm (plugin) can be defined with this parameter.</p>
<p>Currently available: &quot;AIC&quot;, &quot;BK&quot; or
&quot;GFZ&quot;.</p>
<p>More options may be available by plugins. Configure related
parameters in global bindings.</p>
</dd></dl>
@ -418,10 +417,10 @@ their evaluation status.</p>
<dt class="sig sig-object std" id="confval-spicker">
<span class="sig-name descname"><span class="pre">spicker</span></span><a class="headerlink" href="#confval-spicker" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>The secondary picker to use, e.g., for picking S-phases.
Currently available is: &quot;S-L2&quot;. More options may
be available by plugins. Configure related parameters
in global bindings.</p>
<p>Values: <code class="docutils literal notranslate"><span class="pre">S-L2,S-V</span></code></p>
<p>The secondary picker to use, e.g., for picking S-phases.</p>
<p>More options may be available by plugins. Configure related
parameters in global bindings.</p>
</dd></dl>
<dl class="std confval">
@ -453,15 +452,27 @@ of the pick creation, which actually requires
with a non-negative value.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-simplifiedIDs">
<span class="sig-name descname"><span class="pre">simplifiedIDs</span></span><a class="headerlink" href="#confval-simplifiedIDs" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">false</span></code></p>
<p>Type: <em>boolean</em></p>
<p>If enabled then simplified pick and amplitude IDs will be created.
Rather than the configured publicID pattern, the following pattern
will be used: &quot;%Y%m%d.%H%M%S.%f-&#64;net.sta.loc.cha&#64;&quot;.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-fx">
<span class="sig-name descname"><span class="pre">fx</span></span><a class="headerlink" href="#confval-fx" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>Values: <code class="docutils literal notranslate"><span class="pre">DFX</span></code></p>
<p>Configures the feature extraction type to use. Currently
available: &quot;DFX&quot;. Configure related parameters
in global bindings.</p>
<p>When configured, the usability of the features for locating
events depends on the used locator, e.g. LOCSAT. Read the
events depends on the used locator, e.g. LOCSAT will by default
consider slowness and backazimuth when measured. Read the
locators documentation and configuration parameters.</p>
</dd></dl>
@ -546,10 +557,14 @@ similar to the trigger threshold. Read the documentation!</p>
<span class="sig-name descname"><span class="pre">thresholds.minDuration</span></span><a class="headerlink" href="#confval-thresholds.minDuration" 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>Unit: <em>s</em></p>
<p>The minimum duration to reach. The duration is measured as
the time between trigger on and trigger off. If this value
is configured the detection (pick) will be delayed in order
is configured, the detection (pick) will be delayed in order
to compute and check the duration.</p>
<p>The duration will be reported as comment to the pick when
activating &quot;extraPickComments&quot; allowing the tuning
of the acceptable duration range.</p>
</dd></dl>
<dl class="std confval">
@ -557,10 +572,15 @@ to compute and check the duration.</p>
<span class="sig-name descname"><span class="pre">thresholds.maxDuration</span></span><a class="headerlink" href="#confval-thresholds.maxDuration" 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>Unit: <em>s</em></p>
<p>The maximum duration allowed. The duration is measured as
the time between trigger on and trigger off. If this value
is configured the detection (pick) will be delayed in order
to compute and check the duration.</p>
is configured, the detection (pick) will be delayed in order
to compute and check the duration. Negative values
deactivate the check.</p>
<p>The duration will be reported as comment to the pick when
activating &quot;extraPickComments&quot; allowing the tuning
of the acceptable duration range.</p>
</dd></dl>
<dl class="std confval">
@ -823,12 +843,14 @@ This option can be given more than once.</p>
<dt class="sig sig-object std" id="cmdoption-scautopick-content-type">
<span class="sig-name descname"><span class="pre">--content-type</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scautopick-content-type" title="Permalink to this definition"></a></dt>
<dd><p>Overrides configuration parameter <a class="reference internal" href="global.html#confval-connection.contentType"><code class="xref std std-confval docutils literal notranslate"><span class="pre">connection.contentType</span></code></a>.</p>
<p>Default: <code class="docutils literal notranslate"><span class="pre">binary</span></code></p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scautopick-start-stop-msg">
<span class="sig-name descname"><span class="pre">--start-stop-msg</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scautopick-start-stop-msg" title="Permalink to this definition"></a></dt>
<dd><p>Set sending of a start and a stop message.</p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">0</span></code></p>
<p>Set sending of a start and a stop message.</p>
</dd></dl>
</section>
@ -880,12 +902,12 @@ can be queried with &quot;--db-driver-list&quot;.</p>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scautopick-I">
<span id="cmdoption-scautopick-record-url"></span><span class="sig-name descname"><span class="pre">-I</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">--record-url</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scautopick-I" title="Permalink to this definition"></a></dt>
<dd><p>The recordstream source URL, format:
<dd><p>The RecordStream source URL. Format:
[<a class="reference external" href="service://">service://</a>]location[#type].
&quot;service&quot; is the name of the recordstream driver
&quot;service&quot; is the name of the RecordStream driver
which can be queried with &quot;--record-driver-list&quot;.
If &quot;service&quot; is not given, &quot;<a class="reference external" href="file://">file://</a>&quot; is
used.</p>
used and simply the name of a miniSEED file can be given.</p>
</dd></dl>
<dl class="std option">
@ -922,14 +944,17 @@ older datasets in offline mode or when running playbacks.</p>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scautopick-ep">
<span class="sig-name descname"><span class="pre">--ep</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-scautopick-ep" title="Permalink to this definition"></a></dt>
<dd><p>Outputs an XML event parameters file containing all picks and amplitudes.
This option implies offline.</p>
<dd><p>Outputs an XML event parameters file containing all
picks and amplitudes. This option implies --offline.
Consider --playback or configure accordingly for
processing data from the past.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scautopick-amplitudes">
<span class="sig-name descname"><span class="pre">--amplitudes</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scautopick-amplitudes" title="Permalink to this definition"></a></dt>
<dd><p>Enables or disables computation of amplitudes.</p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">1</span></code></p>
<p>Enables or disables computation of amplitudes.</p>
</dd></dl>
<dl class="std option">
@ -1048,6 +1073,16 @@ and a new amplitude is available. The output format is a simple ASCII format.</p
<dd><p>Overrides configuration parameter <a class="reference internal" href="#confval-extraPickComments"><code class="xref std std-confval docutils literal notranslate"><span class="pre">extraPickComments</span></code></a>.</p>
</dd></dl>
</section>
<section id="output">
<h3>Output<a class="headerlink" href="#output" title="Permalink to this heading"></a></h3>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scautopick-f">
<span id="cmdoption-scautopick-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-scautopick-f" title="Permalink to this definition"></a></dt>
<dd><p>Use formatted XML output along with --ep. Otherwise XML
is unformatted.</p>
</dd></dl>
</section>
</section>
</section>
@ -1096,6 +1131,7 @@ and a new amplitude is available. The output format is a simple ASCII format.</p
<li><a class="reference internal" href="#records">Records</a></li>
<li><a class="reference internal" href="#mode">Mode</a></li>
<li><a class="reference internal" href="#settings">Settings</a></li>
<li><a class="reference internal" href="#output">Output</a></li>
</ul>
</li>
</ul>
@ -1132,7 +1168,7 @@ and a new amplitude is available. The output format is a simple ASCII format.</p
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>scbulletin &#8212; SeisComP Release documentation</title>
<title>scbulletin &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -77,13 +77,13 @@
<p><strong>Create bulletins from SCML.</strong></p>
<section id="description">
<h2>Description<a class="headerlink" href="#description" title="Permalink to this heading"></a></h2>
<p>scbulletin transforms the parameters of events or origins either to various formats.
Currently supported output formats are:</p>
<p>scbulletin transforms the parameters of events or origins to various bulletin
formats. Currently supported output formats are:</p>
<ul class="simple">
<li><p>autoloc1,</p></li>
<li><p>autoloc3,</p></li>
<li><p>fdsnws,</p></li>
<li><p>kml.</p></li>
<li><p>1: autoloc1,</p></li>
<li><p>3: autoloc3,</p></li>
<li><p>4: fdsnws,</p></li>
<li><p>5: kml.</p></li>
</ul>
</section>
<section id="input-modes">
@ -92,7 +92,7 @@ Currently supported output formats are:</p>
<ol class="arabic simple">
<li><p>Dump mode: Fetch all necessary information from database directly. Either
choose one or more event or origin IDs. The database connection must be given
with <code class="xref std std-option docutils literal notranslate"><span class="pre">-o</span></code>.</p></li>
with <code class="xref std std-option docutils literal notranslate"><span class="pre">-d</span></code>.</p></li>
<li><p>Input mode: Provide all event and origin information in XML (<a class="reference internal" href="../base/glossary.html#term-SCML"><span class="xref std std-term">SCML</span></a>)
format from file or stdin. You may filter further by event or origin ID.</p></li>
</ol>
@ -108,22 +108,24 @@ can be generated by <a class="reference internal" href="scxmldump.html#scxmldump
</section>
<section id="output-modes">
<h2>Output Modes<a class="headerlink" href="#output-modes" title="Permalink to this heading"></a></h2>
<p>The generated content is written to stdout or, with option <code class="xref std std-option docutils literal notranslate"><span class="pre">-o</span></code> to a
file. Different output formats are available by command-line options:</p>
<p>The generated content is written to stdout or to a file with option <code class="xref std std-option docutils literal notranslate"><span class="pre">-o</span></code>.
Different output formats are available by command-line options:</p>
<ul class="simple">
<li><p><code class="docutils literal notranslate"><span class="pre">-1</span></code> for <strong>autoloc1</strong>: Print one bulletin per event.</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">-3</span></code> for <strong>autoloc3</strong>: Print one bulletin per event.</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">-3</span> <span class="pre">-x</span></code> for <strong>extended autoloc3</strong>.</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">-4</span></code> or <code class="docutils literal notranslate"><span class="pre">--fdsnws</span></code> for FDSNWS event text: Print one line per event. Useful
for generating event catalogs. This option offers an alternative to generating
event catalogs by <a class="reference internal" href="fdsnws.html#sec-event"><span class="std std-ref">fdsnws-event</span></a>.</p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">-5</span></code> or <code class="docutils literal notranslate"><span class="pre">--kml</span></code> for KML/GIS file format. The output can be viewed, e.g.,
in <em>Google Earth</em>.</p></li>
<li><p><code class="xref std std-option docutils literal notranslate"><span class="pre">-1</span></code> for <strong>autoloc1</strong>: Print one bulletin per event.</p></li>
<li><p><code class="xref std std-option docutils literal notranslate"><span class="pre">-3</span></code> for <strong>autoloc3</strong>: Print one bulletin per event.</p></li>
<li><p><code class="xref std std-option docutils literal notranslate"><span class="pre">-4</span></code> or <code class="xref std std-option docutils literal notranslate"><span class="pre">--fdsnws</span></code> for FDSNWS event text: Print one line per
event. Useful for generating event catalogs. This option offers an alternative
to generating event catalogs compatible with <a class="reference internal" href="fdsnws.html#sec-event"><span class="std std-ref">fdsnws-event</span></a>
CSV format defined by <span id="id2"><em>FDSNWS</em> [<a class="reference internal" href="../base/references.html#id135" title="FDSNWS. International Federation of Digital Seismograph Networks. URL: http://www.fdsn.org/webservices/.">8</a>]</span>.</p></li>
<li><p><code class="xref std std-option docutils literal notranslate"><span class="pre">-5</span></code> or <code class="xref std std-option docutils literal notranslate"><span class="pre">--kml</span></code> for KML/GIS file format. The output can be
viewed, e.g., in <em>Google Earth</em>.</p></li>
</ul>
<p>By default, the output precision of times or coordinates is optimized for events
at teleseismic or regional distances. Use the option <code class="xref std std-option docutils literal notranslate"><span class="pre">-e</span></code> for
<strong>enhanced</strong> output at higher precision: All times and distances are in units
of milliseconds and meters, respectively.</p>
<strong>enhanced</strong> output at higher precision. Then all times and distances are given
with precision of milliseconds and meters, respectively.
Combine options <code class="xref std std-option docutils literal notranslate"><span class="pre">-3</span></code> or <code class="xref std std-option docutils literal notranslate"><span class="pre">-4</span></code> with <code class="xref std std-option docutils literal notranslate"><span class="pre">-x</span></code> for printing more
parameters in generated bulletins.</p>
</section>
<section id="examples">
<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this heading"></a></h2>
@ -155,7 +157,8 @@ scbulletin<span class="w"> </span>-i<span class="w"> </span>gfz2012abcd.xml<span
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>When considering a single event XML file containing many events, the
bulletins of all events will be generated unless <code class="docutils literal notranslate"><span class="pre">--first-only</span></code> is used.</p>
bulletins of all events will be generated unless <code class="xref std std-option docutils literal notranslate"><span class="pre">--first-only</span></code> is
used.</p>
</div>
</section>
<section id="module-configuration">
@ -450,8 +453,10 @@ printed to stdout.</p>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scbulletin-0">
<span id="cmdoption-scbulletin-2"></span><span class="sig-name descname"><span class="pre">-x</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">--extra</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-scbulletin-0" title="Permalink to this definition"></a></dt>
<dd><p>Use a specially detailed autoloc3 format. This options works
only in combination with the autoloc3-flag.</p>
<dd><p>Generate extra detailed output for specific output formats adding</p>
<p>- 3/autoloc3: IDs of preferred objects and creation information</p>
<p>- 4/FDSNWS event text: Additional columns</p>
<p>More information may be added in future versions.</p>
</dd></dl>
</section>
@ -527,7 +532,7 @@ only in combination with the autoloc3-flag.</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>scchkcfg &#8212; SeisComP Release documentation</title>
<title>scchkcfg &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -184,7 +184,7 @@ decide whether it needs a fix or not.</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>sccnv &#8212; SeisComP Release documentation</title>
<title>sccnv &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -74,15 +74,15 @@
<section id="sccnv">
<span id="id1"></span><h1>sccnv<a class="headerlink" href="#sccnv" title="Permalink to this heading"></a></h1>
<p><strong>Converts data in different formats.</strong></p>
<p><strong>Converts data from/to different formats.</strong></p>
<section id="description">
<h2>Description<a class="headerlink" href="#description" title="Permalink to this heading"></a></h2>
<p>sccnv reads input given in a supported format, converts the content to another
format and writes the output. Use the command-line option <code class="xref std std-confval docutils literal notranslate"><span class="pre">format-list</span></code>
format and writes the output. Use the command-line option <code class="xref std std-option docutils literal notranslate"><span class="pre">--format-list</span></code>
for a list of supported formats.</p>
</section>
<section id="formats">
<h2>Formats<a class="headerlink" href="#formats" title="Permalink to this heading"></a></h2>
<span id="sec-sccnv-formats"></span><h2>Formats<a class="headerlink" href="#formats" title="Permalink to this heading"></a></h2>
<p>Different formats are supported for input and output files.</p>
<table class="docutils align-left">
<colgroup>
@ -104,56 +104,71 @@ for a list of supported formats.</p>
<td><p>X</p></td>
<td><p>X</p></td>
</tr>
<tr class="row-odd"><td><p>bson</p></td>
<tr class="row-odd"><td><p>binary</p></td>
<td><p><a class="reference internal" href="../base/api-python.html#api-datamodel-python"><span class="std std-ref">SeisComP data model</span></a> in binary format: low-weight and fast</p></td>
<td><p>X</p></td>
<td><p>X</p></td>
</tr>
<tr class="row-even"><td><p>bson</p></td>
<td></td>
<td><p>X</p></td>
<td><p>X</p></td>
</tr>
<tr class="row-even"><td><p>bson-json</p></td>
<tr class="row-odd"><td><p>bson-json</p></td>
<td></td>
<td></td>
<td><p>X</p></td>
</tr>
<tr class="row-odd"><td><p>csv</p></td>
<tr class="row-even"><td><p>csv</p></td>
<td><p>comma-separated values</p></td>
<td></td>
<td><p>X</p></td>
</tr>
<tr class="row-even"><td><p>hyp71sum2k</p></td>
<tr class="row-odd"><td><p>hyp71sum2k</p></td>
<td><p>Hypo71 format</p></td>
<td></td>
<td><p>X</p></td>
</tr>
<tr class="row-odd"><td><p>ims10</p></td>
<tr class="row-even"><td><p>ims10</p></td>
<td></td>
<td></td>
<td><p>X</p></td>
</tr>
<tr class="row-even"><td><p>json</p></td>
<td><p><a class="reference external" href="https://www.json.org/">JSON</a> format</p></td>
<tr class="row-odd"><td><p>json</p></td>
<td><p><span id="id2"><em>Introducing JSON</em> [<a class="reference internal" href="../base/references.html#id171" title="Introducing JSON. Internet. URL: https://www.json.org.">16</a>]</span> format</p></td>
<td><p>X</p></td>
<td><p>X</p></td>
</tr>
<tr class="row-odd"><td><p>qml1.2</p></td>
<tr class="row-even"><td><p>qml1.2</p></td>
<td><p><a class="reference internal" href="../base/glossary.html#term-QuakeML"><span class="xref std std-term">QuakeML</span></a> format</p></td>
<td><p>*</p></td>
<td><p>X</p></td>
</tr>
<tr class="row-even"><td><p>qml1.2rt</p></td>
<tr class="row-odd"><td><p>qml1.2rt</p></td>
<td><p><a class="reference internal" href="../base/glossary.html#term-QuakeML"><span class="xref std std-term">QuakeML</span></a> real time (RT) format</p></td>
<td><p>*</p></td>
<td><p>X</p></td>
</tr>
<tr class="row-odd"><td><p>scdm0.51</p></td>
<tr class="row-even"><td><p>scdm0.51</p></td>
<td></td>
<td><p>X</p></td>
<td><p>X</p></td>
</tr>
<tr class="row-even"><td><p>trunk</p></td>
<tr class="row-odd"><td><p>scml</p></td>
<td><p>SeisComP XML (<a class="reference internal" href="../base/glossary.html#term-SCML"><span class="xref std std-term">SCML</span></a>) - <a class="reference internal" href="../base/api-python.html#api-datamodel-python"><span class="std std-ref">SCML API</span></a></p></td>
<td><p>X</p></td>
<td><p>X</p></td>
</tr>
<tr class="row-even"><td><p>trunk</p></td>
<td><p>same as scml, classic way of stating this format</p></td>
<td><p>X</p></td>
<td><p>X</p></td>
</tr>
<tr class="row-odd"><td><p>vbson</p></td>
<td></td>
<td><p>X</p></td>
<td><p>X</p></td>
</tr>
</tbody>
</table>
<p><strong>*</strong>: The conversion from files in QuakeML format is not supported by sccnv
@ -209,7 +224,7 @@ content in a file:</p>
</li>
<li><p>Convert an event parameter file in <a class="reference internal" href="../base/glossary.html#term-SCML"><span class="xref std std-term">SCML</span></a> format to ims1.0 and store the
content in a file:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>$<span class="w"> </span>sccnv<span class="w"> </span>-i<span class="w"> </span>trunk:event.xml<span class="w"> </span>-o<span class="w"> </span>ims10:event.ims
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>$<span class="w"> </span>sccnv<span class="w"> </span>-i<span class="w"> </span>scml:event.xml<span class="w"> </span>-o<span class="w"> </span>ims10:event.ims
</pre></div>
</div>
</li>
@ -223,9 +238,9 @@ content in a file:</p>
<section id="command-line-options">
<h2>Command-Line Options<a class="headerlink" href="#command-line-options" title="Permalink to this heading"></a></h2>
<p><strong class="program">sccnv -i format:file -o format:file</strong></p>
<p>sccnv reads the input given in a supported format, converts the content
and writes the output in another format. Use the option <cite>format-list</cite>
for a list of supported formats.</p>
<p>sccnv reads the input given in a supported format, converts the
content and writes the output in another format. Use the option
<cite>format-list</cite> for a list of supported formats.</p>
<section id="generic">
<h3>Generic<a class="headerlink" href="#generic" title="Permalink to this heading"></a></h3>
<dl class="std option">
@ -257,12 +272,18 @@ Equivalent to --verbosity=4 --console=1 .</p>
</dd></dl>
</section>
<section id="id2">
<h3>Formats<a class="headerlink" href="#id2" title="Permalink to this heading"></a></h3>
<section id="id3">
<h3>Formats<a class="headerlink" href="#id3" title="Permalink to this heading"></a></h3>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-sccnv-format-list">
<span class="sig-name descname"><span class="pre">--format-list</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-sccnv-format-list" title="Permalink to this definition"></a></dt>
<dd><p>List all supported formats</p>
<dd><p>List all supported formats.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-sccnv-list-formats">
<span class="sig-name descname"><span class="pre">--list-formats</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-sccnv-list-formats" title="Permalink to this definition"></a></dt>
<dd><p>Same as --format-list.</p>
</dd></dl>
</section>
@ -271,7 +292,8 @@ Equivalent to --verbosity=4 --console=1 .</p>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-sccnv-i">
<span id="cmdoption-sccnv-input"></span><span class="sig-name descname"><span class="pre">-i</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">--input</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-sccnv-i" title="Permalink to this definition"></a></dt>
<dd><p>Input stream [format:][file], default: trunk:-</p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">scml:-</span></code></p>
<p>Input stream [format:][file].</p>
</dd></dl>
</section>
@ -280,19 +302,21 @@ Equivalent to --verbosity=4 --console=1 .</p>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-sccnv-o">
<span id="cmdoption-sccnv-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-sccnv-o" title="Permalink to this definition"></a></dt>
<dd><p>Output stream [format:][file], default trunk:-</p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">scml:-</span></code></p>
<p>Output stream [format:][file].</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-sccnv-f">
<span id="cmdoption-sccnv-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-sccnv-f" title="Permalink to this definition"></a></dt>
<dd><p>Use formatted output</p>
<dd><p>Use formatted output.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-sccnv-indent">
<span class="sig-name descname"><span class="pre">--indent</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-sccnv-indent" title="Permalink to this definition"></a></dt>
<dd><p>Formatted line indent. Default: 2</p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">2</span></code></p>
<p>Formatted line indent.</p>
</dd></dl>
</section>
@ -329,7 +353,7 @@ Equivalent to --verbosity=4 --console=1 .</p>
<li><a class="reference internal" href="#command-line-options">Command-Line Options</a><ul>
<li><a class="reference internal" href="#generic">Generic</a></li>
<li><a class="reference internal" href="#verbosity">Verbosity</a></li>
<li><a class="reference internal" href="#id2">Formats</a></li>
<li><a class="reference internal" href="#id3">Formats</a></li>
<li><a class="reference internal" href="#input">Input</a></li>
<li><a class="reference internal" href="#output">Output</a></li>
</ul>
@ -368,7 +392,7 @@ Equivalent to --verbosity=4 --console=1 .</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>scconfig &#8212; SeisComP Release documentation</title>
<title>scconfig &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -549,7 +549,7 @@ Docs panel.</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>scdb &#8212; SeisComP Release documentation</title>
<title>scdb &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -365,12 +365,14 @@ This option can be given more than once.</p>
<dt class="sig sig-object std" id="cmdoption-scdb-content-type">
<span class="sig-name descname"><span class="pre">--content-type</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scdb-content-type" title="Permalink to this definition"></a></dt>
<dd><p>Overrides configuration parameter <a class="reference internal" href="global.html#confval-connection.contentType"><code class="xref std std-confval docutils literal notranslate"><span class="pre">connection.contentType</span></code></a>.</p>
<p>Default: <code class="docutils literal notranslate"><span class="pre">binary</span></code></p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scdb-start-stop-msg">
<span class="sig-name descname"><span class="pre">--start-stop-msg</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scdb-start-stop-msg" title="Permalink to this definition"></a></dt>
<dd><p>Set sending of a start and a stop message.</p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">0</span></code></p>
<p>Set sending of a start and a stop message.</p>
</dd></dl>
<dl class="std option">
@ -441,6 +443,19 @@ to clients as part of a database response messages.</p>
Can be provided multiple times to import multiple files.</p>
</dd></dl>
</section>
<section id="operation">
<h3>Operation<a class="headerlink" href="#operation" title="Permalink to this heading"></a></h3>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scdb-x">
<span id="cmdoption-scdb-wipe"></span><span class="sig-name descname"><span class="pre">-x</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">--wipe</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scdb-x" title="Permalink to this definition"></a></dt>
<dd><p>PublicObjects for which all child objects will be wiped out.
A PublicObject is defined as {type}[:{publicID}],
e.g. Origin:123.
If the colon and publicID is omitted then the publicID is
equal to the type, e.g. Inventory.</p>
</dd></dl>
</section>
</section>
</section>
@ -479,6 +494,7 @@ Can be provided multiple times to import multiple files.</p>
<li><a class="reference internal" href="#messaging">Messaging</a></li>
<li><a class="reference internal" href="#database">Database</a></li>
<li><a class="reference internal" href="#import">Import</a></li>
<li><a class="reference internal" href="#operation">Operation</a></li>
</ul>
</li>
</ul>
@ -515,7 +531,7 @@ Can be provided multiple times to import multiple files.</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>scdbstrip &#8212; SeisComP Release documentation</title>
<title>scdbstrip &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -485,10 +485,26 @@ startTime~endTime that is %Y-%m-%dT%H:%M:%S~%Y-%m-%dT%H:%M:%S</p>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scdbstrip-keep-events">
<span class="sig-name descname"><span class="pre">--keep-events</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-scdbstrip-keep-events" title="Permalink to this definition"></a></dt>
<span class="sig-name descname"><span class="pre">--keep-events</span></span><span class="sig-prename descclassname"> <span class="pre">events</span></span><a class="headerlink" href="#cmdoption-scdbstrip-keep-events" title="Permalink to this definition"></a></dt>
<dd><p>IDs of events to keep in the database separated with comma.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scdbstrip-keep-event-modes">
<span class="sig-name descname"><span class="pre">--keep-event-modes</span></span><span class="sig-prename descclassname"> <span class="pre">modes</span></span><a class="headerlink" href="#cmdoption-scdbstrip-keep-event-modes" title="Permalink to this definition"></a></dt>
<dd><p>Do not delete events where the evaluation mode of the
preferred origin is one of the passed modes. Modes are
given as a list with comma as separator.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scdbstrip-keep-event-status">
<span class="sig-name descname"><span class="pre">--keep-event-status</span></span><span class="sig-prename descclassname"> <span class="pre">status</span></span><a class="headerlink" href="#cmdoption-scdbstrip-keep-event-status" title="Permalink to this definition"></a></dt>
<dd><p>Do not delete events where the evaluation status of the
preferred origin is one of the passed status. Status are
given as a list with comma as separator.</p>
</dd></dl>
</section>
</section>
</section>
@ -561,7 +577,7 @@ startTime~endTime that is %Y-%m-%dT%H:%M:%S~%Y-%m-%dT%H:%M:%S</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>scdispatch &#8212; SeisComP Release documentation</title>
<title>scdispatch &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -407,12 +407,14 @@ This option can be given more than once.</p>
<dt class="sig sig-object std" id="cmdoption-scdispatch-content-type">
<span class="sig-name descname"><span class="pre">--content-type</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scdispatch-content-type" title="Permalink to this definition"></a></dt>
<dd><p>Overrides configuration parameter <a class="reference internal" href="global.html#confval-connection.contentType"><code class="xref std std-confval docutils literal notranslate"><span class="pre">connection.contentType</span></code></a>.</p>
<p>Default: <code class="docutils literal notranslate"><span class="pre">binary</span></code></p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scdispatch-start-stop-msg">
<span class="sig-name descname"><span class="pre">--start-stop-msg</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scdispatch-start-stop-msg" title="Permalink to this definition"></a></dt>
<dd><p>Set sending of a start and a stop message.</p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">0</span></code></p>
<p>Set sending of a start and a stop message.</p>
</dd></dl>
</section>
@ -471,7 +473,9 @@ event parameters.</p>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scdispatch-O">
<span id="cmdoption-scdispatch-operation"></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">--operation</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scdispatch-O" title="Permalink to this definition"></a></dt>
<dd><p>Merge and merge-without-remove require a database
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">merge</span></code></p>
<p>Values: <code class="docutils literal notranslate"><span class="pre">add,update,remove,merge,merge-without-remove</span></code></p>
<p>Merge and merge-without-remove require a database
connection. Both will read the object corresponding to the
sent object from the database and calculate the differences.
Merge-without-remove behaves like merge with the exception
@ -497,7 +501,8 @@ existence in the database.</p>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scdispatch-routingtable">
<span class="sig-name descname"><span class="pre">--routingtable</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scdispatch-routingtable" title="Permalink to this definition"></a></dt>
<dd><p>Specify routing table as comma separated list of object:group
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">Amplitude:AMPLITUDE,Event:EVENT,FocalMechanism:FOCMECH,Magnitude:MAGNITUDE,</span> <span class="pre">Origin:LOCATION,Pick:PICK,StationMagnitude:MAGNITUDE</span></code></p>
<p>Specify routing table as comma separated list of object:group
pairs, e.g. &quot;Origin:LOCATION,Event:EVENT&quot;. When an
object should be routed to a group and no table entry for
that particular class type is available, all parent objects
@ -596,7 +601,7 @@ standard output in XML format.</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>scdumpcfg &#8212; SeisComP Release documentation</title>
<title>scdumpcfg &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -417,7 +417,7 @@ e.g., invextr, scart, scmssort, scevtstreams.</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>scesv &#8212; SeisComP Release documentation</title>
<title>scesv &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -662,12 +662,14 @@ This option can be given more than once.</p>
<dt class="sig sig-object std" id="cmdoption-scesv-content-type">
<span class="sig-name descname"><span class="pre">--content-type</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scesv-content-type" title="Permalink to this definition"></a></dt>
<dd><p>Overrides configuration parameter <a class="reference internal" href="global.html#confval-connection.contentType"><code class="xref std std-confval docutils literal notranslate"><span class="pre">connection.contentType</span></code></a>.</p>
<p>Default: <code class="docutils literal notranslate"><span class="pre">binary</span></code></p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scesv-start-stop-msg">
<span class="sig-name descname"><span class="pre">--start-stop-msg</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scesv-start-stop-msg" title="Permalink to this definition"></a></dt>
<dd><p>Set sending of a start and a stop message.</p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">0</span></code></p>
<p>Set sending of a start and a stop message.</p>
</dd></dl>
</section>
@ -719,12 +721,12 @@ can be queried with &quot;--db-driver-list&quot;.</p>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scesv-I">
<span id="cmdoption-scesv-record-url"></span><span class="sig-name descname"><span class="pre">-I</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">--record-url</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scesv-I" title="Permalink to this definition"></a></dt>
<dd><p>The recordstream source URL, format:
<dd><p>The RecordStream source URL. Format:
[<a class="reference external" href="service://">service://</a>]location[#type].
&quot;service&quot; is the name of the recordstream driver
&quot;service&quot; is the name of the RecordStream driver
which can be queried with &quot;--record-driver-list&quot;.
If &quot;service&quot; is not given, &quot;<a class="reference external" href="file://">file://</a>&quot; is
used.</p>
used and simply the name of a miniSEED file can be given.</p>
</dd></dl>
<dl class="std option">
@ -745,7 +747,9 @@ used.</p>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scesv-city-xml">
<span class="sig-name descname"><span class="pre">--city-xml</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scesv-city-xml" title="Permalink to this definition"></a></dt>
<dd><p>The path to the cities XML file. This overrides the default
<dd><p>Type: <em>file</em></p>
<p>Values: <code class="docutils literal notranslate"><span class="pre">*.xml</span></code></p>
<p>The path to the cities XML file. This overrides the default
paths. Compare with the global parameter &quot;citiesXML&quot;.</p>
</dd></dl>
@ -868,7 +872,7 @@ parameters $1, $2, $3 and $4, respectively.</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>scevent &#8212; SeisComP Release documentation</title>
<title>scevent &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -74,8 +74,8 @@
<section id="scevent">
<span id="id1"></span><h1>scevent<a class="headerlink" href="#scevent" title="Permalink to this heading"></a></h1>
<p><strong>Associates an Origin to an Event or forms a new Event if no match is found.
Selects the preferred origin, magnitude and focal mechanism.</strong></p>
<p><strong>Associate an Origin to an Event or form a new Event if no match is found.
Select the preferred origin, magnitude and focal mechanism.</strong></p>
<section id="description">
<h2>Description<a class="headerlink" href="#description" title="Permalink to this heading"></a></h2>
<p>As a consequence of a real-time system the <cite>SeisComP</cite> modules creates several
@ -440,6 +440,46 @@ given origin ID.</p></li>
</dl>
</dd></dl>
</section>
<section id="rest-api">
<span id="scevent-restapi"></span><h2>REST API<a class="headerlink" href="#rest-api" title="Permalink to this heading"></a></h2>
<p><strong class="program">scevent</strong> provides a HTTP REST API which may be enabled by defining a
bind address under <a class="reference internal" href="#confval-restAPI"><code class="xref std std-confval docutils literal notranslate"><span class="pre">restAPI</span></code></a>. The following enpoints are available</p>
<section id="try-to-associate">
<span id="scevent-restapi-associate"></span><h3>try-to-associate<a class="headerlink" href="#try-to-associate" title="Permalink to this heading"></a></h3>
<p>Allows to query for possible event associations of origin candidates. An event
ID is returned if a matching event is found. No event is ever created.</p>
<table class="docutils align-default">
<tbody>
<tr class="row-odd"><td><p><strong>Location</strong></p></td>
<td><p><cite>/api/1/try-to-associate</cite></p></td>
</tr>
<tr class="row-even"><td><p><strong>HTTP Methods</strong></p></td>
<td><p>POST</p></td>
</tr>
<tr class="row-odd"><td><p><strong>Request data</strong></p></td>
<td><p><a class="reference internal" href="../base/glossary.html#term-SCML"><span class="xref std std-term">SCML</span></a> containing an <a class="reference internal" href="../base/api-python.html#api-python-datamodel-eventparameters"><span class="std std-ref">EventParameters</span></a> element with one and only one <a class="reference internal" href="../base/api-python.html#api-python-datamodel-origin"><span class="std std-ref">Origin</span></a></p></td>
</tr>
<tr class="row-even"><td><p><strong>Request header</strong></p></td>
<td><p><cite>ContentType: text/xml</cite> (no subtype allowed)</p></td>
</tr>
<tr class="row-odd"><td><p><strong>Response data</strong></p></td>
<td><p>EventID string</p></td>
</tr>
<tr class="row-even"><td><p><strong>Response code</strong></p></td>
<td><p><strong>200</strong> (matching event found), <strong>204</strong> (no matching event found), <strong>400</strong> (invalid input)</p></td>
</tr>
</tbody>
</table>
<p>The following example demonstrates how to query the event id for an origin
defined in <code class="file docutils literal notranslate"><span class="pre">origin.xml</span></code> using the command line programm <strong class="program">curl</strong>.
The request header <cite>Content-Type</cite> must be specified and must have a value of
<cite>text/xml</cite>. No subtype is allowed. It is assumed that <strong class="program">scevent</strong> is
configured with <cite>restAPI = 18182</cite>.</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>curl<span class="w"> </span>-v<span class="w"> </span>-X<span class="w"> </span>POST<span class="w"> </span>http://localhost:18182/api/1/try-to-associate<span class="w"> </span>-H<span class="w"> </span><span class="s2">&quot;Content-Type: text/xml&quot;</span><span class="w"> </span>-d<span class="w"> </span>@origin.xml
</pre></div>
</div>
</section>
</section>
<section id="plugins">
<h2>Plugins<a class="headerlink" href="#plugins" title="Permalink to this heading"></a></h2>
@ -490,12 +530,13 @@ given origin ID.</p></li>
<dt class="sig sig-object std" id="confval-eventIDLookupMargin">
<span class="sig-name descname"><span class="pre">eventIDLookupMargin</span></span><a class="headerlink" href="#confval-eventIDLookupMargin" 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>integer</em></p>
<p>Type: <em>int</em></p>
<p>Configures the number of event ID slots to look back and
forth when an event ID is already taken. The default in
previous versions was 5. Now -1 means that the margin is
determined automatically based on &quot;eventAssociation.eventTimeBefore&quot;
and &quot;eventAssociation.eventTimeAfter&quot;. According to the
determined automatically based on
&quot;eventAssociation.eventTimeBefore&quot; and
&quot;eventAssociation.eventTimeAfter&quot;. According to the
configured &quot;eventIDPattern&quot; a fixed time range per slot
can be computed and with that width the number of look
ahead slots and look back slots can be computed based on
@ -516,8 +557,9 @@ Flinn-Engdahl region name.</p>
<dt class="sig sig-object std" id="confval-restAPI">
<span class="sig-name descname"><span class="pre">restAPI</span></span><a class="headerlink" href="#confval-restAPI" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>Defines the bind adress of the REST API endpoint. This API
allows to query for possible event associations of origin
<p>Defines the bind address of the REST API of form [address:]port.
This API currently provides one endpoint, /api/1/try-to-associate,
which allows to query for possible event associations of origin
candidates.</p>
</dd></dl>
@ -544,8 +586,9 @@ combination with %c. If %C is used, ABCD is matched.</p>
<span class="sig-name descname"><span class="pre">eventAssociation.minimumDefiningPhases</span></span><a class="headerlink" href="#confval-eventAssociation.minimumDefiningPhases" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">10</span></code></p>
<p>Type: <em>int</em></p>
<p>Minimum number of Picks for an Origin that is automatic and cannot be
associated with an Event to be allowed to form an new Event.</p>
<p>Minimum number of Picks for an Origin that is automatic
and cannot be associated with an Event to be allowed to
form an new Event.</p>
</dd></dl>
<dl class="std confval">
@ -577,8 +620,8 @@ from CMT/MT inversions.</p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">1800</span></code></p>
<p>Type: <em>double</em></p>
<p>Unit: <em>s</em></p>
<p>Time range before the Origin time of an incoming Origin to search for
matching events.</p>
<p>Time range before the Origin time of an incoming Origin to
search for matching events.</p>
</dd></dl>
<dl class="std confval">
@ -587,8 +630,8 @@ matching events.</p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">1800</span></code></p>
<p>Type: <em>double</em></p>
<p>Unit: <em>s</em></p>
<p>Time range after the Origin time of an incoming Origin to search for
matching events.</p>
<p>Time range after the Origin time of an incoming Origin to
search for matching events.</p>
</dd></dl>
<dl class="std confval">
@ -596,8 +639,8 @@ matching events.</p>
<span class="sig-name descname"><span class="pre">eventAssociation.minimumMatchingArrivals</span></span><a class="headerlink" href="#confval-eventAssociation.minimumMatchingArrivals" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">3</span></code></p>
<p>Type: <em>int</em></p>
<p>Minimum number of matching picks between two Origins to be associated
to the same event.</p>
<p>Minimum number of matching picks between two Origins to be
associated to the same event.</p>
</dd></dl>
<dl class="std confval">
@ -618,11 +661,11 @@ of the pickID. Pass: |pick1.time - pick2.time| &lt;= threshold</p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">true</span></code></p>
<p>Type: <em>boolean</em></p>
<p>This parameter is only used in conjunction with
eventAssociation.maximumMatchingArrivalTimeDiff.
&quot;eventAssociation.maximumMatchingArrivalTimeDiff&quot;.
If a station has multiple associated arrivals for a
particular event, this flag defines if the time distance
of a new pick to all arrivals must be within
eventAssociation.maximumMatchingArrivalTimeDiff
&quot;eventAssociation.maximumMatchingArrivalTimeDiff&quot;
or if one matching arrival is enough.</p>
</dd></dl>
@ -640,9 +683,9 @@ or if one matching arrival is enough.</p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">60</span></code></p>
<p>Type: <em>double</em></p>
<p>Unit: <em>s</em></p>
<p>Associates an Origin with an existing event if the Origin
time differs not more than 60 seconds unless the
minimumMatchingArrivals criteria matches.</p>
<p>Associates an Origin with an existing event if the Origin
time differs not more than 60 seconds unless
&quot;eventAssociation.minimumMatchingArrivals&quot; matches.</p>
</dd></dl>
<dl class="std confval">
@ -651,8 +694,8 @@ minimumMatchingArrivals criteria matches.</p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">5</span></code></p>
<p>Type: <em>double</em></p>
<p>Unit: <em>degrees</em></p>
<p>Allowed location difference between an incoming Origin compared with
preferred Origins to get associated.</p>
<p>Allowed location difference between an incoming Origin
compared with preferred Origins to get associated.</p>
</dd></dl>
<dl class="std confval">
@ -660,19 +703,25 @@ preferred Origins to get associated.</p>
<span class="sig-name descname"><span class="pre">eventAssociation.magTypes</span></span><a class="headerlink" href="#confval-eventAssociation.magTypes" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">M</span></code></p>
<p>Type: <em>list:string</em></p>
<p>Magnitude type priority list for becoming a preferred magnitude for an
event.</p>
<p>List of magnitude types considered for computing priorities
in order to declare the preferred magnitude of an event.
Magnitudes not listed have a priority of 0 and are ranked
by station count only.</p>
<p>Magnitudes must meet
&quot;eventAssociation.minimumMagnitudes&quot; and
&quot;eventAssociation.minMwCount&quot; unless
&quot;eventAssociation.enableFallbackMagnitude&quot; is true.
If listed, Mw-/Mw()-type magnitudes are preferred over all
others. Next, the magnitude type with the largest station
count wins (default) unless
&quot;eventAssociation.magPriorityOverStationCount&quot; is
true. If the station count is equal, priority is highest
for the magnitude earliest in the list.</p>
<p>If &quot;eventAssociation.magPriorityOverStationCount&quot; is
true, highest priority is first given to magnitude types
earliest in the list before testing the station count.</p>
<p>Example:</p>
<p>M, mBc, Mw(mB), Mwp, ML, MLh, MLv, mb</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-eventAssociation.enableFallbackMagnitude">
<span class="sig-name descname"><span class="pre">eventAssociation.enableFallbackMagnitude</span></span><a class="headerlink" href="#confval-eventAssociation.enableFallbackMagnitude" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">false</span></code></p>
<p>Type: <em>boolean</em></p>
<p>If true, one magnitude will be preferred even if magnitude criteria are
not fullfilled.</p>
<p>M, mBc, Mw(mB), Mwp, ML, MLv, mb</p>
</dd></dl>
<dl class="std confval">
@ -680,8 +729,11 @@ not fullfilled.</p>
<span class="sig-name descname"><span class="pre">eventAssociation.minimumMagnitudes</span></span><a class="headerlink" href="#confval-eventAssociation.minimumMagnitudes" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">4</span></code></p>
<p>Type: <em>int</em></p>
<p>Minimum number of station magnitudes referenced to a network magnitude
to become a preferred magnitude.</p>
<p>Minimum number of station magnitudes required for
considering non-Mw or non-Mw() magnitudes, as
preferred magnitude.</p>
<p>Also consider
&quot;eventAssociation.enableFallbackMagnitude&quot;.</p>
</dd></dl>
<dl class="std confval">
@ -689,8 +741,23 @@ to become a preferred magnitude.</p>
<span class="sig-name descname"><span class="pre">eventAssociation.minMwCount</span></span><a class="headerlink" href="#confval-eventAssociation.minMwCount" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">8</span></code></p>
<p>Type: <em>int</em></p>
<p>Minimum number of station magnitudes required for Mw(mB) to be considered as
preferred magnitude.</p>
<p>Minimum number of station magnitudes required for
considering Mw or any derived moment magnitude, Mw(), as
preferred magnitude. The moment magnitudes must also meet
&quot;eventAssociation.minimumMagnitudes&quot;.</p>
<p>Also consider
&quot;eventAssociation.enableFallbackMagnitude&quot;.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-eventAssociation.enableFallbackMagnitude">
<span class="sig-name descname"><span class="pre">eventAssociation.enableFallbackMagnitude</span></span><a class="headerlink" href="#confval-eventAssociation.enableFallbackMagnitude" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">false</span></code></p>
<p>Type: <em>boolean</em></p>
<p>If true, one magnitude will be preferred even if magnitude
criteria (&quot;eventAssociation.minimumMagnitudes&quot;,
&quot;eventAssociation.minMwCount&quot;) are not fulfilled
by any magnitude.</p>
</dd></dl>
<dl class="std confval">
@ -698,8 +765,8 @@ preferred magnitude.</p>
<span class="sig-name descname"><span class="pre">eventAssociation.mbOverMwCount</span></span><a class="headerlink" href="#confval-eventAssociation.mbOverMwCount" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">30</span></code></p>
<p>Type: <em>int</em></p>
<p>Minimum number of station magnitudes which ensures that Mw(mB) will be
preferred and not mb.</p>
<p>Minimum number of station magnitudes which ensures that
Mw(mB) will be preferred and not mb.</p>
</dd></dl>
<dl class="std confval">
@ -707,8 +774,8 @@ preferred and not mb.</p>
<span class="sig-name descname"><span class="pre">eventAssociation.mbOverMwValue</span></span><a class="headerlink" href="#confval-eventAssociation.mbOverMwValue" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">6</span></code></p>
<p>Type: <em>double</em></p>
<p>Average between mb and Mw(mB) which must be exceeded to become Mw(mB)
preferred.</p>
<p>Average between mb and Mw(mB) which must be exceeded to
become Mw(mB) preferred.</p>
</dd></dl>
<dl class="std confval">
@ -716,10 +783,10 @@ preferred.</p>
<span class="sig-name descname"><span class="pre">eventAssociation.magPriorityOverStationCount</span></span><a class="headerlink" href="#confval-eventAssociation.magPriorityOverStationCount" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">false</span></code></p>
<p>Type: <em>boolean</em></p>
<p>If false then the station count rules out the magnitude priority
<p>If false, then the station count rules out the magnitude priority
which is only taken into account if two magnitudes have the
same station count.</p>
<p>If true then the priority rules out the station count
<p>If true, then the priority rules out the station count
which is only taken into account if two magnitudes have the
same priority.</p>
</dd></dl>
@ -727,74 +794,89 @@ same priority.</p>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-eventAssociation.priorities">
<span class="sig-name descname"><span class="pre">eventAssociation.priorities</span></span><a class="headerlink" href="#confval-eventAssociation.priorities" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">AGENCY,</span> <span class="pre">STATUS,</span> <span class="pre">PHASES_AUTOMATIC,</span> <span class="pre">TIME_AUTOMATIC</span></code></p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">AGENCY,STATUS,PHASES_AUTOMATIC,TIME_AUTOMATIC</span></code></p>
<p>Type: <em>list:string</em></p>
<p>The general priority list to decide if an Origin becomes preferred.
The priority decreases in the order of the parameters.
This list is not used unless this parameter is activated.</p>
<p>Empty priority list: scevent replicates the default hard wired behaviour:
AGENCY, STATUS, PHASES_AUTOMATIC, TIME_AUTOMATIC</p>
<p>Each item in the list corresponds to a check that is performed.
Each check computes a score of the incoming Origin (s1) and the
current preferred Origin (s2). If the s1 is lower than s2,
the incoming Origin is rejected and does not become preferred.
All subsequent checks are ignored.
If s1 is equal to s2, the next check in the list is performed.
If s1 is larger than s2, the Origin becomes preferred and
all subsequent checks are ignored.</p>
<p>Available tokens:</p>
<p>AGENCY: check based on agency priorities</p>
<p>AUTHOR: check based on author priorities</p>
<p>MODE: evaluation mode priority: 0 = unset, 1 = automatic, 2 = manual, manual over-rules automatic</p>
<p>STATUS: priority combined from evaluation status and evaluation mode:
-100 = status is rejected, -1 = status is reported,
0 = status is preliminary or status is unset and mode is automatic,
1 = status is confirmed or status is unset and mode is manual,
2 = status is reviewed, 3 = status is final,</p>
<p>METHOD: check based on the method priorities</p>
<p>PHASES: higher phase count = higher priority</p>
<p>PHASES_AUTOMATIC: only checks phase priorities for incoming automatic Origins</p>
<p>RMS: lower rms = higher priority</p>
<p>RMS_AUTOMATIC: only check RMS on incoming automatic Origins</p>
<p>TIME: more recent Origins (creationTime) have higher priorities</p>
<p>TIME_AUTOMATIC: only check creationTime priority on incoming automatic Origins</p>
<p>SCORE: evaluates the score according to a configured ScoreProcessor and
prefers the Origin/Focalmechanism with the highest score.</p>
<p>Values: <code class="docutils literal notranslate"><span class="pre">'',AGENCY,AUTHOR,MODE,PHASES,PHASES_AUTOMATIC,RMS,RMS_AUTOMATIC,SCORE,STATUS,TIME,TIME_AUTOMATIC</span></code></p>
<p>The general priority list to decide if new Origins become
preferred.</p>
<p>Tokens are processed in the given order. Each token in the
list corresponds to a check that is performed. Each check
computes a score of the incoming Origin (s1) and the
currently preferred Origin (s2). The origin with the higher
score becomes preferred for the event. If s1 equals s2, the
next check in the list is performed. Once a check prefers an
origin, all subsequent checks are ignored.</p>
<p>Available tokens (checks):</p>
<p>* AGENCY: check based on agency priorities</p>
<p>* AUTHOR: check based on author priorities</p>
<p>* MODE: priority from evaluation mode. Priority values are</p>
<p>0 : unset</p>
<p>1 : automatic</p>
<p>2 : manual, manual over-rules automatic</p>
<p>* STATUS: priority combined from evaluation status and
evaluation mode. Priority values are</p>
<p>-100 : status is rejected</p>
<p>-1 : status is reported</p>
<p>0 : status is preliminary or status is unset and mode is automatic</p>
<p>1 : status is confirmed or status is unset and mode is manual</p>
<p>2 : status is reviewed</p>
<p>3 : status is final</p>
<p>* METHOD: priority based on the methods defined in &quot;eventAssociation.methods&quot;</p>
<p>* PHASES: higher phase count = higher priority</p>
<p>* PHASES_AUTOMATIC: only checks phase priorities for incoming
automatic Origins. Higher phase count = higher priority.</p>
<p>* RMS: lower RMS = higher priority.</p>
<p>* RMS_AUTOMATIC: only check RMS on incoming automatic Origins.
Lower RMS = higher priority.</p>
<p>* TIME: more recent Origins (creationTime) have higher priorities.</p>
<p>* TIME_AUTOMATIC: only check creationTime of incoming
automatic Origins. More recent Origins (creationTime) have higher priorities.</p>
<p>* SCORE: priority based on the score according to a configured
ScoreProcessor and prefers the Origin/Focalmechanism with
the highest score.</p>
<p>Empty priority list replicates the hard-wired default
behaviour: AGENCY,STATUS,PHASES_AUTOMATIC,TIME_AUTOMATIC</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-eventAssociation.agencies">
<span class="sig-name descname"><span class="pre">eventAssociation.agencies</span></span><a class="headerlink" href="#confval-eventAssociation.agencies" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>list:string</em></p>
<p>The agencyID priority list. When the eventtool comes to the point to
select a preferred Origin based on AGENCY it orders all Origins by its agency priority and
selects then the best one among the highest priority agency. It also defines the
agency priority for custom priority checks
(eventAssociation.priorities).</p>
<p>The parameter is only considered when defined in &quot;priorities&quot;.</p>
<p>The priority list of agency IDs. When scevent comes to the
point to select a preferred Origin based on AGENCY it orders
all Origins by its agency priority selecting the best one
among the highest priority agency. It also defines the
agency priority for custom priority checks.</p>
<p>The parameter is only considered when AGENCY is used in
&quot;eventAssociation.priorities&quot;.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-eventAssociation.authors">
<span class="sig-name descname"><span class="pre">eventAssociation.authors</span></span><a class="headerlink" href="#confval-eventAssociation.authors" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>list:string</em></p>
<p>The author priority list. When the eventtool comes to the point to
select a preferred Origin based on AUTHOR it orders all Origins by its author priority and
selects then the best one among the highest priority author. It also defines the
author priority for custom priority checks (eventAssociation.priorities).</p>
<p>The parameter is only considered when defined in &quot;priorities&quot;.</p>
<p>The author priority list. When scevent comes to the
point to select a preferred Origin based on AUTHOR it orders
all Origins by its author priority and selects then the best
one among the highest priority author. It also defines the
author priority for custom priority checks.</p>
<p>The parameter is only considered when AUTHOR is used
in &quot;eventAssociation.priorities&quot;.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-eventAssociation.methods">
<span class="sig-name descname"><span class="pre">eventAssociation.methods</span></span><a class="headerlink" href="#confval-eventAssociation.methods" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>list:string</em></p>
<p>The method priority list. When the eventtool comes to the point to
select a preferred Origin based on METHOD it orders all Origins by its methodID priority and
selects then the best one among the highest priority method. It also defines the
method priority for custom priority checks (eventAssociation.priorities).
A defined method string must match exactly the string in Origin.methodID.</p>
<p>The parameter is only considered when defined in &quot;priorities&quot;.</p>
<p>The method priority list. When the scevent comes to the
point to select a preferred Origin based on METHOD it orders
all Origins by its methodID priority and selects then the
best one among the highest priority method. It also defines
the method priority for custom priority checks. A defined
method string must match exactly the string in
Origin.methodID.</p>
<p>The parameter is only considered when METHODS is used
in &quot;eventAssociation.priorities&quot;.</p>
</dd></dl>
<dl class="std confval">
@ -802,8 +884,19 @@ A defined method string must match exactly the string in Origin.methodID.</p>
<span class="sig-name descname"><span class="pre">eventAssociation.score</span></span><a class="headerlink" href="#confval-eventAssociation.score" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>Defines the ScoreProcessor interface to be used along
with priority &quot;SCORE&quot;.</p>
<p>The parameter is only considered when defined in &quot;priorities&quot;.</p>
with priority &quot;SCORE&quot; when defined in
&quot;eventAssociation.priorities&quot;.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-eventAssociation.enablePreferredFMSelection">
<span class="sig-name descname"><span class="pre">eventAssociation.enablePreferredFMSelection</span></span><a class="headerlink" href="#confval-eventAssociation.enablePreferredFMSelection" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">true</span></code></p>
<p>Type: <em>boolean</em></p>
<p>Enables the selection of the preferred focalmechanism. If set
to false then only explicit commands will have effect on the
preferred focalmechanism selection, namely the EvPrefFocMecID
command.</p>
</dd></dl>
<dl class="std confval">
@ -820,26 +913,27 @@ has been fixed.</p>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-eventAssociation.delayTimeSpan">
<span class="sig-name descname"><span class="pre">eventAssociation.delayTimeSpan</span></span><a class="headerlink" href="#confval-eventAssociation.delayTimeSpan" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>int</em></p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">0</span></code></p>
<p>Type: <em>int</em></p>
<p>Unit: <em>s</em></p>
<p>Configures a timespan to delay Event creation. If a new Origin arrives
which cannot be associated to an existing Event, delay the Event creation for a certain
timespan.</p>
<p>The timespan to delay Event creation from new Origins which
cannot be associated to an existing Event.</p>
</dd></dl>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p><strong>eventAssociation.region.*</strong>
<em>Region filter for creating events. Use with care! Origins</em>
<em>outside may be ignored even if they would</em>
<em>become preferred otherwise.</em></p>
<em>outside may be ignored even if they would become preferred</em>
<em>otherwise. Empty value deactivates testing this parameter.</em></p>
</div>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-eventAssociation.region.rect">
<span class="sig-name descname"><span class="pre">eventAssociation.region.rect</span></span><a class="headerlink" href="#confval-eventAssociation.region.rect" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>Region by geographic coordinates.</p>
<p>Format: &quot;South, East, North, West&quot;</p>
<dd><p>Type: <em>list:double</em></p>
<p>Region by geographic coordinates. Empty value
deactivates testing this parameter.</p>
<p>Format: &quot;South,East,North,West&quot;</p>
</dd></dl>
<dl class="std confval">
@ -847,7 +941,8 @@ timespan.</p>
<span class="sig-name descname"><span class="pre">eventAssociation.region.minDepth</span></span><a class="headerlink" href="#confval-eventAssociation.region.minDepth" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>double</em></p>
<p>Unit: <em>km</em></p>
<p>Minimum depth.</p>
<p>Minimum depth. Empty value deactivates testing this
parameter.</p>
</dd></dl>
<dl class="std confval">
@ -855,20 +950,23 @@ timespan.</p>
<span class="sig-name descname"><span class="pre">eventAssociation.region.maxDepth</span></span><a class="headerlink" href="#confval-eventAssociation.region.maxDepth" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>double</em></p>
<p>Unit: <em>km</em></p>
<p>Maximum depth.</p>
<p>Maximum depth. Empty value deactivates testing this
parameter.</p>
</dd></dl>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p><strong>eventAssociation.delayFilter.*</strong>
<em>The delayFilter group configures an Origin filter to activate the delay feature for</em>
<em>this Origin. If more than one filter is given they are combined with AND.</em></p>
<em>Configure an Origin filter to delay Origin for being</em>
<em>processed. If more than one filter is given they are</em>
<em>combined with AND. The application requires</em>
<em>eventAssociation.delayTimeSpan &gt; 0.</em></p>
</div>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-eventAssociation.delayFilter.agencyID">
<span class="sig-name descname"><span class="pre">eventAssociation.delayFilter.agencyID</span></span><a class="headerlink" href="#confval-eventAssociation.delayFilter.agencyID" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>The agencyID of the Origin to be delayed.</p>
<p>The agency ID of the Origin to be delayed.</p>
</dd></dl>
<dl class="std confval">
@ -882,8 +980,8 @@ timespan.</p>
<dt class="sig sig-object std" id="confval-eventAssociation.delayFilter.evaluationMode">
<span class="sig-name descname"><span class="pre">eventAssociation.delayFilter.evaluationMode</span></span><a class="headerlink" href="#confval-eventAssociation.delayFilter.evaluationMode" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>The evaluation mode of the Origin to be delayed. Can be either &quot;manual&quot;
or &quot;automatic&quot;.</p>
<p>Values: <code class="docutils literal notranslate"><span class="pre">automatic,manual</span></code></p>
<p>The evaluation mode of the Origin to be delayed.</p>
</dd></dl>
<section id="eventtype-extension">
@ -1124,7 +1222,7 @@ given as well, this parameter is ignored.</p>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scevent-O">
<span id="cmdoption-scevent-origin-id"></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-id</span></span><span class="sig-prename descclassname"> <span class="pre">publicID</span></span><a class="headerlink" href="#cmdoption-scevent-O" title="Permalink to this definition"></a></dt>
<dd><p>OriginID to be associated. When given no messages are sent.
<dd><p>Origin ID to be associated. When given no messages are sent.
Only the status of the association is written to stdout.</p>
</dd></dl>
@ -1226,7 +1324,8 @@ This option can be given more than once.</p>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scevent-start-stop-msg">
<span class="sig-name descname"><span class="pre">--start-stop-msg</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scevent-start-stop-msg" title="Permalink to this definition"></a></dt>
<dd><p>Set sending of a start and a stop message.</p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">0</span></code></p>
<p>Set sending of a start and a stop message.</p>
</dd></dl>
</section>
@ -1266,6 +1365,52 @@ can be queried with &quot;--db-driver-list&quot;.</p>
<dd><p>Do not use the database at all</p>
</dd></dl>
</section>
<section id="input">
<h3>Input<a class="headerlink" href="#input" title="Permalink to this heading"></a></h3>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scevent-ep">
<span class="sig-name descname"><span class="pre">--ep</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-scevent-ep" title="Permalink to this definition"></a></dt>
<dd><p>Event parameters XML file for offline processing of all
contained origins. Use - to read from stdin.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scevent-reprocess">
<span class="sig-name descname"><span class="pre">--reprocess</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-scevent-reprocess" title="Permalink to this definition"></a></dt>
<dd><p>Reprocess event parameters ignoring all event and journal
objects in input file. Works only in combination with --ep.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scevent-update-event-id">
<span class="sig-name descname"><span class="pre">--update-event-id</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-scevent-update-event-id" title="Permalink to this definition"></a></dt>
<dd><p>Update IDs of events if they already exist. Works only in
combination with --ep.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scevent-clear-cache">
<span class="sig-name descname"><span class="pre">--clear-cache</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-scevent-clear-cache" title="Permalink to this definition"></a></dt>
<dd><p>Send a clear cache message and quit.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scevent-disable-info-log">
<span class="sig-name descname"><span class="pre">--disable-info-log</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-scevent-disable-info-log" title="Permalink to this definition"></a></dt>
<dd><p>Do not populate the scevent-processing-info.log file.</p>
</dd></dl>
</section>
<section id="output">
<h3>Output<a class="headerlink" href="#output" title="Permalink to this heading"></a></h3>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scevent-f">
<span id="cmdoption-scevent-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-scevent-f" title="Permalink to this definition"></a></dt>
<dd><p>Use formatted XML output along with --ep. Otherwise XML
is unformatted.</p>
</dd></dl>
</section>
</section>
</section>
@ -1319,6 +1464,10 @@ can be queried with &quot;--db-driver-list&quot;.</p>
<li><a class="reference internal" href="#EvTypeCertainty"><code class="docutils literal notranslate"><span class="pre">EvTypeCertainty()</span></code></a></li>
</ul>
</li>
<li><a class="reference internal" href="#rest-api">REST API</a><ul>
<li><a class="reference internal" href="#try-to-associate">try-to-associate</a></li>
</ul>
</li>
<li><a class="reference internal" href="#plugins">Plugins</a></li>
<li><a class="reference internal" href="#module-configuration">Module Configuration</a><ul>
<li><a class="reference internal" href="#eventtype-extension">EventType extension</a></li>
@ -1330,6 +1479,8 @@ can be queried with &quot;--db-driver-list&quot;.</p>
<li><a class="reference internal" href="#verbosity">Verbosity</a></li>
<li><a class="reference internal" href="#messaging">Messaging</a></li>
<li><a class="reference internal" href="#database">Database</a></li>
<li><a class="reference internal" href="#input">Input</a></li>
<li><a class="reference internal" href="#output">Output</a></li>
</ul>
</li>
</ul>
@ -1366,7 +1517,7 @@ can be queried with &quot;--db-driver-list&quot;.</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>EventType &#8212; SeisComP Release documentation</title>
<title>EventType &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -212,7 +212,7 @@ given values. An empty list disables setting the type.</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>RegionCheck &#8212; SeisComP Release documentation</title>
<title>RegionCheck &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -166,7 +166,7 @@ or based on the type provided in the polygon files if
<a class="reference internal" href="#confval-rc.readEventTypeFromBNA"><code class="xref std std-confval docutils literal notranslate"><span class="pre">rc.readEventTypeFromBNA</span></code></a> is active.</p>
<section id="type-definition">
<h4>Type definition<a class="headerlink" href="#type-definition" title="Permalink to this heading"></a></h4>
<p>For defining the event type, any value defined in <span id="id1"><em>SeisComP UML diagram</em> [<a class="reference internal" href="../base/references.html#id280" title="SeisComP UML diagram. GEOFON. URL: https://geofon.gfz-potsdam.de/_uml_new/.">23</a>]</span>.
<p>For defining the event type, any value defined in <span id="id1"><em>SeisComP UML diagram</em> [<a class="reference internal" href="../base/references.html#id315" title="SeisComP UML diagram. GEOFON. URL: https://geofon.gfz.de/_uml_new/.">25</a>]</span>.
The list of valid values can also be found in the Event tab of <a class="reference internal" href="scolv.html#scolv"><span class="std std-ref">scolv</span></a>: Type.</p>
<p>Examples for valid event types:</p>
<ul class="simple">
@ -192,7 +192,7 @@ range can be added to the polygons using the key words <em>minDepth</em> and
<em>maxDepth</em>. For considering a polygon, the depth <em>d</em> of the preferred
<a class="reference internal" href="../base/glossary.html#term-origin"><span class="xref std std-term">origin</span></a> of an <a class="reference internal" href="../base/glossary.html#term-event"><span class="xref std std-term">event</span></a> must be within the range</p>
<div class="math">
<p><img src="../_images/math/f2e87dd314fde8db19e6eb5a5f937278f85efe08.png" alt="minDepth \le d \le maxDepth"/></p>
<p><img src="../_images/math/f2e87dd314fde8db19e6eb5a5f937278f85efe08.svg" alt="minDepth \le d \le maxDepth"/></p>
</div><p>The origin depth is only tested if minDepth or maxDepth or both are set and if
<a class="reference internal" href="#confval-rc.readEventTypeFromBNA"><code class="xref std std-confval docutils literal notranslate"><span class="pre">rc.readEventTypeFromBNA</span></code></a> is active.</p>
<div class="admonition warning">
@ -542,7 +542,7 @@ define eventType.</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>scevtlog &#8212; SeisComP Release documentation</title>
<title>scevtlog &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -113,10 +113,10 @@ directory structure and the event files are stored.</p>
<span class="sig-name descname"><span class="pre">format</span></span><a class="headerlink" href="#confval-format" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">xml</span></code></p>
<p>Type: <em>string</em></p>
<p>Specify output event format (default is autoloc3). For completeness
it is recommended to switch to xml as storage format. The autoloc3
format can be easily reconstructed with scbulletin but not the other
way around.</p>
<p>Values: <code class="docutils literal notranslate"><span class="pre">xml,autoloc1,autoloc3</span></code></p>
<p>Event output format. For completeness it is recommended to stick
with the default xml as it can be converted to autoloc1 and
autoloc3 by scbulletin but not the other way around.</p>
</dd></dl>
<dl class="std confval">
@ -296,12 +296,14 @@ This option can be given more than once.</p>
<dt class="sig sig-object std" id="cmdoption-scevtlog-content-type">
<span class="sig-name descname"><span class="pre">--content-type</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scevtlog-content-type" title="Permalink to this definition"></a></dt>
<dd><p>Overrides configuration parameter <a class="reference internal" href="global.html#confval-connection.contentType"><code class="xref std std-confval docutils literal notranslate"><span class="pre">connection.contentType</span></code></a>.</p>
<p>Default: <code class="docutils literal notranslate"><span class="pre">binary</span></code></p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scevtlog-start-stop-msg">
<span class="sig-name descname"><span class="pre">--start-stop-msg</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scevtlog-start-stop-msg" title="Permalink to this definition"></a></dt>
<dd><p>Set sending of a start and a stop message.</p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">0</span></code></p>
<p>Set sending of a start and a stop message.</p>
</dd></dl>
</section>
@ -425,7 +427,7 @@ can be queried with &quot;--db-driver-list&quot;.</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>scevtls &#8212; SeisComP Release documentation</title>
<title>scevtls &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -385,7 +385,7 @@ ID.</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>scevtstreams &#8212; SeisComP Release documentation</title>
<title>scevtstreams &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -74,17 +74,21 @@
<section id="scevtstreams">
<span id="id1"></span><h1>scevtstreams<a class="headerlink" href="#scevtstreams" title="Permalink to this heading"></a></h1>
<p><strong>Extract stream information with time windows from picks of an event.</strong></p>
<p><strong>Extract stream information and time windows from picks of an event or
solitary picks.</strong></p>
<section id="description">
<h2>Description<a class="headerlink" href="#description" title="Permalink to this heading"></a></h2>
<p>scevtstreams reads all picks of an event and determines the time window between
the first pick and the last pick. In addition a symmetric or an asymmetric time
margin is added to this
time window. It writes the streams that are picked including the determined
<p>scevtstreams reads all picks of an event or solitary picks determining the time
window between the first pick and the last pick.
In addition symmetric asymmetric time margins are added to this time window.
It writes the streams that are picked including the determined
time window for the event to stdout. This tool gives appropriate input
information for <a class="reference internal" href="scart.html#scart"><span class="std std-ref">scart</span></a>, <a class="reference internal" href="fdsnws.html#fdsnws"><span class="std std-ref">fdsnws</span></a> and <span id="id2"><em>capstool</em> [<a class="reference internal" href="../base/references.html#id94" title="capstool. gempa plugin. URL: https://docs.gempa.de/caps/current/apps/capstool.html.">27</a>]</span> for
<span id="id3"><em>CAPS</em> [<a class="reference internal" href="../base/references.html#id91" title="CAPS. gempa module. URL: https://docs.gempa.de/caps/current/index.html.">3</a>]</span> server (Common Acquisition Protocol Server by gempa GmbH) to dump
information for <a class="reference internal" href="scart.html#scart"><span class="std std-ref">scart</span></a>, <a class="reference internal" href="fdsnws.html#fdsnws"><span class="std std-ref">fdsnws</span></a> and <span id="id2"><em>capstool</em> [<a class="reference internal" href="../base/references.html#id119" title="capstool. gempa plugin. URL: https://docs.gempa.de/caps/current/apps/capstool.html.">30</a>]</span> for
<span id="id3"><em>CAPS</em> [<a class="reference internal" href="../base/references.html#id116" title="CAPS. gempa module. URL: https://docs.gempa.de/caps/current/index.html.">3</a>]</span> server (Common Acquisition Protocol Server by gempa GmbH) to dump
waveforms from archives based on event data.</p>
<p>Events with origins and picks can be read from database or XML file. Solitary
picks can only be read from XML file. The XML files can be generated using
<a class="reference internal" href="scxmldump.html#scxmldump"><span class="std std-ref">scxmldump</span></a>.</p>
</section>
<section id="output-format">
<h2>Output Format<a class="headerlink" href="#output-format" title="Permalink to this heading"></a></h2>
@ -106,29 +110,39 @@ waveforms from archives based on event data.</p>
</pre></div>
</div>
</li>
<li><p>Get the asymmetric time windows for an event in an XML file. The time window
starts 120 s before the first pick and ends 500 s after the last pick:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>scevtstreams<span class="w"> </span>-E<span class="w"> </span>gfz2012abcd<span class="w"> </span>-i<span class="w"> </span>event.xml<span class="w"> </span>-m<span class="w"> </span><span class="m">120</span>,500
<li><p>Get the time windows for one specific event or all events in a XML file.
The time windows start 120 s before the first pick and ends 500 s after the
last pick:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>scevtstreams<span class="w"> </span>-i<span class="w"> </span>event.xml<span class="w"> </span>-E<span class="w"> </span>gfz2012abcd
scevtstreams<span class="w"> </span>-i<span class="w"> </span>event.xml
</pre></div>
</div>
</li>
<li><p>Create a playback of an event with a time window of 5 minutes data and
sort the records by end time:</p>
<li><p>Get the time windows from all picks in a XML file which does not contain
events or origins:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>scevtstreams<span class="w"> </span>-i<span class="w"> </span>picks.xml
</pre></div>
</div>
</li>
<li><p>Combine with <a class="reference internal" href="scart.html#scart"><span class="std std-ref">scart</span></a> for creating a <a class="reference internal" href="../base/glossary.html#term-miniSeed"><span class="xref std std-term">miniSEED</span></a> data file from one
event. The time window starts and ends 5 minutes before the first and after
the last pick, respectively.
The data is read from <a class="reference internal" href="../base/glossary.html#term-SDS"><span class="xref std std-term">SDS</span></a> archive and sorted by end time:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>scevtstreams<span class="w"> </span>-E<span class="w"> </span>gfz2012abcd<span class="w"> </span>-d<span class="w"> </span>mysql://sysop:sysop@localhost/seiscomp<span class="w"> </span>-m<span class="w"> </span><span class="m">300</span><span class="w"> </span><span class="p">|</span><span class="se">\</span>
scart<span class="w"> </span>-dsvE<span class="w"> </span>--list<span class="w"> </span>-<span class="w"> </span>~/seiscomp/acquisition/archive<span class="w"> </span>&gt;<span class="w"> </span>gfz2012abcd-sorted.mseed
</pre></div>
</div>
</li>
<li><p>Download waveforms from Arclink and import into local archive. Include
<li><p>Download waveforms from FDSN and import into local archive. Include
all stations from the contributing networks:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>scevtstreams<span class="w"> </span>-E<span class="w"> </span>gfz2012abcd<span class="w"> </span>-d<span class="w"> </span>mysql://sysop:sysop@localhost/seiscomp<span class="w"> </span>-m<span class="w"> </span><span class="m">300</span><span class="w"> </span>-R<span class="w"> </span>--all-stations<span class="w"> </span><span class="p">|</span><span class="se">\</span>
scart<span class="w"> </span>--list<span class="w"> </span>-<span class="w"> </span>./my-archive
scart<span class="w"> </span>--list<span class="w"> </span>-<span class="w"> </span>-I<span class="w"> </span>fdsnws://geofon.gfz.de<span class="w"> </span>./my-archive
</pre></div>
</div>
</li>
<li><p>Create lists compatible with <a class="reference internal" href="fdsnws.html#fdsnws"><span class="std std-ref">fdsnws</span></a> or <a class="reference external" href="https://docs.gempa.de/caps/current/apps/capstool.html">caps</a>:</p>
<div class="highlight-rst notranslate"><div class="highlight"><pre><span></span>scevtstreams -E gfz2012abcd -i event.xml -m 120,500 --fdsnws
scevtstreams -E gfz2012abcd -i event.xml -m 120,500 --caps
<li><p>Create lists compatible with <a class="reference internal" href="fdsnws.html#fdsnws"><span class="std std-ref">fdsnws</span></a> POST format or <span id="id4"><em>capstool</em> [<a class="reference internal" href="../base/references.html#id119" title="capstool. gempa plugin. URL: https://docs.gempa.de/caps/current/apps/capstool.html.">30</a>]</span>:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>scevtstreams<span class="w"> </span>-E<span class="w"> </span>gfz2012abcd<span class="w"> </span>-i<span class="w"> </span>event.xml<span class="w"> </span>-m<span class="w"> </span><span class="m">120</span>,500<span class="w"> </span>--fdsnws
scevtstreams<span class="w"> </span>-E<span class="w"> </span>gfz2012abcd<span class="w"> </span>-i<span class="w"> </span>event.xml<span class="w"> </span>-m<span class="w"> </span><span class="m">120</span>,500<span class="w"> </span>--caps
</pre></div>
</div>
</li>
@ -317,8 +331,8 @@ can be queried with &quot;--db-driver-list&quot;.</p>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scevtstreams-i">
<span id="cmdoption-scevtstreams-input"></span><span class="sig-name descname"><span class="pre">-i</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">--input</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scevtstreams-i" title="Permalink to this definition"></a></dt>
<dd><p>Input XML file name. Reads event from the XML file instead of
database. Use - to read from stdin.</p>
<dd><p>Input XML file name. Reads event and picks from the XML file
instead of database. Use - to read from stdin.</p>
</dd></dl>
<dl class="std option">
@ -341,7 +355,7 @@ binary). Only relevant with -i.</p>
<dt class="sig sig-object std" id="cmdoption-scevtstreams-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-scevtstreams-net-sta" title="Permalink to this definition"></a></dt>
<dd><p>Filter read picks by network code or network and station
code. Format: NET or NET.STA</p>
code. Format: NET or NET.STA .</p>
</dd></dl>
<dl class="std option">
@ -494,7 +508,7 @@ by gempa GmbH).</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>scheli &#8212; SeisComP Release documentation</title>
<title>scheli &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -108,8 +108,8 @@ The images can be used, e.g. for showing data images on web sites.</p></li>
</pre></div>
</div>
</li>
<li><p>Let <strong class="program">scheli</strong> show data from the CX station PB01 for the previous 5 hours
overriding configuration by command-line paramaters:</p>
<li><p>Let <strong class="program">scheli</strong> show data from the CX station PB01 for the previous
5 hours overriding configuration by command-line paramaters:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>scheli<span class="w"> </span>--stream<span class="w"> </span>CX.PB01..HHZ<span class="w"> </span>--rows<span class="w"> </span><span class="m">10</span>
</pre></div>
</div>
@ -172,11 +172,12 @@ scheme.colors.records.alternateForeground<span class="w"> </span><span class="o"
<dt class="sig sig-object std" id="confval-heli.streams">
<span class="sig-name descname"><span class="pre">heli.streams</span></span><a class="headerlink" href="#confval-heli.streams" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>list:string</em></p>
<p>List of stream codes to be plotted (net.sta.loc.cha).
If not in capture mode only the first stream is shown.
<p>List of stream codes to be plotted.
If not in capture mode, only the first stream is shown.
When using a list, the first entry is considered.
Use commas for separating streams.</p>
<p>Example: GR.MOX..BHZ</p>
<p>Format: NET.STA.LOC.CHA</p>
<p>Example: GR.CLL..BHZ,GR.MOX..BHZ</p>
</dd></dl>
<dl class="std confval">
@ -267,6 +268,7 @@ settings from scheme.records.antiAliasing</p>
<span class="sig-name descname"><span class="pre">heli.amplitudeRange.scaling</span></span><a class="headerlink" href="#confval-heli.amplitudeRange.scaling" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">minmax</span></code></p>
<p>Type: <em>string</em></p>
<p>Values: <code class="docutils literal notranslate"><span class="pre">minmax,row</span></code></p>
<p>Define the method to scale traces within rows. Possible
values are:</p>
<p>minmax: Scale all rows to configured minimum and maximum
@ -549,12 +551,14 @@ This option can be given more than once.</p>
<dt class="sig sig-object std" id="cmdoption-scheli-content-type">
<span class="sig-name descname"><span class="pre">--content-type</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scheli-content-type" title="Permalink to this definition"></a></dt>
<dd><p>Overrides configuration parameter <a class="reference internal" href="global.html#confval-connection.contentType"><code class="xref std std-confval docutils literal notranslate"><span class="pre">connection.contentType</span></code></a>.</p>
<p>Default: <code class="docutils literal notranslate"><span class="pre">binary</span></code></p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scheli-start-stop-msg">
<span class="sig-name descname"><span class="pre">--start-stop-msg</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scheli-start-stop-msg" title="Permalink to this definition"></a></dt>
<dd><p>Set sending of a start and a stop message.</p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">0</span></code></p>
<p>Set sending of a start and a stop message.</p>
</dd></dl>
</section>
@ -607,12 +611,12 @@ format: [<a class="reference external" href="service://]location">service://]loc
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scheli-I">
<span id="cmdoption-scheli-record-url"></span><span class="sig-name descname"><span class="pre">-I</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">--record-url</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scheli-I" title="Permalink to this definition"></a></dt>
<dd><p>The recordstream source URL, format:
<dd><p>The RecordStream source URL. Format:
[<a class="reference external" href="service://">service://</a>]location[#type].
&quot;service&quot; is the name of the recordstream driver
&quot;service&quot; is the name of the RecordStream driver
which can be queried with &quot;--record-driver-list&quot;.
If &quot;service&quot; is not given, &quot;<a class="reference external" href="file://">file://</a>&quot; is
used.</p>
used and simply the name of a miniSEED file can be given.</p>
</dd></dl>
<dl class="std option">
@ -681,13 +685,15 @@ multiple times for multiple streams.</p>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scheli-gain">
<span class="sig-name descname"><span class="pre">--gain</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scheli-gain" title="Permalink to this definition"></a></dt>
<dd><p>Gain applied to the data before plotting</p>
<dd><p>Unit: <em>counts/unit</em></p>
<p>Gain applied to the data before plotting</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scheli-amp-scaling">
<span class="sig-name descname"><span class="pre">--amp-scaling</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scheli-amp-scaling" title="Permalink to this definition"></a></dt>
<dd><p>Lower bound of amplitude range per row. Possible values:</p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">minmax</span></code></p>
<p>Lower bound of amplitude range per row. Possible values:</p>
<p>minmax: Scale all rows to configured minimum and maximum
amplitudes.</p>
<p>row: Scale each row to the maximum within this row.</p>
@ -735,7 +741,8 @@ amplitudes.</p>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scheli-time-span">
<span class="sig-name descname"><span class="pre">--time-span</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scheli-time-span" title="Permalink to this definition"></a></dt>
<dd><p>Configure the time-span (in secs) per row. Unit: seconds.</p>
<dd><p>Unit: <em>s</em></p>
<p>Configure the time-span (in secs) per row. Unit: seconds.</p>
</dd></dl>
<dl class="std option">
@ -747,19 +754,22 @@ amplitudes.</p>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scheli-xres">
<span class="sig-name descname"><span class="pre">--xres</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scheli-xres" title="Permalink to this definition"></a></dt>
<dd><p>Output x resolution when generating images. Unit: dpi.</p>
<dd><p>Unit: <em>dpi</em></p>
<p>Output x resolution when generating images. Unit: dpi.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scheli-yres">
<span class="sig-name descname"><span class="pre">--yres</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scheli-yres" title="Permalink to this definition"></a></dt>
<dd><p>Output y resolution when generating images. Unit: dpi.</p>
<dd><p>Unit: <em>dpi</em></p>
<p>Output y resolution when generating images. Unit: dpi.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scheli-dpi">
<span class="sig-name descname"><span class="pre">--dpi</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scheli-dpi" title="Permalink to this definition"></a></dt>
<dd><p>Output dpi when generating postscript. Unit:dpi.</p>
<dd><p>Unit: <em>dpi</em></p>
<p>Output dpi when generating postscript. Unit:dpi.</p>
</dd></dl>
<dl class="std option">
@ -772,7 +782,8 @@ code, station code, location code, channel code.</p>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scheli-interval">
<span class="sig-name descname"><span class="pre">--interval</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scheli-interval" title="Permalink to this definition"></a></dt>
<dd><p>Snapshot interval (less than 0 disables timed snapshots).
<dd><p>Unit: <em>s</em></p>
<p>Snapshot interval (less than 0 disables timed snapshots).
Unit: seconds.</p>
</dd></dl>
@ -851,7 +862,7 @@ Unit: seconds.</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>scimex &#8212; SeisComP Release documentation</title>
<title>scimex &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -514,12 +514,14 @@ This option can be given more than once.</p>
<dt class="sig sig-object std" id="cmdoption-scimex-content-type">
<span class="sig-name descname"><span class="pre">--content-type</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scimex-content-type" title="Permalink to this definition"></a></dt>
<dd><p>Overrides configuration parameter <a class="reference internal" href="global.html#confval-connection.contentType"><code class="xref std std-confval docutils literal notranslate"><span class="pre">connection.contentType</span></code></a>.</p>
<p>Default: <code class="docutils literal notranslate"><span class="pre">binary</span></code></p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scimex-start-stop-msg">
<span class="sig-name descname"><span class="pre">--start-stop-msg</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scimex-start-stop-msg" title="Permalink to this definition"></a></dt>
<dd><p>Set sending of a start and a stop message.</p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">0</span></code></p>
<p>Set sending of a start and a stop message.</p>
</dd></dl>
</section>
@ -600,7 +602,7 @@ This option can be given more than once.</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>scimport &#8212; SeisComP Release documentation</title>
<title>scimport &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -587,12 +587,14 @@ This option can be given more than once.</p>
<dt class="sig sig-object std" id="cmdoption-scimport-content-type">
<span class="sig-name descname"><span class="pre">--content-type</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scimport-content-type" title="Permalink to this definition"></a></dt>
<dd><p>Overrides configuration parameter <a class="reference internal" href="global.html#confval-connection.contentType"><code class="xref std std-confval docutils literal notranslate"><span class="pre">connection.contentType</span></code></a>.</p>
<p>Default: <code class="docutils literal notranslate"><span class="pre">binary</span></code></p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scimport-start-stop-msg">
<span class="sig-name descname"><span class="pre">--start-stop-msg</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scimport-start-stop-msg" title="Permalink to this definition"></a></dt>
<dd><p>Set sending of a start and a stop message.</p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">0</span></code></p>
<p>Set sending of a start and a stop message.</p>
</dd></dl>
</section>
@ -705,7 +707,7 @@ routing table will be calculated automatically.</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>scinv &#8212; SeisComP Release documentation</title>
<title>scinv &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -88,7 +88,7 @@ inventory from <code class="file docutils literal notranslate"><span class="pre"
<div class="admonition hint">
<p class="admonition-title">Hint</p>
<p>Inventory files in <a class="reference internal" href="../base/glossary.html#term-SCML"><span class="xref std std-term">SCML</span></a> format may be generated or modified by
<span id="id2"><em>SMP</em> [<a class="reference internal" href="../base/references.html#id268" title="SMP. Station Management Portal by gempa GmbH. URL: https://smp.gempa.de/.">22</a>]</span> or <a class="reference internal" href="invextr.html#invextr"><span class="std std-ref">invextr</span></a>. For conversion from FDSN station XML and
<span id="id2"><em>SMP</em> [<a class="reference internal" href="../base/references.html#id301" title="SMP. Station Management Portal by gempa GmbH. URL: https://smp.gempa.de/.">24</a>]</span> or <a class="reference internal" href="invextr.html#invextr"><span class="std std-ref">invextr</span></a>. For conversion from FDSN station XML and
dataless SEED volume to <a class="reference internal" href="../base/glossary.html#term-SCML"><span class="xref std std-term">SCML</span></a> use <a class="reference internal" href="fdsnxml2inv.html#fdsnxml2inv"><span class="std std-ref">fdsnxml2inv</span></a> and
<a class="reference internal" href="dlsv2inv.html#dlsv2inv"><span class="std std-ref">dlsv2inv</span></a>, respectively.</p>
</div>
@ -141,7 +141,7 @@ specified with <code class="xref std std-option docutils literal notranslate"><s
<p>Merges two or more inventories into one inventory checking the consistency
of the inventory by using <a class="reference internal" href="#scinv-check"><span class="std std-ref">check</span></a>. This command is useful to merge
existing subtrees into a final inventory before synchronization.</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>scinv<span class="w"> </span>merge<span class="w"> </span>net1.xml<span class="w"> </span>net2.xml<span class="w"> </span>-o<span class="w"> </span>inv.xml
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>scinv<span class="w"> </span>merge<span class="w"> </span>network1.xml<span class="w"> </span>network2.xml<span class="w"> </span>-o<span class="w"> </span>inventory.xml
</pre></div>
</div>
<div class="admonition note">
@ -149,6 +149,15 @@ existing subtrees into a final inventory before synchronization.</p>
<p>Merging inventory XML files is also supported by <a class="reference internal" href="scxmlmerge.html#scxmlmerge"><span class="std std-ref">scxmlmerge</span></a> but
without the full <a class="reference internal" href="#scinv-check"><span class="std std-ref">consistency checks</span></a>.</p>
</div>
<p>Along with <code class="xref std std-option docutils literal notranslate"><span class="pre">--strip</span></code>, unreferenced data logger, sensors and responses
are removed resulting in small XML files.</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>scinv<span class="w"> </span>merge<span class="w"> </span>--strip<span class="w"> </span>network1.xml<span class="w"> </span>network2.xml<span class="w"> </span>-o<span class="w"> </span>inventory.xml
</pre></div>
</div>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>Removing such unreferenced objects is also achieved by <a class="reference internal" href="invextr.html#invextr"><span class="std std-ref">invextr</span></a>.</p>
</div>
</section>
<section id="apply">
<span id="scinv-apply"></span><h3>apply<a class="headerlink" href="#apply" title="Permalink to this heading"></a></h3>
@ -275,7 +284,7 @@ results.</p>
<ul class="simple">
<li><p>This test matrix may be incomplete. Consider adding more tests and results.</p></li>
<li><p>Please report inventory issues not caught by tests to the SeisComP
development team, e.g. on <span id="id3"><em>SeisComP on GitHub</em> [<a class="reference internal" href="../base/references.html#id258" title="Seiscomp on github. URL: https://github.com/SeisComP.">1</a>]</span>.</p></li>
development team, e.g. on <span id="id3"><em>SeisComP on GitHub</em> [<a class="reference internal" href="../base/references.html#id291" title="Seiscomp on github. URL: https://github.com/SeisComP.">1</a>]</span>.</p></li>
</ul>
<table class="docutils align-left">
<colgroup>
@ -298,45 +307,55 @@ development team, e.g. on <span id="id3"><em>SeisComP on GitHub</em> [<a class="
<td></td>
</tr>
<tr class="row-odd"><td></td>
<td><p>empty start time</p></td>
<td></td>
<td><p>handled by SeisComP inventory reader: network is ignored</p></td>
</tr>
<tr class="row-even"><td></td>
<td><p>overlapping epochs</p></td>
<td><p>C</p></td>
<td></td>
</tr>
<tr class="row-odd"><td></td>
<td><p>network without station</p></td>
<td><p>W</p></td>
<td></td>
</tr>
<tr class="row-even"><td></td>
<td><p>empty start time</p></td>
<td></td>
<td><p>handled by SeisComP inventory reader: network is ignored</p></td>
</tr>
<tr class="row-odd"><td></td>
<td><p>empty station</p></td>
<td><p>W</p></td>
<td></td>
</tr>
<tr class="row-even"><td></td>
<tr class="row-odd"><td></td>
<td><p>empty code</p></td>
<td><p>W</p></td>
<td></td>
</tr>
<tr class="row-odd"><td></td>
<tr class="row-even"><td></td>
<td></td>
<td></td>
<td></td>
</tr>
<tr class="row-even"><td><p>station</p></td>
<tr class="row-odd"><td><p>station</p></td>
<td><p>start time after end time</p></td>
<td><p>!</p></td>
<td></td>
</tr>
<tr class="row-odd"><td></td>
<tr class="row-even"><td></td>
<td><p>empty or no start time</p></td>
<td><p>W</p></td>
<td><p>station is ignored</p></td>
</tr>
<tr class="row-even"><td></td>
<tr class="row-odd"><td></td>
<td><p>start time after end time</p></td>
<td><p>!</p></td>
<td></td>
</tr>
<tr class="row-even"><td></td>
<td><p>overlapping epochs</p></td>
<td><p>C</p></td>
<td></td>
</tr>
<tr class="row-odd"><td></td>
<td><p>empty code</p></td>
<td><p>W</p></td>
@ -398,55 +417,55 @@ development team, e.g. on <span id="id3"><em>SeisComP on GitHub</em> [<a class="
<td></td>
</tr>
<tr class="row-odd"><td></td>
<td><p>overlapping epochs</p></td>
<td><p>C</p></td>
<td></td>
</tr>
<tr class="row-even"><td></td>
<td><p>empty or no start time</p></td>
<td><p>W</p></td>
<td><p>sensorLocation is ignored</p></td>
</tr>
<tr class="row-even"><td></td>
<tr class="row-odd"><td></td>
<td><p>empty latitude</p></td>
<td><p>W</p></td>
<td></td>
</tr>
<tr class="row-odd"><td></td>
<tr class="row-even"><td></td>
<td><p>empty longitude</p></td>
<td><p>W</p></td>
<td></td>
</tr>
<tr class="row-even"><td></td>
<tr class="row-odd"><td></td>
<td><p>elevation &gt; 8900</p></td>
<td><p>!</p></td>
<td></td>
</tr>
<tr class="row-odd"><td></td>
<tr class="row-even"><td></td>
<td><p>elevation &lt; -12000</p></td>
<td><p>!</p></td>
<td></td>
</tr>
<tr class="row-even"><td></td>
<tr class="row-odd"><td></td>
<td><p>empty or no elevation</p></td>
<td><p>W</p></td>
<td></td>
</tr>
<tr class="row-odd"><td></td>
<tr class="row-even"><td></td>
<td><p>has no channel/stream</p></td>
<td><p>W</p></td>
<td></td>
</tr>
<tr class="row-even"><td></td>
<tr class="row-odd"><td></td>
<td></td>
<td></td>
<td></td>
</tr>
<tr class="row-odd"><td><p>stream</p></td>
<tr class="row-even"><td><p>stream</p></td>
<td><p>empty or no start time</p></td>
<td></td>
<td><p>handled by SeisComP inventory reader: stream is ignored</p></td>
</tr>
<tr class="row-even"><td></td>
<td><p>empty azimuth</p></td>
<td><p>C</p></td>
<td></td>
</tr>
<tr class="row-odd"><td></td>
<td><p>epoch outside sensorLocation</p></td>
<td><p>C</p></td>
@ -468,111 +487,116 @@ development team, e.g. on <span id="id3"><em>SeisComP on GitHub</em> [<a class="
<td></td>
</tr>
<tr class="row-odd"><td></td>
<td><p>overlapping epochs</p></td>
<td><p>C</p></td>
<td></td>
</tr>
<tr class="row-even"><td></td>
<td><p>missing gain value</p></td>
<td><p>W</p></td>
<td><p>empty value is handled by SeisComP inventory reader</p></td>
</tr>
<tr class="row-even"><td></td>
<tr class="row-odd"><td></td>
<td><p>gain value = 0</p></td>
<td><p>W</p></td>
<td></td>
</tr>
<tr class="row-odd"><td></td>
<tr class="row-even"><td></td>
<td><p>gain &lt; 0 and dip &gt; 0</p></td>
<td><p>W</p></td>
<td><p>may result in unexpected behavior, consider positive gain and negative dip</p></td>
</tr>
<tr class="row-even"><td></td>
<tr class="row-odd"><td></td>
<td><p>missing gain unit</p></td>
<td><p>W</p></td>
<td><p>empty value is handled by SeisComP inventory reader</p></td>
</tr>
<tr class="row-odd"><td></td>
<tr class="row-even"><td></td>
<td><p>missing gain frequency</p></td>
<td></td>
<td><p>empty value is handled by SeisComP inventory reader</p></td>
</tr>
<tr class="row-even"><td></td>
<tr class="row-odd"><td></td>
<td><p>missing sampling rate</p></td>
<td></td>
<td><p>empty value is handled by SeisComP inventory reader</p></td>
</tr>
<tr class="row-odd"><td></td>
<tr class="row-even"><td></td>
<td><p>missing depth</p></td>
<td><p>W</p></td>
<td><p>empty value is handled by SeisComP inventory reader</p></td>
</tr>
<tr class="row-even"><td></td>
<tr class="row-odd"><td></td>
<td><p>missing azimuth</p></td>
<td><p>W</p></td>
<td></td>
</tr>
<tr class="row-odd"><td></td>
<tr class="row-even"><td></td>
<td><p>missing dip</p></td>
<td><p>W</p></td>
<td></td>
</tr>
<tr class="row-even"><td></td>
<tr class="row-odd"><td></td>
<td><p>empty azimuth</p></td>
<td></td>
<td><p>handled by SeisComP inventory reader</p></td>
</tr>
<tr class="row-odd"><td></td>
<tr class="row-even"><td></td>
<td><p>empty dip</p></td>
<td></td>
<td><p>handled by SeisComP inventory reader</p></td>
</tr>
<tr class="row-even"><td></td>
<tr class="row-odd"><td></td>
<td><p>large depth</p></td>
<td><p>W</p></td>
<td><p><code class="xref std std-option docutils literal notranslate"><span class="pre">--max-sensor-depth</span></code> and <a class="reference internal" href="#confval-check.maxSensorDepth"><code class="xref std std-confval docutils literal notranslate"><span class="pre">check.maxSensorDepth</span></code></a> override default threshold (500 m)</p></td>
</tr>
<tr class="row-odd"><td></td>
<tr class="row-even"><td></td>
<td><p>empty sensor ID</p></td>
<td><p>I</p></td>
<td></td>
</tr>
<tr class="row-even"><td></td>
<tr class="row-odd"><td></td>
<td><p>sensor is unavailable</p></td>
<td><p>R</p></td>
<td></td>
</tr>
<tr class="row-odd"><td></td>
<tr class="row-even"><td></td>
<td><p>empty data logger ID</p></td>
<td><p>I</p></td>
<td></td>
</tr>
<tr class="row-even"><td></td>
<tr class="row-odd"><td></td>
<td><p>data logger is unavailable</p></td>
<td><p>R</p></td>
<td></td>
</tr>
<tr class="row-odd"><td></td>
<tr class="row-even"><td></td>
<td><p>2 or more than 3 streams exist</p></td>
<td><p>I</p></td>
<td></td>
</tr>
<tr class="row-even"><td></td>
<tr class="row-odd"><td></td>
<td><p>3C streams are not orthogonal</p></td>
<td><p>W</p></td>
<td><p>differences &lt;= 5 degree are tolerated, applies to seismic sensors with codes G, H, L, N</p></td>
</tr>
<tr class="row-odd"><td></td>
<tr class="row-even"><td></td>
<td></td>
<td></td>
<td></td>
</tr>
<tr class="row-even"><td><p>sensor</p></td>
<tr class="row-odd"><td><p>sensor</p></td>
<td><p>referenced response not available</p></td>
<td><p>R</p></td>
<td></td>
</tr>
<tr class="row-odd"><td></td>
<tr class="row-even"><td></td>
<td></td>
<td></td>
<td></td>
</tr>
<tr class="row-even"><td><p>data logger</p></td>
<tr class="row-odd"><td><p>data logger</p></td>
<td><p>referenced response not available</p></td>
<td><p>R</p></td>
<td></td>
@ -827,12 +851,14 @@ This option can be given more than once.</p>
<dt class="sig sig-object std" id="cmdoption-scinv-content-type">
<span class="sig-name descname"><span class="pre">--content-type</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scinv-content-type" title="Permalink to this definition"></a></dt>
<dd><p>Overrides configuration parameter <a class="reference internal" href="global.html#confval-connection.contentType"><code class="xref std std-confval docutils literal notranslate"><span class="pre">connection.contentType</span></code></a>.</p>
<p>Default: <code class="docutils literal notranslate"><span class="pre">binary</span></code></p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scinv-start-stop-msg">
<span class="sig-name descname"><span class="pre">--start-stop-msg</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scinv-start-stop-msg" title="Permalink to this definition"></a></dt>
<dd><p>Set sending of a start and a stop message.</p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">0</span></code></p>
<p>Set sending of a start and a stop message.</p>
</dd></dl>
</section>
@ -1086,7 +1112,7 @@ operations and conflicts.</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>scm &#8212; SeisComP Release documentation</title>
<title>scm &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -469,12 +469,14 @@ This option can be given more than once.</p>
<dt class="sig sig-object std" id="cmdoption-scm-content-type">
<span class="sig-name descname"><span class="pre">--content-type</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scm-content-type" title="Permalink to this definition"></a></dt>
<dd><p>Overrides configuration parameter <a class="reference internal" href="global.html#confval-connection.contentType"><code class="xref std std-confval docutils literal notranslate"><span class="pre">connection.contentType</span></code></a>.</p>
<p>Default: <code class="docutils literal notranslate"><span class="pre">binary</span></code></p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scm-start-stop-msg">
<span class="sig-name descname"><span class="pre">--start-stop-msg</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scm-start-stop-msg" title="Permalink to this definition"></a></dt>
<dd><p>Set sending of a start and a stop message.</p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">0</span></code></p>
<p>Set sending of a start and a stop message.</p>
</dd></dl>
</section>
@ -578,7 +580,7 @@ build filter configurations.</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>email &#8212; SeisComP Release documentation</title>
<title>email &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -253,7 +253,7 @@ and logical and numerical operators. See scm for more information.</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>ncurses &#8212; SeisComP Release documentation</title>
<title>ncurses &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,12 +12,12 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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="Filter Grammar" href="../base/filter-grammar.html" />
<link rel="next" title="Time Formats" href="../base/time-grammar.html" />
<link rel="prev" title="text" href="scm_text.html" />
</head>
<body>
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -43,7 +43,7 @@
</a>
</li>
<li class="right">
<a href="../base/filter-grammar.html" title="Filter Grammar"
<a href="../base/time-grammar.html" title="Time Formats"
accesskey="N">
next
</a>
@ -142,8 +142,8 @@ client update (resp).</p>
</div>
<div>
<h4>Next topic</h4>
<p class="topless"><a href="../base/filter-grammar.html"
title="next chapter">Filter Grammar</a></p>
<p class="topless"><a href="../base/time-grammar.html"
title="next chapter">Time Formats</a></p>
</div>
<div role="note" aria-label="source link">
<h3>This Page</h3>
@ -164,7 +164,7 @@ client update (resp).</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>text &#8212; SeisComP Release documentation</title>
<title>text &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -162,7 +162,7 @@ tags used in the client status file.</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>scmag &#8212; SeisComP Release documentation</title>
<title>scmag &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -104,15 +104,15 @@ Currently the following primary magnitude types are implemented.</p>
<section id="local-distances">
<h3>Local distances<a class="headerlink" href="#local-distances" title="Permalink to this heading"></a></h3>
<dl class="simple">
<dt><a class="reference internal" href="../base/glossary.html#term-magnitude-duration-Md"><span class="xref std std-term">Md</span></a></dt><dd><p>Duration magnitude as described in HYPOINVERSE (<span id="id2">Klein [<a class="reference internal" href="../base/references.html#id47" title="F.W. Klein. Users guide to HYPOINVERSE-2000, a Fortran program to solve for earthquake locations and magnitudes. US Geological Survey, 2002-171:, 2002. URL: https://www.usgs.gov/node/279394, doi:10.3133/ofr02171.">50</a>]</span>).</p>
<dt><a class="reference internal" href="../base/glossary.html#term-magnitude-duration-Md"><span class="xref std std-term">Md</span></a></dt><dd><p>Duration magnitude as described in HYPOINVERSE (<span id="id2">Klein [<a class="reference internal" href="../base/references.html#id63" title="F.W. Klein. Users guide to HYPOINVERSE-2000, a Fortran program to solve for earthquake locations and magnitudes. US Geological Survey, 2002-171:, 2002. URL: https://www.usgs.gov/node/279394, doi:10.3133/ofr02171.">58</a>]</span>).</p>
</dd>
<dt><a class="reference internal" href="../base/glossary.html#term-magnitude-JMA-M_JMA"><span class="xref std std-term">Mjma</span></a></dt><dd><p>Mjma is computed on displacement data using body waves of period &lt; 30s.</p>
</dd>
<dt><a class="reference internal" href="../base/glossary.html#term-magnitude-local-ML"><span class="xref std std-term">ML</span></a></dt><dd><p>Local (Richter) magnitude calculated on the horizontal components using a
correction term to fit with the standard ML (<span id="id3">Richter [<a class="reference internal" href="../base/references.html#id62" title="C.F. Richter. An instrumental earthquake magnitude scale. Bull. Seismol. Soc. Am., 1:1 - 32, 1935. URL: https://resolver.caltech.edu/CaltechAUTHORS:20140804-143558638, doi:10.1785/BSSA0250010001.">57</a>]</span>).</p>
correction term to fit with the standard ML (<span id="id3">Richter [<a class="reference internal" href="../base/references.html#id81" title="C.F. Richter. An instrumental earthquake magnitude scale. Bull. Seismol. Soc. Am., 1:1 - 32, 1935. URL: https://resolver.caltech.edu/CaltechAUTHORS:20140804-143558638, doi:10.1785/BSSA0250010001.">66</a>]</span>).</p>
</dd>
<dt><a class="reference internal" href="../base/glossary.html#term-magnitude-local-custom-MLc"><span class="xref std std-term">MLc</span></a></dt><dd><p>Local custom magnitude calculated on the horizontal components according to
Hessian Earthquake Service and <span id="id4">Stange [<a class="reference internal" href="../base/references.html#id78" title="S. Stange. ML determination for local and regional events using a sparse network in Southwestern Germany. J. Seismol., 10:247 257, 2006. doi:10.1007/s10950-006-9010-6.">62</a>]</span></p>
Hessian Earthquake Service and <span id="id4">Stange [<a class="reference internal" href="../base/references.html#id100" title="S. Stange. ML determination for local and regional events using a sparse network in Southwestern Germany. J. Seismol., 10:247 257, 2006. doi:10.1007/s10950-006-9010-6.">71</a>]</span></p>
</dd>
<dt><a class="reference internal" href="../base/glossary.html#term-magnitude-local-horizontal-MLh"><span class="xref std std-term">MLh</span></a></dt><dd><p>Local magnitude calculated on the horizontal components according to SED
specifications.</p>
@ -121,9 +121,9 @@ specifications.</p>
to fit with the standard ML.</p>
</dd>
<dt><a class="reference internal" href="../base/glossary.html#term-magnitude-local-GNS-GEONET-MLr"><span class="xref std std-term">MLr</span></a></dt><dd><p>Local magnitude calculated from MLv amplitudes based on GNS/GEONET specifications
for New Zealand (<span id="id5">Ristau <em>et al.</em> [<a class="reference internal" href="../base/references.html#id64" title="J. Ristau, D. Harte, and J. Salichon. A Revised Local Magnitude (ML) Scale for New Zealand Earthquakes. Bull. Seismol. Soc. Am., 106(2):, 2016. doi:10.1785/0120150293.">58</a>]</span>).</p>
for New Zealand (<span id="id5">Ristau <em>et al.</em> [<a class="reference internal" href="../base/references.html#id85" title="J. Ristau, D. Harte, and J. Salichon. A Revised Local Magnitude (ML) Scale for New Zealand Earthquakes. Bull. Seismol. Soc. Am., 106(2):, 2016. doi:10.1785/0120150293.">67</a>]</span>).</p>
</dd>
<dt><a class="reference internal" href="../base/glossary.html#term-magnitude-Nuttli-MN"><span class="xref std std-term">MN</span></a></dt><dd><p>Nuttli magnitude for Canada and other Cratonic regions (<span id="id6">Nuttli [<a class="reference internal" href="../base/references.html#id58" title="O.W. Nuttli. Seismic wave attenuation and magnitude relations for eastern north america. J. Geophys. Res., 5:876 - 885, 1973. doi:10.1029/JB078i005p00876.">53</a>]</span>).</p>
<dt><a class="reference internal" href="../base/glossary.html#term-magnitude-Nuttli-MN"><span class="xref std std-term">MN</span></a></dt><dd><p>Nuttli magnitude for Canada and other Cratonic regions (<span id="id6">Nuttli [<a class="reference internal" href="../base/references.html#id76" title="O.W. Nuttli. Seismic wave attenuation and magnitude relations for eastern north america. J. Geophys. Res., 5:876 - 885, 1973. doi:10.1029/JB078i005p00876.">62</a>]</span>).</p>
</dd>
</dl>
</section>
@ -134,9 +134,9 @@ for New Zealand (<span id="id5">Ristau <em>et al.</em> [<a class="reference inte
</dd>
<dt><a class="reference internal" href="../base/glossary.html#term-magnitude-cumulative-body-wave-mBc"><span class="xref std std-term">mBc</span></a></dt><dd><p>Cumulative body wave magnitude</p>
</dd>
<dt><a class="reference internal" href="../base/glossary.html#term-magnitude-broadband-body-wave-mB"><span class="xref std std-term">mB</span></a></dt><dd><p>Broad band body wave magnitude after <span id="id7">Bormann and Saul [<a class="reference internal" href="../base/references.html#id18" title="P. Bormann and J. Saul. The new iaspei standard broadband magnitude mb. Seismol. Res. Lett., 5:698 - 705, 2008. doi:10.1785/gssrl.79.5.698.">38</a>]</span></p>
<dt><a class="reference internal" href="../base/glossary.html#term-magnitude-broadband-body-wave-mB"><span class="xref std std-term">mB</span></a></dt><dd><p>Broad band body wave magnitude after <span id="id7">Bormann and Saul [<a class="reference internal" href="../base/references.html#id28" title="P. Bormann and J. Saul. The new iaspei standard broadband magnitude mb. Seismol. Res. Lett., 5:698 - 705, 2008. doi:10.1785/gssrl.79.5.698.">46</a>]</span></p>
</dd>
<dt><a class="reference internal" href="../base/glossary.html#term-magnitude-broadband-P-wave-moment-Mwp"><span class="xref std std-term">Mwp</span></a></dt><dd><p>The body wave magnitude of <span id="id8">Tsuboi <em>et al.</em> [<a class="reference internal" href="../base/references.html#id79" title="S. Tsuboi, K. Abe, K. Takano, and Y. Yamanaka. Rapid determination of Mw from broadband P waveforms. Bull. Seismol. Soc. Am., 1995. doi:10.1785/BSSA0850020606.">63</a>]</span></p>
<dt><a class="reference internal" href="../base/glossary.html#term-magnitude-broadband-P-wave-moment-Mwp"><span class="xref std std-term">Mwp</span></a></dt><dd><p>The body wave magnitude of <span id="id8">Tsuboi <em>et al.</em> [<a class="reference internal" href="../base/references.html#id101" title="S. Tsuboi, K. Abe, K. Takano, and Y. Yamanaka. Rapid determination of Mw from broadband P waveforms. Bull. Seismol. Soc. Am., 1995. doi:10.1785/BSSA0850020606.">72</a>]</span></p>
</dd>
<dt><a class="reference internal" href="../base/glossary.html#term-magnitude-surface-wave-Ms_20"><span class="xref std std-term">Ms_20</span></a></dt><dd><p>Surface-wave magnitude at 20 s period</p>
</dd>
@ -149,10 +149,10 @@ for New Zealand (<span id="id5">Ristau <em>et al.</em> [<a class="reference inte
<p>Additionally, scmag derives the following magnitudes from primary magnitudes:</p>
<dl>
<dt><a class="reference internal" href="../base/glossary.html#term-magnitude-derived-mB-Mw-mB"><span class="xref std std-term">Mw(mB)</span></a></dt><dd><p>Estimation of the moment magnitude Mw based on mB using the Mw vs. mB
regression of <span id="id9">Bormann and Saul [<a class="reference internal" href="../base/references.html#id18" title="P. Bormann and J. Saul. The new iaspei standard broadband magnitude mb. Seismol. Res. Lett., 5:698 - 705, 2008. doi:10.1785/gssrl.79.5.698.">38</a>]</span></p>
regression of <span id="id9">Bormann and Saul [<a class="reference internal" href="../base/references.html#id28" title="P. Bormann and J. Saul. The new iaspei standard broadband magnitude mb. Seismol. Res. Lett., 5:698 - 705, 2008. doi:10.1785/gssrl.79.5.698.">46</a>]</span></p>
</dd>
<dt><a class="reference internal" href="../base/glossary.html#term-magnitude-derived-Mwp-Mw-Mwp"><span class="xref std std-term">Mw(Mwp)</span></a></dt><dd><p>Estimation of the moment magnitude Mw based on Mwp using the Mw vs. Mwp
regression of <span id="id10">Whitmore <em>et al.</em> [<a class="reference internal" href="../base/references.html#id85" title="P.M. Whitmore, S. Tsuboi, B. Hirshorn, and T.J. Sokolowski. Magnitude dependent correction for Mwp. Science of Tsunami Hazards, 20(4):, 2002.">65</a>]</span></p>
regression of <span id="id10">Whitmore <em>et al.</em> [<a class="reference internal" href="../base/references.html#id108" title="P.M. Whitmore, S. Tsuboi, B. Hirshorn, and T.J. Sokolowski. Magnitude dependent correction for Mwp. Science of Tsunami Hazards, 20(4):, 2002.">74</a>]</span></p>
</dd>
<dt><a class="reference internal" href="../base/glossary.html#term-magnitude-summary-M"><span class="xref std std-term">M</span></a></dt><dd><p>Summary magnitude, which consists of a weighted average of the individual
magnitudes and attempts to be a best possible compromise between all magnitudes.
@ -257,7 +257,7 @@ This magnitude is typically called <strong>M</strong> as configured in
<a class="reference internal" href="#confval-summaryMagnitude.type"><code class="xref std std-confval docutils literal notranslate"><span class="pre">summaryMagnitude.type</span></code></a>.</p>
<p>It is computed as a weighted average over the available magnitudes:</p>
<div class="math">
<p><img src="../_images/math/9af9964f1e826eea97592ba3eb00a1c8b0e42b05.png" alt="M &amp;= \frac{\sum w_{i} * M_{i}}{\sum w_i} \\
<p><img src="../_images/math/9af9964f1e826eea97592ba3eb00a1c8b0e42b05.svg" alt="M &amp;= \frac{\sum w_{i} * M_{i}}{\sum w_i} \\
w_{i} &amp;= a_i * stationCount(M_{i}) + b_i"/></p>
</div><p>The coefficients a and b can be configured per magnitude type by
<a class="reference internal" href="#confval-summaryMagnitude.coefficients.a"><code class="xref std std-confval docutils literal notranslate"><span class="pre">summaryMagnitude.coefficients.a</span></code></a>
@ -319,15 +319,15 @@ to be used for calculating a magnitude.</p>
<span class="sig-name descname"><span class="pre">magnitudes.average</span></span><a class="headerlink" href="#confval-magnitudes.average" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">default</span></code></p>
<p>Type: <em>list:string</em></p>
<p>The methods for computing the network magnitude
from station magnitudes. Exactly one method per
magnitude can be configured.
To define the averaging method per magnitude type append
the type after colon, e.g.:
&quot;magnitudes.average = default, MLv:median&quot;</p>
<p>default: Compute the mean if less than 4 contributed
station magnitudes exist. Otherwise apply trimmedMean(25),
trimmed mean with 25%.</p>
<p>Values: <code class="docutils literal notranslate"><span class="pre">*default,*mean,*median,*trimmedMean(*),*trimmedMedian(*),*medianTrimmedMean(*)</span></code></p>
<p>The methods for computing the network magnitude from station
magnitudes. Exactly one method per magnitude can be
configured. To define the averaging method per magnitude
type append the type after colon. Example:</p>
<p>&quot;magnitudes.average = default, MLv:median&quot;</p>
<p>default: Compute the mean if less than 4 contributed station
magnitudes exist. Otherwise apply trimmedMean(25), trimmed
mean with 25%.</p>
</dd></dl>
<dl class="std confval">
@ -415,7 +415,7 @@ magnitude calculation.</p>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-summaryMagnitude.coefficients.a">
<span class="sig-name descname"><span class="pre">summaryMagnitude.coefficients.a</span></span><a class="headerlink" href="#confval-summaryMagnitude.coefficients.a" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">0,</span> <span class="pre">Mw(mB):0.4,</span> <span class="pre">Mw(Mwp):0.4</span></code></p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">0,Mw(mB):0.4,Mw(Mwp):0.4</span></code></p>
<p>Type: <em>list:string</em></p>
<p>Define the coefficients a. To define the value per magnitude
type append the type after colon. A value without a
@ -425,7 +425,7 @@ type defines the default value.</p>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-summaryMagnitude.coefficients.b">
<span class="sig-name descname"><span class="pre">summaryMagnitude.coefficients.b</span></span><a class="headerlink" href="#confval-summaryMagnitude.coefficients.b" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">1,</span> <span class="pre">MLv:2,</span> <span class="pre">Mw(mB):-1,</span> <span class="pre">Mw(Mwp):-1</span></code></p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">1,MLv:2,</span> <span class="pre">Mw(mB):-1,Mw(Mwp):-1</span></code></p>
<p>Type: <em>list:string</em></p>
<p>Define the coefficients b. To define the value per magnitude
type append the type after colon. A value without a
@ -604,12 +604,14 @@ This option can be given more than once.</p>
<dt class="sig sig-object std" id="cmdoption-scmag-content-type">
<span class="sig-name descname"><span class="pre">--content-type</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scmag-content-type" title="Permalink to this definition"></a></dt>
<dd><p>Overrides configuration parameter <a class="reference internal" href="global.html#confval-connection.contentType"><code class="xref std std-confval docutils literal notranslate"><span class="pre">connection.contentType</span></code></a>.</p>
<p>Default: <code class="docutils literal notranslate"><span class="pre">binary</span></code></p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scmag-start-stop-msg">
<span class="sig-name descname"><span class="pre">--start-stop-msg</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scmag-start-stop-msg" title="Permalink to this definition"></a></dt>
<dd><p>Set sending of a start and a stop message.</p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">0</span></code></p>
<p>Set sending of a start and a stop message.</p>
</dd></dl>
</section>
@ -655,7 +657,9 @@ can be queried with &quot;--db-driver-list&quot;.</p>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scmag-ep">
<span class="sig-name descname"><span class="pre">--ep</span></span><span class="sig-prename descclassname"> <span class="pre">file</span></span><a class="headerlink" href="#cmdoption-scmag-ep" title="Permalink to this definition"></a></dt>
<dd><p>Defines an event parameters XML file to be read and processed. This
<dd><p>Type: <em>string</em></p>
<p>Defines an event parameters XML file to be read and
processed. Use - to read from stdin. This
implies offline mode and only processes all origins contained
in that file. It computes station magnitudes for all picks associated
with an origin where amplitudes are available and the corresponding
@ -699,6 +703,16 @@ network magnitude.</p>
<dd><p>Keep the original weights in combination with --static.</p>
</dd></dl>
</section>
<section id="output">
<h3>Output<a class="headerlink" href="#output" title="Permalink to this heading"></a></h3>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scmag-f">
<span id="cmdoption-scmag-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-scmag-f" title="Permalink to this definition"></a></dt>
<dd><p>Use formatted XML output along with --ep. Otherwise XML
is unformatted.</p>
</dd></dl>
</section>
</section>
</section>
@ -747,6 +761,7 @@ network magnitude.</p>
<li><a class="reference internal" href="#database">Database</a></li>
<li><a class="reference internal" href="#input">Input</a></li>
<li><a class="reference internal" href="#reprocess">Reprocess</a></li>
<li><a class="reference internal" href="#output">Output</a></li>
</ul>
</li>
</ul>
@ -783,7 +798,7 @@ network magnitude.</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>scmapcut &#8212; SeisComP Release documentation</title>
<title>scmapcut &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,12 +12,12 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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="scmssort" href="scmssort.html" />
<link rel="next" title="scmsdemux" href="scmsdemux.html" />
<link rel="prev" title="scm" href="scm.html" />
</head>
<body>
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -43,7 +43,7 @@
</a>
</li>
<li class="right">
<a href="scmssort.html" title="scmssort"
<a href="scmsdemux.html" title="scmsdemux"
accesskey="N">
next
</a>
@ -258,7 +258,8 @@ Equivalent to --verbosity=4 --console=1 .</p>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scmapcut-city-xml">
<span class="sig-name descname"><span class="pre">--city-xml</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scmapcut-city-xml" title="Permalink to this definition"></a></dt>
<dd><p>Path to the cities.xml file. If undefined, the data is
<dd><p>Type: <em>string</em></p>
<p>Path to the cities.xml file. If undefined, the data is
read from CONFIGDIR&#64;/cities.xml or &#64;DATADIR&#64;/cities.xml.</p>
</dd></dl>
@ -268,43 +269,54 @@ read from CONFIGDIR&#64;/cities.xml or &#64;DATADIR&#64;/cities.xml.</p>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scmapcut-r">
<span id="cmdoption-scmapcut-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-scmapcut-r" title="Permalink to this definition"></a></dt>
<dd><p>Cut region ([lat_dim]x[lon_dim]+lat0+lon0 or +lat0+lon+lat1+lon1).</p>
<dd><p>Unit: <em>degree</em></p>
<p>Type: <em>string</em></p>
<p>Cut region ([lat_dim]x[lon_dim]+lat0+lon0 or +lat0+lon+lat1+lon1).</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scmapcut-m">
<span id="cmdoption-scmapcut-margin"></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">--margin</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scmapcut-m" title="Permalink to this definition"></a></dt>
<dd><p>Margin in degrees around origin (margin|margin_latxmargin_lon).</p>
<dd><p>Unit: <em>degree</em></p>
<p>Type: <em>string</em></p>
<p>Margin in degrees around origin (margin|margin_latxmargin_lon).</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scmapcut-d">
<span id="cmdoption-scmapcut-dimension"></span><span class="sig-name descname"><span class="pre">-d</span></span><span class="sig-prename descclassname"></span><span class="sig-prename descclassname"><span class="pre">,</span> </span><span class="sig-name descname"><span class="pre">--dimension</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scmapcut-d" title="Permalink to this definition"></a></dt>
<dd><p>Output image dimension (wxh).</p>
<dd><p>Unit: <em>px</em></p>
<p>Type: <em>string</em></p>
<p>Output image dimension (wxh).</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scmapcut-o">
<span id="cmdoption-scmapcut-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-scmapcut-o" title="Permalink to this definition"></a></dt>
<dd><p>Output image, file name.</p>
<dd><p>Type: <em>string</em></p>
<p>Output image, file name.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scmapcut-lat">
<span class="sig-name descname"><span class="pre">--lat</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scmapcut-lat" title="Permalink to this definition"></a></dt>
<dd><p>Latitude of symbol.</p>
<dd><p>Unit: <em>degree</em></p>
<p>Type: <em>float</em></p>
<p>Latitude of symbol.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scmapcut-long">
<span class="sig-name descname"><span class="pre">--long</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scmapcut-long" title="Permalink to this definition"></a></dt>
<dd><p>Longitude of symbol.</p>
<dd><p>Unit: <em>degree</em></p>
<p>Longitude of symbol.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scmapcut-depth">
<span class="sig-name descname"><span class="pre">--depth</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scmapcut-depth" title="Permalink to this definition"></a></dt>
<dd><p>Depth of event.</p>
<dd><p>Unit: <em>km</em></p>
<p>Depth of event.</p>
</dd></dl>
<dl class="std option">
@ -390,8 +402,8 @@ read from CONFIGDIR&#64;/cities.xml or &#64;DATADIR&#64;/cities.xml.</p>
</div>
<div>
<h4>Next topic</h4>
<p class="topless"><a href="scmssort.html"
title="next chapter">scmssort</a></p>
<p class="topless"><a href="scmsdemux.html"
title="next chapter">scmsdemux</a></p>
</div>
<div role="note" aria-label="source link">
<h3>This Page</h3>
@ -412,7 +424,7 @@ read from CONFIGDIR&#64;/cities.xml or &#64;DATADIR&#64;/cities.xml.</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>scmaster &#8212; SeisComP Release documentation</title>
<title>scmaster &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -439,6 +439,18 @@ exactly what are you doing and what the
consequences are.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-queues.-name.processors.messages.dbstore.deleteTree">
<span class="sig-name descname"><span class="pre">queues.$name.processors.messages.dbstore.deleteTree</span></span><a class="headerlink" href="#confval-queues.-name.processors.messages.dbstore.deleteTree" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">true</span></code></p>
<p>Type: <em>boolean</em></p>
<p>Enables removing the entire object tree from
the database if a parent object is being deleted.
This will also decrease the numbers of notifiers
sent to scmaster. Depending on the database
backend, it can improve the performance.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-http.filebase">
<span class="sig-name descname"><span class="pre">http.filebase</span></span><a class="headerlink" href="#confval-http.filebase" title="Permalink to this definition"></a></dt>
@ -675,7 +687,7 @@ Equivalent to --verbosity=4 --console=1 --print-component=1
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>scmm &#8212; SeisComP Release documentation</title>
<title>scmm &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -294,12 +294,14 @@ This option can be given more than once.</p>
<dt class="sig sig-object std" id="cmdoption-scmm-content-type">
<span class="sig-name descname"><span class="pre">--content-type</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scmm-content-type" title="Permalink to this definition"></a></dt>
<dd><p>Overrides configuration parameter <a class="reference internal" href="global.html#confval-connection.contentType"><code class="xref std std-confval docutils literal notranslate"><span class="pre">connection.contentType</span></code></a>.</p>
<p>Default: <code class="docutils literal notranslate"><span class="pre">binary</span></code></p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scmm-start-stop-msg">
<span class="sig-name descname"><span class="pre">--start-stop-msg</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scmm-start-stop-msg" title="Permalink to this definition"></a></dt>
<dd><p>Set sending of a start and a stop message.</p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">0</span></code></p>
<p>Set sending of a start and a stop message.</p>
</dd></dl>
</section>
@ -351,12 +353,12 @@ can be queried with &quot;--db-driver-list&quot;.</p>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scmm-I">
<span id="cmdoption-scmm-record-url"></span><span class="sig-name descname"><span class="pre">-I</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">--record-url</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scmm-I" title="Permalink to this definition"></a></dt>
<dd><p>The recordstream source URL, format:
<dd><p>The RecordStream source URL. Format:
[<a class="reference external" href="service://">service://</a>]location[#type].
&quot;service&quot; is the name of the recordstream driver
&quot;service&quot; is the name of the RecordStream driver
which can be queried with &quot;--record-driver-list&quot;.
If &quot;service&quot; is not given, &quot;<a class="reference external" href="file://">file://</a>&quot; is
used.</p>
used and simply the name of a miniSEED file can be given.</p>
</dd></dl>
<dl class="std option">
@ -456,7 +458,7 @@ used.</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>inv2dlsv &#8212; SeisComP Release documentation</title>
<title>scmsdemux &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,21 +12,21 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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="invextr" href="invextr.html" />
<link rel="prev" title="import_inv" href="import_inv.html" />
<link rel="next" title="scmssort" href="scmssort.html" />
<link rel="prev" title="scmapcut" href="scmapcut.html" />
</head>
<body>
<div class="header">
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -43,13 +43,13 @@
</a>
</li>
<li class="right">
<a href="invextr.html" title="invextr"
<a href="scmssort.html" title="scmssort"
accesskey="N">
next
</a>
</li>
<li class="right">
<a href="import_inv.html" title="import_inv"
<a href="scmapcut.html" title="scmapcut"
accesskey="P">
previous
</a>
@ -61,7 +61,7 @@
<a href="../modules.html" >Modules</a>
</li>
<li class="nav-item nav-item-2">
<a href="../toc/inventory.html" accesskey="U">Inventory</a>
<a href="../toc/utilities.html" accesskey="U">Utilities</a>
</li>
</ul>
</div>
@ -72,49 +72,48 @@
<div class="fitted content" id="anchors-container">
<div class="body" role="main">
<section id="inv2dlsv">
<span id="id1"></span><h1>inv2dlsv<a class="headerlink" href="#inv2dlsv" title="Permalink to this heading"></a></h1>
<p><strong>Converts SC3 inventory XML to dataless SEED.</strong></p>
<section id="scmsdemux">
<span id="id1"></span><h1>scmsdemux<a class="headerlink" href="#scmsdemux" title="Permalink to this heading"></a></h1>
<p><strong>Demultiplex miniSEED record creating files per stream</strong></p>
<section id="description">
<h2>Description<a class="headerlink" href="#description" title="Permalink to this heading"></a></h2>
<p>inv2dlsv is a simple filter that converts inventory in <cite>SeisComP</cite> XML (<a class="reference internal" href="../base/glossary.html#term-SCML"><span class="xref std std-term">SCML</span></a>)
format from stdin (or a file) to dataless SEED on stdout (or a file). It does
not support processing of input XML such as extraction of networks or channels.
To accomplish this task, combine <strong class="program">inv2dlsv</strong> with <a class="reference internal" href="invextr.html#invextr"><span class="std std-ref">invextr</span></a>.</p>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>Conversion of dataless SEED to <cite>SeisComP</cite> XML is provided by <a class="reference internal" href="dlsv2inv.html#dlsv2inv"><span class="std std-ref">dlsv2inv</span></a>.</p>
</div>
</section>
<section id="examples">
<h2>Examples<a class="headerlink" href="#examples" title="Permalink to this heading"></a></h2>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>“-” can always be used as filename to refer to the standard input/output channel.</p>
</div>
<ol class="arabic">
<li><p>Convert an inventory XML file to a dataless SEED file</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>inv2dlsv<span class="w"> </span>inv.xml<span class="w"> </span>inv.seed
<p>scmsdemux demultiplexes <a class="reference internal" href="../base/glossary.html#term-miniSeed"><span class="xref std std-term">miniSEED</span></a> records found in the given source
writing them into separate new files. The source can be files or stdin. One
file per stream is generated. File names are derived from the stream code and
the begin time of the records.</p>
<p>Examples:</p>
<ul>
<li><p>Demultiplex the miniSEED records contained in <code class="file docutils literal notranslate"><span class="pre">data.mseed</span></code> and
additionally print the names of created files to stderr</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>scmsdemux<span class="w"> </span>-v<span class="w"> </span>data.mseed
</pre></div>
</div>
</li>
<li><p>Convert an inventory XML file to a compressed dataless SEED file</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>inv2dlsv<span class="w"> </span>inv.xml<span class="w"> </span><span class="p">|</span><span class="w"> </span>gzip<span class="w"> </span>&gt;<span class="w"> </span>inv.seed.gz
<li><p>Demultiplex the miniSEED records received from stdin</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>scmssort<span class="w"> </span>-u<span class="w"> </span>-E<span class="w"> </span>data.mseed<span class="w"> </span><span class="p">|</span><span class="w"> </span>scmsdemux<span class="w"> </span>-
</pre></div>
</div>
</li>
<li><p>Convert a subset of an inventory XML using <a class="reference internal" href="invextr.html#invextr"><span class="std std-ref">invextr</span></a>.</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>invextr<span class="w"> </span>--chans<span class="w"> </span><span class="s2">&quot;*MORC*&quot;</span><span class="w"> </span>inv.xml<span class="w"> </span><span class="p">|</span><span class="w"> </span>inv2dlsv<span class="w"> </span>-<span class="w"> </span>inv.seed
</pre></div>
</div>
</li>
</ol>
</ul>
</section>
<section id="command-line-options">
<h2>Command-Line Options<a class="headerlink" href="#command-line-options" title="Permalink to this heading"></a></h2>
<p><strong class="program">inv2dlsv [in_xml [out_dataless]]</strong></p>
<p>If in_xml is not given, stdin is used. If out_dataless is not given,
stdout is used.</p>
<p><strong class="program">scmsdemux [OPTION] source</strong></p>
<section id="verbosity">
<h3>Verbosity<a class="headerlink" href="#verbosity" title="Permalink to this heading"></a></h3>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scmsdemux-h">
<span id="cmdoption-scmsdemux-help"></span><span class="sig-name descname"><span class="pre">-h</span></span><span class="sig-prename descclassname"></span><span class="sig-prename descclassname"><span class="pre">,</span> </span><span class="sig-name descname"><span class="pre">--help</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-scmsdemux-h" title="Permalink to this definition"></a></dt>
<dd><p>Display this help message.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scmsdemux-v">
<span id="cmdoption-scmsdemux-verbose"></span><span class="sig-name descname"><span class="pre">-v</span></span><span class="sig-prename descclassname"></span><span class="sig-prename descclassname"><span class="pre">,</span> </span><span class="sig-name descname"><span class="pre">--verbose</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-scmsdemux-v" title="Permalink to this definition"></a></dt>
<dd><p>Verbose mode.</p>
</dd></dl>
</section>
</section>
</section>
@ -138,10 +137,12 @@ stdout is used.</p>
<div>
<h3><a href="../index.html">Table of Contents</a></h3>
<ul>
<li><a class="reference internal" href="#">inv2dlsv</a><ul>
<li><a class="reference internal" href="#">scmsdemux</a><ul>
<li><a class="reference internal" href="#description">Description</a></li>
<li><a class="reference internal" href="#examples">Examples</a></li>
<li><a class="reference internal" href="#command-line-options">Command-Line Options</a></li>
<li><a class="reference internal" href="#command-line-options">Command-Line Options</a><ul>
<li><a class="reference internal" href="#verbosity">Verbosity</a></li>
</ul>
</li>
</ul>
</li>
</ul>
@ -149,18 +150,18 @@ stdout is used.</p>
</div>
<div>
<h4>Previous topic</h4>
<p class="topless"><a href="import_inv.html"
title="previous chapter">import_inv</a></p>
<p class="topless"><a href="scmapcut.html"
title="previous chapter">scmapcut</a></p>
</div>
<div>
<h4>Next topic</h4>
<p class="topless"><a href="invextr.html"
title="next chapter">invextr</a></p>
<p class="topless"><a href="scmssort.html"
title="next chapter">scmssort</a></p>
</div>
<div role="note" aria-label="source link">
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="../_sources/apps/inv2dlsv.rst.txt"
<li><a href="../_sources/apps/scmsdemux.rst.txt"
rel="nofollow">Show Source</a></li>
</ul>
</div>
@ -176,7 +177,7 @@ stdout is used.</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>scmssort &#8212; SeisComP Release documentation</title>
<title>scmssort &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,21 +12,21 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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="scorgls" href="scorgls.html" />
<link rel="prev" title="scmapcut" href="scmapcut.html" />
<link rel="prev" title="scmsdemux" href="scmsdemux.html" />
</head>
<body>
<div class="header">
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -49,7 +49,7 @@
</a>
</li>
<li class="right">
<a href="scmapcut.html" title="scmapcut"
<a href="scmsdemux.html" title="scmsdemux"
accesskey="P">
previous
</a>
@ -241,8 +241,8 @@ Times are of course UTC and separated by a tilde ~</p>
</div>
<div>
<h4>Previous topic</h4>
<p class="topless"><a href="scmapcut.html"
title="previous chapter">scmapcut</a></p>
<p class="topless"><a href="scmsdemux.html"
title="previous chapter">scmsdemux</a></p>
</div>
<div>
<h4>Next topic</h4>
@ -268,7 +268,7 @@ Times are of course UTC and separated by a tilde ~</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>scmv &#8212; SeisComP Release documentation</title>
<title>scmv &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,12 +12,12 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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="scolv" href="scolv.html" />
<link rel="next" title="scmvx" href="scmvx.html" />
<link rel="prev" title="scmm" href="scmm.html" />
</head>
<body>
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -43,7 +43,7 @@
</a>
</li>
<li class="right">
<a href="scolv.html" title="scolv"
<a href="scmvx.html" title="scmvx"
accesskey="N">
next
</a>
@ -634,12 +634,14 @@ This option can be given more than once.</p>
<dt class="sig sig-object std" id="cmdoption-scmv-content-type">
<span class="sig-name descname"><span class="pre">--content-type</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scmv-content-type" title="Permalink to this definition"></a></dt>
<dd><p>Overrides configuration parameter <a class="reference internal" href="global.html#confval-connection.contentType"><code class="xref std std-confval docutils literal notranslate"><span class="pre">connection.contentType</span></code></a>.</p>
<p>Default: <code class="docutils literal notranslate"><span class="pre">binary</span></code></p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scmv-start-stop-msg">
<span class="sig-name descname"><span class="pre">--start-stop-msg</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scmv-start-stop-msg" title="Permalink to this definition"></a></dt>
<dd><p>Set sending of a start and a stop message.</p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">0</span></code></p>
<p>Set sending of a start and a stop message.</p>
</dd></dl>
</section>
@ -691,12 +693,12 @@ can be queried with &quot;--db-driver-list&quot;.</p>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scmv-I">
<span id="cmdoption-scmv-record-url"></span><span class="sig-name descname"><span class="pre">-I</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">--record-url</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scmv-I" title="Permalink to this definition"></a></dt>
<dd><p>The recordstream source URL, format:
<dd><p>The RecordStream source URL. Format:
[<a class="reference external" href="service://">service://</a>]location[#type].
&quot;service&quot; is the name of the recordstream driver
&quot;service&quot; is the name of the RecordStream driver
which can be queried with &quot;--record-driver-list&quot;.
If &quot;service&quot; is not given, &quot;<a class="reference external" href="file://">file://</a>&quot; is
used.</p>
used and simply the name of a miniSEED file can be given.</p>
</dd></dl>
<dl class="std option">
@ -717,7 +719,9 @@ used.</p>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scmv-city-xml">
<span class="sig-name descname"><span class="pre">--city-xml</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scmv-city-xml" title="Permalink to this definition"></a></dt>
<dd><p>The path to the cities XML file. This overrides the default
<dd><p>Type: <em>file</em></p>
<p>Values: <code class="docutils literal notranslate"><span class="pre">*.xml</span></code></p>
<p>The path to the cities XML file. This overrides the default
paths. Compare with the global parameter &quot;citiesXML&quot;.</p>
</dd></dl>
@ -817,8 +821,8 @@ Modes: groundmotion, qualitycontrol</p>
</div>
<div>
<h4>Next topic</h4>
<p class="topless"><a href="scolv.html"
title="next chapter">scolv</a></p>
<p class="topless"><a href="scmvx.html"
title="next chapter">scmvx</a></p>
</div>
<div role="note" aria-label="source link">
<h3>This Page</h3>
@ -839,7 +843,7 @@ Modes: groundmotion, qualitycontrol</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -0,0 +1,866 @@
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>scmvx &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
<link rel="stylesheet" type="text/css" href="../_static/seiscomp.css?v=c6da7ce6" />
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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="scolv" href="scolv.html" />
<link rel="prev" title="scmv" href="scmv.html" />
</head>
<body>
<div class="header">
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
<div class="nav">
<div class="container">
<div class="content"><a class="pull-right" id="sidebar-toggle">TOC</a>
<div class="related" role="navigation" aria-label="related navigation">
<ul>
<li class="right">
<a href="../genindex.html" title="General Index"
accesskey="I">
index
</a>
</li>
<li class="right">
<a href="scolv.html" title="scolv"
accesskey="N">
next
</a>
</li>
<li class="right">
<a href="scmv.html" title="scmv"
accesskey="P">
previous
</a>
</li>
<li class="nav-item nav-item-0">
<a href="../index.html">Home</a>
</li>
<li class="nav-item nav-item-1">
<a href="../gui.html" accesskey="U">Graphical User Interfaces</a>
</li>
</ul>
</div>
</div>
</div>
</div>
<div class="container">
<div class="fitted content" id="anchors-container">
<div class="body" role="main">
<section id="scmvx">
<span id="id1"></span><h1>scmvx<a class="headerlink" href="#scmvx" title="Permalink to this heading"></a></h1>
<p><strong>Map view showing maps with stations and events. Issues related to
configuration of stations are indicated.</strong></p>
<section id="description">
<h2>Description<a class="headerlink" href="#description" title="Permalink to this heading"></a></h2>
<p>scmvx visualizes the current information of earthquakes or earthquakes loaded
database as well as current station information including:</p>
<ul class="simple">
<li><p>trigger status,</p></li>
<li><p>ground motion,</p></li>
<li><p>station quality,</p></li>
<li><p>station configuration issues.</p></li>
</ul>
<p>All stations and events are visualized in a map. The map can be customized by
global <code class="xref std std-confval docutils literal notranslate"><span class="pre">scheme.map</span></code> parameters and additional layers can be added as
outlined in the <a class="reference internal" href="global_gui.html#global-gui"><span class="std std-ref">GUI documenation</span></a>. scmvx provides multiple
<a class="reference internal" href="#sec-scmvx-tabs"><span class="std std-ref">tabs</span></a>:</p>
<ul class="simple">
<li><p><a class="reference internal" href="#sec-scmvx-network-tab"><span class="std std-ref">Network</span></a>: Maps showing events and network
information including station configuration issues.</p></li>
<li><p><a class="reference internal" href="#sec-scmvx-gm-tab"><span class="std std-ref">Ground motion</span></a>: Map with events and stations. The
color of stations symbols represents recent ground motion calculated by scmvx
in a configurable time window.</p></li>
<li><p><a class="reference internal" href="#sec-scmvx-qc-tab"><span class="std std-ref">Quality control</span></a>: Map with events and stations. The
color of stations symbols represents recent waveform quality control
parameters calculated by <a class="reference internal" href="scqc.html#scqc"><span class="std std-ref">scqc</span></a>.</p></li>
<li><p><a class="reference internal" href="#sec-scmvx-events-tab"><span class="std std-ref">Events</span></a>: Event list updated in real time and
allowing to filter events and to load historic events from database.</p></li>
</ul>
</section>
<section id="tabs">
<span id="sec-scmvx-tabs"></span><h2>Tabs<a class="headerlink" href="#tabs" title="Permalink to this heading"></a></h2>
<p>Section is upcoming.</p>
<section id="network">
<span id="sec-scmvx-network-tab"></span><h3>Network<a class="headerlink" href="#network" title="Permalink to this heading"></a></h3>
<p>Section is upcoming.</p>
</section>
<section id="ground-motion">
<span id="sec-scmvx-gm-tab"></span><h3>Ground motion<a class="headerlink" href="#ground-motion" title="Permalink to this heading"></a></h3>
<p>Section is upcoming.</p>
</section>
<section id="quality-control">
<span id="sec-scmvx-qc-tab"></span><h3>Quality control<a class="headerlink" href="#quality-control" title="Permalink to this heading"></a></h3>
<p>Section is upcoming.</p>
</section>
<section id="events">
<span id="sec-scmvx-events-tab"></span><h3>Events<a class="headerlink" href="#events" title="Permalink to this heading"></a></h3>
<p>Events are shown as they arrive in real time and may be interactively loaded
from database.
During startup events from within a period of time are loaded and shown
according the configuration of <a class="reference internal" href="#confval-readEventsNotOlderThan"><code class="xref std std-confval docutils literal notranslate"><span class="pre">readEventsNotOlderThan</span></code></a>.
More events are added in real time as they arrive.
Historic events can be loaded from database for time spans and other filter
criteria.
The loaded events can sorted interactively by clicking on the table header.
Events out of scope can be hidden based on region, event type of agency ID.
In contrast to other event lists, e.g. in <a class="reference internal" href="scolv.html#scolv"><span class="std std-ref">scolv</span></a> or <a class="reference internal" href="scesv.html#scesv"><span class="std std-ref">scesv</span></a>, this
event list only gives access to parameter of the preferred but no other origins
of events.</p>
<figure class="align-center" id="id2">
<span id="fig-scmvx-events-tab"></span><a class="reference internal image-reference" href="../_images/scmvx-events-tab.png"><img alt="../_images/scmvx-events-tab.png" src="../_images/scmvx-events-tab.png" style="width: 16cm;" /></a>
<figcaption>
<p><span class="caption-text">Events tab</span><a class="headerlink" href="#id2" title="Permalink to this image"></a></p>
</figcaption>
</figure>
</section>
<section id="hotkeys">
<h3>Hotkeys<a class="headerlink" href="#hotkeys" title="Permalink to this heading"></a></h3>
<table class="docutils align-default">
<colgroup>
<col style="width: 30.0%" />
<col style="width: 70.0%" />
</colgroup>
<thead>
<tr class="row-odd"><th class="head"><p>Hotkey</p></th>
<th class="head"><p>Description</p></th>
</tr>
</thead>
<tbody>
<tr class="row-even"><td><p>C</p></td>
<td><p>Center map around latest event upon event update</p></td>
</tr>
<tr class="row-odd"><td><p>G</p></td>
<td><p>Show map base layer in gray scale</p></td>
</tr>
<tr class="row-even"><td><p>N</p></td>
<td><p>Reset view to default</p></td>
</tr>
<tr class="row-odd"><td><p><kbd class="kbd docutils literal notranslate">F1</kbd></p></td>
<td><p>Open SeisComP documentation in default browser</p></td>
</tr>
<tr class="row-even"><td><p><kbd class="kbd compound docutils literal notranslate"><kbd class="kbd docutils literal notranslate">Shift</kbd> <kbd class="kbd docutils literal notranslate"></kbd>+<kbd class="kbd docutils literal notranslate"></kbd> <kbd class="kbd docutils literal notranslate">F1</kbd></kbd></p></td>
<td><p>Open scmvx documentation in default browser</p></td>
</tr>
<tr class="row-odd"><td><p><kbd class="kbd docutils literal notranslate">F2</kbd></p></td>
<td><p>Open dialog for connecting to database and messaging</p></td>
</tr>
<tr class="row-even"><td><p><kbd class="kbd docutils literal notranslate">F6</kbd></p></td>
<td><p>Toggle latest event information on map</p></td>
</tr>
<tr class="row-odd"><td><p><kbd class="kbd docutils literal notranslate">F7</kbd></p></td>
<td><p>Toggle legend</p></td>
</tr>
<tr class="row-even"><td><p><kbd class="kbd docutils literal notranslate">F8</kbd></p></td>
<td><p>Toggle station issues in Network tab</p></td>
</tr>
<tr class="row-odd"><td><p><kbd class="kbd docutils literal notranslate">F9</kbd></p></td>
<td><p>Toggle station annotation</p></td>
</tr>
<tr class="row-even"><td><p><kbd class="kbd docutils literal notranslate">F10</kbd></p></td>
<td><p>Switch to event list (Events tab)</p></td>
</tr>
<tr class="row-odd"><td><p><kbd class="kbd docutils literal notranslate">F11</kbd></p></td>
<td><p>Toggle full screen mode</p></td>
</tr>
<tr class="row-even"><td><p><kbd class="kbd compound docutils literal notranslate"><kbd class="kbd docutils literal notranslate">CTRL</kbd> <kbd class="kbd docutils literal notranslate"></kbd>+<kbd class="kbd docutils literal notranslate"></kbd> <kbd class="kbd docutils literal notranslate">F</kbd></kbd></p></td>
<td><p>Search station</p></td>
</tr>
<tr class="row-odd"><td><p><kbd class="kbd compound docutils literal notranslate"><kbd class="kbd docutils literal notranslate">CTRL</kbd> <kbd class="kbd docutils literal notranslate"></kbd>+<kbd class="kbd docutils literal notranslate"></kbd> <kbd class="kbd docutils literal notranslate">O</kbd></kbd></p></td>
<td><p>Open event parameter XML file</p></td>
</tr>
<tr class="row-even"><td><p><kbd class="kbd compound docutils literal notranslate"><kbd class="kbd docutils literal notranslate">CTRL</kbd> <kbd class="kbd docutils literal notranslate"></kbd>+<kbd class="kbd docutils literal notranslate"></kbd> <kbd class="kbd docutils literal notranslate">Q</kbd></kbd></p></td>
<td><p>Quit scmvx</p></td>
</tr>
<tr class="row-odd"><td><p><kbd class="kbd compound docutils literal notranslate"><kbd class="kbd docutils literal notranslate">Shift</kbd> <kbd class="kbd docutils literal notranslate"></kbd>+<kbd class="kbd docutils literal notranslate"></kbd> <kbd class="kbd docutils literal notranslate">Arrows</kbd></kbd></p></td>
<td><p>Move focus of map</p></td>
</tr>
<tr class="row-even"><td><p><kbd class="kbd docutils literal notranslate">+</kbd></p></td>
<td><p>Zoom in in map</p></td>
</tr>
<tr class="row-odd"><td><p><kbd class="kbd docutils literal notranslate">-</kbd></p></td>
<td><p>Zoom out in map</p></td>
</tr>
<tr class="row-even"><td><p>Mouse wheel</p></td>
<td><p>Zoom in or out in map</p></td>
</tr>
<tr class="row-odd"><td><p>Mouse double click</p></td>
<td><p>Center map</p></td>
</tr>
<tr class="row-even"><td><p>Right mouse button</p></td>
<td><p>Open context menu</p></td>
</tr>
</tbody>
</table>
</section>
</section>
<section id="use-cases">
<h2>Use Cases<a class="headerlink" href="#use-cases" title="Permalink to this heading"></a></h2>
<section id="get-station-information-detail-issues">
<h3>Get station information, detail issues<a class="headerlink" href="#get-station-information-detail-issues" title="Permalink to this heading"></a></h3>
<ol class="arabic simple">
<li><p>Navigate to the Network tab</p></li>
<li><p>Position the mouse above a triangle representing a station. The selected
station is highlighted. Zoom in if events are overlapping.</p></li>
<li><p>Click your left mouse button for opening the station info widget.
Data and potential configuration issues are shown.</p></li>
</ol>
</section>
<section id="search-for-and-show-an-event">
<h3>Search for and show an event<a class="headerlink" href="#search-for-and-show-an-event" title="Permalink to this heading"></a></h3>
<ol class="arabic simple">
<li><p>Navigate to the Events tab load events from database in a relevant time range.
You may narrow down the database search through the filter button. After
events are loaded the list may be limited by hiding irrelevant events and you
may change the sorting of the event table by clicking on the header.</p></li>
<li><p>Identify the event and double-click on the event line to load the parameters.
You will immediately switch to a map centered around the selected event.</p></li>
</ol>
</section>
<section id="get-event-information">
<h3>Get event information<a class="headerlink" href="#get-event-information" title="Permalink to this heading"></a></h3>
<ol class="arabic simple">
<li><p>Position the mouse above a circle representing the location of an event.
Zoom in if events are overlapping.</p></li>
<li><p>Click the left mouse button for opening the event object inspector.</p></li>
</ol>
</section>
<section id="set-preliminary-origin">
<h3>Set preliminary origin<a class="headerlink" href="#set-preliminary-origin" title="Permalink to this heading"></a></h3>
<p><em>Upcoming feature, not yet supported</em></p>
<ol class="arabic simple">
<li><p>Position the mouse in the map</p></li>
<li><p>Press the middle mouse button</p></li>
<li><p>Set date &amp; time and latitude, longitude &amp; depth</p></li>
<li><p>Press “Create” to open the origin in another GUI, e.g., scolv which must
be running already.</p></li>
</ol>
</section>
<section id="search-station-network">
<h3>Search station/network<a class="headerlink" href="#search-station-network" title="Permalink to this heading"></a></h3>
<ol class="arabic simple">
<li><p>Press <kbd class="kbd compound docutils literal notranslate"><kbd class="kbd docutils literal notranslate">CTRL</kbd> <kbd class="kbd docutils literal notranslate"></kbd>+<kbd class="kbd docutils literal notranslate"></kbd> <kbd class="kbd docutils literal notranslate">F</kbd></kbd> to open the search window.</p></li>
<li><p>Type any string from a station and/or network name in the input field or just
select a station from the list.</p></li>
<li><p>Double click in a station in the list to center the map at this location.</p></li>
</ol>
</section>
</section>
<section id="command-line-examples">
<h2>Command-Line Examples<a class="headerlink" href="#command-line-examples" title="Permalink to this heading"></a></h2>
<ul>
<li><p>Real-time view of events and stations on a local server</p>
<div class="highlight-properties notranslate"><div class="highlight"><pre><span></span><span class="na">scmvx</span><span class="w"> </span><span class="s">-H localhost -I slink://localhost --debug</span>
</pre></div>
</div>
</li>
<li><p>Offline view of event parameters given in an XML file. Inventory is read from
database.</p>
<div class="highlight-properties notranslate"><div class="highlight"><pre><span></span><span class="na">scmvx</span><span class="w"> </span><span class="s">-d localhost -i events.xml --debug</span>
</pre></div>
</div>
</li>
</ul>
</section>
<section id="module-configuration">
<span id="scmvx-configuration"></span><h2>Module Configuration<a class="headerlink" href="#module-configuration" title="Permalink to this heading"></a></h2>
<div class="line-block">
<div class="line"><code class="file docutils literal notranslate"><span class="pre">etc/defaults/global.cfg</span></code></div>
<div class="line"><code class="file docutils literal notranslate"><span class="pre">etc/defaults/scmvx.cfg</span></code></div>
<div class="line"><code class="file docutils literal notranslate"><span class="pre">etc/global.cfg</span></code></div>
<div class="line"><code class="file docutils literal notranslate"><span class="pre">etc/scmvx.cfg</span></code></div>
<div class="line"><code class="file docutils literal notranslate"><span class="pre">~/.seiscomp/global.cfg</span></code></div>
<div class="line"><code class="file docutils literal notranslate"><span class="pre">~/.seiscomp/scmvx.cfg</span></code></div>
</div>
<p>scmvx inherits <a class="reference internal" href="global.html#global-configuration"><span class="std std-ref">global options</span></a>.</p>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-displaymode">
<span class="sig-name descname"><span class="pre">displaymode</span></span><a class="headerlink" href="#confval-displaymode" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>Values: <code class="docutils literal notranslate"><span class="pre">groundmotion,qualitycontrol</span></code></p>
<p>Set one of the available display modes used during startup:
groundmotion or qualitycontrol. When empty, the Network tab is
shown.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-readEventsNotOlderThan">
<span class="sig-name descname"><span class="pre">readEventsNotOlderThan</span></span><a class="headerlink" href="#confval-readEventsNotOlderThan" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">86400</span></code></p>
<p>Type: <em>double</em></p>
<p>Unit: <em>s</em></p>
<p>Sets the time span before current time to read events initially
from database.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-centerOrigins">
<span class="sig-name descname"><span class="pre">centerOrigins</span></span><a class="headerlink" href="#confval-centerOrigins" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">false</span></code></p>
<p>Type: <em>boolean</em></p>
<p>If a new origin/event is set/selected, this option defines if
the map is centered or not at the origin location.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-annotations">
<span class="sig-name descname"><span class="pre">annotations</span></span><a class="headerlink" href="#confval-annotations" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">false</span></code></p>
<p>Type: <em>boolean</em></p>
<p>Enables/disabled drawing of station annotations at startup.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-annotationsWithChannels">
<span class="sig-name descname"><span class="pre">annotationsWithChannels</span></span><a class="headerlink" href="#confval-annotationsWithChannels" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">true</span></code></p>
<p>Type: <em>boolean</em></p>
<p>Enable/disable drawing of station annotations with
location/channel codes as NET.STA.LOC.CHA.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-showUnboundStations">
<span class="sig-name descname"><span class="pre">showUnboundStations</span></span><a class="headerlink" href="#confval-showUnboundStations" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">true</span></code></p>
<p>Type: <em>boolean</em></p>
<p>Enable/disable drawing of stations which are not bound with global bindings.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-mapLegendPosition">
<span class="sig-name descname"><span class="pre">mapLegendPosition</span></span><a class="headerlink" href="#confval-mapLegendPosition" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">topleft</span></code></p>
<p>Type: <em>string</em></p>
<p>Values: <code class="docutils literal notranslate"><span class="pre">topleft,topright,bottomright,bottomleft</span></code></p>
<p>The legend location for station symbols (network, QC, ground motion).</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-eventLegendPosition">
<span class="sig-name descname"><span class="pre">eventLegendPosition</span></span><a class="headerlink" href="#confval-eventLegendPosition" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">bottomleft</span></code></p>
<p>Type: <em>string</em></p>
<p>Values: <code class="docutils literal notranslate"><span class="pre">topleft,topright,bottomright,bottomleft</span></code></p>
<p>The legend location for event symbols.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-stations.amplitudeTimeSpan">
<span class="sig-name descname"><span class="pre">stations.amplitudeTimeSpan</span></span><a class="headerlink" href="#confval-stations.amplitudeTimeSpan" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">10</span></code></p>
<p>Type: <em>double</em></p>
<p>Unit: <em>s</em></p>
<p><em>No description available</em></p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-stations.groundMotionRecordLifeSpan">
<span class="sig-name descname"><span class="pre">stations.groundMotionRecordLifeSpan</span></span><a class="headerlink" href="#confval-stations.groundMotionRecordLifeSpan" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">600</span></code></p>
<p>Type: <em>double</em></p>
<p>Unit: <em>s</em></p>
<p>Time to keep waveform data in memory</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-stations.triggerTimeout">
<span class="sig-name descname"><span class="pre">stations.triggerTimeout</span></span><a class="headerlink" href="#confval-stations.triggerTimeout" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">60</span></code></p>
<p>Type: <em>double</em></p>
<p>Unit: <em>s</em></p>
<p><em>No description available</em></p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-stations.groundMotionFilter">
<span class="sig-name descname"><span class="pre">stations.groundMotionFilter</span></span><a class="headerlink" href="#confval-stations.groundMotionFilter" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">ITAPER(60)&gt;&gt;BW_HP(4,0.5)</span></code></p>
<p>Type: <em>string</em></p>
<p>Sets the filter applied to determine ground motion.</p>
</dd></dl>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p><strong>display.*</strong>
<em>The initial rectangular region for the map. The eventual region</em>
<em>is also scaled to the dimension of the opened map widget.</em></p>
</div>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-display.latmin">
<span class="sig-name descname"><span class="pre">display.latmin</span></span><a class="headerlink" href="#confval-display.latmin" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">-90.0</span></code></p>
<p>Type: <em>double</em></p>
<p>Unit: <em>deg</em></p>
<p>Range: <code class="docutils literal notranslate"><span class="pre">-90:90</span></code></p>
<p>Minimum latitude in degrees.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-display.lonmin">
<span class="sig-name descname"><span class="pre">display.lonmin</span></span><a class="headerlink" href="#confval-display.lonmin" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">-180.0</span></code></p>
<p>Type: <em>double</em></p>
<p>Unit: <em>deg</em></p>
<p>Range: <code class="docutils literal notranslate"><span class="pre">-360:360</span></code></p>
<p>Minimum longitude in degrees.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-display.latmax">
<span class="sig-name descname"><span class="pre">display.latmax</span></span><a class="headerlink" href="#confval-display.latmax" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">90.0</span></code></p>
<p>Type: <em>double</em></p>
<p>Unit: <em>deg</em></p>
<p>Range: <code class="docutils literal notranslate"><span class="pre">-90:90</span></code></p>
<p>Maximum latitude in degrees.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-display.lonmax">
<span class="sig-name descname"><span class="pre">display.lonmax</span></span><a class="headerlink" href="#confval-display.lonmax" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">180.0</span></code></p>
<p>Type: <em>double</em></p>
<p>Unit: <em>deg</em></p>
<p>Range: <code class="docutils literal notranslate"><span class="pre">-360:360</span></code></p>
<p>Maximum longitude in degrees.</p>
</dd></dl>
</section>
<section id="command-line-options">
<h2>Command-Line Options<a class="headerlink" href="#command-line-options" title="Permalink to this heading"></a></h2>
<p><strong class="program">scmvx [options]</strong></p>
<section id="verbosity">
<h3>Verbosity<a class="headerlink" href="#verbosity" title="Permalink to this heading"></a></h3>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scmvx-verbosity">
<span class="sig-name descname"><span class="pre">--verbosity</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scmvx-verbosity" title="Permalink to this definition"></a></dt>
<dd><p>Verbosity level [0..4]. 0:quiet, 1:error, 2:warning, 3:info,
4:debug.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scmvx-v">
<span id="cmdoption-scmvx-v"></span><span class="sig-name descname"><span class="pre">-v</span></span><span class="sig-prename descclassname"></span><span class="sig-prename descclassname"><span class="pre">,</span> </span><span class="sig-name descname"><span class="pre">--v</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-scmvx-v" title="Permalink to this definition"></a></dt>
<dd><p>Increase verbosity level (may be repeated, eg. -vv).</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scmvx-q">
<span id="cmdoption-scmvx-quiet"></span><span class="sig-name descname"><span class="pre">-q</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">--quiet</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-scmvx-q" title="Permalink to this definition"></a></dt>
<dd><p>Quiet mode: no logging output.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scmvx-component">
<span class="sig-name descname"><span class="pre">--component</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scmvx-component" title="Permalink to this definition"></a></dt>
<dd><p>Limit the logging to a certain component. This option can
be given more than once.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scmvx-s">
<span id="cmdoption-scmvx-syslog"></span><span class="sig-name descname"><span class="pre">-s</span></span><span class="sig-prename descclassname"></span><span class="sig-prename descclassname"><span class="pre">,</span> </span><span class="sig-name descname"><span class="pre">--syslog</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-scmvx-s" title="Permalink to this definition"></a></dt>
<dd><p>Use syslog logging backend. The output usually goes to
/var/lib/messages.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scmvx-l">
<span id="cmdoption-scmvx-lockfile"></span><span class="sig-name descname"><span class="pre">-l</span></span><span class="sig-prename descclassname"></span><span class="sig-prename descclassname"><span class="pre">,</span> </span><span class="sig-name descname"><span class="pre">--lockfile</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scmvx-l" title="Permalink to this definition"></a></dt>
<dd><p>Path to lock file.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scmvx-console">
<span class="sig-name descname"><span class="pre">--console</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scmvx-console" title="Permalink to this definition"></a></dt>
<dd><p>Send log output to stdout.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scmvx-debug">
<span class="sig-name descname"><span class="pre">--debug</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-scmvx-debug" title="Permalink to this definition"></a></dt>
<dd><p>Execute in debug mode.
Equivalent to --verbosity=4 --console=1 .</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scmvx-log-file">
<span class="sig-name descname"><span class="pre">--log-file</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scmvx-log-file" title="Permalink to this definition"></a></dt>
<dd><p>Use alternative log file.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scmvx-print-component">
<span class="sig-name descname"><span class="pre">--print-component</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scmvx-print-component" title="Permalink to this definition"></a></dt>
<dd><p>For each log entry print the component right after the
log level. By default the component output is enabled
for file output but disabled for console output.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scmvx-trace">
<span class="sig-name descname"><span class="pre">--trace</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-scmvx-trace" title="Permalink to this definition"></a></dt>
<dd><p>Execute in trace mode.
Equivalent to --verbosity=4 --console=1 --print-component=1
--print-context=1 .</p>
</dd></dl>
</section>
<section id="generic">
<h3>Generic<a class="headerlink" href="#generic" title="Permalink to this heading"></a></h3>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scmvx-h">
<span id="cmdoption-scmvx-help"></span><span class="sig-name descname"><span class="pre">-h</span></span><span class="sig-prename descclassname"></span><span class="sig-prename descclassname"><span class="pre">,</span> </span><span class="sig-name descname"><span class="pre">--help</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-scmvx-h" title="Permalink to this definition"></a></dt>
<dd><p>Show help message.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scmvx-V">
<span id="cmdoption-scmvx-version"></span><span class="sig-name descname"><span class="pre">-V</span></span><span class="sig-prename descclassname"></span><span class="sig-prename descclassname"><span class="pre">,</span> </span><span class="sig-name descname"><span class="pre">--version</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-scmvx-V" title="Permalink to this definition"></a></dt>
<dd><p>Show version information.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scmvx-config-file">
<span class="sig-name descname"><span class="pre">--config-file</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scmvx-config-file" title="Permalink to this definition"></a></dt>
<dd><p>Use alternative configuration file. When this option is
used the loading of all stages is disabled. Only the
given configuration file is parsed and used. To use
another name for the configuration create a symbolic
link of the application or copy it. Example:
scautopick -&gt; scautopick2.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scmvx-plugins">
<span class="sig-name descname"><span class="pre">--plugins</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scmvx-plugins" title="Permalink to this definition"></a></dt>
<dd><p>Load given plugins.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scmvx-auto-shutdown">
<span class="sig-name descname"><span class="pre">--auto-shutdown</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scmvx-auto-shutdown" title="Permalink to this definition"></a></dt>
<dd><p>Enable/disable self-shutdown because a master module shutdown.
This only works when messaging is enabled and the master
module sends a shutdown message (enabled with --start-stop-msg
for the master module).</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scmvx-shutdown-master-module">
<span class="sig-name descname"><span class="pre">--shutdown-master-module</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scmvx-shutdown-master-module" title="Permalink to this definition"></a></dt>
<dd><p>Set the name of the master-module used for auto-shutdown.
This is the application name of the module actually
started. If symlinks are used, then it is the name of
the symlinked application.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scmvx-shutdown-master-username">
<span class="sig-name descname"><span class="pre">--shutdown-master-username</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scmvx-shutdown-master-username" title="Permalink to this definition"></a></dt>
<dd><p>Set the name of the master-username of the messaging
used for auto-shutdown. If &quot;shutdown-master-module&quot; is
given as well, this parameter is ignored.</p>
</dd></dl>
</section>
<section id="messaging">
<h3>Messaging<a class="headerlink" href="#messaging" title="Permalink to this heading"></a></h3>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scmvx-u">
<span id="cmdoption-scmvx-user"></span><span class="sig-name descname"><span class="pre">-u</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">--user</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scmvx-u" title="Permalink to this definition"></a></dt>
<dd><p>Overrides configuration parameter <a class="reference internal" href="global.html#confval-connection.username"><code class="xref std std-confval docutils literal notranslate"><span class="pre">connection.username</span></code></a>.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scmvx-H">
<span id="cmdoption-scmvx-host"></span><span class="sig-name descname"><span class="pre">-H</span></span><span class="sig-prename descclassname"></span><span class="sig-prename descclassname"><span class="pre">,</span> </span><span class="sig-name descname"><span class="pre">--host</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scmvx-H" title="Permalink to this definition"></a></dt>
<dd><p>Overrides configuration parameter <a class="reference internal" href="global.html#confval-connection.server"><code class="xref std std-confval docutils literal notranslate"><span class="pre">connection.server</span></code></a>.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scmvx-t">
<span id="cmdoption-scmvx-timeout"></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">--timeout</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scmvx-t" title="Permalink to this definition"></a></dt>
<dd><p>Overrides configuration parameter <a class="reference internal" href="global.html#confval-connection.timeout"><code class="xref std std-confval docutils literal notranslate"><span class="pre">connection.timeout</span></code></a>.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scmvx-g">
<span id="cmdoption-scmvx-primary-group"></span><span class="sig-name descname"><span class="pre">-g</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">--primary-group</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scmvx-g" title="Permalink to this definition"></a></dt>
<dd><p>Overrides configuration parameter <a class="reference internal" href="global.html#confval-connection.primaryGroup"><code class="xref std std-confval docutils literal notranslate"><span class="pre">connection.primaryGroup</span></code></a>.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scmvx-S">
<span id="cmdoption-scmvx-subscribe-group"></span><span class="sig-name descname"><span class="pre">-S</span></span><span class="sig-prename descclassname"></span><span class="sig-prename descclassname"><span class="pre">,</span> </span><span class="sig-name descname"><span class="pre">--subscribe-group</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scmvx-S" title="Permalink to this definition"></a></dt>
<dd><p>A group to subscribe to.
This option can be given more than once.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scmvx-content-type">
<span class="sig-name descname"><span class="pre">--content-type</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scmvx-content-type" title="Permalink to this definition"></a></dt>
<dd><p>Overrides configuration parameter <a class="reference internal" href="global.html#confval-connection.contentType"><code class="xref std std-confval docutils literal notranslate"><span class="pre">connection.contentType</span></code></a>.</p>
<p>Default: <code class="docutils literal notranslate"><span class="pre">binary</span></code></p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scmvx-start-stop-msg">
<span class="sig-name descname"><span class="pre">--start-stop-msg</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scmvx-start-stop-msg" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">0</span></code></p>
<p>Set sending of a start and a stop message.</p>
</dd></dl>
</section>
<section id="database">
<h3>Database<a class="headerlink" href="#database" title="Permalink to this heading"></a></h3>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scmvx-db-driver-list">
<span class="sig-name descname"><span class="pre">--db-driver-list</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-scmvx-db-driver-list" title="Permalink to this definition"></a></dt>
<dd><p>List all supported database drivers.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scmvx-d">
<span id="cmdoption-scmvx-database"></span><span class="sig-name descname"><span class="pre">-d</span></span><span class="sig-prename descclassname"></span><span class="sig-prename descclassname"><span class="pre">,</span> </span><span class="sig-name descname"><span class="pre">--database</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scmvx-d" title="Permalink to this definition"></a></dt>
<dd><p>The database connection string, format:
<a class="reference external" href="service://user:pwd&#64;host/database">service://user:pwd&#64;host/database</a>.
&quot;service&quot; is the name of the database driver which
can be queried with &quot;--db-driver-list&quot;.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scmvx-config-module">
<span class="sig-name descname"><span class="pre">--config-module</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scmvx-config-module" title="Permalink to this definition"></a></dt>
<dd><p>The config module to use.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scmvx-inventory-db">
<span class="sig-name descname"><span class="pre">--inventory-db</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scmvx-inventory-db" title="Permalink to this definition"></a></dt>
<dd><p>Load the inventory from the given database or file, format:
[<a class="reference external" href="service://]location">service://]location</a> .</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scmvx-db-disable">
<span class="sig-name descname"><span class="pre">--db-disable</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-scmvx-db-disable" title="Permalink to this definition"></a></dt>
<dd><p>Do not use the database at all</p>
</dd></dl>
</section>
<section id="records">
<h3>Records<a class="headerlink" href="#records" title="Permalink to this heading"></a></h3>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scmvx-record-driver-list">
<span class="sig-name descname"><span class="pre">--record-driver-list</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-scmvx-record-driver-list" title="Permalink to this definition"></a></dt>
<dd><p>List all supported record stream drivers.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scmvx-I">
<span id="cmdoption-scmvx-record-url"></span><span class="sig-name descname"><span class="pre">-I</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">--record-url</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scmvx-I" title="Permalink to this definition"></a></dt>
<dd><p>The RecordStream source URL. Format:
[<a class="reference external" href="service://">service://</a>]location[#type].
&quot;service&quot; is the name of the RecordStream driver
which can be queried with &quot;--record-driver-list&quot;.
If &quot;service&quot; is not given, &quot;<a class="reference external" href="file://">file://</a>&quot; is
used and simply the name of a miniSEED file can be given.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scmvx-record-file">
<span class="sig-name descname"><span class="pre">--record-file</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scmvx-record-file" title="Permalink to this definition"></a></dt>
<dd><p>Specify a file as record source.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scmvx-record-type">
<span class="sig-name descname"><span class="pre">--record-type</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scmvx-record-type" title="Permalink to this definition"></a></dt>
<dd><p>Specify a type for the records being read.</p>
</dd></dl>
</section>
<section id="cities">
<h3>Cities<a class="headerlink" href="#cities" title="Permalink to this heading"></a></h3>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scmvx-city-xml">
<span class="sig-name descname"><span class="pre">--city-xml</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scmvx-city-xml" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>file</em></p>
<p>Values: <code class="docutils literal notranslate"><span class="pre">*.xml</span></code></p>
<p>The path to the cities XML file. This overrides the default
paths. Compare with the global parameter &quot;citiesXML&quot;.</p>
</dd></dl>
</section>
<section id="user-interface">
<h3>User interface<a class="headerlink" href="#user-interface" title="Permalink to this heading"></a></h3>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scmvx-F">
<span id="cmdoption-scmvx-full-screen"></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">--full-screen</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-scmvx-F" title="Permalink to this definition"></a></dt>
<dd><p>Start the application filling the entire screen.
This only works with GUI applications.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scmvx-N">
<span id="cmdoption-scmvx-non-interactive"></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">--non-interactive</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-scmvx-N" title="Permalink to this definition"></a></dt>
<dd><p>Use non-interactive presentation mode. This only works with
GUI applications.</p>
</dd></dl>
</section>
<section id="mapviewx">
<h3>MapviewX<a class="headerlink" href="#mapviewx" title="Permalink to this heading"></a></h3>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scmvx-display-mode">
<span class="sig-name descname"><span class="pre">--display-mode</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scmvx-display-mode" title="Permalink to this definition"></a></dt>
<dd><p>Overrides configuration parameter <a class="reference internal" href="#confval-displaymode"><code class="xref std std-confval docutils literal notranslate"><span class="pre">displaymode</span></code></a>.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scmvx-i">
<span id="cmdoption-scmvx-input-file"></span><span class="sig-name descname"><span class="pre">-i</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">--input-file</span></span><span class="sig-prename descclassname"> <span class="pre">file</span></span><a class="headerlink" href="#cmdoption-scmvx-i" title="Permalink to this definition"></a></dt>
<dd><p>Load events in given XML file during startup and switch to
offline mode.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scmvx-offline">
<span class="sig-name descname"><span class="pre">--offline</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-scmvx-offline" title="Permalink to this definition"></a></dt>
<dd><p>Do not connect to a messaging server and do not subscribe
channel data.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scmvx-with-legend">
<span class="sig-name descname"><span class="pre">--with-legend</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-scmvx-with-legend" title="Permalink to this definition"></a></dt>
<dd><p>Show the map legends.</p>
</dd></dl>
</section>
</section>
</section>
<div id="anchors-bottom"></div>
</div>
<div class="sidebar" role="navigation" aria-label="main navigation">
<div id="anchors-top"></div>
<div id="anchors" class="content">
<div id="searchbox" style="display: none" role="search">
<h3 id="searchlabel">Quick search</h3>
<div class="searchformwrapper">
<form class="search" action="../search.html" method="get">
<input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
<input type="submit" value="Go" />
</form>
</div>
</div>
<script>document.getElementById('searchbox').style.display = "block"</script>
<div>
<h3><a href="../index.html">Table of Contents</a></h3>
<ul>
<li><a class="reference internal" href="#">scmvx</a><ul>
<li><a class="reference internal" href="#description">Description</a></li>
<li><a class="reference internal" href="#tabs">Tabs</a><ul>
<li><a class="reference internal" href="#network">Network</a></li>
<li><a class="reference internal" href="#ground-motion">Ground motion</a></li>
<li><a class="reference internal" href="#quality-control">Quality control</a></li>
<li><a class="reference internal" href="#events">Events</a></li>
<li><a class="reference internal" href="#hotkeys">Hotkeys</a></li>
</ul>
</li>
<li><a class="reference internal" href="#use-cases">Use Cases</a><ul>
<li><a class="reference internal" href="#get-station-information-detail-issues">Get station information, detail issues</a></li>
<li><a class="reference internal" href="#search-for-and-show-an-event">Search for and show an event</a></li>
<li><a class="reference internal" href="#get-event-information">Get event information</a></li>
<li><a class="reference internal" href="#set-preliminary-origin">Set preliminary origin</a></li>
<li><a class="reference internal" href="#search-station-network">Search station/network</a></li>
</ul>
</li>
<li><a class="reference internal" href="#command-line-examples">Command-Line Examples</a></li>
<li><a class="reference internal" href="#module-configuration">Module Configuration</a></li>
<li><a class="reference internal" href="#command-line-options">Command-Line Options</a><ul>
<li><a class="reference internal" href="#verbosity">Verbosity</a></li>
<li><a class="reference internal" href="#generic">Generic</a></li>
<li><a class="reference internal" href="#messaging">Messaging</a></li>
<li><a class="reference internal" href="#database">Database</a></li>
<li><a class="reference internal" href="#records">Records</a></li>
<li><a class="reference internal" href="#cities">Cities</a></li>
<li><a class="reference internal" href="#user-interface">User interface</a></li>
<li><a class="reference internal" href="#mapviewx">MapviewX</a></li>
</ul>
</li>
</ul>
</li>
</ul>
</div>
<div>
<h4>Previous topic</h4>
<p class="topless"><a href="scmv.html"
title="previous chapter">scmv</a></p>
</div>
<div>
<h4>Next topic</h4>
<p class="topless"><a href="scolv.html"
title="next chapter">scolv</a></p>
</div>
<div role="note" aria-label="source link">
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="../_sources/apps/scmvx.rst.txt"
rel="nofollow">Show Source</a></li>
</ul>
</div>
</div>
</div>
</div>
</div>
<div class="footer">
<div class="container">
<div class="horizontal layout content">
<a class="fade-in" href="https://www.gempa.de" target="_blank">
<img class="brand" src="../_static/brands/gempa.svg"/>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.
</div>
</div>
<a class="fade-in" href="https://www.gfz-potsdam.de" target="_blank">
<img class="brand" src="../_static/brands/gfz.svg"/>
</a>
</div>
</div>
</div>
</body>
</html>

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>scolv &#8212; SeisComP Release documentation</title>
<title>scolv &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,21 +12,21 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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="scqcv" href="scqcv.html" />
<link rel="prev" title="scmv" href="scmv.html" />
<link rel="prev" title="scmvx" href="scmvx.html" />
</head>
<body>
<div class="header">
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -49,7 +49,7 @@
</a>
</li>
<li class="right">
<a href="scmv.html" title="scmv"
<a href="scmvx.html" title="scmvx"
accesskey="P">
previous
</a>
@ -2020,10 +2020,12 @@ list of the &quot;Commit with additional options&quot; dialog.</p>
<dt class="sig sig-object std" id="confval-olv.defaultMagnitudeAggregation">
<span class="sig-name descname"><span class="pre">olv.defaultMagnitudeAggregation</span></span><a class="headerlink" href="#confval-olv.defaultMagnitudeAggregation" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>Sets the default magnitude aggregation method. It can be either &quot;mean&quot;,
&quot;trimmed mean&quot; or &quot;median&quot;. If not set, the default
behavior is used which computes the mean if less than 4 stations are available,
trimmed mean otherwise.</p>
<p>Values: <code class="docutils literal notranslate"><span class="pre">mean,trimmedMean,median,medianTrimmedMean</span></code></p>
<p>Sets the default magnitude aggregation method.
If not set, the default behavior is used which computes the
mean if less than 4 stations are available, trimmed mean otherwise.
Neither of the above values can take an additional parameter.
The default parameter values (if supported) will be used.</p>
</dd></dl>
<dl class="std confval">
@ -2101,6 +2103,15 @@ in the arrivals or not.</p>
<p>The default value for adding unassociated stations in the picker.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-olv.loadAdditionalStations">
<span class="sig-name descname"><span class="pre">olv.loadAdditionalStations</span></span><a class="headerlink" href="#confval-olv.loadAdditionalStations" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">false</span></code></p>
<p>Type: <em>boolean</em></p>
<p>If enabled then all station within the configured distance will
be loaded if a new origin is loaded.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-olv.hideStationsWithoutData">
<span class="sig-name descname"><span class="pre">olv.hideStationsWithoutData</span></span><a class="headerlink" href="#confval-olv.hideStationsWithoutData" title="Permalink to this definition"></a></dt>
@ -2144,6 +2155,14 @@ hidden in the picker.</p>
when a new event was received.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-olv.originAgencyIDs">
<span class="sig-name descname"><span class="pre">olv.originAgencyIDs</span></span><a class="headerlink" href="#confval-olv.originAgencyIDs" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>list:string</em></p>
<p>Define a list of agencyIDs which can be used as override
for the origin agencyID when committing with options.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-olv.originComments">
<span class="sig-name descname"><span class="pre">olv.originComments</span></span><a class="headerlink" href="#confval-olv.originComments" title="Permalink to this definition"></a></dt>
@ -2236,6 +2255,56 @@ is being loaded. It tries to figure the locator type
from Origin.methodID and the profile from Origin.earthModelID.</p>
</dd></dl>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p><strong>olv.import.*</strong>
<em>Set default options for the “Import picks” dialog.</em></p>
</div>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-olv.import.mode">
<span class="sig-name descname"><span class="pre">olv.import.mode</span></span><a class="headerlink" href="#confval-olv.import.mode" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">latest</span></code></p>
<p>Type: <em>string</em></p>
<p>Values: <code class="docutils literal notranslate"><span class="pre">latest,latest-automatic,phases,all</span></code></p>
<p>Defines the default mode of import picks. For more information
see the &quot;Import picks&quot; dialog.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-olv.import.acceptedPhases">
<span class="sig-name descname"><span class="pre">olv.import.acceptedPhases</span></span><a class="headerlink" href="#confval-olv.import.acceptedPhases" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>list:string</em></p>
<p>Defines a list of accepted or denied phases when importing picks.
This list will be used to populate the corresponding input
field in the &quot;Import picks&quot; dialog.</p>
<p>A phase which is prepended with a minus, e.g. &quot;-P&quot;,
will be denied.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-olv.import.options.allAgencies">
<span class="sig-name descname"><span class="pre">olv.import.options.allAgencies</span></span><a class="headerlink" href="#confval-olv.import.options.allAgencies" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">false</span></code></p>
<p>Type: <em>boolean</em></p>
<p>Configures the default for &quot;Import picks from all agencies …&quot;.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-olv.import.options.allPhases">
<span class="sig-name descname"><span class="pre">olv.import.options.allPhases</span></span><a class="headerlink" href="#confval-olv.import.options.allPhases" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">true</span></code></p>
<p>Type: <em>boolean</em></p>
<p>Configures the default for &quot;Import all phases …&quot;.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-olv.import.options.preferTargetPhases">
<span class="sig-name descname"><span class="pre">olv.import.options.preferTargetPhases</span></span><a class="headerlink" href="#confval-olv.import.options.preferTargetPhases" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">true</span></code></p>
<p>Type: <em>boolean</em></p>
<p>Configures the default for &quot;Prefer phases of target …&quot;.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-olv.commit.forceEventAssociation">
<span class="sig-name descname"><span class="pre">olv.commit.forceEventAssociation</span></span><a class="headerlink" href="#confval-olv.commit.forceEventAssociation" title="Permalink to this definition"></a></dt>
@ -2469,6 +2538,96 @@ Use hexadecimal values.</p>
<p>Add a summary of the actions to the buttons tooltip.</p>
</dd></dl>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p><strong>olv.commandMenuAction.*</strong>
<em>Configuration of custom commands shown in a menu when pressing</em>
<em>the Run button next to the custom script buttons. Actions</em>
<em>defined here will appear in order of listing. A dash may be</em>
<em>use to insert a separator.</em></p>
</div>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p><strong>olv.commandMenuAction.$name.*</strong>
<em>Definition of a command menu action.</em>
$name is a placeholder for the name to be used.</p>
</div>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-olv.commandMenuAction.-name.enable">
<span class="sig-name descname"><span class="pre">olv.commandMenuAction.$name.enable</span></span><a class="headerlink" href="#confval-olv.commandMenuAction.-name.enable" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">true</span></code></p>
<p>Type: <em>boolean</em></p>
<p>Controls whether this action will be available.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-olv.commandMenuAction.-name.command">
<span class="sig-name descname"><span class="pre">olv.commandMenuAction.$name.command</span></span><a class="headerlink" href="#confval-olv.commandMenuAction.-name.command" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>file</em></p>
<p>Command to be executed. Similar to the custom script
buttons the command is launched with the current
origin ID as first argument and the eventID as
second argument if available. Optionally the entire
origin may be written to stdin if an exporter is
defined.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-olv.commandMenuAction.-name.exporter">
<span class="sig-name descname"><span class="pre">olv.commandMenuAction.$name.exporter</span></span><a class="headerlink" href="#confval-olv.commandMenuAction.-name.exporter" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>Values: <code class="docutils literal notranslate"><span class="pre">scml,json,csv,binary</span></code></p>
<p>Name of the SeisComP exporter used to serialize
the current origin when writing it to stdin of
the specified command. If empty no data will be
send to stdin. See sccnv --list-formats for a
list of available options.</p>
<p>Note: Some of the exporters are implemented
as plugins which need to be loaded before they
can be used.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-olv.commandMenuAction.-name.showProcess">
<span class="sig-name descname"><span class="pre">olv.commandMenuAction.$name.showProcess</span></span><a class="headerlink" href="#confval-olv.commandMenuAction.-name.showProcess" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">false</span></code></p>
<p>Type: <em>boolean</em></p>
<p>Automatically open process manager for progress
monitoring. The process manager may also be started
manually via the View menu bar entry or via an icon
at the right of the status bar.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-olv.commandMenuAction.-name.text">
<span class="sig-name descname"><span class="pre">olv.commandMenuAction.$name.text</span></span><a class="headerlink" href="#confval-olv.commandMenuAction.-name.text" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>Name of the action. Use in the launch menu and in
the process manager.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-olv.commandMenuAction.-name.icon">
<span class="sig-name descname"><span class="pre">olv.commandMenuAction.$name.icon</span></span><a class="headerlink" href="#confval-olv.commandMenuAction.-name.icon" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>file</em></p>
<p>Path to an icon to show for this action.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-olv.commandMenuAction.-name.keySequence">
<span class="sig-name descname"><span class="pre">olv.commandMenuAction.$name.keySequence</span></span><a class="headerlink" href="#confval-olv.commandMenuAction.-name.keySequence" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>file</em></p>
<p>Keyboard shortcut to run this action without
the need to open the menu. E.g., Ctrl+Alt+A</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-olv.commandMenuAction.-name.toolTip">
<span class="sig-name descname"><span class="pre">olv.commandMenuAction.$name.toolTip</span></span><a class="headerlink" href="#confval-olv.commandMenuAction.-name.toolTip" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>file</em></p>
<p>Tool tip for this action.</p>
</dd></dl>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p><strong>olv.magnitudeComments.*</strong>
@ -2563,7 +2722,7 @@ stations given by &quot;picker.limitStationAcquisitionCount&quot;.</p>
<span class="sig-name descname"><span class="pre">picker.limitStationAcquisitionCount</span></span><a class="headerlink" href="#confval-picker.limitStationAcquisitionCount" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">10</span></code></p>
<p>Type: <em>int</em></p>
<p>Limit the data acquisituion to the given number of
<p>Limit the data acquisition to the given number of
the nearest stations. Requires to activate
&quot;picker.limitStationAcquisition&quot;.</p>
</dd></dl>
@ -2673,6 +2832,24 @@ to interval [0:1] where 0 is the left side and 1 is right
side of the trace window.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-picker.rotation">
<span class="sig-name descname"><span class="pre">picker.rotation</span></span><a class="headerlink" href="#confval-picker.rotation" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">123</span></code></p>
<p>Type: <em>string</em></p>
<p>Values: <code class="docutils literal notranslate"><span class="pre">123,ZNE,ZRT,LQT,ZH(L2)</span></code></p>
<p>The initially applied rotation component waveform rotation.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-picker.unit">
<span class="sig-name descname"><span class="pre">picker.unit</span></span><a class="headerlink" href="#confval-picker.unit" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">Sensor</span></code></p>
<p>Type: <em>string</em></p>
<p>Values: <code class="docutils literal notranslate"><span class="pre">Sensor,Acceleration,Velocity,Displacement</span></code></p>
<p>The unit the waveform data is converted to initially.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-picker.repickerStart">
<span class="sig-name descname"><span class="pre">picker.repickerStart</span></span><a class="headerlink" href="#confval-picker.repickerStart" title="Permalink to this definition"></a></dt>
@ -2697,6 +2874,18 @@ side of the trace window.</p>
&quot;name1;filter-definition1&quot;, &quot;name2;filter-definition2&quot;</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-picker.limitFilterToZoomTrace">
<span class="sig-name descname"><span class="pre">picker.limitFilterToZoomTrace</span></span><a class="headerlink" href="#confval-picker.limitFilterToZoomTrace" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">false</span></code></p>
<p>Type: <em>boolean</em></p>
<p>Whether to apply the current filter only to the zoom trace or
all traces. If enabled then the current filter will only be
applied to another trace if it becomes the current trace. This
is mainly for performance reasons as filtering hundreds or
thousands of channels can take much time.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-picker.velocityChannelCodes">
<span class="sig-name descname"><span class="pre">picker.velocityChannelCodes</span></span><a class="headerlink" href="#confval-picker.velocityChannelCodes" title="Permalink to this definition"></a></dt>
@ -2759,6 +2948,19 @@ the component of the zoom trace will change but the overall
component will stay the same. It must be changed explicitely.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-picker.showAmpLevel">
<span class="sig-name descname"><span class="pre">picker.showAmpLevel</span></span><a class="headerlink" href="#confval-picker.showAmpLevel" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">false</span></code></p>
<p>Type: <em>boolean</em></p>
<p>If enabled then the picker will show in the upper right corner of
the zoomtrace an amplitude measure ranging from 0 to 100 and mapping
the current amplitude at the cursor to this range where 0 is the bottom
of the widget and 100 the top of the widget. Screen readers should
fetch this value change and read them. This is especially important
to support visually impaired users.</p>
</dd></dl>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p><strong>picker.auxiliary.*</strong>
@ -2774,6 +2976,8 @@ component will stay the same. It must be changed explicitely.</p>
<p>A list of wildcard patterns to identify auxiliary
channels. A pattern is simply checked against a stream
ID, the concatenation of NSLC separated by a period.</p>
<p>This is an obsolete and deprecated setting. Please use
profiles.</p>
</dd></dl>
<dl class="std confval">
@ -2786,6 +2990,8 @@ ID, the concatenation of NSLC separated by a period.</p>
unassociated auxiliary channel. Loading a
channel / station explicitely (F3) will not respect
this setting.</p>
<p>This is an obsolete and deprecated setting. Please use
profiles.</p>
</dd></dl>
<dl class="std confval">
@ -2798,6 +3004,61 @@ this setting.</p>
unassociated auxiliary channel. Loading a
channel / station explicitely (F3) will not respect
this setting.</p>
<p>This is an obsolete and deprecated setting. Please use
profiles.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-picker.auxiliary.profiles">
<span class="sig-name descname"><span class="pre">picker.auxiliary.profiles</span></span><a class="headerlink" href="#confval-picker.auxiliary.profiles" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>list:string</em></p>
<p>A list of auxiliary channel profiles which are enabled.</p>
</dd></dl>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p><strong>picker.auxiliary.profiles.$name.*</strong>
$name is a placeholder for the name to be used and needs to be added to <a class="reference internal" href="#confval-picker.auxiliary.profiles"><code class="xref std std-confval docutils literal notranslate"><span class="pre">picker.auxiliary.profiles</span></code></a> to become active.</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>picker.auxiliary.profiles<span class="w"> </span><span class="o">=</span><span class="w"> </span>a,b
picker.auxiliary.profiles.a.value1<span class="w"> </span><span class="o">=</span><span class="w"> </span>...
picker.auxiliary.profiles.b.value1<span class="w"> </span><span class="o">=</span><span class="w"> </span>...
<span class="c1"># c is not active because it has not been added</span>
<span class="c1"># to the list of picker.auxiliary.profiles</span>
picker.auxiliary.profiles.c.value1<span class="w"> </span><span class="o">=</span><span class="w"> </span>...
</pre></div>
</div>
</div>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-picker.auxiliary.profiles.-name.channels">
<span class="sig-name descname"><span class="pre">picker.auxiliary.profiles.$name.channels</span></span><a class="headerlink" href="#confval-picker.auxiliary.profiles.-name.channels" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>list:string</em></p>
<p>A list of wildcard patterns to identify auxiliary
channels. A pattern is simply checked against a stream
ID, the concatenation of NSLC separated by a period.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-picker.auxiliary.profiles.-name.minimumDistance">
<span class="sig-name descname"><span class="pre">picker.auxiliary.profiles.$name.minimumDistance</span></span><a class="headerlink" href="#confval-picker.auxiliary.profiles.-name.minimumDistance" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">0</span></code></p>
<p>Type: <em>double</em></p>
<p>Unit: <em>deg</em></p>
<p>The minimum distance in degrees from origin to load an
unassociated auxiliary channel. Loading a
channel / station explicitely (F3) will not respect
this setting.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-picker.auxiliary.profiles.-name.maximumDistance">
<span class="sig-name descname"><span class="pre">picker.auxiliary.profiles.$name.maximumDistance</span></span><a class="headerlink" href="#confval-picker.auxiliary.profiles.-name.maximumDistance" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">1000</span></code></p>
<p>Type: <em>double</em></p>
<p>Unit: <em>deg</em></p>
<p>The maximum distance in degrees from origin to load an
unassociated auxiliary channel. Loading a
channel / station explicitely (F3) will not respect
this setting.</p>
</dd></dl>
<div class="admonition note">
@ -2943,6 +3204,50 @@ amplitude time window.</p>
amplitude time window.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-amplitudePicker.defaultNoiseBegin">
<span class="sig-name descname"><span class="pre">amplitudePicker.defaultNoiseBegin</span></span><a class="headerlink" href="#confval-amplitudePicker.defaultNoiseBegin" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">-30</span></code></p>
<p>Type: <em>double</em></p>
<p>Unit: <em>s</em></p>
<p>In case the amplitude time window cannot be computed due
to errors, e.g. computing travel times, this default noise
window start time will be used instead.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-amplitudePicker.defaultNoiseEnd">
<span class="sig-name descname"><span class="pre">amplitudePicker.defaultNoiseEnd</span></span><a class="headerlink" href="#confval-amplitudePicker.defaultNoiseEnd" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">0</span></code></p>
<p>Type: <em>double</em></p>
<p>Unit: <em>s</em></p>
<p>In case the amplitude time window cannot be computed due
to errors, e.g. computing travel times, this default noise
window end time will be used instead.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-amplitudePicker.defaultSignalBegin">
<span class="sig-name descname"><span class="pre">amplitudePicker.defaultSignalBegin</span></span><a class="headerlink" href="#confval-amplitudePicker.defaultSignalBegin" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">0</span></code></p>
<p>Type: <em>double</em></p>
<p>Unit: <em>s</em></p>
<p>In case the amplitude time window cannot be computed due
to errors, e.g. computing travel times, this default signal
window start time will be used instead.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-amplitudePicker.defaultSignalEnd">
<span class="sig-name descname"><span class="pre">amplitudePicker.defaultSignalEnd</span></span><a class="headerlink" href="#confval-amplitudePicker.defaultSignalEnd" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">30</span></code></p>
<p>Type: <em>double</em></p>
<p>Unit: <em>s</em></p>
<p>In case the amplitude time window cannot be computed due
to errors, e.g. computing travel times, this default signal
window end time will be used instead.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-amplitudePicker.filters">
<span class="sig-name descname"><span class="pre">amplitudePicker.filters</span></span><a class="headerlink" href="#confval-amplitudePicker.filters" title="Permalink to this definition"></a></dt>
@ -3187,12 +3492,14 @@ This option can be given more than once.</p>
<dt class="sig sig-object std" id="cmdoption-scolv-content-type">
<span class="sig-name descname"><span class="pre">--content-type</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scolv-content-type" title="Permalink to this definition"></a></dt>
<dd><p>Overrides configuration parameter <a class="reference internal" href="global.html#confval-connection.contentType"><code class="xref std std-confval docutils literal notranslate"><span class="pre">connection.contentType</span></code></a>.</p>
<p>Default: <code class="docutils literal notranslate"><span class="pre">binary</span></code></p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scolv-start-stop-msg">
<span class="sig-name descname"><span class="pre">--start-stop-msg</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scolv-start-stop-msg" title="Permalink to this definition"></a></dt>
<dd><p>Set sending of a start and a stop message.</p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">0</span></code></p>
<p>Set sending of a start and a stop message.</p>
</dd></dl>
</section>
@ -3244,12 +3551,12 @@ can be queried with &quot;--db-driver-list&quot;.</p>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scolv-I">
<span id="cmdoption-scolv-record-url"></span><span class="sig-name descname"><span class="pre">-I</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">--record-url</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scolv-I" title="Permalink to this definition"></a></dt>
<dd><p>The recordstream source URL, format:
<dd><p>The RecordStream source URL. Format:
[<a class="reference external" href="service://">service://</a>]location[#type].
&quot;service&quot; is the name of the recordstream driver
&quot;service&quot; is the name of the RecordStream driver
which can be queried with &quot;--record-driver-list&quot;.
If &quot;service&quot; is not given, &quot;<a class="reference external" href="file://">file://</a>&quot; is
used.</p>
used and simply the name of a miniSEED file can be given.</p>
</dd></dl>
<dl class="std option">
@ -3270,7 +3577,9 @@ used.</p>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scolv-city-xml">
<span class="sig-name descname"><span class="pre">--city-xml</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scolv-city-xml" title="Permalink to this definition"></a></dt>
<dd><p>The path to the cities XML file. This overrides the default
<dd><p>Type: <em>file</em></p>
<p>Values: <code class="docutils literal notranslate"><span class="pre">*.xml</span></code></p>
<p>The path to the cities XML file. This overrides the default
paths. Compare with the global parameter &quot;citiesXML&quot;.</p>
</dd></dl>
@ -3451,8 +3760,8 @@ GUI applications.</p>
</div>
<div>
<h4>Previous topic</h4>
<p class="topless"><a href="scmv.html"
title="previous chapter">scmv</a></p>
<p class="topless"><a href="scmvx.html"
title="previous chapter">scmvx</a></p>
</div>
<div>
<h4>Next topic</h4>
@ -3478,7 +3787,7 @@ GUI applications.</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>scorgls &#8212; SeisComP Release documentation</title>
<title>scorgls &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -384,7 +384,7 @@ Deactivates reading origins from database.</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>scqc &#8212; SeisComP Release documentation</title>
<title>scqc &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -102,7 +102,7 @@ by default or selected by <a class="reference internal" href="#scqc-setup"><span
<figcaption>
<p><span class="caption-text">Times describing the data records, e.g., for calculating
<a class="reference internal" href="#scqc-delay"><span class="std std-ref">delay</span></a> or <a class="reference internal" href="#scqc-latency"><span class="std std-ref">latency</span></a>.
<img class="math" src="../_images/math/1f50c891e31cbac3d86762eed95535d46fedfbb7.png" alt="t_{now}"/> may be measured differently depending on the QC parameter.</span><a class="headerlink" href="#id2" title="Permalink to this image"></a></p>
<img class="math" src="../_images/math/1f50c891e31cbac3d86762eed95535d46fedfbb7.svg" alt="t_{now}"/> may be measured differently depending on the QC parameter.</span><a class="headerlink" href="#id2" title="Permalink to this image"></a></p>
</figcaption>
</figure>
<p>The following QC parameters are determined when the corresponding plugin is
@ -114,10 +114,10 @@ loaded:</p>
</dl>
<dl id="scqc-delay">
<dt>delay [s]</dt><dd><p><strong>Plugin:</strong> qcplugin_delay</p>
<p><strong>Description:</strong> Time difference between current time, <img class="math" src="../_images/math/1f50c891e31cbac3d86762eed95535d46fedfbb7.png" alt="t_{now}"/>, and
<p><strong>Description:</strong> Time difference between current time, <img class="math" src="../_images/math/1f50c891e31cbac3d86762eed95535d46fedfbb7.svg" alt="t_{now}"/>, and
time of the last record in the <cite>SeisComP</cite> system (see <a class="reference internal" href="#scqc-fig-times"><span class="std std-ref">Figure</span></a>):</p>
<div class="math">
<p><img src="../_images/math/a00f908f87fb188a574cbfcdc84d27eb048638d3.png" alt="delay = t_{now} - t_{2}."/></p>
<p><img src="../_images/math/a00f908f87fb188a574cbfcdc84d27eb048638d3.svg" alt="delay = t_{now} - t_{2}."/></p>
</div><div class="admonition note">
<p class="admonition-title">Note</p>
<p>Current time is measured during reception of a record and updated in the
@ -139,10 +139,10 @@ for gaps count &gt; 1. This may be important when evaluating the intervals.</p>
</dl>
<dl id="scqc-latency">
<dt>latency [s]</dt><dd><p><strong>Plugin:</strong> qcplugin_latency</p>
<p><strong>Description:</strong> Time difference between current time, <img class="math" src="../_images/math/1f50c891e31cbac3d86762eed95535d46fedfbb7.png" alt="t_{now}"/>, and
<p><strong>Description:</strong> Time difference between current time, <img class="math" src="../_images/math/1f50c891e31cbac3d86762eed95535d46fedfbb7.svg" alt="t_{now}"/>, and
arrival time of the last record (see <a class="reference internal" href="#scqc-fig-times"><span class="std std-ref">Figure</span></a>):</p>
<div class="math">
<p><img src="../_images/math/7bf45885e062034318f53c011608395ed5c38808.png" alt="latency = t_{now} - t_{arr}."/></p>
<p><img src="../_images/math/7bf45885e062034318f53c011608395ed5c38808.svg" alt="latency = t_{now} - t_{arr}."/></p>
</div><div class="admonition note">
<p class="admonition-title">Note</p>
<p>Current time is measured during reception of a record and updated in the
@ -1764,12 +1764,14 @@ This option can be given more than once.</p>
<dt class="sig sig-object std" id="cmdoption-scqc-content-type">
<span class="sig-name descname"><span class="pre">--content-type</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scqc-content-type" title="Permalink to this definition"></a></dt>
<dd><p>Overrides configuration parameter <a class="reference internal" href="global.html#confval-connection.contentType"><code class="xref std std-confval docutils literal notranslate"><span class="pre">connection.contentType</span></code></a>.</p>
<p>Default: <code class="docutils literal notranslate"><span class="pre">binary</span></code></p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scqc-start-stop-msg">
<span class="sig-name descname"><span class="pre">--start-stop-msg</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scqc-start-stop-msg" title="Permalink to this definition"></a></dt>
<dd><p>Set sending of a start and a stop message.</p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">0</span></code></p>
<p>Set sending of a start and a stop message.</p>
</dd></dl>
</section>
@ -1821,12 +1823,12 @@ can be queried with &quot;--db-driver-list&quot;.</p>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scqc-I">
<span id="cmdoption-scqc-record-url"></span><span class="sig-name descname"><span class="pre">-I</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">--record-url</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scqc-I" title="Permalink to this definition"></a></dt>
<dd><p>The recordstream source URL, format:
<dd><p>The RecordStream source URL. Format:
[<a class="reference external" href="service://">service://</a>]location[#type].
&quot;service&quot; is the name of the recordstream driver
&quot;service&quot; is the name of the RecordStream driver
which can be queried with &quot;--record-driver-list&quot;.
If &quot;service&quot; is not given, &quot;<a class="reference external" href="file://">file://</a>&quot; is
used.</p>
used and simply the name of a miniSEED file can be given.</p>
</dd></dl>
<dl class="std option">
@ -1913,7 +1915,7 @@ used.</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>scqcv &#8212; SeisComP Release documentation</title>
<title>scqcv &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -419,13 +419,6 @@ value until updated.</p>
<p>Activate to display absolute values (modulus).</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-default.action">
<span class="sig-name descname"><span class="pre">default.action</span></span><a class="headerlink" href="#confval-default.action" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>Possible values: enableStream, disableStream</p>
</dd></dl>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p><strong>default.range.*</strong>
@ -484,13 +477,6 @@ The range must be considered.</p>
<p>A color defined by the color definitions below.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-default.range.-name.action">
<span class="sig-name descname"><span class="pre">default.range.$name.action</span></span><a class="headerlink" href="#confval-default.range.-name.action" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>Possible values: enableStream, disableStream</p>
</dd></dl>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p><strong>availability.*</strong>
@ -541,13 +527,6 @@ value until updated.</p>
<p>Activate to display absolute values (modulus).</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-availability.action">
<span class="sig-name descname"><span class="pre">availability.action</span></span><a class="headerlink" href="#confval-availability.action" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>Possible values: enableStream, disableStream</p>
</dd></dl>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p><strong>availability.range.*</strong>
@ -606,13 +585,6 @@ The range must be considered.</p>
<p>A color defined by the color definitions below.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-availability.range.-name.action">
<span class="sig-name descname"><span class="pre">availability.range.$name.action</span></span><a class="headerlink" href="#confval-availability.range.-name.action" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>Possible values: enableStream, disableStream</p>
</dd></dl>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p><strong>delay.*</strong>
@ -662,13 +634,6 @@ value until updated.</p>
<p>Activate to display absolute values (modulus).</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-delay.action">
<span class="sig-name descname"><span class="pre">delay.action</span></span><a class="headerlink" href="#confval-delay.action" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>Possible values: enableStream, disableStream</p>
</dd></dl>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p><strong>delay.range.*</strong>
@ -727,13 +692,6 @@ The range must be considered.</p>
<p>A color defined by the color definitions below.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-delay.range.-name.action">
<span class="sig-name descname"><span class="pre">delay.range.$name.action</span></span><a class="headerlink" href="#confval-delay.range.-name.action" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>Possible values: enableStream, disableStream</p>
</dd></dl>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p><strong>gap.*</strong>
@ -784,13 +742,6 @@ value until updated.</p>
<p>Activate to display absolute values (modulus).</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-gap.action">
<span class="sig-name descname"><span class="pre">gap.action</span></span><a class="headerlink" href="#confval-gap.action" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>Possible values: enableStream, disableStream</p>
</dd></dl>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p><strong>gap.range.*</strong>
@ -849,13 +800,6 @@ The range must be considered.</p>
<p>A color defined by the color definitions below.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-gap.range.-name.action">
<span class="sig-name descname"><span class="pre">gap.range.$name.action</span></span><a class="headerlink" href="#confval-gap.range.-name.action" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>Possible values: enableStream, disableStream</p>
</dd></dl>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p><strong>gapLength.*</strong>
@ -906,13 +850,6 @@ value until updated.</p>
<p>Activate to display absolute values (modulus).</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-gapLength.action">
<span class="sig-name descname"><span class="pre">gapLength.action</span></span><a class="headerlink" href="#confval-gapLength.action" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>Possible values: enableStream, disableStream.</p>
</dd></dl>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p><strong>gapLength.range.*</strong>
@ -971,13 +908,6 @@ The range must be considered.</p>
<p>A color defined by the color definitions below.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-gapLength.range.-name.action">
<span class="sig-name descname"><span class="pre">gapLength.range.$name.action</span></span><a class="headerlink" href="#confval-gapLength.range.-name.action" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>Possible values: enableStream, disableStream</p>
</dd></dl>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p><strong>gapInterval.*</strong>
@ -1027,13 +957,6 @@ updated.</p>
<p>Activate to display absolute values (modulus).</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-gapInterval.action">
<span class="sig-name descname"><span class="pre">gapInterval.action</span></span><a class="headerlink" href="#confval-gapInterval.action" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>Possible values: enableStream, disableStream</p>
</dd></dl>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p><strong>gapInterval.range.*</strong>
@ -1092,13 +1015,6 @@ The range must be considered.</p>
<p>A color defined by the color definitions below.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-gapInterval.range.-name.action">
<span class="sig-name descname"><span class="pre">gapInterval.range.$name.action</span></span><a class="headerlink" href="#confval-gapInterval.range.-name.action" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>Possible values: enableStream, disableStream</p>
</dd></dl>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p><strong>latency.*</strong>
@ -1148,13 +1064,6 @@ updated.</p>
<p>Activate to display absolute values (modulus).</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-latency.action">
<span class="sig-name descname"><span class="pre">latency.action</span></span><a class="headerlink" href="#confval-latency.action" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>Possible values: enableStream, disableStream</p>
</dd></dl>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p><strong>latency.range.*</strong>
@ -1213,13 +1122,6 @@ The range must be considered.</p>
<p>A color defined by the color definitions below.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-latency.range.-name.action">
<span class="sig-name descname"><span class="pre">latency.range.$name.action</span></span><a class="headerlink" href="#confval-latency.range.-name.action" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>Possible values: enableStream, disableStream</p>
</dd></dl>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p><strong>offset.*</strong>
@ -1270,13 +1172,6 @@ updated.</p>
<p>Activate to display absolute values (modulus).</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-offset.action">
<span class="sig-name descname"><span class="pre">offset.action</span></span><a class="headerlink" href="#confval-offset.action" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>Possible values: enableStream, disableStream</p>
</dd></dl>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p><strong>offset.range.*</strong>
@ -1335,13 +1230,6 @@ The range must be considered.</p>
<p>A color defined by the color definitions below.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-offset.range.-name.action">
<span class="sig-name descname"><span class="pre">offset.range.$name.action</span></span><a class="headerlink" href="#confval-offset.range.-name.action" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>Possible values: enableStream, disableStream</p>
</dd></dl>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p><strong>overlap.*</strong>
@ -1391,13 +1279,6 @@ updated.</p>
<p>Activate to display absolute values (modulus).</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-overlap.action">
<span class="sig-name descname"><span class="pre">overlap.action</span></span><a class="headerlink" href="#confval-overlap.action" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>Possible values: enableStream, disableStream</p>
</dd></dl>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p><strong>overlap.range.*</strong>
@ -1456,13 +1337,6 @@ The range must be considered.</p>
<p>A color defined by the color definitions below.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-overlap.range.-name.action">
<span class="sig-name descname"><span class="pre">overlap.range.$name.action</span></span><a class="headerlink" href="#confval-overlap.range.-name.action" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>Possible values: enableStream, disableStream</p>
</dd></dl>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p><strong>overlapInterval.*</strong>
@ -1512,13 +1386,6 @@ value until updated.</p>
<p>Activate to display absolute values (modulus).</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-overlapInterval.action">
<span class="sig-name descname"><span class="pre">overlapInterval.action</span></span><a class="headerlink" href="#confval-overlapInterval.action" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>Possible values: enableStream, disableStream</p>
</dd></dl>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p><strong>overlapInterval.range.*</strong>
@ -1577,13 +1444,6 @@ The range must be considered.</p>
<p>A color defined by the color definitions below.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-overlapInterval.range.-name.action">
<span class="sig-name descname"><span class="pre">overlapInterval.range.$name.action</span></span><a class="headerlink" href="#confval-overlapInterval.range.-name.action" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>Possible values: enableStream, disableStream</p>
</dd></dl>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p><strong>overlapLength.*</strong>
@ -1634,13 +1494,6 @@ value until updated.</p>
<p>Activate to display absolute values (modulus).</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-overlapLength.action">
<span class="sig-name descname"><span class="pre">overlapLength.action</span></span><a class="headerlink" href="#confval-overlapLength.action" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>Possible values: enableStream, disableStream</p>
</dd></dl>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p><strong>overlapLength.range.*</strong>
@ -1699,13 +1552,6 @@ The range must be considered.</p>
<p>A color defined by the color definitions below.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-overlapLength.range.-name.action">
<span class="sig-name descname"><span class="pre">overlapLength.range.$name.action</span></span><a class="headerlink" href="#confval-overlapLength.range.-name.action" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>Possible values: enableStream, disableStream</p>
</dd></dl>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p><strong>rms.*</strong>
@ -1755,13 +1601,6 @@ value until updated.</p>
<p>Activate to display absolute values (modulus).</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-rms.action">
<span class="sig-name descname"><span class="pre">rms.action</span></span><a class="headerlink" href="#confval-rms.action" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>Possible values: enableStream, disableStream</p>
</dd></dl>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p><strong>rms.range.*</strong>
@ -1820,13 +1659,6 @@ The range must be considered.</p>
<p>A color defined by the color definitions below.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-rms.range.-name.action">
<span class="sig-name descname"><span class="pre">rms.range.$name.action</span></span><a class="headerlink" href="#confval-rms.range.-name.action" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>Possible values: enableStream, disableStream</p>
</dd></dl>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p><strong>spike.*</strong>
@ -1877,13 +1709,6 @@ value until updated.</p>
<p>Activate to display absolute values (modulus).</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-spike.action">
<span class="sig-name descname"><span class="pre">spike.action</span></span><a class="headerlink" href="#confval-spike.action" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>Possible values: enableStream, disableStream</p>
</dd></dl>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p><strong>spike.range.*</strong>
@ -1942,13 +1767,6 @@ The range must be considered.</p>
<p>A color defined by the color definitions below.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-spike.range.-name.action">
<span class="sig-name descname"><span class="pre">spike.range.$name.action</span></span><a class="headerlink" href="#confval-spike.range.-name.action" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>Possible values: enableStream, disableStream</p>
</dd></dl>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p><strong>spikeAmplitude.*</strong>
@ -1999,13 +1817,6 @@ value until updated.</p>
<p>Activate to display absolute values (modulus).</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-spikeAmplitude.action">
<span class="sig-name descname"><span class="pre">spikeAmplitude.action</span></span><a class="headerlink" href="#confval-spikeAmplitude.action" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>Possible values: enableStream, disableStream</p>
</dd></dl>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p><strong>spikeAmplitude.range.*</strong>
@ -2064,13 +1875,6 @@ The range must be considered.</p>
<p>A color defined by the color definitions below.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-spikeAmplitude.range.-name.action">
<span class="sig-name descname"><span class="pre">spikeAmplitude.range.$name.action</span></span><a class="headerlink" href="#confval-spikeAmplitude.range.-name.action" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>Possible values: enableStream, disableStream</p>
</dd></dl>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p><strong>spikeInterval.*</strong>
@ -2121,13 +1925,6 @@ value until updated.</p>
<p>Activate to display absolute values (modulus).</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-spikeInterval.action">
<span class="sig-name descname"><span class="pre">spikeInterval.action</span></span><a class="headerlink" href="#confval-spikeInterval.action" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>Possible values: enableStream, disableStream</p>
</dd></dl>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p><strong>spikeInterval.range.*</strong>
@ -2186,13 +1983,6 @@ The range must be considered.</p>
<p>A color defined by the color definitions below.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-spikeInterval.range.-name.action">
<span class="sig-name descname"><span class="pre">spikeInterval.range.$name.action</span></span><a class="headerlink" href="#confval-spikeInterval.range.-name.action" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>Possible values: enableStream, disableStream</p>
</dd></dl>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p><strong>timing.*</strong>
@ -2243,13 +2033,6 @@ value until updated.</p>
<p>Activate to display absolute values (modulus).</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-timing.action">
<span class="sig-name descname"><span class="pre">timing.action</span></span><a class="headerlink" href="#confval-timing.action" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>Possible values: enableStream, disableStream</p>
</dd></dl>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p><strong>timing.range.*</strong>
@ -2308,13 +2091,6 @@ The range must be considered.</p>
<p>A color defined by the color definitions below.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-timing.range.-name.action">
<span class="sig-name descname"><span class="pre">timing.range.$name.action</span></span><a class="headerlink" href="#confval-timing.range.-name.action" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>Possible values: enableStream, disableStream</p>
</dd></dl>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p><strong>range.*</strong>
@ -2477,13 +2253,6 @@ The range must be considered. The count is also set in
<p>A color defined by the color definitions below.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-range.-name.action">
<span class="sig-name descname"><span class="pre">range.$name.action</span></span><a class="headerlink" href="#confval-range.-name.action" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>Possible values: enableStream, disableStream</p>
</dd></dl>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p><strong>color.*</strong>
@ -2807,12 +2576,14 @@ This option can be given more than once.</p>
<dt class="sig sig-object std" id="cmdoption-scqcv-content-type">
<span class="sig-name descname"><span class="pre">--content-type</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scqcv-content-type" title="Permalink to this definition"></a></dt>
<dd><p>Overrides configuration parameter <a class="reference internal" href="global.html#confval-connection.contentType"><code class="xref std std-confval docutils literal notranslate"><span class="pre">connection.contentType</span></code></a>.</p>
<p>Default: <code class="docutils literal notranslate"><span class="pre">binary</span></code></p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scqcv-start-stop-msg">
<span class="sig-name descname"><span class="pre">--start-stop-msg</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scqcv-start-stop-msg" title="Permalink to this definition"></a></dt>
<dd><p>Set sending of a start and a stop message.</p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">0</span></code></p>
<p>Set sending of a start and a stop message.</p>
</dd></dl>
</section>
@ -2864,12 +2635,12 @@ can be queried with &quot;--db-driver-list&quot;.</p>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scqcv-I">
<span id="cmdoption-scqcv-record-url"></span><span class="sig-name descname"><span class="pre">-I</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">--record-url</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scqcv-I" title="Permalink to this definition"></a></dt>
<dd><p>The recordstream source URL, format:
<dd><p>The RecordStream source URL. Format:
[<a class="reference external" href="service://">service://</a>]location[#type].
&quot;service&quot; is the name of the recordstream driver
&quot;service&quot; is the name of the RecordStream driver
which can be queried with &quot;--record-driver-list&quot;.
If &quot;service&quot; is not given, &quot;<a class="reference external" href="file://">file://</a>&quot; is
used.</p>
used and simply the name of a miniSEED file can be given.</p>
</dd></dl>
<dl class="std option">
@ -2890,7 +2661,9 @@ used.</p>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scqcv-city-xml">
<span class="sig-name descname"><span class="pre">--city-xml</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scqcv-city-xml" title="Permalink to this definition"></a></dt>
<dd><p>The path to the cities XML file. This overrides the default
<dd><p>Type: <em>file</em></p>
<p>Values: <code class="docutils literal notranslate"><span class="pre">*.xml</span></code></p>
<p>The path to the cities XML file. This overrides the default
paths. Compare with the global parameter &quot;citiesXML&quot;.</p>
</dd></dl>
@ -2993,7 +2766,7 @@ GUI applications.</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>scquery &#8212; SeisComP Release documentation</title>
<title>scquery &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -479,7 +479,7 @@ pre-defined by configuration.</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>scqueryqc &#8212; SeisComP Release documentation</title>
<title>scqueryqc &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -404,7 +404,7 @@ Defaults are used if parameter is undefined.</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>screloc &#8212; SeisComP Release documentation</title>
<title>screloc &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -164,24 +164,35 @@ NonLinLoc.profile.global.controlFile<span class="w"> </span><span class="o">=</s
<section id="examples">
<span id="screloc-example"></span><h2>Examples<a class="headerlink" href="#examples" title="Permalink to this heading"></a></h2>
<ul>
<li><p>Run screloc to with a specific velocity model given in a profile by <a class="reference internal" href="global_nonlinloc.html#global-nonlinloc"><span class="std std-ref">NonLinLoc</span></a>.
Use a specific userID and authorID for uniquely recognizing the relocation.
Changing the priority in <a class="reference internal" href="scevent.html#scevent"><span class="std std-ref">scevent</span></a> before running the example, e.g. to
TIME_AUTOMATIC, sets the latest origin (which will be created by screloc) to preferred.</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="c1"># set specific velocity profile defined for NonLinLoc</span>
<span class="nv">profile</span><span class="o">=</span>&lt;your_profile&gt;
<span class="c1"># set userID</span>
<span class="nv">userID</span><span class="o">=</span><span class="s2">&quot;&lt;your_user&gt;&quot;</span>
<span class="c1"># set authorID</span>
<span class="nv">authorID</span><span class="o">=</span><span class="s2">&quot;&lt;screloc&gt;&quot;</span>
<li><p>Relocate all origins given in an <a class="reference internal" href="../base/glossary.html#term-SCML"><span class="xref std std-term">SCML</span></a> file according to the
configuration of <strong class="program">screloc</strong>. Write all output to unformatted SCML.</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>screloc<span class="w"> </span>-d<span class="w"> </span>localhost<span class="w"> </span>--ep<span class="w"> </span>origins.xml<span class="w"> </span>&gt;<span class="w"> </span>origins_screloc.xml
</pre></div>
</div>
</li>
<li><p>Relocate the previously preferred origins of all events (<a class="reference internal" href="scevtls.html#scevtls"><span class="std std-ref">scevtls</span></a>)
within some period of time using a specific <a class="reference internal" href="../base/concepts/locators.html#concepts-locators"><span class="std std-ref">locator</span></a>
and locator profile.
Use some userID and authorID for uniquely recognizing the relocation.
Configuring the ref:<cite>scevent</cite> parameter <a class="reference internal" href="scevent.html#confval-eventAssociation.priorities"><code class="xref std std-confval docutils literal notranslate"><span class="pre">eventAssociation.priorities</span></code></a>
to TIME_AUTOMATIC before running the example will prefer the latest origin
(which will be created by screloc) for the event the new origin is associated
to. The new origins are automatically sent to the messaging.</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="ch">#!/bin/bash</span>
<span class="k">for</span><span class="w"> </span>i<span class="w"> </span><span class="k">in</span><span class="w"> </span><span class="sb">`</span>scevtls<span class="w"> </span>-d<span class="w"> </span>mysql://sysop:sysop@localhost/seiscomp<span class="w"> </span>--begin<span class="w"> </span><span class="s1">&#39;2015-01-01 00:00:00&#39;</span><span class="w"> </span>--end<span class="w"> </span><span class="s1">&#39;2015-02-01 00:00:00&#39;</span><span class="sb">`</span><span class="p">;</span><span class="w"> </span><span class="k">do</span>
<span class="w"> </span><span class="nv">orgID</span><span class="o">=</span><span class="sb">`</span><span class="nb">echo</span><span class="w"> </span><span class="s2">&quot;select preferredOriginID from Event,PublicObject where Event._oid=PublicObject._oid and PublicObject.publicID=&#39;</span><span class="nv">$i</span><span class="s2">&#39;&quot;</span><span class="w"> </span><span class="p">|</span><span class="se">\</span>
<span class="w"> </span>mysql<span class="w"> </span>-u<span class="w"> </span>sysop<span class="w"> </span>-p<span class="w"> </span>sysop<span class="w"> </span>-D<span class="w"> </span>seiscomp<span class="w"> </span>-h<span class="w"> </span>localhost<span class="w"> </span>-N<span class="sb">`</span>
<span class="w"> </span>screloc<span class="w"> </span>-O<span class="w"> </span><span class="nv">$orgID</span><span class="w"> </span>-d<span class="w"> </span>localhost<span class="w"> </span>--locator<span class="w"> </span>NonLinLoc<span class="w"> </span>--profile<span class="w"> </span><span class="nv">$profile</span><span class="w"> </span>-u<span class="w"> </span><span class="nv">$userID</span><span class="w"> </span>--debug<span class="w"> </span>--author<span class="o">=</span><span class="nv">$authorID</span>
<span class="c1"># locator type</span>
<span class="nv">locator</span><span class="o">=[</span>your_locator<span class="o">]</span>
<span class="c1"># locator profile</span>
<span class="nv">profile</span><span class="o">=[</span>your_profile<span class="o">]</span>
<span class="c1"># set some userID</span>
<span class="nv">userID</span><span class="o">=[</span>your_user<span class="o">]</span>
<span class="c1"># set some authorID</span>
<span class="nv">authorID</span><span class="o">=[</span>screloc<span class="o">]</span>
<span class="nv">IFS</span><span class="o">=</span><span class="s1">&#39;,&#39;</span><span class="w"> </span><span class="nb">read</span><span class="w"> </span>-ra<span class="w"> </span>events<span class="w"> </span><span class="o">&lt;&lt;&lt;</span><span class="w"> </span><span class="sb">`</span>scevtls<span class="w"> </span>-d<span class="w"> </span>localhost<span class="w"> </span>-p<span class="w"> </span>-D<span class="w"> </span>,<span class="w"> </span>--begin<span class="w"> </span><span class="m">2025</span>-01-01<span class="w"> </span>--end<span class="w"> </span><span class="m">2025</span>-02-01<span class="sb">`</span>
<span class="k">for</span><span class="w"> </span>event<span class="w"> </span><span class="k">in</span><span class="w"> </span><span class="s2">&quot;</span><span class="si">${</span><span class="nv">events</span><span class="p">[@]</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">;</span><span class="w"> </span><span class="k">do</span>
<span class="w"> </span><span class="nv">preferredOrigin</span><span class="o">=</span><span class="k">$(</span><span class="nb">echo</span><span class="w"> </span><span class="nv">$event</span><span class="w"> </span><span class="p">|</span><span class="w"> </span>awk<span class="w"> </span><span class="s1">&#39;{print $2}&#39;</span><span class="k">)</span>
<span class="w"> </span>screloc<span class="w"> </span>-d<span class="w"> </span>localhost<span class="w"> </span>-O<span class="w"> </span><span class="nv">$preferredOrigin</span><span class="w"> </span>--locator<span class="w"> </span><span class="nv">$locator</span><span class="w"> </span>--profile<span class="w"> </span><span class="nv">$profile</span><span class="w"> </span>-u<span class="w"> </span><span class="nv">$userID</span><span class="w"> </span>--author<span class="o">=</span><span class="nv">$authorID</span>
<span class="k">done</span>
</pre></div>
</div>
@ -293,6 +304,25 @@ However, new publicIDs are unrelated to the time of creation.
If not defined, a new publicID will be generated automatically.</p>
</dd></dl>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p><strong>picks.*</strong>
<em>Parameters specific to picks.</em></p>
</div>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-picks.streamsSetUnused">
<span class="sig-name descname"><span class="pre">picks.streamsSetUnused</span></span><a class="headerlink" href="#confval-picks.streamsSetUnused" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>list:string</em></p>
<p>List of streams from which picks are set to unsed by their
referencing arrivals before locating. The concerned arrivals
are kept but the picks will not be used for locating.
Streams take the format NET.STA.LOC.CHA. Wildcards * and ?
are supported.</p>
<p>Example:</p>
<p>GE.MOX.*.HH? : All arrivals on any HH stream of station MOX
will be kept but not used for locating.</p>
</dd></dl>
</section>
<section id="command-line-options">
<h2>Command-Line Options<a class="headerlink" href="#command-line-options" title="Permalink to this heading"></a></h2>
@ -459,12 +489,14 @@ This option can be given more than once.</p>
<dt class="sig sig-object std" id="cmdoption-screloc-content-type">
<span class="sig-name descname"><span class="pre">--content-type</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-screloc-content-type" title="Permalink to this definition"></a></dt>
<dd><p>Overrides configuration parameter <a class="reference internal" href="global.html#confval-connection.contentType"><code class="xref std std-confval docutils literal notranslate"><span class="pre">connection.contentType</span></code></a>.</p>
<p>Default: <code class="docutils literal notranslate"><span class="pre">binary</span></code></p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-screloc-start-stop-msg">
<span class="sig-name descname"><span class="pre">--start-stop-msg</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-screloc-start-stop-msg" title="Permalink to this definition"></a></dt>
<dd><p>Set sending of a start and a stop message.</p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">0</span></code></p>
<p>Set sending of a start and a stop message.</p>
</dd></dl>
</section>
@ -507,46 +539,65 @@ can be queried with &quot;--db-driver-list&quot;.</p>
</section>
<section id="mode">
<h3>Mode<a class="headerlink" href="#mode" title="Permalink to this heading"></a></h3>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-screloc-dump">
<span class="sig-name descname"><span class="pre">--dump</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-screloc-dump" title="Permalink to this definition"></a></dt>
<dd><p>Dump processed origins as XML to stdout. Use in combination
with -O.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-screloc-test">
<span class="sig-name descname"><span class="pre">--test</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-screloc-test" title="Permalink to this definition"></a></dt>
<dd><p>Test mode, do not send any message</p>
<dd><p>Test mode, do not send any message.</p>
</dd></dl>
</section>
<section id="input">
<h3>Input<a class="headerlink" href="#input" title="Permalink to this heading"></a></h3>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-screloc-O">
<span id="cmdoption-screloc-origin-id"></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-id</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-screloc-O" title="Permalink to this definition"></a></dt>
<dd><p>Reprocess the origin and send a message unless test mode is activated</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-screloc-locator">
<span class="sig-name descname"><span class="pre">--locator</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-screloc-locator" title="Permalink to this definition"></a></dt>
<dd><p>The locator type to use</p>
<dd><p>Overrides configuration parameter <a class="reference internal" href="#confval-reloc.locator"><code class="xref std std-confval docutils literal notranslate"><span class="pre">reloc.locator</span></code></a>.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-screloc-use-weight">
<span class="sig-name descname"><span class="pre">--use-weight</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-screloc-use-weight" title="Permalink to this definition"></a></dt>
<dd><p>Use current picks weight</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-screloc-evaluation-mode">
<span class="sig-name descname"><span class="pre">--evaluation-mode</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-screloc-evaluation-mode" title="Permalink to this definition"></a></dt>
<dd><p>set origin evaluation mode: &quot;AUTOMATIC&quot; or &quot;MANUAL&quot;</p>
<dt class="sig sig-object std" id="cmdoption-screloc-profile">
<span class="sig-name descname"><span class="pre">--profile</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-screloc-profile" title="Permalink to this definition"></a></dt>
<dd><p>Overrides configuration parameter <a class="reference internal" href="#confval-reloc.profile"><code class="xref std std-confval docutils literal notranslate"><span class="pre">reloc.profile</span></code></a>.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-screloc-ep">
<span class="sig-name descname"><span class="pre">--ep</span></span><span class="sig-prename descclassname"> <span class="pre">file</span></span><a class="headerlink" href="#cmdoption-screloc-ep" title="Permalink to this definition"></a></dt>
<dd><p>Defines an event parameters XML file to be read and processed. This
implies offline mode and only processes all origins contained
in that file. Each relocated origin is appended to the list
of origins unless --replace is given.</p>
<span class="sig-name descname"><span class="pre">--ep</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-screloc-ep" title="Permalink to this definition"></a></dt>
<dd><p>Event parameters XML file for offline processing of all
contained origins. This option should not be mixed with
--dump.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-screloc-O">
<span id="cmdoption-screloc-origin-id"></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-id</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-screloc-O" title="Permalink to this definition"></a></dt>
<dd><p>Reprocess the origin and send a message unless test mode is
activated.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-screloc-use-weight">
<span class="sig-name descname"><span class="pre">--use-weight</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-screloc-use-weight" title="Permalink to this definition"></a></dt>
<dd><p>Overrides configuration parameter <a class="reference internal" href="#confval-reloc.useWeight"><code class="xref std std-confval docutils literal notranslate"><span class="pre">reloc.useWeight</span></code></a>.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-screloc-streams-set-unused">
<span class="sig-name descname"><span class="pre">--streams-set-unused</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-screloc-streams-set-unused" title="Permalink to this definition"></a></dt>
<dd><p>Overrides configuration parameter <a class="reference internal" href="#confval-picks.streamsSetUnused"><code class="xref std std-confval docutils literal notranslate"><span class="pre">picks.streamsSetUnused</span></code></a>.</p>
<p>Type: <em>list:string</em></p>
<p>List of streams from which picks are set to unsed by their
referencing arrivals before locating. The concerned arrivals
are kept but the picks will not be used for locating.
Streams take the format NET.STA.LOC.CHA. Wildcards * and ?
are supported.</p>
</dd></dl>
<dl class="std option">
@ -558,6 +609,28 @@ of relocation. In other words: two LocSAT origins in, two
NonLinLoc origins out. All other objects are passed through.</p>
</dd></dl>
</section>
<section id="output">
<h3>Output<a class="headerlink" href="#output" title="Permalink to this heading"></a></h3>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-screloc-evaluation-mode">
<span class="sig-name descname"><span class="pre">--evaluation-mode</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-screloc-evaluation-mode" title="Permalink to this definition"></a></dt>
<dd><p>Evaluation mode of the new origin (AUTOMATIC or MANUAL).</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-screloc-f">
<span id="cmdoption-screloc-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-screloc-f" title="Permalink to this definition"></a></dt>
<dd><p>Use formatted XML output. Otherwise XML is unformatted.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-screloc-origin-id-suffix">
<span class="sig-name descname"><span class="pre">--origin-id-suffix</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-screloc-origin-id-suffix" title="Permalink to this definition"></a></dt>
<dd><p>Create origin ID from that of the input origin plus the
specfied suffix.</p>
</dd></dl>
</section>
<section id="profiling">
<h3>Profiling<a class="headerlink" href="#profiling" title="Permalink to this heading"></a></h3>
@ -570,7 +643,9 @@ NonLinLoc origins out. All other objects are passed through.</p>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-screloc-repeated-relocations">
<span class="sig-name descname"><span class="pre">--repeated-relocations</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-screloc-repeated-relocations" title="Permalink to this definition"></a></dt>
<dd><p>improve measurement of relocation time by running each relocation multiple times. Specify the number of relocations, e.g. 100.</p>
<dd><p>Improve measurement of relocation time by running each
relocation multiple times. Specify the number of relocations,
e.g. 100.</p>
</dd></dl>
</section>
@ -609,6 +684,7 @@ NonLinLoc origins out. All other objects are passed through.</p>
<li><a class="reference internal" href="#database">Database</a></li>
<li><a class="reference internal" href="#mode">Mode</a></li>
<li><a class="reference internal" href="#input">Input</a></li>
<li><a class="reference internal" href="#output">Output</a></li>
<li><a class="reference internal" href="#profiling">Profiling</a></li>
</ul>
</li>
@ -646,7 +722,7 @@ NonLinLoc origins out. All other objects are passed through.</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>screpick &#8212; SeisComP Release documentation</title>
<title>screpick &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,12 +12,12 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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="scwfparam" href="scwfparam.html" />
<link rel="next" title="scsmdump" href="scsmdump.html" />
<link rel="prev" title="screloc" href="screloc.html" />
</head>
<body>
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -43,7 +43,7 @@
</a>
</li>
<li class="right">
<a href="scwfparam.html" title="scwfparam"
<a href="scsmdump.html" title="scsmdump"
accesskey="N">
next
</a>
@ -280,12 +280,12 @@ can be queried with &quot;--db-driver-list&quot;.</p>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-screpick-I">
<span id="cmdoption-screpick-record-url"></span><span class="sig-name descname"><span class="pre">-I</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">--record-url</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-screpick-I" title="Permalink to this definition"></a></dt>
<dd><p>The recordstream source URL, format:
<dd><p>The RecordStream source URL. Format:
[<a class="reference external" href="service://">service://</a>]location[#type].
&quot;service&quot; is the name of the recordstream driver
&quot;service&quot; is the name of the RecordStream driver
which can be queried with &quot;--record-driver-list&quot;.
If &quot;service&quot; is not given, &quot;<a class="reference external" href="file://">file://</a>&quot; is
used.</p>
used and simply the name of a miniSEED file can be given.</p>
</dd></dl>
<dl class="std option">
@ -307,7 +307,7 @@ used.</p>
<dt class="sig sig-object std" id="cmdoption-screpick-ep">
<span class="sig-name descname"><span class="pre">--ep</span></span><span class="sig-prename descclassname"> <span class="pre">file</span></span><a class="headerlink" href="#cmdoption-screpick-ep" title="Permalink to this definition"></a></dt>
<dd><p>Name of input XML file (SCML) with all picks for offline
processing.</p>
processing. Use - to read from stdin.</p>
</dd></dl>
</section>
@ -326,6 +326,16 @@ the common libraries or loaded as plugin.</p>
<dd><p>Accept any pick regardless of its phase hint.</p>
</dd></dl>
</section>
<section id="output">
<h3>Output<a class="headerlink" href="#output" title="Permalink to this heading"></a></h3>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-screpick-f">
<span id="cmdoption-screpick-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-screpick-f" title="Permalink to this definition"></a></dt>
<dd><p>Use formatted XML output along with --ep. Otherwise XML
is unformatted.</p>
</dd></dl>
</section>
</section>
</section>
@ -359,6 +369,7 @@ the common libraries or loaded as plugin.</p>
<li><a class="reference internal" href="#records">Records</a></li>
<li><a class="reference internal" href="#input">Input</a></li>
<li><a class="reference internal" href="#picker">Picker</a></li>
<li><a class="reference internal" href="#output">Output</a></li>
</ul>
</li>
</ul>
@ -373,8 +384,8 @@ the common libraries or loaded as plugin.</p>
</div>
<div>
<h4>Next topic</h4>
<p class="topless"><a href="scwfparam.html"
title="next chapter">scwfparam</a></p>
<p class="topless"><a href="scsmdump.html"
title="next chapter">scsmdump</a></p>
</div>
<div role="note" aria-label="source link">
<h3>This Page</h3>
@ -395,7 +406,7 @@ the common libraries or loaded as plugin.</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>scrttv &#8212; SeisComP Release documentation</title>
<title>scrttv &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -140,7 +140,7 @@ default definition (<a class="reference internal" href="#confval-streams.codes">
</ul>
</li>
</ul>
<p>More parameters are available on the command-line:</p>
<p>More options are available on the command-line:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>scrttv<span class="w"> </span>-h
</pre></div>
</div>
@ -474,6 +474,45 @@ will not store the origin in the database and works the same way as creating
</section>
</section>
</section>
<section id="applications">
<span id="scrttv-applications"></span><h2>Applications<a class="headerlink" href="#applications" title="Permalink to this heading"></a></h2>
<ol class="arabic">
<li><p>View waveforms with default settings printing debug information</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>scrttv<span class="w"> </span>--debug
</pre></div>
</div>
</li>
<li><p>View 3C data from default recordstream 3 hours before midnight. All available
picks are displayed.</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>scrttv<span class="w"> </span>--buffer-size<span class="w"> </span><span class="m">10800</span><span class="w"> </span>--end-time<span class="w"> </span><span class="m">2022</span>-06-01<span class="w"> </span>--map-picks
</pre></div>
</div>
</li>
<li><p>View data from a miniSEED file in offline mode without messaging</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>scrttv<span class="w"> </span>file.mseed
</pre></div>
</div>
</li>
<li><p>View all HH streams from stations CX.PB01 and CX.PB02 without messaging and
inventory</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>scrttv<span class="w"> </span>--offline<span class="w"> </span>--no-inventory<span class="w"> </span>--channels<span class="w"> </span>CX.PB01.*.HH?<span class="w"> </span>--channels<span class="w"> </span>CX.PB02.*.HH?
</pre></div>
</div>
</li>
<li><p>View the miniSEED data from all file ending with .mseed which are read from
stdin</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>cat<span class="w"> </span>*.mseed<span class="w"> </span><span class="p">|</span><span class="w"> </span>scrttv<span class="w"> </span>-
</pre></div>
</div>
</li>
<li><p>View miniSEED data played back from archive at normal speed as in real time
using <a class="reference internal" href="scart.html#scart"><span class="std std-ref">scart</span></a></p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>scart<span class="w"> </span>-dmv<span class="w"> </span>-t<span class="w"> </span><span class="m">2026</span>-05-01~2026-05-02<span class="w"> </span>/archive<span class="w"> </span><span class="p">|</span><span class="w"> </span>scrttv<span class="w"> </span>-I<span class="w"> </span>-<span class="w"> </span>--offline<span class="w"> </span>--no-inventory
</pre></div>
</div>
</li>
</ol>
</section>
<section id="hotkeys">
<span id="scrttv-hot-keys"></span><h2>Hotkeys<a class="headerlink" href="#hotkeys" title="Permalink to this heading"></a></h2>
<table class="docutils align-default">
@ -700,7 +739,7 @@ This parameter exists mainly for backward compatibility.</p>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-filters">
<span class="sig-name descname"><span class="pre">filters</span></span><a class="headerlink" href="#confval-filters" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">&quot;RMHP(2)&gt;&gt;ITAPER(5)&gt;&gt;BW(3,0.5,8.0)&quot;,&quot;RMHP(2)&gt;&gt;ITAPER(5)&gt;&gt;BW_HP(3,</span> <span class="pre">3)&quot;</span></code></p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">&quot;BW</span> <span class="pre">0.5</span> <span class="pre">-</span> <span class="pre">8.0</span> <span class="pre">Hz;RMHP(2)&gt;&gt;ITAPER(5)&gt;&gt;BW(3,</span> <span class="pre">0.5,</span> <span class="pre">8.0)&quot;,&quot;HP</span> <span class="pre">3.0</span> <span class="pre">Hz;RMHP(2)&gt;&gt;ITAPER(5)&gt;&gt;BW_HP(3,</span> <span class="pre">3)&quot;</span></code></p>
<p>Type: <em>list:string</em></p>
<p>Define a list of filters that is cycles through when pressing
G or D. Filtering is toggled with F.
@ -816,7 +855,7 @@ e.g. &quot;GE.MORC..BHZ&quot;.</p>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-streams.rows">
<span class="sig-name descname"><span class="pre">streams.rows</span></span><a class="headerlink" href="#confval-streams.rows" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>integer</em></p>
<dd><p>Type: <em>int</em></p>
<p>Number of rows to show at once in one windows. If more traces
than rows are loaded, the are accessible by a scroll bar.</p>
</dd></dl>
@ -847,8 +886,8 @@ profile section. Use comma separation for a list of profiles.</p>
<span class="sig-name descname"><span class="pre">streams.sort.mode</span></span><a class="headerlink" href="#confval-streams.sort.mode" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">distance</span></code></p>
<p>Type: <em>string</em></p>
<p>The sort mode applied initially. Allowed values
are: config, distance, station, network, group.</p>
<p>Values: <code class="docutils literal notranslate"><span class="pre">config,distance,station,network,group</span></code></p>
<p>The mode applied initially for sorting traces.</p>
</dd></dl>
<dl class="std confval">
@ -954,7 +993,8 @@ and all HH streams of PF.BON.00</p>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p><strong>streams.group.$name.pen.*</strong>
<em>Define the trace pen of the group.</em></p>
<em>Define the trace pen of the group. Read the SeisComP</em>
<em>GUI documenation for full details.</em></p>
</div>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-streams.group.-name.pen.color">
@ -988,11 +1028,10 @@ where the value range is scaled to [0,1].</p>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-streams.group.-name.pen.style">
<span class="sig-name descname"><span class="pre">streams.group.$name.pen.style</span></span><a class="headerlink" href="#confval-streams.group.-name.pen.style" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">SolidLine</span></code></p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">solidline</span></code></p>
<p>Type: <em>string</em></p>
<p>The style of the pen. Supported values are: NoPen,
SolidLine, DashLine, DotLine, DashDotLine,
DashDotDotLine.</p>
<p>Values: <code class="docutils literal notranslate"><span class="pre">nopen,solidline,dashline,dotline,dashdotline,dashdotdotline</span></code></p>
<p>The line style of the pen.</p>
</dd></dl>
<dl class="std confval">
@ -1001,7 +1040,7 @@ DashDotDotLine.</p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">1.0</span></code></p>
<p>Type: <em>double</em></p>
<p>Unit: <em>px</em></p>
<p>The width of the pen.</p>
<p>The line width of the pen.</p>
</dd></dl>
<div class="admonition note">
@ -1103,6 +1142,7 @@ showing trace amplitude value</p>
<span class="sig-name descname"><span class="pre">streams.profile.$name.minimum.pen.style</span></span><a class="headerlink" href="#confval-streams.profile.-name.minimum.pen.style" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">solidline</span></code></p>
<p>Type: <em>string</em></p>
<p>Values: <code class="docutils literal notranslate"><span class="pre">nopen,solidline,dashline,dotline,dashdotline,dashdotdotline</span></code></p>
</dd></dl>
<dl class="std confval">
@ -1115,13 +1155,15 @@ showing trace amplitude value</p>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p><strong>streams.profile.$name.minimum.brush.*</strong>
<em>Properties of the area below the minimum.</em></p>
<em>Properties of the area below the minimum. Read</em>
<em>the SeisComP GUI documenation for full details.</em></p>
</div>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-streams.profile.-name.minimum.brush.style">
<span class="sig-name descname"><span class="pre">streams.profile.$name.minimum.brush.style</span></span><a class="headerlink" href="#confval-streams.profile.-name.minimum.brush.style" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">nobrush</span></code></p>
<p>Type: <em>string</em></p>
<p>Values: <code class="docutils literal notranslate"><span class="pre">solid,dense1,dense2,dense3,dense4,dense5,dense6,dense7,nobrush,horizontal,vertical,cross,bdiag,fdiag,diagross</span></code></p>
</dd></dl>
<dl class="std confval">
@ -1147,7 +1189,8 @@ showing trace amplitude value</p>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p><strong>streams.profile.$name.maximum.pen.*</strong>
<em>Line properties.</em></p>
<em>Line properties. Read the SeisComP GUI</em>
<em>documenation for full details.</em></p>
</div>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-streams.profile.-name.maximum.pen.width">
@ -1161,6 +1204,7 @@ showing trace amplitude value</p>
<span class="sig-name descname"><span class="pre">streams.profile.$name.maximum.pen.style</span></span><a class="headerlink" href="#confval-streams.profile.-name.maximum.pen.style" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">solidline</span></code></p>
<p>Type: <em>string</em></p>
<p>Values: <code class="docutils literal notranslate"><span class="pre">nopen,solidline,dashline,dotline,dashdotline,dashdotdotline</span></code></p>
</dd></dl>
<dl class="std confval">
@ -1173,13 +1217,15 @@ showing trace amplitude value</p>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p><strong>streams.profile.$name.maximum.brush.*</strong>
<em>Properties of the area above the maximum.</em></p>
<em>Properties of the area above the maximum. Read</em>
<em>the SeisComP GUI documenation for full details.</em></p>
</div>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-streams.profile.-name.maximum.brush.style">
<span class="sig-name descname"><span class="pre">streams.profile.$name.maximum.brush.style</span></span><a class="headerlink" href="#confval-streams.profile.-name.maximum.brush.style" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">nobrush</span></code></p>
<p>Type: <em>string</em></p>
<p>Values: <code class="docutils literal notranslate"><span class="pre">solid,dense1,dense2,dense3,dense4,dense5,dense6,dense7,nobrush,horizontal,vertical,cross,bdiag,fdiag,diagross</span></code></p>
</dd></dl>
<dl class="std confval">
@ -1246,8 +1292,8 @@ dropdown list.</p>
<span class="sig-name descname"><span class="pre">spectrogram.normalization</span></span><a class="headerlink" href="#confval-spectrogram.normalization" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">fixed</span></code></p>
<p>Type: <em>string</em></p>
<p>Which amplitude normalization mode to use: &quot;fixed&quot;,
&quot;frequency&quot; or &quot;time&quot;.</p>
<p>Values: <code class="docutils literal notranslate"><span class="pre">fixed,frequency,time</span></code></p>
<p>The amplitude normalization mode to use.</p>
</dd></dl>
<dl class="std confval">
@ -1255,7 +1301,7 @@ dropdown list.</p>
<span class="sig-name descname"><span class="pre">spectrogram.axis</span></span><a class="headerlink" href="#confval-spectrogram.axis" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">false</span></code></p>
<p>Type: <em>boolean</em></p>
<p>Whether to show the frequency axis.</p>
<p>Show the frequency axis.</p>
</dd></dl>
<dl class="std confval">
@ -1493,12 +1539,14 @@ This option can be given more than once.</p>
<dt class="sig sig-object std" id="cmdoption-scrttv-content-type">
<span class="sig-name descname"><span class="pre">--content-type</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scrttv-content-type" title="Permalink to this definition"></a></dt>
<dd><p>Overrides configuration parameter <a class="reference internal" href="global.html#confval-connection.contentType"><code class="xref std std-confval docutils literal notranslate"><span class="pre">connection.contentType</span></code></a>.</p>
<p>Default: <code class="docutils literal notranslate"><span class="pre">binary</span></code></p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scrttv-start-stop-msg">
<span class="sig-name descname"><span class="pre">--start-stop-msg</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scrttv-start-stop-msg" title="Permalink to this definition"></a></dt>
<dd><p>Set sending of a start and a stop message.</p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">0</span></code></p>
<p>Set sending of a start and a stop message.</p>
</dd></dl>
</section>
@ -1550,12 +1598,12 @@ can be queried with &quot;--db-driver-list&quot;.</p>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scrttv-I">
<span id="cmdoption-scrttv-record-url"></span><span class="sig-name descname"><span class="pre">-I</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">--record-url</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scrttv-I" title="Permalink to this definition"></a></dt>
<dd><p>The recordstream source URL, format:
<dd><p>The RecordStream source URL. Format:
[<a class="reference external" href="service://">service://</a>]location[#type].
&quot;service&quot; is the name of the recordstream driver
&quot;service&quot; is the name of the RecordStream driver
which can be queried with &quot;--record-driver-list&quot;.
If &quot;service&quot; is not given, &quot;<a class="reference external" href="file://">file://</a>&quot; is
used.</p>
used and simply the name of a miniSEED file can be given.</p>
</dd></dl>
<dl class="std option">
@ -1652,10 +1700,11 @@ extraction.</p>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scrttv-channels">
<span class="sig-name descname"><span class="pre">--channels</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-scrttv-channels" title="Permalink to this definition"></a></dt>
<dd><p>Channel(s) to display. The channel code may contain wildcards
at any position but the support of wildcards depends on
RecordStream. Repeat the option for multiple
channel groups. Examples:</p>
<dd><p>Channel(s) to display. The corresponding rows are only shown
when data for the considered time window is available.</p>
<p>The channel code may contain wildcards at any position but
the support of wildcards depends on RecordStream.
Repeat the option for multiple channel groups. Examples:</p>
<p>default : all streams configured by global bindings.</p>
<p>GE.*.*.HH? : all HH channels of all stations from GE network.</p>
</dd></dl>
@ -1666,7 +1715,9 @@ channel groups. Examples:</p>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scrttv-city-xml">
<span class="sig-name descname"><span class="pre">--city-xml</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scrttv-city-xml" title="Permalink to this definition"></a></dt>
<dd><p>The path to the cities XML file. This overrides the default
<dd><p>Type: <em>file</em></p>
<p>Values: <code class="docutils literal notranslate"><span class="pre">*.xml</span></code></p>
<p>The path to the cities XML file. This overrides the default
paths. Compare with the global parameter &quot;citiesXML&quot;.</p>
</dd></dl>
@ -1740,6 +1791,7 @@ GUI applications.</p>
</li>
</ul>
</li>
<li><a class="reference internal" href="#applications">Applications</a></li>
<li><a class="reference internal" href="#hotkeys">Hotkeys</a></li>
<li><a class="reference internal" href="#module-configuration">Module Configuration</a></li>
<li><a class="reference internal" href="#command-line-options">Command-Line Options</a><ul>
@ -1788,7 +1840,7 @@ GUI applications.</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>scsendjournal &#8212; SeisComP Release documentation</title>
<title>scsendjournal &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -325,7 +325,8 @@ This option can be given more than once.</p>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scsendjournal-start-stop-msg">
<span class="sig-name descname"><span class="pre">--start-stop-msg</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scsendjournal-start-stop-msg" title="Permalink to this definition"></a></dt>
<dd><p>Set sending of a start and a stop message.</p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">0</span></code></p>
<p>Set sending of a start and a stop message.</p>
</dd></dl>
</section>
@ -410,7 +411,7 @@ This option can be given more than once.</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>scsendorigin &#8212; SeisComP Release documentation</title>
<title>scsendorigin &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -240,7 +240,8 @@ This option can be given more than once.</p>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scsendorigin-start-stop-msg">
<span class="sig-name descname"><span class="pre">--start-stop-msg</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scsendorigin-start-stop-msg" title="Permalink to this definition"></a></dt>
<dd><p>Set sending of a start and a stop message.</p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">0</span></code></p>
<p>Set sending of a start and a stop message.</p>
</dd></dl>
</section>
@ -324,7 +325,7 @@ This option can be given more than once.</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -0,0 +1,401 @@
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>scsmdump &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
<link rel="stylesheet" type="text/css" href="../_static/seiscomp.css?v=c6da7ce6" />
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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="scwfparam" href="scwfparam.html" />
<link rel="prev" title="screpick" href="screpick.html" />
</head>
<body>
<div class="header">
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
<div class="nav">
<div class="container">
<div class="content"><a class="pull-right" id="sidebar-toggle">TOC</a>
<div class="related" role="navigation" aria-label="related navigation">
<ul>
<li class="right">
<a href="../genindex.html" title="General Index"
accesskey="I">
index
</a>
</li>
<li class="right">
<a href="scwfparam.html" title="scwfparam"
accesskey="N">
next
</a>
</li>
<li class="right">
<a href="screpick.html" title="screpick"
accesskey="P">
previous
</a>
</li>
<li class="nav-item nav-item-0">
<a href="../index.html">Home</a>
</li>
<li class="nav-item nav-item-1">
<a href="../modules.html" >Modules</a>
</li>
<li class="nav-item nav-item-2">
<a href="../toc/processing.html" accesskey="U">Processing</a>
</li>
</ul>
</div>
</div>
</div>
</div>
<div class="container">
<div class="fitted content" id="anchors-container">
<div class="body" role="main">
<section id="scsmdump">
<span id="id1"></span><h1>scsmdump<a class="headerlink" href="#scsmdump" title="Permalink to this heading"></a></h1>
<p><strong>Strong motion parameters database dump.</strong></p>
<section id="description">
<h2>Description<a class="headerlink" href="#description" title="Permalink to this heading"></a></h2>
<p>scsmdump …</p>
</section>
<section id="module-configuration">
<span id="scsmdump-configuration"></span><h2>Module Configuration<a class="headerlink" href="#module-configuration" title="Permalink to this heading"></a></h2>
<div class="line-block">
<div class="line"><code class="file docutils literal notranslate"><span class="pre">etc/defaults/global.cfg</span></code></div>
<div class="line"><code class="file docutils literal notranslate"><span class="pre">etc/defaults/scsmdump.cfg</span></code></div>
<div class="line"><code class="file docutils literal notranslate"><span class="pre">etc/global.cfg</span></code></div>
<div class="line"><code class="file docutils literal notranslate"><span class="pre">etc/scsmdump.cfg</span></code></div>
<div class="line"><code class="file docutils literal notranslate"><span class="pre">~/.seiscomp/global.cfg</span></code></div>
<div class="line"><code class="file docutils literal notranslate"><span class="pre">~/.seiscomp/scsmdump.cfg</span></code></div>
</div>
<p>scsmdump inherits <a class="reference internal" href="global.html#global-configuration"><span class="std std-ref">global options</span></a>.</p>
</section>
<section id="command-line-options">
<h2>Command-Line Options<a class="headerlink" href="#command-line-options" title="Permalink to this heading"></a></h2>
<section id="generic">
<h3>Generic<a class="headerlink" href="#generic" title="Permalink to this heading"></a></h3>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scsmdump-h">
<span id="cmdoption-scsmdump-help"></span><span class="sig-name descname"><span class="pre">-h</span></span><span class="sig-prename descclassname"></span><span class="sig-prename descclassname"><span class="pre">,</span> </span><span class="sig-name descname"><span class="pre">--help</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-scsmdump-h" title="Permalink to this definition"></a></dt>
<dd><p>Show help message.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scsmdump-V">
<span id="cmdoption-scsmdump-version"></span><span class="sig-name descname"><span class="pre">-V</span></span><span class="sig-prename descclassname"></span><span class="sig-prename descclassname"><span class="pre">,</span> </span><span class="sig-name descname"><span class="pre">--version</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-scsmdump-V" title="Permalink to this definition"></a></dt>
<dd><p>Show version information.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scsmdump-config-file">
<span class="sig-name descname"><span class="pre">--config-file</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scsmdump-config-file" title="Permalink to this definition"></a></dt>
<dd><p>Use alternative configuration file. When this option is
used the loading of all stages is disabled. Only the
given configuration file is parsed and used. To use
another name for the configuration create a symbolic
link of the application or copy it. Example:
scautopick -&gt; scautopick2.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scsmdump-plugins">
<span class="sig-name descname"><span class="pre">--plugins</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scsmdump-plugins" title="Permalink to this definition"></a></dt>
<dd><p>Load given plugins.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scsmdump-D">
<span id="cmdoption-scsmdump-daemon"></span><span class="sig-name descname"><span class="pre">-D</span></span><span class="sig-prename descclassname"></span><span class="sig-prename descclassname"><span class="pre">,</span> </span><span class="sig-name descname"><span class="pre">--daemon</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-scsmdump-D" title="Permalink to this definition"></a></dt>
<dd><p>Run as daemon. This means the application will fork itself
and doesnt need to be started with &amp;.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scsmdump-auto-shutdown">
<span class="sig-name descname"><span class="pre">--auto-shutdown</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scsmdump-auto-shutdown" title="Permalink to this definition"></a></dt>
<dd><p>Enable/disable self-shutdown because a master module shutdown.
This only works when messaging is enabled and the master
module sends a shutdown message (enabled with --start-stop-msg
for the master module).</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scsmdump-shutdown-master-module">
<span class="sig-name descname"><span class="pre">--shutdown-master-module</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scsmdump-shutdown-master-module" title="Permalink to this definition"></a></dt>
<dd><p>Set the name of the master-module used for auto-shutdown.
This is the application name of the module actually
started. If symlinks are used, then it is the name of
the symlinked application.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scsmdump-shutdown-master-username">
<span class="sig-name descname"><span class="pre">--shutdown-master-username</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scsmdump-shutdown-master-username" title="Permalink to this definition"></a></dt>
<dd><p>Set the name of the master-username of the messaging
used for auto-shutdown. If &quot;shutdown-master-module&quot; is
given as well, this parameter is ignored.</p>
</dd></dl>
</section>
<section id="verbosity">
<h3>Verbosity<a class="headerlink" href="#verbosity" title="Permalink to this heading"></a></h3>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scsmdump-verbosity">
<span class="sig-name descname"><span class="pre">--verbosity</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scsmdump-verbosity" title="Permalink to this definition"></a></dt>
<dd><p>Verbosity level [0..4]. 0:quiet, 1:error, 2:warning, 3:info,
4:debug.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scsmdump-v">
<span id="cmdoption-scsmdump-v"></span><span class="sig-name descname"><span class="pre">-v</span></span><span class="sig-prename descclassname"></span><span class="sig-prename descclassname"><span class="pre">,</span> </span><span class="sig-name descname"><span class="pre">--v</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-scsmdump-v" title="Permalink to this definition"></a></dt>
<dd><p>Increase verbosity level (may be repeated, eg. -vv).</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scsmdump-q">
<span id="cmdoption-scsmdump-quiet"></span><span class="sig-name descname"><span class="pre">-q</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">--quiet</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-scsmdump-q" title="Permalink to this definition"></a></dt>
<dd><p>Quiet mode: no logging output.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scsmdump-component">
<span class="sig-name descname"><span class="pre">--component</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scsmdump-component" title="Permalink to this definition"></a></dt>
<dd><p>Limit the logging to a certain component. This option can
be given more than once.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scsmdump-s">
<span id="cmdoption-scsmdump-syslog"></span><span class="sig-name descname"><span class="pre">-s</span></span><span class="sig-prename descclassname"></span><span class="sig-prename descclassname"><span class="pre">,</span> </span><span class="sig-name descname"><span class="pre">--syslog</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-scsmdump-s" title="Permalink to this definition"></a></dt>
<dd><p>Use syslog logging backend. The output usually goes to
/var/lib/messages.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scsmdump-l">
<span id="cmdoption-scsmdump-lockfile"></span><span class="sig-name descname"><span class="pre">-l</span></span><span class="sig-prename descclassname"></span><span class="sig-prename descclassname"><span class="pre">,</span> </span><span class="sig-name descname"><span class="pre">--lockfile</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scsmdump-l" title="Permalink to this definition"></a></dt>
<dd><p>Path to lock file.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scsmdump-console">
<span class="sig-name descname"><span class="pre">--console</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scsmdump-console" title="Permalink to this definition"></a></dt>
<dd><p>Send log output to stdout.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scsmdump-debug">
<span class="sig-name descname"><span class="pre">--debug</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-scsmdump-debug" title="Permalink to this definition"></a></dt>
<dd><p>Execute in debug mode.
Equivalent to --verbosity=4 --console=1 .</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scsmdump-log-file">
<span class="sig-name descname"><span class="pre">--log-file</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scsmdump-log-file" title="Permalink to this definition"></a></dt>
<dd><p>Use alternative log file.</p>
</dd></dl>
</section>
<section id="database">
<h3>Database<a class="headerlink" href="#database" title="Permalink to this heading"></a></h3>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scsmdump-db-driver-list">
<span class="sig-name descname"><span class="pre">--db-driver-list</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-scsmdump-db-driver-list" title="Permalink to this definition"></a></dt>
<dd><p>List all supported database drivers.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scsmdump-d">
<span id="cmdoption-scsmdump-database"></span><span class="sig-name descname"><span class="pre">-d</span></span><span class="sig-prename descclassname"></span><span class="sig-prename descclassname"><span class="pre">,</span> </span><span class="sig-name descname"><span class="pre">--database</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scsmdump-d" title="Permalink to this definition"></a></dt>
<dd><p>The database connection string, format:
<a class="reference external" href="service://user:pwd&#64;host/database">service://user:pwd&#64;host/database</a>.
&quot;service&quot; is the name of the database driver which
can be queried with &quot;--db-driver-list&quot;.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scsmdump-config-module">
<span class="sig-name descname"><span class="pre">--config-module</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scsmdump-config-module" title="Permalink to this definition"></a></dt>
<dd><p>The config module to use.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scsmdump-inventory-db">
<span class="sig-name descname"><span class="pre">--inventory-db</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scsmdump-inventory-db" title="Permalink to this definition"></a></dt>
<dd><p>Load the inventory from the given database or file, format:
[<a class="reference external" href="service://]location">service://]location</a> .</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scsmdump-db-disable">
<span class="sig-name descname"><span class="pre">--db-disable</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-scsmdump-db-disable" title="Permalink to this definition"></a></dt>
<dd><p>Do not use the database at all</p>
</dd></dl>
</section>
<section id="input">
<h3>Input<a class="headerlink" href="#input" title="Permalink to this heading"></a></h3>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scsmdump-O">
<span id="cmdoption-scsmdump-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">originID</span></span><a class="headerlink" href="#cmdoption-scsmdump-O" title="Permalink to this definition"></a></dt>
<dd><p>Origin public ID(s) to dump. Multiple origins may be specified
as a comma-separated list. Use &quot;-&quot; for reading from stdin.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scsmdump-E">
<span id="cmdoption-scsmdump-event"></span><span class="sig-name descname"><span class="pre">-E</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">--event</span></span><span class="sig-prename descclassname"> <span class="pre">eventID</span></span><a class="headerlink" href="#cmdoption-scsmdump-E" title="Permalink to this definition"></a></dt>
<dd><p>Event public ID(s) to dump. Multiple events may be specified
as a comma-separated list. Use &quot;-&quot; for reading from stdin.</p>
</dd></dl>
</section>
<section id="dump">
<h3>Dump<a class="headerlink" href="#dump" title="Permalink to this heading"></a></h3>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scsmdump-r">
<span id="cmdoption-scsmdump-with-event-records"></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">--with-event-records</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-scsmdump-r" title="Permalink to this definition"></a></dt>
<dd><p>Include event record references. This option is necessary in order to export the records itself.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scsmdump-S">
<span id="cmdoption-scsmdump-with-records"></span><span class="sig-name descname"><span class="pre">-S</span></span><span class="sig-prename descclassname"></span><span class="sig-prename descclassname"><span class="pre">,</span> </span><span class="sig-name descname"><span class="pre">--with-records</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-scsmdump-S" title="Permalink to this definition"></a></dt>
<dd><p>Include records referred to from event records. This option depends on --with-event-records.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scsmdump-R">
<span id="cmdoption-scsmdump-with-ruptures"></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">--with-ruptures</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-scsmdump-R" title="Permalink to this definition"></a></dt>
<dd><p>Include ruptures.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scsmdump-p">
<span id="cmdoption-scsmdump-preferred-only"></span><span class="sig-name descname"><span class="pre">-p</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">--preferred-only</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-scsmdump-p" title="Permalink to this definition"></a></dt>
<dd><p>When dumping events, only the preferred origin will be dumped.</p>
</dd></dl>
</section>
<section id="output">
<h3>Output<a class="headerlink" href="#output" title="Permalink to this heading"></a></h3>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scsmdump-f">
<span id="cmdoption-scsmdump-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-scsmdump-f" title="Permalink to this definition"></a></dt>
<dd><p>Use formatted XML output.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scsmdump-o">
<span id="cmdoption-scsmdump-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">file</span></span><a class="headerlink" href="#cmdoption-scsmdump-o" title="Permalink to this definition"></a></dt>
<dd><p>Name of output file. If not given or -, output
is sent to stdout.</p>
</dd></dl>
</section>
</section>
</section>
<div id="anchors-bottom"></div>
</div>
<div class="sidebar" role="navigation" aria-label="main navigation">
<div id="anchors-top"></div>
<div id="anchors" class="content">
<div id="searchbox" style="display: none" role="search">
<h3 id="searchlabel">Quick search</h3>
<div class="searchformwrapper">
<form class="search" action="../search.html" method="get">
<input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
<input type="submit" value="Go" />
</form>
</div>
</div>
<script>document.getElementById('searchbox').style.display = "block"</script>
<div>
<h3><a href="../index.html">Table of Contents</a></h3>
<ul>
<li><a class="reference internal" href="#">scsmdump</a><ul>
<li><a class="reference internal" href="#description">Description</a></li>
<li><a class="reference internal" href="#module-configuration">Module Configuration</a></li>
<li><a class="reference internal" href="#command-line-options">Command-Line Options</a><ul>
<li><a class="reference internal" href="#generic">Generic</a></li>
<li><a class="reference internal" href="#verbosity">Verbosity</a></li>
<li><a class="reference internal" href="#database">Database</a></li>
<li><a class="reference internal" href="#input">Input</a></li>
<li><a class="reference internal" href="#dump">Dump</a></li>
<li><a class="reference internal" href="#output">Output</a></li>
</ul>
</li>
</ul>
</li>
</ul>
</div>
<div>
<h4>Previous topic</h4>
<p class="topless"><a href="screpick.html"
title="previous chapter">screpick</a></p>
</div>
<div>
<h4>Next topic</h4>
<p class="topless"><a href="scwfparam.html"
title="next chapter">scwfparam</a></p>
</div>
<div role="note" aria-label="source link">
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="../_sources/apps/scsmdump.rst.txt"
rel="nofollow">Show Source</a></li>
</ul>
</div>
</div>
</div>
</div>
</div>
<div class="footer">
<div class="container">
<div class="horizontal layout content">
<a class="fade-in" href="https://www.gempa.de" target="_blank">
<img class="brand" src="../_static/brands/gempa.svg"/>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.
</div>
</div>
<a class="fade-in" href="https://www.gfz-potsdam.de" target="_blank">
<img class="brand" src="../_static/brands/gfz.svg"/>
</a>
</div>
</div>
</div>
</body>
</html>

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>scsohlog &#8212; SeisComP Release documentation</title>
<title>scsohlog &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -300,12 +300,14 @@ This option can be given more than once.</p>
<dt class="sig sig-object std" id="cmdoption-scsohlog-content-type">
<span class="sig-name descname"><span class="pre">--content-type</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scsohlog-content-type" title="Permalink to this definition"></a></dt>
<dd><p>Overrides configuration parameter <a class="reference internal" href="global.html#confval-connection.contentType"><code class="xref std std-confval docutils literal notranslate"><span class="pre">connection.contentType</span></code></a>.</p>
<p>Default: <code class="docutils literal notranslate"><span class="pre">binary</span></code></p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scsohlog-start-stop-msg">
<span class="sig-name descname"><span class="pre">--start-stop-msg</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scsohlog-start-stop-msg" title="Permalink to this definition"></a></dt>
<dd><p>Set sending of a start and a stop message.</p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">0</span></code></p>
<p>Set sending of a start and a stop message.</p>
</dd></dl>
</section>
@ -398,7 +400,7 @@ This option can be given more than once.</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>scvoice &#8212; SeisComP Release documentation</title>
<title>scvoice &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -229,7 +229,7 @@ event. Any point of interest farther away will be ignored.</p>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-scripts.amplitude">
<span class="sig-name descname"><span class="pre">scripts.amplitude</span></span><a class="headerlink" href="#confval-scripts.amplitude" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<dd><p>Type: <em>file</em></p>
<p>Specify the script to be called if an amplitude
arrives, network-, stationcode and amplitude are passed
as parameters $1, $2 and $3.</p>
@ -238,7 +238,7 @@ as parameters $1, $2 and $3.</p>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-scripts.alert">
<span class="sig-name descname"><span class="pre">scripts.alert</span></span><a class="headerlink" href="#confval-scripts.alert" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<dd><p>Type: <em>file</em></p>
<p>Specify the script to be called if a preliminary
origin arrives, latitude and longitude are passed as
parameters $1 and $2.</p>
@ -247,7 +247,7 @@ parameters $1 and $2.</p>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-scripts.event">
<span class="sig-name descname"><span class="pre">scripts.event</span></span><a class="headerlink" href="#confval-scripts.event" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<dd><p>Type: <em>file</em></p>
<p>Specify the script to be called when an event has been
declared; the message string, a flag (1=new event,
0=update event), the EventID, the arrival count and the
@ -428,12 +428,14 @@ This option can be given more than once.</p>
<dt class="sig sig-object std" id="cmdoption-scvoice-content-type">
<span class="sig-name descname"><span class="pre">--content-type</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scvoice-content-type" title="Permalink to this definition"></a></dt>
<dd><p>Overrides configuration parameter <a class="reference internal" href="global.html#confval-connection.contentType"><code class="xref std std-confval docutils literal notranslate"><span class="pre">connection.contentType</span></code></a>.</p>
<p>Default: <code class="docutils literal notranslate"><span class="pre">binary</span></code></p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scvoice-start-stop-msg">
<span class="sig-name descname"><span class="pre">--start-stop-msg</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scvoice-start-stop-msg" title="Permalink to this definition"></a></dt>
<dd><p>Set sending of a start and a stop message.</p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">0</span></code></p>
<p>Set sending of a start and a stop message.</p>
</dd></dl>
</section>
@ -479,7 +481,8 @@ can be queried with &quot;--db-driver-list&quot;.</p>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scvoice-amp-type">
<span class="sig-name descname"><span class="pre">--amp-type</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scvoice-amp-type" title="Permalink to this definition"></a></dt>
<dd><p>Specify the amplitude type to listen to.</p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">snr</span></code></p>
<p>Specify the amplitude type to listen to.</p>
</dd></dl>
<dl class="std option">
@ -602,7 +605,7 @@ After running the alert scripts scvoice will exit.</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>scwfas &#8212; SeisComP Release documentation</title>
<title>scwfas &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -87,11 +87,7 @@ SDS archive via different protocols. Currently there are two implementations:</p
<li><p>dataselect/1/application.wadl</p></li>
</ul>
</li>
<li><p>Arclink (deprecated)</p></li>
</ul>
<p>This application is meant to share data with trusted computers in a fast and
efficient way. It does not require inventory information and supports wildcards
on each level.</p>
<p>All data are forwarded unrestricted. There are no options to add restriction
checks or user authentication.</p>
</section>
@ -125,16 +121,6 @@ handler is defined by &quot;handlerSDS&quot;, this value serves
as input to setSource().</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-arclink.port">
<span class="sig-name descname"><span class="pre">arclink.port</span></span><a class="headerlink" href="#confval-arclink.port" 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>int</em></p>
<p>The server port for Arclink connections. -1
deactivates the Arclink server. The standard Arclink port is
18001.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-fdsnws.port">
<span class="sig-name descname"><span class="pre">fdsnws.port</span></span><a class="headerlink" href="#confval-fdsnws.port" title="Permalink to this definition"></a></dt>
@ -289,7 +275,7 @@ Equivalent to --verbosity=4 --console=1 --print-component=1
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scwfas-arclink-port">
<span class="sig-name descname"><span class="pre">--arclink-port</span></span><span class="sig-prename descclassname"> <span class="pre">int</span></span><a class="headerlink" href="#cmdoption-scwfas-arclink-port" title="Permalink to this definition"></a></dt>
<dd><p>Overrides configuration parameter <a class="reference internal" href="#confval-arclink.port"><code class="xref std std-confval docutils literal notranslate"><span class="pre">arclink.port</span></code></a>.</p>
<dd><p>Overrides configuration parameter <code class="xref std std-confval docutils literal notranslate"><span class="pre">arclink.port</span></code>.</p>
</dd></dl>
<dl class="std option">
@ -371,7 +357,7 @@ Equivalent to --verbosity=4 --console=1 --print-component=1
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>scwfparam &#8212; SeisComP Release documentation</title>
<title>scwfparam &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,21 +12,21 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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="System" href="../toc/system.html" />
<link rel="prev" title="screpick" href="screpick.html" />
<link rel="prev" title="scsmdump" href="scsmdump.html" />
</head>
<body>
<div class="header">
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -49,7 +49,7 @@
</a>
</li>
<li class="right">
<a href="screpick.html" title="screpick"
<a href="scsmdump.html" title="scsmdump"
accesskey="P">
previous
</a>
@ -1262,12 +1262,14 @@ This option can be given more than once.</p>
<dt class="sig sig-object std" id="cmdoption-scwfparam-content-type">
<span class="sig-name descname"><span class="pre">--content-type</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scwfparam-content-type" title="Permalink to this definition"></a></dt>
<dd><p>Overrides configuration parameter <a class="reference internal" href="global.html#confval-connection.contentType"><code class="xref std std-confval docutils literal notranslate"><span class="pre">connection.contentType</span></code></a>.</p>
<p>Default: <code class="docutils literal notranslate"><span class="pre">binary</span></code></p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scwfparam-start-stop-msg">
<span class="sig-name descname"><span class="pre">--start-stop-msg</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scwfparam-start-stop-msg" title="Permalink to this definition"></a></dt>
<dd><p>Set sending of a start and a stop message.</p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">0</span></code></p>
<p>Set sending of a start and a stop message.</p>
</dd></dl>
<dl class="std option">
@ -1325,12 +1327,12 @@ can be queried with &quot;--db-driver-list&quot;.</p>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scwfparam-I">
<span id="cmdoption-scwfparam-record-url"></span><span class="sig-name descname"><span class="pre">-I</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">--record-url</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scwfparam-I" title="Permalink to this definition"></a></dt>
<dd><p>The recordstream source URL, format:
<dd><p>The RecordStream source URL. Format:
[<a class="reference external" href="service://">service://</a>]location[#type].
&quot;service&quot; is the name of the recordstream driver
&quot;service&quot; is the name of the RecordStream driver
which can be queried with &quot;--record-driver-list&quot;.
If &quot;service&quot; is not given, &quot;<a class="reference external" href="file://">file://</a>&quot; is
used.</p>
used and simply the name of a miniSEED file can be given.</p>
</dd></dl>
<dl class="std option">
@ -1472,8 +1474,8 @@ used.</p>
</div>
<div>
<h4>Previous topic</h4>
<p class="topless"><a href="screpick.html"
title="previous chapter">screpick</a></p>
<p class="topless"><a href="scsmdump.html"
title="previous chapter">scsmdump</a></p>
</div>
<div>
<h4>Next topic</h4>
@ -1499,7 +1501,7 @@ used.</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>scxmldump &#8212; SeisComP Release documentation</title>
<title>scxmldump &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -74,11 +74,15 @@
<section id="scxmldump">
<span id="id1"></span><h1>scxmldump<a class="headerlink" href="#scxmldump" title="Permalink to this heading"></a></h1>
<p><strong>Dump database objects to XML files.</strong></p>
<p><strong>Dump objects from database or messaging to XML.</strong></p>
<section id="description">
<h2>Description<a class="headerlink" href="#description" title="Permalink to this heading"></a></h2>
<p>scxmldump reads various parameters from a SeisComP database:</p>
<p>scxmldump reads SeisComP objects from database or messaging and writes them
in SeisComP XML (<a class="reference internal" href="../base/glossary.html#term-SCML"><span class="xref std std-term">SCML</span></a>) to stdout or into a file (<code class="xref std std-option docutils literal notranslate"><span class="pre">-o</span></code>).</p>
<ul class="simple">
<li><p>Dumping from a SeisComP database supports various
<a class="reference internal" href="../base/api-python.html#api-datamodel-python"><span class="std std-ref">objects</span></a>:</p>
<ul>
<li><p>Availability,</p></li>
<li><p>Config (bindings parameters),</p></li>
<li><p>Event parameters,</p></li>
@ -86,19 +90,26 @@
<li><p>Journal,</p></li>
<li><p>Routing.</p></li>
</ul>
<p>The parameters are sent to stdout or written into an XML (<a class="reference internal" href="../base/glossary.html#term-SCML"><span class="xref std std-term">SCML</span></a>) file.</p>
</li>
<li><p>Dumping from a SeisComP messaging (<code class="xref std std-option docutils literal notranslate"><span class="pre">--listen</span></code>) considers only event
parameters.</p></li>
</ul>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>Waveform quality control (QC) parameters can be read from databases using
<span class="xref std std-ref">scqcquery</span>.</p>
</div>
<ul class="simple">
<li><p>Furthermore any object carrying a publicID can be retrieved from the database
including its hierarchie or not. See <a class="reference internal" href="#scxmldump-public-objects"><span class="std std-ref">PublicObjects</span></a>.</p></li>
</ul>
<section id="event-parameters">
<h3>Event parameters<a class="headerlink" href="#event-parameters" title="Permalink to this heading"></a></h3>
<p>To get event, origin or pick information from the database without using SQL
commands is an important task for the user. <a class="reference internal" href="#scxmldump"><span class="std std-ref">scxmldump</span></a> queries the
database and transforms that information into XML. Events and origins can be
treated further by <a class="reference internal" href="scbulletin.html#scbulletin"><span class="std std-ref">scbulletin</span></a> for generating bulletins or conversion
into KML.</p>
into other formats including KML.</p>
<p>Many processing modules, e.g., <a class="reference internal" href="scevent.html#scevent"><span class="std std-ref">scevent</span></a> support the on-demand processing
of dumped event parameters by the command-line option <code class="xref std std-option docutils literal notranslate"><span class="pre">--ep</span></code>.
Importing event parameters into another database is possible with <a class="reference internal" href="scdb.html#scdb"><span class="std std-ref">scdb</span></a>
@ -111,6 +122,30 @@ respectively. Event, origin and pick IDs can also be read from graphical
tools like <a class="reference internal" href="scolv.html#scolv"><span class="std std-ref">scolv</span></a> or used database queries assisted by <a class="reference internal" href="scquery.html#scquery"><span class="std std-ref">scquery</span></a>.</p>
</div>
</section>
<section id="publicobjects">
<span id="scxmldump-public-objects"></span><h3>PublicObjects<a class="headerlink" href="#publicobjects" title="Permalink to this heading"></a></h3>
<p>The option <code class="xref std std-option docutils literal notranslate"><span class="pre">--public-id</span></code> defines a list of publicIDs to be retrieved
from the database. As the data model is extendable via plugins and custom code,
scxmldump cannot know all of those object types and how to retrieve them
from the database. If a publicID belongs to a type for which the code resides
in another library or plugin, then scxmldump must load this plugin or library
in order to find the correct database tables. For example, if a strong motion
object should be dumped, then the plugin dmsm must be loaded into scxmldump.</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>scxmldump<span class="w"> </span>-d<span class="w"> </span>localhost<span class="w"> </span>--plugins<span class="w"> </span>dbmysql,dmsm<span class="w"> </span>--public-id<span class="w"> </span>StrongMotionOrigin/123456
</pre></div>
</div>
<p>This command would only export the StrongMotionOrigin itself without all
child objects. Option <code class="xref std std-option docutils literal notranslate"><span class="pre">--with-childs</span></code> must be passed to export the
full hierarchy:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>scxmldump<span class="w"> </span>-d<span class="w"> </span>localhost<span class="w"> </span>--plugins<span class="w"> </span>dbmysql,dmsm<span class="w"> </span>--public-id<span class="w"> </span>StrongMotionOrigin/123456<span class="w"> </span>--with-childs
</pre></div>
</div>
<p>If the extension code resides in a library then LD_PRELOAD can be used to inject
the code into scxmldump:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="nv">LD_PRELOAD</span><span class="o">=</span>/home/sysop/seiscomp/lib/libseiscomp_datamodel_sm.so<span class="w"> </span>scxmldump<span class="w"> </span>-d<span class="w"> </span>localhost<span class="w"> </span>--public-id<span class="w"> </span>StrongMotionOrigin/123456<span class="w"> </span>--with-childs
</pre></div>
</div>
</section>
<section id="format-conversion">
<h3>Format conversion<a class="headerlink" href="#format-conversion" title="Permalink to this heading"></a></h3>
<p>Conversion of <a class="reference internal" href="../base/glossary.html#term-SCML"><span class="xref std std-term">SCML</span></a> into other formats is supported by <a class="reference internal" href="sccnv.html#sccnv"><span class="std std-ref">sccnv</span></a>.
@ -119,41 +154,56 @@ An XSD schema of the XML output can be found under
</section>
<section id="examples">
<h3>Examples<a class="headerlink" href="#examples" title="Permalink to this heading"></a></h3>
<p>Dump inventory</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>scxmldump<span class="w"> </span>-fI<span class="w"> </span>-o<span class="w"> </span>inventory.xml<span class="w"> </span>-d<span class="w"> </span>mysql://sysop:sysop@localhost/seiscomp
<ul>
<li><p>Dump inventory</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>scxmldump<span class="w"> </span>-d<span class="w"> </span>mysql://sysop:sysop@localhost/seiscomp<span class="w"> </span>-fI<span class="w"> </span>-o<span class="w"> </span>inventory.xml
</pre></div>
</div>
<p>Dump config (bindings parameters)</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>scxmldump<span class="w"> </span>-fC<span class="w"> </span>-o<span class="w"> </span>config.xml<span class="w"> </span>-d<span class="w"> </span>mysql://sysop:sysop@localhost/seiscomp
</li>
<li><p>Dump config (bindings parameters)</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>scxmldump<span class="w"> </span>-d<span class="w"> </span>localhost<span class="w"> </span>-fC<span class="w"> </span>-o<span class="w"> </span>config.xml
</pre></div>
</div>
<p>Dump full event data incl. the relevant journal entries</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>scxmldump<span class="w"> </span>-fPAMFJ<span class="w"> </span>-E<span class="w"> </span>test2012abcd<span class="w"> </span>-o<span class="w"> </span>test2012abcd.xml<span class="w"> </span><span class="se">\</span>
<span class="w"> </span>-d<span class="w"> </span>mysql://sysop:sysop@localhost/seiscomp
</li>
<li><p>Dump full event data including the relevant journal entries</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>scxmldump<span class="w"> </span>-d<span class="w"> </span>localhost<span class="w"> </span>-fPAMFJ<span class="w"> </span>-E<span class="w"> </span>test2012abcd<span class="w"> </span>-o<span class="w"> </span>test2012abcd.xml
</pre></div>
</div>
<p>Dump summary event data</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>scxmldump<span class="w"> </span>-fap<span class="w"> </span>-E<span class="w"> </span>test2012abcd<span class="w"> </span>-o<span class="w"> </span>test2012abcd.xml<span class="w"> </span><span class="se">\</span>
<span class="w"> </span>-d<span class="w"> </span>mysql://sysop:sysop@localhost/seiscomp
</li>
<li><p>Dump full event data. Event IDs are provided by <a class="reference internal" href="scevtls.html#scevtls"><span class="std std-ref">scevtls</span></a> and received
from stdin</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>scevtls<span class="w"> </span>-d<span class="w"> </span>localhost<span class="w"> </span>--begin<span class="w"> </span><span class="m">2025</span>-01-01<span class="w"> </span><span class="p">|</span><span class="se">\</span>
scxmldump<span class="w"> </span>-d<span class="w"> </span>localhost<span class="w"> </span>-fPAMF<span class="w"> </span>-E<span class="w"> </span>-<span class="w"> </span>-o<span class="w"> </span>events.xml
</pre></div>
</div>
<p>Create bulletin from an event</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>scxmldump<span class="w"> </span>-fPAMF<span class="w"> </span>-E<span class="w"> </span>test2012abcd
<span class="w"> </span>-d<span class="w"> </span>mysql://sysop:sysop@localhost/seiscomp<span class="w"> </span><span class="p">|</span><span class="w"> </span><span class="se">\</span>
scbulletin
</li>
<li><p>Dump summary event data</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>scxmldump<span class="w"> </span>-d<span class="w"> </span>localhost<span class="w"> </span>-fap<span class="w"> </span>-E<span class="w"> </span>test2012abcd<span class="w"> </span>-o<span class="w"> </span>test2012abcd.xml
</pre></div>
</div>
<p>Copy event parameters to another database</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>scxmldump<span class="w"> </span>-fPAMF<span class="w"> </span>-E<span class="w"> </span>test2012abcd<span class="w"> </span><span class="se">\</span>
<span class="w"> </span>-d<span class="w"> </span>mysql://sysop:sysop@localhost/seiscomp<span class="w"> </span><span class="p">|</span><span class="w"> </span><span class="se">\</span>
</li>
<li><p>Create bulletin from an event using <a class="reference internal" href="scbulletin.html#scbulletin"><span class="std std-ref">scbulletin</span></a></p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>scxmldump<span class="w"> </span>-d<span class="w"> </span>localhost<span class="w"> </span>-fPAMF<span class="w"> </span>-E<span class="w"> </span>test2012abcd<span class="w"> </span><span class="p">|</span><span class="w"> </span>scbulletin
</pre></div>
</div>
</li>
<li><p>Copy event parameters to another database</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>scxmldump<span class="w"> </span>-d<span class="w"> </span>localhost<span class="w"> </span>-fPAMF<span class="w"> </span>-E<span class="w"> </span>test2012abcd<span class="w"> </span><span class="p">|</span><span class="se">\</span>
scdb<span class="w"> </span>-i<span class="w"> </span>-<span class="w"> </span>-d<span class="w"> </span>mysql://sysop:sysop@archive-db/seiscomp
</pre></div>
</div>
<p>Export the entire journal:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>scxmldump<span class="w"> </span>-fJ<span class="w"> </span>-o<span class="w"> </span>journal.xml<span class="w"> </span><span class="se">\</span>
<span class="w"> </span>-d<span class="w"> </span>mysql://sysop:sysop@localhost/seiscomp
</li>
<li><p>Dump the entire journal:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>scxmldump<span class="w"> </span>-d<span class="w"> </span>localhost<span class="w"> </span>-fJ<span class="w"> </span>-o<span class="w"> </span>journal.xml
</pre></div>
</div>
</li>
<li><p>Dump events received from messaging on local computer:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>scxmldump<span class="w"> </span>-H<span class="w"> </span>localhost/production<span class="w"> </span>--listen
</pre></div>
</div>
</li>
</ul>
</section>
</section>
<section id="module-configuration">
@ -334,12 +384,14 @@ This option can be given more than once.</p>
<dt class="sig sig-object std" id="cmdoption-scxmldump-content-type">
<span class="sig-name descname"><span class="pre">--content-type</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scxmldump-content-type" title="Permalink to this definition"></a></dt>
<dd><p>Overrides configuration parameter <a class="reference internal" href="global.html#confval-connection.contentType"><code class="xref std std-confval docutils literal notranslate"><span class="pre">connection.contentType</span></code></a>.</p>
<p>Default: <code class="docutils literal notranslate"><span class="pre">binary</span></code></p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scxmldump-start-stop-msg">
<span class="sig-name descname"><span class="pre">--start-stop-msg</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scxmldump-start-stop-msg" title="Permalink to this definition"></a></dt>
<dd><p>Set sending of a start and a stop message.</p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">0</span></code></p>
<p>Set sending of a start and a stop message.</p>
</dd></dl>
</section>
@ -383,13 +435,6 @@ format: [<a class="reference external" href="service://]location">service://]loc
</section>
<section id="dump">
<h3>Dump<a class="headerlink" href="#dump" title="Permalink to this heading"></a></h3>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scxmldump-listen">
<span class="sig-name descname"><span class="pre">--listen</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-scxmldump-listen" title="Permalink to this definition"></a></dt>
<dd><p>Enable server mode which listens to the message server for
incoming events and dumps each received add/update.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scxmldump-I">
<span id="cmdoption-scxmldump-inventory"></span><span class="sig-name descname"><span class="pre">-I</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">--inventory</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-scxmldump-I" title="Permalink to this definition"></a></dt>
@ -405,7 +450,7 @@ incoming events and dumps each received add/update.</p>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scxmldump-stations">
<span class="sig-name descname"><span class="pre">--stations</span></span><span class="sig-prename descclassname"> <span class="pre">sta-list</span></span><a class="headerlink" href="#cmdoption-scxmldump-stations" title="Permalink to this definition"></a></dt>
<dd><p>If inventory is exported, filter the stations to export.
<dd><p>If inventory is dumped, filter the stations to dump.
Wildcards are supported. Format of each item: net[.{sta|*}].</p>
</dd></dl>
@ -437,28 +482,31 @@ journal entries are included.</p>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scxmldump-with-segments">
<span class="sig-name descname"><span class="pre">--with-segments</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-scxmldump-with-segments" title="Permalink to this definition"></a></dt>
<dd><p>Dump individual data segments.</p>
<dd><p>Dump individual data segments. Requires
&quot;--availability&quot;.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scxmldump-pick">
<span class="sig-name descname"><span class="pre">--pick</span></span><span class="sig-prename descclassname"> <span class="pre">ID</span></span><a class="headerlink" href="#cmdoption-scxmldump-pick" title="Permalink to this definition"></a></dt>
<dd><p>Pick public ID(s) to dump. Multiple IDs may be specified
as a comma-separated list.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scxmldump-O">
<span id="cmdoption-scxmldump-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">ID</span></span><a class="headerlink" href="#cmdoption-scxmldump-O" title="Permalink to this definition"></a></dt>
<dd><p>Origin public ID(s) to dump. Multiple origins may be specified
as a comma-separated list.</p>
<dt class="sig sig-object std" id="cmdoption-scxmldump-listen">
<span class="sig-name descname"><span class="pre">--listen</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-scxmldump-listen" title="Permalink to this definition"></a></dt>
<dd><p>Listen to the message server for incoming events. Otherwise
scxmldump reads from database.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scxmldump-E">
<span id="cmdoption-scxmldump-event"></span><span class="sig-name descname"><span class="pre">-E</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">--event</span></span><span class="sig-prename descclassname"> <span class="pre">ID</span></span><a class="headerlink" href="#cmdoption-scxmldump-E" title="Permalink to this definition"></a></dt>
<dd><p>Event public ID(s) to dump. Multiple events may be specified
as a comma-separated list.</p>
as a comma-separated list. Use &quot;-&quot; for reading the IDs as
individual lines from stdin.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scxmldump-O">
<span id="cmdoption-scxmldump-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">ID</span></span><a class="headerlink" href="#cmdoption-scxmldump-O" title="Permalink to this definition"></a></dt>
<dd><p>Origin public ID(s) to dump. Multiple origins may be specified
as a comma-separated list. Use &quot;-&quot; for reading the IDs as
individual lines from stdin</p>
</dd></dl>
<dl class="std option">
@ -488,31 +536,62 @@ as a comma-separated list.</p>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scxmldump-a">
<span id="cmdoption-scxmldump-ignore-arrivals"></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">--ignore-arrivals</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-scxmldump-a" title="Permalink to this definition"></a></dt>
<dd><p>Do not dump arrivals part of origins.</p>
<dd><p>Do not dump arrivals of origins.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scxmldump-ignore-magnitudes">
<span class="sig-name descname"><span class="pre">--ignore-magnitudes</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-scxmldump-ignore-magnitudes" title="Permalink to this definition"></a></dt>
<dd><p>Do not export (network) magnitudes of origins. This
<dd><p>Do not dump (network) magnitudes of origins. This
option is most useful in combination with -O to only
export the location information.</p>
dump the location information.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scxmldump-p">
<span id="cmdoption-scxmldump-preferred-only"></span><span class="sig-name descname"><span class="pre">-p</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">--preferred-only</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-scxmldump-p" title="Permalink to this definition"></a></dt>
<dd><p>When exporting events only the preferred origin, the preferred
<dd><p>When dumping events only the preferred origin, the preferred
magnitude and the preferred focal mechanism will be dumped.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scxmldump-m">
<span id="cmdoption-scxmldump-all-magnitudes"></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">--all-magnitudes</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-scxmldump-m" title="Permalink to this definition"></a></dt>
<dd><p>If only the preferred origin is exported, all magnitudes for
<dd><p>If only the preferred origin is dumped, all magnitudes for
this origin will be dumped.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scxmldump-pick">
<span class="sig-name descname"><span class="pre">--pick</span></span><span class="sig-prename descclassname"> <span class="pre">ID</span></span><a class="headerlink" href="#cmdoption-scxmldump-pick" title="Permalink to this definition"></a></dt>
<dd><p>ID(s) of pick(s) to dump. Use - to read the IDs as
individual lines from stdin.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scxmldump-public-id">
<span class="sig-name descname"><span class="pre">--public-id</span></span><span class="sig-prename descclassname"> <span class="pre">ID</span></span><a class="headerlink" href="#cmdoption-scxmldump-public-id" title="Permalink to this definition"></a></dt>
<dd><p>ID(s) of any object(s) to dump. Use - to read the IDs as
individual lines from stdin. No parent objects are dumped.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scxmldump-with-childs">
<span class="sig-name descname"><span class="pre">--with-childs</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-scxmldump-with-childs" title="Permalink to this definition"></a></dt>
<dd><p>Dump also all child objects of dumped objects. Valid only in
combination with --public-id.</p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scxmldump-with-root">
<span class="sig-name descname"><span class="pre">--with-root</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-scxmldump-with-root" title="Permalink to this definition"></a></dt>
<dd><p>Whether to add the container of exported PublicObjects or
not. Objects which are not a direct child of
EventParameters, Inventory and so on, also referred to as
top-level objects, will not be exported.
Valid in combination with --public-id.</p>
</dd></dl>
</section>
<section id="output">
<h3>Output<a class="headerlink" href="#output" title="Permalink to this heading"></a></h3>
@ -563,6 +642,7 @@ stdout.</p>
<li><a class="reference internal" href="#">scxmldump</a><ul>
<li><a class="reference internal" href="#description">Description</a><ul>
<li><a class="reference internal" href="#event-parameters">Event parameters</a></li>
<li><a class="reference internal" href="#publicobjects">PublicObjects</a></li>
<li><a class="reference internal" href="#format-conversion">Format conversion</a></li>
<li><a class="reference internal" href="#examples">Examples</a></li>
</ul>
@ -611,7 +691,7 @@ stdout.</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>scxmlmerge &#8212; SeisComP Release documentation</title>
<title>scxmlmerge &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -354,7 +354,7 @@ or empty files are processed.</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>sczip &#8212; SeisComP Release documentation</title>
<title>sczip &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -324,7 +324,7 @@ Equivalent to --verbosity=4 --console=1 .</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>seedlink &#8212; SeisComP Release documentation</title>
<title>seedlink &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -77,8 +77,9 @@
<p><strong>Real-time waveform server implementing the SeedLink protocol.</strong></p>
<section id="description">
<h2>Description<a class="headerlink" href="#description" title="Permalink to this heading"></a></h2>
<p>SeedLink is a real-time data acquisition protocol and a client-server software
that implements this protocol. The SeedLink protocol is based on TCP. All
<p>SeedLink serves miniSEED data to clients in real times. It is a real-time data
acquisition protocol and a client-server software that implements this protocol.
The SeedLink protocol is based on TCP. All
connections are initiated by the client. During handshaking phase the client can
subscribe to specific stations and streams using simple commands in ASCII coding.
When handshaking is completed, a stream of SeedLink “packets” consisting of a
@ -91,27 +92,36 @@ manufacturers have implemented SeedLink in their digitizer firmware. All
implementations are generally compatible, but not all of them support the full
SeedLink protocol. On the other hand IRIS DMC implements some extensions which
are not supported by other servers. In the following we use “SeedLink” to denote
the SeedLink implementation used in SeisComP. The data source of a SeedLink
server can be anything which is supported by a SeedLink plugin - a small program
the SeedLink implementation used in SeisComP.</p>
<p>The data source of a SeedLink server can be anything which is supported by a
<a class="reference internal" href="#seedlink-sources"><span class="std std-ref">SeedLink plugin</span></a> - a small program
that sends data to the SeedLink server. Plugins are controlled by the SeedLink
server, e.g., a plugin is automatically restarted if it crashes or a timeout
occurs. Data supplied by a plugin can be a form of miniSEED packets or just
raw integer samples with accompanying timing information. In the latter case,
the SeedLink server uses an inegrated “Stream Processor” to create the desired
the SeedLink server uses an integrated “Stream Processor” to create the desired
data streams and assemble miniSEED packets.</p>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>SeedLink supports by default miniSEED records with a size of 512 bytes which
is hardcoded. For serving records with other sizes, e.g., 4096 bytes,
SeedLink must be recompiled with a modified variable <em>MSEED-RECLEN</em> located
in <code class="file docutils literal notranslate"><span class="pre">seedlink/apps/seedlink/iosystem.h</span></code> of the SeedLink repository.</p>
</div>
<section id="supported-data-sources">
<h3>Supported data sources<a class="headerlink" href="#supported-data-sources" title="Permalink to this heading"></a></h3>
<p>The table below lists digitizers and data acquisition systems that are supported by
SeedLink plugins. More plugins (Kinemetrics K2, Lennartz MARS-88, Lennartz PCM
5800, etc.) have been implemented by various users, but are not (yet) included
in the package. The included C language plugin interface is described in
section 5.1.1.5. Antelope, Earthworm and NAQS can also import data from
SeisComP. In SeisComP the class <a class="reference internal" href="global_recordstream.html#global-recordstream"><span class="std std-ref">RecordStream</span></a> is implemented that supports both
<span id="seedlink-sources"></span><h3>Supported data sources<a class="headerlink" href="#supported-data-sources" title="Permalink to this heading"></a></h3>
<p>The table below lists digitizers and data acquisition systems and the SeedLink
plugins supporting these system. More plugins (Kinemetrics K2, Lennartz MARS-88,
Lennartz PCM 5800, etc.) have been implemented by various users, but are not
(yet) included in the package. The included C language plugin interface is
described in section 5.1.1.5. Antelope, Earthworm and NAQS can also import data
from SeisComP. In SeisComP the class <a class="reference internal" href="global_recordstream.html#global-recordstream"><span class="std std-ref">RecordStream</span></a>
is implemented that supports both
SeedLink and ArcLink sources; this class is used by all SeisComP modules that
work with waveform data. On a lower level, SeedLink clients can be implemented
using the <span id="id2"><em>Libslink</em> [<a class="reference internal" href="../base/references.html#id148" title="Libslink. SeedLink client library written in C. URL: https://ds.iris.edu/ds/nodes/dmc/software/downloads/libslink/.">16</a>]</span> software library or its Java counterpart, JSeedLink. Libslink
supports Linux/UNIX, Windows and MacOS X platforms, and comes with an exhaustive
documentation in form of UNIX manual pages.</p>
using the <span id="id2"><em>Libslink</em> [<a class="reference internal" href="../base/references.html#id177" title="Libslink. SeedLink client library written in C. URL: https://ds.iris.edu/ds/nodes/dmc/software/downloads/libslink/.">17</a>]</span> software library or its Java counterpart,
JSeedLink. Libslink supports Linux/UNIX, Windows and MacOS X platforms, and
comes with an exhaustive documentation in form of UNIX manual pages.</p>
<table class="docutils align-left">
<colgroup>
<col style="width: 20.0%" />
@ -130,7 +140,7 @@ documentation in form of UNIX manual pages.</p>
<td><p>Chad Trabant (IRIS)</p></td>
</tr>
<tr class="row-odd"><td><p><a class="reference internal" href="#seedlink-sources-caps-label"><span class="std std-ref">caps</span></a></p></td>
<td><p>CAPS server <span id="id3">[<a class="reference internal" href="../base/references.html#id91" title="CAPS. gempa module. URL: https://docs.gempa.de/caps/current/index.html.">3</a>]</span></p></td>
<td><p>CAPS server <span id="id3">[<a class="reference internal" href="../base/references.html#id116" title="CAPS. gempa module. URL: https://docs.gempa.de/caps/current/index.html.">3</a>]</span></p></td>
<td><p><a class="reference external" href="https://www.gempa.de">gempa GmbH</a></p></td>
</tr>
<tr class="row-even"><td><p><a class="reference internal" href="#seedlink-sources-chain-label"><span class="std std-ref">chain</span></a></p></td>
@ -169,107 +179,111 @@ documentation in form of UNIX manual pages.</p>
<td><p>GDRT server</p></td>
<td><p>GFZ</p></td>
</tr>
<tr class="row-odd"><td><p><a class="reference internal" href="#seedlink-sources-hrd24-label"><span class="std std-ref">hrd24</span></a></p></td>
<tr class="row-odd"><td><p><a class="reference internal" href="#seedlink-sources-gmeteo-label"><span class="std std-ref">gmeteo</span></a></p></td>
<td><p>GFZ meteo protocol</p></td>
<td><p>GFZ</p></td>
</tr>
<tr class="row-even"><td><p><a class="reference internal" href="#seedlink-sources-hrd24-label"><span class="std std-ref">hrd24</span></a></p></td>
<td><p>Nanometrics HRD24</p></td>
<td><p>GFZ; Recai Yalgin</p></td>
</tr>
<tr class="row-even"><td><p><a class="reference internal" href="#seedlink-sources-liss-label"><span class="std std-ref">liss</span></a></p></td>
<tr class="row-odd"><td><p><a class="reference internal" href="#seedlink-sources-liss-label"><span class="std std-ref">liss</span></a></p></td>
<td><p>LISS</p></td>
<td><p>Chad Trabant (IRIS)</p></td>
</tr>
<tr class="row-odd"><td><p><a class="reference internal" href="#seedlink-sources-m24-label"><span class="std std-ref">m24</span></a> *</p></td>
<tr class="row-even"><td><p><a class="reference internal" href="#seedlink-sources-m24-label"><span class="std std-ref">m24</span></a> *</p></td>
<td><p>Lennartz M24</p></td>
<td><p>Lennartz Electronic GmbH</p></td>
</tr>
<tr class="row-even"><td><p><a class="reference internal" href="#seedlink-sources-maram-label"><span class="std std-ref">maram</span></a></p></td>
<tr class="row-odd"><td><p><a class="reference internal" href="#seedlink-sources-maram-label"><span class="std std-ref">maram</span></a></p></td>
<td><p>maRam Weatherstation V1</p></td>
<td><p>GFZ</p></td>
</tr>
<tr class="row-odd"><td><p><a class="reference internal" href="#seedlink-sources-minilogger-label"><span class="std std-ref">minilogger</span></a></p></td>
<tr class="row-even"><td><p><a class="reference internal" href="#seedlink-sources-minilogger-label"><span class="std std-ref">minilogger</span></a></p></td>
<td><p>SEP064 USB Seismometer Interface</p></td>
<td><p>GFZ; Anthony Lomax</p></td>
</tr>
<tr class="row-even"><td><p><a class="reference internal" href="#seedlink-sources-mseedfifo-label"><span class="std std-ref">mseedfifo</span></a></p></td>
<td><p>Generic</p></td>
<td><p>GFZ</p></td>
</tr>
<tr class="row-odd"><td><p><a class="reference internal" href="#seedlink-sources-mseedscan-label"><span class="std std-ref">mseedscan</span></a></p></td>
<td><p>Transfers miniSEED files from a directory</p></td>
<td><p>Chad Trabant (IRIS)</p></td>
</tr>
<tr class="row-even"><td><p><a class="reference internal" href="#seedlink-sources-mk6-label"><span class="std std-ref">mk6</span></a> *</p></td>
<tr class="row-odd"><td><p><a class="reference internal" href="#seedlink-sources-mk6-label"><span class="std std-ref">mk6</span></a> *</p></td>
<td><p>MK6</p></td>
<td><p>Jan Wiszniowski (IGPAS)</p></td>
</tr>
<tr class="row-odd"><td><p><a class="reference internal" href="#seedlink-sources-mppt-label"><span class="std std-ref">mppt</span></a> *</p></td>
<tr class="row-even"><td><p><a class="reference internal" href="#seedlink-sources-mppt-label"><span class="std std-ref">mppt</span></a> *</p></td>
<td><p>SunSaver MPPT via Modbus TCP/IP</p></td>
<td><p>GFZ</p></td>
</tr>
<tr class="row-even"><td><p><a class="reference internal" href="#seedlink-sources-mws-label"><span class="std std-ref">mws</span></a></p></td>
<tr class="row-odd"><td><p><a class="reference internal" href="#seedlink-sources-mseedfifo-label"><span class="std std-ref">mseedfifo</span></a></p></td>
<td><p>Generic</p></td>
<td><p>GFZ</p></td>
</tr>
<tr class="row-even"><td><p><a class="reference internal" href="#seedlink-sources-mseedscan-label"><span class="std std-ref">mseedscan</span></a></p></td>
<td><p>Transfers miniSEED files from a directory</p></td>
<td><p>Chad Trabant (IRIS)</p></td>
</tr>
<tr class="row-odd"><td><p><a class="reference internal" href="#seedlink-sources-mws-label"><span class="std std-ref">mws</span></a></p></td>
<td><p>Reinhardt MWS5/MWS9 Weather Station</p></td>
<td><p>GFZ</p></td>
</tr>
<tr class="row-odd"><td><p><a class="reference internal" href="#seedlink-sources-naqs-label"><span class="std std-ref">naqs</span></a></p></td>
<tr class="row-even"><td><p><a class="reference internal" href="#seedlink-sources-naqs-label"><span class="std std-ref">naqs</span></a></p></td>
<td><p>NAQS</p></td>
<td><p>Chad Trabant (IRIS); based on sample code from Nanometrics, Inc.</p></td>
</tr>
<tr class="row-even"><td><p><a class="reference internal" href="#seedlink-sources-nmxp-label"><span class="std std-ref">nmxp</span></a> *</p></td>
<tr class="row-odd"><td><p><a class="reference internal" href="#seedlink-sources-nmxp-label"><span class="std std-ref">nmxp</span></a> *</p></td>
<td><p>NAQS</p></td>
<td><p>Matteo Quintiliani (INGV)</p></td>
</tr>
<tr class="row-odd"><td><p>nrts **</p></td>
<tr class="row-even"><td><p>nrts **</p></td>
<td><p>NRTS</p></td>
<td><p>GFZ; based on ISI toolkit from David E. Chavez</p></td>
</tr>
<tr class="row-even"><td><p><a class="reference internal" href="#seedlink-sources-optodas-label"><span class="std std-ref">optodas</span></a></p></td>
<tr class="row-odd"><td><p><a class="reference internal" href="#seedlink-sources-optodas-label"><span class="std std-ref">optodas</span></a></p></td>
<td><p>OptoDAS interrogator via ZeroMQ</p></td>
<td><p>GFZ</p></td>
</tr>
<tr class="row-odd"><td><p><a class="reference internal" href="#seedlink-sources-ps2400-eth-label"><span class="std std-ref">ps2400_eth</span></a></p></td>
<tr class="row-even"><td><p><a class="reference internal" href="#seedlink-sources-ps2400-eth-label"><span class="std std-ref">ps2400_eth</span></a></p></td>
<td><p>Earth Data PS2400/PS6 Ethernet</p></td>
<td><p>GFZ; <a class="reference external" href="https://www.gempa.de">gempa GmbH</a></p></td>
</tr>
<tr class="row-even"><td><p><a class="reference internal" href="#seedlink-sources-q330-label"><span class="std std-ref">q330</span></a></p></td>
<tr class="row-odd"><td><p><a class="reference internal" href="#seedlink-sources-q330-label"><span class="std std-ref">q330</span></a></p></td>
<td><p>Quanterra Q330</p></td>
<td><p>GFZ; based on lib330 maintained by ISTI, Inc.</p></td>
</tr>
<tr class="row-odd"><td><p>comserv **</p></td>
<tr class="row-even"><td><p>comserv **</p></td>
<td><p>Quanterra Q380/Q680, Q4120, Q720</p></td>
<td><p>GFZ; based on Comserv by Quanterra, Inc.</p></td>
</tr>
<tr class="row-even"><td><p><a class="reference internal" href="#seedlink-sources-reftek-label"><span class="std std-ref">reftek</span></a></p></td>
<tr class="row-odd"><td><p><a class="reference internal" href="#seedlink-sources-reftek-label"><span class="std std-ref">reftek</span></a></p></td>
<td><p>RefTek RTPD</p></td>
<td><p>GFZ; based on software library provided by RefTek, Inc.</p></td>
</tr>
<tr class="row-odd"><td><p><a class="reference internal" href="#seedlink-sources-sadc-label"><span class="std std-ref">sadc</span></a></p></td>
<tr class="row-even"><td><p><a class="reference internal" href="#seedlink-sources-sadc-label"><span class="std std-ref">sadc</span></a></p></td>
<td><p>SARA SADC10/18/20/30</p></td>
<td><p>GFZ</p></td>
</tr>
<tr class="row-even"><td><p><a class="reference internal" href="#seedlink-sources-scream-label"><span class="std std-ref">scream</span></a></p></td>
<tr class="row-odd"><td><p><a class="reference internal" href="#seedlink-sources-scream-label"><span class="std std-ref">scream</span></a></p></td>
<td><p>SCREAM</p></td>
<td><p>Reinoud Sleeman (KNMI)</p></td>
</tr>
<tr class="row-odd"><td><p><a class="reference internal" href="#seedlink-sources-scream-ring-label"><span class="std std-ref">scream_ring</span></a></p></td>
<tr class="row-even"><td><p><a class="reference internal" href="#seedlink-sources-scream-ring-label"><span class="std std-ref">scream_ring</span></a></p></td>
<td><p>SCREAM</p></td>
<td><p>Reinoud Sleeman (KNMI), This is the second revision of the scream plugin which supports buffering for short-term completeness.</p></td>
</tr>
<tr class="row-even"><td><p><a class="reference internal" href="#seedlink-sources-vaisala-label"><span class="std std-ref">vaisala</span></a></p></td>
<tr class="row-odd"><td><p><a class="reference internal" href="#seedlink-sources-vaisala-label"><span class="std std-ref">vaisala</span></a></p></td>
<td><p>Vaisala ASCII protocol (serial plugin)</p></td>
<td><p>GFZ</p></td>
</tr>
<tr class="row-odd"><td><p><a class="reference internal" href="#seedlink-sources-wago-label"><span class="std std-ref">wago</span></a></p></td>
<tr class="row-even"><td><p><a class="reference internal" href="#seedlink-sources-wago-label"><span class="std std-ref">wago</span></a></p></td>
<td><p>WAGO MODBUS/TCP devices</p></td>
<td><p>GFZ</p></td>
</tr>
<tr class="row-even"><td><p><a class="reference internal" href="#seedlink-sources-wave24-label"><span class="std std-ref">wave24</span></a> *</p></td>
<tr class="row-odd"><td><p><a class="reference internal" href="#seedlink-sources-wave24-label"><span class="std std-ref">wave24</span></a> *</p></td>
<td><p>Wave24</p></td>
<td><p>MicroStep-MIS</p></td>
</tr>
<tr class="row-odd"><td><p><a class="reference internal" href="#seedlink-sources-win-label"><span class="std std-ref">win</span></a></p></td>
<tr class="row-even"><td><p><a class="reference internal" href="#seedlink-sources-win-label"><span class="std std-ref">win</span></a></p></td>
<td><p>WIN</p></td>
<td><p>GFZ; based on source code of WIN system</p></td>
</tr>
<tr class="row-even"><td><p>ws2300 **</p></td>
<tr class="row-odd"><td><p>ws2300 **</p></td>
<td><p>Lacrosse 2300 Weather Station</p></td>
<td><p>GFZ; based on open2300 library from Kenneth Lavrsen</p></td>
</tr>
@ -281,7 +295,7 @@ documentation in form of UNIX manual pages.</p>
<section id="telnet-interface">
<h3>Telnet interface<a class="headerlink" href="#telnet-interface" title="Permalink to this heading"></a></h3>
<p><strong class="program">seedlink</strong> provides a telnet interface accepting the commands set out in
<a class="reference internal" href="#seedlink-commands"><span class="std std-ref">Commands</span></a> through the seedlink <a class="reference internal" href="slmon.html#confval-port"><code class="xref std std-confval docutils literal notranslate"><span class="pre">port</span></code></a></p>
<a class="reference internal" href="#seedlink-commands"><span class="std std-ref">Commands</span></a> through the seedlink <a class="reference internal" href="slmon2.html#confval-port"><code class="xref std std-confval docutils literal notranslate"><span class="pre">port</span></code></a></p>
<div class="highlight-rst notranslate"><div class="highlight"><pre><span></span>telnet [host] [port]
</pre></div>
</div>
@ -430,15 +444,15 @@ In these files the following public functions are defined:</p>
<p>is used to send a raw packet (array of 32-bit integer samples) to SeedLink. The parameters are:</p>
<dl class="simple">
<dt>station</dt><dd><p>station ID, must match one of the defined stations in seedlink.ini. (Up to 10 characters.)</p>
<dt>station</dt><dd><p>station ID, must match one of the defined stations in <code class="file docutils literal notranslate"><span class="pre">seedlink.ini</span></code>. (Up to 10 characters.)</p>
</dd>
<dt>channel</dt><dd><p>channel ID, referenced by the “input” element in streams.xml. (Up to 10 characters.)</p>
<dt>channel</dt><dd><p>channel ID, referenced by the “input” element in <code class="file docutils literal notranslate"><span class="pre">streams.xml</span></code>. (Up to 10 characters.)</p>
</dd>
<dt>pt</dt><dd><p>time of the first sample in the array. If NULL then time is calculated relative to the previous send_raw3() call. struct ptime is defined in <code class="file docutils literal notranslate"><span class="pre">plugin.h</span></code>.</p>
</dd>
<dt>usec_correction</dt><dd><p>time correction in microseconds to be written in the SEED data header. Can be useful if the digitizer is not phase locked to GPS.</p>
</dd>
<dt>timing_quality</dt><dd><p>timing quality in percent (0-100). The number is directly written into miniSEED header (blockette 1001). Semantics is implementation-defined. Usually 100 means that GPS is in lock and 0 means there never was a GPS lock, so the timing is completely unreliable. When GPS goes out of lock, the value can slowly decrease reflecting a possible timedrift.</p>
<dt>timing_quality</dt><dd><p>timing quality in percent (0-100). The number is directly written into miniSEED header (blockette 1001). Semantics is implementation-defined. Usually 100 means that GPS is in lock and 0 means there never was a GPS lock, so the timing is completely unreliable. When GPS goes out of lock, the value can slowly decrease reflecting a possible time drift.</p>
</dd>
<dt>dataptr</dt><dd><p>Array of signed 32-bit samples.</p>
</dd>
@ -1174,7 +1188,7 @@ raw streams (streams submitted by a plugin as raw samples).</p>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-sources.chain.address">
<span class="sig-name descname"><span class="pre">sources.chain.address</span></span><a class="headerlink" href="#confval-sources.chain.address" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">geofon.gfz-potsdam.de</span></code></p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">geofon.gfz.de</span></code></p>
<p>Type: <em>string</em></p>
<p>Hostname or IP of the Seedlink server.</p>
</dd></dl>
@ -3128,7 +3142,7 @@ raw streams (streams submitted by a plugin as raw samples).</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>seiscomp &#8212; SeisComP Release documentation</title>
<title>seiscomp &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -187,8 +187,8 @@ seiscomp<span class="w"> </span>list<span class="w"> </span>started
</pre></div>
</div>
</section>
<section id="enable-disable">
<span id="sec-seiscomp-enable"></span><h3>Enable/disable <a class="footnote-reference brackets" href="#id7" id="id2" role="doc-noteref"><span class="fn-bracket">[</span>*<span class="fn-bracket">]</span></a><a class="headerlink" href="#enable-disable" title="Permalink to this heading"></a></h3>
<section id="enable-disable-1">
<span id="sec-seiscomp-enable"></span><h3>Enable/disable <a class="footnote-reference brackets" href="#id7" id="id2" role="doc-noteref"><span class="fn-bracket">[</span>1<span class="fn-bracket">]</span></a><a class="headerlink" href="#enable-disable-1" title="Permalink to this heading"></a></h3>
<p>Enabled modules will be started to run as a background daemon module.
You may enable or disable one or multiple modules. Examples:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>seiscomp<span class="w"> </span><span class="nb">enable</span><span class="w"> </span>scautopick
@ -197,8 +197,8 @@ seiscomp<span class="w"> </span>disable<span class="w"> </span>scautopick<span c
</pre></div>
</div>
</section>
<section id="start-stop-restart-reload">
<span id="sec-seiscomp-start"></span><h3>Start/stop/restart/reload <a href="#id8"><span class="problematic" id="id9"><span id="id3"></span>[*]_</span></a><a class="headerlink" href="#start-stop-restart-reload" title="Permalink to this heading"></a></h3>
<section id="start-stop-restart-reload-1">
<span id="sec-seiscomp-start"></span><h3>Start/stop/restart/reload <a class="footnote-reference brackets" href="#id7" id="id3" role="doc-noteref"><span class="fn-bracket">[</span>1<span class="fn-bracket">]</span></a><a class="headerlink" href="#start-stop-restart-reload-1" title="Permalink to this heading"></a></h3>
<p>Start all enabled modules:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>seiscomp<span class="w"> </span>start
</pre></div>
@ -227,8 +227,8 @@ daemon modules. Therefore, they cannot be started but they can
be <a class="reference internal" href="#sec-seiscomp-execute"><span class="std std-ref">executed</span></a>.</p>
</div>
</section>
<section id="check">
<span id="sec-seiscomp-check"></span><h3>Check <a href="#id8"><span class="problematic" id="id10"><span id="id4"></span>[*]_</span></a><a class="headerlink" href="#check" title="Permalink to this heading"></a></h3>
<section id="check-1">
<span id="sec-seiscomp-check"></span><h3>Check <a class="footnote-reference brackets" href="#id7" id="id4" role="doc-noteref"><span class="fn-bracket">[</span>1<span class="fn-bracket">]</span></a><a class="headerlink" href="#check-1" title="Permalink to this heading"></a></h3>
<p>When modules stop unexpectedly, they are not stopped in a clean way. Such
stopped modules may be detected and started again in order to minimize
downtimes. Apply the <strong class="command">check</strong> command to all or specific modules.
@ -258,8 +258,8 @@ scautopick<span class="w"> </span>--debug
</div>
</div>
</section>
<section id="status">
<span id="sec-seiscomp-status"></span><h3>Status <a href="#id8"><span class="problematic" id="id11"><span id="id5"></span>[*]_</span></a><a class="headerlink" href="#status" title="Permalink to this heading"></a></h3>
<section id="status-1">
<span id="sec-seiscomp-status"></span><h3>Status <a class="footnote-reference brackets" href="#id7" id="id5" role="doc-noteref"><span class="fn-bracket">[</span>1<span class="fn-bracket">]</span></a><a class="headerlink" href="#status-1" title="Permalink to this heading"></a></h3>
<p>List the status of all, enabled, disabled, started, or specific modules.
Examples:</p>
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>seiscomp<span class="w"> </span>status
@ -306,8 +306,8 @@ interactively.</p>
</pre></div>
</div>
</section>
<section id="update-configuration">
<span id="sec-seiscomp-update"></span><h3>Update configuration <a href="#id8"><span class="problematic" id="id12"><span id="id6"></span>[*]_</span></a><a class="headerlink" href="#update-configuration" title="Permalink to this heading"></a></h3>
<section id="update-configuration-1">
<span id="sec-seiscomp-update"></span><h3>Update configuration <a class="footnote-reference brackets" href="#id7" id="id6" role="doc-noteref"><span class="fn-bracket">[</span>1<span class="fn-bracket">]</span></a><a class="headerlink" href="#update-configuration-1" title="Permalink to this heading"></a></h3>
<p>The command <strong class="command">update-config</strong> allows reading bindings configurations from
the standard <code class="file docutils literal notranslate"><span class="pre">&#64;KEYDIR&#64;</span></code> directory as well as inventory from
<code class="file docutils literal notranslate"><span class="pre">&#64;SYSTEMCONFIGDIR&#64;/inventory</span></code> and sending them to the messaging for
@ -403,7 +403,8 @@ Commands:
<p class="admonition-title">Note</p>
<aside class="footnote-list brackets">
<aside class="footnote brackets" id="id7" role="doc-footnote">
<span class="label"><span class="fn-bracket">[</span><a role="doc-backlink" href="#id2">*</a><span class="fn-bracket">]</span></span>
<span class="label"><span class="fn-bracket">[</span>1<span class="fn-bracket">]</span></span>
<span class="backrefs">(<a role="doc-backlink" href="#id2">1</a>,<a role="doc-backlink" href="#id3">2</a>,<a role="doc-backlink" href="#id4">3</a>,<a role="doc-backlink" href="#id5">4</a>,<a role="doc-backlink" href="#id6">5</a>)</span>
<p>With this command, the flag <code class="xref std std-option docutils literal notranslate"><span class="pre">--invert</span></code> can be used
in order to invert the application to the specific modules. You may provide
one or more module names. A major application is to
@ -496,13 +497,13 @@ file, e.g., <cite>seiscomp --wait 10 update-config</cite>.</p>
<li><a class="reference internal" href="#print">Print</a></li>
<li><a class="reference internal" href="#basic-setup">Basic setup</a></li>
<li><a class="reference internal" href="#list">List</a></li>
<li><a class="reference internal" href="#enable-disable">Enable/disable </a></li>
<li><a class="reference internal" href="#start-stop-restart-reload">Start/stop/restart/reload [*]_</a></li>
<li><a class="reference internal" href="#check">Check [*]_</a></li>
<li><a class="reference internal" href="#enable-disable-1">Enable/disable </a></li>
<li><a class="reference internal" href="#start-stop-restart-reload-1">Start/stop/restart/reload </a></li>
<li><a class="reference internal" href="#check-1">Check </a></li>
<li><a class="reference internal" href="#execute">Execute</a></li>
<li><a class="reference internal" href="#status">Status [*]_</a></li>
<li><a class="reference internal" href="#status-1">Status </a></li>
<li><a class="reference internal" href="#module-aliases">Module Aliases</a></li>
<li><a class="reference internal" href="#update-configuration">Update configuration [*]_</a></li>
<li><a class="reference internal" href="#update-configuration-1">Update configuration </a></li>
</ul>
</li>
<li><a class="reference internal" href="#seiscomp-shell">seiscomp Shell</a></li>
@ -544,7 +545,7 @@ file, e.g., <cite>seiscomp --wait 10 update-config</cite>.</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>sh2proc &#8212; SeisComP Release documentation</title>
<title>sh2proc &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -456,12 +456,14 @@ This option can be given more than once.</p>
<dt class="sig sig-object std" id="cmdoption-sh2proc-content-type">
<span class="sig-name descname"><span class="pre">--content-type</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-sh2proc-content-type" title="Permalink to this definition"></a></dt>
<dd><p>Overrides configuration parameter <a class="reference internal" href="global.html#confval-connection.contentType"><code class="xref std std-confval docutils literal notranslate"><span class="pre">connection.contentType</span></code></a>.</p>
<p>Default: <code class="docutils literal notranslate"><span class="pre">binary</span></code></p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-sh2proc-start-stop-msg">
<span class="sig-name descname"><span class="pre">--start-stop-msg</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-sh2proc-start-stop-msg" title="Permalink to this definition"></a></dt>
<dd><p>Set sending of a start and a stop message.</p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">0</span></code></p>
<p>Set sending of a start and a stop message.</p>
</dd></dl>
</section>
@ -578,7 +580,7 @@ can be queried with &quot;--db-driver-list&quot;.</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>slarchive &#8212; SeisComP Release documentation</title>
<title>slarchive &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -617,7 +617,7 @@ server will send data indefinitely. This option will override any saved state in
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>slinktool &#8212; SeisComP Release documentation</title>
<title>slinktool &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -310,7 +310,9 @@ including information from fixed header and 100/1000/1001 blockettes.</p>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-slinktool-nd">
<span class="sig-name descname"><span class="pre">-nd</span></span><span class="sig-prename descclassname"> <span class="pre">delay</span></span><a class="headerlink" href="#cmdoption-slinktool-nd" title="Permalink to this definition"></a></dt>
<dd><p>The network reconnect delay for the connection to the SeedLink server.
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">30</span></code></p>
<p>Unit: <em>s</em></p>
<p>The network reconnect delay for the connection to the SeedLink server.
If the connection breaks for any reason this will govern how soon a reconnection should
be attempted.</p>
</dd></dl>
@ -327,7 +329,8 @@ A value of 0 disables the timeout.</p>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-slinktool-k">
<span class="sig-name descname"><span class="pre">-k</span></span><span class="sig-prename descclassname"> <span class="pre">interval</span></span><a class="headerlink" href="#cmdoption-slinktool-k" title="Permalink to this definition"></a></dt>
<dd><p>Interval at which keepalive (heartbeat) packets are sent to the server.
<dd><p>Unit: <em>s</em></p>
<p>Interval at which keepalive (heartbeat) packets are sent to the server.
Keepalive packets are only sent if nothing is received within the interval.</p>
</dd></dl>
@ -544,7 +547,7 @@ of the -A option. The BUD dir/file structure is:</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>slmon &#8212; SeisComP Release documentation</title>
<title>slmon &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,12 +12,12 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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="Addon Modules" href="../base/addons.html" />
<link rel="next" title="slmon2" href="slmon2.html" />
<link rel="prev" title="sh2proc" href="sh2proc.html" />
</head>
<body>
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -43,7 +43,7 @@
</a>
</li>
<li class="right">
<a href="../base/addons.html" title="Addon Modules"
<a href="slmon2.html" title="slmon2"
accesskey="N">
next
</a>
@ -279,8 +279,8 @@ Not mandatory.</p>
</div>
<div>
<h4>Next topic</h4>
<p class="topless"><a href="../base/addons.html"
title="next chapter">Addon Modules</a></p>
<p class="topless"><a href="slmon2.html"
title="next chapter">slmon2</a></p>
</div>
<div role="note" aria-label="source link">
<h3>This Page</h3>
@ -301,7 +301,7 @@ Not mandatory.</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.

View File

@ -0,0 +1,268 @@
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>slmon2 &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
<link rel="stylesheet" type="text/css" href="../_static/seiscomp.css?v=c6da7ce6" />
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></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="Addon Modules" href="../base/addons.html" />
<link rel="prev" title="slmon" href="slmon.html" />
</head>
<body>
<div class="header">
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
<div class="nav">
<div class="container">
<div class="content"><a class="pull-right" id="sidebar-toggle">TOC</a>
<div class="related" role="navigation" aria-label="related navigation">
<ul>
<li class="right">
<a href="../genindex.html" title="General Index"
accesskey="I">
index
</a>
</li>
<li class="right">
<a href="../base/addons.html" title="Addon Modules"
accesskey="N">
next
</a>
</li>
<li class="right">
<a href="slmon.html" title="slmon"
accesskey="P">
previous
</a>
</li>
<li class="nav-item nav-item-0">
<a href="../index.html">Home</a>
</li>
<li class="nav-item nav-item-1">
<a href="../modules.html" >Modules</a>
</li>
<li class="nav-item nav-item-2">
<a href="../toc/utilities.html" accesskey="U">Utilities</a>
</li>
</ul>
</div>
</div>
</div>
</div>
<div class="container">
<div class="fitted content" id="anchors-container">
<div class="body" role="main">
<section id="slmon2">
<span id="id1"></span><h1>slmon2<a class="headerlink" href="#slmon2" title="Permalink to this heading"></a></h1>
<p><strong>SeedLink monitor creating web pages</strong></p>
<section id="module-configuration">
<span id="slmon2-configuration"></span><h2>Module Configuration<a class="headerlink" href="#module-configuration" title="Permalink to this heading"></a></h2>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>slmon2 is a <a class="reference internal" href="../base/glossary.html#term-standalone-module"><span class="xref std std-term">standalone module</span></a> and does not inherit <a class="reference internal" href="global.html#global-configuration"><span class="std std-ref">global options</span></a>.</p>
</div>
<div class="line-block">
<div class="line"><code class="file docutils literal notranslate"><span class="pre">etc/defaults/slmon2.cfg</span></code></div>
<div class="line"><code class="file docutils literal notranslate"><span class="pre">etc/slmon2.cfg</span></code></div>
<div class="line"><code class="file docutils literal notranslate"><span class="pre">~/.seiscomp/slmon2.cfg</span></code></div>
</div>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-title">
<span class="sig-name descname"><span class="pre">title</span></span><a class="headerlink" href="#confval-title" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">&quot;SeedLink</span> <span class="pre">Monitor&quot;</span></code></p>
<p>Type: <em>string</em></p>
<p>Title of the web page used as heading.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-refresh">
<span class="sig-name descname"><span class="pre">refresh</span></span><a class="headerlink" href="#confval-refresh" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">180</span></code></p>
<p>Type: <em>double</em></p>
<p>Unit: <em>s</em></p>
<p>Refresh interval of the generated web page used by the browser.
The interval should be similar to the interval for starting slmon.
If empty, the web page must be manually refreshed from within
the browser.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-address">
<span class="sig-name descname"><span class="pre">address</span></span><a class="headerlink" href="#confval-address" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">127.0.0.1</span></code></p>
<p>Type: <em>string</em></p>
<p>Host of the Seedlink server to connect to. If the acquisition
is running on one system nothing needs to be changed.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-port">
<span class="sig-name descname"><span class="pre">port</span></span><a class="headerlink" href="#confval-port" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">18000</span></code></p>
<p>Type: <em>int</em></p>
<p>The port of the Seedlink server to connect to. If the acquisition
is running on one system this port must match the configured
local Seedlink port.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-email">
<span class="sig-name descname"><span class="pre">email</span></span><a class="headerlink" href="#confval-email" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>e-mail address added to web pages.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-wwwdir">
<span class="sig-name descname"><span class="pre">wwwdir</span></span><a class="headerlink" href="#confval-wwwdir" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">&#64;ROOTDIR&#64;/var/run/&#64;NAME&#64;</span></code></p>
<p>Type: <em>string</em></p>
<p>Output directory of the web pages.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-icon">
<span class="sig-name descname"><span class="pre">icon</span></span><a class="headerlink" href="#confval-icon" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">http://www.gfz-potsdam.de/favicon.ico</span></code></p>
<p>Type: <em>string</em></p>
<p>Favicon URL of the web pages. Not mandatory.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-linkname">
<span class="sig-name descname"><span class="pre">linkname</span></span><a class="headerlink" href="#confval-linkname" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">GEOFON</span></code></p>
<p>Type: <em>string</em></p>
<p>Name of Link shown in footer of web pages.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-linkurl">
<span class="sig-name descname"><span class="pre">linkurl</span></span><a class="headerlink" href="#confval-linkurl" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">http://www.gfz-potsdam.de/geofon/</span></code></p>
<p>Type: <em>string</em></p>
<p>URL referred to by linkname in footer of web pages.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-liveurl">
<span class="sig-name descname"><span class="pre">liveurl</span></span><a class="headerlink" href="#confval-liveurl" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">http://geofon.gfz-potsdam.de/waveform/liveseis.php?station=%s</span></code></p>
<p>Type: <em>string</em></p>
<p>URL to live seismograms. %s will be replaced by station name.
Not mandatory.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-fdsnws_url">
<span class="sig-name descname"><span class="pre">fdsnws_url</span></span><a class="headerlink" href="#confval-fdsnws_url" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">http://localhost:8080/fdsnws/</span></code></p>
<p>Type: <em>string</em></p>
<p>FDSNWS base URL. Used to get station coordinates.</p>
</dd></dl>
</section>
<section id="bindings-parameters">
<h2>Bindings Parameters<a class="headerlink" href="#bindings-parameters" title="Permalink to this heading"></a></h2>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-group">
<span class="sig-name descname"><span class="pre">group</span></span><a class="headerlink" href="#confval-group" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">local</span></code></p>
<p>Type: <em>string</em></p>
<p>Defines the group of the station that is monitored.</p>
</dd></dl>
</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="#">slmon2</a><ul>
<li><a class="reference internal" href="#module-configuration">Module Configuration</a></li>
<li><a class="reference internal" href="#bindings-parameters">Bindings Parameters</a></li>
</ul>
</li>
</ul>
</div>
<div>
<h4>Previous topic</h4>
<p class="topless"><a href="slmon.html"
title="previous chapter">slmon</a></p>
</div>
<div>
<h4>Next topic</h4>
<p class="topless"><a href="../base/addons.html"
title="next chapter">Addon Modules</a></p>
</div>
<div role="note" aria-label="source link">
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="../_sources/apps/slmon2.rst.txt"
rel="nofollow">Show Source</a></li>
</ul>
</div>
</div>
</div>
</div>
</div>
<div class="footer">
<div class="container">
<div class="horizontal layout content">
<a class="fade-in" href="https://www.gempa.de" target="_blank">
<img class="brand" src="../_static/brands/gempa.svg"/>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.
</div>
</div>
<a class="fade-in" href="https://www.gfz-potsdam.de" target="_blank">
<img class="brand" src="../_static/brands/gfz.svg"/>
</a>
</div>
</div>
</div>
</body>
</html>

Some files were not shown because too many files have changed in this diff Show More