$Id: Readme.txt 2295 2016-12-06 15:22:16Z lendl $

This directory contains Cube examples useful for (unit-) testing the
'cubeinfo' GIPPtools utility.


Test 001 -- Single channel data
-------------------------------

  Plain and simple 100Hz, one channel Cube file as recorded by Cube #45.
  No special cases, no silly surprises.

  Note: About 90% of the original recording were removed (and the trailer block
        was adjusted accordingly) to speed up testing.

    001-single-channel.cube ...... Cube input file.
    001-single-channel.summary ... Textual summary of the Cube file.


Test 002 -- Three channel data
------------------------------

  Three channel data in Cube file format. The purpose of this example file
  is to see if the library routines can handle more than one channel.

  Note: As in the previous test case, a large chunk of the original recording
        was removed (of course without compromising the file integrity) to
        speed up testing.

    002-three-channes.cube ....... Cube input file.
    002-three-channels.summary ... Textual summary of the Cube file.

  (The data was recorded by an early prototype of a future three channel unit.)


Test 003 -- Cut-off Cube file
-----------------------------

  A Cube file without 'trailer' and 'end-of-file' block. (Actually, the
  file ends in the middle of a sample value.) Similar files are occasionally
  to be expected when the Cubes see some usage in the field. (Due to e.g.
  a full file system, a corrupted file system, power failures, defect SD-Cards
  and similar problems.)

    003-missing-trailer.cube ...... Cube input file.
    003-missing-trailer.info ...... Short description of the Cube file.
    003-missing-trailer.summary ... Textual summary of the Cube file.


Test 004 -- Cube file with an auxiliary channel
-----------------------------------------------

  A Cube file containing a simple auxiliary channel (just a counter).  
  
  Note: Another "new" thing is the (single) "GPS on" event at the beginning 
        of the file. 
  
    004-aux-channel.cube ...... Cube input file.
    004-aux-channel.dump ...... A dump of the Cube file.
    004-aux-channel.summary ... Textual summary of the Cube file.
  
  ToDo:  Replace the test file by a smaller but more complex example file!


Test 005 -- Cube file with atomic clock as time source
------------------------------------------------------

  Cubes can use various hardware as time base. This Cube input file contains
  an recording, where the source of time information is switch from a GPS 
  receiver to a  "chip scaled atomic clock" (CSAC) during recording.

    005-atomic-clock.cube ... Cube input file.
    005-atomic-clock.dump ... A dump of the input file.
    005-atomic-clock.gps .... The time information contained in the TAIP blocks.


Test 006 -- Begin recording without obtaining GPS fix first
-----------------------------------------------------------

  Cubes may start recording data immediately after power on and BEFORE a first
  GPS fix is obtained! ('ACQ_ON=1') 
  
  This results in Cube files that contain "fake" GPS time tags (from the 
  internal GPS hardware clock) until a first satellite fix can be obtained. 
  For processing with e.g. 'cube2mseed' or 'cube2ascii' these time tags will
  be silently ignored. However, 'cubeinfo --format=GPS' will report the tags.

    006-immediate-recording.cube .. Cube input file.
    006-immediate-recording.gps ... The time information contained in the TAIP
                                    blocks.

                                    