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

[installation] Change to nightly

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

130
share/doc/seiscomp/html/apps/global_fixedhypocenter.html
View File

@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>FixedHypocenter &#8212; SeisComP Release documentation</title>
<title>FixedHypocenter &#8212; SeisComP Development documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=72bcf2f2" />
@ -12,7 +12,7 @@
<link rel="stylesheet" type="text/css" href="../_static/graphviz.css?v=eafc0fe6" />
<script type="text/javascript" src="../_static/seiscomp.js"></script>
<script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=823bb831"></script>
<script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=744d344a"></script>
<script src="../_static/doctools.js?v=888ff710"></script>
<script src="../_static/sphinx_highlight.js?v=4825356b"></script>
<link rel="index" title="Index" href="../genindex.html" />
@ -25,8 +25,8 @@
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">6.9.0</span>
<!-- span class="title">SeisComP Development</span -->
<span class="version">7.0.0</span>
</div>
</div>
</div>
@ -77,7 +77,7 @@
<p>Locator for re-computing source time with fixed hypocenter</p>
<section id="description">
<h2>Description<a class="headerlink" href="#description" title="Permalink to this heading"></a></h2>
<p>Mining-related events are useful as ground truth events (<span id="id1">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>)
<p>Mining-related events are useful as ground truth events (<span id="id1">Bondár and McLaughlin [<a class="reference internal" href="../base/references.html#id19" 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.">42</a>]</span>)
because the epicentre and depth can be constrained by physical inspection.
Unless a local seismograph network with accurate timing also locates the event,
and that information is available, the origin time must be estimated in order
@ -93,29 +93,29 @@ origin time determination.</p>
the practise of the Comprehensive Test Ban Treaty Organization (CTBTO).</p></li>
<li><p>Adaptation of a procedure which is compatible with the other locators supported by <cite>SeisComP</cite>.</p></li>
<li><p>Adaptation of a procedure which can reproduce results of legacy locators currently
in use, such as GENLOC <span id="id2">Pavlis <em>et al.</em> [<a class="reference internal" href="../base/references.html#id60" title="G.L. Pavlis, F. Vernon, D. Harvey, and D. Quinlan. 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.">55</a>]</span> and GRL, a
in use, such as GENLOC <span id="id2">Pavlis <em>et al.</em> [<a class="reference internal" href="../base/references.html#id78" title="G.L. Pavlis, F. Vernon, D. Harvey, and D. Quinlan. 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.">64</a>]</span> and GRL, a
grid-based locator developed at the Canadian Hazards Information Service (CHIS).</p></li>
</ul>
<p>The implementation of this locator by <a class="reference internal" href="../base/glossary.html#term-gempa-GmbH"><span class="xref std std-term">gempa GmbH</span></a> was initiated and has received
initial funding from <span id="id3"><em>Natural Resources Canada (NRCAN), Earthquakes Canada</em> [<a class="reference internal" href="../base/references.html#id173" title="Natural Resources Canada (NRCAN), Earthquakes Canada. URL: https://earthquakescanada.nrcan.gc.ca/index-en.php.">17</a>]</span>.</p>
initial funding from <span id="id3"><em>Natural Resources Canada (NRCAN), Earthquakes Canada</em> [<a class="reference internal" href="../base/references.html#id202" title="Natural Resources Canada (NRCAN), Earthquakes Canada. URL: https://earthquakescanada.nrcan.gc.ca/index-en.php.">18</a>]</span>.</p>
</section>
<section id="methodology">
<h2>Methodology<a class="headerlink" href="#methodology" title="Permalink to this heading"></a></h2>
<p>Given the measured arrival times <img class="math" src="../_images/math/ef0cc8a9abcd91d4c81e277fda15f02f61283b8a.png" alt="t_i^k"/> of phase <img class="math" src="../_images/math/9630132210b904754c9ab272b61cb527d12263ca.png" alt="k"/> at
station <img class="math" src="../_images/math/5aa339d4daf45a810dda332e3c80a0698e526e04.png" alt="i"/>, most methods of earthquake hypocentre location involve
<p>Given the measured arrival times <img class="math" src="../_images/math/ef0cc8a9abcd91d4c81e277fda15f02f61283b8a.svg" alt="t_i^k"/> of phase <img class="math" src="../_images/math/9630132210b904754c9ab272b61cb527d12263ca.svg" alt="k"/> at
station <img class="math" src="../_images/math/5aa339d4daf45a810dda332e3c80a0698e526e04.svg" alt="i"/>, most methods of earthquake hypocentre location involve
minimization of the weighted squared sum of the residuals. That is,
minimization of:</p>
<div class="math">
<p><img src="../_images/math/66bfccc625b603ecc69ebbaf5e79849a6f90985a.png" alt="|r_w|^2 = \sum_{i=1}^N {w_i^2 [ t_i^k - \tau - T_{model}^k(r_i,x) ]^2}"/></p>
<p><img src="../_images/math/66bfccc625b603ecc69ebbaf5e79849a6f90985a.svg" alt="|r_w|^2 = \sum_{i=1}^N {w_i^2 [ t_i^k - \tau - T_{model}^k(r_i,x) ]^2}"/></p>
</div><p>The residuals are computed by subtracting the expected arrival times
<img class="math" src="../_images/math/4cd887dff87ad1c4fe54e94c441379b895433dc5.png" alt="\tau - T_{model}^k(r_i,x)"/> based on a velocity model applied at the
<img class="math" src="../_images/math/4cd887dff87ad1c4fe54e94c441379b895433dc5.svg" alt="\tau - T_{model}^k(r_i,x)"/> based on a velocity model applied at the
coordinates of each station
<img class="math" src="../_images/math/dbc4c429b48dd94e41ee866e1edbf0abededae3a.png" alt="r_i"/>.</p>
<img class="math" src="../_images/math/dbc4c429b48dd94e41ee866e1edbf0abededae3a.svg" alt="r_i"/>.</p>
<p>Typically the weights can be a combination of the inverse of the
estimated pick uncertainty <img class="math" src="../_images/math/68d8fad26c73ee49f100be287592043b3d020379.png" alt="1/{\sigma}_i"/>, a distance term
<img class="math" src="../_images/math/1bdf84b56ea19c568b70e6dc45392b954d63a0ea.png" alt="d^k(\Delta)"/> and/or a residual weight term <img class="math" src="../_images/math/cf90d710bc5e654f04f2197992b5658a393a8c93.png" alt="p(r_i)"/>.
estimated pick uncertainty <img class="math" src="../_images/math/68d8fad26c73ee49f100be287592043b3d020379.svg" alt="1/{\sigma}_i"/>, a distance term
<img class="math" src="../_images/math/1bdf84b56ea19c568b70e6dc45392b954d63a0ea.svg" alt="d^k(\Delta)"/> and/or a residual weight term <img class="math" src="../_images/math/cf90d710bc5e654f04f2197992b5658a393a8c93.svg" alt="p(r_i)"/>.
Alternative weighting schemes can be applied but in this
implementation we weight by pick uncertainty alone: <img class="math" src="../_images/math/eb6982d524ed71f7530ce3eb31b4814c1aef31b1.png" alt="w_i=\frac{1}{{\sigma}_i}"/>.</p>
implementation we weight by pick uncertainty alone: <img class="math" src="../_images/math/eb6982d524ed71f7530ce3eb31b4814c1aef31b1.svg" alt="w_i=\frac{1}{{\sigma}_i}"/>.</p>
<p>In the general case, the model is a nonlinear function of its inputs, and there
is no analytic solution for the origin time and hypocenter that minimize the
norm. Typically, the solution is found iteratively, based on an initial guess
@ -125,85 +125,85 @@ When the hypocenter is in fact accurately constrained, the modeled travel time
is a constant, so we can project each phase arrival back to an equivalent origin
time</p>
<div class="math">
<p><img src="../_images/math/e07cf5ca46edb86938c9b742583b78cf5dfd5a2c.png" alt="\tau_i^k = t_i^k - T_{model}^k (r_i,x)"/></p>
<p><img src="../_images/math/e07cf5ca46edb86938c9b742583b78cf5dfd5a2c.svg" alt="\tau_i^k = t_i^k - T_{model}^k (r_i,x)"/></p>
</div><p>so that we only have to find which minimizes:</p>
<div class="math">
<p><img src="../_images/math/ce91df5771b45d3d22d0246721cb9eda678dc1ea.png" alt="|r_w|^2 = \sum_{i=1}^{N}w_i^2 [\tau_i^k - \tau]^2"/></p>
<p><img src="../_images/math/ce91df5771b45d3d22d0246721cb9eda678dc1ea.svg" alt="|r_w|^2 = \sum_{i=1}^{N}w_i^2 [\tau_i^k - \tau]^2"/></p>
</div><p>The residuals are minimized by:</p>
<div class="math">
<p><img src="../_images/math/a3c64e2d4f039151334ad193c4df506d7c5a4d27.png" alt="\tau = \frac{\sum_{i=1}^{N}w_i^2 (\tau_i^k)^2}{\sum_{i=1}^{N}w_i^2}."/></p>
<p><img src="../_images/math/a3c64e2d4f039151334ad193c4df506d7c5a4d27.svg" alt="\tau = \frac{\sum_{i=1}^{N}w_i^2 (\tau_i^k)^2}{\sum_{i=1}^{N}w_i^2}."/></p>
</div><p>Thus, the origin time is simply the weighted mean of the equivalent origin
times, according to the velocity model, associated with the arrivals.</p>
<p>The standard error of this estimate is:</p>
<div class="math">
<p><img src="../_images/math/450e7d546e262c19d94b8fdfc9f5d971d36f7a1b.png" alt="\sigma = \sqrt{\frac{\sum_{i=1}^{N}w_i^2 [\tau_i^k - \tau]^2}{\sum_{i=1}^{N}w_i^2}}."/></p>
<p><img src="../_images/math/450e7d546e262c19d94b8fdfc9f5d971d36f7a1b.svg" alt="\sigma = \sqrt{\frac{\sum_{i=1}^{N}w_i^2 [\tau_i^k - \tau]^2}{\sum_{i=1}^{N}w_i^2}}."/></p>
</div><p>The methodology for estimating error intervals and ellipses recommended for
standard processing at the CTBTO (<span id="id4">Lee and Lahr [<a class="reference internal" href="../base/references.html#id51" title="W.H. Lee and J.C. Lahr. Hypo71 (revised): a computer program for determining local earthquake hypocentral parameters, magnitude, and first motion pattern of local earthquakes. US Geol. Survey Open-file Report 75-311, 1975. URL: https://pubs.er.usgs.gov/publication/ofr75311, doi:10.3133/ofr75311.">51</a>]</span>) is that of
<span id="id5">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> and is implemented
in LOCSAT (<span id="id6">Bratt and Bache [<a class="reference internal" href="../base/references.html#id20" title="S.R. Bratt and T.C. Bache. Locating events with a sparse network of regional arrays. Bull. Seismol. Soc. Am., 78(2):780 - 798, 1988. URL: https://pubs.geoscienceworld.org/ssa/bssa/article-pdf/78/2/780/5334120/bssa0780020780.pdf, doi:10.1785/BSSA0780020780.">41</a>]</span>).
Uncertainty is represented by a set of points <img class="math" src="../_images/math/c24babb8b2b84f2c211a040b48c4e2e04bb74871.png" alt="x_e"/> around the final estimate
<img class="math" src="../_images/math/4d932942be8cf79d3cda089d58de1a45ca6f8597.png" alt="x_f"/> satisfying:</p>
standard processing at the CTBTO (<span id="id4">Lee and Lahr [<a class="reference internal" href="../base/references.html#id69" title="W.H. Lee and J.C. Lahr. Hypo71 (revised): a computer program for determining local earthquake hypocentral parameters, magnitude, and first motion pattern of local earthquakes. US Geol. Survey Open-file Report 75-311, 1975. URL: https://pubs.er.usgs.gov/publication/ofr75311, doi:10.3133/ofr75311.">59</a>]</span>) is that of
<span id="id5">Jordan and Sverdrup [<a class="reference internal" href="../base/references.html#id56" 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.">55</a>]</span> and is implemented
in LOCSAT (<span id="id6">Bratt and Bache [<a class="reference internal" href="../base/references.html#id31" title="S.R. Bratt and T.C. Bache. Locating events with a sparse network of regional arrays. Bull. Seismol. Soc. Am., 78(2):780 - 798, 1988. URL: https://pubs.geoscienceworld.org/ssa/bssa/article-pdf/78/2/780/5334120/bssa0780020780.pdf, doi:10.1785/BSSA0780020780.">49</a>]</span>).
Uncertainty is represented by a set of points <img class="math" src="../_images/math/c24babb8b2b84f2c211a040b48c4e2e04bb74871.svg" alt="x_e"/> around the final estimate
<img class="math" src="../_images/math/4d932942be8cf79d3cda089d58de1a45ca6f8597.svg" alt="x_f"/> satisfying:</p>
<div class="math">
<p><img src="../_images/math/b5359fb7461e8422b3d0ea043241d3902ed8c878.png" alt="\kappa_p^2 &amp;= (x_e - x_f)^TC_m(x_e-x_f), \\
<p><img src="../_images/math/b5359fb7461e8422b3d0ea043241d3902ed8c878.svg" alt="\kappa_p^2 &amp;= (x_e - x_f)^TC_m(x_e-x_f), \\
\kappa_p^2 &amp;= Ms^2F_p(M,K+N-M), \\
s^2 &amp;= \frac{Ks_K^2+|r_w|^2}{K+N-M}"/></p>
</div><p>where:</p>
<ul>
<li><p><img class="math" src="../_images/math/4577806854ed7741af5ad0aa1abe2909567a3083.png" alt="C_m"/>: Covariance matrix, corresponding to the final hypocentre estimate <img class="math" src="../_images/math/4d932942be8cf79d3cda089d58de1a45ca6f8597.png" alt="x_f"/>.</p></li>
<li><p><img class="math" src="../_images/math/8ab4b82ece5a67cb801cf339bca8ff343a570c2e.png" alt="s^2"/>: Ratio of actual to assumed.</p></li>
<li><p><img class="math" src="../_images/math/2255befd84ee2fcea10694752b43e60d80a4f992.png" alt="\kappa_p^2"/>: The “confidence coefficient” at probability <img class="math" src="../_images/math/27dc86f9f1b1c3435b2403a869b5870c582facea.png" alt="\rho"/>.</p></li>
<li><p><img class="math" src="../_images/math/86991529ca92ae0a8532508be15f15400052d4a4.png" alt="F_p(m,n)"/>: Fisher-Snedecor quantile function (inverse cumulative F-distribution)
<li><p><img class="math" src="../_images/math/4577806854ed7741af5ad0aa1abe2909567a3083.svg" alt="C_m"/>: Covariance matrix, corresponding to the final hypocentre estimate <img class="math" src="../_images/math/4d932942be8cf79d3cda089d58de1a45ca6f8597.svg" alt="x_f"/>.</p></li>
<li><p><img class="math" src="../_images/math/8ab4b82ece5a67cb801cf339bca8ff343a570c2e.svg" alt="s^2"/>: Ratio of actual to assumed.</p></li>
<li><p><img class="math" src="../_images/math/2255befd84ee2fcea10694752b43e60d80a4f992.svg" alt="\kappa_p^2"/>: The “confidence coefficient” at probability <img class="math" src="../_images/math/27dc86f9f1b1c3435b2403a869b5870c582facea.svg" alt="\rho"/>.</p></li>
<li><p><img class="math" src="../_images/math/86991529ca92ae0a8532508be15f15400052d4a4.svg" alt="F_p(m,n)"/>: Fisher-Snedecor quantile function (inverse cumulative F-distribution)
for and degrees of freedom of numerator and denominator sum of squares,
respectively, and probability.</p></li>
<li><p><img class="math" src="../_images/math/141bbefb74014fc5e43499901bf78607ae335583.png" alt="p"/>: Confidence level: the desired probability that the true epicentre should
<li><p><img class="math" src="../_images/math/141bbefb74014fc5e43499901bf78607ae335583.svg" alt="p"/>: Confidence level: the desired probability that the true epicentre should
fall within the uncertainty bounds.</p></li>
<li><p><img class="math" src="../_images/math/3bfb3a64189a14b2704f4610827762d5e3145114.png" alt="N"/>: Sum of all arrival time, azimuth or slowness estimates. Here, only
<li><p><img class="math" src="../_images/math/3bfb3a64189a14b2704f4610827762d5e3145114.svg" alt="N"/>: Sum of all arrival time, azimuth or slowness estimates. Here, only
arrival times are considered for inversion.</p></li>
<li><p><img class="math" src="../_images/math/4abba779877abb276b98ccb2b4ba9bf2e41947ab.png" alt="M"/>: Number of fitted parameters:</p>
<li><p><img class="math" src="../_images/math/4abba779877abb276b98ccb2b4ba9bf2e41947ab.svg" alt="M"/>: Number of fitted parameters:</p>
<ul class="simple">
<li><p>3: error ellipsoid</p></li>
<li><p>2: error ellipse</p></li>
<li><p>1: depth or time error bounds.</p></li>
</ul>
<p>Here, <img class="math" src="../_images/math/dabb61ecc4da8df35c00e765a39fd383714b573a.png" alt="M = 1"/> as we only invert for the time.</p>
<p>Here, <img class="math" src="../_images/math/dabb61ecc4da8df35c00e765a39fd383714b573a.svg" alt="M = 1"/> as we only invert for the time.</p>
</li>
<li><p><img class="math" src="../_images/math/8caebcef0e5d5769000618e5116d6051c25bd98e.png" alt="s_K^2"/>: A prior estimate of the ratio of actual to assumed data variances; typically set to 1.</p></li>
<li><p><img class="math" src="../_images/math/52ddc0cde6d632f631533173562fe3ca375b1f32.png" alt="K"/>: Number of degrees of freedom in prior estimate <img class="math" src="../_images/math/8caebcef0e5d5769000618e5116d6051c25bd98e.png" alt="s_K^2"/>.
<img class="math" src="../_images/math/52ddc0cde6d632f631533173562fe3ca375b1f32.png" alt="K"/> can be configured by <a class="reference internal" href="#confval-FixedHypocenter.degreesOfFreedom"><code class="xref std std-confval docutils literal notranslate"><span class="pre">FixedHypocenter.degreesOfFreedom</span></code></a>.</p></li>
<li><p><img class="math" src="../_images/math/4fa53fbce202dca5a7572c6eb0dd0b33bd9e601b.png" alt="r_w"/>: Vector of weighted residuals.</p></li>
<li><p><img class="math" src="../_images/math/8caebcef0e5d5769000618e5116d6051c25bd98e.svg" alt="s_K^2"/>: A prior estimate of the ratio of actual to assumed data variances; typically set to 1.</p></li>
<li><p><img class="math" src="../_images/math/52ddc0cde6d632f631533173562fe3ca375b1f32.svg" alt="K"/>: Number of degrees of freedom in prior estimate <img class="math" src="../_images/math/8caebcef0e5d5769000618e5116d6051c25bd98e.svg" alt="s_K^2"/>.
<img class="math" src="../_images/math/52ddc0cde6d632f631533173562fe3ca375b1f32.svg" alt="K"/> can be configured by <a class="reference internal" href="#confval-FixedHypocenter.degreesOfFreedom"><code class="xref std std-confval docutils literal notranslate"><span class="pre">FixedHypocenter.degreesOfFreedom</span></code></a>.</p></li>
<li><p><img class="math" src="../_images/math/4fa53fbce202dca5a7572c6eb0dd0b33bd9e601b.svg" alt="r_w"/>: Vector of weighted residuals.</p></li>
</ul>
<p>Although this formulation is complex it is useful it because allows the analyst to
balance a priori and a posteriori estimates of the ratio of actual to assumed
data variances.</p>
<p>The covariance matrix in the general case is computed from the weighted sensitivity
matrix <img class="math" src="../_images/math/93b581f18e6ddf1ae1ab7475c44b41837e648994.png" alt="A_w"/>, the row-weighted matrix of partial derivatives of arrival
matrix <img class="math" src="../_images/math/93b581f18e6ddf1ae1ab7475c44b41837e648994.svg" alt="A_w"/>, the row-weighted matrix of partial derivatives of arrival
time with respect to the solution coordinates.</p>
<div class="math">
<p><img src="../_images/math/746b9634c2f299dd2005c85460e58fae6d08a49e.png" alt="C_m = A^T_wA_w"/></p>
<p><img src="../_images/math/746b9634c2f299dd2005c85460e58fae6d08a49e.svg" alt="C_m = A^T_wA_w"/></p>
</div><p>However, when origin time is the only coordinate, the partial derivatives with
respect to origin time are unity, the weighted sensitivity matrix is simply a
row vector of weights, and the time-time covariance
<img class="math" src="../_images/math/95c69b0bc6dae384ad6ff06f0ec8ecaaf23987e4.png" alt="c_{tt}"/> is simply the sum of the squares of these weights.</p>
<img class="math" src="../_images/math/95c69b0bc6dae384ad6ff06f0ec8ecaaf23987e4.svg" alt="c_{tt}"/> is simply the sum of the squares of these weights.</p>
<div class="math">
<p><img src="../_images/math/3a34284a39272ffe88e206a0c9e216e716d08a39.png" alt="c_{tt} = \sum_{i=1}^{N}w_i^2"/></p>
<p><img src="../_images/math/3a34284a39272ffe88e206a0c9e216e716d08a39.svg" alt="c_{tt} = \sum_{i=1}^{N}w_i^2"/></p>
</div><p>It is recommended that fixed-hypocentre origin time confidence intervals be
estimated using the method of <span id="id7">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> for error ellipsoids,
estimated using the method of <span id="id7">Jordan and Sverdrup [<a class="reference internal" href="../base/references.html#id56" 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.">55</a>]</span> for error ellipsoids,
that is, that the time error bounds be represented using</p>
<div class="math">
<p><img src="../_images/math/6d03a1b7af5b2b4b70c5442100e5e890ecc841ae.png" alt="\Delta t_p &amp;= \sqrt{ \frac{\kappa_p^2}{c_{tt}} } \\
<p><img src="../_images/math/6d03a1b7af5b2b4b70c5442100e5e890ecc841ae.svg" alt="\Delta t_p &amp;= \sqrt{ \frac{\kappa_p^2}{c_{tt}} } \\
&amp;= \sqrt{ \frac{F_p(1,K+N-1)}{K+N-1} \frac{Ks_K^2 + \sum_{i=1}^{N}w_i^2 [\tau_i^k-\tau]^2}{\sum_{i=1}^{N}w_i^2}}."/></p>
</div><p>In addition to recording arrival weights and residuals, distances and azimuths,
and other details of origin quality, the details of a ground-truth-level (GT1)
fixed-hypocentre origin time estimate are recorded as:</p>
<ul class="simple">
<li><p>origin.time = <img class="math" src="../_images/math/914b2d4b6659b86d3153d5510839dfb254dfc8a3.png" alt="\tau"/></p></li>
<li><p>origin.time_errors.uncertainty = <img class="math" src="../_images/math/c65793dc2e246814b66c7cdd4e3a1c6dc504bbfc.png" alt="\Delta t_p"/></p></li>
<li><p>origin.time_errors.confidence_level = <img class="math" src="../_images/math/13f30937182d0536a97f9f716e6024b4c3951b86.png" alt="100p"/></p></li>
<li><p>origin.quality.standard_error = <img class="math" src="../_images/math/b52df27bfb0b1e3af0c2c68a7b9da459178c2a7d.png" alt="\sigma"/></p></li>
<li><p>origin.time = <img class="math" src="../_images/math/914b2d4b6659b86d3153d5510839dfb254dfc8a3.svg" alt="\tau"/></p></li>
<li><p>origin.time_errors.uncertainty = <img class="math" src="../_images/math/c65793dc2e246814b66c7cdd4e3a1c6dc504bbfc.svg" alt="\Delta t_p"/></p></li>
<li><p>origin.time_errors.confidence_level = <img class="math" src="../_images/math/13f30937182d0536a97f9f716e6024b4c3951b86.svg" alt="100p"/></p></li>
<li><p>origin.quality.standard_error = <img class="math" src="../_images/math/b52df27bfb0b1e3af0c2c68a7b9da459178c2a7d.svg" alt="\sigma"/></p></li>
<li><p>origin.quality.ground_truth_level = GT1</p></li>
</ul>
<p>For the sake of reproducibility, a comment is added to every new <a class="reference internal" href="../base/glossary.html#term-origin"><span class="xref std std-term">origin</span></a>
reporting <img class="math" src="../_images/math/52ddc0cde6d632f631533173562fe3ca375b1f32.png" alt="K"/>, <img class="math" src="../_images/math/93ad30f90f5091591a2dc0895c6171abda508e06.png" alt="s_K"/> and <img class="math" src="../_images/math/e2e0165baaf165355d3e4661b14d1558d9bde02b.png" alt="\kappa_p"/>.</p>
reporting <img class="math" src="../_images/math/52ddc0cde6d632f631533173562fe3ca375b1f32.svg" alt="K"/>, <img class="math" src="../_images/math/93ad30f90f5091591a2dc0895c6171abda508e06.svg" alt="s_K"/> and <img class="math" src="../_images/math/e2e0165baaf165355d3e4661b14d1558d9bde02b.svg" alt="\kappa_p"/>.</p>
</section>
<section id="application">
<h2>Application<a class="headerlink" href="#application" title="Permalink to this heading"></a></h2>
@ -264,6 +264,38 @@ Other interfaces might be added via plugins. Please check their
documentation for the required interface name.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-FixedHypocenter.lat">
<span class="sig-name descname"><span class="pre">FixedHypocenter.lat</span></span><a class="headerlink" href="#confval-FixedHypocenter.lat" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>double</em></p>
<p>The fixed latitude to use. If not set then this
value is read from the input origin.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-FixedHypocenter.lon">
<span class="sig-name descname"><span class="pre">FixedHypocenter.lon</span></span><a class="headerlink" href="#confval-FixedHypocenter.lon" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>double</em></p>
<p>The fixed longitude to use. If not set then this
value is read from the input origin.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-FixedHypocenter.depth">
<span class="sig-name descname"><span class="pre">FixedHypocenter.depth</span></span><a class="headerlink" href="#confval-FixedHypocenter.depth" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>double</em></p>
<p>The fixed depth to use. If not set then this
value is read from the input origin.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-FixedHypocenter.time">
<span class="sig-name descname"><span class="pre">FixedHypocenter.time</span></span><a class="headerlink" href="#confval-FixedHypocenter.time" title="Permalink to this definition"></a></dt>
<dd><p>Type: <em>string</em></p>
<p>The fixed time to use. If not set then this
value is read from the input origin.</p>
</dd></dl>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-FixedHypocenter.usePickUncertainties">
<span class="sig-name descname"><span class="pre">FixedHypocenter.usePickUncertainties</span></span><a class="headerlink" href="#confval-FixedHypocenter.usePickUncertainties" title="Permalink to this definition"></a></dt>
@ -364,7 +396,7 @@ not going to be used or if they are absent.</p>
</a>
<div class="stretched align-center fitted content">
<div>
Version <b>6.9.0</b> Release
Version <b>7.0.0</b> Development
</div>
<div class="copyright">
Copyright &copy; gempa GmbH, GFZ Potsdam.