SONGetEventChannel

  SONGETEVENTCHANNEL reads an event channel from a SON file

  DATA{, H}]=SONGETEVENTCHANNEL(FID, CHAN{, START{, STOP{, OPTIONS}}})

  FID is the matlab file handle and chan is the channel number (1-max)
  If START/STOP are absent, all data is read. When present, START or
  START and STOP together set the disc blocks to read. This allows large
  data files to be read in parts.
  OPTIONS, if present, must be a cell array of strings and must be the last
  argument in the list. Valid options:
  'ticks', 'microseconds', 'milliseconds', 'seconds' (default). Other
  options will be ignored.

  DATA is returned as a double precision array with the timestamps,
  in units determined by OPTIONS. H, if present, is returned with the
  channel header.

  e.g.
  [data,h]=SONGetEventChannel(fid, 1, 10, 11, 'microseconds')
      reads Block 10-11 of Channel 1 and returns that data in microseconds
  [data,h]=SONGetEventChannel(fid, 1, 'ticks')
      reads all blocks returning data in clock ticks

  See also SONGetMarkerChannel, SONGetADCMarkerChannel,
  SONGetRealMarkerChannel, SONGetTextMarkerChannel

  Malcolm Lidierth 02/02
  Updated 10/06 ML
  Copyright © The Author & King's College London 2002-2006