benjamin
/
seiscomp-training
1
0
Fork 0
Code Pull Requests Packages Projects Releases Wiki Activity
You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
main
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from '906e9ccf6b'
${ noResults }
seiscomp-training/share/doc/seiscomp/html/apps/global_locsat.html

308 lines
15 KiB
HTML
Raw Normal View History Unescape Escape

[installation] Initial commit with first config
2 years ago
<!DOCTYPE html>
<html >
<head>
<meta charset="utf-8" />
<title>LOCSAT &#8212; 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="FixedHypocenter" href="global_fixedhypocenter.html" />
<link rel="prev" title="ML" href="global_ml.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="global_fixedhypocenter.html" title="FixedHypocenter"
accesskey="N">
next
</a>
</li>
<li class="right">
<a href="global_ml.html" title="ML"
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="../toc/extensions.html" >Extensions</a>
</li>
<li class="nav-item nav-item-2">
<a href="../toc/extensions/global.html" accesskey="U">global</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="locsat">
<span id="global-locsat"></span><h1>LOCSAT<a class="headerlink" href="#locsat" title="Permalink to this headline"></a></h1>
<p>Locator in SeisComP for computing source time and hypocenter
coordinates from phase picks.</p>
<div class="section" id="description">
<h2>Description<a class="headerlink" href="#description" title="Permalink to this headline"></a></h2>
<p>LOCSAT is a locator in SeisComP for computing source time and hypocenter
coordinates from phase picks considering:</p>
<ul class="simple">
<li><p>Pick time,</p></li>
<li><p>Backazimuth,</p></li>
<li><p>Slowness.</p></li>
</ul>
<p>The LOCSAT locator interface 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.">39</a>]</span> (according to the README file shipped with the
LocSAT distribution) referred to as <strong>LOCSAT</strong> in <cite>SeisComP</cite>.</p>
</div>
<div class="section" id="travel-time-tables">
<h2>Travel-time tables<a class="headerlink" href="#travel-time-tables" title="Permalink to this headline"></a></h2>
<p><cite>SeisComP</cite> ships with two predefined travel time tables: tab and iasp91.
LOCSAT travel time tables are located under <code class="file docutils literal notranslate"><span class="pre">share/locsat/tables/</span></code>.</p>
<p>The default profile is <em>iasp91</em>.</p>
</div>
<div class="section" id="travel-time-interface">
<h2>Travel-time interface<a class="headerlink" href="#travel-time-interface" title="Permalink to this headline"></a></h2>
<p>LOCSAT provides an interface for computing travel times based on coordinates and depth.</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>
</div>
<div class="section" id="configuration-in-scname-modules">
<h2>Configuration in <cite>SeisComP</cite> modules<a class="headerlink" href="#configuration-in-scname-modules" title="Permalink to this headline"></a></h2>
<p>Use “LOCSAT” as a value for the locator type or interface when configurable, e.g. by
<a class="reference internal" href="screloc.html#screloc"><span class="std std-ref">screloc</span></a> or <a class="reference internal" href="scolv.html#scolv"><span class="std std-ref">scolv</span></a>.</p>
</div>
<div class="section" id="station-corrections">
<h2>Station corrections<a class="headerlink" href="#station-corrections" title="Permalink to this headline"></a></h2>
<p>LOCSAT does not support station corrections natively. 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="o">=</span> <span class="mf">0.0</span><span class="p">;</span> <span class="cm">/* FIX !!!!!!*/</span>
</pre></div>
</div>
<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 corrections of observation times
in seconds. A correction is <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#id160" title="A. Lomax. The NonLinLoc Software Guide. Manual. URL: http://alomax.free.fr/nlloc/.">49</a>]</span>
station correction definitions.</p>
<p>Each LOCSAT profile (travel time table) can have an associated station
correction file. To use station corrections for 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-sh notranslate"><div class="highlight"><pre><span></span><span class="c1"># LOCDELAY code phase numReadings delay</span>
LOCDELAY GE.MORC P <span class="m">1</span> -0.1
</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>
<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>
</div>
</div>
<div class="section" id="module-configuration">
<span id="global-locsat-configuration"></span><h2>Module Configuration<a class="headerlink" href="#module-configuration" title="Permalink to this headline"></a></h2>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p><strong>LOCSAT.*</strong>
<em>Locator parameters: LOCSAT</em></p>
</div>
<dl class="confval">
<dt id="confval-LOCSAT.profiles">
<code class="sig-name descname">LOCSAT.profiles</code><a class="headerlink" href="#confval-LOCSAT.profiles" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">iasp91,</span> <span class="pre">tab</span></code></p>
<p>Type: <em>list:string</em></p>
<p>Defines a list of available LOCSAT travel-time tables.</p>
</dd></dl>
<dl class="confval">
<dt id="confval-LOCSAT.depthInit">
<code class="sig-name descname">LOCSAT.depthInit</code><a class="headerlink" href="#confval-LOCSAT.depthInit" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">20.0</span></code></p>
<p>Type: <em>double</em></p>
<p>Unit: <em>km</em></p>
<p>The initial depth estimate for LOCSAT.</p>
</dd></dl>
<dl class="confval">
<dt id="confval-LOCSAT.usePickUncertainties">
<code class="sig-name descname">LOCSAT.usePickUncertainties</code><a class="headerlink" href="#confval-LOCSAT.usePickUncertainties" 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 pick time untertainties for arrival deltim rather
than a fixed time error. If true then the uncertainties are
retrieved from each individual pick object. If they are not
defined then the default pick time uncertainty will be used
as fallback.</p>
</dd></dl>
<dl class="confval">
<dt id="confval-LOCSAT.defaultTimeError">
<code class="sig-name descname">LOCSAT.defaultTimeError</code><a class="headerlink" href="#confval-LOCSAT.defaultTimeError" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">1.0</span></code></p>
<p>Type: <em>double</em></p>
<p>Unit: <em>s</em></p>
<p>The default pick time uncertainty assigned to LOCSAT’s arrival deltim
attribute if pick uncertainties are not going to be used or
if they are absent. A time uncertainty of 0 s may result in
errors of the SVD decomposition in LOCSAT.</p>
</dd></dl>
<dl class="confval">
<dt id="confval-LOCSAT.usePickBackazimuth">
<code class="sig-name descname">LOCSAT.usePickBackazimuth</code><a class="headerlink" href="#confval-LOCSAT.usePickBackazimuth" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">true</span></code></p>
<p>Type: <em>boolean</em></p>
<p>Whether to forward pick backazimuth to LOCSAT or not. In an
automatic mode backazimuth measurements might be inaccurrate
and disabling their usage in LOCSAT can be controlled with
this parameter.</p>
</dd></dl>
<dl class="confval">
<dt id="confval-LOCSAT.usePickSlowness">
<code class="sig-name descname">LOCSAT.usePickSlowness</code><a class="headerlink" href="#confval-LOCSAT.usePickSlowness" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">true</span></code></p>
<p>Type: <em>boolean</em></p>
<p>Whether to forward pick horizontal slowness to LOCSAT or not.
In an automatic mode slowness measurements might be
inaccurrate and disabling their usage in LOCSAT can be
controlled with this parameter.</p>
</dd></dl>
<dl class="confval">
<dt id="confval-LOCSAT.degreesOfFreedom">
<code class="sig-name descname">LOCSAT.degreesOfFreedom</code><a class="headerlink" href="#confval-LOCSAT.degreesOfFreedom" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">9999</span></code></p>
<p>Type: <em>int</em></p>
<p>Number of degrees of freedom.</p>
</dd></dl>
<dl class="confval">
<dt id="confval-LOCSAT.confLevel">
<code class="sig-name descname">LOCSAT.confLevel</code><a class="headerlink" href="#confval-LOCSAT.confLevel" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">0.9</span></code></p>
<p>Type: <em>double</em></p>
<p>Confidence level between 0.5 and 1.0.</p>
</dd></dl>
<dl class="confval">
<dt id="confval-LOCSAT.enableConfidenceEllipsoid">
<code class="sig-name descname">LOCSAT.enableConfidenceEllipsoid</code><a class="headerlink" href="#confval-LOCSAT.enableConfidenceEllipsoid" 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>Compute the confidence ellipsoid from covariance matrix in 3D.</p>
</dd></dl>
</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="#">LOCSAT</a><ul>
<li><a class="reference internal" href="#description">Description</a></li>
<li><a class="reference internal" href="#travel-time-tables">Travel-time tables</a></li>
<li><a class="reference internal" href="#travel-time-interface">Travel-time interface</a></li>
<li><a class="reference internal" href="#configuration-in-scname-modules">Configuration in <cite>SeisComP</cite> modules</a></li>
<li><a class="reference internal" href="#station-corrections">Station corrections</a></li>
<li><a class="reference internal" href="#module-configuration">Module Configuration</a></li>
</ul>
</li>
</ul>
<h4>Previous topic</h4>
<p class="topless"><a href="global_ml.html"
title="previous chapter">ML</a></p>
<h4>Next topic</h4>
<p class="topless"><a href="global_fixedhypocenter.html"
title="next chapter">FixedHypocenter</a></p>
<div role="note" aria-label="source link">
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="../_sources/apps/global_locsat.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 &copy; gempa GmbH, GFZ Potsdam.
</div>
</div>
<a class="fade-in" href="https://www.gfz-potsdam.de" target="_blank">
<img class="brand" src="../_static/brands/gfz.svg"/>
</a>
</div>
</div>
</div>
</body>
</html>