scart

The archive tool scart creates replay files (multiplexed MiniSEED files) from SDS structured data (e.g. created by slarchive) or from data passed from another record source (like ArcLink). It can also replay 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.

Commandline options

The last option has to be the archive directory when dump mode is enabled. When no archive directory is explicitly given, $SEISCOMP_ROOT/acquisition/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 (like 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 within. Times are UTC and separated by a tilde “~”. For dumping 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 fetched from an archive and stored in a file (or pipe).

-l, --list <file>

Uses a stream list file instead of defined networks and channels (-n and -c are ignored). Line format: starttime;endtime;streamID

2007-03-28 15:48;2007-03-28 16:18;GE.LAST.*.*
2007-03-28 15:48;2007-03-28 16:18;GE.PMBI..BH?

-s, --sort

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

-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

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).

-E

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

--files

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

-v, --verbose

Verbose mode.

--test

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

-h, --help

Display a help message.

Examples

Creating an one hour replay of waveform data of network GE from archive:

scart -dsvE -t '2008-09-01 15:00~2008-09-01 16:00' -n GE /home/sysop/seiscomp3/acquisition/archive > mseed.sorted

Creating a replay using a stream list:

[streams.lst]
2008-09-21 13:26:07;2008-09-21 13:56:39;GE.MALT.*.BH?
scart -dsv --list streams.lst /home/sysop/seiscomp3/acquisition/archive > mseed.sorted

Creating a local SDS archive structure with data fetched from ArcLink. NOTE: ArcLink does not support wildcards for the location code when a station has no location code. It has to be left empty.

[streams.lst]
2008-09-21 13:26:07;2008-09-21 13:56:39;GE.MALT..BH?
scart -v -I arclink://localhost:18001 --list streams.lst ./my_local_archive