You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
230 lines
5.7 KiB
Groff
230 lines
5.7 KiB
Groff
.\" Man page generated from reStructuredText.
|
|
.
|
|
.TH "MSRTSIMUL" "1" "Jan 10, 2023" "5.3.0" "SeisComP"
|
|
.SH NAME
|
|
msrtsimul \- SeisComP Documentation
|
|
.
|
|
.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
|
|
..
|
|
.sp
|
|
\fBMiniSEED real time playback and simulation\fP
|
|
.SH DESCRIPTION
|
|
.sp
|
|
msrtsimul simulates a real\-time data acquisition by injecting miniSEED data from a
|
|
file into the seedlink buffer via the mseedfifo plugin for seedlink. It can be
|
|
used for simulating real\-time conditions in playbacks for whole\-system
|
|
demonstrations, user training, etc.
|
|
.sp
|
|
The data are played back as if they were recorded at current time. Therefore, creation
|
|
times and the actual data times including pick times, event times etc. will be \fBfaked\fP\&.
|
|
\fI\%Historic playbacks\fP allow keeping the actual data times.
|
|
.sp
|
|
\fBWARNING:\fP
|
|
.INDENT 0.0
|
|
.INDENT 3.5
|
|
For real\-time playbacks, the data must be sorted by time. This requirement
|
|
may be violated. Use scmssort to sort the data by time.
|
|
.UNINDENT
|
|
.UNINDENT
|
|
.SS Non\-default seedlink pipes
|
|
.sp
|
|
By default, msrtsimul writes the data into the mseedfifo pipe
|
|
\fI$SEISCOMP_ROOT/var/run/seedlink/mseedfifo\fP\&.
|
|
If the data are to be written into the pipe of a \fBseedlink\fP alias or
|
|
into any other pipe, the pipe name must be adjusted. Use the option
|
|
.INDENT 0.0
|
|
.IP \(bu 2
|
|
\fB\-\-seedlink\fP to replace \fIseedlink\fP by another name, e.g. a seedlink instance
|
|
created as an alias, \fBseedlink\-test\fP\&. This would write into
|
|
\fI$SEISCOMP_ROOT/var/run/seedlink\-test/mseedfifo\fP\&.
|
|
.IP \(bu 2
|
|
\fB\-\-stdout\fP to write to standard output and then redirect to any other location.
|
|
.UNINDENT
|
|
.SS Historic playbacks
|
|
.sp
|
|
You may use msrtsimul with the \fB\-m historic\fP option to maintain the time of the records,
|
|
thus the times of picks, amplitudes, origins, etc. but not the creation times.
|
|
Applying \fB\-m historic\fP will feed the data into the seedlink buffer at the time
|
|
of the records. The time of the system is untouched. GUI, processing modules, logging,
|
|
etc. will run with current system time. The historic mode allows to process waveforms
|
|
with the stream inventory valid at the time when the data were recorded including
|
|
streams closed at current time.
|
|
.sp
|
|
\fBWARNING:\fP
|
|
.INDENT 0.0
|
|
.INDENT 3.5
|
|
When repeating historic playbacks, the waveforms are fed multiple times to the
|
|
seedlink buffer and the resulting picks are also repeated with the same pick
|
|
times. This may confuse the real\-time system. Therefore, seedlink and other modules
|
|
creating or processing picks should be
|
|
stopped, the seedlink buffer should be cleared and the processing
|
|
modules should be restarted to clear the buffers before starting the
|
|
historic playbacks. Make sure scautopick is configured or started with
|
|
the \fB\-\-playback\fP option. Example:
|
|
.INDENT 0.0
|
|
.INDENT 3.5
|
|
.sp
|
|
.nf
|
|
.ft C
|
|
$ seiscomp stop
|
|
$ rm \-rf $SEISCOMP_ROOT/var/lib/seedlink/buffer
|
|
$ seiscomp start
|
|
$ msrtsimul ...
|
|
.ft P
|
|
.fi
|
|
.UNINDENT
|
|
.UNINDENT
|
|
.UNINDENT
|
|
.UNINDENT
|
|
.SS seedlink setup
|
|
.sp
|
|
For supporting msrtsimul activate the \fBmsrtsimul\fP parameter in the
|
|
seedlink module configuration (\fBseedlink.cfg\fP), update the configuration
|
|
and restart seedlink before running msrtsimul:
|
|
.INDENT 0.0
|
|
.INDENT 3.5
|
|
.sp
|
|
.nf
|
|
.ft C
|
|
$ seiscomp update\-config seedlink
|
|
$ seiscomp restart seedlink
|
|
$ msrtsimul ...
|
|
.ft P
|
|
.fi
|
|
.UNINDENT
|
|
.UNINDENT
|
|
.SS Examples
|
|
.INDENT 0.0
|
|
.IP 1. 3
|
|
Playback miniSEED waveforms in real time with verbose output:
|
|
.INDENT 3.0
|
|
.INDENT 3.5
|
|
.sp
|
|
.nf
|
|
.ft C
|
|
$ msrtsimul \-v miniSEED\-file
|
|
.ft P
|
|
.fi
|
|
.UNINDENT
|
|
.UNINDENT
|
|
.IP 2. 3
|
|
Playback miniSEED waveforms in historic mode. This may require scautopick
|
|
to be started with the option \fIplayback\fP:
|
|
.INDENT 3.0
|
|
.INDENT 3.5
|
|
.sp
|
|
.nf
|
|
.ft C
|
|
$ msrtsimul \-v \-m historic miniSEED\-file
|
|
.ft P
|
|
.fi
|
|
.UNINDENT
|
|
.UNINDENT
|
|
.IP 3. 3
|
|
Feed the data into the buffer of a specific seedlink instance, e.g. \fIseedlink\-test\fP:
|
|
.INDENT 3.0
|
|
.INDENT 3.5
|
|
.sp
|
|
.nf
|
|
.ft C
|
|
$ msrtsimul \-v \-\-seedlink seedlink\-test miniSEED\-file
|
|
.ft P
|
|
.fi
|
|
.UNINDENT
|
|
.UNINDENT
|
|
.UNINDENT
|
|
.SH MODULE CONFIGURATION
|
|
.nf
|
|
\fBetc/defaults/global.cfg\fP
|
|
\fBetc/defaults/msrtsimul.cfg\fP
|
|
\fBetc/global.cfg\fP
|
|
\fBetc/msrtsimul.cfg\fP
|
|
\fB~/.seiscomp/global.cfg\fP
|
|
\fB~/.seiscomp/msrtsimul.cfg\fP
|
|
.fi
|
|
.sp
|
|
.sp
|
|
msrtsimul inherits global options\&.
|
|
.SH COMMAND-LINE OPTIONS
|
|
.sp
|
|
\fBmsrtsimul [OPTION] miniSEED\-file\fP
|
|
.SS Options
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-c, \-\-stdout
|
|
write on standard output. The output my be redirected to a
|
|
specific mseedfifo path.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-d, \-\-delays
|
|
add artificial delays
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-s, \-\-speed float
|
|
speed factor. 1 is normal speed.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-j, \-\-jump float
|
|
minutes to skip at the beginning
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-\-test
|
|
test mode
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-m, \-\-mode string
|
|
playback mode: choose between \(aqrealtime\(aq and \(aqhistoric\(aq
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-\-seedlink string
|
|
the seedlink module name. Useful if a seedlink alias or
|
|
non\-standard names are used. Replaces \(aqseedlink\(aq
|
|
in the standard mseedfifo path.
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-v, \-\-verbose
|
|
verbose mode
|
|
.UNINDENT
|
|
.INDENT 0.0
|
|
.TP
|
|
.B \-h, \-\-help
|
|
display this help message
|
|
.UNINDENT
|
|
.SH AUTHOR
|
|
gempa GmbH, GFZ Potsdam
|
|
.SH COPYRIGHT
|
|
gempa GmbH, GFZ Potsdam
|
|
.\" Generated by docutils manpage writer.
|
|
.
|