[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>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.