Statistics Captured in WLAN System-Level Simulation
WLAN system-level simulation captures these statistics in the
statistics
MAT file. If the
displayStatsInUITable
workspace variable is enabled at the end of
simulation, you can visualize these statistics in the
statisticsTable
workspace variable.
This table shows the node-specific statistics.
Statistic Parameter | Description |
---|---|
| Flag indicating whether the node is operated in the specified frequency |
This table shows the statistics captured at the application layer (APP). The statistic
parameter name endings _BE
,
_BK
, _VI
, and _VO
indicate best effort, background, video traffic, and
voice traffic, respectively.
Statistic Parameter | Description |
---|---|
| Total number of transmitted APP packets of each access category (AC) |
| |
| |
| |
| Total number of bytes transmitted from APP |
| Total number of received APP packets of each AC |
| |
| |
| |
| Total number of bytes received from APP |
| Total number of APP packets overflowed at the medium access control (MAC) layer |
| Average latency (in microseconds) between the APP at transmitter and receiver |
| Average packet latency (in microseconds) for each AC at APP |
| |
| |
|
This table shows the statistics captured at the MAC layer.
Statistic Parameter | Description |
---|---|
| Total number of internal collisions experienced by each AC |
| |
| |
| |
| Total count of MAC random backoff slots at each AC |
| |
| |
| |
| Total number of unicast nonmesh MAC service data units (MSDUs) transmitted, including retransmissions |
| Total number of unicast nonmesh MSDUs of each AC transmitted, including retransmissions |
| |
| |
| |
| Total number of broadcast MSDUs transmitted |
| Total number of broadcast MSDUs of each AC transmitted |
| |
| |
| |
| Total number of aggregated MAC protocol data units (A-MPDUs) of each AC transmitted, including retransmissions |
| |
| |
| |
| Total number of MSDUs transmitted |
| Total number of MSDUs of each AC transmitted |
| |
| |
| |
| Total number of retransmitted MSDUs |
| Total number of retransmitted MSDUs of each AC |
| |
| |
| |
| Total number of MAC acknowledgment (ACK) frames transmitted |
| Total number of MAC block ACK (BA) frames transmitted |
| Total number of MAC multiuser (MU) block ACK request (BAR) frames transmitted |
| Total number of MAC request-to-send (RTS) frames transmitted |
| Total number of MAC MU-RTS frames transmitted |
| Total number of MAC clear to send (CTS) frames transmitted |
| Total number of MAC data bytes successfully transmitted |
| Total number of MAC data bytes received |
| Total number of MAC control bytes transmitted |
| Total number of MAC control bytes received |
| Total number of MAC transmission queue overflows |
| Total number of MAC transmission failures |
| Total number of MAC frames successfully received |
| Total number of unicast nonmesh MAC data frames (destined to the node) received successfully |
| Total number of unicast nonmesh MAC data frames (destined to the node) of each AC received successfully |
| |
| |
| |
| Total number of MAC broadcast data frames received successfully |
| Total number of MAC broadcast data frames of each AC received successfully |
| |
| |
| |
| Total number of MAC aggregated frames received at each AC, in which at least one subframe is successful |
| |
| |
| |
| Total number of MAC aggregated frames received |
| Total number of MAC aggregated duplicate frames received |
| Total number of MAC non-high throughput (non-HT) frames received |
| Total number of MAC HT frames received |
| Total number of MAC very-high throughput (VHT) frames received |
| Total number of MAC high-efficiency single user (HE-SU) frames received |
| Total number of MAC HE extended SU (HE-EXT-SU) frames received |
| Total number of HE-multi user (HE-MU) frames received |
| Total number of MAC frames dropped at MAC |
| Total number of MAC frames received with cyclic redundancy check (CRC) failures |
| Total number of received MAC aggregated frames in which no delimiter is found |
| Total number of MAC ACK frames received |
| Total number of MAC RTS frames received |
| Total number of MAC CTS frames received |
| Total number of MAC BA frames received |
| Total number of MAC errored response frames ( CTS, ACK, and BA) received, while waiting for response frames |
| Total number of MAC frames received, other than the response frame, while waiting for response frame |
| Total number of MAC response frames (destined to other nodes) received, while waiting for the corresponding response frame |
| Time spent in idle state in microseconds |
| Time spent in contention state in microseconds |
| Time spent in transmission state in microseconds |
| Time spent in wait for response state in microseconds |
| Time spent in extended interframe space (EIFS) state (microseconds) |
| Time spent in reception state in microseconds |
| MAC layer throughput |
| MAC layer throughput per AC |
| |
| |
| |
| Number of acknowledged MPDUs or A-MPDU subframes |
| Ratio of number of lost packets to total number of sent packets |
| Maximum queue length (for each AC) reached during simulation |
| |
| |
| |
| Total number of duplicate MAC frames of each AC dropped at MAC |
| |
| |
| |
| Total number of successful RTS transmissions |
| Total number of successful MU-RTS transmissions |
| Timestamp at which recent MAC frame transmission status is known |
| Total number of network allocation vector (NAV) updates |
| Total number of unicast mesh MSDUs transmitted, including retransmissions |
| Total number of unicast mesh MSDUs of each AC transmitted, including retransmissions |
| |
| |
| |
| Total number of unicast mesh MAC data frames (destined to the node) received successfully |
| Total number of unicast mesh MAC data frames (destined to the node) of each AC received successfully |
| |
| |
|
This table shows the statistics captured at the PHY.
Statistic Parameter | Description |
---|---|
| Total number of waveforms transmitted |
| Total number of payload bytes transmitted by PHY |
| Amount of time for which PHY is transmitting |
| Total number of PHY energy detections that are less than energy detection (ED) threshold This statistic is evaluated for each received signal at the PHY receiver. If the signal power is less than the ED threshold, this statistic is incremented |
| Total duration of interference experienced while reception is in progress |
| Total number of receptions while previous reception is in progress |
| Total number of receptions while transmission is in progress |
| Total number of PHY preamble failures |
| Total number of PHY header decode failures |
| Total number of waveforms successfully received |
| Total number of receiving waveforms dropped |
| Total number of payload bytes received at PHY |
This table shows the mesh statistics.
Statistic Parameter | Description |
---|---|
| Total number of MSDUs pushed into MAC queue for forwarding |
| Total number of MSDUs of each AC pushed into MAC queue for forwarding |
| |
| |
| |
| Total number of data bytes pushed into MAC queue for forwarding |
| Total number of data bytes of each AC pushed into MAC queue for forwarding |
| |
| |
| |
| Total number of MSDUs dropped while forwarding because no further path exists |
| Total number of duplicate MSDUs dropped |
| Total number of MSDUs dropped due to insufficient mesh forward hop count |
Add Custom Statistics
You can add custom statistics at any layer of a WLAN node by using these helper objects.
hApplication
for the APPhEDCAMAC
for the MAChPHYTxInterface
andhPHYRxInterface
for the PHYhMeshBridge
for mesh
To add your own custom statistic parameter, follow these steps.
Open the helper object corresponding to the layer in which you want to add the custom statistic parameter.
In the 'properties', specify a custom statistic parameter.
In the concerned functions, add your code to update the custom statistic parameter.
In the
getMetricsList
function of the helper object corresponding to the layer, add the custom statistic parameter in theavailableMetrics
cell array.Run the simulation.
The custom statistic parameter appears in the statisticsTable
workspace variable.
Related Topics
- WLAN Node Composition and Configuration
- 802.11ax Multinode System-Level Simulation of Residential Scenario Using MATLAB
- Get Started with WLAN System-Level Simulation in MATLAB
- MAC and PHY Layer Abstraction in System-Level Simulation
- Create and Visualize 802.11ax Multinode Residential Scenario
- Configure Uplink and Downlink Traffic at 802.11ax Access Point
- Visualize Node State Transitions in 802.11ax System-Level Simulation