CAPS data file analysis tool


The CAPS server uses the RIFF file format for data archiving. rifftool may be used to analyse the RIFF container, check data integrity, print record statistics and meta data, and to extract raw data stored in the files. The output depends on the selected operational mode and is written to stdout.

rifftool addresses files directly without a request to the CAPS server. This is in contrast to capstool which makes server requests. Hence, rifftool can be used to extract data files to, e.g., in miniSEED format, even if the CAPS server is not operational.




Dump individual RIFF chunks including size, position and meta information specific to individual chunk type.


Dump the CAPS record index organized in a B+ tree (BPT).


Dump the raw data stored in the CAPS records. The format is specific to the record type and different record types may be mixed in one file. E.g., if all records are of type miniSEED then the result will be a miniSEED conform file with the records sorted by sampling time.


Check data integrity by validating the record order. Additional check assertions may be enabled through parameters.


Dump meta data of all records.


Dump data gaps found in a file.


Dump data overlaps found in a file.


  • Dump list of record meta data to stdout

    rifftool records NET.STA.LOC.CHA.2022.000.data
  • Write the raw data stored in the CAPS records to new file

    rifftool data NET.STA.LOC.CHA.2022.000.data > data.mseed
  • Print gaps to stdout

    rifftool gaps NET.STA.LOC.CHA.2022.000.data
  • Check data integrity by validating the record order

    rifftool check NET.STA.LOC.CHA.2022.000.data

Command-Line Options

rifftool [options] mode file

Mode is one of: check, chunks, data, index, gaps, overlaps, records

Check Assertions


Assert data file contains no gaps.


Assert no overlaps in data file.


Assert no data type changes among records of same data file.


Assert no sampling rate change among records of same data file.