Files
2025/share/doc/seiscomp/html/apps/global_mlc.html

409 lines
32 KiB
HTML
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" />
<title>MLc &#8212; SeisComP Release documentation</title>
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
<link rel="stylesheet" href="../_static/seiscomp.css" type="text/css" />
<link rel="stylesheet" type="text/css" href="../_static/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="MLv" href="global_mlv.html" />
<link rel="prev" title="ML" href="global_ml.html" />
</head>
<body>
<div class="header">
<div class="container">
<div class="brand">
<img class="logo" src="../_static/brands/seiscomp/text/white.svg"/>
<!-- span class="title">SeisComP Release</span -->
<span class="version">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_mlv.html" title="MLv"
accesskey="N">
next
</a>
</li>
<li class="right">
<a href="global_ml.html" title="ML"
accesskey="P">
previous
</a>
</li>
<li class="nav-item nav-item-0">
<a href="../index.html">Home</a>
</li>
<li class="nav-item nav-item-1">
<a href="../toc/extensions.html" >Extensions</a>
</li>
<li class="nav-item nav-item-2">
<a href="../toc/extensions/global.html" accesskey="U">global</a>
</li>
</ul>
</div>
</div>
</div>
</div>
<div class="container">
<div class="fitted content" id="anchors-container">
<div class="body" role="main">
<section id="mlc">
<span id="global-mlc"></span><h1>MLc<a class="headerlink" href="#mlc" title="Permalink to this heading"></a></h1>
<p>Custom magnitude for local events measured on horizontal components</p>
<section id="description">
<h2>Description<a class="headerlink" href="#description" title="Permalink to this heading"></a></h2>
<p>MLc is a custom magnitude for local events based on <a class="reference internal" href="global_ml.html#global-ml"><span class="std std-ref">ML</span></a> but
with greater flexibility.
The original implementation is based on specifications by the Hessian Agency for
Nature Conservation, Environment and Geology, Hessian Earthquake Service.
More options have been added allowing the magnitude to be configured with
great flexibility in order to account for many different conditions. The
general procedures for measuring amplitudes and computing magnitudes are
outlined in the <a class="reference internal" href="../base/concepts/magnitudes.html#concepts-magnitudes"><span class="std std-ref">“Concepts” section on magnitudes</span></a>.</p>
<p>The MLc magnitude is very similar to the original <a class="reference internal" href="global_ml.html#global-ml"><span class="std std-ref">ML</span></a>,
except that</p>
<ul class="simple">
<li><p>Amplitude pre-filtering is applied by default.</p></li>
<li><p>Wood-Anderson simulation is optionally applied and can be deactivated.</p></li>
<li><p>Measured amplitudes can be scaled accounting for expected units.</p></li>
<li><p>Measured amplitudes are combined by taking the maximum instead of the average.</p></li>
<li><p>A parametric <a class="reference internal" href="#mlc-station-magnitude"><span class="std std-ref">magnitude calibration</span></a> function
applies but a correction in the form log10(A0) can be configured for converting
measured amplitudes to station magnitudes.</p></li>
<li><p>Hypocentral instead of epicentral distance is considered by default.</p></li>
</ul>
<section id="amplitudes">
<h3>Amplitudes<a class="headerlink" href="#amplitudes" title="Permalink to this heading"></a></h3>
<p>Some general conditions apply for measuring amplitudes:</p>
<ul class="simple">
<li><p>Measured amplitude type: MLc.</p></li>
<li><p>Expected unit of gain-corrected input data: m/s. Activate response correction
in global bindings in case data are provided in acceleration.</p></li>
<li><p>Components used for amplitude measurements: both horizontal components
separately.</p></li>
</ul>
<p>The default parameters for measuring MLc amplitudes can be adjusted by global
binding parameters:</p>
<ul class="simple">
<li><p>Filtering before instrument simulation: <a class="reference internal" href="../base/filter-grammar.html#filter-bw"><span class="std std-ref">BW(3,0.5,12)</span></a>,
configurable by <a class="reference internal" href="global.html#confval-amplitudes.MLc.preFilter"><code class="xref std std-confval docutils literal notranslate"><span class="pre">amplitudes.MLc.preFilter</span></code></a>.</p></li>
<li><p><a class="reference internal" href="../base/glossary.html#term-Wood-Anderson-seismometer"><span class="xref std std-term">Wood-Anderson seismometer</span></a> simulation: yes, can be deactivated by
<a class="reference internal" href="global.html#confval-amplitudes.MLc.applyWoodAnderson"><code class="xref std std-confval docutils literal notranslate"><span class="pre">amplitudes.MLc.applyWoodAnderson</span></code></a>.</p></li>
<li><p>Characteristics of <a class="reference internal" href="../base/glossary.html#term-Wood-Anderson-seismometer"><span class="xref std std-term">Wood-Anderson seismometer</span></a>: according to IASPEI
recommendations. Can be adjusted by <a class="reference internal" href="global.html#confval-2"><code class="xref std std-confval docutils literal notranslate"><span class="pre">amplitudes.WoodAnderson.gain</span></code></a>,
<a class="reference internal" href="global.html#confval-3"><code class="xref std std-confval docutils literal notranslate"><span class="pre">amplitudes.WoodAnderson.T0</span></code></a>, <a class="reference internal" href="global.html#confval-4"><code class="xref std std-confval docutils literal notranslate"><span class="pre">amplitudes.WoodAnderson.h</span></code></a>
in global bindings or global module configuration.</p></li>
<li><p>Amplitude scaling: 1, configure by <a class="reference internal" href="global.html#confval-amplitudes.MLc.amplitudeScale"><code class="xref std std-confval docutils literal notranslate"><span class="pre">amplitudes.MLc.amplitudeScale</span></code></a>
for considering non-default units by magnitude.</p></li>
<li><p>Method applied for measuring amplitudes: absolute maximum, configurable in
global bindings by <a class="reference internal" href="global.html#confval-amplitudes.MLc.measureType"><code class="xref std std-confval docutils literal notranslate"><span class="pre">amplitudes.MLc.measureType</span></code></a>.</p></li>
<li><p>Method for combining amplitude measurements: <em>max</em> (maximum from both
horizontal components), configurable in global bindings by
<a class="reference internal" href="global.html#confval-amplitudes.MLc.combiner"><code class="xref std std-confval docutils literal notranslate"><span class="pre">amplitudes.MLc.combiner</span></code></a>.</p></li>
</ul>
<p>Some additional parameters require you to create an amplitude-type profile for
global binding parameters. Name the profile like the amplitude name, hence MLc:</p>
<ul class="simple">
<li><p>Time window for measuring signal amplitudes [s]: P pick time + 150 s by
<a class="reference internal" href="scautopick.html#scautopick"><span class="std std-ref">scautopick</span></a> or distance [km]/3 km/s + 30 s,
the relevant parameters are: <code class="xref std std-confval docutils literal notranslate"><span class="pre">amplitudes.MLc.signalBegin</span></code>,
<code class="xref std std-confval docutils literal notranslate"><span class="pre">amplitudes.MLc.signalEnd</span></code>. <a class="reference internal" href="../base/time-grammar.html#time-grammar"><span class="std std-ref">Time grammar</span></a> may be
applied for begin and end times.</p></li>
<li><p>Time window for measuring noise amplitudes [s]: 30 s before the P pick,
the relevant parameters are: <code class="xref std std-confval docutils literal notranslate"><span class="pre">amplitudes.MLc.noiseBegin</span></code>,
<code class="xref std std-confval docutils literal notranslate"><span class="pre">amplitudes.MLc.noiseEnd</span></code>. <a class="reference internal" href="../base/time-grammar.html#time-grammar"><span class="std std-ref">Time grammar</span></a> may be
applied for begin and end times.</p></li>
<li><p>Minimum SNR: 0, configurable by <code class="xref std std-confval docutils literal notranslate"><span class="pre">amplitudes.MLc.minSNR</span></code>.</p></li>
<li><p>Distance range: 0 - 8 deg, configurable by <code class="xref std std-confval docutils literal notranslate"><span class="pre">amplitudes.MLc.minDist</span></code>,
<code class="xref std std-confval docutils literal notranslate"><span class="pre">amplitudes.MLc.maxDist</span></code>, stations at distances beyond 8 deg will be strictly
ignored.</p></li>
<li><p>Depth range: &lt;= 80 km, can be adjusted and extended by
<code class="xref std std-confval docutils literal notranslate"><span class="pre">amplitudes.MLc.minDepth</span></code> and <code class="xref std std-confval docutils literal notranslate"><span class="pre">amplitudes.MLc.maxDepth</span></code>.</p></li>
</ul>
<p>Most parameters controlling the amplitude measurements are configurable in
global bindings or global module configuration.</p>
<p>The Wood-Anderson simulation will convert input velocity data to ground
displacement in mm. The input data may be of a different unit after applying
<a class="reference internal" href="global.html#confval-amplitudes.MLc.preFilter"><code class="xref std std-confval docutils literal notranslate"><span class="pre">amplitudes.MLc.preFilter</span></code></a>, e.g. when integration is applied, and / or
when Wood-Anderson simulation is disabled. Configure
<a class="reference internal" href="global.html#confval-amplitudes.MLc.amplitudeScale"><code class="xref std std-confval docutils literal notranslate"><span class="pre">amplitudes.MLc.amplitudeScale</span></code></a> for converting the unit of the
processed data to the unit expected by the
<a class="reference internal" href="#mlc-station-magnitude"><span class="std std-ref">station magnitude calibration</span></a> for the measured
amplitude.</p>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>For comparing MLc amplitudes with <a class="reference internal" href="global_ml.html#global-ml"><span class="std std-ref">ML amplitudes</span></a> set the
global bindings parameters</p>
<div class="highlight-default notranslate"><div class="highlight"><pre><span></span><span class="n">amplitudes</span><span class="o">.</span><span class="n">MLc</span><span class="o">.</span><span class="n">preFilter</span> <span class="o">=</span> <span class="s2">&quot;&quot;</span>
<span class="n">amplitudes</span><span class="o">.</span><span class="n">MLc</span><span class="o">.</span><span class="n">combiner</span> <span class="o">=</span> <span class="n">average</span>
</pre></div>
</div>
</div>
</section>
<section id="station-magnitudes">
<span id="mlc-station-magnitude"></span><h3>Station magnitudes<a class="headerlink" href="#station-magnitudes" title="Permalink to this heading"></a></h3>
<p>Default properties, most parameters are configurable in global bindings:</p>
<ul class="simple">
<li><p>Distance type: hypocentral, epicentral can be selected by <a class="reference internal" href="global.html#confval-magnitudes.MLc.distMode"><code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.MLc.distMode</span></code></a>.</p></li>
<li><p>Distance range: 0 - 8 deg, configurable by <a class="reference internal" href="global.html#confval-magnitudes.MLc.minDist"><code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.MLc.minDist</span></code></a>,
<a class="reference internal" href="global.html#confval-magnitudes.MLc.maxDist"><code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.MLc.maxDist</span></code></a>, measurements beyond 8 deg will be strictly
ignored.</p></li>
<li><p>Depth range: &lt;= 80 km, can be extended by <a class="reference internal" href="global.html#confval-magnitudes.MLc.maxDepth"><code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.MLc.maxDepth</span></code></a>.</p></li>
<li><p>Expected amplitude type: MLc, configurable by magnitude alias.</p></li>
<li><p>Expected amplitude unit: millimeter (mm), other units can be assumed by
amplitude scaling with <a class="reference internal" href="global.html#confval-amplitudes.MLc.amplitudeScale"><code class="xref std std-confval docutils literal notranslate"><span class="pre">amplitudes.MLc.amplitudeScale</span></code></a>.</p></li>
<li><p>Magnitude calibration type: parametric, parametric and non-parametric are
available through <a class="reference internal" href="global.html#confval-magnitudes.MLc.calibrationType"><code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.MLc.calibrationType</span></code></a>.</p></li>
<li><p>Calibration function (see below for the equations), configurable by global bindings
depending on the actual calibration type:</p>
<ul>
<li><p>parametric: <a class="reference internal" href="global.html#confval-magnitudes.MLc.parametric.c0"><code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.MLc.parametric.c0</span></code></a>,
<a class="reference internal" href="global.html#confval-magnitudes.MLc.parametric.c1"><code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.MLc.parametric.c1</span></code></a>,
<a class="reference internal" href="global.html#confval-magnitudes.MLc.parametric.c2"><code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.MLc.parametric.c2</span></code></a>,
<a class="reference internal" href="global.html#confval-magnitudes.MLc.parametric.c3"><code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.MLc.parametric.c3</span></code></a>,
<a class="reference internal" href="global.html#confval-magnitudes.MLc.parametric.c4"><code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.MLc.parametric.c4</span></code></a>,
<a class="reference internal" href="global.html#confval-magnitudes.MLc.parametric.c5"><code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.MLc.parametric.c5</span></code></a></p></li>
<li><p>A0: <a class="reference internal" href="global.html#confval-magnitudes.MLc.A0.logA0"><code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.MLc.A0.logA0</span></code></a></p></li>
</ul>
</li>
<li><p>Station correction: none, configurable by a magnitude-type profile in global
bindings with <code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.MLc.offset</span></code> or the equivalent in global
module configuration as <code class="xref std std-confval docutils literal notranslate"><span class="pre">module.trunk.NET.STA.magnitudes.MLc.offset</span></code>.
The latter is not supported by <a class="reference internal" href="scconfig.html#scconfig"><span class="std std-ref">scconfig</span></a> but it reduces the amount of
required bindings.</p></li>
</ul>
<p>The calibration function is considered in one of the forms</p>
<ul>
<li><p>parametric when <a class="reference internal" href="global.html#confval-magnitudes.MLc.calibrationType"><code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.MLc.calibrationType</span></code></a> = “parametric”<a href="#id1"><span class="problematic" id="id2">`</span></a>:</p>
<div class="math">
<p><img src="../_images/math/bfdf8455f23a75bf18652720e491939a20ac8fa6.png" alt="MLc = \log_{10}(A) + c_3 * \log_{10}(r/c_5) + c_2 * (r + c_4) + c_1 + c_0(station)"/></p>
</div><p>where</p>
<ul class="simple">
<li><p><em>A</em>: displacement amplitude measured in unit of mm or as per configuration</p></li>
<li><p><em>r</em>: hypocentral (default) or epicentral distance</p></li>
<li><p><em>c1</em>, <em>c2</em>, <em>c3</em>, <em>c4</em>, <em>c5</em>: general calibration parameters</p></li>
<li><p><em>c0</em>: station-specific correction</p></li>
<li><p><em>r</em>: Hypocentral (default) or epicentral distance as configured by
<a class="reference internal" href="global.html#confval-magnitudes.MLc.distMode"><code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.MLc.distMode</span></code></a>.</p></li>
</ul>
<p>The default values are valid for SW-Germany (<span id="id3">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>), c6 and H
have been added for supporting dependency on depth (<span id="id4">Rhoades <em>et al.</em> [<a class="reference internal" href="../base/references.html#id72" title="D.A. Rhoades, A. Christophersen, S. Bourguignon, J. Ristau, and J. Salichon. A DepthDependent Local Magnitude Scale for New Zealand Earthquakes Consistent with Moment Magnitude. Bull. Seismol. Soc. Am., 111(2):10561066, 2020. doi:10.1785/0120200252.">56</a>]</span>).</p>
</li>
<li><p>log10(A0)-based non-parametric when <a class="reference internal" href="global.html#confval-magnitudes.MLc.calibrationType"><code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.MLc.calibrationType</span></code></a> = “A0”<a href="#id5"><span class="problematic" id="id6">`</span></a>:</p>
<div class="math">
<p><img src="../_images/math/ccab4425809584f06dd1ddcaf88fa0b15cb94841.png" alt="MLc = \log_{10}(A) - \log_{10}(A_0)"/></p>
</div><p>where</p>
<ul class="simple">
<li><p><img class="math" src="../_images/math/93675c26b872cb6c8401f3a9d037d0e7383ae06b.png" alt="log_{10}(A_0)"/>: distance-dependent correction value. Read
<a class="reference internal" href="global_mlv.html#global-mlv"><span class="std std-ref">MLv</span></a> for the details.</p></li>
</ul>
</li>
</ul>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>The magnitude calibration function can be regionalized by adjusting global
module configuration parameters in MLc region profiles of
<code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.MLc.region.*</span></code> and in a <em>MLc</em> Magnitude type profile e.g.
in <code class="file docutils literal notranslate"><span class="pre">global.cfg</span></code>.</p>
</div>
<p>The flexibility of the amplitude and magnitude processing allows for MLc to be
applied in various use cases. Examples are given below.</p>
<ul>
<li><p><strong>Default:</strong> Pre-filtered and gain-corrected amplitudes, Wood-Anderson
corrected and measured in mm for Southwestern Germany, <span id="id7">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>
<div class="math">
<p><img src="../_images/math/d949c4542df9586bfdd0006602e3f0b3a56fbc5b.png" alt="MLc = \log_{10}(A) + 1.11 * \log_{10}(r) + 0.00095 * r + 0.69 + c_0"/></p>
</div></li>
<li><p>Wood-Anderson-corrected displacement amplitudes measured in mm for
Southern California, <span id="id8">Hutton and Boore [<a class="reference internal" href="../base/references.html#id39" title="L.K. Hutton and D.M. Boore. The ML scale in southern California. Bull. Seismol. Soc. Am,, 77(6):20742094, 1987. URL: https://resolver.caltech.edu/CaltechAUTHORS:20140905-113510505.">45</a>]</span>:</p>
<div class="math">
<p><img src="../_images/math/fe3a90edfdebbbcc8730ea60fd0048e251cda93c.png" alt="MLc = \log_{10}(A) + 1.110 * \log_{10}(r / 100) + 0.00189 * (r - 100) + 3.0"/></p>
</div></li>
<li><p>Pre-filtered velocity amplitudes in units of mym/s (requiring to set
<a class="reference internal" href="global.html#confval-amplitudes.MLc.amplitudeScale"><code class="xref std std-confval docutils literal notranslate"><span class="pre">amplitudes.MLc.amplitudeScale</span></code></a>), no Wood-Anderson correction,
for West Bohemia, e.g. <span id="id9">Hiemer and Roessler [<a class="reference internal" href="../base/references.html#id38" title="S. Hiemer and D. Roessler. Monitoring the West Bohemian earthquake swarm in 2008/2009 by a temporary small-aperture seismic array. J. Seismol., 16:169-182, 2012. doi:10.1007/s10950-011-9256-5.">44</a>]</span>:</p>
<div class="math">
<p><img src="../_images/math/b21da4311b2f4882dbbadbcb617d04c5e5e35e7b.png" alt="MLc = \log_{10}(A) - log_{10}(2\Pi) + 2.1 * \log_{10}(r) - 1.7 + c_0"/></p>
</div></li>
</ul>
<figure class="align-center" id="id13">
<a class="reference internal image-reference" href="../_images/magnitude-calibrations_MLc_s_MLc_hb.png"><img alt="../_images/magnitude-calibrations_MLc_s_MLc_hb.png" src="../_images/magnitude-calibrations_MLc_s_MLc_hb.png" style="width: 18cm;" /></a>
<figcaption>
<p><span class="caption-text">MLc magnitudes for measured amplitude of 1 mm with default magnitude
calibration (<em>MLc_s</em>, <span id="id10">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>) and calibration values for Southern
California (<em>MLc_hb</em>, <span id="id11">Hutton and Boore [<a class="reference internal" href="../base/references.html#id39" title="L.K. Hutton and D.M. Boore. The ML scale in southern California. Bull. Seismol. Soc. Am,, 77(6):20742094, 1987. URL: https://resolver.caltech.edu/CaltechAUTHORS:20140905-113510505.">45</a>]</span>).</span><a class="headerlink" href="#id13" title="Permalink to this image"></a></p>
</figcaption>
</figure>
</section>
<section id="network-magnitude">
<h3>Network magnitude<a class="headerlink" href="#network-magnitude" title="Permalink to this heading"></a></h3>
<p>The network magnitude is computed from station magnitudes automatically by
<a class="reference internal" href="scmag.html#scmag"><span class="std std-ref">scmag</span></a> or interactively by <a class="reference internal" href="scolv.html#scolv"><span class="std std-ref">scolv</span></a>.
Originally the median was computed from all station MLc to form the
<a class="reference internal" href="../base/glossary.html#term-network-magnitude"><span class="xref std std-term">network magnitude</span></a> MLc. Here, the trimmed mean is applied. Outliers
beyond the outer 12.5% percentiles are removed before forming the mean. The
method can be adjusted in <a class="reference internal" href="scmag.html#scmag"><span class="std std-ref">scmag</span></a> by <a class="reference internal" href="scmag.html#confval-magnitudes.average"><code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.average</span></code></a>.</p>
</section>
<section id="moment-magnitude">
<h3>Moment magnitude<a class="headerlink" href="#moment-magnitude" title="Permalink to this heading"></a></h3>
<p>MLc can be scaled to a moment magnitude, Mw(MLc), by a magnitude-type profile in
global module configuration. Read the
<a class="reference internal" href="../base/tutorials/magnitude-regionalization.html#tutorials-mags-moment"><span class="std std-ref">Tutorial on moment magnitudes</span></a> for the details.</p>
</section>
<section id="magnitude-aliases">
<h3>Magnitude aliases<a class="headerlink" href="#magnitude-aliases" title="Permalink to this heading"></a></h3>
<p>Magnitude aliases can be created by <a class="reference internal" href="global.html#confval-magnitudes.aliases"><code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.aliases</span></code></a> in
global module configuration in order to derive other magnitude types from
original amplitudes and magnitudes. The actual amplitude and magnitude
parameters of the aliases will be configured in global bindings or by
magnitude-type profiles in global module configuration. Read the
<a class="reference internal" href="../base/tutorials/magnitude-regionalization.html#tutorials-magnitude-aliases"><span class="std std-ref">Tutorial on magnitude aliases</span></a> for the
details.</p>
</section>
<section id="regionalization">
<h3>Regionalization<a class="headerlink" href="#regionalization" title="Permalink to this heading"></a></h3>
<p>Regionalization may be achieved by a magnitude-type profile in global module
configuration. Read the
<a class="reference internal" href="../base/tutorials/magnitude-regionalization.html#tutorials-magnitude-region"><span class="std std-ref">Tutorial on regionalization</span></a> for the details.</p>
</section>
</section>
<section id="setup">
<h2>Setup<a class="headerlink" href="#setup" title="Permalink to this heading"></a></h2>
<ol class="arabic">
<li><p><strong>Set the configuration and calibration parameters</strong> in the global bindings
similar
to <a class="reference internal" href="global_ml.html#global-ml"><span class="std std-ref">ML</span></a>. Instead of configuring lots of global bindings profiles
or station bindings one line per parameter can be added to the global module
configuration (<code class="file docutils literal notranslate"><span class="pre">global.cfg</span></code>) which takes the form</p>
<div class="highlight-params notranslate"><div class="highlight"><pre><span></span>module.trunk.NET.STA.amplitudes.MLc.preFilter = value
module.trunk.NET.STA.magnitudes.MLc.parametric.c0 = value
</pre></div>
</div>
</li>
<li><p>Add MLc to the list of default amplitudes and magnitudes if MLc is to be
computed by automatic modules, e.g. of <a class="reference internal" href="scamp.html#scamp"><span class="std std-ref">scamp</span></a>, <a class="reference internal" href="scmag.html#scmag"><span class="std std-ref">scmag</span></a>.</p></li>
<li><p>Configure <a class="reference internal" href="scmag.html#scmag"><span class="std std-ref">scmag</span></a> (<a class="reference internal" href="scmag.html#confval-magnitudes.average"><code class="xref std std-confval docutils literal notranslate"><span class="pre">magnitudes.average</span></code></a> in <code class="file docutils literal notranslate"><span class="pre">scmag.cfg</span></code>)
for choosing the method to form the
network magnitude from station magnitudes, e.g.</p>
<div class="highlight-params notranslate"><div class="highlight"><pre><span></span>magnitudes.average = MLc:median
</pre></div>
</div>
</li>
<li><p>Add MLc to the list of magnitudes preferred by <a class="reference internal" href="scevent.html#scevent"><span class="std std-ref">scevent</span></a>
(<a class="reference internal" href="scevent.html#confval-eventAssociation.magTypes"><code class="xref std std-confval docutils literal notranslate"><span class="pre">eventAssociation.magTypes</span></code></a> in <code class="file docutils literal notranslate"><span class="pre">scevent.cfg</span></code>) in order to let
MLc become the preferred magnitude.</p></li>
<li><p>Set defaults/visibility of MLc in <a class="reference internal" href="../base/glossary.html#term-GUI"><span class="xref std std-term">GUI</span></a> modules, e.g. <a class="reference internal" href="scolv.html#scolv"><span class="std std-ref">scolv</span></a>
or <a class="reference internal" href="scesv.html#scesv"><span class="std std-ref">scesv</span></a>.</p></li>
</ol>
<div class="admonition note">
<p class="admonition-title">Note</p>
<p>All default values for bindings configuration parameters are from
<span id="id12">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>
</div>
</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="#">MLc</a><ul>
<li><a class="reference internal" href="#description">Description</a><ul>
<li><a class="reference internal" href="#amplitudes">Amplitudes</a></li>
<li><a class="reference internal" href="#station-magnitudes">Station magnitudes</a></li>
<li><a class="reference internal" href="#network-magnitude">Network magnitude</a></li>
<li><a class="reference internal" href="#moment-magnitude">Moment magnitude</a></li>
<li><a class="reference internal" href="#magnitude-aliases">Magnitude aliases</a></li>
<li><a class="reference internal" href="#regionalization">Regionalization</a></li>
</ul>
</li>
<li><a class="reference internal" href="#setup">Setup</a></li>
</ul>
</li>
</ul>
</div>
<div>
<h4>Previous topic</h4>
<p class="topless"><a href="global_ml.html"
title="previous chapter">ML</a></p>
</div>
<div>
<h4>Next topic</h4>
<p class="topless"><a href="global_mlv.html"
title="next chapter">MLv</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_mlc.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 &copy; gempa GmbH, GFZ Potsdam.
</div>
</div>
<a class="fade-in" href="https://www.gfz-potsdam.de" target="_blank">
<img class="brand" src="../_static/brands/gfz.svg"/>
</a>
</div>
</div>
</div>
</body>
</html>