Calculates magnitudes of different types.
The purpose of scmag is to compute magnitudes. It takes amplitudes and origins as input and produces StationMagnitudes and Magnitudes as output. The resulting magnitudes are sent to the "MAGNITUDE" group. scmag doesn’t access any waveforms. It only uses amplitudes previously calculated, e.g. by scamp. The purpose of scmag is the decoupling of magnitude computation from amplitude measurements. This allows several modules to generate amplitudes concurrently, like scautopick and scamp. As soon as an origin comes in, the amplitudes related to the picks are taken either from the memory buffer or the database to compute the magnitudes. Currently the following magnitude types are implemented:
Additionally, scmag computes the following derived magnitudes:
scmag can compute a summary magnitude which is a weighted sum of all available magnitudes. This magnitude is called M and is computed as follows:
M = \frac{\sum w_{i} M_{i}}{\sum w_i} w_{i} = a_i stacount(M_{i}) + b_i
The coefficients a and b can be configured per magnitude type. Furthermore each magnitude type can be included or excluded from the summary magnitude calculation.
scmag inherits global options.
Type: list:string
Definition of amplitude types to be calculated. Default is MLv, mb, mB, Mwp.
Type: int
Interval between 2 sending processes. The interval has influence how often information is updated. Default is 1.
Type: double
The minimum weight of an arrival to be used for magnitude calculations. Default is 0.5.
Note
summaryMagnitude.* The summary magnitude is building a weighted summary above all defined magnitude types. The single magnitude value is multiplied with the magnitude type specific weight. This is summed up for all magnitude types and the resulting sum is divided through the sum of all weights.
Type: boolean
Enables summary magnitude calculation. Default is true.
Type: string
Define the type/name of the summary magnitude. Default is M.
Type: int
This is the minimum station magnitude required for any magnitude to contribute to the summary magnitude at all. If this is set to 4 then no magnitude with less than 4 station magnitudes is taken into consideration even if this results in no summary magnitude at all. For this reason, the default here is 1 but in a purely automatic system it should be higher, at least 4 is recommended. Default is 4.
Type: list:string
Define the magnitude types to be excluded from the summary magnitude calculation.
Type: list:string
Define the magnitude types to be included in the summary magnitude calculation.
Note
summaryMagnitude.coefficients.* Define the coefficients to calculate the weight of a magnitude. weight = a*magStationCount+b
Type: list:string
Define the coefficients a. Unnamed values define the default value. Default is 0, Mw(mB):0.4, Mw(Mwp):0.4.
Type: list:string
Define the coefficients b. Unnamed values define the default value. Default is 1, MLv:2, Mw(mB):-1, Mw(Mwp):-1.
Type: list:string
Defines the average method to use when computing the network magnitude. To define the average method per magnitude type append the type, eg: "magnitudes.average = default, MLv:median"
The default behaviour is to compute the mean if less than 4 contributed station magnitudes exist otherwise a trimmed mean of 25 percent is used. Options are "default", "mean" and "trimmedMean". Default is default.
show help message.
show version information
Use alternative configuration file. When this option is used the loading of all stages is disabled. Only the given configuration file is parsed and used. To use another name for the configuration create a symbolic link of the application or copy it, eg scautopick -> scautopick2.
Load given plugins.
Run as daemon. This means the application will fork itself and doesn't need to be started with &.
Enable/disable self-shutdown because a master module shutdown. This only works when messaging is enabled and the master module sends a shutdown message (enabled with --start-stop-msg for the master module).
Sets the name of the master-module used for auto-shutdown. This is the application name of the module actually started. If symlinks are used then it is the name of the symlinked application.
Sets the name of the master-username of the messaging used for auto-shutdown. If "shutdown-master-module" is given as well this parameter is ignored.
Time span in hours after which objects expire.
Verbosity level [0..4]. 0:quiet, 1:error, 2:warning, 3:info, 4:debug
Increase verbosity level (may be repeated, eg. -vv)
Quiet mode: no logging output
Limits the logging to a certain component. This option can be given more than once.
Use syslog logging back end. The output usually goes to /var/lib/messages.
Path to lock file.
Send log output to stdout.
Debug mode: --verbosity=4 --console=1
Use alternative log file.
Overrides configuration parameter connection.username.
Overrides configuration parameter connection.server.
Overrides configuration parameter connection.timeout.
Overrides configuration parameter connection.primaryGroup.
A group to subscribe to. This option can be given more than once.
Overrides configuration parameter connection.encoding.
Sets sending of a start- and a stop message.
List all supported database drivers.
The database connection string, format: service://user:pwd@host/database. "service" is the name of the database driver which can be queried with "--db-driver-list".
The configmodule to use.
Load the inventory from the given database or file, format: [service://]location
Do not use the database at all