555 lines
29 KiB
HTML
555 lines
29 KiB
HTML
<!DOCTYPE html>
|
||
|
||
<html lang="en">
|
||
<head>
|
||
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
|
||
|
||
<title>StdLoc — 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/pygments.css?v=72bcf2f2" />
|
||
<link rel="stylesheet" type="text/css" href="../_static/seiscomp.css?v=c6da7ce6" />
|
||
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
|
||
<script type="text/javascript" src="../_static/seiscomp.js"></script>
|
||
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
|
||
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
|
||
<script src="../_static/doctools.js?v=888ff710"></script>
|
||
<script src="../_static/sphinx_highlight.js?v=4825356b"></script>
|
||
<link rel="index" title="Index" href="../genindex.html" />
|
||
<link rel="search" title="Search" href="../search.html" />
|
||
<link rel="next" title="LocExt" href="global_locext.html" />
|
||
<link rel="prev" title="GUI" href="global_gui.html" />
|
||
</head>
|
||
<body>
|
||
<div class="header">
|
||
<div class="container">
|
||
<div class="brand">
|
||
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
|
||
<!-- span class="title">SeisComP Release</span -->
|
||
<span class="version">6.9.1</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_locext.html" title="LocExt"
|
||
accesskey="N">
|
||
next
|
||
</a>
|
||
</li>
|
||
<li class="right">
|
||
<a href="global_gui.html" title="GUI"
|
||
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">
|
||
|
||
<section id="stdloc">
|
||
<span id="global-stdloc"></span><h1>StdLoc<a class="headerlink" href="#stdloc" title="Permalink to this heading">¶</a></h1>
|
||
<p>Generic locator plugin for SeisComP.</p>
|
||
<section id="description">
|
||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this heading">¶</a></h2>
|
||
<p>StdLoc is a SeisComP locator plugin that combines standard location methods
|
||
and was developed with the focus on local seismicity, although the methods
|
||
are generic enough to work at larger scales as well.</p>
|
||
</section>
|
||
<section id="plugin">
|
||
<h2>Plugin<a class="headerlink" href="#plugin" title="Permalink to this heading">¶</a></h2>
|
||
<p>To enable StdLoc the plugin <code class="docutils literal notranslate"><span class="pre">stdloc</span></code> must be loaded.</p>
|
||
</section>
|
||
<section id="how-does-it-work">
|
||
<h2>How does it work?<a class="headerlink" href="#how-does-it-work" title="Permalink to this heading">¶</a></h2>
|
||
<p>The locator can apply a multitude of location methods and it is particularly useful to
|
||
combine them to achieve better solutions:</p>
|
||
<ul>
|
||
<li><p>LeastSquares: this is the classic algorithm that solves the linearized problem of
|
||
travel time residual minimization via iterative least squares. However an initial
|
||
location estimate is required. This is the intended method to select when StdLoc
|
||
is used in combination with a pick associator: it provides the initial location
|
||
estimate and StdLoc will improve it. When used in <a class="reference internal" href="scolv.html#scolv"><span class="std std-ref">scolv</span></a> or <a class="reference internal" href="screloc.html#screloc"><span class="std std-ref">screloc</span></a>,
|
||
the location of the origin to be relocated is used as starting estimate.
|
||
The configuration doesn’t require any mandatory parameters:</p>
|
||
<blockquote>
|
||
<div><div class="highlight-params notranslate"><div class="highlight"><pre><span></span>method = LeastSquares
|
||
</pre></div>
|
||
</div>
|
||
</div></blockquote>
|
||
</li>
|
||
<li><p>GridSearch: finds the source parameters by evaluating the hypocenter probability
|
||
of each point in a grid and returning the maximum likelihood hypocenter.
|
||
Because the search space is fully evaluated there is no need for an initial
|
||
location estimate and the location uncertainty is completely known. However the
|
||
method is very slow. It can be used to relocate events in <a class="reference internal" href="scolv.html#scolv"><span class="std std-ref">scolv</span></a> that seem
|
||
difficult to locate via other methods or to verify the uncertainty of a solution.
|
||
The following example configuration computes a grid search around the average
|
||
location of the picked stations. The grid points are spaced apart 0.5km
|
||
horizontally and 2km vertically.</p>
|
||
<blockquote>
|
||
<div><div class="highlight-params notranslate"><div class="highlight"><pre><span></span>method = GridSearch
|
||
GridSearch.center = auto,auto,15
|
||
GridSearch.size = 40,40,30
|
||
GridSearch.numPoints = 81,81,16
|
||
</pre></div>
|
||
</div>
|
||
</div></blockquote>
|
||
</li>
|
||
<li><p>GridSearch+LeastSquares: this method can be used in very complex networks where
|
||
a bad initial location estimates can get LeastSquares stuck in a local minimum.
|
||
The method finds a LeastSquares solution for each cell in a (coarse) grid, using
|
||
the cell centroid as initial location estimate. If finally returns the maximum
|
||
likelihood solution. This method is intended to be used in <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> to relocate existing events.
|
||
The following example configuration returns the best among the 75 (5x5x3)
|
||
LeastSquares solutions, computed for every point in the grid.</p>
|
||
<blockquote>
|
||
<div><div class="highlight-params notranslate"><div class="highlight"><pre><span></span>method = GridSearch+LeastSquares
|
||
GridSearch.center = auto,auto,15
|
||
GridSearch.size = 100,100,30
|
||
GridSearch.numPoints = 5,5,3
|
||
</pre></div>
|
||
</div>
|
||
</div></blockquote>
|
||
</li>
|
||
<li><p>OctTree: this method produces similar results to GridSearch but it is extremely
|
||
faster and it follows the NonLinLoc approach. The OctTree search starts by
|
||
evaluating the hypocenter probability of each cell in a grid, computed as the
|
||
probability density at the cell center coordinates times the cell volume. The
|
||
search then continues by repeatedly fetching the cell with highest probability
|
||
and splitting it in 8 sub-cells. These 8 cells are then inserted in the pool of
|
||
cells to fetch from at next iteration.
|
||
The search terminates after either a maximum number of iterations or after
|
||
reaching a minimum cell size. At that point the maximum likelihood hypocenter
|
||
is selected. Because the algorithms splits only the cells with higher
|
||
probability, the search space is sampled in a very efficient way and it makes
|
||
the method way faster than GridSearch.
|
||
This method is intended to be used in <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> to
|
||
relocate existing events.
|
||
The following example is a plausible configuration for the entire Swiss
|
||
network:</p>
|
||
<blockquote>
|
||
<div><div class="highlight-params notranslate"><div class="highlight"><pre><span></span>method = OctTree
|
||
GridSearch.center = 47.0,8.5,50
|
||
GridSearch.size = 700,700,100
|
||
GridSearch.numPoints = 21,21,11
|
||
OctTree.maxIterations = 100000
|
||
OctTree.minCellSize = 0.001
|
||
</pre></div>
|
||
</div>
|
||
</div></blockquote>
|
||
<p>However in this example we are at the size limit for a flat earth study
|
||
geometry and for bigger regions <cite>GridSearch.center</cite> should be set to
|
||
<cite>auto</cite> and <cite>GridSearch.size</cite> to a smaller size.</p>
|
||
</li>
|
||
<li><p>OctTree+LeastSquares: this method allows the OctTree search to find the
|
||
maximum probability cell in the network and uses that as the initial
|
||
location estimate for LeastSquares.
|
||
This method is intended to be used in <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> to
|
||
relocate existing events.
|
||
The following example is a plausible configuration for the entire Swiss
|
||
network:</p>
|
||
<blockquote>
|
||
<div><div class="highlight-params notranslate"><div class="highlight"><pre><span></span>method = OctTree+LeastSquares
|
||
GridSearch.center = 47.0,8.5,50
|
||
GridSearch.size = 700,700,100
|
||
GridSearch.numPoints = 21,21,11
|
||
OctTree.maxIterations = 10000
|
||
OctTree.minCellSize = 1.0
|
||
</pre></div>
|
||
</div>
|
||
</div></blockquote>
|
||
<p>However in this example we are at the size limit for a flat earth study
|
||
geometry and for bigger regions <cite>GridSearch.center</cite> should be set to
|
||
<cite>auto</cite> and <cite>GridSearch.size</cite> to a smaller size.</p>
|
||
</li>
|
||
</ul>
|
||
<p>The algorithms implemented in StdLoc are standard methods described in “Routine Data
|
||
Processing in Earthquake Seismology” by Jens Havskov and Lars Ottemoller. The OctTree
|
||
search algorithm is based on NonLibLoc by Antony Lomax.</p>
|
||
</section>
|
||
<section id="why-is-stdloc-suitable-for-local-seismicity">
|
||
<h2>Why is stdloc suitable for local seismicity?<a class="headerlink" href="#why-is-stdloc-suitable-for-local-seismicity" title="Permalink to this heading">¶</a></h2>
|
||
<p>When dealing with very local seismicity (few kilometers or hundreds of meters)
|
||
simplifications that are common for regional seismicity have to be removed.
|
||
In particular the locator should take into consideration:</p>
|
||
<ul class="simple">
|
||
<li><p>station elevation and even negative elevation (e.g. borehole sensors)</p></li>
|
||
<li><p>earthquake location can be above a seismic sensor (e.g. borehole sensors)</p></li>
|
||
<li><p>possible negative earthquake depth (above surface)</p></li>
|
||
</ul>
|
||
<p>More importantly the travel time tables used by the locator must be able to take
|
||
into consideration all the above too.</p>
|
||
</section>
|
||
<section id="travel-time-table">
|
||
<h2>Travel Time Table<a class="headerlink" href="#travel-time-table" title="Permalink to this heading">¶</a></h2>
|
||
<p>StdLoc can be configured with any Travel Time Table type available in SeisComP,
|
||
however only the <cite>homogeneous</cite> type is able to take into consideration station
|
||
elevation, negative source depth and sources happening above stations. For this
|
||
reason <cite>homogeneous</cite> should be the preferred choice when working on very local
|
||
seismicity and especially with borehole sensors.</p>
|
||
</section>
|
||
<section id="module-configuration">
|
||
<span id="global-stdloc-configuration"></span><h2>Module Configuration<a class="headerlink" href="#module-configuration" title="Permalink to this heading">¶</a></h2>
|
||
<div class="admonition note">
|
||
<p class="admonition-title">Note</p>
|
||
<p><strong>StdLoc.*</strong>
|
||
<em>Locator parameters: StdLoc. This locator requires the plugin</em>
|
||
<em>“stdloc” to be loaded.</em></p>
|
||
</div>
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-StdLoc.profiles">
|
||
<span class="sig-name descname"><span class="pre">StdLoc.profiles</span></span><a class="headerlink" href="#confval-StdLoc.profiles" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Type: <em>list:string</em></p>
|
||
<p>Defines a list of profiles to make available to the plugin.</p>
|
||
</dd></dl>
|
||
|
||
<div class="admonition note">
|
||
<p class="admonition-title">Note</p>
|
||
<p><strong>StdLoc.profile.$name.*</strong>
|
||
$name is a placeholder for the name to be used and needs to be added to <a class="reference internal" href="#confval-StdLoc.profiles"><code class="xref std std-confval docutils literal notranslate"><span class="pre">StdLoc.profiles</span></code></a> to become active.</p>
|
||
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>StdLoc.profiles<span class="w"> </span><span class="o">=</span><span class="w"> </span>a,b
|
||
StdLoc.profile.a.value1<span class="w"> </span><span class="o">=</span><span class="w"> </span>...
|
||
StdLoc.profile.b.value1<span class="w"> </span><span class="o">=</span><span class="w"> </span>...
|
||
<span class="c1"># c is not active because it has not been added</span>
|
||
<span class="c1"># to the list of StdLoc.profiles</span>
|
||
StdLoc.profile.c.value1<span class="w"> </span><span class="o">=</span><span class="w"> </span>...
|
||
</pre></div>
|
||
</div>
|
||
</div>
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-StdLoc.profile.-name.method">
|
||
<span class="sig-name descname"><span class="pre">StdLoc.profile.$name.method</span></span><a class="headerlink" href="#confval-StdLoc.profile.-name.method" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">LeastSquares</span></code></p>
|
||
<p>Type: <em>string</em></p>
|
||
<p>The location method to use: LeastSquares, GridSearch,
|
||
OctTree, GridSearch+LeastSquares or OctTree+LeastSquares.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-StdLoc.profile.-name.tableType">
|
||
<span class="sig-name descname"><span class="pre">StdLoc.profile.$name.tableType</span></span><a class="headerlink" href="#confval-StdLoc.profile.-name.tableType" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">LOCSAT</span></code></p>
|
||
<p>Type: <em>string</em></p>
|
||
<p>Travel time table format type. Also consider
|
||
"tableModel"!</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-StdLoc.profile.-name.tableModel">
|
||
<span class="sig-name descname"><span class="pre">StdLoc.profile.$name.tableModel</span></span><a class="headerlink" href="#confval-StdLoc.profile.-name.tableModel" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">iasp91</span></code></p>
|
||
<p>Type: <em>string</em></p>
|
||
<p>The model to be used. The format depends on
|
||
"tableType".</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-StdLoc.profile.-name.PSTableOnly">
|
||
<span class="sig-name descname"><span class="pre">StdLoc.profile.$name.PSTableOnly</span></span><a class="headerlink" href="#confval-StdLoc.profile.-name.PSTableOnly" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">true</span></code></p>
|
||
<p>Type: <em>boolean</em></p>
|
||
<p>If enabled the arrival travel time information are fetched
|
||
using ‘P’ and ‘S’ tables only and the user selected
|
||
specific phase type is not considered (e.g. Pg, Sg,
|
||
PmP, SmS, P1, S1, etc).</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-StdLoc.profile.-name.usePickUncertainties">
|
||
<span class="sig-name descname"><span class="pre">StdLoc.profile.$name.usePickUncertainties</span></span><a class="headerlink" href="#confval-StdLoc.profile.-name.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>Use pick time uncertainties rather than a fixed
|
||
time error of XXX s. If true, an arrival weight is
|
||
associated according to the uncertainty of the pick
|
||
and "pickUncertaintyClasses".</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-StdLoc.profile.-name.pickUncertaintyClasses">
|
||
<span class="sig-name descname"><span class="pre">StdLoc.profile.$name.pickUncertaintyClasses</span></span><a class="headerlink" href="#confval-StdLoc.profile.-name.pickUncertaintyClasses" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">0.000,0.025,0.050,0.100,0.200,0.400</span></code></p>
|
||
<p>Type: <em>list:string</em></p>
|
||
<p>Unit: <em>s</em></p>
|
||
<p>Comma-separated list of time limits of uncertainty
|
||
classes from which, along with pick time uncertainties,
|
||
arrival weights are computed. The first value
|
||
defines the lower limit of class 0.</p>
|
||
<p>The interval into which a pick time uncertainty falls
|
||
defines the index of the uncertainty class starting
|
||
with 0.</p>
|
||
<p>The corresponding arrival weight is computed as:
|
||
weight = 1 / 2^(index).</p>
|
||
<p>Example: A pick with a time uncertainty of 0.15 s is
|
||
within the 4th interval ranging from 0.1 to 0.2 s.
|
||
The class index is then 3.</p>
|
||
<p>If pick uncertainty is absent, the highest class index
|
||
applies.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-StdLoc.profile.-name.confLevel">
|
||
<span class="sig-name descname"><span class="pre">StdLoc.profile.$name.confLevel</span></span><a class="headerlink" href="#confval-StdLoc.profile.-name.confLevel" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">0.9</span></code></p>
|
||
<p>Type: <em>double</em></p>
|
||
<p>Confidence level, between 0.5 and 1.0, used in
|
||
computing the hypocenter confidence ellipsoid.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-StdLoc.profile.-name.enableConfidenceEllipsoid">
|
||
<span class="sig-name descname"><span class="pre">StdLoc.profile.$name.enableConfidenceEllipsoid</span></span><a class="headerlink" href="#confval-StdLoc.profile.-name.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 hypocenter confidence ellipsoid. Disable
|
||
this optional parameter to save some computation time.</p>
|
||
</dd></dl>
|
||
|
||
<div class="admonition note">
|
||
<p class="admonition-title">Note</p>
|
||
<p><strong>StdLoc.profile.$name.GridSearch.*</strong>
|
||
<em>Parameters controlling the GridSearch and OctTree methods.</em></p>
|
||
</div>
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-StdLoc.profile.-name.GridSearch.center">
|
||
<span class="sig-name descname"><span class="pre">StdLoc.profile.$name.GridSearch.center</span></span><a class="headerlink" href="#confval-StdLoc.profile.-name.GridSearch.center" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">auto,auto,20</span></code></p>
|
||
<p>Type: <em>list:string</em></p>
|
||
<p>Unit: <em>deg,deg,km</em></p>
|
||
<p>Grid center defined as: latitude,longitude,depth. The
|
||
special value "auto" can be used and the corresponding latitude, longitude
|
||
and/or depth will be automatically computed as the average of the arrival
|
||
station locations.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-StdLoc.profile.-name.GridSearch.size">
|
||
<span class="sig-name descname"><span class="pre">StdLoc.profile.$name.GridSearch.size</span></span><a class="headerlink" href="#confval-StdLoc.profile.-name.GridSearch.size" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">40,40,30</span></code></p>
|
||
<p>Type: <em>list:string</em></p>
|
||
<p>Unit: <em>km</em></p>
|
||
<p>Grid size in km defined as: X,Y,Z
|
||
direction extents around the "GridSearch.center",
|
||
where X is the longitudinal extent, Y the
|
||
latitudinal extent and Z the vertical extent.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-StdLoc.profile.-name.GridSearch.numPoints">
|
||
<span class="sig-name descname"><span class="pre">StdLoc.profile.$name.GridSearch.numPoints</span></span><a class="headerlink" href="#confval-StdLoc.profile.-name.GridSearch.numPoints" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Type: <em>list:string</em></p>
|
||
<p>Number of grid points in X, Y, Z
|
||
direction. The first and last points are on the
|
||
grid boundary unless the number of points is 1
|
||
and the point will be in the grid center.</p>
|
||
<p>Format: numX,numY,numZ.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-StdLoc.profile.-name.GridSearch.misfitType">
|
||
<span class="sig-name descname"><span class="pre">StdLoc.profile.$name.GridSearch.misfitType</span></span><a class="headerlink" href="#confval-StdLoc.profile.-name.GridSearch.misfitType" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">L1</span></code></p>
|
||
<p>Type: <em>string</em></p>
|
||
<p>The type of misfit to use, from which
|
||
the likelihood function is derived: L1 or L2 norm.
|
||
L1 is less sensitive to outliers and so more
|
||
suitable with automatic picks, L2 is the preferred
|
||
choice for manual picks.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-StdLoc.profile.-name.GridSearch.travelTimeError">
|
||
<span class="sig-name descname"><span class="pre">StdLoc.profile.$name.GridSearch.travelTimeError</span></span><a class="headerlink" href="#confval-StdLoc.profile.-name.GridSearch.travelTimeError" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">0.25</span></code></p>
|
||
<p>Type: <em>double</em></p>
|
||
<p>Unit: <em>s</em></p>
|
||
<p>Typical error in seconds for travel times to
|
||
stations. The value affects the uncertainty
|
||
of the location. In OctTree it also influences
|
||
the probability density computation: too
|
||
conservative values increase the number of
|
||
iterations required by OctTree to converge
|
||
to a high resolution solution.</p>
|
||
</dd></dl>
|
||
|
||
<div class="admonition note">
|
||
<p class="admonition-title">Note</p>
|
||
<p><strong>StdLoc.profile.$name.OctTree.*</strong>
|
||
<em>Parameters controlling the OctTree method. OctTree</em>
|
||
<em>uses the parameters defined in GridSearch, but</em>
|
||
<em>applies the OctTree search algorithm on the grid.</em>
|
||
<em>The starting cells of the OctTree search are created by</em>
|
||
<em>dividing the initial grid in equally sized cells.</em>
|
||
<em>The grid points becomes the cell vertices.</em>
|
||
<em>Resulting number of cells in each direction:</em>
|
||
<em>“GridSearch.numPoints” - 1.</em></p>
|
||
</div>
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-StdLoc.profile.-name.OctTree.maxIterations">
|
||
<span class="sig-name descname"><span class="pre">StdLoc.profile.$name.OctTree.maxIterations</span></span><a class="headerlink" href="#confval-StdLoc.profile.-name.OctTree.maxIterations" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">50000</span></code></p>
|
||
<p>Type: <em>int</em></p>
|
||
<p>Maximum number of iterations after which the
|
||
search stops. Zero or negatives values disable
|
||
the stopping.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-StdLoc.profile.-name.OctTree.minCellSize">
|
||
<span class="sig-name descname"><span class="pre">StdLoc.profile.$name.OctTree.minCellSize</span></span><a class="headerlink" href="#confval-StdLoc.profile.-name.OctTree.minCellSize" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">0.1</span></code></p>
|
||
<p>Type: <em>double</em></p>
|
||
<p>Unit: <em>km</em></p>
|
||
<p>Minimum cell size to be generate by the OctTree
|
||
search to stop. A zero or negative value disable
|
||
this stopping mechanism.</p>
|
||
</dd></dl>
|
||
|
||
<div class="admonition note">
|
||
<p class="admonition-title">Note</p>
|
||
<p><strong>StdLoc.profile.$name.LeastSquares.*</strong>
|
||
<em>Parameters controlling the LeastSquares method.</em></p>
|
||
</div>
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-StdLoc.profile.-name.LeastSquares.depthInit">
|
||
<span class="sig-name descname"><span class="pre">StdLoc.profile.$name.LeastSquares.depthInit</span></span><a class="headerlink" href="#confval-StdLoc.profile.-name.LeastSquares.depthInit" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">20</span></code></p>
|
||
<p>Type: <em>double</em></p>
|
||
<p>The initial depth estimate when no initial
|
||
hypocenter is provided. Used only with
|
||
‘LeastSquares’.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-StdLoc.profile.-name.LeastSquares.iterations">
|
||
<span class="sig-name descname"><span class="pre">StdLoc.profile.$name.LeastSquares.iterations</span></span><a class="headerlink" href="#confval-StdLoc.profile.-name.LeastSquares.iterations" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">20</span></code></p>
|
||
<p>Type: <em>int</em></p>
|
||
<p>Number of iterations. Each iteration will
|
||
use the location and time from the previous
|
||
Least Squares solution.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-StdLoc.profile.-name.LeastSquares.dampingFactor">
|
||
<span class="sig-name descname"><span class="pre">StdLoc.profile.$name.LeastSquares.dampingFactor</span></span><a class="headerlink" href="#confval-StdLoc.profile.-name.LeastSquares.dampingFactor" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">0.0</span></code></p>
|
||
<p>Type: <em>double</em></p>
|
||
<p>Damping factor to be used when solving the
|
||
system of equations.</p>
|
||
<p>0: no damping.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="std confval">
|
||
<dt class="sig sig-object std" id="confval-StdLoc.profile.-name.LeastSquares.solverType">
|
||
<span class="sig-name descname"><span class="pre">StdLoc.profile.$name.LeastSquares.solverType</span></span><a class="headerlink" href="#confval-StdLoc.profile.-name.LeastSquares.solverType" title="Permalink to this definition">¶</a></dt>
|
||
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">LSMR</span></code></p>
|
||
<p>Type: <em>string</em></p>
|
||
<p>Algorithm to use: either LSMR or LSQR.</p>
|
||
</dd></dl>
|
||
|
||
</section>
|
||
</section>
|
||
|
||
|
||
<div id="anchors-bottom"></div>
|
||
</div>
|
||
|
||
<div class="sidebar" role="navigation" aria-label="main navigation">
|
||
<div id="anchors-top"></div>
|
||
<div id="anchors" class="content">
|
||
<div id="searchbox" style="display: none" role="search">
|
||
<h3 id="searchlabel">Quick search</h3>
|
||
<div class="searchformwrapper">
|
||
<form class="search" action="../search.html" method="get">
|
||
<input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false"/>
|
||
<input type="submit" value="Go" />
|
||
</form>
|
||
</div>
|
||
</div>
|
||
<script>document.getElementById('searchbox').style.display = "block"</script>
|
||
<div>
|
||
<h3><a href="../index.html">Table of Contents</a></h3>
|
||
<ul>
|
||
<li><a class="reference internal" href="#">StdLoc</a><ul>
|
||
<li><a class="reference internal" href="#description">Description</a></li>
|
||
<li><a class="reference internal" href="#plugin">Plugin</a></li>
|
||
<li><a class="reference internal" href="#how-does-it-work">How does it work?</a></li>
|
||
<li><a class="reference internal" href="#why-is-stdloc-suitable-for-local-seismicity">Why is stdloc suitable for local seismicity?</a></li>
|
||
<li><a class="reference internal" href="#travel-time-table">Travel Time Table</a></li>
|
||
<li><a class="reference internal" href="#module-configuration">Module Configuration</a></li>
|
||
</ul>
|
||
</li>
|
||
</ul>
|
||
|
||
</div>
|
||
<div>
|
||
<h4>Previous topic</h4>
|
||
<p class="topless"><a href="global_gui.html"
|
||
title="previous chapter">GUI</a></p>
|
||
</div>
|
||
<div>
|
||
<h4>Next topic</h4>
|
||
<p class="topless"><a href="global_locext.html"
|
||
title="next chapter">LocExt</a></p>
|
||
</div>
|
||
<div role="note" aria-label="source link">
|
||
<h3>This Page</h3>
|
||
<ul class="this-page-menu">
|
||
<li><a href="../_sources/apps/global_stdloc.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>6.9.1</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> |