[installation] Change to nightly
This commit is contained in:
@ -36,53 +36,54 @@ Amplitudes
|
||||
|
||||
Some general conditions apply for measuring amplitudes:
|
||||
|
||||
* Measured amplitude type: MLc.
|
||||
* Name amplitude type: MLc.
|
||||
* Expected unit of gain-corrected input data: m/s. Activate response correction
|
||||
in global bindings in case data are provided in acceleration.
|
||||
* Components used for amplitude measurements: both horizontal components
|
||||
separately.
|
||||
|
||||
The default parameters for measuring MLc amplitudes can be adjusted by global
|
||||
The parameters for measuring MLc amplitudes can be adjusted by global
|
||||
binding parameters:
|
||||
|
||||
* Filtering before instrument simulation: :ref:`BW(3,0.5,12) <filter-bw>`,
|
||||
configurable by :confval:`amplitudes.MLc.preFilter`.
|
||||
* :term:`Wood-Anderson seismometer` simulation: yes, can be deactivated by
|
||||
:confval:`amplitudes.MLc.applyWoodAnderson`.
|
||||
* Characteristics of :term:`Wood-Anderson seismometer`: according to IASPEI
|
||||
recommendations. Can be adjusted by :confval:`amplitudes.WoodAnderson.gain`,
|
||||
:confval:`amplitudes.WoodAnderson.T0`, :confval:`amplitudes.WoodAnderson.h`
|
||||
in global bindings or global module configuration.
|
||||
* Amplitude scaling: 1, configure by :confval:`amplitudes.MLc.amplitudeScale`
|
||||
for considering non-default units by magnitude.
|
||||
* Method applied for measuring amplitudes: absolute maximum, configurable in
|
||||
global bindings by :confval:`amplitudes.MLc.measureType`.
|
||||
* Method for combining amplitude measurements: *max* (maximum from both
|
||||
horizontal components), configurable in global bindings by
|
||||
:confval:`amplitudes.MLc.combiner`.
|
||||
.. csv-table::
|
||||
:widths: 20 25 15 30
|
||||
:header: Topic, Parameter, Default, Comment
|
||||
:align: left
|
||||
:delim: ;
|
||||
|
||||
:ref:`Filtering <filter-grammar>`; :confval:`amplitudes.MLc.preFilter`; :ref:`BW(3,0.5,12) <filter-bw>`; Applied before instrument simulation
|
||||
:term:`Wood-Anderson simulation <Wood-Anderson seismometer>`; :confval:`amplitudes.MLc.applyWoodAnderson`; true; When WA simulation is inactive, measured amplitudes take the units of the gain of the stream on which they were measured.
|
||||
:term:`Wood-Anderson parameters <Wood-Anderson seismometer>`; :confval:`amplitudes.WoodAnderson.gain`, :confval:`amplitudes.WoodAnderson.T0`, :confval:`amplitudes.WoodAnderson.h`; 2080, 0.8, 0.7; Defaults: see :ref:`IASPEI recommendation <concepts_magnitudes-wa>`.
|
||||
Amplitude scaling; :confval:`amplitudes.MLc.amplitudeScale`; 1; Apply for scaling measured amplitudes to units required by the magnitude
|
||||
Amplitude combination; :confval:`amplitudes.MLc.combiner`;max; Method for combining amplitudes measured on both horizontal components
|
||||
|
||||
Some additional parameters require you to create an amplitude-type profile for
|
||||
global binding parameters. Name the profile like the amplitude name, hence MLc:
|
||||
global binding parameters. Name the profile like the amplitude name, hence MLc
|
||||
replacing '$name' in the parameters below:
|
||||
|
||||
* Time window for measuring signal amplitudes [s]: P pick time + 150 s by
|
||||
:ref:`scautopick` or distance [km]/3 km/s + 30 s,
|
||||
the relevant parameters are: :confval:`amplitudes.MLc.signalBegin`,
|
||||
:confval:`amplitudes.MLc.signalEnd`. :ref:`Time grammar <time-grammar>` may be
|
||||
applied for begin and end times.
|
||||
* Time window for measuring noise amplitudes [s]: 30 s before the P pick,
|
||||
the relevant parameters are: :confval:`amplitudes.MLc.noiseBegin`,
|
||||
:confval:`amplitudes.MLc.noiseEnd`. :ref:`Time grammar <time-grammar>` may be
|
||||
applied for begin and end times.
|
||||
* Minimum SNR: 0, configurable by :confval:`amplitudes.MLc.minSNR`.
|
||||
* Distance range: 0 - 8 deg, configurable by :confval:`amplitudes.MLc.minDist`,
|
||||
:confval:`amplitudes.MLc.maxDist`, stations at distances beyond 8 deg will be strictly
|
||||
ignored.
|
||||
* Depth range: <= 80 km, can be adjusted and extended by
|
||||
:confval:`amplitudes.MLc.minDepth` and :confval:`amplitudes.MLc.maxDepth`.
|
||||
.. csv-table::
|
||||
:widths: 20 25 15 30
|
||||
:header: Topic, Parameter, Default, Comment
|
||||
:align: left
|
||||
:delim: ;
|
||||
|
||||
Most parameters controlling the amplitude measurements are configurable in
|
||||
global bindings or global module configuration.
|
||||
Minimum distance; :confval:`amplitudes.$name.minDist`; 0;
|
||||
Maximum distance; :confval:`amplitudes.$name.maxDist`; 8; Cannot be extended beyond default
|
||||
Minimum source depth; :confval:`amplitudes.$name.minDepth`; 0; Can be negative
|
||||
Maximum source depth; :confval:`amplitudes.$name.maxDepth`; 80; Can be extended beyond default
|
||||
Noise window begin; :confval:`amplitudes.$name.noiseBegin`; -30; (+++)
|
||||
Noise window end; :confval:`amplitudes.$name.noiseEnd`; -5; (+++)
|
||||
Signal window begin; :confval:`amplitudes.$name.signalBegin`; -5; (+++)
|
||||
Signal window end; :confval:`amplitudes.$name.signalEnd`; 150 (+) or distance/3+30 (++); (**+**) When measured by :ref:`scautopick`, (**++**) When measured by :ref:`scamp` or :ref:`scolv` (+++)
|
||||
Minimum :term:`SNR`; :confval:`amplitudes.$name.minSNR`;not applied; Compares the maximum amplitudes measured within the signal and noise windows
|
||||
Period range; NA; NA; Period is not measured. A configuration will prevent any MLc amplitude from being measured
|
||||
Amplitude saturation; :confval:`amplitudes.$name.saturationThreshold`; false; Apply for avoiding measurements on clipped data
|
||||
Response correction; :confval:`amplitudes.$name.enableResponses`; false; Activate for input units other than nm/s and set :confval:`amplitudes.$name.resp.minFreq`, :confval:`amplitudes.$name.resp.maxFreq`
|
||||
|
||||
**(+++)** All values defining the time windows for measuring noise and signal
|
||||
are relative to P arrival time, read :ref:`Time grammar <time-grammar>`.
|
||||
|
||||
The default values are valid for SW-Germany (:cite:t:`stange-2006`).
|
||||
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
|
||||
:confval:`amplitudes.MLc.preFilter`, e.g. when integration is applied, and / or
|
||||
@ -95,7 +96,9 @@ amplitude.
|
||||
.. note::
|
||||
|
||||
For comparing MLc amplitudes with :ref:`ML amplitudes <global_ml>` set the
|
||||
global bindings parameters ::
|
||||
global bindings parameters
|
||||
|
||||
.. code-block:: properties
|
||||
|
||||
amplitudes.MLc.preFilter = ""
|
||||
amplitudes.MLc.combiner = average
|
||||
@ -106,54 +109,39 @@ amplitude.
|
||||
Station magnitudes
|
||||
------------------
|
||||
|
||||
Default properties, most parameters are configurable in global bindings:
|
||||
Station magnitudes are computed from measured amplitudes by applying a
|
||||
configurable calibration function when the origin is within depths and distance
|
||||
constraints. The parameters are configurable in global bindings or by global
|
||||
module parameters when applying
|
||||
:ref:`regionalization <concepts-magnitudes-regionalization>`.
|
||||
|
||||
* Distance type: hypocentral, epicentral can be selected by :confval:`magnitudes.MLc.distMode`.
|
||||
* Distance range: 0 - 8 deg, configurable by :confval:`magnitudes.MLc.minDist`,
|
||||
:confval:`magnitudes.MLc.maxDist`, measurements beyond 8 deg will be strictly
|
||||
ignored.
|
||||
* Depth range: <= 80 km, can be extended by :confval:`magnitudes.MLc.maxDepth`.
|
||||
* Expected amplitude type: MLc, configurable by magnitude alias.
|
||||
* Expected amplitude unit: millimeter (mm), other units can be assumed by
|
||||
amplitude scaling with :confval:`amplitudes.MLc.amplitudeScale`.
|
||||
* Magnitude calibration type: parametric, parametric and non-parametric are
|
||||
available through :confval:`magnitudes.MLc.calibrationType`.
|
||||
* Calibration function (see below for the equations), configurable by global bindings
|
||||
depending on the actual calibration type:
|
||||
|
||||
* parametric: :confval:`magnitudes.MLc.parametric.c0`,
|
||||
:confval:`magnitudes.MLc.parametric.c1`,
|
||||
:confval:`magnitudes.MLc.parametric.c2`,
|
||||
:confval:`magnitudes.MLc.parametric.c3`,
|
||||
:confval:`magnitudes.MLc.parametric.c4`,
|
||||
:confval:`magnitudes.MLc.parametric.c5`
|
||||
|
||||
* A0: :confval:`magnitudes.MLc.A0.logA0`
|
||||
* Station correction: none, configurable by a magnitude-type profile in global
|
||||
bindings with :confval:`magnitudes.MLc.offset` or the equivalent in global
|
||||
module configuration as :confval:`module.trunk.NET.STA.magnitudes.MLc.offset`.
|
||||
The latter is not supported by :ref:`scconfig` but it reduces the amount of
|
||||
required bindings.
|
||||
Station corrections are configurable by a magnitude-type profile named MLc in
|
||||
global bindings with :confval:`magnitudes.$name.offset` or the equivalent in
|
||||
global module configuration as :confval:`module.trunk.NET.STA.magnitudes.MLc.offset`.
|
||||
The latter is not supported by :ref:`scconfig` but it reduces the amount of
|
||||
required bindings.
|
||||
|
||||
The calibration function is considered in one of the forms
|
||||
|
||||
* parametric when :confval:`magnitudes.MLc.calibrationType` = "parametric"`:
|
||||
* Parametric when :confval:`magnitudes.MLc.calibrationType` = "parametric"`:
|
||||
|
||||
.. math::
|
||||
|
||||
MLc = \log_{10}(A) + c_3 * \log_{10}(r/c_5) + c_2 * (r + c_4) + c_1 + c_0(station)
|
||||
MLc = \log_{10}(A) + c_7 * e^{c8 * r} + c_6 * h + c_3 * \log_{10}(r / c_5) + c_2 * (r + c_4) + c_1 + c_0(station)
|
||||
|
||||
where
|
||||
|
||||
* *A*: displacement amplitude measured in unit of mm or as per configuration
|
||||
* *r*: hypocentral (default) or epicentral distance
|
||||
* *c1*, *c2*, *c3*, *c4*, *c5*: general calibration parameters
|
||||
* *c1 - c8*: general calibration parameters
|
||||
* *c0*: station-specific correction
|
||||
* *r*: Hypocentral (default) or epicentral distance as configured by
|
||||
:confval:`magnitudes.MLc.distMode`.
|
||||
:confval:`magnitudes.MLc.distMode`
|
||||
* h: (source depth - :confval:`magnitudes.MLc.parametric.H`) when
|
||||
source depth > :confval:`magnitudes.MLc.parametric.H` but 0 otherwise.
|
||||
|
||||
The default values are valid for SW-Germany (:cite:t:`stange-2006`), c6 and H
|
||||
have been added for supporting dependency on depth (:cite:t:`rhoades-2020`).
|
||||
The default values are valid for SW-Germany (:cite:t:`stange-2006`). *c6*,
|
||||
*H* have been added for supporting dependency on depth (:cite:t:`rhoades-2020`)
|
||||
and *c7*, *c8* for observations at short distances (:cite:t:`luckett2019`).
|
||||
|
||||
* log10(A0)-based non-parametric when :confval:`magnitudes.MLc.calibrationType` = "A0"`:
|
||||
|
||||
@ -168,10 +156,89 @@ The calibration function is considered in one of the forms
|
||||
|
||||
.. note::
|
||||
|
||||
The magnitude calibration function can be regionalized by adjusting global
|
||||
module configuration parameters in MLc region profiles of
|
||||
:confval:`magnitudes.MLc.region.*` and in a *MLc* Magnitude type profile e.g.
|
||||
in :file:`global.cfg`.
|
||||
* The magnitude calibration function can be regionalized by adjusting global
|
||||
module configuration parameters in MLc region profiles of
|
||||
:confval:`magnitudes.MLc.region.*` and in a *MLc* Magnitude type profile
|
||||
e.g., in :file:`global.cfg`.
|
||||
|
||||
Configurable parameters:
|
||||
|
||||
.. csv-table::
|
||||
:widths: 20 25 15 30
|
||||
:header: Topic, Parameter, Default, Comment
|
||||
:align: left
|
||||
:delim: ;
|
||||
|
||||
Distance type; :confval:`magnitudes.MLc.distMode`; hypocentral; epicentral or hyocentral can be selected
|
||||
Minimum distance; :confval:`magnitudes.MLc.minDist`; -1;
|
||||
Maximum distance; :confval:`magnitudes.MLc.maxDist`; 8; Measurements beyond 8 deg are strictly ignored
|
||||
Minimum source depth; :confval:`magnitudes.MLc.minDepth`; -10;
|
||||
Maximum source depth; :confval:`magnitudes.MLc.maxDepth`; 80; Can be extended beyond default
|
||||
Period range; NA; NA; Period is not measured. A configuration will prevent any MLc magnitude from being computed
|
||||
Amplitude type;; MLc; Configurable by :ref:`amplitude and magnitude alias <concepts_magnitudes-aliases>`
|
||||
Amplitude unit;; mm; other units can be assumed by amplitude scaling with :confval:`amplitudes.MLc.amplitudeScale`
|
||||
Magnitude calibration type; :confval:`magnitudes.MLc.calibrationType`; parametric; parametric and A0 (non-parametric) are available
|
||||
Linear magnitude correction;:confval:`magnitudes.$name.multiplier`; 1.0; Configure station corrections more conveniently configurable in global module configuration as :confval:`module.trunk.NET.STA.magnitudes.MLc.multiplier`
|
||||
Constant magnitude correction;:confval:`magnitudes.$name.offset`; 0.0; Configure station corrections more conveniently configurable in global module configuration as :confval:`module.trunk.NET.STA.magnitudes.MLc.offset`
|
||||
;;;
|
||||
**parametric** calibration;;; Parameters are used for :confval:`magnitudes.MLc.calibrationType` = parametric
|
||||
;:confval:`magnitudes.MLc.parametric.c0`;0.0;
|
||||
;:confval:`magnitudes.MLc.parametric.c1`;0.69;
|
||||
;:confval:`magnitudes.MLc.parametric.c2`;0.00095;
|
||||
;:confval:`magnitudes.MLc.parametric.c3`;1.11;
|
||||
;:confval:`magnitudes.MLc.parametric.c4`;0.0;
|
||||
;:confval:`magnitudes.MLc.parametric.c5`;1.0;
|
||||
;:confval:`magnitudes.MLc.parametric.c6`;0.0; see :cite:t:`rhoades-2020`
|
||||
;:confval:`magnitudes.MLc.parametric.H`;40.0; see :cite:t:`rhoades-2020`
|
||||
;:confval:`magnitudes.MLc.parametric.c7`;0.0; see :cite:t:`luckett2019`
|
||||
;:confval:`magnitudes.MLc.parametric.c8`;0.0; see :cite:t:`luckett2019`
|
||||
;;;
|
||||
**non-parametric** calibration;;; Parameters are used for :confval:`magnitudes.MLc.calibrationType` = A0
|
||||
;:confval:`magnitudes.MLc.A0.logA0`;0:-1.3,60:-2.8,100:-3.0,400:-4.5,1000:-5.85; from :ref:`ML magnitude <global_ml>`
|
||||
|
||||
|
||||
Network magnitude
|
||||
-----------------
|
||||
|
||||
The network magnitude is computed from station magnitudes automatically by
|
||||
:ref:`scmag` or interactively by :ref:`scolv`.
|
||||
Originally the median was computed from all station MLc to form the
|
||||
:term:`network magnitude` 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 :ref:`scmag` by :confval:`magnitudes.average`.
|
||||
|
||||
|
||||
Moment magnitude
|
||||
----------------
|
||||
|
||||
MLc can be scaled to a moment magnitude, Mw(MLc), by a magnitude-type profile in
|
||||
global module configuration. Read the
|
||||
:ref:`Tutorial on moment magnitudes <tutorials_mags_moment>` for the details.
|
||||
|
||||
|
||||
Aliases
|
||||
-------
|
||||
|
||||
Amplitude and magnitude aliases can be created by :confval:`magnitudes.aliases`
|
||||
and :confval:`amplitudes.aliases`, respectively, 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
|
||||
:ref:`Tutorial on magnitude aliases <tutorials_magnitude-aliases>` for the
|
||||
details.
|
||||
|
||||
|
||||
Regionalization
|
||||
---------------
|
||||
|
||||
Regionalization may be achieved by a magnitude-type profile in global module
|
||||
configuration. Read the
|
||||
:ref:`Tutorial on regionalization <tutorials_magnitude-region>` for the details.
|
||||
|
||||
|
||||
Examples
|
||||
========
|
||||
|
||||
The flexibility of the amplitude and magnitude processing allows for MLc to be
|
||||
applied in various use cases. Examples are given below.
|
||||
@ -207,46 +274,6 @@ applied in various use cases. Examples are given below.
|
||||
California (*MLc_hb*, :cite:t:`hutton-1987`).
|
||||
|
||||
|
||||
Network magnitude
|
||||
-----------------
|
||||
|
||||
The network magnitude is computed from station magnitudes automatically by
|
||||
:ref:`scmag` or interactively by :ref:`scolv`.
|
||||
Originally the median was computed from all station MLc to form the
|
||||
:term:`network magnitude` 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 :ref:`scmag` by :confval:`magnitudes.average`.
|
||||
|
||||
|
||||
Moment magnitude
|
||||
----------------
|
||||
|
||||
MLc can be scaled to a moment magnitude, Mw(MLc), by a magnitude-type profile in
|
||||
global module configuration. Read the
|
||||
:ref:`Tutorial on moment magnitudes <tutorials_mags_moment>` for the details.
|
||||
|
||||
|
||||
Magnitude aliases
|
||||
-----------------
|
||||
|
||||
Magnitude aliases can be created by :confval:`magnitudes.aliases` 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
|
||||
:ref:`Tutorial on magnitude aliases <tutorials_magnitude-aliases>` for the
|
||||
details.
|
||||
|
||||
|
||||
|
||||
Regionalization
|
||||
---------------
|
||||
|
||||
Regionalization may be achieved by a magnitude-type profile in global module
|
||||
configuration. Read the
|
||||
:ref:`Tutorial on regionalization <tutorials_magnitude-region>` for the details.
|
||||
|
||||
|
||||
Setup
|
||||
=====
|
||||
|
||||
@ -256,7 +283,7 @@ Setup
|
||||
or station bindings one line per parameter can be added to the global module
|
||||
configuration (:file:`global.cfg`) which takes the form
|
||||
|
||||
.. code-block:: params
|
||||
.. code-block:: properties
|
||||
|
||||
module.trunk.NET.STA.amplitudes.MLc.preFilter = value
|
||||
module.trunk.NET.STA.magnitudes.MLc.parametric.c0 = value
|
||||
@ -267,7 +294,7 @@ Setup
|
||||
for choosing the method to form the
|
||||
network magnitude from station magnitudes, e.g.
|
||||
|
||||
.. code-block:: params
|
||||
.. code-block:: properties
|
||||
|
||||
magnitudes.average = MLc:median
|
||||
|
||||
@ -276,8 +303,3 @@ Setup
|
||||
MLc become the preferred magnitude.
|
||||
#. Set defaults/visibility of MLc in :term:`GUI` modules, e.g. :ref:`scolv`
|
||||
or :ref:`scesv`.
|
||||
|
||||
.. note::
|
||||
|
||||
All default values for bindings configuration parameters are from
|
||||
:cite:t:`stange-2006`.
|
||||
|
||||
Reference in New Issue
Block a user