This is a README file. It will elucidate you.

This tarball contains data used in these publications:

@INPROCEEDINGS{AndersonSigMetrics2008,
  author = {Eric Anderson and Caleb Phillips and Kevin Bauer and Douglas Sicker
	and Dirk Grunwald},
  title = {Modeling Directionality in Wireless Networks [Extended Abstract]},
  booktitle = {ACM SigMetrics},
  year = {2008},
}
@TECHREPORT{AndersonTechReport2008,
  author = {Eric Anderson and Caleb Phillips and Douglas Sicker and Dirk Grunwald},
  title = {Modeling Environmental Effects on Directionality in Wireless Networks},
  institution = {University of Colorado at Boulder},
  year = {2008},
  url = {http://www.cs.colorado.edu/department/publications/reports/docs/CU-CS-1044-08.pdf}
}
@INPROCEEDINGS{AndersonWiNMee2009,
  author = {Eric Anderson and Caleb Phillips and Douglas Sicker and Dirk Grunwald},
  title = {Modeling Environmental Effects on Directionality in Wireless Networks},
  booktitle = {5th International workshop on Wireless Network Measurements (WiNMee)},
  year = {2009},
}
@INPROCEEDINGS{AndersonWiOpt2009,
  author = {Eric Anderson and Gary Yee and Caleb Phillips and Douglas Sicker
	and Dirk Grunwald},
  title = {The Impact of Directional Antenna Models on Simulation Accuracy},
  booktitle = {7th International Symposium on Modeling and Optimization in Mobile,
	Ad Hoc, and Wireless Networks (WiOpt)},
  year = {2009},
}

If you want some information on how the data was used, and details about
how it was collected, the above tech-report is a good place to start.

This dataset involves 2 files with the following described formats:

::: baseline.txt.bz2 :::

Clean "reference" antenna measurements supplied to us by the
manufacturer or taken with a VSG and VSA in a remote floodplain. Contains a header
line followed by newline-delimited records of whitespace-delimited fields. The
first column is just the record number and doesn't correspond to a header label.
This is kind of confusing, but it's the native format for R's read.table() and
write.table(), so if you use R, your life is especially easy. If you don't,
a command like this will put the data in a more ammenable format:

  bzip2 -cd baseline.txt.bz2 | tail -n $((`bzip2 -d -c baseline.txt.bz2 | wc -l`-1)) \
    | cut -f 2- -d ' ' > baseline.txt

Okay, let's look at the file:

  cphillips@shannon:~/data$ bzip2 -dc baseline.txt.bz2 | head -n 2
  "position" "ctr" "batch" "tag" "norm.rss"
  "1" 0 -34.0841277279277 "patch" "default" -0.313844191808094

The fields are (i.e. as appear L to R in the 2-Nth line):

  - id: quoted record id as produced by R's write.table()
  - position: angle about the azimuth
  - ctr: measured power value at center frequency with noise floor subtracted (i.e. RSS)
  - batch: experiment/antenna label: patch, parabolic, or patty (patty is an 8-element
           uniform circular phased-array antenna)
  - tag: always default. used as a sub-batch identifier
  - norm.rss -  Within a given trace (i.e., unique batch/tag), the normalized RSS of
    each packet is defined as the absolute RSS less the "reference
    maximum" for that trace.  The reference maximum is the greatest
    mean value for any angle within the trace.

::: packets.txt.bz2 :::

In-situ antenna measurements taken using (calibrated) commodity 802.11
hardware. File format is the same as above.

  cphillips@shannon:~/data$ bzip2 -dc packets.txt.bz2 | head -n 2
  "rss" "batch" "position" "tag" "norm.rss" "norm.diff"
  "1" 48 "parabolic-field2" 0 "default" -2.66053226698007 2.66053226698007

The fields are (i.e. as appear L to R in the 2-Nth line)

  - id: quoted record id as produced by R's write.table()
  - rss: packet received signal strength as reported by the MadWiFi driver
  - batch: same as above
  - tag: near, far, or default. used as a sub-batch identifier for the indoor
    experiments.
  - norm.rss: same as above
  - norm.diff: normalized difference from the corresponding baseline pattern

The batch/tag names are related to the "pretty names" used in our 
2008 tech. report by the following space-delimited mapping:

pretty-name batch tag
Parabolic-Outdoor-A parabolic-field2 default
Parabolic-Outdoor-B para-floodplain default
Parabolic-Indoor-A indoor-lab default
Parabolic-Indoor-B parabolic-cinc far
Parabolic-Indoor-C parabolic-cinc near
Parabolic-Reference parabolic default
Patch-Outdoor-A patch-field default
Patch-Outdoor-B patch-floodplain default
Patch-Indoor-A patch-indoor-lab2 default
Patch-Indoor-B patch-cinc far
Patch-Indoor-C patch-cinc near
Patch-Reference patch default
Array-Outdoor-A patty-field default
Array-Indoor-A patty-cinc-1 default
Array-Indoor-B patty-cinc-7 default
Array-Reference patty default

If you have any questions or comments, let us know:

  Eric Anderson <eric.anderson@colorado.edu>
  Caleb Phillips <caleb.phillips@colorado.edu>

Particularly, if you use our data in your work, please cite us. The WiNMee paper
is probably the best citation for that purpose.

Happy hacking :)