Copyright (C) 1994/95/96/2000/01 IGM TU Braunschweig, MPE Garching

fgmdp  --  generate high resolution or averaged CLUSTER FGM data

USAGE:

 fgmdp [<inf>...] [-b <begin>] [-e <end>] [-a <attf>] [-p [<posf>]]
       [-E <eclf>] [ -w [<float>]] [-i] [-x] [-l [<logf>]] [-o [<outf>]]
            
 fgmdp generates high resolution magnetic field vectors in GSE  
                 or averages over a user defined time interval. 
          
 The input file is a normal or burst mode science data file containing
 the raw FGM data, like those distributed on the raw data media (RDM).
 More than one input file may be specified to concatenate data. If no
 input file is given, the data will be read from stdin.  If option '-w'
 not used, default output is high resolution. The default output format
 is binary igm-structure. Use option '-x' to get an ASCII file. 
 ASCII output contains date/time, components of the magnetic field in [nT]
 and position vector components [km] in GSE coordinate system

OPTIONS:

  -b <begin> define the begin of time interval for the output
  
  -e <end>   define the end of time interval for the output

             The following formats may be used for the  <begin> and <end> 
             strings:
                ISO standard, like '2000-09-01T12:00:04.012Z'
                ISO standard, without date, like 'T12:00:04.012Z'
                seconds of the UNIX epoch, like '978420804.012443596'.

  -w <float>  compute averages over <float> seconds. Averaging intervals start 
              at full UT second. <float> must be larger then the sampling. 
              If option '-w' present, but no <float> specified, 
              spin-averages (PPs) are produced  (spin-offset= 26.3671875 deg).

     <float>  float number specifying the length of an averaging 
              interval in seconds. Fractions of seconds are taken into 
              account only for subunitary numbers.
              
  -a   use <attf> as attitude file. <attf> may contain DDS-headers, i.e.
       the raw attitude file from CDROM (*ga*) may be used.
       Default is to use the merged attitude file '$SATTPATH/satt.cl#',
       #=1,2,3,4 is the satellite number.

  -p   use <posfile> as orbit file (*ba* on the CDROM)for determing the 
       spacecraft's position. The file may, or may not contain DDS-headers. 
       Default is to use the short term orbit file `$ORBITPATH/stof.cl#', 
       (#=1,2,3,4) with DDS-headers beeing removed.
       If -p is used but <posfile> is omitted, the preprocessed long term 
       orbit file `$ORBITPATH/ltof.cl#' will be used.

  -E   read eclipse info from file <eclf>. <eclf> may contain DDS-headers, i.e.
       the raw attitude file from CDROM (*ta*) may be used.
       Default is '$SATTPATH/s{|l}tef.cl#', where #=1,2,3,4.

  -x   ASCII output; default output is binary IGM-format
  
  -i   append calfilename-info to the end of the ASCII output; to be used
       together with option '-x'. Default is to have the used calibration 
       file-name written in a separate file: 'cal.log'. A tailstring
       containing output column names is appended too.        

  -l   re-direct info from stderr to a logfile <logf>;
       if option '-l', but no filename given, default is: 'logfile' 
  
  -o   use <outf> as output file. Default is to write to a file called :
       C#_yyyymmdd_sys.igm or C#_yyyymmdd_sys.txt (if '-x'), 
       where #=1,2,3,4 stands for satellite number and sys for the output 
       coordinate system.

  -V   print version number on stdout, then exit.

AUTHORS:
 
 Edita Georgescu      (eg@mpe.mpg.de)
 Karl-Heinz Fornacon  (k-h.fornacon@tu-bs.de)
 Stephan Buchert      (scb@stelab.nagoya-u.ac.jp)
