
fgmpos  --  add mission-id and position to CLUSTER FGM data

USAGE:

  ... | fgmpos [-p [<posfile>]] [-o [outfile]]

  The program reads CLUSTER FGM vectors (in fgmtvec_t format) from stdin
  and adds a mission identifier and the spacecraft's position, creating
  output in a common format for spacecraft magnetometer data used at
  the Institute of Geophysics and Meteorology of TU Braunschweig.

  The coordinate system used for the magnetic field vectors may be one
  of `scs', `gse', `gsm', `sm', or `j2k'.  For the spacecraft positions,
  the same coordinate system will be used, unless in case of `scs', where
  the positions will be given in `gse'.

OPTIONS:

  -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.

  -o     use <outfile> as the output file. If '-o', but no <outfile> given,
         default name is : C#_yyyymmdd_sys.igm, where #=1,2,3,4 stands for
         satellite number and sys for the output coordinate system. 
         Default is to write to stdout.

  -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@igpp.ucla.edu)
