Note on the format of the WinRiverII ASCII classic output file in

Matlab

The classic ASCII output format is read by readData_V1.m (an adaptation of the tfile.m
function from the VMT software - a Matlab based toolbox - developed by USGS).

N.B.: For this script to run, the MCR (Matlab Compiler Runtime) needs to be > version 7.17

The output of this script is a ‘super structure’ called A. This structure classes all the
variables from the ASCII file so that it can easily be accessed for further processing.

The structure can be divided into four main groups as shown in the table below:

A.Sup Contains general information about the measurement.

A.Wat Contains water-related information
A.Nav Contains navigation information
A.Sensor Contains ADCP sensor information
A.Q Contains discharge information

The table below lists the parameters contained in each sub-section:

A.Sup A.Wat A.Nav A.Sensor A.Q

absorption_dbpm binDepth bvEast pitch_deg endDepth
bins backscatter bvError roll_deg endDist
binsize_cm vDir bvNorth heading_deg bot
nbins vMag bvVert temp_degC end
blank_cm vEast depth meas
draft_cm vError dsDepth start
ensNo vNorth dmg top
nPings vVert length unit
noEnsinSeg percentGood totDistEast startDepth
noe totDistNorth startDist
note1 altitude
note2 altitudeChng
intScalefact_dbpcnt gpsTotdist
intUnits gpsVariable
vRef gpsVeast
wm gpsVnorth
units lat_deg
year long_deg
month nSats
day hdop
hour
minute
second
 sec100
timeElapsed_sec
timeDelta_sec100

Explanation of the variables:

A.Sup.(…)

absorption_dbpm SOUND ABSORPTION FACTOR – in dB/m

bins NUMBER OF BINS TO FOLLOW
binSize_cm size of bins (cm) DEPTH CELL LENGTH (cm)
nBins NUMBER OF DEPTH CELLS
blank_cm blank after transmit (cm)
draft_cm ADCP DEPTH FROM CONFIGURATION NODE (cm)
ensNo ENSEMBLE NUMBER (or SEGMENT NUMBER for processed or averaged
raw data)
nPings NUMBER OF PINGS PER ENSEMBLE
noEnsInSeg NUMBER OF ENSEMBLES IN SEGMENT (if averaging ON or processing
data)
noe
intScaleFact_dbpcnt INTENSITY SCALE FACTOR – in dB/count
intUnits INTENSITY UNITS - dB or counts
vRef VELOCITY REFERENCE – BT, GGA, VTG, or NONE for current velocity
data rows 7-26 fields 2-7
wm Profiling mode
units MEASUREMENT UNIT – cm or ft
timeElapsed_sec TOTAL ELAPSED TIME – Through this ensemble (in seconds)
timeDelta_sec100 TIME PER ENSEMBLE (hundredths of seconds)

A.Wat.(…)

binDepth DEPTH – Corresponds to depth of data for present bin

(depth
cell); includes ADCP depth and blanking value; in m or ft.
backscatter: Has the information of Beam intensity
the 4 beams in a 3D matrix
vDir VELOCITY DIRECTION
vMag VELOCITY MAGNITUDE
vEast EAST VELOCITY COMPONENT – East(+)/West(-)
vError ERROR VELOCITY
vNorth NORTH VELOCITY COMPONENT - North(+)/South(-)
vVert VERTICAL VELOCITY COMPONENT - Up(+)/Down(-)
percentGood % good
A.Nav.(…)

bvEast BOTTOM-TRACK VELOCITY – GPS (GGA or VTG) Velocity (calculated from

GGA String). Reference = GGA East(+)/West (-1)
bvError BOTTOM-TRACK VELOCITY - BT Error
bvNorth BOTTOM-TRACK VELOCITY Reference = VTG - GPS (GGA or VTG).
North(+)/South(-) Velocity
bvVert BOTTOM-TRACK VELOCITY Reference = VTG - GPS (GGA or VTG). BT
(up[+]/down[-]) Velocity
depth (of the 4 DEPTH READING – Beam average for this ensemble (m or ft, as
beam -> 4 columns set by user)
matrix)
dsDepth GPS/DEPTH SOUNDER - corrected bottom depth from depth sounder (m
or ft)
dmg TOTAL DISTANCE MADE GOOD – Through this ensemble (from
bottomtrack
or GPS data in m or ft)
length TOTAL ELAPSED DISTANCE - Through this ensemble (from bottom track
or GPS data; in m or ft)
totDistEast TOTAL DISTANCED TRAVELED EAST (m or ft, as set by user)
totDistNorth TOTAL DISTANCED TRAVELED NORTH (m or ft, as set by user)
altitude GPS/DEPTH SOUNDER GGA altitude (m or ft)
altitudeChng GPS/DEPTH SOUNDER GGA Δaltitude (max – min, in m or ft)
gpsTotDist CANNOT MAKE OUT WHAT IT IS
gpsVariable GPS/DEPTH SOUNDER - GGA HDOP x 10 + # satillites/100 (negative
value if invalid for ensemble)
gpsVeast CANNOT MAKE OUT WHAT IT IS
gpsVnorth CANNOT MAKE OUT WHAT IT IS
lat_deg Latitude (degrees and decimal degrees)
long_deg Longitude (degrees and decimal degrees)
nSats
hdop Horizontal Dilution of Precision

A.Sensor.(…)

pitch_deg PITCH – Average for this ensemble (degrees)

roll_deg ROLL – Average for this ensemble (degrees)
heading_deg CORRECTED HEADING - Average ADCP heading (corrected for one cycle error) +
heading offset + magnetic variation
temp_degC ADCP TEMPERATURE - Average for this ensemble (°C)

A.Q.(…)

endDepth Ending depth of middle layer (or starting depth of bottom layer); m or ft
endDist Ending distance (boat to shore); m or ft
bot Bottom part of profile (estimated); m3/s (Discharge)
end End-shore discharge estimate; m3/s
meas Middle part of profile (measured); m3/s (Discharge)
start Start-shore discharge estimate; m3/s
top Top part of profile (estimated); m3/s (Discharge)
unit Value corresponding to no flow measurements (i.e. 2147483647)
startDepth Starting depth of middle layer (or endingdepth of top layer); m
startDist Starting distance (boat to shore); m