Contents[Hide]
Download zip archive

Description

MATLAB scripts that let you visualize and analyze radar and microphone data collected by the BumbleBee Radar Data Collector and the Kiwi Microphone Data Collector. If you have access to MATLAB or a compatible program such as Octave, you can run the scripts.

Compatibility

eMote.NOW 1.0, eMote version 4.3.1.12 and Visual Studio 2012.

BumbleBee Radar Scripts

Use the BumbleBee Radar Data Collector to collect data. Then exfiltrate the data to a PC using Data Collector Exfiltrator and the Data Collector Host app notes. The resulting file will have an extension of ".data" automatically assigned. 

Open MATLAB. Navigate to the the location of the app note's radar scripts. For your convenience, there is a sample radar data file "IQTest.data" present in the folder.

PlotRadarData

This will produce a plot showing the I and Q values. From the MATLAB command window, run

PlotRadarData('file path and name', sample interval, IQ format, start time, end time)

The arguments are as follows:

  • file path and name: The name of the file, prepended with path if necessary. The extension ".data" will be added by the script.
  • sample interval: The number of microseconds between samples. For the BumbleBee Radar Data Collector this value is 3906.
  • IQ format: For the BumbleBee Radar Data Collector, the value is 0, which means the data file consists of alternating I and Q values. For other radar data collection programs that write data as blocks of I followed by blocks of Q, enter the block size.
  • start time: The offset of the first second's worth of data to consider; 0 for the start of the data. In some cases you may want to limit the data, so you can specify the beginning sample. Since the argument is in seconds, the first sample to consider is found by using the argument (if not zero) and the sample interval.
  • end time: The offset of the last second's worth of data to consider; 0 for the end of the data. 

A typical invocation of is

PlotRadarData('IQTest',3906,0,0,0)

RadarDataLength

This will give information about the data, including number of samples and duration in seconds. From the MATLAB command window, run

RadarDataLength('file path and name', sample interval)

The two arguments are as for PlotRadarData.

Kiwi Microphone Scripts

Use the Kiwi Microphone Data Collector to collect data. Then exfiltrate the data to a PC using Data Collector Exfiltrator and the Data Collector Host app notes. The resulting file will have an extension of ".data" automatically assigned. 

Open MATLAB. Navigate to the location of the app note's microphone scripts. For your convenience, there is a sample microphone data file "MicTest.data" present in the folder.

PlotMicData

This will produce a plot of the data. From the MATLAB command window, run

PlotMicData('file path and name', sample interval, start time, end time)

The arguments are as for PlotRadarData. For the Kiwi Microphone Data Collector app note, the sample interval is 1000. A typical invocation is

PlotMicData('MicTest',1000,0,0)

MicDataLength

This will give information about the data, including number of samples and duration in seconds. From the MATLAB command window, run

RadarDataLength('file path and name', sample interval)

The two arguments are as for PlotMicData.