.\" Man page generated from reStructuredText. . . .nr rst2man-indent-level 0 . .de1 rstReportMargin \\$1 \\n[an-margin] level \\n[rst2man-indent-level] level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] - \\n[rst2man-indent0] \\n[rst2man-indent1] \\n[rst2man-indent2] .. .de1 INDENT .\" .rstReportMargin pre: . RS \\$1 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] . nr rst2man-indent-level +1 .\" .rstReportMargin post: .. .de UNINDENT . RE .\" indent \\n[an-margin] .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] .nr rst2man-indent-level -1 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. .TH "SCEEWENV" "1" "Nov 17, 2026" "vX.Y.Z" "ETHZ-SED EEW SeisComP contributions" .SH NAME sceewenv \- ETHZ-SED EEW SeisComP contributions Documentation .sp \fBThe generic pre\-processing module for EEW algorithms. It is required by scvsmag for the Virtual Seismologist (VS). In FinDer, the same core processing library is integrated into scfinder, the wrapper for the Finite\-Fault Rupture Detector (FinDer).\fP .SH DESCRIPTION .sp Part of the \fI\%EEW\fP package (in \fI\%VS\fP). .sp \fIsceewenv\fP is released under the GNU Affero General Public License (Free Software Foundation, version 3 or later). It provides in effect continuous real\-time streams of envelope values for horizontal and vertical acceleration, velocity and displacement from raw acceleration and velocity waveforms. \fIsceewenv\fP was extended from the original SED\-ETHZ VS\-specific pre\-processing module \fIscenvelope\fP, implemented to handle the waveform pre\-processing necessary for the \fI\%scvsmag\fP module (\X'tty: link http://www.seismo.ethz.ch/en/knowledge/earthquake-data-and-analysis-tools/EEW/Virtual-Seismologist/index.html'\fI\%Virtual Seismologist\fP\X'tty: link' [1]). Further parameters can also being calculated using the core library included in \fIsceewenv\fP, such as spectral amplitudes and tauP, though these are not accessible via the current \fIsceewenv\fP implementation. .sp The processing procedure for envelope computation is as follows: .INDENT 0.0 .IP 1. 3 gain correction .IP 2. 3 baseline correction .IP 3. 3 combination of the two horizontal components to a root\-mean\-squared horizontal component .IP 4. 3 integration or differentiation to velocity, acceleration and displacement (both velocity and displacement are high pass pre\-filtered over 0.075 Hz) .IP 5. 3 high\-pass filter with a corner frequency of 3 s period .IP 6. 3 computation of the absolute value within 1 s intervals .UNINDENT .sp In the example below, the resulting envelope values are sent as messages to the messaging system via the \(dqEEW\(dq message group. Depending on the number of streams that are processed this can result in a significant number of messages (#streams/s). .sp In order to save the messages in the database and to provide them to other modules, the messaging system must to be able to handle these messages. Therefore, the plugins \fIdmvs\fP must be available to seiscomp:scmaster and the \(dqEEW\(dq group must be added. .sp The plugins can be most easily \fBadded\fP through the configuration parameters in \fBglobal.cfg\fP: .INDENT 0.0 .INDENT 3.5 .sp .EX plugins = ${plugins}, dmvs .EE .UNINDENT .UNINDENT .sp \fBAdd\fP the \(dqENVELOPE\(dq group the the other message groups defined by scmaster in \fBscmaster.cfg\fP: .INDENT 0.0 .INDENT 3.5 .sp .EX defaultGroups = ${defaultGroups}, ENVELOPE .EE .UNINDENT .UNINDENT .sp and let \fIsceewenv\fP send the messages to the \(dqENVELOPE\(dq group instead of \(dqAMPLITUDE\(dq. Adjust \fBsceewenv.cfg\fP: .INDENT 0.0 .INDENT 3.5 .sp .EX connection.primaryGroup = ENVELOPE .EE .UNINDENT .UNINDENT .sp \fBNOTE:\fP .INDENT 0.0 .INDENT 3.5 When changing \fBconnection.primaryGroup\fP, the \(dqENVELOPE\(dq group must also be added to the subscriptions in \fI\%scvsmag\fP\&. .UNINDENT .UNINDENT .SH REFERENCES .IP [1] 5 \X'tty: link http://www.seismo.ethz.ch/en/knowledge/earthquake-data-and-analysis-tools/EEW/Virtual-Seismologist/index.html'\fI\%http://www.seismo.ethz.ch/en/knowledge/earthquake\-data\-and\-analysis\-tools/EEW/Virtual\-Seismologist/index.html\fP\X'tty: link' .SH CONFIGURATION .nf \fBetc/defaults/global.cfg\fP \fBetc/defaults/sceewenv.cfg\fP \fBetc/global.cfg\fP \fBetc/sceewenv.cfg\fP \fB~/.seiscomp/global.cfg\fP \fB~/.seiscomp/sceewenv.cfg\fP .fi .sp .sp sceewenv inherits \X'tty: link https://docs.gempa.de/seiscomp/current/apps/global.html'\fI\%global options\fP\X'tty: link'\&. .INDENT 0.0 .TP .B eewenv.saturationThreshold Type: \fIdouble\fP .sp Unit: \fIpercent\fP .sp Relative saturation threshold in percent. If the absolute raw amplitude exceeds X% of 2**23 counts the station will be excluded from processing. This assumes a 24bit datalogger. The default is 80. Default is \fB80\fP\&. .UNINDENT .INDENT 0.0 .TP .B eewenv.baselineCorrectionBuffer Type: \fIdouble\fP .sp Unit: \fIs\fP .sp Length in seconds of the baseline correction buffer. A running average is computed and removed from the current sample. The default is 60s. Default is \fB60\fP\&. .UNINDENT .INDENT 0.0 .TP .B eewenv.horizontalBuffer Type: \fIdouble\fP .sp Unit: \fIs\fP .sp Length of buffer for horizontal components. Because horizontal components are being received separately they must be buffered to align them properly. Sets the buffer size for each component to compensate for data acquisition latencies. Each component is buffered for at least as long as \ep ts seconds before single records are being removed. This buffer size correlates to the maximum latency of one horiontal component with respect to the other. A too short buffer size will lead to gaps in the combined data stream. bufferSize is as time span (in seconds with fractional part). The default is 60s. Default is \fB60\fP\&. .UNINDENT .INDENT 0.0 .TP .B eewenv.taperLength Type: \fIdouble\fP .sp Unit: \fIs\fP .sp Length in seconds of the taper that is applied to the beginning of the trace. Default is \fB60\fP\&. .UNINDENT .sp \fBNOTE:\fP .INDENT 0.0 .INDENT 3.5 \fBeewenv.streams.*\fP \fIDefines the white\- and blacklist of data streams to be used. The\fP \fIrules to decide if a stream is used or not are the following:\fP ** \fI1. if whitelist is not empty and the stream is not on the whitelist,\fP \fIdon\(aqt use it, ok otherwise\fP ** \fI2. if blacklist is not empty and the stream is on the blacklist,\fP \fIdon\(aqt use it, ok otherwise\fP ** \fIBoth checks are made and combined with AND. Either whitelist or\fP \fIblacklist contains a list of patterns (wildcard allowed as * and ?),\fP \fIeg GE.\fP\&.*.*, \fI, GE.MORC.\fP\&.BH? Each stream id (NET.STA.LOC.CHA) will* \fIbe checked against the defined patterns.\fP .UNINDENT .UNINDENT .INDENT 0.0 .TP .B eewenv.streams.whitelist Type: \fIlist:string\fP .sp The stream whitelist .UNINDENT .INDENT 0.0 .TP .B eewenv.streams.blacklist Type: \fIlist:string\fP .sp The stream blacklist .UNINDENT .sp \fBNOTE:\fP .INDENT 0.0 .INDENT 3.5 \fBeewenv.vsfndr.*\fP \fIVS and FinDer configuration\fP .UNINDENT .UNINDENT .INDENT 0.0 .TP .B eewenv.vsfndr.envelopeInterval Type: \fIdouble\fP .sp Unit: \fIs\fP .sp Interval length for envelope computation. The default is 1s. .sp Interval of the envelope computation. The maximum is taken with that data interval and declared as envelope value. The intervals do not overlap. Default is \fB1.0\fP\&. .UNINDENT .INDENT 0.0 .TP .B eewenv.vsfndr.filterAcc Type: \fIboolean\fP .sp Enable acceleration filter, default is false. Default is \fBfalse\fP\&. .UNINDENT .INDENT 0.0 .TP .B eewenv.vsfndr.filterVel Type: \fIboolean\fP .sp Enable velocity filter, default is false. Default is \fBfalse\fP\&. .UNINDENT .INDENT 0.0 .TP .B eewenv.vsfndr.filterDisp Type: \fIboolean\fP .sp Enable displacement filter, default is true. Default is \fBtrue\fP\&. .UNINDENT .INDENT 0.0 .TP .B eewenv.vsfndr.filterCornerFreq Type: \fIdouble\fP .sp Unit: \fIHz\fP .sp Sets the corner frequency of the Butterworth (4 poles) high\-pass filter, default is 1/3 Hz. Default is \fB1/3\fP\&. .UNINDENT .INDENT 0.0 .TP .B eewenv.debug.maxHorizontalGap Type: \fIdouble\fP .sp Unit: \fIs\fP .sp Sets the maximum combined horizontal channels delay before issuing a warning. That parameter does not configure buffers as such but only a threshold (in seconds with fractional part) to warn the user that something is not real\-time anymore. The default is 30s. Default is \fB30\fP\&. .UNINDENT .INDENT 0.0 .TP .B eewenv.debug.maxDelay Type: \fIdouble\fP .sp Unit: \fIs\fP .sp Sets the maximum absolute value of packet delay before issuing a warning. That parameter does not configure buffers as such but only a threshold (in seconds with fractional part) to warn the user that something is not real\-time anymore. The default is 3s. Default is \fB3\fP\&. .UNINDENT .SH COMMAND LINE .SS Generic .INDENT 0.0 .TP .B \-x, \-\-expiry time Time span in hours after which objects expire. .UNINDENT .INDENT 0.0 .TP .B \-O, \-\-origin\-id publicID OriginID to calculate amplitudes for and exit. .UNINDENT .INDENT 0.0 .TP .B \-\-dump\-records Dumps the filtered traces to ASCII when using \-O. .UNINDENT .SS Verbosity .SS Messaging .INDENT 0.0 .TP .B \-\-test Test mode where no messages are sent. .UNINDENT .SS Database .SS Records .SS Offline .INDENT 0.0 .TP .B \-\-offline Do not connect to the messaging. This mode requires either an explicit database connection to read the inventory from or an inventory XML file. This option implies \-\-test. .UNINDENT .INDENT 0.0 .TP .B \-\-dump\-config Show configuration in debug log and stdcerr and exit. .UNINDENT .INDENT 0.0 .TP .B \-\-ts Start time of data acquisition time window, requires also \-\-te .UNINDENT .INDENT 0.0 .TP .B \-\-te End time of data acquisition time window, requires also \-\-ts .UNINDENT .SS Streams .INDENT 0.0 .TP .B \-\-dump Enables dumping of incoming, transformed and combined records to stdout. This mode is for debugging. The default is false. .UNINDENT .SH AUTHOR Swiss Seismological Service .SH COPYRIGHT 2020, SED .\" Generated by docutils manpage writer. .