WinADCP User Guide
WinADCP User Guide
Users Guide
RD Instruments
Acoustic Doppler Solutions
Table of Contents
1
Introduction ....................................................................................................................................... 1
1.1
1.2
System Requirements.........................................................................................................................1
Software Installation............................................................................................................................2
Chart Options.................................................................................................................................. 12
3.1
3.2
3.3
3.4
3.5
Contour .............................................................................................................................................19
Profile................................................................................................................................................21
Series/Ancillary .................................................................................................................................22
List of Figures
Figure 1.
Figure 2.
Figure 3.
Figure 4.
Figure 5.
Figure 6.
Figure 7.
Figure 8.
Figure 9.
Figure 10.
Figure 11.
Figure 12.
Figure 13.
Figure 14.
Figure 15.
Figure 16.
Figure 17.
Figure 18.
NOTES
Introduction
This guide is an overview on using the WinADCP software provided with your
system.
NOTE. This guide covers version 1.11 or earlier.
1.1
System Requirements
WinADCP requires the following:
Windows 95, Windows 98, or Windows NT 4.0 with Service
Pack 4 installed
NOTE. Install all critical software updates from Microsoft before installing
WinADCP.
page 1
1.2
Software Installation
To install the software, do the following.
a. Insert the compact disc into your CD-ROM drive and then follow the
browser instructions on your screen. If the browser does not appear, complete Steps b through d.
b. Click the Start button, and then click Run.
c. Type <drive>:launch. For example, if your CD-ROM drive is drive D, type
d:launch.
d. Follow the browser instructions on your screen.
Once, installed, you will have a shortcut added to your Windows Start menu.
The Winadcp shortcut will start WinADCP.
NOTE. The default directory for WinADCP installation is C:\program
files\RD Instruments\Winadcp.
Using WinADCP
WinADCP is a software package for use with RDI Acoustic Doppler Current
Profilers. This software package supports both the Narrowband and the Broadband/Workhorse Binary Output Data Formats.
In general, WinADCP gives the user a visual sense of the entire set of data. It
also allows the user to zoom in on a portion of the data for closer analysis.
2.1
2.2
Whole Set
WinADCP has two main graphic display forms. The form located in the upper
right portion of the screen is called the Whole Set. The form located across the
bottom half of the display is called the Sub Set. Each of these forms displays a
portion of the entire data set as a color contour. In addition to the color contour,
Sub Set displays the user selected Profile, Series, and Ancillary data.
page 2
RD Instruments
The Whole Set form is displayed in the upper right-hand portion of WinADCP.
When a file containing a Binary Output Data Format is opened, the entire set of
the selected data type is displayed as a color contour located within the Whole
Set form.
2.3
Figure 1.
Whole Set
Figure 2.
Sub Set
Selected Set
By holding down the Spacebar and then pressing the Left mouse button, the
user can drag the mouse to select a portion of the entire data set. When the
mouse button is released, the selected portion of the Whole Set is marked by a
blinking box outline. The blinking box outlines a set of data called the Selected
Set. A second blinking box is also created when the mouse is released. This
second box is striped or solid depending on your graphics card. The solid blinking box marks a region of data called the Sub Set. The width of the Sub Set
box may not be as wide as the Selected Set box. The width of the Sub Set is
dependent upon the Options, Ensembles setting selected from the main menu.
page 3
Figure 1, page 3 shows an example of the Whole Set contour display. The Sub
Set contour display is identical except it does not show the Selected and Sub
Set ensemble numbers (located in the upper right corner of the chart).
Figure 3.
2.4
Selected Set
Profile Chart
The Profile chart, located on the left side of the Sub Set form, displays a user
selected ensemble in several two dimensional (2D) charts. Each of these sub
charts contains a different data type taken from the ensemble. The user can
select the profile ensemble by double clicking the left mouse button just above
or just below the Sub Set color contour.
NOTE. Use the left and right keyboard arrows to scroll through the
ensembles. Use the Animate menu to automatically scroll through the
data file. To quickly select an ensemble, double-click a point just above or
below the Sub Set color contour plot.
Figure 4.
page 4
Profile Chart
RD Instruments
2.5
Series Chart
The Series and Ancillary chart, located in the lower left-hand portion of Sub
Set, displays user selected bins of user selected data types. In addition, the user
may select any of the ancillary data types for display in this chart.
The candle chart shows the statistical information about the series chart. Use
the Options, Chart Options menu to select the Averaging Interval. The candle chart will be centered on the averaging interval.
The red line is the mean
The middle rectangle shape is the Standard Deviation
The long line shows the minimum and maximum values
NOTE. Double-click the candle chart to display the Series Trend and
Residuals chart.
NOTE. Use the up and down keyboard arrows to scroll through the bins.
Use the Animate menu to automatically scroll through the data file. To
quickly select multiple bins, double-click a point just to the left or right of
the color contour plot on the Sub Set color contour plot. Double clicking
the same point will unselect the bin.
Figure 5.
Figure 6.
page 5
2.6
Figure 7.
The Track Vector Time Series window has its own menu.
Exits the Track Vector Time Series window. To display the window
again, click Window, Track Vector.
Exit
Choose Go to animate the chart. Stop will stop the animation and
Rewind will rewind the chart to the beginning of the file.
Animate
Projection
page 6
RD Instruments
Clicking Display will let you choose the Units, and Font for the display. Selecting Time Origin on Left will toggle the time origin being displayed
on the right, to the left side of the display.
Display
Clicking anywhere on the Track Vector Time Series display will display the
Chart Options menu, Series tab. Choose the bins to display by selecting the
bin box on the list.
NOTE. The Animation and Reference menus are disabled on the Track
Vector window when the Monitor mode is enabled. All other menus are
available.
Negative range numbers are shown when the system is downward facing
(bins are below transducer). If the system is upward facing the range
numbers are positive.
2.7
Saving Files
The Selected and Sub Set plots may be saved to new data files as needed.
2.7.1
page 7
2.7.2
2.8
Printing Charts
Charts may be copied to the Windows clipboard so that they may be pasted or
printed in other programs.
a. On the Edit menu, click Copy.
b. Select either the Whole Set or the Sub Set.
c. The chart will be placed on the Windows clipboard.
d. Open the graphic program (or Word) and select Edit, Paste.
e. Use the graphic program (or Word) to print the chart.
NOTE. If you use the Edit, MSPAINT menu the Whole Set or Sub Set will
be placed as a Bit Map image on the Windows clipboard and will open the
Microsoft Paint program. In Paint, select Edit, Paste to display the Bit
Map.
The shortcut to the Microsoft Paint program expects the program to be in
the default directory C:\Windows.
page 8
RD Instruments
2.9
Flip
Selecting Flip from the Edit menu causes the file to be re-read with the orientation bit inverted. In other words, an upward facing data set appears as a downward set when Flip is clicked.
2.10
Data Viewer
When the Mouse is positioned over a point within the Sub Set color contour
charts, data associated with the bin and ensemble are shown on the Viewer
form. If the Viewer is not visible, select the Window menu and click on
Viewer. A sample of the Viewer is shown below.
Figure 8.
Data Viewer
Most items are self-explanatory, however the ARRAY data in the center requires
explanation. There are three rows of data:
a. The top row contains Velocity data (V). The first value is -462; this is the
Eastward velocity component in millimeters per second. The 95 is the
Northward followed by the Vertical, error, Magnitude, and Direction of the
velocity.
b. The middle row contains Echo Intensity data in counts. The 150 is Beam 1s
Echo Intensity followed by Beams 2, 3, and 4. The last value (149) is the
average of the four Echo Intensity values.
c. The last row contains Correlation data if the ADCP is a Broadband or
WorkHorse otherwise Spectral width for the Narrowband ADCP. If the data
are not available then zeros are displayed.
page 9
Figure 9.
NOTE. Lat/Lon and MicroCAT data will not be visible unless the data was
collected.
page 10
RD Instruments
2.11
File Details
On the Utilities menu, click File Details. Select the data file to be examined.
The file utility window will show you everything there is to know about the file
contents.
Figure 10.
File Details
page 11
Chart Options
The Options menu controls how the displays are shown. Selecting Chart Options under the Options Menu brings up the Chart Options dialog box. There
are five tabs on the dialog box:
Contour Tab
Profile Tab
Series Tab
Ancillary Tab
Processing Tab
Six buttons are positioned along the bottom of the Chart Options dialog box.
Default
Load
- reads in, from a selected file, a previously saved set of option pages.
Save
OK
- updates the screen to the new setting(s) and close the options dialog.
Cancel
- update the screen to the new setting(s) but does not close the options
dialog.
Apply
NOTE. Max Ensembles, under the Options menu, is used to set the
maximum number of ensembles shown in both the Sub Set Color
Contour and Series charts.
page 12
RD Instruments
3.1
Contour Tab
The Contour tab has five control groups for controlling the Whole Set, Sub Set
and color contour charts.
Figure 11.
Contour Tab
- Five choices for selecting the maximum and minimum values of the
color scale.
Scale
page 13
Locators - turn on/off the blinking boxes of the Whole Set color contour.
Grid - turn on/off the grid that overlays both color contour charts.
BT Depth When checked and Bottom Track depth data is available,
a bottom contour line is drawn on top of the color contour plot. If
beam 1 through 4 RSSI or correlation is selected for display, the
beams depth is shown. Any other selection will show the contour
line as the average of the four beams.
Data Type
Selected Set
Sub Set
page 14
- Used to select the first and last ensembles of the Selected Set.
- Used to select the first and last ensembles of the Sub Set.
RD Instruments
3.2
Profile Tab
The Profile tab has four control groups for controlling the Profile chart.
Figure 12.
Scale
Profile Tab
- Manual selection of the maximum and minimum values for each data
type.
Appearance
Data Type
page 15
3.3
Series Tab
The Series tab has five control groups for controlling the Series chart.
Figure 13.
Scale
Series Tab
- Manual selection of the maximum and minimum values for each data
type.
Appearance
Combo - When selected each bin of a data type is plotted on the same
chart.
Lines - Turn on/off the connection of lines between data points.
Symbols - Turn on/off a symbol at each data point location.
Grid - Turn on/off the grids that overlay the series charts.
Data Type
page 16
RD Instruments
Statistics
3.4
Ancillary Tab
The Ancillary tab has three control groups for controlling the Ancillary chart.
Figure 14.
Scale
Ancillary Tab
- Manual selection of the maximum and minimum values for each data
type.
page 17
Appearance
3.5
Processing Tab
The Processing tab allows the selection of a velocity reference; None, Bottom
Track, or Navigation.
NOTE. The Navigation (VmDas) is VmDas format only, dont use this for
WinRiver. GPS (GGA) and GPS (VTG) are in WinRiver format.
Figure 15.
page 18
Processing Tab
RD Instruments
Exporting Data
Clicking the main menu item Export brings up the WinADCP Export Options
dialog box. There are three styles of export: Contour, Profile, and Series/Ancillary.
The MAT file output has a MatLab compatible binary format. From MatLab
type load filename.mat then type who. The Column = Bin and Row = Ensemble. A
list of variables for each output format is shown.
4.1
Contour
Exporting contour data allows the selection of one data type (Velocity, Magnitude, Amplitude, Correlation, and Percent Good), the first/last ensembles, the
first/last bins, and the file format.
Figure 16.
page 19
RDIBinSize
RDIEnsDate
RDIEnsInterval
RDIEnsTime
RDIFileName
RDIPingsPerEns
RDISecPerPing
RDISystem
For the Profile export the variables are: (Pro refers to Profile)
ProCor1cnts
ProCor2cnts
ProCor3cnts
ProCor4cnts
ProCorAvgcnts
ProDir10thDeg
ProEAmpBm1cnts
ProEAmpBm2cnts
ProEAmpBm3cnts
ProEAmpBm4cnts
ProEAmpBmAvgcnts
ProEmmpersec
ProErmmpersec
ProMagmmsec
ProNmmpersec
ProVmmpersec
RDIBin1Mid
RDIBinSize
RDIEnsDate
RDIEnsInterval
RDIEnsTime
RDIFileName
RDIPingsPerEns
RDIProfileBins
RDIProfileEns
RDISecPerPing
RDISystem
An example of the "TXT" format is shown below between the dashed lines.
The row of numbers 1, 6, 11, 16 are the selected bin numbers.
The columns of numbers 1390 through 1400 are ensemble numbers.
The data set, which has 3598 in the upper left-hand corner, contains velocity
magnitude data in mm/s.
---------------------------------------------------------------------------"Contour Data = Velocity Magnitude mm/s"
"C:\DATA\Sampdata.000"
"Broadband 614.4 kHz"
"Pings/Ens =" 5
"Time/Ping = 00:00.00"
"First Ensemble Date = 95/03/21"
"First Ensemble Time = 03:44:23.78"
"Ensemble Interval (s) = " 1.71
"1st Bin Range (m) = "
0.33
"Bin Size (m) =" 0.10
1
11
16
1390
3598
2619
3099
998
1391
2867
2464
2919
491
1392
2350
3040
2357
805
1393
3156
2438
2682
2138
1394
3025
2520
2096
2305
1395
2303
2918
2121
271
1396
1990
3129
3232
421
1397
3006
2079
947
644
1398
2341
2027
1804
657
1399
2390
1334
1854
616
1400
2426
2175
2135
514
----------------------------------------------------------------------------
page 20
RD Instruments
4.2
Profile
Exporting Profile data allows the selection of many data types, one ensemble,
the first/last bins, and the file format.
Figure 17.
An example of the TXT format is shown below between the dashed lines.
The row of numbers 1, 5, 9, 13, 17 are the selected bin numbers.
The left-hand column contains data type titles (16 possible):
EAA is Echo Amplitude Average (average of the four beams).
CA is Correlation Average (average of four beams).
Mag mm/s is the velocity Magnitude in millimeters per second.
Dir deg is the velocity Direction in degrees.
---------------------------------------------------------------------------"Profile Data Ensemble Number = " 1341
"C:\DATA\Sampdata.000"
"Broadband 614.4 kHz"
"Pings/Ens =" 5
"Time/Ping = 00:00.00"
"First Ensemble Date = 95/03/21"
page 21
13
17
"EAA cnts"
173
169
152
148
122
"CA cnts"
138
156
100
132
122
"Mag mm/s"
1499
612
799
608
1344
"Dir deg "
91.3
54.9
163.3 92.7
80.0
----------------------------------------------------------------------------
4.3
Series/Ancillary
Exporting Series/Ancillary data allows the selection of many data types, the
first/last ensembles, the first/last bins (of the series data), and the file format.
Figure 18.
NOTE. If you are exporting navigation data form a data file collected with
WinRiver, make sure to check the WinRiver box. This lets WinADCP
know where to look for the navigation data.
page 22
RD Instruments
An example of the TXT format is shown below between the dashed lines.
The row of numbers 1, 7, 13, 19 are the selected bin numbers.
Ancillary data does not have a bin number above it.
The columns of numbers 1390 through 1400 are ensemble numbers.
---------------------------------------------------------------------------"Series Data"
"C:\DATA\STEIN\BIGGE\TRANDATA\Bigg020r.000"
"Broadband 614.4 kHz"
"Pings/Ens =" 5
"Time/Ping = 00:00.00"
"First Ensemble Date = 95/03/21"
"First Ensemble Time = 03:44:23.78"
"Ensemble Interval (s) = " 1.71
"1st Bin Range (m) = "
0.33
"Bin Size (m) =" 0.10
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
"Hea"
"deg"
1
"Dir"
"deg"
"Dir"
"deg"
"Dir"
"deg"
178.62
177.85
179.65
179.30
179.75
178.53
179.53
177.95
177.62
177.52
174.92
3598
2867
2350
3156
3025
2303
1990
3006
2341
2390
2426
102.9
87.4
91.3
100.3
62.7
83.4
93.0
84.7
85.0
93.8
85.0
71.5
61.9
80.9
82.5
99.7
92.0
100.5
78.5
83.1
75.4
75.4
68.7
57.6
84.8
94.0
92.0
73.8
90.5
79.4
66.0
115.2
63.3
3182
2958
2435
2533
2514
2475
2884
2652
2257
2069
2625
1289
1474
2154
1831
1463
1652
1989
1379
1127
1184
2901
1627
1736
1986
2156
1107
1407
2621
1396
1468
630
1655
87.8
80.9
82.6
91.1
91.7
100.6
85.9
92.3
87.1
88.2
87.3
----------------------------------------------------------------------------
Ens HH
MM
SS
HH
"Pit"
"deg"
"Rol"
"deg"
"BIT"
""
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
13
14
14
14
14
14
14
15
15
15
15
15
15
16
16
16
16
16
16
50
00
10
20
30
40
50
00
10
20
30
40
50
00
10
20
30
40
50
72
72
72
72
72
72
72
72
72
72
72
72
72
72
72
72
72
72
72
-0.13
-0.13
-0.14
-0.14
-0.14
-0.13
-0.13
-0.14
-0.13
-0.13
-0.13
-0.13
-0.13
-0.13
-0.13
-0.13
-0.13
-0.13
-0.13
-0.36
-0.35
-0.36
-0.36
-0.35
-0.36
-0.35
-0.36
-0.36
-0.35
-0.35
-0.35
-0.36
-0.36
-0.35
-0.36
-0.36
-0.36
-0.36
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
11
11
11
11
11
11
11
11
11
11
11
11
11
11
11
11
11
11
11
01,
01,
01,
01,
01,
01,
01,
01,
01,
01,
01,
01,
01,
01,
01,
01,
01,
01,
01,
"MicroCAT"
00000,
00000,
00000,
00000,
00000,
00000,
00000,
00000,
00000,
00000,
00000,
00000,
00000,
00000,
00000,
00000,
00000,
00000,
00000,
5.8361,
5.8365,
5.8364,
5.8363,
5.8363,
5.8363,
5.8362,
5.8363,
5.8362,
5.8362,
5.8361,
5.8360,
5.8363,
5.8363,
5.8359,
5.8363,
5.8361,
5.8363,
5.8364,
3.44779,
3.44779,
3.44779,
3.44779,
3.44779,
3.44778,
3.44778,
3.44779,
3.44779,
3.44778,
3.44779,
3.44778,
3.44778,
3.44779,
3.44779,
3.44778,
3.44779,
3.44778,
3.44777,
366.974,
366.972,
366.991,
366.995,
366.997,
367.000,
366.993,
366.995,
367.006,
367.000,
366.998,
366.990,
366.984,
366.980,
366.984,
366.982,
366.993,
366.999,
366.989,
35.1075,
35.1070,
35.1072,
35.1072,
35.1072,
35.1071,
35.1073,
35.1073,
35.1073,
35.1072,
35.1075,
35.1074,
35.1071,
35.1072,
35.1077,
35.1071,
35.1075,
35.1071,
35.1069,
01
01
01
01
01
01
01
01
01
01
01
01
01
01
01
01
01
01
01
Jan
Jan
Jan
Jan
Jan
Jan
Jan
Jan
Jan
Jan
Jan
Jan
Jan
Jan
Jan
Jan
Jan
Jan
Jan
1980,
1980,
1980,
1980,
1980,
1980,
1980,
1980,
1980,
1980,
1980,
1980,
1980,
1980,
1980,
1980,
1980,
1980,
1980,
04:43:00
04:43:10
04:43:20
04:43:30
04:43:40
04:43:50
04:44:00
04:44:10
04:44:20
04:44:30
04:44:40
04:44:50
04:45:00
04:45:10
04:45:20
04:45:30
04:45:40
04:45:50
04:46:00
page 23
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
11
11
11
11
11
11
11
11
11
11
11
11
11
11
11
11
11
11
17
17
17
17
17
17
18
18
18
18
18
18
19
19
19
19
19
19
00
10
20
30
40
50
00
10
20
30
40
50
00
10
20
30
40
50
72
72
72
72
72
72
72
72
72
72
72
72
72
72
72
72
72
72
-0.13
-0.13
-0.12
-0.13
-0.13
-0.12
-0.12
-0.12
-0.12
-0.12
-0.12
-0.11
-0.11
-0.11
-0.09
-0.11
-0.08
-0.11
-0.36
-0.36
-0.36
-0.36
-0.35
-0.36
-0.36
-0.35
-0.36
-0.36
-0.34
-0.35
-0.35
-0.35
-0.36
-0.35
-0.35
-0.36
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
01,
01,
01,
01,
01,
01,
01,
01,
01,
01,
01,
01,
01,
01,
01,
01,
01,
01,
00000,
00000,
00000,
00000,
00000,
00000,
00000,
00000,
00000,
00000,
00000,
00000,
00000,
00000,
00000,
00000,
00000,
00000,
5.8362,
5.8362,
5.8361,
5.8361,
5.8360,
5.8363,
5.8363,
5.8363,
5.8363,
5.8362,
5.8362,
5.8365,
5.8365,
5.8362,
5.8361,
5.8365,
5.8360,
5.8362,
3.44778,
3.44778,
3.44778,
3.44778,
3.44778,
3.44778,
3.44778,
3.44778,
3.44777,
3.44778,
3.44778,
3.44778,
3.44778,
3.44777,
3.44778,
3.44778,
3.44777,
3.44778,
366.986,
366.984,
366.985,
366.981,
366.984,
366.977,
366.990,
366.980,
366.980,
366.996,
366.996,
366.997,
366.989,
366.983,
367.017,
366.991,
366.992,
366.994,
35.1072,
35.1072,
35.1074,
35.1074,
35.1074,
35.1072,
35.1072,
35.1072,
35.1070,
35.1072,
35.1073,
35.1070,
35.1069,
35.1072,
35.1074,
35.1070,
35.1073,
35.1073,
01
01
01
01
01
01
01
01
01
01
01
01
01
01
01
01
01
01
Jan
Jan
Jan
Jan
Jan
Jan
Jan
Jan
Jan
Jan
Jan
Jan
Jan
Jan
Jan
Jan
Jan
Jan
1980,
1980,
1980,
1980,
1980,
1980,
1980,
1980,
1980,
1980,
1980,
1980,
1980,
1980,
1980,
1980,
1980,
1980,
04:46:10
04:46:20
04:46:30
04:46:40
04:46:50
04:47:00
04:47:10
04:47:20
04:47:30
04:47:40
04:47:50
04:48:00
04:48:10
04:48:20
04:48:30
04:48:40
04:48:50
04:49:00
Monitor Mode
WinADCP has the ability to automatically update the reading of a file as realtime data collection is occurring. When the file size increases, (due to real-time
data collection in another program such as VmDas) Monitor will automatically
reread the file at selected intervals and display the contents. When Monitor is
enabled and the file size is changing, all menu items except Monitor will be unavailable. You can change the interval by clicking Monitor, Interval. Enter
the monitor interval in seconds.
page 24
RD Instruments