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

71
share/doc/seiscomp/html/apps/scmag.html
View File

@@ -4,7 +4,7 @@
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>scmag &#8212; SeisComP Release documentation</title>
<title>scmag &#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>
@@ -104,15 +104,15 @@ Currently the following primary magnitude types are implemented.</p>
<section id="local-distances">
<h3>Local distances<a class="headerlink" href="#local-distances" title="Permalink to this heading"></a></h3>
<dl class="simple">
<dt><a class="reference internal" href="../base/glossary.html#term-magnitude-duration-Md"><span class="xref std std-term">Md</span></a></dt><dd><p>Duration magnitude as described in HYPOINVERSE (<span id="id2">Klein [<a class="reference internal" href="../base/references.html#id47" title="F.W. Klein. User’s guide to HYPOINVERSE-2000, a Fortran program to solve for earthquake locations and magnitudes. US Geological Survey, 2002-171:, 2002. URL: https://www.usgs.gov/node/279394, doi:10.3133/ofr02171.">50</a>]</span>).</p>
<dt><a class="reference internal" href="../base/glossary.html#term-magnitude-duration-Md"><span class="xref std std-term">Md</span></a></dt><dd><p>Duration magnitude as described in HYPOINVERSE (<span id="id2">Klein [<a class="reference internal" href="../base/references.html#id63" title="F.W. Klein. User’s guide to HYPOINVERSE-2000, a Fortran program to solve for earthquake locations and magnitudes. US Geological Survey, 2002-171:, 2002. URL: https://www.usgs.gov/node/279394, doi:10.3133/ofr02171.">58</a>]</span>).</p>
</dd>
<dt><a class="reference internal" href="../base/glossary.html#term-magnitude-JMA-M_JMA"><span class="xref std std-term">Mjma</span></a></dt><dd><p>Mjma is computed on displacement data using body waves of period &lt; 30s.</p>
</dd>
<dt><a class="reference internal" href="../base/glossary.html#term-magnitude-local-ML"><span class="xref std std-term">ML</span></a></dt><dd><p>Local (Richter) magnitude calculated on the horizontal components using a
correction term to fit with the standard ML (<span id="id3">Richter [<a class="reference internal" href="../base/references.html#id62" title="C.F. Richter. An instrumental earthquake magnitude scale. Bull. Seismol. Soc. Am., 1:1 - 32, 1935. URL: https://resolver.caltech.edu/CaltechAUTHORS:20140804-143558638, doi:10.1785/BSSA0250010001.">57</a>]</span>).</p>
correction term to fit with the standard ML (<span id="id3">Richter [<a class="reference internal" href="../base/references.html#id81" title="C.F. Richter. An instrumental earthquake magnitude scale. Bull. Seismol. Soc. Am., 1:1 - 32, 1935. URL: https://resolver.caltech.edu/CaltechAUTHORS:20140804-143558638, doi:10.1785/BSSA0250010001.">66</a>]</span>).</p>
</dd>
<dt><a class="reference internal" href="../base/glossary.html#term-magnitude-local-custom-MLc"><span class="xref std std-term">MLc</span></a></dt><dd><p>Local custom magnitude calculated on the horizontal components according to
Hessian Earthquake Service and <span id="id4">Stange [<a class="reference internal" href="../base/references.html#id78" title="S. Stange. ML determination for local and regional events using a sparse network in Southwestern Germany. J. Seismol., 10:247 – 257, 2006. doi:10.1007/s10950-006-9010-6.">62</a>]</span></p>
Hessian Earthquake Service and <span id="id4">Stange [<a class="reference internal" href="../base/references.html#id100" title="S. Stange. ML determination for local and regional events using a sparse network in Southwestern Germany. J. Seismol., 10:247 – 257, 2006. doi:10.1007/s10950-006-9010-6.">71</a>]</span></p>
</dd>
<dt><a class="reference internal" href="../base/glossary.html#term-magnitude-local-horizontal-MLh"><span class="xref std std-term">MLh</span></a></dt><dd><p>Local magnitude calculated on the horizontal components according to SED
specifications.</p>
@@ -121,9 +121,9 @@ specifications.</p>
to fit with the standard ML.</p>
</dd>
<dt><a class="reference internal" href="../base/glossary.html#term-magnitude-local-GNS-GEONET-MLr"><span class="xref std std-term">MLr</span></a></dt><dd><p>Local magnitude calculated from MLv amplitudes based on GNS/GEONET specifications
for New Zealand (<span id="id5">Ristau <em>et al.</em> [<a class="reference internal" href="../base/references.html#id64" title="J. Ristau, D. Harte, and J. Salichon. A Revised Local Magnitude (ML) Scale for New Zealand Earthquakes. Bull. Seismol. Soc. Am., 106(2):, 2016. doi:10.1785/0120150293.">58</a>]</span>).</p>
for New Zealand (<span id="id5">Ristau <em>et al.</em> [<a class="reference internal" href="../base/references.html#id85" title="J. Ristau, D. Harte, and J. Salichon. A Revised Local Magnitude (ML) Scale for New Zealand Earthquakes. Bull. Seismol. Soc. Am., 106(2):, 2016. doi:10.1785/0120150293.">67</a>]</span>).</p>
</dd>
<dt><a class="reference internal" href="../base/glossary.html#term-magnitude-Nuttli-MN"><span class="xref std std-term">MN</span></a></dt><dd><p>Nuttli magnitude for Canada and other Cratonic regions (<span id="id6">Nuttli [<a class="reference internal" href="../base/references.html#id58" title="O.W. Nuttli. Seismic wave attenuation and magnitude relations for eastern north america. J. Geophys. Res., 5:876 - 885, 1973. doi:10.1029/JB078i005p00876.">53</a>]</span>).</p>
<dt><a class="reference internal" href="../base/glossary.html#term-magnitude-Nuttli-MN"><span class="xref std std-term">MN</span></a></dt><dd><p>Nuttli magnitude for Canada and other Cratonic regions (<span id="id6">Nuttli [<a class="reference internal" href="../base/references.html#id76" title="O.W. Nuttli. Seismic wave attenuation and magnitude relations for eastern north america. J. Geophys. Res., 5:876 - 885, 1973. doi:10.1029/JB078i005p00876.">62</a>]</span>).</p>
</dd>
</dl>
</section>
@@ -134,9 +134,9 @@ for New Zealand (<span id="id5">Ristau <em>et al.</em> [<a class="reference inte
</dd>
<dt><a class="reference internal" href="../base/glossary.html#term-magnitude-cumulative-body-wave-mBc"><span class="xref std std-term">mBc</span></a></dt><dd><p>Cumulative body wave magnitude</p>
</dd>
<dt><a class="reference internal" href="../base/glossary.html#term-magnitude-broadband-body-wave-mB"><span class="xref std std-term">mB</span></a></dt><dd><p>Broad band body wave magnitude after <span id="id7">Bormann and Saul [<a class="reference internal" href="../base/references.html#id18" title="P. Bormann and J. Saul. The new iaspei standard broadband magnitude mb. Seismol. Res. Lett., 5:698 - 705, 2008. doi:10.1785/gssrl.79.5.698.">38</a>]</span></p>
<dt><a class="reference internal" href="../base/glossary.html#term-magnitude-broadband-body-wave-mB"><span class="xref std std-term">mB</span></a></dt><dd><p>Broad band body wave magnitude after <span id="id7">Bormann and Saul [<a class="reference internal" href="../base/references.html#id28" title="P. Bormann and J. Saul. The new iaspei standard broadband magnitude mb. Seismol. Res. Lett., 5:698 - 705, 2008. doi:10.1785/gssrl.79.5.698.">46</a>]</span></p>
</dd>
<dt><a class="reference internal" href="../base/glossary.html#term-magnitude-broadband-P-wave-moment-Mwp"><span class="xref std std-term">Mwp</span></a></dt><dd><p>The body wave magnitude of <span id="id8">Tsuboi <em>et al.</em> [<a class="reference internal" href="../base/references.html#id79" title="S. Tsuboi, K. Abe, K. Takano, and Y. Yamanaka. Rapid determination of Mw from broadband P waveforms. Bull. Seismol. Soc. Am., 1995. doi:10.1785/BSSA0850020606.">63</a>]</span></p>
<dt><a class="reference internal" href="../base/glossary.html#term-magnitude-broadband-P-wave-moment-Mwp"><span class="xref std std-term">Mwp</span></a></dt><dd><p>The body wave magnitude of <span id="id8">Tsuboi <em>et al.</em> [<a class="reference internal" href="../base/references.html#id101" title="S. Tsuboi, K. Abe, K. Takano, and Y. Yamanaka. Rapid determination of Mw from broadband P waveforms. Bull. Seismol. Soc. Am., 1995. doi:10.1785/BSSA0850020606.">72</a>]</span></p>
</dd>
<dt><a class="reference internal" href="../base/glossary.html#term-magnitude-surface-wave-Ms_20"><span class="xref std std-term">Ms_20</span></a></dt><dd><p>Surface-wave magnitude at 20 s period</p>
</dd>
@@ -149,10 +149,10 @@ for New Zealand (<span id="id5">Ristau <em>et al.</em> [<a class="reference inte
<p>Additionally, scmag derives the following magnitudes from primary magnitudes:</p>
<dl>
<dt><a class="reference internal" href="../base/glossary.html#term-magnitude-derived-mB-Mw-mB"><span class="xref std std-term">Mw(mB)</span></a></dt><dd><p>Estimation of the moment magnitude Mw based on mB using the Mw vs. mB
regression of <span id="id9">Bormann and Saul [<a class="reference internal" href="../base/references.html#id18" title="P. Bormann and J. Saul. The new iaspei standard broadband magnitude mb. Seismol. Res. Lett., 5:698 - 705, 2008. doi:10.1785/gssrl.79.5.698.">38</a>]</span></p>
regression of <span id="id9">Bormann and Saul [<a class="reference internal" href="../base/references.html#id28" title="P. Bormann and J. Saul. The new iaspei standard broadband magnitude mb. Seismol. Res. Lett., 5:698 - 705, 2008. doi:10.1785/gssrl.79.5.698.">46</a>]</span></p>
</dd>
<dt><a class="reference internal" href="../base/glossary.html#term-magnitude-derived-Mwp-Mw-Mwp"><span class="xref std std-term">Mw(Mwp)</span></a></dt><dd><p>Estimation of the moment magnitude Mw based on Mwp using the Mw vs. Mwp
regression of <span id="id10">Whitmore <em>et al.</em> [<a class="reference internal" href="../base/references.html#id85" title="P.M. Whitmore, S. Tsuboi, B. Hirshorn, and T.J. Sokolowski. Magnitude dependent correction for Mwp. Science of Tsunami Hazards, 20(4):, 2002.">65</a>]</span></p>
regression of <span id="id10">Whitmore <em>et al.</em> [<a class="reference internal" href="../base/references.html#id108" title="P.M. Whitmore, S. Tsuboi, B. Hirshorn, and T.J. Sokolowski. Magnitude dependent correction for Mwp. Science of Tsunami Hazards, 20(4):, 2002.">74</a>]</span></p>
</dd>
<dt><a class="reference internal" href="../base/glossary.html#term-magnitude-summary-M"><span class="xref std std-term">M</span></a></dt><dd><p>Summary magnitude, which consists of a weighted average of the individual
magnitudes and attempts to be a best possible compromise between all magnitudes.
@@ -257,7 +257,7 @@ This magnitude is typically called <strong>M</strong> as configured in
<a class="reference internal" href="#confval-summaryMagnitude.type"><code class="xref std std-confval docutils literal notranslate"><span class="pre">summaryMagnitude.type</span></code></a>.</p>
<p>It is computed as a weighted average over the available magnitudes:</p>
<div class="math">
<p><img src="../_images/math/9af9964f1e826eea97592ba3eb00a1c8b0e42b05.png" alt="M &amp;= \frac{\sum w_{i} * M_{i}}{\sum w_i} \\
<p><img src="../_images/math/9af9964f1e826eea97592ba3eb00a1c8b0e42b05.svg" alt="M &amp;= \frac{\sum w_{i} * M_{i}}{\sum w_i} \\
w_{i} &amp;= a_i * stationCount(M_{i}) + b_i"/></p>
</div><p>The coefficients a and b can be configured per magnitude type by
<a class="reference internal" href="#confval-summaryMagnitude.coefficients.a"><code class="xref std std-confval docutils literal notranslate"><span class="pre">summaryMagnitude.coefficients.a</span></code></a>
@@ -319,15 +319,15 @@ to be used for calculating a magnitude.</p>
<span class="sig-name descname"><span class="pre">magnitudes.average</span></span><a class="headerlink" href="#confval-magnitudes.average" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">default</span></code></p>
<p>Type: <em>list:string</em></p>
<p>The methods for computing the network magnitude
from station magnitudes. Exactly one method per
magnitude can be configured.
To define the averaging method per magnitude type append
the type after colon, e.g.:
&quot;magnitudes.average = default, MLv:median&quot;</p>
<p>default: Compute the mean if less than 4 contributed
station magnitudes exist. Otherwise apply trimmedMean(25),
trimmed mean with 25%.</p>
<p>Values: <code class="docutils literal notranslate"><span class="pre">*default,*mean,*median,*trimmedMean(*),*trimmedMedian(*),*medianTrimmedMean(*)</span></code></p>
<p>The methods for computing the network magnitude from station
magnitudes. Exactly one method per magnitude can be
configured. To define the averaging method per magnitude
type append the type after colon. Example:</p>
<p>&quot;magnitudes.average = default, MLv:median&quot;</p>
<p>default: Compute the mean if less than 4 contributed station
magnitudes exist. Otherwise apply trimmedMean(25), trimmed
mean with 25%.</p>
</dd></dl>
<dl class="std confval">
@@ -415,7 +415,7 @@ magnitude calculation.</p>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-summaryMagnitude.coefficients.a">
<span class="sig-name descname"><span class="pre">summaryMagnitude.coefficients.a</span></span><a class="headerlink" href="#confval-summaryMagnitude.coefficients.a" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">0,</span> <span class="pre">Mw(mB):0.4,</span> <span class="pre">Mw(Mwp):0.4</span></code></p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">0,Mw(mB):0.4,Mw(Mwp):0.4</span></code></p>
<p>Type: <em>list:string</em></p>
<p>Define the coefficients a. To define the value per magnitude
type append the type after colon. A value without a
@@ -425,7 +425,7 @@ type defines the default value.</p>
<dl class="std confval">
<dt class="sig sig-object std" id="confval-summaryMagnitude.coefficients.b">
<span class="sig-name descname"><span class="pre">summaryMagnitude.coefficients.b</span></span><a class="headerlink" href="#confval-summaryMagnitude.coefficients.b" title="Permalink to this definition"></a></dt>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">1,</span> <span class="pre">MLv:2,</span> <span class="pre">Mw(mB):-1,</span> <span class="pre">Mw(Mwp):-1</span></code></p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">1,MLv:2,</span> <span class="pre">Mw(mB):-1,Mw(Mwp):-1</span></code></p>
<p>Type: <em>list:string</em></p>
<p>Define the coefficients b. To define the value per magnitude
type append the type after colon. A value without a
@@ -604,12 +604,14 @@ This option can be given more than once.</p>
<dt class="sig sig-object std" id="cmdoption-scmag-content-type">
<span class="sig-name descname"><span class="pre">--content-type</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scmag-content-type" title="Permalink to this definition"></a></dt>
<dd><p>Overrides configuration parameter <a class="reference internal" href="global.html#confval-connection.contentType"><code class="xref std std-confval docutils literal notranslate"><span class="pre">connection.contentType</span></code></a>.</p>
<p>Default: <code class="docutils literal notranslate"><span class="pre">binary</span></code></p>
</dd></dl>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scmag-start-stop-msg">
<span class="sig-name descname"><span class="pre">--start-stop-msg</span></span><span class="sig-prename descclassname"> <span class="pre">arg</span></span><a class="headerlink" href="#cmdoption-scmag-start-stop-msg" title="Permalink to this definition"></a></dt>
<dd><p>Set sending of a start and a stop message.</p>
<dd><p>Default: <code class="docutils literal notranslate"><span class="pre">0</span></code></p>
<p>Set sending of a start and a stop message.</p>
</dd></dl>
</section>
@@ -655,7 +657,9 @@ can be queried with &quot;--db-driver-list&quot;.</p>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scmag-ep">
<span class="sig-name descname"><span class="pre">--ep</span></span><span class="sig-prename descclassname"> <span class="pre">file</span></span><a class="headerlink" href="#cmdoption-scmag-ep" title="Permalink to this definition"></a></dt>
<dd><p>Defines an event parameters XML file to be read and processed. This
<dd><p>Type: <em>string</em></p>
<p>Defines an event parameters XML file to be read and
processed. Use ‘-’ to read from stdin. This
implies offline mode and only processes all origins contained
in that file. It computes station magnitudes for all picks associated
with an origin where amplitudes are available and the corresponding
@@ -699,6 +703,16 @@ network magnitude.</p>
<dd><p>Keep the original weights in combination with --static.</p>
</dd></dl>
</section>
<section id="output">
<h3>Output<a class="headerlink" href="#output" title="Permalink to this heading"></a></h3>
<dl class="std option">
<dt class="sig sig-object std" id="cmdoption-scmag-f">
<span id="cmdoption-scmag-formatted"></span><span class="sig-name descname"><span class="pre">-f</span></span><span class="sig-prename descclassname"></span><span class="sig-prename descclassname"><span class="pre">,</span> </span><span class="sig-name descname"><span class="pre">--formatted</span></span><span class="sig-prename descclassname"></span><a class="headerlink" href="#cmdoption-scmag-f" title="Permalink to this definition"></a></dt>
<dd><p>Use formatted XML output along with ‘--ep’. Otherwise XML
is unformatted.</p>
</dd></dl>
</section>
</section>
</section>
@@ -747,6 +761,7 @@ network magnitude.</p>
<li><a class="reference internal" href="#database">Database</a></li>
<li><a class="reference internal" href="#input">Input</a></li>
<li><a class="reference internal" href="#reprocess">Reprocess</a></li>
<li><a class="reference internal" href="#output">Output</a></li>
</ul>
</li>
</ul>
@@ -783,7 +798,7 @@ network magnitude.</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.