c Lily Woo April 6, 2010 

This readme file explains the contents of the CD-ROM attached to the thesis in the following manner:
Directory\Folder
		Description		: brief desription
		General Notes		: e.g., command to run
		Software to run program	: compiler, version

----------------------------------------------------------------------------------------------------
Appendices\
	Appendices\Code
		Appendices\Code\A1_Monofractal_Noise_Synthesis
			Description				: For monofractal noise generation using the spectral filtering algorithm.
			General Notes				: Main program: inputnoisesForPERexpts. All other .m files are functions that the main program uses. To run the main program, please see notes *** below.
			Software to compile & run program	: MATLAB R2007b

		Appendices\Code\A2_PER_TXRX_Codes
			Description				: These programs (smac_per_tx.c and smac_per_rx.c) are written for the firmware of the transmitter (TX) and receiver (RX) boards. The PER_TX firmware allows the TX to transmit 1000 packets to the RX. The PER_RX firmware monitors the number of received and dropped packets at the RX. Both firmware allow for serial access and control to the boards for sending TX-related and RX-related command through a Hyperterminal session from a laptop.
			General Notes				: To compile the program and then flash the firmware onto the TX and RX boards, see instructions on pages 114-116 of thesis. To access each board through HyperTerminal, see configuration instructions on pages 116-117 of thesis.
			Software to compile & debug program	: Freescale CodeWarrior, CW for Microcontrollers V6.2
			Software to communicate to flashed Freescale board: HyperTerminal, v6.3, Private Edition

		Appendices\Code\A3_TraceDataAcquisition_Codes
			Description				: A software (graphical user interface) written in C# to (i) acquire trace data from HP 8546A spectrum analyzer through its GPIB interface using a Prologix GPIB-USB controller module, and (ii) save trace data information (frequency and amplitude pairs) in a comma-separated value text file.
			General Notes				: To run program, double click on testApp.exe found in folder Appendices\Code\A3_TraceDataAcquisition_Codes\GPIBUSB_correctedAsOfJune262008\testApp\testApp\obj\Debug (refer to Appendix C.7 in the thesis for futher details)
			Software to compile program		: Microsoft Visual Studio 2005

		Appendices\Code\A4_PowerWithinSpecifiedBandwidth_MATLABcodes
			Description				: For computing power within a specified bandwidth from the input trace file (spectrum captured off a spectrum analyzer)
			General Notes				: Main program: main_program_genpowerBW. The other .m file is a function that the main program uses. To run the main program, please see notes *** below.
			Software to compile & run program	: MATLAB R2007b

		Appendices\Code\A5_CapturedNoiseAnalysis_Spectrogram
			Description				: To produce the plots shown in Fig. 4.10 on page 67 of thesis.
			General Notes				: To run the program, please see notes *** below.
			Software to compile & run program	: MATLAB R2007b

		Appendices\Code\A6_CapturedNoiseAnalysis_convertIQTtoTimeSeries_thenFindVFDT
			Description				: plottimeseries_v12.m: To convert information in .IQT file to time series data in the form of Amplitude vs. sample number.
								  determineBetaRangeforCapNoise.m: To compute the VFDT plot for the signal depicted in the time series output by the plottimeseries_v12.m MATLAB program.
			General Notes				: To run each program, please see notes *** below.
			Software to compile & run program	: MATLAB R2007b

		Appendices\Code\A7_VarianceFractalDimensionTrajectory_MATLABcodes
			Description				: For computing the variance fractal dimension trajectory (VFDT) plot of the input signal.
			General Notes				: Main program: MainProgram. All other .m files are functions that the main program uses. To run the main program, please see notes *** below.
			Software to compile & run program	: MATLAB R2007b

		Appendices\Code\A8_AMMN_Analytical
			Description				: analysis1A and analysis1B contain the .m files used to generate the plots for the binomial expansion and the power law estimation analyses in [WPKF07].
			General Notes				: To run each program, please see notes *** below.
			Software to compile & run program	: MATLAB R2007b


		***Notes on running a program in MATLAB:
		--------------------------------------------------------------------------------------------------------------------------------------------------------
			There are two ways to run a program in MATLAB, either 
			1. From the MATLAB Desktop Tools and Development Environment:
				1a) Click on the 'Current Directory' drop down list, and select the folder where the main program and its related function file resides.
				2a) Then, in the Command Window, type the name of the main program (without the extension), and press the Enter button.
			or 
			2. From the MATLAB Editor/Debugger:
				2a) Double click on the main program .m file
				2b) To run, hit F5, click the run button, or go to Debug->Run from the menu bar.
		--------------------------------------------------------------------------------------------------------------------------------------------------------

	Appendices\Data
		Appendices\Data\B1_CapturedNoiseData_StarterSourceOfTractors
			Description				: These are the RSA 3303A RTSA-captured traces (in .IQT format) of noise signals (emitted by the starter system in a tractor) within the 15 MHz frequency span centered at 2.405 GHz.
			General Notes				: These were the trace data used as input files to the plottimeseries_v12.m MATLAB program in Appendix A.7 to output each captured trace from .IQT format to time series (in terms of amplitude vs. sample number).

		Appendices\Data\B2_Baseband_Monofractals_Datapoints
			Description				: These are the discrete sequence of monofractal noises synthesized from the main program (inputnoisesForPERexpts.m) in Appendix A.1
			General Notes				: These sequences are uploaded onto the arbitrary waveform generator to produce analog baseband monofractal noise signals. Please see Appendix C.5 for the uploading procedure.

		Appendices\Data\B3_PacketErrorRate_Data
			Description				: Each of the PER_data text file contains the number of packets dropped for each of the ten 1000-packet transmission runs for various nodes separation at different power levels of the chosen noise type.
			General Notes				: The averaged PER value is inserted to the corresponding cell in the respective worksheet in the Excel file (in Appendix D).

		Appendices\Data\B4_TraceData_Noise_ZigBee
			Description				: The text files are that of the ZigBee and noise traces acquired for the different performance evaluation experiments.
			General Notes				: These were the text files used as input files to the main_program_genpowerBW.m MATLAB program in Appendix A.4 to compute its power within the 2 MHz bandwidth (from 2.409 to 2.411 GHz).

	Appendices\Photos
		Appendices\Photos\Expl_Snapshots\BasebandNoiseSequenceUploading
			Description				: Snapshots of the hardware (equipment and cables) involved in the uploading of synthesized monofractal noise sequence (from a textfile) onto the AWG for the baseband portion of the high-frequency fractal noise generation circuit. Please refer to Fig. 1 in Appendix C.9 for the specific hardware, software, and cables involved in this task.

		Appendices\Photos\Expl_Snapshots\Expt_Setup_InsideChamber
			Description				: Snapshots of the layout and the hardware (equipment and cables) involved in the transmission of 1000 ZigBee packets from a transmitter board to a receiver board. Please refer to Fig. 1 in Appendix C.9 for the specific hardware, software, and cables involved in this task.

		Appendices\Photos\Expl_Snapshots\Expt_Setup_OutsideChamber
			Description				: Snapshots of the layout and the hardware (equipment and cables) involved in a) the generation of high-frequency analog fractal noise signals, and b) the monitoring of packet dropped during each 1000-packets-transmission run. Please refer to Fig. 1 in Appendix C.9 for the specific hardware, software, and cables involved in this task.

		Appendices\Photos\Expl_Snapshots\PhysicalNoise
			Description				: Snapshots of the layout and the hardware (equipment and cables) involved in the performance evaluation of the wireless protocol under test under the influence of a physical noise source (EM noise generated from the sparking event of a plasma globe).

		Appendices\Photos\Expl_Snapshots\SNR_fromTraceAcquired
			Description				: Snapshots of the hardware (equipment and cables) involved in the acquiring of trace data from the HP 8546A spectrum analyzer. Please refer to Appendix C.7 for more detailed information.

	Appendices\Results
		Description				: The Excel file contains A. three (3) worksheets (i.e., worksheets CH2_1m_SN, CH2_2m_SN, and CH2_4m_SN) showing the PER and SNR values measured at different nodes separations (1 m, 2 m, and 4 m) for packets transmission at 2410 GHz (i.e., the second ZigBee channel in the 2.4GHz PHY) under various modulated monofractal (0.4, 0.8, 1.2, and 1.6) noises in tabular format, B. three (3) worksheets (i.e., worksheets PvSrx_1m, PvSrx_2m, and PvSrx_4m) containing the PER vs. SNR_RX plots for the three nodes separation for the four synthetic noise types, and C. three (3)worksheets containing the calculations required for plotting the MvStx table (worksheet Correct_Stx_20), the table used for plotting the MvStx plot (worksheet MvStx_table) as well as the MvStx plot itself (worksheet MvStx_plot).

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