
fgmvec  --  writing ASCII output of FGM vectors to stdout

USAGE:

 ... | fgmvec [-t <int>] [-a] [-r ] [-m] [-p] [-v] [-f] 
                                              [-i [<cal>]] [-o [<out>]]

 The program reads CLUSTER FGM data (in fgmtvec_t format) from stdin and
 writes the magnetic field vectors as an ASCII listing to stdout.
 Each vector consists of a time string and the three vector components.

 If option -r is used, the number of decimal places of each component will
 depend on the range of the magnetometer, i.e. on the data resolution
 currently used.

OPTIONS:

  -t     print the time information in the following form:
         <int> = 0 : ISO standard time string like '2000-12-02T02:05:15.798Z'
         <int> = 1 : seconds and nanoseconds of the UNIX epoch
         <int> = 2 : (float) seconds of the hour
         <int> = 3 : (float) hours of the day
         <int> = 4 : character string like 'Mon Dec  2 02:05:15 2000'
         Default is the ISO time string.

  -r     choose the number of decimal places according to the data resolution.
         Default is to use a fixed format with a resolution of 0.1 nT.

  -m     add the magnitude to each output vector.

  -p     add the phase (for high-resolution data) or
         the normalized variance of the total magnetic field
         (for averaged data) to each output vector.

  -v     add the raw data variance (for high-resolution data) or 
         the normalized variance of the magnetic field magnitude
         (for averaged data) to each output vector.

  -f     add the data acquisition frequency to each output vector.
 
  -a     output all vectors of the fgmtvec_t stream, even if marked 'BAD'. 
         Adds TM mode, range, sensor, and data flags to each output record.
         A non-zero value in the last column means 'BAD' vector, 0 else.
         Default is to output only non-marked data.
 
  -i     add calibration filename info to output.
         use <cal> as calfile-name logfile. If '-i', but no name given,
         default name is 'cal.log'. Column name info is appended too. 
         
  -o     use <out> as output file. If '-o', but no <out>,
         default name is : C#_yyyymmdd_sys.mag, where #=1,2,3,4 stands for
         satellite number and sys for the output coordinate system. 
         Default output is stdout.

  -V     print the 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)
