/******************************************************************************

  FILE:  nmea_gps.cnt

         This control file is used with the nmea_gps program
         to convert NMEA-formatted GPS fix files to a columnar
         text format suitable for use with the codas3/adcp/nav
         programs, and/or to Mat-file format for Matlab.  In the
         latter case, the data are edited according to the
         given criteria prior to output.

  INPUT:  NMEA-formatted GPS fix files
  OUTPUT: 1. if requested, text file (.gps) with the following columns:
             a. fix time, in decimal days
             b. longitude, in decimal degrees
             c. latitude, in decimal degrees
             d. no. of satellites used
             e. quality index
             f. horizontal dilution of precision (HDOP)
             g. 0, since no dopN
             h. 0, since no dopE
             i. 0, since no dopV
             j. altitude
          2. if requested, one or more Mat-files (.mat or .m?? if more than one)
             with the following arrays:
             a. fix time, in decimal days
             b. longitude, in decimal degrees
             c. latitude, in decimal degrees
             d. no. of satellites used, if requested
             e. horizontal dilution of precision, if requested
-------------------------------------------------------------------------------
  CONTROL FILE STRUCTURE:

  [ YMD_BASE:            < yy/mm/dd for decimal day conversions > ] { 00/01/01 }
  [ TIME_RANGE:          < ALL | yy/mm/dd hh:mm:ss to yy/mm/dd hh:mm:ss > ]
  [ TIME_FILE:           <decimal day time file> ]
  [ OUTPUT_ASCII_FILE:   < none | root for output ASCII filename > ]
  [ OUTPUT_MAT_FILE:     < none | root for output Mat-filename > 
    [ max_HDOP=            < max. allowed HDOP for Mat-file output > ]
    [ subsamples=          < fix sampling rate for Mat-file output > ]
    [ max_mat_array_size=  < maximum no. of fixes per Mat-file > ]
                         { only needed for PC-Matlab (no virtual memory) }
    [ SAVE_NUM_OF_SAT      { output no. of satellites info. to Mat-file } ]
    [ SAVE_HDOP            { output HDOP info. to Mat-file } ]
    [ GAP_INCLUDED         { output bad fixes to Mat-file as NaNs } ]]

  end                    { must always precede INPUT_GPS_FILES: }

  INPUT_GPS_FILES:       { list in chronological order }
    < NMEA-formatted GPS fix filename >
    .
    .
    .
-----------------------------------------------------------------------------*/

  YMD_BASE:             91/01/30
  TIME_RANGE:           91/01/30 22:54:45 to 91/01/30 22:55:00
  OUTPUT_ASCII_FILE:    nmeagps1
  OUTPUT_MAT_FILE:      nmeagps1
    subsamples=         50
    max_HDOP=           6
    SAVE_HDOP
    SAVE_NUM_OF_SAT
    GAP_INCLUDED
  end

  INPUT_GPS_FILES:
    tw17an00.c0

/*****************************************************************************/
