How to use reviewGUI
Please send questions and comments to Francois Cazenave: francois@mbari.org

What is it? reviewGUI is a GUI (graphical user interface) which allows the user to load AUV log data and plot it in various ways.

Getting started:
Go to Francois tempbox. (T:\Francois)
Copy the folder named reviewGUI to your work space.
Open matlab. Add the folder reviewGUI to your matlab path.

Using the GUI:
In your matlab command window, type reviewGUI. The GUI will appear on the screen.
The GUI has the following features:

Menus:
Load new data set: this is where you load the AUV logs. A dialog box will appear. Navigate to the folder which contains the AUV logs you want to load (AUV log are located on the network at \\Tornado\auvctd\missionlogs).
This will create a structure containing all the AUV data (including instrument name, data type and units) and put it in the GUIs workspace. It finds which instrument starts logging the latest. The start time of this instrument will be considered the reference time for all instruments and data logged before this start time is discarded. A message will appear if an instrument starts log more than 5 minutes after dataNav. The start time is saved in the structure. Time is then synchronized for all the instruments.
For some of the older data sets (2003), the units and data long names are not in the log file. The short names will be used instead of the long names and units not be displayed.
Load saved data set: Select this option if you want to use a data set that you have previously loaded and saved (see below). If you load a new data set, you can not click on generate plot right away, even if it looks like instruments and data are already selected. You must select instruments and data again.
Save Current data set: Select this option if you want to save the current data set. A dialog box will allow you to save it wherever you want.
Save current plot configuration: If you want to make the same plot for different data sets, you may want to save the plot configuration. Once you have selected data and plotting options, click on this option so save the configuration. Using the dialog box navigate to the folder where you would like to save the plot configuration. You may have to rename it.
Open saved plot configuration: To open a saved plot configuration, click on this option. A dialog box will appear. Navigate to the folder which contains previously saved plot configuration and select it. Click on Generate plot or Generate subplots.
Help: opens a text file with this description of the GUI.

Drop down menu:
Select instrument: drop down menu to select one of the instruments (ex: dataDVL)
Select data: drop down menu to select one type of data (ex: Yaw)

Check boxes:
Activate second y axis: check this if you want to have 2 data sets on one plot. Scales should be the same.
Time on X axis: check this if you want to have time on the x axis. It will automatically use the time of the instrument(s) selected for the y axis. If it is not checked and you want to use different instruments on the x and y axis, sampling frequency may be different. The program will automatically resample the data set which has the smaller sampling frequency to match the sampling frequency of the other data set. The interpolation type is linear, but this can be changed easily in the code.
Reverse Y axis for subplot 1 or 2: Useful when you have depth on the y axis.
Link axis: This option allows you to get the same zooming factor on both subplots. For example, if link x axis is selected and you zoom in on subplot 1, the x axis limits will be adjusted on subplot 2 to be the same. Use this option only if the scales are similar for both subplots.

Radio buttons:
2-1 subplots/1-2 subplots: if 2-1 subplots is selected, subplots will be one below the other (good for comparing time series), if 1-2 subplots is selected, subplots will be side by side (good for depth profiles).
  
Note about instrument names and units:
All instrument names, data names and units are taken from the AUV log files. There are some mistakes. For example degrees are sometimes used instead of radians.
Instrument names in the GUI are short names. Here are the corresponding long names:
short name	Long name
biolume	Bioluminescence sensor
bluefinBattLog	Bluefin Battery
ctdDriver2ctdlog	CTD driver 2
ctdDriverctdlog	CTD driver 1
dataCB	Cross Bow
dataDC	Dynamic control
dataDvl	DVL
dataEnv	Sphere environment
dataNav	Navigation
dataTC	Tail cone
gps	GPS
hydroscatlog	Multichannel backscatter
isuslog	Nitrate sensor
parosci	Pressure sensor
DropWeight	Drop weight
lisstlog	Lisst sensor

Note about loadData2:
loadData2 is a subfunction of reviewGUI, it must be in the matlab path otherwise you will not be able to load log files from the GUI.
You may also use loadData2 by itself, and save the data for later use.


Updated: June 29, 2007
