scqc
scqc determines quality parameters of seismic data streams. The output parameters are time averaged quality control (QC) parameters in terms of waveform quality messages. In regular intervals report messages are sent containing the short term average representation of the specific QC parameter for a given time span. Alarm messages are generated if the short term average (e.g. 90s) of a QC parameter differs from the long term average (e.g. 3600s) more than a defined threshold.
To avoid an excessive load, QC messages are sent distributed over time. The following parameters are determined:
- Delay [s]
- Time difference between arrival time and last record end time plus half record length (mean data latency, valid for all samples in record)
- Latency [s]
- Time difference between current time and record arrival time (feed latency)
- Offset [counts]
- Average value of all samples of a record
- RMS [counts]
- Offset corrected root mean square (RMS) value of a record
- Spike (interval [s], amplitude [counts])
- In case of the occurrence of a spike in a record this parameter delivers the time interval between adjacent spikes and the mean amplitude of the spike; internally a list of spikes is stored (spike time, spike amplitude); the spike finder algorithm is still preliminary
- Gap (interval [s], length [s])
- In case of a data gap between two consecutive records this parameter delivers the gap interval time and the mean length of the gap
- Timing [%]
- miniseed record timing quality (0 - 100 %)
Options
scqc supports command line options as well as configuration files (scqc.cfg).
Commandline
Command line options are limited to the default application options.
Configuration
User configuration file: $HOME/.seiscomp3/scqc.cfg
- CreatorID <string>
- ID of QC message creator(# use only configured streams,# --> the same streams as e.g. scautopick works on)
- useConfiguredStreams <bool>
- limit QC determination to processed data streams
- mode <data/notifier>
- send QC parameters as notifier or data messages
- Plugins <plug-in list>
-
Load this plug-ins for calculating QC parameters, e.g.
- qcplugin_delay
- qcplugin_latency
- qcplugin_timing
- qcplugin_rms
- qcplugin_offset
- qcplugin_gap
- qcplugin_spike
- qcplugin_availability
- qcplugin_outage.so
- qcplugin_overlap.so
- plugins.default.reportInterval <int> [60]
- Interval for sending the report messages in seconds
- plugins.default.alertInterval <int> [30]
- Interval for checking the alert thresholds in seconds
- plugins.default.staBufferLength <int> [600]
- Short Term Average (STA) buffer length in seconds
- plugins.default.ltaBufferLength <int> [1800]
- Long Term Average (LTA) buffer length in seconds
- plugins.default.timeout <int> [0]
- Generate a report message in case no data is received since timeout in seconds
- plugins.default.thresholds <int> [100]
- Alert thresholds in percent, single value [or list 25,50,75 ... not yet implemented]
- plugins.qcplugin_latency.timeout <int> [60]
- Maximum latency of streams that are processed by scqc
Example:
CreatorId="smi://de.gfz-potsdam/QcTool_0.2"
useConfiguredStreams = True
mode = data
plugins = qcplugin_delay, \
qcplugin_latency, \
qcplugin_timing, \
qcplugin_rms, \
qcplugin_offset, \
qcplugin_gap, \
qcplugin_spike
plugins.default.reportInterval = 60
plugins.default.alertInterval = 30
plugins.default.staBufferLength = 600
plugins.default.ltaBufferLength = 1800
plugins.default.timeout = 0
plugins.default.thresholds = 100
plugins.qcplugin_latency.timeout = 60
