README - Energy Files
SensIT / Collaborative Signal Processing Research Group
Electrical and Computer Engineering
University of Wisconsin Madison

Prepared by Marco F. Duarte
May 21, 2003

Description of files
--------------------

The files in this directory contain the energy information for acoustic, seismic and 
infrared signals recorded during the SITEX02 experiments in Twentynine Palms, CA on 
November, 2001. The files are organized by runs, nodes and modalities. The main 
directory contains the following files:

* sitex02.exe: Executable file to convert original binary data files to ASCII 
               formatted files.
* energies.m:  Matlab script to generate energy information from ASCII data files.
* nodexy.txt:  Location information for the nodes, given in UTM coordinates.

For each run you will find a directory named after the run (AAV3, AAV4, AAV5, AAV6, 
AAV7, AAV8, AAV9, AAV10, AAV11, DW1, DW2, DW3, DW4, DW5, DW6, DW7, DW8, DW9, DW10, 
DW11, DW12). This directory will contain a xxx_gt.txt file (xxx being the run or 
directory name), which contains the ground truth information for the run, or the 
location information in UTM coordinates recorded every 0.75 seconds. The directory 
will also contain several subdirectories: one for each node (n1, n2, n3, n4, n5, n6, 
n41, n42, n46, n47, n48, n49, n50, n51, n52, n53, n54, n55, n56, n58, n59, n60, n61) 
and one for each modality (acoustic_1, seismic_2 and pir_3). The node subdirectories
will contain the energy files for all three modalities for that node, the detection 
label for the node and the timestamp file; the modality subdirectories will contain 
the energy files for all nodes for that modality and the timestamp file. The 
timestamp file is named timestamp.txt; the energy files are named using the 
convention xxxcpann_m.txt and the detection label files are named using the 
convention xxxlabelnn.txt, where xxx is the run name, nn is the node number and m is 
the modality number (1 for acoustic, 2 for seismic and 3 for PIR). 

Description of Extraction
-------------------------

To convert the binary data files into ASCII data files, you will need the sitex02.exe 
file; use the command

sitex02 source.dat > destination.txt

where source.dat is the filename of the binary file and destination.txt is the 
filename of the output ASCII file.

To extract the energy information, run the energies.m script in Matlab using the 
command

energies(runname,nodes)

where runname is the run name in character vector format, and nodes is the vector of 
node numbers. This script requires the ASCII data files to be placed in a subfolder 
named 'output', using the naming convention sensitnn-m-xxx.txt, where xxx is the run 
name, nn is the node number and m is the modality number (1 for acoustic, 2 for 
seismic and 3 for PIR). The energy file will be saved in the 'output' subfolder, 
using the convention xxxcpann_m.txt, where xxx is the run name, nn is the node number 
and m is the modality number (1 for acoustic, 2 for seismic and 3 for PIR). The script
will return 0 when it runs successfully and -1 on error.

Questions or comments, please contact sensit@ece.wisc.edu.

