Changes between Version 3 and Version 4 of 802.11/wlan_exp/sample_data

Timestamp:

Apr 12, 2014, 10:47:42 PM (10 years ago)

Author:

murphpo

Comment:

--

802.11/wlan_exp/sample_data

@@ -9 +9 @@
 == Automatic Download ==
 
+The wlan_exp package can download the latest sample data files automatically. The auto download method requires the Python [http://docs.python-requests.org/en/latest/ requests] package.
+To download the sample data automatically open a Python interpreter and run:
 {{{#!python
 import wlan_exp.log.util_sample_data as sample_data_util
@@ -14 +16 @@
 }}}
 
+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:
+{{{#!python
+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  =||=  URL  =||
-|| raw_log_dual_flow_ap.hdf5 || 19.3 MB || [http://warpproject.org/dl/refdes/802.11/sample_data/0.9/raw_log_dual_flow_ap.hdf5 Download] ||
-|| raw_log_dual_flow_sta.hdf5 || 31.3 MB || [http://warpproject.org/dl/refdes/802.11/sample_data/0.9/raw_log_dual_flow_sta.hdf5 Download] ||
-|| raw_log_one_flow.hdf5 || 9.1 MB || [http://warpproject.org/dl/refdes/802.11/sample_data/0.9/raw_log_one_flow.hdf5 Download] ||
-|| np_rx_ofdm_entries.hdf5 || 5.9 MB || [http://warpproject.org/dl/refdes/802.11/sample_data/0.9/np_rx_ofdm_entries.hdf5 Download] ||
+||=  File  =||=  Size  =||=  Link  =||=  Description  =||
+|| raw_log_dual_flow_ap.hdf5 || 19.3 MB || [http://warpproject.org/dl/refdes/802.11/sample_data/0.9/raw_log_dual_flow_ap.hdf5 Download] || "Dual Flow" (details below) ||
+|| raw_log_dual_flow_sta.hdf5 || 31.3 MB || [http://warpproject.org/dl/refdes/802.11/sample_data/0.9/raw_log_dual_flow_sta.hdf5 Download] || "Dual Flow" (details below) ||
+|| raw_log_one_flow.hdf5 || 9.1 MB || [http://warpproject.org/dl/refdes/802.11/sample_data/0.9/raw_log_one_flow.hdf5 Download] || "One Flow" (details below) ||
+|| np_rx_ofdm_entries.hdf5 || 5.9 MB || [http://warpproject.org/dl/refdes/802.11/sample_data/0.9/np_rx_ofdm_entries.hdf5 Download] || "One Flow" (details below) ||
+
+'''Dual Flow Experiment''':
+Please refer to the [wiki:../examples/txrx_log 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''':