Changes between Version 8 and Version 9 of WARPLab/Reference/Utility

Timestamp:

Aug 22, 2013, 3:49:37 PM (11 years ago)

Author:

welsh

Comment:

--

WARPLab/Reference/Utility

@@ -97 +97 @@
 will create a vector of wl_node objects in the variable {{{nodes}}} that contains one node per line of the configuration file.  
 
+== wl_benchmark (WARPLab 7.3.0 and later)==
+File source: [browser:ResearchApps/PHY/WARPLAB/WARPLab7/M_Code_Reference/util/wl_benchmark.m wl_benchmark.m]
+
+With the release of WARPLab 7.3.0, wl_benchmark is now available to perform some basic WARPLab benchmarks on your system setup.  The current benchmarks are:
+  * Available in WARPLab 7.3.0 or later
+    * Read IQ:  'read_iq'
+    * Write IQ: 'write_iq'
+
+As more benchmarks are developed, these will be added to the wl_benchmark utility.  To run the utility, you must pass in:
+  * Array of [wiki:../Architecture/Classes#Node wl_node] objects
+  * Benchmark to be run
+  * Number of trials to be run
+  * Number of samples to be used as part of the benchmark
+    * For WARP v2 hardware, this is between 1 and 16384
+    * For WARP v3 hardware, this is between 1 and 32768
+    * Can use the keyword 'max' to run the maximum number of samples for the hardware
+
+For more information on the WARPLab benchmarks, please visit the [wiki:WARPLab/Benchmarks Benchmarks] page.
+
+
+Examples:
+
+NOTE:  This was performed after running [wiki:WARPLab/Reference/Utility#wl_setup wl_setup] to configure the [wiki:WARPLab/Framework/Modules#Transport Transport] and Ethernet Packet Size.
+
+{{{
+>> nodes = wl_initNodes(1);
+>> results = wl_benchmark( nodes, 'read_iq', 1000, 'max' );
+------------------------------------------------------------
+Running on node 1 of 1:  ID =    0  Serial Number =   W3-a-00006
+------------------------------------------------------------
+Displaying results of 1 nodes:
+
+-------------------------------------------------------------------------------------------------------------
+|  ID |  WLVER |    Serial # |   Transport | Pkt Size (B) | Num Samples | Num Trials |  Avg Read IQ per sec |
+-------------------------------------------------------------------------------------------------------------
+|   0 |  7.3.0 |  W3-a-00006 |    Java UDP |         8960 |       32768 |       1000 |              71.0523 |
+-------------------------------------------------------------------------------------------------------------
+}}}
+
+or 
+
+{{{
+>> nodes = wl_initNodes(1);
+>> results = wl_benchmark( nodes, 'write_iq', 1000, 1000 );
+------------------------------------------------------------
+Running on node 1 of 1:  ID =    0  Serial Number =   W3-a-00006
+------------------------------------------------------------
+Displaying results of 1 nodes:
+
+-------------------------------------------------------------------------------------------------------------
+|  ID |  WLVER |    Serial # |   Transport | Pkt Size (B) | Num Samples | Num Trials | Avg Write IQ per sec |
+-------------------------------------------------------------------------------------------------------------
+|   0 |  7.3.0 |  W3-a-00006 |    Java UDP |         1464 |        1000 |       1000 |             330.0903 |
+-------------------------------------------------------------------------------------------------------------
+}}}
+
+