
fgmcut  --  cut out vectors of CLUSTER FGM data

USAGE:

 ... | fgmcut [-b <beginning>] [-e <end>] [-x]
              [-s <sc>] [-a <adc>] [-r <range>] [-u <unit>] | ...

 The program reads CLUSTER FGM data (in fgmtvec_t format) from stdin, compares
 each vector's time with the specified time interval, and writes only those
 vectors to stdout which fall into this time period. 

 If the modifier `-x' is set, the mode of operation is inverted: only vectors
 which do not fall into the specified time period are written to stdout.
 Thus, the given time interval is excluded from the data stream.

 In both cases, the time interval is inclusive, i.e., the times <beginning>
 and <end> belong to the time interval that is cut out or excluded.

 When specifying `sc', `adc', `range' or `sensor' only those vectors will be
 written to stdout that have the specified setting for this parameter.

OPTIONS:

  -b   let the string <beginning> specify the beginning of the time interval.

  -e   let the string <end> specify the end of the time interval.

       The following formats may be used for these strings:

       If the string contains the letter `T', it will be interpreted as 
       an ISO time string like `2004-09-01T12:00:04.012Z'.
       If the date is omitted, i.e. the string starts with a `T', the date
       is being adopted from the time stamp of the first input vector.
       If the string does not contain any `T', it will be interpreted as
       seconds of the UNIX epoch, like `778420804.012443596'.

  -x   switch to `excluding' mode.

  -s   write only vectors from spacecraft <sc> (1-4).

  -a   write only vectors measured with ADC number <adc>.
       0 = default ADC unit, 1 = spare ADC unit

  -r   write only vectors with range <range> (1-7).

  -u   write only vectors from the sensor <unit>.
       0 = outboard sensor unit, 1 = inboard sensor unit

  -V   print version number on stdout, then exit.

AUTHORS:

 Edita Georgescu  (eg@mpe.mpg.de)
 Stephan Buchert  (scb@geophys.nat.tu-bs.de)
 Reinhold Kempen  (reinhold@geophys.nat.tu-bs.de)
 Joerg Warnecke   (joerg@geophys.nat.tu-bs.de)
