GOES Data Format:

CAUTION: This data is collected from the USGS in real-time without any quality
         control checking.  So the data will not always be accurate.

Station IDs:

  dtr = Detroit River Sontek Meter
  scr = St Clair River Sontek Meter
  smr = St Marys River
  lnr = Lower Niagara River
  slm = St Lawrence River Morristown


Directories:

  raw  = Raw data from GOES message downloads (cf. LRGS Client Guide)
  data = Decoded data text files


Data format for dtr, scr, and smr data:

    File name convention:

      First three characters of file name are the station ID
      Then date in YYYYMMDD format (4 digit year, 2 digit month, 2 digit day)
      Then file name suffix .raw for raw data files, .dat for formatted text files

      Example data file names:
      goes/dtr/raw/dtr20120824.raw
      goes/dtr/data/dtr20120824.dat


    Data file format:

      Each line contains data in columns as follows:

      YYYYMMDD HHMMSS TTTT.TT VVVV.VV

      where YYYYMMDD = year, month, day
            HHMMSS   = hour, minute, second (UTC)
            TTTT.TT  = temperature, F
            VVVV.VV  = velocity, ft/sec

      Example data:

      20120824 040030   74.37    2.58
      20120824 040630   74.35    2.56
      20120824 041230   74.33    2.63


Data format for lnr and slm data:

    File name convention:

        For raw data files:
            First three characters of file name are the station ID
            then date in YYYYMMDD format (4 digit year, 2 digit month, 2 digit day)
            then file name suffix .raw

            Example:
            goes/lnr/raw/lnr20191231.raw

        For daily data files:
            First three characters of file name are the station ID
            then an underscore character (_)
            then the data type followed by an underscore (_)
                "vel" for X velocity in m/s
                "hgt" for gauge height in meters
                "tmp" for water temperature in C
            then date in YYYYMMDD format (4 digit year, 2 digit month, 2 digit day)
            then file name suffix .dat

            Examples:
            goes/lnr/data/lnr_vel_20191231.dat
            goes/lnr/data/lnr_hgt_20191231.dat
            goes/lnr/data/lnr_tmp_20191231.dat

        For yearly comma-separated-value (CSV) files:
            Starts with a digit and a dash (-) character (to put it at the top of the file listing):
                1- for velocity data
                2- for orifice data
                3- for temperature data
            then the station ID followed by an underscore (_)
            then the data type followed by an underscore (_)
                "vel" for X velocity in m/s
                "hgt" for gauge height in meters
                "tmp" for water temperature in C
            then the word "data"
            then file name suffix .csv

            Examples:
            goes/lnr/data/1-lnr_vel_data.csv
            goes/lnr/data/2-lnr_hgt_data.csv
            goes/lnr/data/3-lnr_tmp_data.csv

    Data file format:

      Each line contains data in comma-separated-values:

      YYYY/MM/DD HH:MM, X

      where YYYY/MM/DD = year, month, day
            HH:MM      = hour, minute (UTC)
            X          = data value:
                           vel = Velocity in m/s
                           hgt = Gauge Height in meters
                           tmp = Temperature in C

      Example data:

      2019/12/31 12:00,  1.105
      2019/12/31 12:06,  1.105
      2019/12/31 12:12,  1.064