***Installation***

After uncompressing DiFarv10.exe, follow the Usage directions below.

Assuming the files were extracted to c:\matlab6p5\toolbox\difar


***Usage***

starting DiFar in Matlab:
1. Navigate your Matlab current directory to the location where DiFar is located (C:\matlab6p5\toolbox\difar)

2. Run the DiFar software using the following syntax from the Matlab prompt:
>> DiFar

Using DiFar:
1. Select a folder you wish to monitor via the "Browse" button.

2. Select the interval of time between which you want DiFar to check the folder for a new wave file.

3. Select the analysis bandwidth in Hz

4. Select the length of FFT in seconds for use in analyzing the window of locked data

	4.1 The FFT length must be less than the length of the locked data window

	4.2 If the amount of lock-able data within the set window is less than the FFT length, a statement about the available data within the window will be displayed in Matlab and DiFar will stop to allow for adjustments in window or FFT size.

5. Select the beginning of the window of locked data to be analyzed from the file.

6. Select the end of the window of locked data to be analyzed from the file.

7. Select an output file for selected plot data under "Coordinate Data File". 

	7.1 The selected file will output coordinate, bearing, and time of plot creation data when the left mouse button is click on a plot.

	7.2 Data is written to the file sono1.txt, sono2.txt, or sono3.txt within a "data" subfolder of the monitoring folder.

8. Press the "Start" button to begin analysis of the selected folder

	8.1 If a wave file(s) is in the selected folder, analysis will begin on that file(s)

	8.2 Placing a new file in the monitored folder will begin a new analysis within the time interval selected for monitoring

9. DiFar will print a list of lock changes on the data within the currently analyzed file.  Only data with full locks (displayed as "1 1") provide valid information.  Any data not fully locked within the provided analysis window will be discarded.

10. Data is seperated into channels and resampled for quicker analysis.

11. A plot of the data is displayed

	11.1 Data about the information is displayed across the top of the plot, including date and time the plot was created, amount of locked data that was found in the file, and the start/end times of the analysis window used.

	11.2 Moving the mouse across the plot will produce a cross-hair with the values of its position given in the lower-left hand corner of the plot
	
	11.3 Clicking on the plot will save the values of the cross-hair to file (see Usage - Using DiFar step 7).


***Known Issues:***

DiFar does not run properly if Matlab's current directory is not set to the location of DiFar's dll's (see Usage - Starting DiFar in Matlab step 1).

Portions of DiFar was compiled using Microsoft's .NET framework and require this framework to run.  If Matlab fails when trying to run DiFar, download the .Net Framework from Window's Update to obtain the latest dll's.

To re-analyze the same file within a folder, stop DiFar, adjust the settings, and re-start.   


***Revision History***

 Filename: DiFar.m
 Version: 1.0
 Date: 01-27-04

------------------------------------------------------------------------