scGetTimePeriod

  scGetTimePeriod returns the data for a specified time period

  Data are returned for the period START <= t < STOP

  Example:
  DATAOUT=scGetTimePeriod(DATAIN, START, STOP)
  DATAOUT=scGetTimePeriod(DATAIN, [START STOP])

  DATAIN is a sigTOOL channel array or element
  START and STOP are the times (in seconds) marking the beginning and end
        of the required time window.

  DATAOUT is a sigTOOL channel array containing scchannel objects.
  Waveform data in DATAOUT will be trimmed to the limits START <= t < STOP.
  When the channel is a 'Custom' channeltype, all epochs with
  START <= tim(:,1) < STOP will be returned.
  The epochs are defined by the highest dimension of adc.

  ADCARRAY and TSTAMP objects in DATAIN will be returned as double 
  in DATAOUT

  See also ADCARRAY, TSTAMP

  Toolboxes required: None

 -------------------------------------------------------------------------
  Author: Malcolm Lidierth 09/06
  Copyright © The Author & King’s College London 2006-2007
 -------------------------------------------------------------------------

  Acknowledgements:
  Revisions: