Users Manual

AOML ADCP Recording 

NOAA/AOML/OCEAN Acoustics Division

Table of Contents


Screen Guide
Notification System
System Requirements
Known Bugs



The AOML Data Analyzer Application loads a graphical user interface and reads from the serial port or a saved file. Application locates ensembles from the file or serial port and automatically saves the raw ensemble data to a daily file. The ensemble data is also used to update the user interface with data from the ADCP instrument. Under varying conditions, the application can send out emails to update on the status of the currents being measured. Settings are changed via an options dialog, and are automatically saved and loaded. The application offers a basic help screen, and the code documentation is about 80% complete.


Screen Guide


 The following shows the main application window.

The "System Information" window contains information about the ADCP instrument, as well as the "Discharge Status". Discharge Status represents the conditions of the currents in relation to dredging activity. Good and Bad conditions are indicated there.

The "ADCP Data" area displays ongoing current data. A timestamp is displayed, since the data from the last 24 hours is displayed (72 total samples at 3 samples per hour). The columns can be moved around and resized as desired.

The "Console Output" displays any information that the user may be interested in, such as Microcontroller messages, good and bad ensemble reads, and any application issues.

From this main window, several menus are available to start and stop a connection, open up an options dialog, as well as exit the application. The "X" close widget on the upper right of the application has the same effect as "Exit" from the "File" menu.

Notification System


First message is the standard message sent every 20 minutes when an ensemble comes in from the ADCP between the hours of 8 AM till 8 PM. It will be transmitted via email to the watch stander and make it selectable in options as to who else will receive it. The message reads as follows:

“Curr: E/W __ cm/s   N/S __ cm/sec”

Note: -u = west, + u = east, - v = south, + v = north

The next message type is when the current exceeds a -u (west) current value of (?). The message will be transmitted to the watch stander and the designated dredge personnel. The message recipients should also be selected in the options menu. This message and the following will be transmitted even it the time is past 8 PM. This message will read as follows:  

"Window Opened"

“_ hrs __ mins remain to discharge”

Followed by the message:

“Curr: E/W __ cm/s   N/S __ cm/sec”

This message will be transmitted every time an ensemble comes in (every 20 minutes). The number of hours should count down in increments of 20 minutes until time runs out or the u component of the current no longer exceeds the specified value.

If time runs out the messages should read:

“The window has closed, discharge suspended until further notice”

“Curr: E/W __ cm/s   N/S __ cm/sec”

This message will continue to be transmitted every time an ensemble comes in until the current conditions are favorable again.

If the current swings around to a favorable condition the messages should read:

“Conditions favorable, resume normal operations”

“Curr: E/W __ cm/s   N/S __ cm/sec”

If it is after 8 PM then the program should resume normally and not send any messages after 8 PM. Note: Only if conditions are favorable.




The following are screen shots of the Options Dialog:

To apply any option settings you must enter a user ID.

Processing Options:

The "Processing" tab contains options relevant to the processing of velocity cell data, which is used to display current information in the "ADCP Data" area, as well as determine the dredging/discharge status.

You can not currently change the ensemble interval from the application. The application always assumes 3 ensembles per hour.

The File Name Prefix allows you to set the beginning of the filename. The filename always contains the date, and has the extention ".dat".

NOTE: Unless you select otherwise, data read in from a file, will be recorded as usual to the selected file area, just as data read in from a serial port.

Connection Options:

By selecting "Automatically Connect on Start" the application will automatically open the serial port on startup.

Console garbage are characters that probably should not be printed (outside of an ensemble transmission), and by default are suppressed.

The File Reader Delay is the the delay time in milliseconds between byte reads. This is useful to see system data updated with each ensemble read from the file. Enter a delay of 0 to load the entire file at once. (You will not have time to see the updated system data, only the last ensemble, however, the last 72 ensembles will be displayed in the "ADCP Data" area.

Email Options:

"Mail Host:" is your SMTP server.

"From Address:" allows you to change the address watch standers and dredgers will see in emails sent out as notifications.

The "Watch Stander email List" is the list of emails that are members of the Watch Stander group. You can set when they are notified (outside of bad conditions) on the Notification Options Tab. The "Dredger email List" works the same. You may seperate email addresses however you like. When you click apply you can check if the email addresses were accepted. Incorrect (bad format) emails are dropped from the list.


Notification Options:

On the notification options panel you can set the times that groups are always notified (even under good conditions). If you only want them to be notified under bad conditions put the same time under the "From:" and "to" text boxes.

The conditional notification options allow you to set which conditions are considered bad so that a time to discharge window is opened and the groups are notified. Positive values are East and North. Negative values are West and South.

The "Window Duration:" is the length of time a window can be opened until a notification that operations are suspended is sent.


System Requirements


Operating System

Note: Although a Java application, communication libraries only available on the Windows and Solaris platforms are required. Third party communication libraries for other operating systems may available.

Sun Java Components:

Hardware Requirements


Known Bugs


Some issues should be corrected inside the DataPanel

No file recording capability of formatted data

No Advanced option to edit email filter

Should wait for analyzer to finish before allowing new connection (buffer clear?)

Files sometimes immediately close on opening

The information in the “Connection Status” class StatusPanel is not visually appealling

Should show a green icon when connected to a source, a yellow icon when idle, and a red icon in error condition.

Also show a recording icon when connected to a live source and file recording is enabled

Could possibly show the location of the recording file

No option to edit the email messages, perhaps with %u, %v, %etc…

Should load the systems port name identifiers for compatibility with Solaris