|
Users Manual |
NOAA/AOML/OCEAN Acoustics Division |
|
Table of Contents |
| Introduction | |
| Screen Guide | |
| Notification System | |
| Options | |
| 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.
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.
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. |
 |
Operating System
- Microsoft Windows 2000 (Tested Platform)
- Microsoft Window XP
- Solaris 9 OS
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:
- J2SE 1.4 Java Runtime or later (Tested on build 1.4.1_02-b06)
- JAF-1.0.2 Java Activation Framework (or later, but must match Mail release)
- Java Mail 1.3 Java Mail extension (or later, but must match Activation Framework release)
- Java Communications API 2.0 or later
Hardware Requirements
- Recommended 300 MHz Processor (Tested on Pentium II, 350 MHz)
- Same as Operating System
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