
                                README

              RFI (Radio Frequency Interference) Mitigation
                            MATLAB ToolBox

              Author: Marcel Nassar (nassar@ece.utexas.edu)

                          DATE: September 21, 2007
Contents
---------

* Introduction
* Installation
* Theory and Background Information
* Compatibility
* Bug Reports and Feedback
* References


Introduction
-------------

The RFI Mitigation toolbox for MATLAB is designed to provide a simulation 
environment for generating radio frequency interference and quantifying the
performance of various parameter estimation algorithms and interference 
mitigation algorithms. It is composed of various functions used to generate 
various types of noise statistics and to perform noise cancellation and 
detection. The current version (ver 1.0 ) supports the generation of 
Middleton Class A and Alpha Stable random variables and their envelopes 
(used in estimation). For the evaluation of communication performance under
the presence of the aforementioned noise types, the current version (ver 1.0
) of the toolbox implements a PAM communication system with correlation
detection, Wiener filtering followed by correlation detection, and the 
optimal Bayes detection developed by Spaulding and Middleton [1]. In 
addition to that, it implements the following parameter estimation algorithms:
Method of Moments [3], Zabin and Poor [4], Tsihrintzis [2]. This toolbox 
also includes various demos that illustrate the usage of the implemented 
functions, and generate various results.



Installation
-------------
The current version (ver 1.0) of the RFI Mitigation toolbox does not 
contain a stand alone installer. To install it, the copy the given the RFI
directory to your toolbox directory in the MATLAB folder. For example 
assume that the MATLAB is installed in C:\Program Files\MATLAB. Then a 
possible destination directory can be C:\Program Files\MATLAB\toolbox.
After that the following command should be executed to add the RFI toolbox
to your MATLAB paths:

addpath(genpath('C:\Program Files\MATLAB\R2007a\toolbox\rfi'));

where you replace 'C:\Program Files\MATLAB\R2007a\toolbox\' with the 
directory to where you copied the rfi folder.



Theory and Background Information
----------------------------------
The theory and the background information are given in an online report and
presentation that can be found at the following links:

Report:
http://users.ece.utexas.edu/~bevans/projects/rfi/reports/RFIReportSpring2007.doc

Presentation:
http://users.ece.utexas.edu/~bevans/projects/rfi/talks/April2007RFIMitigationSlides.ppt



Compatibility
------------
This toolbox has been tested in Matlab 7.0 and 7.1. The following 
command-toolbox dependencies exit and are needed for the toolbox to run 
properly:

	Command                 Toolbox
	--------                --------
	* pammod                Communication Toolbox
	* moment                Statistics Toolbox
	* rcosine               Communication Toolbox
	* xcorr                 Signal Processing Toolbox
 


Bug Reports and Feedback
-------------------------
For bugs and feedback, email me at nassar@ece.utexas.edu.



References
-----------
 [1] A. Spaulding and D. Middleton, Optimum reception in an impulsive
     interference environment-part I: Coherent detection, IEEE Transactions on 
     Communications, vol. 25, no. 9, pp. 910923, 1977.

 [2] G. A. Tsihrintzis and C. L. Nikias, "Fast estimation of the
     parameters of alpha-stable impulsive interference", IEEE Transactions 
     on Signal Processing, vol. 44, no 6, pp. 1492-1503, June 1996.

 [3] D. Middleton, Procedures for determining the properties of the 
     first-order canonical models of Class A and Class B electromagnetic 
     interference, IEEE Transactions on Electromagnetic Compatibility, 
     vol. 21, pp. 190-208, Aug. 1979.

 [4] S. M. Zabin and H. V. Poor, Efficient estimation of Class A noise parameters
     via the EM [Expectation-Maximization] algorithms, IEEE Transaction on Information
     Theory, vol. 37, no. 1, pp. 60-72, Jan. 1991.
