scqceval

QCStationEvaluator - Listens for QC messages and enables/disables stations based on configured QC parameter thresholds.

Description

scqceval dynamically re-configures the network processing based on data quality parameters. In case of inhomogeneous stations geometry of an earthquake monitoring setup where, e.g. an array is included within a network, the earthquake solution may be biased. Therefore only a subset of the station, e.g. the reference station of the array, may be used for the monitoring network. However, this or other stations may be of variable data quality. In case of low data quality alternative stations should be used. scqceval realizes such a re-configuration in real time based on the data quality parameters. Therefore scqceval allows to maintain homogeneous networks with high monitoring quality. The changes in the network configuration effects other parameters such as the amount of time required to locate events or the minimum magnitude which can be detected. Such changes in network performance are automatically monitored and reported by npeval.

Overview

scqceval dynamically re-configures the data processing of a SeisComP3 system in real time by:

  • Evaluating station quality (QC) parameters. It can take any QC parameters delivered by any plugin for scqc.
  • Activating and deactivating (enabling / disabling) stations with their location and streams based on the QC parameters.
  • Dynamic switching between a primary and a secondary station or even station chains in real times
  • Considering re-configurations by other modules, e.g. scrttv or scesv.

Configuration

scqceval requires:

  • Bindings configuration for including stations which are considered by scqceval
  • Module configuration:
    • defined primary and seconday stations by qc.pairs
    • set the time which prevents scqceval from reconfiguration after an initial reconfiguration by other modules: qc.resetAuthorAfter
    • decide which QC parameters define enabling a stations: qc.parameters within the configured ranges. Stations with QC parameter values outside the ranges are disabled by scqceval. Possible (conservative) choices are:
      • availability: 40.0,100.0
      • gaps count: 0,10
      • overlaps count: 0,10
      • latency: -Inf,600
      • delay: 0,60
      • timing quality: 90,Inf
      • offset: -700000,700000
      • spikes count: -Inf,0
      • timing quality: 90,Inf
      • rms: 20,Inf
      • gaps interval: 60,Inf
      • gaps length: -Inf,60
      • spikes interval: 20,Inf
      • overlaps interval: 60,Inf
      • overlaps length: 0,60

Examples

  • The stations GE.VAL and GE.RGN are automatically disabled by scqceval and replaced by their alternatives.

    _images/scqceval_1_clip.png

    Primary:secondary configuration: GE.VAL : GE.WLF ; GE.RGN : GE.SBV : GE.UGM

    _images/scqceval_2_clip.png

    Switch to secondary configuration due to exceedance of QC parameters gaps and delay: GE.VAL : GE.WLF ; GE.RGN : GE.SBV : GE.UGM

Configuration

etc/defaults/global.cfg
etc/defaults/scqceval.cfg
etc/global.cfg
etc/scqceval.cfg
~/.seiscomp3/global.cfg
~/.seiscomp3/scqceval.cfg

scqceval inherits global options.

qc.parameters

Type: list:string

Defines QC parameters to observe. Each parameter is associated with a value range. If any of the defined ranges is exceeded the corresponding station is disabled. Use ‘-Inf’ resp. ‘Inf’ if no upper or lower bound should exist. Supported QC parameters are availability, gaps count, overlaps count, latency, delay, timing quality, offset, rms and spikes count.

Example:

qc.parameters = “availability: 40.0,100.0”, “gaps count: 0,1”, “overlaps count: 0,1”

qc.pairs

Type: list:string

Define the primary and secondary station sorted by their priority in descending order. The station with the highest priority that fulfills all QC parameters is enabled. Primary stations outside a QC parameter range are disabled. Stations not listed here are simply enabled or disabled based on the QC parameters without a replacement by a secondary station.

Example:

qc.pairs = GE.VAL : GE.WLF, GE.UGM : GE.SBV : GE.RGN, GE.UGM : GE.WLF

qc.resetAuthorAfter

Type: int

Unit: s

Allow control over foreign stations after the specified time following a reconfiguration. A re-configuration can be e.g. enabling or disabling of a station in scrttv or scqcv. which have not been modified within the given number of seconds.

0: immediate control over all reconfigured stations

-1: control is disabled, scqceval will not reconfigure a foreign station Default is -1.

qc.ignoreMissingParametersAfter

Type: int

Unit: s

On startup, wait the given number of seconds to retrieve QC messages for all of the configured parameters before toggling a station actively. After this period, QC parameters without a value will be ignored. Use -1 to wait indefinitely. Default is 0.

Bindings

Configuration

enable

Type: boolean

Enables/disables usage of station with qceval. Default is true.