
This directory contains various test cases useful for (unit-) testing the
miniSEED to SEG-Y format conversion.


Test 001 -- Creating shot and receiver gathers
----------------------------------------------

  Straightforward miniSEED to SEG-Y conversion. No gaps in the time series
  data, no unexpected channel names nor any other silly surprises.

  001-project.txt         The 'project' file describing the experiment geometry.
                          Contains the locations and times for the shot and
                          receiver points used for testing.

  001-miniseed            Directory containing 36 miniSEED snippets (each 2 min
                          long) that are used as input to the conversion.

  001-segy-standard       The expected, various shot and receiver gathers in
                          "standard" SEG-Y format.

  001-seismicunix-native  The expected, various shot and receiver gathers in
                          (old) native "Seismic Unix" format.


  Note: The example data was taken from the "Karoo" project recorded in
        November 2005.


Test 002 -- Creating shot and receiver gathers
----------------------------------------------

  Straightforward miniSEED to SEG-Y conversion. No gaps in the time series
  data, no unexpected channel names or any other silly surprises.

    Input files:

  002-project.txt          The 'project' file containing the experiment
                           geometry and the shot times.
  002-miniseed             Directory containing the respective miniSEED input.

    The expected shot and receiver gathers:

  002-segy-standard        "Standard" SEG-Y format.
  002-seismicunix-native   Native Seismic Unix format.
  002-seismicunix-xdr      (New) Seismic Unix XDR format.


  Note: The used input data was originally recorded by Cubes during the
        CyprusArc Experiment (2010) and converted to miniSEED format for
        this test. There is an analog test case for the 'cube2segy' utility.
        
        
Test 003 -- MiniSEED input containing gaps
------------------------------------------

  Attempted conversion of three miniSEED traces to SEG-Y. The problem is with
  the second trace, where the recorded miniSEED data contains some data gaps.
  (Hence the three separate files for station 'D040'.)
  In the end, there is not enough continuous (!) data for the conversion and
  the resulting SEG-Y file only contains two traces.
  
    Input files:

  003-project.txt          The 'project' file containing the experiment
                           geometry and the shot times.

  003-miniseed             Directory containing the respective miniSEED input.

      The expected shot and receiver gathers:

  003-segy-standard        Directory containing "standard" SEG-Y format output.


  Note: The used input data was taken from the AlpArray (2019) experiment. It
        crashed the 2019 releases of 'mseed2segy' because the faulty second
        trace was not handled correctly.


Test 004 -- Multiplexed miniSEED input
--------------------------------------

  Test how the 'mseed2segy' utility handles "problematic" miniSEED input.

  This check uses the same miniSEED input as Test 001 (see above) but the
  individual records were manually re-ordered (to one degree or another)
  and finally placed in one file per recorder:

    chunked.mseed
      The three recording channels of recorder 'e3130' are ordered channel
      by channel in the file. Reading the file results in nine continuous
      time series, three for each channel.

    reversed.mseed:
      Similar to the chunked recording above, but for station 'e3185'.
      However, the youngest time series segments are located at the
      beginning of the file! (The later (timewise) a chunk was recorded,
      the further back in the file it is positioned.)
      This ordering results in a somewhat reversed time axis in the file.
      The records of each time-series itself are of course "normal". Only
      complete segments were reordered.

    multiplexed.mseed:
      The three recording channels of 'e3132' are multiplexed record by
      record. (A record of the first channel is followed by one record for
      the second channel, which is followed by a record from the third
      channel. Then it starts with the first channel again.)

    random.mseed:
      The order of the miniSEED records of station 'e3168' was completely
      randomized! (For an ultimate challenge... ;-) )

  For the expected shot and receiver gathers as well as the project file
  see the respective subdirectories and files of 'Test 001' above.
