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

[installation] Change to nightly

Browse Source
This commit is contained in:
Dirk Rössler
2025-10-30 12:04:59 +01:00
parent 2ff097f9d1
commit a31bc45cce
1441 changed files with 60368 additions and 56360 deletions
Download Patch File Download Diff File Expand all files Collapse all files

100
share/doc/seiscomp/html/apps/global_locsat.html
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.