scart

Import/export MiniSEED data to/from SDS archives.

Description

The archive tool scart creates playback files (multiplexed MiniSEED files) from SDS structured data (e.g. created by slarchive) or from data passed from another record source such as Arclink. It can also playback records directly out of an SDS structure. Furthermore it can be used to import multiplexed MiniSEED files into a local SDS structure. So it is possible to save event based waveform data in combination with scevtstreams into another archive.

Configuration

scart can make use of RecordStream implementations which are provided by additional plugins. For loading additional plugins, e.g. the xyz plugin create and configure scart.cfg:

plugins = xyz

Examples

  1. Extract data from a local SDS archive into a miniSEED file and sort by endtime:

    scart -dsvE -t '<start-time>~<end-time>' <SDS archive> > file.mseed
    

    Note

    Sorting data is computational expensive but required for waveform playbacks.

  2. Push miniSEED data into a local SDS archive:

    scart  -I file://<file.mseed> <SDS archive>
    
  3. Collect data from an arclink server using the RecordStream interface and write to a miniSEED file. The data streams and the time spans are defined in a list file, e.g. created by scevtstreams.

    scart  -I arclink://<server>:18001 --list list.file --stdout > file.mseed
    

Note

Repeated pushing of miniSEED data into an archive will duplicate the data.

Command-line

scart [options] {archive-dir}

The last option has to be the archive directory when dump mode is enabled. When no archive directory is explicitly given, $SEISCOMP_ROOT/var/lib/archive or the current directory is used depending on whether $SEISCOMP_ROOT has been set or not. The default operation mode is import. That means that a multiplexed MiniSEED file or another record source such as ArcLink is used to import records into a SDS structure.

-I

Specify the recordstream URL when in import mode. When using another recordstream than a file (like ArcLink) a stream list file is required (default is file://- (stdin))

-t timewindow

Specify the time window (as one properly quoted string) to dump records for. Times are UTC and separated by a tilde “~”. To dump one hour of waveform data between 2008/01/01 00:00:00 and 2008/01/01 01:00:00 use <-t “2008-01-01 00:00:00~2008-01-01 01:00:00”>.

-d, --dump

Set export (dump) mode. Records are retrieved from an archive and written to standard output.

-l, --list file

Uses a stream list file instead of defined networks and channels (-n and -c are ignored). Line format: starttime;endtime;streamID. The time format is the same as described in option ‘-t’.

-s, --sort

Sort records by [start-]time. To sort records by their endtime use -E.

-E

Sort records according to their end time (default is start time).

-m, --modify

Modify the record time for real time playback when in export mode. The first record time is NOW. The relative time of successive records to the first one are kept.

--speed

Specify the speed to dump the records. A value of 0 means no delay otherwise speed is a multiplier of the real time difference between the records. When feeding the records directly into the replay pipe a value of 1 (real time) is recommended.

-n networks

Network list of networks to dump (comma separated) (default is *).

-c channels

Specify the channel filter for the dumped streams as regular expression (default is (B|S|M|H)(L|H)(Z|N|E)). To dump only the BHZ, BHN and BHE streams use BH(Z|N|E).

--files count

Specify the number of file handles to cache (default is 100).

-v, --verbose

Verbose mode.

--test

Test mode, no record output. This switch is useful for debugging.

-h, --help

Display a help message.