[installation] Change to nightly
This commit is contained in:
@ -1,34 +1,85 @@
|
||||
.. _concepts_magnitudes:
|
||||
|
||||
Magnitudes
|
||||
##########
|
||||
Amplitudes and Magnitudes
|
||||
#########################
|
||||
|
||||
Magnitudes are computed based on amplitudes measured from waveforms. Different
|
||||
types of amplitudes and magnitudes are available which are listed in
|
||||
:ref:`scamp` and :ref:`scmag`.
|
||||
:ref:`Magnitudes of specific types <concepts_magnitudes-station>` are computed
|
||||
from :ref:`amplitudes <concepts_magnitudes-amplitudes>` measured on waveforms.
|
||||
Different types of amplitudes and magnitudes are available including aliases.
|
||||
All magnitudes can be regionalized and mapped to Mw. The native amplitude and
|
||||
magnitudes types are listed in :ref:`scamp` and :ref:`scmag`.
|
||||
|
||||
All amplitude and magnitude values can be read in the Magnitudes tab of
|
||||
:ref:`scolv`, in bulletins created by :ref:`scbulletin` and dumped
|
||||
from database to XML for an origin or event by :ref:`scxmldump`.
|
||||
|
||||
This concept section describes the principles applied in |scname| and links to
|
||||
more specific sections including tutorials describing the configuration and
|
||||
application.
|
||||
|
||||
|
||||
.. figure:: media/amplitude-magnitude-processing.png
|
||||
:alt: amplitudes and magnitudes: processing flow
|
||||
:align: center
|
||||
:width: 18cm
|
||||
|
||||
Schematic processing flow for computing magnitudes from measured amplitudes
|
||||
including the involved |scname| modules and interfaces. Multiple network
|
||||
magnitude types can be computed for the same :term:`origin`. The default
|
||||
processing of native amplitudes and magnitudes in the center can be extended
|
||||
by aliases, regionalization, Mw mapping or external magnitudes.
|
||||
|
||||
|
||||
.. _concepts_magnitudes-amplitudes:
|
||||
|
||||
Amplitudes
|
||||
==========
|
||||
|
||||
Amplitudes can be measured automatically from waveforms
|
||||
Amplitudes can be measured on waveforms
|
||||
|
||||
* During phase picking by :ref:`scautopick` with generally fixed time windows
|
||||
due to the absence of knowledge about source parameters or by,
|
||||
* :ref:`scamp` as soon as :term:`origins <origin>` are available. Depending
|
||||
on the magnitude type, fixed or distance-dependent time windows apply.
|
||||
* Automatically during phase picking by :ref:`scautopick` with generally fixed
|
||||
time windows due to the absence of knowledge about source parameters.
|
||||
* Automatically by :ref:`scamp` as soon as :term:`origins <origin>` are
|
||||
available. Depending on the amplitude type and their configuration, fixed or
|
||||
distance-dependent time windows as well as constraints on signal quality apply.
|
||||
* Interactively using :ref:`scolv` with preset or user-defined conditions.
|
||||
|
||||
and interactively using :ref:`scolv`.
|
||||
:ref:`Time grammar <time-grammar>` applies for configuring the time windows.
|
||||
|
||||
|
||||
Instrument simulation
|
||||
---------------------
|
||||
Input data
|
||||
----------
|
||||
|
||||
Amplitude measurements for some magnitude types require or allow the simulation
|
||||
Depending on type amplitudes are measured on raw or filtered waveform data.
|
||||
Initial raw data are given in counts of the digitizer with a stream gain unit of
|
||||
m/s which is typical for seismometers.
|
||||
It is assumed that the measured signal has its dominant
|
||||
frequency where the response of the recording instrument is flat.
|
||||
For other instruments such as accelerometers or short-period geophones, amplitude
|
||||
correction for instrument response and the corresponding frequency range may be
|
||||
configured by the global binding parameters
|
||||
:confval:`amplitudes.enableResponses`, :confval:`amplitudes.resp.minFreq`,
|
||||
:confval:`amplitudes.resp.maxFreq` or even with in amplitude-type profiles for
|
||||
more specific application. Amplitude measurements will fail if the
|
||||
unit of the (corrected) input data do not correspond to the requirement of the
|
||||
amplitude type.
|
||||
|
||||
Filtering may involve
|
||||
:ref:`simulation of Wood-Anderson seismographs <concepts_magnitudes-wa>`.
|
||||
Final amplitude measurements are corrected by stream gain and provided as an
|
||||
amplitude object.
|
||||
|
||||
|
||||
.. _concepts_magnitudes-wa:
|
||||
|
||||
Wood-Anderson simulation
|
||||
------------------------
|
||||
|
||||
Some amplitude types require or allow the correction of waveforms by simulation
|
||||
of instruments such as :py:func:`Wood-Anderson torsion seismometers <WA>`
|
||||
(:cite:t:`richter-1935,uhrhammer-1990`), :py:func:`WWSSN_SP` or :py:func:`WWSSN_LP`.
|
||||
The calibration parameters describing the Wood-Anderson seismometer are
|
||||
configurable in global bindings or global module configuration:
|
||||
The calibration parameters describing a Wood-Anderson seismometer are
|
||||
configurable in global bindings or module configuration:
|
||||
:confval:`amplitudes.WoodAnderson.gain`, :confval:`amplitudes.WoodAnderson.T0`,
|
||||
:confval:`amplitudes.WoodAnderson.h`. Specifically, the difference in magnitude
|
||||
due to configuration using original values listed in
|
||||
@ -38,16 +89,61 @@ Wood-Anderson simulation, e.g. :term:`ML <magnitude, local (ML)>`,
|
||||
:term:`MLv <magnitude, local vertical (MLv)>`, :term:`MLc <magnitude, local custom (MLc)>`.
|
||||
|
||||
|
||||
Physical units
|
||||
--------------
|
||||
|
||||
The physical units of measured amplitudes depend on amplitudes type. They are
|
||||
documented along with the corresponding magnitude type. Starting with the initial
|
||||
gain unit of raw data streams, typically m/s, the amplitude processor in
|
||||
|scname| converts to the required unit. Where instrument simulation if optional,
|
||||
e.g., for :term:`MLc amplitudes <magnitude, local custom (MLc)>`, a conversion
|
||||
configurable factor must be considered for non-default amplitude processing.
|
||||
|
||||
|
||||
.. _concepts_amplitudes-aliases:
|
||||
|
||||
Amplitude Aliases
|
||||
-------------------------------
|
||||
|
||||
New amplitude types (aliases) can be created based on existing amplitude types
|
||||
but configured and measured specifically. They can be measured as any other
|
||||
amplitude by :ref:`scamp` or :ref:`scautopick` and used by other modules, e.g.,
|
||||
by :ref:`scmag` for :ref:`magnitude aliases <concepts_magnitudes-station>`. The
|
||||
setup procedure is outlined in the tutorial on
|
||||
:ref:`amplitude aliases <tutorials_amplitude-aliases>`.
|
||||
|
||||
|
||||
.. _concepts-amplitudes-regionalization:
|
||||
|
||||
Regionalization
|
||||
---------------
|
||||
|
||||
Measuring amplitudes only for sources or pairs of sources and stations in
|
||||
specific regions is supported by regionalization. The region polygons are
|
||||
defined by :ref:`magnitude regionalization <concepts-magnitudes-regionalization>`.
|
||||
In order to use the feature, regionalized amplitudes and magnitudes must have
|
||||
the same type (name) and regionalization must be activated per amplitude type in
|
||||
amplitude-type profiles of global bindings.
|
||||
|
||||
|
||||
.. _concepts_magnitudes-station:
|
||||
|
||||
Station Magnitudes
|
||||
==================
|
||||
|
||||
Station magnitudes are computed automatically by :ref:`scmag` or interactively
|
||||
by :ref:`scolv` from measured amplitudes based on distance-dependent
|
||||
calibration curves which depend on magnitude type. When computing a set of
|
||||
magnitudes in :ref:`scolv` which is different from the set configured in
|
||||
:ref:`scmag`, then scmag may later add the missing magnitudes automatically.
|
||||
Magnitude types for which the evaluation status is set to "rejected", e.g., in
|
||||
scolv, will not be recomputed by scmag.
|
||||
calibration curves which depend on magnitude type. Since distance measures are
|
||||
required, station magnitudes are always related to one :term:`origin`. For
|
||||
computing new magnitudes in scolv, a new origin must be created which is done by
|
||||
relocating.
|
||||
|
||||
When computing a set of station magnitudes in :ref:`scolv` which is different from
|
||||
the set configured in :ref:`scmag`, then scmag may later add the missing
|
||||
magnitudes automatically. Magnitude types for which the evaluation status is
|
||||
set to "rejected", e.g., in :ref:`scolv`, will not be recomputed by scmag. In
|
||||
order to ignore a magnitude type interactively, it should therefore be treated
|
||||
and rejected in scolv.
|
||||
|
||||
|
||||
.. _concepts-magnitudes-correction:
|
||||
@ -64,7 +160,7 @@ global :ref:`binding parameters <global_bindings_config>`:
|
||||
|
||||
When using binding profiles, all referencing stations will be affected equally
|
||||
which is typically not intended. In contrast, applying station bindings requires
|
||||
to set up many bindings which may not be intended either.
|
||||
to set up many bindings which may not be intended either.concepts-magnitudes-regionalization
|
||||
|
||||
Therefore, you may add lines to the global module configuration in
|
||||
:file:`global.cfg` where one line corresponds to one station with one magnitude
|
||||
@ -85,39 +181,26 @@ parameters are identical to the global bindings parameters. All lines start with
|
||||
:file:`seiscomp/etc/global.cfg`.
|
||||
|
||||
|
||||
Network Magnitudes
|
||||
==================
|
||||
.. _concepts_magnitudes-aliases:
|
||||
|
||||
Network magnitudes are computed automatically by :ref:`scmag` or interactively
|
||||
by :ref:`scolv` from station magnitudes based on averaging station magnitudes.
|
||||
The averaging methods applied by :ref:`scmag` are configurable by
|
||||
:confval:`magnitudes.average`. Available are (:cite:t:`rosenberger-1983`):
|
||||
Magnitude Aliases
|
||||
-------------------------------
|
||||
|
||||
* *mean*: the mean value from all station magnitudes.
|
||||
* *median*: the mean value from all station magnitudes.
|
||||
* *trimmedMean(X)*: gnores outlier station magnitudes by first removing the
|
||||
largest and the smallest *X* % of the observed values (percentiles). The mean is
|
||||
formed from the remaining station magnitudes.
|
||||
* *trimmedMedian(X)*: forms the median from all station magnitudes but returns
|
||||
the uncertainty by ignoring the largest and the smallest *X* % station
|
||||
magnitudes.
|
||||
* *medianTrimmedMean(X)*: returns the mean magnitude from all station magnitudes
|
||||
differing less than *X* magnitudes from the median.
|
||||
|
||||
|
||||
Aliases
|
||||
=======
|
||||
|
||||
New magnitude types (aliases) can be created based on existing magnitude and
|
||||
amplitude types but configured specifically.
|
||||
The setup procedure is outlined in the
|
||||
:ref:`tutorial on magnitude aliases <tutorials_magnitude-aliases>`.
|
||||
New magnitude types (aliases) can be created inheriting the configuration
|
||||
parameters but not the configured values from existing magnitude and amplitude types or
|
||||
:ref:`amplitude aliases <concepts_amplitudes-aliases>`. The values are configured
|
||||
specifically. Unless specified explicitly, the amplitude type
|
||||
is the base amplitude of the original magnitude. Other
|
||||
amplitude types or amplitude aliases must be defined first and given explicitly.
|
||||
The aliased magnitudes can be computed by other modules such as :ref:`scmag` or
|
||||
:ref:`scolv`. The setup procedure is outlined in the tutorial on
|
||||
:ref:`magnitude aliases <tutorials_magnitude-aliases>`.
|
||||
|
||||
|
||||
.. _concepts-magnitudes-regionalization:
|
||||
|
||||
Regionalization
|
||||
===============
|
||||
---------------
|
||||
|
||||
The computation of station magnitudes can be regionalized. This means that for
|
||||
a specific region specific conditions apply when computing magnitudes. The
|
||||
@ -135,6 +218,30 @@ setup procedure including
|
||||
:ref:`tutorial on regionalization <tutorials_magnitude-region-aliases>`.
|
||||
|
||||
|
||||
.. _concepts_magnitudes-network:
|
||||
|
||||
Network Magnitudes
|
||||
==================
|
||||
|
||||
Network magnitudes are computed automatically by :ref:`scmag` or interactively
|
||||
by :ref:`scolv` from station magnitudes based on averaging station magnitudes.
|
||||
The averaging methods applied by :ref:`scmag` are configurable by
|
||||
:confval:`magnitudes.average`. Available are (:cite:t:`rosenberger-1983`):
|
||||
|
||||
* *mean*: The mean value from all station magnitudes.
|
||||
* *median*: The mean value from all station magnitudes.
|
||||
* *trimmedMean(X)*: Ignores outlier station magnitudes by first removing the
|
||||
largest and the smallest *X* % of the observed values (percentiles). The mean is
|
||||
formed from the remaining station magnitudes.
|
||||
* *trimmedMedian(X)*: Forms the median from all station magnitudes but returns
|
||||
the uncertainty by ignoring the largest and the smallest *X* % station
|
||||
magnitudes.
|
||||
* *medianTrimmedMean(X)*: Returns the mean magnitude from all station magnitudes
|
||||
differing less than *X* magnitudes from the median.
|
||||
|
||||
|
||||
.. _concepts_magnitudes-moment:
|
||||
|
||||
Moment Magnitudes
|
||||
=================
|
||||
|
||||
@ -165,6 +272,8 @@ usually referred to as *M*. The name is configurable.
|
||||
:term:`origin`.
|
||||
|
||||
|
||||
.. _concepts_magnitudes-preferred:
|
||||
|
||||
Preferred Magnitude
|
||||
===================
|
||||
|
||||
|
||||
Reference in New Issue
Block a user