[seiscomp, scanloc] Install, add .gitignore
This commit is contained in:
892
share/doc/seiscomp/html/apps/global_iloc.html
Normal file
892
share/doc/seiscomp/html/apps/global_iloc.html
Normal file
@ -0,0 +1,892 @@
|
||||
<!DOCTYPE html>
|
||||
|
||||
<html lang="en">
|
||||
<head>
|
||||
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
|
||||
|
||||
<title>iLoc — 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="MN" href="global_mn.html" />
|
||||
<link rel="prev" title="MLh" href="global_mlh.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.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_mn.html" title="MN"
|
||||
accesskey="N">
|
||||
next
|
||||
</a>
|
||||
</li>
|
||||
<li class="right">
|
||||
<a href="global_mlh.html" title="MLh"
|
||||
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="iloc">
|
||||
<span id="global-iloc"></span><h1>iLoc<a class="headerlink" href="#iloc" title="Permalink to this heading">¶</a></h1>
|
||||
<p>Locator in SeisComP implemented by the plugin lociloc.</p>
|
||||
<section id="description">
|
||||
<h2>Description<a class="headerlink" href="#description" title="Permalink to this heading">¶</a></h2>
|
||||
<p>iLoc is a locator developed by István Bondár which has been integrated into
|
||||
<cite>SeisComP</cite> by <span id="id1"><em>gempa GmbH</em> [<a class="reference internal" href="../base/references.html#id122" title="gempa GmbH. The SeisComP development and maintenance company. URL: https://www.gempa.de/.">28</a>]</span>. It is invoked by the wrapper plugin <em>lociloc</em> - the
|
||||
interface between <cite>SeisComP</cite> and iLoc.
|
||||
Read the sections <a class="reference internal" href="#iloc-setup"><span class="std std-ref">Setup in SeisComP</span></a> and <a class="reference internal" href="#iloc-application"><span class="std std-ref">Application in SeisComP</span></a> for
|
||||
configuring and using iLoc in <cite>SeisComP</cite>.</p>
|
||||
<section id="background">
|
||||
<h3>Background<a class="headerlink" href="#background" title="Permalink to this heading">¶</a></h3>
|
||||
<p>iLoc is a locator tool for locating seismic, hydroacoustic and
|
||||
infrasound sources
|
||||
based on <a class="reference internal" href="../base/glossary.html#term-pick"><span class="xref std std-term">phase picks</span></a>. iLoc is based on the location
|
||||
algorithm developed by <span id="id2">Bondár and McLaughlin [<a class="reference internal" href="../base/references.html#id12" title="I. Bondár and K.L. McLaughlin. A new ground truth data set for seismic studies. Seismol. Res. Lett., 3:465 - 472, 2009. doi:10.1785/gssrl.80.3.465.">34</a>]</span> and implemented at the
|
||||
International Seismological Center, (<span id="id3"><em>ISC</em> [<a class="reference internal" href="../base/references.html#id140" title="ISC. International Seismological Centre. URL: http://www.isc.ac.uk/.">14</a>]</span>, <span id="id4">Bondár <em>et al.</em> [<a class="reference internal" href="../base/references.html#id16" title="I. Bondár, P. Mónus, C. Czanik, M. Kiszely, Z. Gráczer, Z. Wéber, and the AlpArrayWorking Group. Relocation of Seismicity in the Pannonian Basin Using a Global 3D Velocity Model. Seismol. Res. Lett., 6:2284 – 2293, 2018. doi:10.1785/0220180143.">36</a>]</span>)
|
||||
with numerous new features added (<span id="id5">Bondár <em>et al.</em> [<a class="reference internal" href="../base/references.html#id16" title="I. Bondár, P. Mónus, C. Czanik, M. Kiszely, Z. Gráczer, Z. Wéber, and the AlpArrayWorking Group. Relocation of Seismicity in the Pannonian Basin Using a Global 3D Velocity Model. Seismol. Res. Lett., 6:2284 – 2293, 2018. doi:10.1785/0220180143.">36</a>]</span>).
|
||||
The stand-alone iLoc code can be downloaded from the <span id="id6"></span>
|
||||
software repository.</p>
|
||||
<p>Among the major advantages of using iLoc is that it can</p>
|
||||
<ul class="simple">
|
||||
<li><p>Use any phases with valid travel-time predictions;</p></li>
|
||||
<li><p>Use seismic, hydroacoustic and infrasound arrival time, slowness and azimuth
|
||||
observations in location;</p></li>
|
||||
<li><p>Use travel-time predictions from a global 3D upper mantle velocity model;</p></li>
|
||||
<li><p>Use a local 1D velocity model;</p></li>
|
||||
<li><p>Account for the correlated travel-time prediction error structure due to
|
||||
unmodeled 3D velocity heterogeneities;</p></li>
|
||||
<li><p>Check if the data has sufficient resolution to determine the
|
||||
hypocenter depth;</p></li>
|
||||
<li><p>Identify ground truth (GT5) candidate events.</p></li>
|
||||
</ul>
|
||||
</section>
|
||||
<section id="history">
|
||||
<h3>History<a class="headerlink" href="#history" title="Permalink to this heading">¶</a></h3>
|
||||
<ul class="simple">
|
||||
<li><p>Originally developed for U.S. Air Force Research Laboratory, today the standard
|
||||
at the International Seismological Centre (ISC) replacing previous routines</p></li>
|
||||
<li><p>Open source, download website: <span id="id7"></span></p></li>
|
||||
<li><p>Integrated first in SeisComP3 in 2019</p></li>
|
||||
<li><p>Basis of the EMSC crowd-source locator, CsLoc since 2019</p></li>
|
||||
<li><p>EMSC standard as of 2022</p></li>
|
||||
</ul>
|
||||
</section>
|
||||
<section id="iloc-in-a-nutshell">
|
||||
<h3>iLoc in a nutshell<a class="headerlink" href="#iloc-in-a-nutshell" title="Permalink to this heading">¶</a></h3>
|
||||
<ul class="simple">
|
||||
<li><p>Accounts for correlated travel-time prediction errors</p></li>
|
||||
<li><p>Initial hypocenter guess from Neighborhood Algorithm search</p></li>
|
||||
<li><p>Linearised inversion using a priori estimate of the full data covariance matrix
|
||||
Attempts for free-depth solution only if there is depth resolution</p></li>
|
||||
<li><p>Default depth is derived from historical seismicity</p></li>
|
||||
<li><p>Seismic, hydroacoustic and infrasound observations</p></li>
|
||||
<li><p>Arrival time, slowness and azimuth measurements</p></li>
|
||||
<li><p>Uses most ak135 or iasp91 Earth model phases in locating</p></li>
|
||||
<li><p>Integrated RSTT travel-time predictions</p></li>
|
||||
<li><p>RSTT is default for Pn/Sn and Pg/Lg</p></li>
|
||||
<li><p>Local velocity model and local phase TT predictions for Pg/Sg/Lg, Pb/Sb, Pn/Sn.</p></li>
|
||||
</ul>
|
||||
</section>
|
||||
<section id="algorithms">
|
||||
<h3>Algorithms<a class="headerlink" href="#algorithms" title="Permalink to this heading">¶</a></h3>
|
||||
<p>This section describes some of the principles. The full description of the applied
|
||||
algorithms can be found in the iLoc documentation provided along with the package
|
||||
on the <span id="id8"></span> website.</p>
|
||||
<section id="neighbourhood-algorithm">
|
||||
<h4>Neighbourhood algorithm<a class="headerlink" href="#neighbourhood-algorithm" title="Permalink to this heading">¶</a></h4>
|
||||
<p>Linearized inversion algorithms are quite sensitive to the initial guess. In order
|
||||
to find an initial hypocenter guess for the linearized inversion the Neigbourhood
|
||||
Algorithm (<span id="id9">Sambridge [<a class="reference internal" href="../base/references.html#id73" title="M. Sambridge. Geophysical inversion with a neighbourhood algorithm. I. Searching the parameter space. Geophys. J. Int., 2:479 – 494, 1999. doi:10.1046/j.1365-246X.1999.00876.x.">60</a>]</span>; <span id="id10">Sambridge and Kennett [<a class="reference internal" href="../base/references.html#id74" title="M. Sambridge and B.L.N. Kennett. Seismic event location: non-linear inversion using a neighbourhood algorithm. Pure and Applied Geophysics, 151(1):241 – 257, 2001. doi:10.1007/PL00001158.">61</a>]</span>) is performed
|
||||
around the starting hypocentre if <a class="reference internal" href="#confval-iLoc.profile.-name.DoGridSearch"><code class="xref std std-confval docutils literal notranslate"><span class="pre">iLoc.profile.$name.DoGridSearch</span></code></a> is active.</p>
|
||||
<p>During the NA search, we identify the phases with respect to each trial hypocenter
|
||||
and calculate the misfit of the trial hypocenter. The misfit is defined as the sum
|
||||
of the <a class="reference internal" href="#confval-iLoc.profile.-name.NAlpNorm"><code class="xref std std-confval docutils literal notranslate"><span class="pre">iLoc.profile.$name.NAlpNorm</span></code></a> residual and a penalty factor that
|
||||
penalizes against freakish local minima provided by just a few phases. In the first
|
||||
iteration <a class="reference internal" href="#confval-iLoc.profile.-name.NAinitialSample"><code class="xref std std-confval docutils literal notranslate"><span class="pre">iLoc.profile.$name.NAinitialSample</span></code></a> hypocenter hypotheses are tested,
|
||||
while the subsequent iterations consider the best <a class="reference internal" href="#confval-iLoc.profile.-name.NAcells"><code class="xref std std-confval docutils literal notranslate"><span class="pre">iLoc.profile.$name.NAcells</span></code></a>
|
||||
solutions and resample the search space around them with
|
||||
<a class="reference internal" href="#confval-iLoc.profile.-name.NAnextSample"><code class="xref std std-confval docutils literal notranslate"><span class="pre">iLoc.profile.$name.NAnextSample</span></code></a> hypocenter hypotheses. The solution with
|
||||
the lowest misfit after <a class="reference internal" href="#confval-iLoc.profile.-name.NAiterMax"><code class="xref std std-confval docutils literal notranslate"><span class="pre">iLoc.profile.$name.NAiterMax</span></code></a> iteration is taken
|
||||
as the initial hypocenter for the linearized least squares inversion.</p>
|
||||
<p>A grid search can be performed to obtain a better initial hypocenter
|
||||
guess. The search is performed around the starting hypocenter.
|
||||
For a very exhaustive search one can increase <a class="reference internal" href="#confval-iLoc.profile.-name.NAinitialSample"><code class="xref std std-confval docutils literal notranslate"><span class="pre">iLoc.profile.$name.NAinitialSample</span></code></a>,
|
||||
<a class="reference internal" href="#confval-iLoc.profile.-name.NAnextSample"><code class="xref std std-confval docutils literal notranslate"><span class="pre">iLoc.profile.$name.NAnextSample</span></code></a> and <a class="reference internal" href="#confval-iLoc.profile.-name.NAcells"><code class="xref std std-confval docutils literal notranslate"><span class="pre">iLoc.profile.$name.NAcells</span></code></a>
|
||||
values. Note that the maximum value for <a class="reference internal" href="#confval-iLoc.profile.-name.NAinitialSample"><code class="xref std std-confval docutils literal notranslate"><span class="pre">iLoc.profile.$name.NAinitialSample</span></code></a>
|
||||
is around 3500 before hitting memory limits.</p>
|
||||
<p>An exhaustive search will
|
||||
considerably slow iLoc down, especially when RSTT predictions are
|
||||
enabled (<a class="reference internal" href="#confval-iLoc.profile.-name.UseRSTT"><code class="xref std std-confval docutils literal notranslate"><span class="pre">iLoc.profile.$name.UseRSTT</span></code></a>, <a class="reference internal" href="#confval-iLoc.profile.-name.UseRSTTPnSn"><code class="xref std std-confval docutils literal notranslate"><span class="pre">iLoc.profile.$name.UseRSTTPnSn</span></code></a>,
|
||||
<a class="reference internal" href="#confval-iLoc.profile.-name.UseRSTTPgLg"><code class="xref std std-confval docutils literal notranslate"><span class="pre">iLoc.profile.$name.UseRSTTPgLg</span></code></a>).</p>
|
||||
</section>
|
||||
<section id="depth-resolution">
|
||||
<h4>Depth resolution<a class="headerlink" href="#depth-resolution" title="Permalink to this heading">¶</a></h4>
|
||||
<p>Depth resolution can be provided by a local network, depth phases, core reflections
|
||||
and to a lesser extent near-regional secondary phases. iLoc attempts for a free-depth
|
||||
solution if the set of :term:arrivals meets at least one of the following conditions:</p>
|
||||
<ul class="simple">
|
||||
<li><p>Number of pairs of defining P and depth phases
|
||||
<img class="math" src="../_images/math/cd836da15c805704a25218271107e7935265b89e.png" alt="\le"/> <a class="reference internal" href="#confval-iLoc.profile.-name.MinDepthPhases"><code class="xref std std-confval docutils literal notranslate"><span class="pre">iLoc.profile.$name.MinDepthPhases</span></code></a></p></li>
|
||||
<li><p>Number of pairs of defining P and core phases
|
||||
<img class="math" src="../_images/math/cd836da15c805704a25218271107e7935265b89e.png" alt="\le"/> <a class="reference internal" href="#confval-iLoc.profile.-name.MinCorePhases"><code class="xref std std-confval docutils literal notranslate"><span class="pre">iLoc.profile.$name.MinCorePhases</span></code></a></p></li>
|
||||
<li><p>Number of pairs of defining P and S phases
|
||||
<img class="math" src="../_images/math/cd836da15c805704a25218271107e7935265b89e.png" alt="\le"/> <a class="reference internal" href="#confval-iLoc.profile.-name.MinSPpairs"><code class="xref std std-confval docutils literal notranslate"><span class="pre">iLoc.profile.$name.MinSPpairs</span></code></a>
|
||||
within a regional distance of <a class="reference internal" href="#confval-iLoc.profile.-name.MaxLocalDistDeg"><code class="xref std std-confval docutils literal notranslate"><span class="pre">iLoc.profile.$name.MaxLocalDistDeg</span></code></a>
|
||||
degree</p></li>
|
||||
<li><p>Number of defining P phases
|
||||
<img class="math" src="../_images/math/cd836da15c805704a25218271107e7935265b89e.png" alt="\le"/> <a class="reference internal" href="#confval-iLoc.profile.-name.MinLocalStations"><code class="xref std std-confval docutils literal notranslate"><span class="pre">iLoc.profile.$name.MinLocalStations</span></code></a>
|
||||
within a local distance of <a class="reference internal" href="#confval-iLoc.profile.-name.MinLocalStations"><code class="xref std std-confval docutils literal notranslate"><span class="pre">iLoc.profile.$name.MinLocalStations</span></code></a>
|
||||
degree.</p></li>
|
||||
</ul>
|
||||
<p>If there is insufficient depth resolution provided by the data, or the depth uncertainty
|
||||
for a free-depth solution exceeds a threshold, the hypocentre depth is set to the depth
|
||||
from the default depth grid if a grid point for the epicentre location exists; otherwise
|
||||
it is set to a depth <span id="id11">Bolton <em>et al.</em> [<a class="reference internal" href="../base/references.html#id9" title="M.K. Bolton, D.A. Storchak, and J. Harris. Updating default depth in the isc bulletin. Phys. Earth Planet. Int., 1:27 - 45, 2006. doi:10.1016/j.pepi.2006.03.004.">33</a>]</span> assigned to
|
||||
the corresponding Flinn-Engdahl geographic
|
||||
region (<span id="id12">Young <em>et al.</em> [<a class="reference internal" href="../base/references.html#id86" title="J.B. Young, B.W. Presgrave, H. Aichele, D.A. Wiens, and E.A. Flinn. The Flinn-Engdahl Regionalisation Scheme: The 1995 revision. Phys. Earth Planet. Int., 96:223 - 297, 1996. doi:10.1016/0031-9201(96)03141-X.">66</a>]</span>). The default depth grid (<span id="id13">Bondár and Storchak [<a class="reference internal" href="../base/references.html#id14" title="I. Bondár and D. Storchak. Improved location procedures at the International Seismological Centre. Geophys. J. Int., 3:1220 – 1244, 2011. doi:10.1111/j.1365-246X.2011.05107.x.">37</a>]</span>)
|
||||
is defined on a 0.5º x 0.5º grid as the median of all depths in the cell, provided
|
||||
that there were at least five events in the cell, and the 75–25 percent quartile
|
||||
range was less than 100 km. The latter constraint is imposed to avoid regions with
|
||||
both shallow and deep seismicity. Anthropogenic events are fixed to the surface.
|
||||
Finally, the user can fix the depth to the initial depth.</p>
|
||||
<p>iLoc reports back how the depth was determined in the FixedDepthType parameter:</p>
|
||||
<ul class="simple">
|
||||
<li><p>0 - free depth solution</p></li>
|
||||
<li><p>1 - airquake/deepquake, depth fixed to surface/MaxHypocenterDepth</p></li>
|
||||
<li><p>2 - depth fixed to depth reported by an agency (not used in <cite>SeisComP</cite>)</p></li>
|
||||
<li><p>3 - depth fixed to depth-phase depth</p></li>
|
||||
<li><p>4 - anthropogenic event, depth fixed to surface</p></li>
|
||||
<li><p>5 - depth fixed to default depth grid depth</p></li>
|
||||
<li><p>6 - no default depth grid point exists, fixed to median reported depth</p></li>
|
||||
<li><p>7 - no default depth grid point exists, fixed to GRN-dependent depth</p></li>
|
||||
<li><p>8 - depth fixed by user provided value</p></li>
|
||||
</ul>
|
||||
</section>
|
||||
<section id="linearized-inversion">
|
||||
<h4>Linearized inversion<a class="headerlink" href="#linearized-inversion" title="Permalink to this heading">¶</a></h4>
|
||||
<p>Once the Neighbourhood search get close to the global optimum, iloc switches
|
||||
to an iterative linearized least-squares inversion of travel-time, azimuth and
|
||||
slowness observations (<span id="id14">Bondár and McLaughlin [<a class="reference internal" href="../base/references.html#id13" title="I. Bondár and K.L. McLaughlin. Seismic location bias and uncertainty in the presence of correlated and non-gaussian travel-time errors. Bull. Seismol. Soc. Am., 1:172 – 193, 2009. doi:10.1785/0120080922.">35</a>]</span>; <span id="id15">Bondár and Storchak [<a class="reference internal" href="../base/references.html#id14" title="I. Bondár and D. Storchak. Improved location procedures at the International Seismological Centre. Geophys. J. Int., 3:1220 – 1244, 2011. doi:10.1111/j.1365-246X.2011.05107.x.">37</a>]</span>) to obtain the final solution
|
||||
for the hypocenter.</p>
|
||||
<p>The convergence test after (<span id="id16">Paige and Saunders [<a class="reference internal" href="../base/references.html#id59" title="C. Paige and M. Saunders. Lsqr: an algorithm for sparse linear equations and sparse least squares. ACM Transactions on Mathematical Software, 1:43 - 71, 1982. doi:10.1145/355984.355989.">54</a>]</span>) is
|
||||
applied after every iteration. Once a convergent solution is obtained, the location
|
||||
uncertainty is defined by the a posteriori model covariance matrix. The model
|
||||
covariance matrix yields the four-dimensional error ellipsoid whose projections
|
||||
provide the two-dimensional error ellipse and one-dimensional errors for depth
|
||||
and origin time. These uncertainties are scaled to the 90% confidence level
|
||||
(<span id="id17">Jordan and Sverdrup [<a class="reference internal" href="../base/references.html#id41" title="T.H. Jordan and K.A. Sverdrup. Teleseismic location techniques and their application to earthquake clusters in the south-central pacific. Bull. Seismol. Soc. Am., 4:1105 – 1130, 1981. doi:10.1785/BSSA0710041105.">47</a>]</span>).</p>
|
||||
<p>The final hypocentre is tested against the
|
||||
ground truth selection criteria (<span id="id18">Bondár and McLaughlin [<a class="reference internal" href="../base/references.html#id12" title="I. Bondár and K.L. McLaughlin. A new ground truth data set for seismic studies. Seismol. Res. Lett., 3:465 - 472, 2009. doi:10.1785/gssrl.80.3.465.">34</a>]</span>),
|
||||
and it is reported as
|
||||
a GT5candidate if the solution meets the GT5 criteria.</p>
|
||||
<p>Some important parameters are:</p>
|
||||
<ul class="simple">
|
||||
<li><p><a class="reference internal" href="#confval-iLoc.profile.-name.SigmaThreshold"><code class="xref std std-confval docutils literal notranslate"><span class="pre">iLoc.profile.$name.SigmaThreshold</span></code></a>: Residuals that exceed
|
||||
<img class="math" src="../_images/math/07995ff78d6ae4e3ecb50d9c0740eb0addf47d94.png" alt="abs(Sigmathreshold * PriorMeasError)"/> are made non-defining.</p></li>
|
||||
<li><p><a class="reference internal" href="#confval-iLoc.profile.-name.MinNdefPhases"><code class="xref std std-confval docutils literal notranslate"><span class="pre">iLoc.profile.$name.MinNdefPhases</span></code></a>: Minimum number of observations
|
||||
required to attempt for a solution.</p></li>
|
||||
</ul>
|
||||
<p>If the number of defining arrival times exceed
|
||||
<a class="reference internal" href="#confval-iLoc.profile.-name.MinNdefPhases"><code class="xref std std-confval docutils literal notranslate"><span class="pre">iLoc.profile.$name.MinNdefPhases</span></code></a>, then slowness observations will not
|
||||
be used in the location.</p>
|
||||
</section>
|
||||
</section>
|
||||
<section id="integration-into-scname">
|
||||
<h3>Integration into <cite>SeisComP</cite><a class="headerlink" href="#integration-into-scname" title="Permalink to this heading">¶</a></h3>
|
||||
<ul class="simple">
|
||||
<li><p>Integration of iLoc into <cite>SeisComP</cite> is provided by an external library of
|
||||
routines (<span id="id19"></span>).</p></li>
|
||||
<li><p><cite>SeisComP</cite> modules call iLoc routines by passing the objects via the plugin
|
||||
<em>lociloc</em> installed in <code class="file docutils literal notranslate"><span class="pre">@DATADIR@/plugins/lociloc.so</span></code>.</p></li>
|
||||
<li><p>iLoc returns objects to <cite>SeisComP</cite> for integration.</p></li>
|
||||
<li><p>The iLoc implementation in <cite>SeisComP</cite> retains all original iLoc functionalities.</p></li>
|
||||
</ul>
|
||||
<p>Read the section <a class="reference internal" href="#iloc-setup"><span class="std std-ref">Setup in SeisComP</span></a> for the installation of the iLoc library and
|
||||
the configuration in <cite>SeisComP</cite>.</p>
|
||||
</section>
|
||||
<section id="velocity-models">
|
||||
<h3>Velocity models<a class="headerlink" href="#velocity-models" title="Permalink to this heading">¶</a></h3>
|
||||
<p>iLoc ships with the global models <em>iasp91</em> and <em>ak135</em> as well as with regional
|
||||
seismic travel-time tables, RSTT, which, if activated by configuration, replaces
|
||||
the global models in areas where they are defined.</p>
|
||||
<section id="global-models">
|
||||
<span id="iloc-velocity-global"></span><h4>Global models<a class="headerlink" href="#global-models" title="Permalink to this heading">¶</a></h4>
|
||||
<p>The global models <em>iasp91</em> and <em>ak135</em> and RSTT are available by default without
|
||||
further configuration.</p>
|
||||
</section>
|
||||
<section id="rstt">
|
||||
<span id="iloc-velocity-rstt"></span><h4>RSTT<a class="headerlink" href="#rstt" title="Permalink to this heading">¶</a></h4>
|
||||
<p>RSTT are available in <code class="file docutils literal notranslate"><span class="pre">@DATADIR@/iloc/RSTTmodels/pdu202009Du.geotess</span></code>.
|
||||
Custom RSTT can be integrated into iLoc and provided to <cite>SeisComP</cite>.
|
||||
For adding custom RSTT to iLoc read the original iLoc documentation from the
|
||||
<span id="id20"></span> software repository.</p>
|
||||
<p>The usage of RSTT is controlled per iLoc profile by global configuration
|
||||
parameters</p>
|
||||
<ul class="simple">
|
||||
<li><p><a class="reference internal" href="#confval-iLoc.profile.-name.UseRSTT"><code class="xref std std-confval docutils literal notranslate"><span class="pre">iLoc.profile.$name.UseRSTT</span></code></a></p></li>
|
||||
<li><p><a class="reference internal" href="#confval-iLoc.profile.-name.UseRSTTPnSn"><code class="xref std std-confval docutils literal notranslate"><span class="pre">iLoc.profile.$name.UseRSTTPnSn</span></code></a></p></li>
|
||||
<li><p><a class="reference internal" href="#confval-iLoc.profile.-name.UseRSTTPgLg"><code class="xref std std-confval docutils literal notranslate"><span class="pre">iLoc.profile.$name.UseRSTTPgLg</span></code></a></p></li>
|
||||
</ul>
|
||||
</section>
|
||||
<section id="local-velocity-models">
|
||||
<span id="iloc-velocity-local"></span><h4>Local velocity models<a class="headerlink" href="#local-velocity-models" title="Permalink to this heading">¶</a></h4>
|
||||
<p>Custom local velocity models can be provided by a file in
|
||||
<code class="file docutils literal notranslate"><span class="pre">@DATADIR@/iloc/localmodels</span></code>. Example file
|
||||
<code class="file docutils literal notranslate"><span class="pre">@DATADIR@/iloc/localmodels/test.localmodel.dat</span></code>:</p>
|
||||
<div class="highlight-properties notranslate"><div class="highlight"><pre><span></span><span class="c1">#</span>
|
||||
<span class="c1"># test</span>
|
||||
<span class="c1">#</span>
|
||||
<span class="c1"># number of layers</span>
|
||||
<span class="na">4</span>
|
||||
<span class="w"> </span><span class="na">0.000</span><span class="w"> </span><span class="s">5.8000 3.4600 x</span>
|
||||
<span class="w"> </span><span class="na">20.000</span><span class="w"> </span><span class="s">6.5000 3.8500 CONRAD</span>
|
||||
<span class="w"> </span><span class="na">45.000</span><span class="w"> </span><span class="s">8.0400 4.4800 MOHO</span>
|
||||
<span class="w"> </span><span class="na">77.500</span><span class="w"> </span><span class="s">8.0400 4.4800 x</span>
|
||||
</pre></div>
|
||||
</div>
|
||||
<p>Once added, the velocity can be configured in <cite>SeisComP</cite> as set out in section
|
||||
<a class="reference internal" href="#iloc-setup"><span class="std std-ref">Setup in SeisComP</span></a>.</p>
|
||||
</section>
|
||||
</section>
|
||||
<section id="station-elevation">
|
||||
<h3>Station elevation<a class="headerlink" href="#station-elevation" title="Permalink to this heading">¶</a></h3>
|
||||
<p>iLoc considers station elevation. It calculates the elevation correction,
|
||||
<em>elevationCorrection</em>, for a station as</p>
|
||||
<div class="math">
|
||||
<p><img src="../_images/math/5f9c3c10facedc7a9d6e72dcdc5f421acb20e77c.png" alt="elevationCorrection = \frac{\sqrt{1 - (surfVel * p)^2} * elev}{surfVel}"/></p>
|
||||
</div><p>where</p>
|
||||
<ul class="simple">
|
||||
<li><p><em>elev</em>: elevation of the station</p></li>
|
||||
<li><p><em>p</em>: the ray parameter (horizontal slowness)</p></li>
|
||||
<li><p><em>surfVel</em>: layer P or S velocity of at the surface depending on the last lag
|
||||
of the phase name.</p></li>
|
||||
</ul>
|
||||
<div class="admonition note">
|
||||
<p class="admonition-title">Note</p>
|
||||
<p>iLoc does not allow airquakes or source locations above datum (0 km). If the
|
||||
depth of an origin becomes negative, iLoc
|
||||
fixes the depth to 0 km and the depth type of the origin will be “operator
|
||||
assigned”.</p>
|
||||
</div>
|
||||
</section>
|
||||
<section id="resources">
|
||||
<span id="sec-iloc-references"></span><h3>Resources<a class="headerlink" href="#resources" title="Permalink to this heading">¶</a></h3>
|
||||
<p>iLoc has taken advantage of many publications or has been cited therein.
|
||||
Read the section <a class="reference internal" href="../base/references.html#sec-references"><span class="std std-ref">References</span></a> for a list.</p>
|
||||
</section>
|
||||
</section>
|
||||
<section id="setup-in-scname">
|
||||
<span id="iloc-setup"></span><h2>Setup in <cite>SeisComP</cite><a class="headerlink" href="#setup-in-scname" title="Permalink to this heading">¶</a></h2>
|
||||
<ol class="arabic">
|
||||
<li><p>Add the plugin <em>lociloc</em> to the global configuration, e.g. in
|
||||
<code class="file docutils literal notranslate"><span class="pre">@SYSTEMCONFIGDIR@/global.cfg</span></code>:</p>
|
||||
<div class="highlight-properties notranslate"><div class="highlight"><pre><span></span><span class="na">plugins</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s">${plugins}, lociloc</span>
|
||||
</pre></div>
|
||||
</div>
|
||||
</li>
|
||||
<li><p>Install the dependencies missing for iLoc. For download, the system variable
|
||||
<em>SEISCOMP_ROOT</em> must be defined which you may wish to test first:</p>
|
||||
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span><span class="nb">echo</span><span class="w"> </span><span class="nv">$SEISCOMP_ROOT</span>
|
||||
</pre></div>
|
||||
</div>
|
||||
<p>In case the variable is undefined, follow the instructions in section
|
||||
<span class="xref std std-ref">getting-started-variables</span>.</p>
|
||||
<p>After <em>$SEISCOMP_ROOT</em> is defined you may install the software dependencies
|
||||
for iLoc using the <a class="reference internal" href="../base/installation.html#software-dependencies"><span class="std std-ref">install scripts</span></a> or simply
|
||||
the <a class="reference internal" href="seiscomp.html#seiscomp"><span class="std std-ref">seiscomp</span></a> script:</p>
|
||||
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>seiscomp<span class="w"> </span>install-deps<span class="w"> </span>iloc
|
||||
</pre></div>
|
||||
</div>
|
||||
<p>The install scripts will fetch auxiliary files from <span id="id21"></span>
|
||||
and install them in <code class="file docutils literal notranslate"><span class="pre">@DATADIR@/iloc/iLocAuxDir</span></code>. For manual download and
|
||||
installation read the install scripts located in
|
||||
<code class="file docutils literal notranslate"><span class="pre">@DATADIR@/deps/[os]/[version]/install-iloc.sh</span></code>.</p>
|
||||
<div class="admonition note">
|
||||
<p class="admonition-title">Note</p>
|
||||
<ul class="simple">
|
||||
<li><p>Check the <span id="id22"></span> website for updates before downloading
|
||||
the file since the version number, hence the name of the download file
|
||||
may change.</p></li>
|
||||
<li><p>Instead of generating the <code class="file docutils literal notranslate"><span class="pre">SEISCOMP_ROOT/share/iloc/iLocAuxDir</span></code>
|
||||
directory, you can also manually install the dependencies somewhere else,
|
||||
create a symbolic link and maintain always the same iLoc version in
|
||||
<cite>SeisComP</cite> and externally.</p></li>
|
||||
</ul>
|
||||
</div>
|
||||
</li>
|
||||
<li><p>Add and configure iLoc profiles for the velocity models. The global models
|
||||
<em>iasp91</em> and <em>ak135</em> are considered by default with default configuration
|
||||
parameters even without setting up <em>iasp91</em>/<em>ak135</em> profiles. You may,
|
||||
however, create these profiles for their customization.</p>
|
||||
<p>Create new profiles or consider existing ones for adjusting their
|
||||
configuration:</p>
|
||||
<ul class="simple">
|
||||
<li><p><a class="reference internal" href="#confval-iLoc.profile.-name.globalModel"><code class="xref std std-confval docutils literal notranslate"><span class="pre">iLoc.profile.$name.globalModel</span></code></a>: The name of the
|
||||
<a class="reference internal" href="#iloc-velocity-global"><span class="std std-ref">global model</span></a>, e.g. <em>iasp91</em> or <em>ak135</em>.</p></li>
|
||||
<li><p>Consider the <a class="reference internal" href="#iloc-velocity-rstt"><span class="std std-ref">RSTT parameters</span></a>.</p></li>
|
||||
<li><p><a class="reference internal" href="#confval-iLoc.profile.-name.LocalVmodel"><code class="xref std std-confval docutils literal notranslate"><span class="pre">iLoc.profile.$name.LocalVmodel</span></code></a>, <a class="reference internal" href="#confval-iLoc.profile.-name.UseLocalTT"><code class="xref std std-confval docutils literal notranslate"><span class="pre">iLoc.profile.$name.UseLocalTT</span></code></a>
|
||||
and <a class="reference internal" href="#confval-iLoc.profile.-name.MaxLocalTTDelta"><code class="xref std std-confval docutils literal notranslate"><span class="pre">iLoc.profile.$name.MaxLocalTTDelta</span></code></a>: The definition of a
|
||||
<a class="reference internal" href="#iloc-velocity-local"><span class="std std-ref">local velocity model</span></a>: model file, default
|
||||
usability, distance range.</p></li>
|
||||
<li><p><a class="reference internal" href="#confval-iLoc.profile.-name.DoNotRenamePhases"><code class="xref std std-confval docutils literal notranslate"><span class="pre">iLoc.profile.$name.DoNotRenamePhases</span></code></a>: Renaming seismic phases
|
||||
automatically
|
||||
impacts the usability of the origins with other locators and locator profiles.
|
||||
Activate the parameter to avoid phase renaming.</p></li>
|
||||
<li><p>Consider the remaining parameters.</p></li>
|
||||
</ul>
|
||||
<div class="admonition note">
|
||||
<p class="admonition-title">Note</p>
|
||||
<p>Creating the profiles allows using the same global velocity model along
|
||||
with different local models or RSTT settings in separate profiles.</p>
|
||||
</div>
|
||||
</li>
|
||||
<li><p>Test the locator using <a class="reference internal" href="scolv.html#scolv"><span class="std std-ref">scolv</span></a> or configure with <a class="reference internal" href="screloc.html#screloc"><span class="std std-ref">screloc</span></a> or other
|
||||
locator modules.</p></li>
|
||||
</ol>
|
||||
</section>
|
||||
<section id="application-in-scname">
|
||||
<span id="iloc-application"></span><h2>Application in <cite>SeisComP</cite><a class="headerlink" href="#application-in-scname" title="Permalink to this heading">¶</a></h2>
|
||||
<p>Once the <em>lociloc</em> plugin is configured, the iLoc locator can be applied</p>
|
||||
<ul class="simple">
|
||||
<li><p>Automatically e.g. in <a class="reference internal" href="screloc.html#screloc"><span class="std std-ref">screloc</span></a> or</p></li>
|
||||
<li><p>Interactively in <a class="reference internal" href="scolv.html#scolv"><span class="std std-ref">scolv</span></a>.</p></li>
|
||||
</ul>
|
||||
<p>For using iLoc in <a class="reference internal" href="scolv.html#scolv"><span class="std std-ref">scolv</span></a> select it in the locator menu of the Location tab</p>
|
||||
<figure class="align-center" id="id23">
|
||||
<img alt="../_images/scolv-iloc-locator.png" src="../_images/scolv-iloc-locator.png" />
|
||||
<figcaption>
|
||||
<p><span class="caption-text">Select iLoc locator</span><a class="headerlink" href="#id23" title="Permalink to this image">¶</a></p>
|
||||
</figcaption>
|
||||
</figure>
|
||||
<p>along with a profile:</p>
|
||||
<figure class="align-center" id="id24">
|
||||
<img alt="../_images/scolv-iloc-profile.png" src="../_images/scolv-iloc-profile.png" />
|
||||
<figcaption>
|
||||
<p><span class="caption-text">Select iLoc profile</span><a class="headerlink" href="#id24" title="Permalink to this image">¶</a></p>
|
||||
</figcaption>
|
||||
</figure>
|
||||
<p>The parameters for iLoc can be adjusted by pressing the wrench button next to the
|
||||
locator selection combo box</p>
|
||||
<figure class="align-center" id="id25">
|
||||
<img alt="../_images/scolv-iloc-change.png" src="../_images/scolv-iloc-change.png" />
|
||||
<figcaption>
|
||||
<p><span class="caption-text">Start the settings dialog</span><a class="headerlink" href="#id25" title="Permalink to this image">¶</a></p>
|
||||
</figcaption>
|
||||
</figure>
|
||||
<p>which opens the iLoc settings dialog:</p>
|
||||
<figure class="align-center" id="id26">
|
||||
<img alt="../_images/scolv-iloc-settings.png" src="../_images/scolv-iloc-settings.png" />
|
||||
<figcaption>
|
||||
<p><span class="caption-text">Adjust the settings and click OK to confirm</span><a class="headerlink" href="#id26" title="Permalink to this image">¶</a></p>
|
||||
</figcaption>
|
||||
</figure>
|
||||
<div class="admonition warning">
|
||||
<p class="admonition-title">Warning</p>
|
||||
<p>By default, automatic phase renaming by iLoc is active. The renaming may
|
||||
change the phase names, e.g. from P to Pn.</p>
|
||||
<p>Renaming seismic phases automatically will later impact the usability of
|
||||
the new origins with other locators and locator
|
||||
profiles. Deactivate <em>DoNotRenamePhases</em> to avoid phase renaming.</p>
|
||||
<p>However,
|
||||
when deactivating, iLoc may not provide results if the initial phases do not
|
||||
exist in the phase table for the given source depth and epicentral distance.
|
||||
Example: For great source depth and small epicentral distance, the first arrival
|
||||
phase is p or Pn and not P but <cite>SeisComP</cite> provides P.</p>
|
||||
</div>
|
||||
<p>After relocating, the iLoc locator and the selected profile are shown in the
|
||||
<a class="reference internal" href="scolv.html#scolv"><span class="std std-ref">scolv</span></a> Location tab as Method and Earth model, respectively:</p>
|
||||
<figure class="align-center" id="id27">
|
||||
<img alt="../_images/scolv-iloc-info.png" src="../_images/scolv-iloc-info.png" />
|
||||
<figcaption>
|
||||
<p><span class="caption-text">Information in scolv Locator tab</span><a class="headerlink" href="#id27" title="Permalink to this image">¶</a></p>
|
||||
</figcaption>
|
||||
</figure>
|
||||
</section>
|
||||
<section id="module-configuration">
|
||||
<span id="global-iloc-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>iLoc.*</strong>
|
||||
<em>Locator parameters: iLoc</em></p>
|
||||
</div>
|
||||
<dl class="std confval">
|
||||
<dt class="sig sig-object std" id="confval-iLoc.auxDir">
|
||||
<span class="sig-name descname"><span class="pre">iLoc.auxDir</span></span><a class="headerlink" href="#confval-iLoc.auxDir" title="Permalink to this definition">¶</a></dt>
|
||||
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">@DATADIR@/iloc/iLocAuxDir</span></code></p>
|
||||
<p>Type: <em>string</em></p>
|
||||
<p>iLoc directory for auxialiary files and directories. Some
|
||||
of them must be provided from the iLoc website. Read the
|
||||
documentation for their installation.</p>
|
||||
</dd></dl>
|
||||
|
||||
<dl class="std confval">
|
||||
<dt class="sig sig-object std" id="confval-iLoc.usePickUncertainties">
|
||||
<span class="sig-name descname"><span class="pre">iLoc.usePickUncertainties</span></span><a class="headerlink" href="#confval-iLoc.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 uncertainties (true) or to use the
|
||||
default timing error (false).</p>
|
||||
</dd></dl>
|
||||
|
||||
<dl class="std confval">
|
||||
<dt class="sig sig-object std" id="confval-iLoc.defaultTimeError">
|
||||
<span class="sig-name descname"><span class="pre">iLoc.defaultTimeError</span></span><a class="headerlink" href="#confval-iLoc.defaultTimeError" title="Permalink to this definition">¶</a></dt>
|
||||
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">9999999</span></code></p>
|
||||
<p>Type: <em>double</em></p>
|
||||
<p>Unit: <em>s</em></p>
|
||||
<p>The default pick time error forwarded to iLoc if no pick time
|
||||
uncertainties are set or if using the pick time uncertainties
|
||||
is disabled.</p>
|
||||
</dd></dl>
|
||||
|
||||
<dl class="std confval">
|
||||
<dt class="sig sig-object std" id="confval-iLoc.profiles">
|
||||
<span class="sig-name descname"><span class="pre">iLoc.profiles</span></span><a class="headerlink" href="#confval-iLoc.profiles" title="Permalink to this definition">¶</a></dt>
|
||||
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">iasp91,ak135</span></code></p>
|
||||
<p>Type: <em>list:string</em></p>
|
||||
<p>iLoc profile name.
|
||||
Multiples names may be set separated by comma.
|
||||
Each profile can have different velocity or parameters.</p>
|
||||
</dd></dl>
|
||||
|
||||
<div class="admonition note">
|
||||
<p class="admonition-title">Note</p>
|
||||
<p><strong>iLoc.profile.*</strong>
|
||||
<em>Profiles containing the specific locator parameters. For</em>
|
||||
<em>the global models, iasp91 and ak135, profiles are</em>
|
||||
<em>automatically considered with defaults.</em>
|
||||
<em>To adjust the profile parameters the corresponding profile</em>
|
||||
<em>must be created.</em></p>
|
||||
</div>
|
||||
<div class="admonition note">
|
||||
<p class="admonition-title">Note</p>
|
||||
<p><strong>iLoc.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-iLoc.profiles"><code class="xref std std-confval docutils literal notranslate"><span class="pre">iLoc.profiles</span></code></a> to become active.</p>
|
||||
<div class="highlight-sh notranslate"><div class="highlight"><pre><span></span>iLoc.profiles<span class="w"> </span><span class="o">=</span><span class="w"> </span>a,b
|
||||
iLoc.profile.a.value1<span class="w"> </span><span class="o">=</span><span class="w"> </span>...
|
||||
iLoc.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 iLoc.profiles</span>
|
||||
iLoc.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-iLoc.profile.-name.Verbose">
|
||||
<span class="sig-name descname"><span class="pre">iLoc.profile.$name.Verbose</span></span><a class="headerlink" href="#confval-iLoc.profile.-name.Verbose" 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>
|
||||
</dd></dl>
|
||||
|
||||
<dl class="std confval">
|
||||
<dt class="sig sig-object std" id="confval-iLoc.profile.-name.globalModel">
|
||||
<span class="sig-name descname"><span class="pre">iLoc.profile.$name.globalModel</span></span><a class="headerlink" href="#confval-iLoc.profile.-name.globalModel" title="Permalink to this definition">¶</a></dt>
|
||||
<dd><p>Type: <em>string</em></p>
|
||||
<p>Name of globally applied velocity model
|
||||
into which RSTT or the local model is integrated. If
|
||||
unset, the name of the profile is considered instead.</p>
|
||||
</dd></dl>
|
||||
|
||||
<dl class="std confval">
|
||||
<dt class="sig sig-object std" id="confval-iLoc.profile.-name.UseRSTT">
|
||||
<span class="sig-name descname"><span class="pre">iLoc.profile.$name.UseRSTT</span></span><a class="headerlink" href="#confval-iLoc.profile.-name.UseRSTT" 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 regional seismic travel-time tables</p>
|
||||
</dd></dl>
|
||||
|
||||
<dl class="std confval">
|
||||
<dt class="sig sig-object std" id="confval-iLoc.profile.-name.UseRSTTPnSn">
|
||||
<span class="sig-name descname"><span class="pre">iLoc.profile.$name.UseRSTTPnSn</span></span><a class="headerlink" href="#confval-iLoc.profile.-name.UseRSTTPnSn" 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>Use regional seismic travel-time tables for Pn and Sn</p>
|
||||
</dd></dl>
|
||||
|
||||
<dl class="std confval">
|
||||
<dt class="sig sig-object std" id="confval-iLoc.profile.-name.UseRSTTPgLg">
|
||||
<span class="sig-name descname"><span class="pre">iLoc.profile.$name.UseRSTTPgLg</span></span><a class="headerlink" href="#confval-iLoc.profile.-name.UseRSTTPgLg" 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>Use regional seismic travel-time tables for Pg and Lg</p>
|
||||
</dd></dl>
|
||||
|
||||
<dl class="std confval">
|
||||
<dt class="sig sig-object std" id="confval-iLoc.profile.-name.UseLocalTT">
|
||||
<span class="sig-name descname"><span class="pre">iLoc.profile.$name.UseLocalTT</span></span><a class="headerlink" href="#confval-iLoc.profile.-name.UseLocalTT" 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 local velocity model if defined in LocalVmodel.</p>
|
||||
</dd></dl>
|
||||
|
||||
<dl class="std confval">
|
||||
<dt class="sig sig-object std" id="confval-iLoc.profile.-name.LocalVmodel">
|
||||
<span class="sig-name descname"><span class="pre">iLoc.profile.$name.LocalVmodel</span></span><a class="headerlink" href="#confval-iLoc.profile.-name.LocalVmodel" title="Permalink to this definition">¶</a></dt>
|
||||
<dd><p>Type: <em>string</em></p>
|
||||
<p>Full path to a file containing the local velocity model.
|
||||
Requires: UseLocalTT = true. Empty string or unset or
|
||||
UseLocalTT = false disables using a local model in
|
||||
this profile.</p>
|
||||
<p>Example:</p>
|
||||
<p>@DATADIR@/iloc/iLocAuxDir/localmodels/model.localmodel.dat.</p>
|
||||
</dd></dl>
|
||||
|
||||
<dl class="std confval">
|
||||
<dt class="sig sig-object std" id="confval-iLoc.profile.-name.MaxLocalTTDelta">
|
||||
<span class="sig-name descname"><span class="pre">iLoc.profile.$name.MaxLocalTTDelta</span></span><a class="headerlink" href="#confval-iLoc.profile.-name.MaxLocalTTDelta" title="Permalink to this definition">¶</a></dt>
|
||||
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">3</span></code></p>
|
||||
<p>Type: <em>float</em></p>
|
||||
<p>Unit: <em>deg</em></p>
|
||||
<p>Maximum epicentral distance for applying the local
|
||||
velocity model.</p>
|
||||
</dd></dl>
|
||||
|
||||
<dl class="std confval">
|
||||
<dt class="sig sig-object std" id="confval-iLoc.profile.-name.DoGridSearch">
|
||||
<span class="sig-name descname"><span class="pre">iLoc.profile.$name.DoGridSearch</span></span><a class="headerlink" href="#confval-iLoc.profile.-name.DoGridSearch" 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>Perform neighbourhood algorithm</p>
|
||||
</dd></dl>
|
||||
|
||||
<dl class="std confval">
|
||||
<dt class="sig sig-object std" id="confval-iLoc.profile.-name.NAsearchRadius">
|
||||
<span class="sig-name descname"><span class="pre">iLoc.profile.$name.NAsearchRadius</span></span><a class="headerlink" href="#confval-iLoc.profile.-name.NAsearchRadius" title="Permalink to this definition">¶</a></dt>
|
||||
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">5</span></code></p>
|
||||
<p>Type: <em>float</em></p>
|
||||
<p>Unit: <em>deg</em></p>
|
||||
<p>Neighbourhood Algorithm: Search radius around initial
|
||||
epicentre</p>
|
||||
</dd></dl>
|
||||
|
||||
<dl class="std confval">
|
||||
<dt class="sig sig-object std" id="confval-iLoc.profile.-name.NAsearchDepth">
|
||||
<span class="sig-name descname"><span class="pre">iLoc.profile.$name.NAsearchDepth</span></span><a class="headerlink" href="#confval-iLoc.profile.-name.NAsearchDepth" title="Permalink to this definition">¶</a></dt>
|
||||
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">300</span></code></p>
|
||||
<p>Type: <em>float</em></p>
|
||||
<p>Unit: <em>km</em></p>
|
||||
<p>Neighbourhood Algorithm: Search radius around initial
|
||||
depth</p>
|
||||
</dd></dl>
|
||||
|
||||
<dl class="std confval">
|
||||
<dt class="sig sig-object std" id="confval-iLoc.profile.-name.NAsearchOT">
|
||||
<span class="sig-name descname"><span class="pre">iLoc.profile.$name.NAsearchOT</span></span><a class="headerlink" href="#confval-iLoc.profile.-name.NAsearchOT" title="Permalink to this definition">¶</a></dt>
|
||||
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">30</span></code></p>
|
||||
<p>Type: <em>float</em></p>
|
||||
<p>Unit: <em>s</em></p>
|
||||
<p>Neighbourhood Algorithm: Search radius around initial
|
||||
origin time</p>
|
||||
</dd></dl>
|
||||
|
||||
<dl class="std confval">
|
||||
<dt class="sig sig-object std" id="confval-iLoc.profile.-name.NAlpNorm">
|
||||
<span class="sig-name descname"><span class="pre">iLoc.profile.$name.NAlpNorm</span></span><a class="headerlink" href="#confval-iLoc.profile.-name.NAlpNorm" title="Permalink to this definition">¶</a></dt>
|
||||
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">1</span></code></p>
|
||||
<p>Type: <em>float</em></p>
|
||||
<p>Neighbourhood Algorithm: p-value for norm to compute
|
||||
misfit [1,2]</p>
|
||||
</dd></dl>
|
||||
|
||||
<dl class="std confval">
|
||||
<dt class="sig sig-object std" id="confval-iLoc.profile.-name.NAiterMax">
|
||||
<span class="sig-name descname"><span class="pre">iLoc.profile.$name.NAiterMax</span></span><a class="headerlink" href="#confval-iLoc.profile.-name.NAiterMax" title="Permalink to this definition">¶</a></dt>
|
||||
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">5</span></code></p>
|
||||
<p>Type: <em>integer</em></p>
|
||||
<p>Neighbourhood Algorithm: Maximum number of iterations</p>
|
||||
</dd></dl>
|
||||
|
||||
<dl class="std confval">
|
||||
<dt class="sig sig-object std" id="confval-iLoc.profile.-name.NAcells">
|
||||
<span class="sig-name descname"><span class="pre">iLoc.profile.$name.NAcells</span></span><a class="headerlink" href="#confval-iLoc.profile.-name.NAcells" title="Permalink to this definition">¶</a></dt>
|
||||
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">25</span></code></p>
|
||||
<p>Type: <em>integer</em></p>
|
||||
<p>Neighbourhood Algorithm: Number of cells to be resampled
|
||||
at each iteration</p>
|
||||
</dd></dl>
|
||||
|
||||
<dl class="std confval">
|
||||
<dt class="sig sig-object std" id="confval-iLoc.profile.-name.NAinitialSample">
|
||||
<span class="sig-name descname"><span class="pre">iLoc.profile.$name.NAinitialSample</span></span><a class="headerlink" href="#confval-iLoc.profile.-name.NAinitialSample" title="Permalink to this definition">¶</a></dt>
|
||||
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">1000</span></code></p>
|
||||
<p>Type: <em>integer</em></p>
|
||||
<p>Neighbourhood Algorithm: Size of initial sample</p>
|
||||
</dd></dl>
|
||||
|
||||
<dl class="std confval">
|
||||
<dt class="sig sig-object std" id="confval-iLoc.profile.-name.NAnextSample">
|
||||
<span class="sig-name descname"><span class="pre">iLoc.profile.$name.NAnextSample</span></span><a class="headerlink" href="#confval-iLoc.profile.-name.NAnextSample" title="Permalink to this definition">¶</a></dt>
|
||||
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">100</span></code></p>
|
||||
<p>Type: <em>integer</em></p>
|
||||
<p>Neighbourhood Algorithm: Size of subsequent samples</p>
|
||||
</dd></dl>
|
||||
|
||||
<dl class="std confval">
|
||||
<dt class="sig sig-object std" id="confval-iLoc.profile.-name.MinDepthPhases">
|
||||
<span class="sig-name descname"><span class="pre">iLoc.profile.$name.MinDepthPhases</span></span><a class="headerlink" href="#confval-iLoc.profile.-name.MinDepthPhases" title="Permalink to this definition">¶</a></dt>
|
||||
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">3</span></code></p>
|
||||
<p>Type: <em>integer</em></p>
|
||||
<p>Depth resolution: Minimum number of depth phases for depdp</p>
|
||||
</dd></dl>
|
||||
|
||||
<dl class="std confval">
|
||||
<dt class="sig sig-object std" id="confval-iLoc.profile.-name.MaxLocalDistDeg">
|
||||
<span class="sig-name descname"><span class="pre">iLoc.profile.$name.MaxLocalDistDeg</span></span><a class="headerlink" href="#confval-iLoc.profile.-name.MaxLocalDistDeg" title="Permalink to this definition">¶</a></dt>
|
||||
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">0.2</span></code></p>
|
||||
<p>Type: <em>float</em></p>
|
||||
<p>Unit: <em>deg</em></p>
|
||||
<p>Depth resolution: Maximum local distance</p>
|
||||
</dd></dl>
|
||||
|
||||
<dl class="std confval">
|
||||
<dt class="sig sig-object std" id="confval-iLoc.profile.-name.MinLocalStations">
|
||||
<span class="sig-name descname"><span class="pre">iLoc.profile.$name.MinLocalStations</span></span><a class="headerlink" href="#confval-iLoc.profile.-name.MinLocalStations" title="Permalink to this definition">¶</a></dt>
|
||||
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">1</span></code></p>
|
||||
<p>Type: <em>integer</em></p>
|
||||
<p>Depth resolution: Minimum number of local defining stations</p>
|
||||
</dd></dl>
|
||||
|
||||
<dl class="std confval">
|
||||
<dt class="sig sig-object std" id="confval-iLoc.profile.-name.MaxSPDistDeg">
|
||||
<span class="sig-name descname"><span class="pre">iLoc.profile.$name.MaxSPDistDeg</span></span><a class="headerlink" href="#confval-iLoc.profile.-name.MaxSPDistDeg" title="Permalink to this definition">¶</a></dt>
|
||||
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">2.0</span></code></p>
|
||||
<p>Type: <em>float</em></p>
|
||||
<p>Unit: <em>deg</em></p>
|
||||
<p>Depth resolution: Maximum distance for using S-P travel-time differences.</p>
|
||||
</dd></dl>
|
||||
|
||||
<dl class="std confval">
|
||||
<dt class="sig sig-object std" id="confval-iLoc.profile.-name.MinSPpairs">
|
||||
<span class="sig-name descname"><span class="pre">iLoc.profile.$name.MinSPpairs</span></span><a class="headerlink" href="#confval-iLoc.profile.-name.MinSPpairs" title="Permalink to this definition">¶</a></dt>
|
||||
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">3</span></code></p>
|
||||
<p>Type: <em>integer</em></p>
|
||||
<p>Depth resolution: Minimum number of defining S-P phase pairs</p>
|
||||
</dd></dl>
|
||||
|
||||
<dl class="std confval">
|
||||
<dt class="sig sig-object std" id="confval-iLoc.profile.-name.MinCorePhases">
|
||||
<span class="sig-name descname"><span class="pre">iLoc.profile.$name.MinCorePhases</span></span><a class="headerlink" href="#confval-iLoc.profile.-name.MinCorePhases" title="Permalink to this definition">¶</a></dt>
|
||||
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">3</span></code></p>
|
||||
<p>Type: <em>integer</em></p>
|
||||
<p>Depth resolution: Minimum number of defining core reflection phases</p>
|
||||
</dd></dl>
|
||||
|
||||
<dl class="std confval">
|
||||
<dt class="sig sig-object std" id="confval-iLoc.profile.-name.MaxShallowDepthError">
|
||||
<span class="sig-name descname"><span class="pre">iLoc.profile.$name.MaxShallowDepthError</span></span><a class="headerlink" href="#confval-iLoc.profile.-name.MaxShallowDepthError" title="Permalink to this definition">¶</a></dt>
|
||||
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">30.0</span></code></p>
|
||||
<p>Type: <em>float</em></p>
|
||||
<p>Unit: <em>km</em></p>
|
||||
<p>Depth resolution: Maximum depth error for crustal free-depth</p>
|
||||
</dd></dl>
|
||||
|
||||
<dl class="std confval">
|
||||
<dt class="sig sig-object std" id="confval-iLoc.profile.-name.MaxDeepDepthError">
|
||||
<span class="sig-name descname"><span class="pre">iLoc.profile.$name.MaxDeepDepthError</span></span><a class="headerlink" href="#confval-iLoc.profile.-name.MaxDeepDepthError" title="Permalink to this definition">¶</a></dt>
|
||||
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">60.0</span></code></p>
|
||||
<p>Type: <em>float</em></p>
|
||||
<p>Unit: <em>km</em></p>
|
||||
<p>Depth resolution: Maximum depth error for deep free-depth</p>
|
||||
</dd></dl>
|
||||
|
||||
<dl class="std confval">
|
||||
<dt class="sig sig-object std" id="confval-iLoc.profile.-name.DoCorrelatedErrors">
|
||||
<span class="sig-name descname"><span class="pre">iLoc.profile.$name.DoCorrelatedErrors</span></span><a class="headerlink" href="#confval-iLoc.profile.-name.DoCorrelatedErrors" 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>Linearized inversion: Account for correlated errors</p>
|
||||
</dd></dl>
|
||||
|
||||
<dl class="std confval">
|
||||
<dt class="sig sig-object std" id="confval-iLoc.profile.-name.SigmaThreshold">
|
||||
<span class="sig-name descname"><span class="pre">iLoc.profile.$name.SigmaThreshold</span></span><a class="headerlink" href="#confval-iLoc.profile.-name.SigmaThreshold" title="Permalink to this definition">¶</a></dt>
|
||||
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">6.0</span></code></p>
|
||||
<p>Type: <em>float</em></p>
|
||||
<p>Unit: <em>s</em></p>
|
||||
<p>Linearized inversion: Used to exclude big residuals from solution</p>
|
||||
</dd></dl>
|
||||
|
||||
<dl class="std confval">
|
||||
<dt class="sig sig-object std" id="confval-iLoc.profile.-name.AllowDamping">
|
||||
<span class="sig-name descname"><span class="pre">iLoc.profile.$name.AllowDamping</span></span><a class="headerlink" href="#confval-iLoc.profile.-name.AllowDamping" 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>Linearized inversion: Allow damping of model vector</p>
|
||||
</dd></dl>
|
||||
|
||||
<dl class="std confval">
|
||||
<dt class="sig sig-object std" id="confval-iLoc.profile.-name.MinIterations">
|
||||
<span class="sig-name descname"><span class="pre">iLoc.profile.$name.MinIterations</span></span><a class="headerlink" href="#confval-iLoc.profile.-name.MinIterations" title="Permalink to this definition">¶</a></dt>
|
||||
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">4</span></code></p>
|
||||
<p>Type: <em>integer</em></p>
|
||||
<p>Linearized inversion: Minimum number of iterations</p>
|
||||
</dd></dl>
|
||||
|
||||
<dl class="std confval">
|
||||
<dt class="sig sig-object std" id="confval-iLoc.profile.-name.MaxIterations">
|
||||
<span class="sig-name descname"><span class="pre">iLoc.profile.$name.MaxIterations</span></span><a class="headerlink" href="#confval-iLoc.profile.-name.MaxIterations" 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>integer</em></p>
|
||||
<p>Linearized inversion: Maximum number of iterations</p>
|
||||
</dd></dl>
|
||||
|
||||
<dl class="std confval">
|
||||
<dt class="sig sig-object std" id="confval-iLoc.profile.-name.MinNdefPhases">
|
||||
<span class="sig-name descname"><span class="pre">iLoc.profile.$name.MinNdefPhases</span></span><a class="headerlink" href="#confval-iLoc.profile.-name.MinNdefPhases" title="Permalink to this definition">¶</a></dt>
|
||||
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">4</span></code></p>
|
||||
<p>Type: <em>integer</em></p>
|
||||
<p>Linearized inversion: Minimum number of defining phases</p>
|
||||
</dd></dl>
|
||||
|
||||
<dl class="std confval">
|
||||
<dt class="sig sig-object std" id="confval-iLoc.profile.-name.DoNotRenamePhases">
|
||||
<span class="sig-name descname"><span class="pre">iLoc.profile.$name.DoNotRenamePhases</span></span><a class="headerlink" href="#confval-iLoc.profile.-name.DoNotRenamePhases" 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>Linearized inversion: Do not rename phases. Deactivating
|
||||
allows to rename the phases automatically for this
|
||||
profile.</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="#">iLoc</a><ul>
|
||||
<li><a class="reference internal" href="#description">Description</a><ul>
|
||||
<li><a class="reference internal" href="#background">Background</a></li>
|
||||
<li><a class="reference internal" href="#history">History</a></li>
|
||||
<li><a class="reference internal" href="#iloc-in-a-nutshell">iLoc in a nutshell</a></li>
|
||||
<li><a class="reference internal" href="#algorithms">Algorithms</a><ul>
|
||||
<li><a class="reference internal" href="#neighbourhood-algorithm">Neighbourhood algorithm</a></li>
|
||||
<li><a class="reference internal" href="#depth-resolution">Depth resolution</a></li>
|
||||
<li><a class="reference internal" href="#linearized-inversion">Linearized inversion</a></li>
|
||||
</ul>
|
||||
</li>
|
||||
<li><a class="reference internal" href="#integration-into-scname">Integration into <cite>SeisComP</cite></a></li>
|
||||
<li><a class="reference internal" href="#velocity-models">Velocity models</a><ul>
|
||||
<li><a class="reference internal" href="#global-models">Global models</a></li>
|
||||
<li><a class="reference internal" href="#rstt">RSTT</a></li>
|
||||
<li><a class="reference internal" href="#local-velocity-models">Local velocity models</a></li>
|
||||
</ul>
|
||||
</li>
|
||||
<li><a class="reference internal" href="#station-elevation">Station elevation</a></li>
|
||||
<li><a class="reference internal" href="#resources">Resources</a></li>
|
||||
</ul>
|
||||
</li>
|
||||
<li><a class="reference internal" href="#setup-in-scname">Setup in <cite>SeisComP</cite></a></li>
|
||||
<li><a class="reference internal" href="#application-in-scname">Application in <cite>SeisComP</cite></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_mlh.html"
|
||||
title="previous chapter">MLh</a></p>
|
||||
</div>
|
||||
<div>
|
||||
<h4>Next topic</h4>
|
||||
<p class="topless"><a href="global_mn.html"
|
||||
title="next chapter">MN</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_iloc.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.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>
|
||||
Reference in New Issue
Block a user