802.11 Reference Design Experiments Framework: Sample Data

Automatic Download

The wlan_exp package can download the latest sample data files automatically. The auto download method requires the Python ​requests package. To download the sample data automatically open a Python interpreter and run:

import wlan_exp.log.util_sample_data as sample_data_util
sample_data_util.download_sample_data()

The download will proceed automatically. The script will show a progress bar for each file as it downloads.

If successful the output will be similar to:

Downloading 802.11 Reference Design sample data to local directory:
 /work/Mango_Mango_802.11_RefDes_v0.9_beta/python/wlan_exp/log/sample_data

Downloading raw_log_dual_flow_ap.hdf5 (19.30 MB)
[======================================================================]

Downloading raw_log_dual_flow_sta.hdf5 (31.34 MB)
[======================================================================]

Downloading raw_log_one_flow.hdf5 ( 9.11 MB)
[======================================================================]

Downloading np_rx_ofdm_entries.hdf5 ( 5.87 MB)
[======================================================================]

If you do not have the requests package installed you will see this error:

ERROR: auto download requires the Python requests package!

 Please download sample data files manually from:
   http://warpproject.org/w/802.11/wlan_exp/

 Sample data files should be saved in local folder:
   /work/Mango_Mango_802.11_RefDes_v0.9_beta/python/wlan_exp/log/sample_data

To resolve this error, either install requests or proceed with the manual download below.

Manual Download

Use the links below to download the sample data files. These files should be saved to the wlan_exp/log/sample_data folder in your local wlan_exp package.

To verify the correct folder for saving the sample_data files, open a Python interpreter and run:

import wlan_exp.log.util_sample_data as sample_data_util
sample_data_util.get_sample_data_dir()

This method will print the full path of the correct sample_data directory.

Data Files

The files below are sorted by release of the 802.11 Reference Design. The log file format may change between releases of the design. These data files should only be used with the matching version of the wlan_exp package.

0.9-beta Release

File	Size	Link	Description
raw_log_dual_flow_ap.hdf5	19.3 MB	​Download	"Dual Flow" (details below)
raw_log_dual_flow_sta.hdf5	31.3 MB	​Download	"Dual Flow" (details below)
raw_log_one_flow.hdf5	9.1 MB	​Download	"One Flow" (details below)
np_rx_ofdm_entries.hdf5	5.9 MB	​Download	"One Flow" (details below)

Dual Flow Experiment: Please refer to the txrx_log examples for analysis scripts that use these sample data files.

This experiment uses two WARP v3 nodes, one as AP, one as STA. Both nodes are controlled from a Python script. The AP node uses a local traffic generator to send fully-backlogged traffic to the STA for the full duration of the experiment. The STA also uses a fully-backlogged LTG, but only for the middle 30 seconds. This scenario allows measurement of the unidirectional throughput (AP->STA with STA is not transmitting) as well as joint throughput when both nodes are transmitting.

Experiment Summary:

• 2 WARP v3 nodes
  • One AP (MAC address 40:D8:55:04:21:3A)
  • One STA (MAC address 40:D8:55:04:20:BC
• RF A of both nodes connected by coaxial cable with 60dB series attenuation
• Experiment duration ~90 seconds
• Fully backlogged AP -> STA traffic for 90 seconds
• Fully backlogged STA -> AP traffic for middle 30 seconds

One Flow Experiment: