|
|
<!DOCTYPE html>
|
|
|
|
|
|
<html >
|
|
|
<head>
|
|
|
<meta charset="utf-8" />
|
|
|
<title>screloc — SeisComP Release documentation</title>
|
|
|
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
|
|
|
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
|
|
|
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css" />
|
|
|
<script type="text/javascript" src="../_static/seiscomp.js"></script>
|
|
|
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
|
|
|
<script src="../_static/jquery.js"></script>
|
|
|
<script src="../_static/underscore.js"></script>
|
|
|
<script src="../_static/doctools.js"></script>
|
|
|
<script src="../_static/language_data.js"></script>
|
|
|
<link rel="shortcut icon" href="../_static/favicon.ico"/>
|
|
|
<link rel="index" title="Index" href="../genindex.html" />
|
|
|
<link rel="search" title="Search" href="../search.html" />
|
|
|
<link rel="next" title="scwfparam" href="scwfparam.html" />
|
|
|
<link rel="prev" title="scqc" href="scqc.html" />
|
|
|
</head>
|
|
|
<body>
|
|
|
<div class="header">
|
|
|
<div class="container">
|
|
|
<div class="brand">
|
|
|
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
|
|
|
<!-- span class="title">SeisComP Release</span -->
|
|
|
<span class="version">5.3.0</span>
|
|
|
</div>
|
|
|
</div>
|
|
|
</div>
|
|
|
<div class="nav">
|
|
|
<div class="container">
|
|
|
<div class="content"><a class="pull-right" id="sidebar-toggle">TOC</a>
|
|
|
|
|
|
<div class="related" role="navigation" aria-label="related navigation">
|
|
|
<ul>
|
|
|
<li class="right">
|
|
|
<a href="../genindex.html" title="General Index"
|
|
|
accesskey="I">
|
|
|
index
|
|
|
</a>
|
|
|
</li>
|
|
|
<li class="right">
|
|
|
<a href="scwfparam.html" title="scwfparam"
|
|
|
accesskey="N">
|
|
|
next
|
|
|
</a>
|
|
|
</li>
|
|
|
<li class="right">
|
|
|
<a href="scqc.html" title="scqc"
|
|
|
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">
|
|
|
|
|
|
<div class="section" id="screloc">
|
|
|
<span id="id1"></span><h1>screloc<a class="headerlink" href="#screloc" title="Permalink to this headline">¶</a></h1>
|
|
|
<p><strong>Automatic relocator.</strong></p>
|
|
|
<div class="section" id="description">
|
|
|
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline">¶</a></h2>
|
|
|
<p>screloc is an automatic relocator that receives origins from realtime
|
|
|
locators such as scautoloc and relocates them with a configurable locator.
|
|
|
screloc can be conveniently used to test different locators and velocity models
|
|
|
or to relocate events with updated velocity models. Check the
|
|
|
<a class="reference internal" href="#screloc-example"><span class="std std-ref">Example applications</span></a> for screloc.</p>
|
|
|
<p>screloc processes any incoming automatic origin but does not yet listen to event
|
|
|
information nor does it skip origins for that a more recent one exists.</p>
|
|
|
<p>To run screloc along with all processing modules add it to the list of
|
|
|
clients in the seiscomp configuration frontend.</p>
|
|
|
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>seiscomp <span class="nb">enable</span> screloc
|
|
|
seiscomp start screloc
|
|
|
</pre></div>
|
|
|
</div>
|
|
|
<p>Descriptions of parameters for screloc:</p>
|
|
|
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>seiscomp <span class="nb">exec</span> screloc -h
|
|
|
</pre></div>
|
|
|
</div>
|
|
|
<p>Test the performance of screloc and learn from debug output:</p>
|
|
|
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>seiscomp <span class="nb">exec</span> screloc --debug
|
|
|
</pre></div>
|
|
|
</div>
|
|
|
</div>
|
|
|
<div class="section" id="setup">
|
|
|
<h2>Setup<a class="headerlink" href="#setup" title="Permalink to this headline">¶</a></h2>
|
|
|
<p>The following example configuration shows a setup of screloc for
|
|
|
<a class="reference internal" href="global_nonlinloc.html#global-nonlinloc"><span class="std std-ref">NonLinLoc</span></a>:</p>
|
|
|
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="nv">plugins</span> <span class="o">=</span> <span class="si">${</span><span class="nv">plugins</span><span class="si">}</span>, locnll
|
|
|
|
|
|
<span class="c1"># Define the locator algorithm to use</span>
|
|
|
reloc.locator <span class="o">=</span> NonLinLoc
|
|
|
|
|
|
<span class="c1"># Define a suffix appended to the publicID of the origin to be relocated</span>
|
|
|
<span class="c1"># to form the new publicID.</span>
|
|
|
<span class="c1"># This helps to identify pairs of origins before and after relocation.</span>
|
|
|
<span class="c1"># However, new publicIDs are unrelated to the time of creation.</span>
|
|
|
<span class="c1"># If not defined, a new publicID will be generated automatically.</span>
|
|
|
reloc.originIDSuffix <span class="o">=</span> <span class="s2">"#relocated"</span>
|
|
|
|
|
|
<span class="c1">########################################################</span>
|
|
|
<span class="c1">################ NonLinLoc configuration################</span>
|
|
|
<span class="c1">########################################################</span>
|
|
|
<span class="nv">NLLROOT</span> <span class="o">=</span> <span class="si">${</span><span class="nv">HOME</span><span class="si">}</span>/nll/data
|
|
|
|
|
|
NonLinLoc.outputPath <span class="o">=</span> <span class="si">${</span><span class="nv">NLLROOT</span><span class="si">}</span>/output/
|
|
|
|
|
|
<span class="c1"># Define the default control file if no profile specific</span>
|
|
|
<span class="c1"># control file is defined.</span>
|
|
|
NonLinLoc.controlFile <span class="o">=</span> <span class="si">${</span><span class="nv">NLLROOT</span><span class="si">}</span>/NLL.default.conf
|
|
|
|
|
|
<span class="c1"># Set the default pick error in seconds passed to NonLinLoc</span>
|
|
|
<span class="c1"># if no SeisComP pick uncertainty is available.</span>
|
|
|
NonLinLoc.defaultPickError <span class="o">=</span> <span class="m">0</span>.1
|
|
|
|
|
|
<span class="c1"># Define the available NonLinLoc location profiles. The order</span>
|
|
|
<span class="c1"># implicitly defines the priority for overlapping regions</span>
|
|
|
<span class="c1">#NonLinLoc.profiles = swiss_3d, swiss_1d, global</span>
|
|
|
NonLinLoc.profiles <span class="o">=</span> swiss_3d, global
|
|
|
|
|
|
<span class="c1"># The earthModelID is copied to earthModelID attribute of the</span>
|
|
|
<span class="c1"># resulting origin</span>
|
|
|
NonLinLoc.profile.swiss_1d.earthModelID <span class="o">=</span> <span class="s2">"swiss regional 1D"</span>
|
|
|
|
|
|
<span class="c1"># Specify the velocity model table path as used by NonLinLoc</span>
|
|
|
NonLinLoc.profile.swiss_1d.tablePath <span class="o">=</span> <span class="si">${</span><span class="nv">NLLROOT</span><span class="si">}</span>/time_1d_regio/regio
|
|
|
|
|
|
<span class="c1"># Specify the region valid for this profile</span>
|
|
|
NonLinLoc.profile.swiss_1d.region <span class="o">=</span> <span class="m">41</span>.2, <span class="m">3</span>.8, <span class="m">50</span>.1, <span class="m">16</span>.8
|
|
|
|
|
|
<span class="c1"># The NonLinLoc default control file to use for this profile</span>
|
|
|
NonLinLoc.profile.swiss_1d.controlFile <span class="o">=</span> <span class="si">${</span><span class="nv">NLLROOT</span><span class="si">}</span>/NLL.swiss_1d.conf
|
|
|
|
|
|
<span class="c1"># Configure the swiss_3d profile</span>
|
|
|
NonLinLoc.profile.swiss_3d.earthModelID <span class="o">=</span> <span class="s2">"swiss regional 3D"</span>
|
|
|
NonLinLoc.profile.swiss_3d.tablePath <span class="o">=</span> <span class="si">${</span><span class="nv">NLLROOT</span><span class="si">}</span>/time_3d/ch
|
|
|
NonLinLoc.profile.swiss_3d.region <span class="o">=</span> <span class="m">45</span>.15, <span class="m">5</span>.7, <span class="m">48</span>.3, <span class="m">11</span>.0
|
|
|
NonLinLoc.profile.swiss_3d.controlFile <span class="o">=</span> <span class="si">${</span><span class="nv">NLLROOT</span><span class="si">}</span>/NLL.swiss_3d.conf
|
|
|
|
|
|
<span class="c1"># And the global profile</span>
|
|
|
NonLinLoc.profile.global.earthModelID <span class="o">=</span> iaspei91
|
|
|
NonLinLoc.profile.global.tablePath <span class="o">=</span> <span class="si">${</span><span class="nv">NLLROOT</span><span class="si">}</span>/iasp91/iasp91
|
|
|
NonLinLoc.profile.global.controlFile <span class="o">=</span> <span class="si">${</span><span class="nv">NLLROOT</span><span class="si">}</span>/NLL.global.conf
|
|
|
</pre></div>
|
|
|
</div>
|
|
|
</div>
|
|
|
<div class="section" id="examples">
|
|
|
<span id="screloc-example"></span><h2>Examples<a class="headerlink" href="#examples" title="Permalink to this headline">¶</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><your_profile>
|
|
|
<span class="c1"># set userID</span>
|
|
|
<span class="nv">userID</span><span class="o">=</span><span class="s2">"<your_user>"</span>
|
|
|
<span class="c1"># set authorID</span>
|
|
|
<span class="nv">authorID</span><span class="o">=</span><span class="s2">"<screloc>"</span>
|
|
|
|
|
|
<span class="k">for</span> i in <span class="sb">`</span>scevtls -d mysql://sysop:sysop@localhost/seiscomp --begin <span class="s1">'2015-01-01 00:00:00'</span> --end <span class="s1">'2015-02-01 00:00:00'</span><span class="sb">`</span><span class="p">;</span> <span class="k">do</span>
|
|
|
|
|
|
<span class="nv">orgID</span><span class="o">=</span><span class="sb">`</span><span class="nb">echo</span> <span class="s2">"select preferredOriginID from Event,PublicObject where Event._oid=PublicObject._oid and PublicObject.publicID='</span><span class="nv">$i</span><span class="s2">'"</span> <span class="p">|</span><span class="se">\</span>
|
|
|
mysql -u sysop -p sysop -D seiscomp -h localhost -N<span class="sb">`</span>
|
|
|
|
|
|
screloc -O <span class="nv">$orgID</span> -d localhost --locator NonLinLoc --profile <span class="nv">$profile</span> -u <span class="nv">$userID</span> --debug --author<span class="o">=</span><span class="nv">$authorID</span>
|
|
|
|
|
|
<span class="k">done</span>
|
|
|
</pre></div>
|
|
|
</div>
|
|
|
</li>
|
|
|
</ul>
|
|
|
</div>
|
|
|
<div class="section" id="module-configuration">
|
|
|
<span id="screloc-configuration"></span><h2>Module Configuration<a class="headerlink" href="#module-configuration" title="Permalink to this headline">¶</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/screloc.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/screloc.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/screloc.cfg</span></code></div>
|
|
|
</div>
|
|
|
<p>screloc inherits <a class="reference internal" href="global.html#global-configuration"><span class="std std-ref">global options</span></a>.</p>
|
|
|
<dl class="confval">
|
|
|
<dt id="confval-reloc.locator">
|
|
|
<code class="sig-name descname">reloc.locator</code><a class="headerlink" href="#confval-reloc.locator" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>Type: <em>string</em></p>
|
|
|
<p>Defines the locator to be used such as NonLinLoc.</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="confval">
|
|
|
<dt id="confval-reloc.profile">
|
|
|
<code class="sig-name descname">reloc.profile</code><a class="headerlink" href="#confval-reloc.profile" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>Type: <em>string</em></p>
|
|
|
<p>The locator profile to use.</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="confval">
|
|
|
<dt id="confval-reloc.ignoreRejectedOrigins">
|
|
|
<code class="sig-name descname">reloc.ignoreRejectedOrigins</code><a class="headerlink" href="#confval-reloc.ignoreRejectedOrigins" 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>Ignores origins with status REJECTED.</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="confval">
|
|
|
<dt id="confval-reloc.allowPreliminaryOrigins">
|
|
|
<code class="sig-name descname">reloc.allowPreliminaryOrigins</code><a class="headerlink" href="#confval-reloc.allowPreliminaryOrigins" 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>Triggers processing also on origins with status PRELIMINARY.</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="confval">
|
|
|
<dt id="confval-reloc.allowManualOrigins">
|
|
|
<code class="sig-name descname">reloc.allowManualOrigins</code><a class="headerlink" href="#confval-reloc.allowManualOrigins" 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>Triggers processing also on origins with mode MANUAL. Otherwise
|
|
|
only origins with mode AUTOMATIC are considered.</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="confval">
|
|
|
<dt id="confval-reloc.useWeight">
|
|
|
<code class="sig-name descname">reloc.useWeight</code><a class="headerlink" href="#confval-reloc.useWeight" 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 use the weight of the picks associated with the
|
|
|
input origin as defined in the input origin as input for
|
|
|
the locator or not. If false then all picks associated with
|
|
|
the input origin will be forwarded to the locator with full
|
|
|
weight.</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="confval">
|
|
|
<dt id="confval-reloc.adoptFixedDepth">
|
|
|
<code class="sig-name descname">reloc.adoptFixedDepth</code><a class="headerlink" href="#confval-reloc.adoptFixedDepth" 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 the input origin’s depth is fixed then it will be fixed
|
|
|
during the relocation process as well.</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="confval">
|
|
|
<dt id="confval-reloc.storeSourceOriginID">
|
|
|
<code class="sig-name descname">reloc.storeSourceOriginID</code><a class="headerlink" href="#confval-reloc.storeSourceOriginID" 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 store the ID of the input origin as comment in the
|
|
|
relocated origin or not.</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="confval">
|
|
|
<dt id="confval-reloc.originIDSuffix">
|
|
|
<code class="sig-name descname">reloc.originIDSuffix</code><a class="headerlink" href="#confval-reloc.originIDSuffix" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>Type: <em>string</em></p>
|
|
|
<p>Suffix appended to the publicID of the origin to be relocated
|
|
|
to form the new publicID. This
|
|
|
helps to identify pairs of origins before and after relocation.
|
|
|
However, new publicIDs are unrelated to the time of creation.
|
|
|
If not defined, a new publicID will be generated automatically.</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
</div>
|
|
|
<div class="section" id="command-line-options">
|
|
|
<h2>Command-Line Options<a class="headerlink" href="#command-line-options" title="Permalink to this headline">¶</a></h2>
|
|
|
<div class="section" id="generic">
|
|
|
<h3>Generic<a class="headerlink" href="#generic" title="Permalink to this headline">¶</a></h3>
|
|
|
<dl class="option">
|
|
|
<dt id="cmdoption-screloc-h">
|
|
|
<code class="sig-name descname">-h</code><code class="sig-prename descclassname"></code><code class="sig-prename descclassname">, </code><code class="sig-name descname">--help</code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-screloc-h" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>Show help message.</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="option">
|
|
|
<dt id="cmdoption-screloc-v">
|
|
|
<code class="sig-name descname">-V</code><code class="sig-prename descclassname"></code><code class="sig-prename descclassname">, </code><code class="sig-name descname">--version</code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-screloc-v" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>Show version information.</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="option">
|
|
|
<dt id="cmdoption-screloc-config-file">
|
|
|
<code class="sig-name descname">--config-file</code><code class="sig-prename descclassname"> arg</code><a class="headerlink" href="#cmdoption-screloc-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 -> scautopick2.</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="option">
|
|
|
<dt id="cmdoption-screloc-plugins">
|
|
|
<code class="sig-name descname">--plugins</code><code class="sig-prename descclassname"> arg</code><a class="headerlink" href="#cmdoption-screloc-plugins" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>Load given plugins.</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="option">
|
|
|
<dt id="cmdoption-screloc-d">
|
|
|
<code class="sig-name descname">-D</code><code class="sig-prename descclassname"></code><code class="sig-prename descclassname">, </code><code class="sig-name descname">--daemon</code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-screloc-d" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>Run as daemon. This means the application will fork itself
|
|
|
and doesn’t need to be started with &.</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="option">
|
|
|
<dt id="cmdoption-screloc-auto-shutdown">
|
|
|
<code class="sig-name descname">--auto-shutdown</code><code class="sig-prename descclassname"> arg</code><a class="headerlink" href="#cmdoption-screloc-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="option">
|
|
|
<dt id="cmdoption-screloc-shutdown-master-module">
|
|
|
<code class="sig-name descname">--shutdown-master-module</code><code class="sig-prename descclassname"> arg</code><a class="headerlink" href="#cmdoption-screloc-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="option">
|
|
|
<dt id="cmdoption-screloc-shutdown-master-username">
|
|
|
<code class="sig-name descname">--shutdown-master-username</code><code class="sig-prename descclassname"> arg</code><a class="headerlink" href="#cmdoption-screloc-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 “shutdown-master-module” is
|
|
|
given as well, this parameter is ignored.</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
</div>
|
|
|
<div class="section" id="verbosity">
|
|
|
<h3>Verbosity<a class="headerlink" href="#verbosity" title="Permalink to this headline">¶</a></h3>
|
|
|
<dl class="option">
|
|
|
<dt id="cmdoption-screloc-verbosity">
|
|
|
<code class="sig-name descname">--verbosity</code><code class="sig-prename descclassname"> arg</code><a class="headerlink" href="#cmdoption-screloc-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="option">
|
|
|
<dt id="id2">
|
|
|
<code class="sig-name descname">-v</code><code class="sig-prename descclassname"></code><code class="sig-prename descclassname">, </code><code class="sig-name descname">--v</code><code class="sig-prename descclassname"></code><a class="headerlink" href="#id2" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>Increase verbosity level (may be repeated, eg. -vv).</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="option">
|
|
|
<dt id="cmdoption-screloc-q">
|
|
|
<code class="sig-name descname">-q</code><code class="sig-prename descclassname"></code><code class="sig-prename descclassname">, </code><code class="sig-name descname">--quiet</code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-screloc-q" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>Quiet mode: no logging output.</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="option">
|
|
|
<dt id="cmdoption-screloc-component">
|
|
|
<code class="sig-name descname">--component</code><code class="sig-prename descclassname"> arg</code><a class="headerlink" href="#cmdoption-screloc-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="option">
|
|
|
<dt id="cmdoption-screloc-s">
|
|
|
<code class="sig-name descname">-s</code><code class="sig-prename descclassname"></code><code class="sig-prename descclassname">, </code><code class="sig-name descname">--syslog</code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-screloc-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="option">
|
|
|
<dt id="cmdoption-screloc-l">
|
|
|
<code class="sig-name descname">-l</code><code class="sig-prename descclassname"></code><code class="sig-prename descclassname">, </code><code class="sig-name descname">--lockfile</code><code class="sig-prename descclassname"> arg</code><a class="headerlink" href="#cmdoption-screloc-l" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>Path to lock file.</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="option">
|
|
|
<dt id="cmdoption-screloc-console">
|
|
|
<code class="sig-name descname">--console</code><code class="sig-prename descclassname"> arg</code><a class="headerlink" href="#cmdoption-screloc-console" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>Send log output to stdout.</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="option">
|
|
|
<dt id="cmdoption-screloc-debug">
|
|
|
<code class="sig-name descname">--debug</code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-screloc-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="option">
|
|
|
<dt id="cmdoption-screloc-log-file">
|
|
|
<code class="sig-name descname">--log-file</code><code class="sig-prename descclassname"> arg</code><a class="headerlink" href="#cmdoption-screloc-log-file" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>Use alternative log file.</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
</div>
|
|
|
<div class="section" id="messaging">
|
|
|
<h3>Messaging<a class="headerlink" href="#messaging" title="Permalink to this headline">¶</a></h3>
|
|
|
<dl class="option">
|
|
|
<dt id="cmdoption-screloc-u">
|
|
|
<code class="sig-name descname">-u</code><code class="sig-prename descclassname"></code><code class="sig-prename descclassname">, </code><code class="sig-name descname">--user</code><code class="sig-prename descclassname"> arg</code><a class="headerlink" href="#cmdoption-screloc-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="option">
|
|
|
<dt id="cmdoption-screloc-host">
|
|
|
<code class="sig-name descname">-H</code><code class="sig-prename descclassname"></code><code class="sig-prename descclassname">, </code><code class="sig-name descname">--host</code><code class="sig-prename descclassname"> arg</code><a class="headerlink" href="#cmdoption-screloc-host" 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="option">
|
|
|
<dt id="cmdoption-screloc-t">
|
|
|
<code class="sig-name descname">-t</code><code class="sig-prename descclassname"></code><code class="sig-prename descclassname">, </code><code class="sig-name descname">--timeout</code><code class="sig-prename descclassname"> arg</code><a class="headerlink" href="#cmdoption-screloc-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="option">
|
|
|
<dt id="cmdoption-screloc-g">
|
|
|
<code class="sig-name descname">-g</code><code class="sig-prename descclassname"></code><code class="sig-prename descclassname">, </code><code class="sig-name descname">--primary-group</code><code class="sig-prename descclassname"> arg</code><a class="headerlink" href="#cmdoption-screloc-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="option">
|
|
|
<dt id="cmdoption-screloc-subscribe-group">
|
|
|
<code class="sig-name descname">-S</code><code class="sig-prename descclassname"></code><code class="sig-prename descclassname">, </code><code class="sig-name descname">--subscribe-group</code><code class="sig-prename descclassname"> arg</code><a class="headerlink" href="#cmdoption-screloc-subscribe-group" 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="option">
|
|
|
<dt id="cmdoption-screloc-content-type">
|
|
|
<code class="sig-name descname">--content-type</code><code class="sig-prename descclassname"> arg</code><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>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="option">
|
|
|
<dt id="cmdoption-screloc-start-stop-msg">
|
|
|
<code class="sig-name descname">--start-stop-msg</code><code class="sig-prename descclassname"> arg</code><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></dl>
|
|
|
|
|
|
</div>
|
|
|
<div class="section" id="database">
|
|
|
<h3>Database<a class="headerlink" href="#database" title="Permalink to this headline">¶</a></h3>
|
|
|
<dl class="option">
|
|
|
<dt id="cmdoption-screloc-db-driver-list">
|
|
|
<code class="sig-name descname">--db-driver-list</code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-screloc-db-driver-list" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>List all supported database drivers.</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="option">
|
|
|
<dt id="cmdoption-screloc-database">
|
|
|
<code class="sig-name descname">-d</code><code class="sig-prename descclassname"></code><code class="sig-prename descclassname">, </code><code class="sig-name descname">--database</code><code class="sig-prename descclassname"> arg</code><a class="headerlink" href="#cmdoption-screloc-database" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>The database connection string, format:
|
|
|
<a class="reference external" href="service://user:pwd@host/database">service://user:pwd@host/database</a>.
|
|
|
“service” is the name of the database driver which
|
|
|
can be queried with “–db-driver-list”.</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="option">
|
|
|
<dt id="cmdoption-screloc-config-module">
|
|
|
<code class="sig-name descname">--config-module</code><code class="sig-prename descclassname"> arg</code><a class="headerlink" href="#cmdoption-screloc-config-module" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>The config module to use.</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="option">
|
|
|
<dt id="cmdoption-screloc-inventory-db">
|
|
|
<code class="sig-name descname">--inventory-db</code><code class="sig-prename descclassname"> arg</code><a class="headerlink" href="#cmdoption-screloc-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="option">
|
|
|
<dt id="cmdoption-screloc-db-disable">
|
|
|
<code class="sig-name descname">--db-disable</code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-screloc-db-disable" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>Do not use the database at all</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
</div>
|
|
|
<div class="section" id="mode">
|
|
|
<h3>Mode<a class="headerlink" href="#mode" title="Permalink to this headline">¶</a></h3>
|
|
|
<dl class="option">
|
|
|
<dt id="cmdoption-screloc-test">
|
|
|
<code class="sig-name descname">--test</code><code class="sig-prename descclassname"></code><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></dl>
|
|
|
|
|
|
</div>
|
|
|
<div class="section" id="input">
|
|
|
<h3>Input<a class="headerlink" href="#input" title="Permalink to this headline">¶</a></h3>
|
|
|
<dl class="option">
|
|
|
<dt id="cmdoption-screloc-o">
|
|
|
<code class="sig-name descname">-O</code><code class="sig-prename descclassname"></code><code class="sig-prename descclassname">, </code><code class="sig-name descname">--origin-id</code><code class="sig-prename descclassname"> arg</code><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="option">
|
|
|
<dt id="cmdoption-screloc-locator">
|
|
|
<code class="sig-name descname">--locator</code><code class="sig-prename descclassname"> arg</code><a class="headerlink" href="#cmdoption-screloc-locator" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>The locator type to use</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="option">
|
|
|
<dt id="cmdoption-screloc-use-weight">
|
|
|
<code class="sig-name descname">--use-weight</code><code class="sig-prename descclassname"> arg</code><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="option">
|
|
|
<dt id="cmdoption-screloc-evaluation-mode">
|
|
|
<code class="sig-name descname">--evaluation-mode</code><code class="sig-prename descclassname"> arg</code><a class="headerlink" href="#cmdoption-screloc-evaluation-mode" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>set origin evaluation mode: “AUTOMATIC” or “MANUAL”</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="option">
|
|
|
<dt id="cmdoption-screloc-ep">
|
|
|
<code class="sig-name descname">--ep</code><code class="sig-prename descclassname"> file</code><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>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="option">
|
|
|
<dt id="cmdoption-screloc-replace">
|
|
|
<code class="sig-name descname">--replace</code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-screloc-replace" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>Used in combination with –ep. If given then each origin for
|
|
|
that an output has been generated is replaced by the result
|
|
|
of relocation. In other words: two LocSAT origins in, two
|
|
|
NonLinLoc origins out. All other objects are passed through.</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
</div>
|
|
|
<div class="section" id="profiling">
|
|
|
<h3>Profiling<a class="headerlink" href="#profiling" title="Permalink to this headline">¶</a></h3>
|
|
|
<dl class="option">
|
|
|
<dt id="cmdoption-screloc-measure-relocation-time">
|
|
|
<code class="sig-name descname">--measure-relocation-time</code><code class="sig-prename descclassname"></code><a class="headerlink" href="#cmdoption-screloc-measure-relocation-time" title="Permalink to this definition">¶</a></dt>
|
|
|
<dd><p>Measure the time spent in a single relocation</p>
|
|
|
</dd></dl>
|
|
|
|
|
|
<dl class="option">
|
|
|
<dt id="cmdoption-screloc-repeated-relocations">
|
|
|
<code class="sig-name descname">--repeated-relocations</code><code class="sig-prename descclassname"> arg</code><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></dl>
|
|
|
|
|
|
</div>
|
|
|
</div>
|
|
|
</div>
|
|
|
|
|
|
|
|
|
<div id="anchors-bottom"></div>
|
|
|
</div>
|
|
|
|
|
|
<div class="sidebar" role="navigation" aria-label="main navigation">
|
|
|
<div id="anchors-top"></div>
|
|
|
<div id="anchors" class="content">
|
|
|
<div id="searchbox" style="display: none" role="search">
|
|
|
<h3 id="searchlabel">Quick search</h3>
|
|
|
<div class="searchformwrapper">
|
|
|
<form class="search" action="../search.html" method="get">
|
|
|
<input type="text" name="q" aria-labelledby="searchlabel" />
|
|
|
<input type="submit" value="Go" />
|
|
|
</form>
|
|
|
</div>
|
|
|
</div>
|
|
|
<script>$('#searchbox').show(0);</script>
|
|
|
<h3><a href="../index.html">Table of Contents</a></h3>
|
|
|
<ul>
|
|
|
<li><a class="reference internal" href="#">screloc</a><ul>
|
|
|
<li><a class="reference internal" href="#description">Description</a></li>
|
|
|
<li><a class="reference internal" href="#setup">Setup</a></li>
|
|
|
<li><a class="reference internal" href="#examples">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="#generic">Generic</a></li>
|
|
|
<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="#mode">Mode</a></li>
|
|
|
<li><a class="reference internal" href="#input">Input</a></li>
|
|
|
<li><a class="reference internal" href="#profiling">Profiling</a></li>
|
|
|
</ul>
|
|
|
</li>
|
|
|
</ul>
|
|
|
</li>
|
|
|
</ul>
|
|
|
|
|
|
<h4>Previous topic</h4>
|
|
|
<p class="topless"><a href="scqc.html"
|
|
|
title="previous chapter">scqc</a></p>
|
|
|
<h4>Next topic</h4>
|
|
|
<p class="topless"><a href="scwfparam.html"
|
|
|
title="next chapter">scwfparam</a></p>
|
|
|
<div role="note" aria-label="source link">
|
|
|
<h3>This Page</h3>
|
|
|
<ul class="this-page-menu">
|
|
|
<li><a href="../_sources/apps/screloc.rst.txt"
|
|
|
rel="nofollow">Show Source</a></li>
|
|
|
</ul>
|
|
|
</div>
|
|
|
</div>
|
|
|
</div>
|
|
|
</div>
|
|
|
</div>
|
|
|
<div class="footer">
|
|
|
<div class="container">
|
|
|
<div class="horizontal layout content">
|
|
|
<a class="fade-in" href="https://www.gempa.de" target="_blank">
|
|
|
<img class="brand" src="../_static/brands/gempa.svg"/>
|
|
|
</a>
|
|
|
<div class="stretched align-center fitted content">
|
|
|
<div>
|
|
|
Version <b>5.3.0</b> Release
|
|
|
</div>
|
|
|
<div class="copyright">
|
|
|
Copyright © gempa GmbH, GFZ Potsdam.
|
|
|
</div>
|
|
|
</div>
|
|
|
<a class="fade-in" href="https://www.gfz-potsdam.de" target="_blank">
|
|
|
<img class="brand" src="../_static/brands/gfz.svg"/>
|
|
|
</a>
|
|
|
</div>
|
|
|
</div>
|
|
|
</div>
|
|
|
</body>
|
|
|
</html> |