.. ......................................
.. UHDAS/CODAS restructured text document
.. ......................................


.. _agetmat_output:




agetmat output variables
~~~~~~~~~~~~~~~~~~~~~~~~

1) These are the most useful variables in the
   processed 5-minute averages:

::


 data =
         dday: [1x1436 double]         zero-based UTC decimal day
          lon: [1x1436 double]         decimal longitude
          lat: [1x1436 double]         decimal latitude
      heading: [1x1436 double]         original heading, likely a gyro
          amp: [50x1436 double]        average signal/noise amplitude (counts)
         bins: [1x50 double]           bins (for convenience)
            z: [50x1 double]           nominal vertical depth (same as 'depth')
      uabs_sm: [50x1436 double]        --\  ocean velocity in earth coords
      vabs_sm: [50x1436 double]        --/  using smoothed navigation
     uship_sm: [1x1436 double]         --\  ship velocity in earth coords
     vship_sm: [1x1436 double]         --/  using smoothed navigation
        smmps: [1x1436 double]         ship speed from smoothed navigation


2) These are all the variables in the processed 5-minute averages:


::

 data =
         dday: [1x1436 double]         zero-based UTC decimal day
          lon: [1x1436 double]         decimal longitude
          lat: [1x1436 double]         decimal latitude
      iblkprf: [1436x2 double]         (database block and profile index)
      heading: [1x1436 double]         original heading, likely a gyro
 corr_heading: [1x1436 double]         corrected heading (eg. ashtech)
         time: [1436x6 double]         y,m,d,h,m,s UTC
           pg: [50x1436 double]        per bin, percent good in the avg
        depth: [50x1436 double]        nominal vertical depth
        pflag: [50x1436 double]        0 = good data; nonzero = code for bad
          amp: [50x1436 double]        average signal/noise amplitude (counts)
           sw: [50x1436 double]        spectral width (if OS or BB)
        umeas: [50x1436 double]        --\  measured velocity in
        vmeas: [50x1436 double]        --/  earth coordinates (east, north)
            w: [50x1436 double]        vertical velocity (NOT FOR SCIENCE!!)
        wmean: [1x1436 double]         mean w in a reference layer
            e: [50x1436 double]        error velocity
         bins: [1x50 double]           bins (for convenience)
            z: [50x1 double]           nominal vertical depth (same as 'depth')
      uabs_sm: [50x1436 double]        --\  ocean velocity in earth coords
      vabs_sm: [50x1436 double]        --/  using smoothed navigation
  uabs_rawnav: [50x1436 double]        --\  ocean velocity in earth coords
  vabs_rawnav: [50x1436 double]        --/  using original navigation
        uship: [1x1436 double]         --\  ship velocity in earth coords
        vship: [1x1436 double]         --/  using original navigation
     uship_sm: [1x1436 double]         --\  ship velocity in earth coords
     vship_sm: [1x1436 double]         --/  using smoothed navigation
           uv: [1x1 struct]            (diagnistics; part of refsm)
          nav: [1x1 struct]            (diagnostics; part of refsm)
      ref_std: [1x1436 double]         "jitter"
        smmps: [1x1436 double]         ship speed from smoothed navigation
            x: [1x1436 double]         displacement in meters (east)
            y: [1x1436 double]         displacement in meters (north)
        smcog: [1x1436 double]         course over ground from smoothed nav
       rawmps: [1x1436 double]         ship speed from orignal navigation
        fmeas: [50x1436 double]        measured velocity in ship's dirction
        pmeas: [50x1436 double]        measured velocity in port direction
      fabs_sm: [50x1436 double]        ocean velocity in ship's direction
      pabs_sm: [50x1436 double]        ocean velocity in port direction