MiniSEED real time playback and simulation
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.
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 faked. Historic playbacks allow keeping the actual data times.
For real-time playbacks, the data must be sorted by time. This requirement may be violated. Use scmssort to sort the data by time.
You may use msrtsimul with the
-m historic option to maintain the time of the records,
thus the times of picks, amplitudes, origins, etc. but not the creation times.
-m historic 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.
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
--playback option. Example:
$ seiscomp stop $ rm -rf $SEISCOMP_ROOT/var/lib/seedlink/buffer $ seiscomp start $ msrtsimul ...
Playback miniSEED waveforms in real time with verbose output:
$ msrtsimul -v miniSEED-file
Playback miniSEED waveforms in historic mode. This may require scautopick to be started with the option playback:
$ msrtsimul -v -m historic miniSEED-file
Feed the data into the buffer of a specific seedlink instance, e.g. seedlink-test:
$ msrtsimul -v --seedlink seedlink-test miniSEED-file
msrtsimul inherits global options.
msrtsimul [OPTION] miniSEED-file
- -c, --stdout¶
write on standard output. The output my be redirected to a specific mseedfifo path.
- -d, --delays¶
add artificial delays
- -s, --speed float¶
speed factor. 1 is normal speed.
- -j, --jump float¶
minutes to skip at the beginning
- -m, --mode string¶
playback mode: choose between ‘realtime’ and ‘historic’
the seedlink module name. Useful if a seedlink alias or non-standard names are used. Replaces ‘seedlink’ in the standard mseedfifo path.
- -v, --verbose¶
- -h, --help¶
display this help message