Main Content

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 statisticsTableworkspace variable.

This table shows the node-specific statistics.

Statistic ParameterDescription

ActiveOperationInFreq

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 ParameterDescription

AppTxAC_BE

Total number of transmitted APP packets of each access category (AC)

AppTxAC_BK

AppTxAC_VI

AppTxAC_VO

APPTxBytes

Total number of bytes transmitted from APP

AppRxAC_BE

Total number of received APP packets of each AC

AppRxAC_BK

AppRxAC_VI

AppRxAC_VO

APPRxBytes

Total number of bytes received from APP

AppTxOverflow

Total number of APP packets overflowed at the medium access control (MAC) layer

AppAvgPacketLatency

Average latency (in microseconds) between the APP at transmitter and receiver

AppAvgPacketLatencyAC_BE

Average packet latency (in microseconds) for each AC at APP

AppAvgPacketLatencyAC_BK

AppAvgPacketLatencyAC_VI

AppAvgPacketLatencyAC_VO

This table shows the statistics captured at the MAC layer.

Statistic ParameterDescription

MACInternalCollisionsAC_BE

Total number of internal collisions experienced by each AC

MACInternalCollisionsAC_BK

MACInternalCollisionsAC_VI

MACInternalCollisionsAC_VO

MACBackoffAC_BE

Total count of MAC random backoff slots at each AC

MACBackoffAC_BK

MACBackoffAC_VI

MACBackoffAC_VO

MACDataTx

Total number of MAC service data units (MSDUs) transmitted, including retransmissions

MACDataTxAC_BE

Total number of MSDUs of each AC transmitted, including retransmissions

MACDataTxAC_BK

MACDataTxAC_VI

MACDataTxAC_VO

MACAggTxAC_BE

Total number of aggregated MAC protocol data units (A-MPDUs) of each AC transmitted, including retransmissions

MACAggTxAC_BK

MACAggTxAC_VI

MACAggTxAC_VO

MACRetries

Total number of retransmitted MSDUs

MACTxRetriesAC_BE

Total number of retransmitted MSDUs of each AC

MACTxRetriesAC_BK

MACTxRetriesAC_VI

MACTxRetriesAC_VO

MACAckTx

Total number of MAC acknowledgment (ACK) frames transmitted

MACBATx

Total number of MAC block ACK (BA) frames transmitted

MACRTSTx

Total number of MAC request to send (RTS) frames transmitted

MACCTSTx

Total number of MAC clear to send (CTS) frames transmitted

MACDataTxBytes

Total number of MAC data bytes successfully transmitted

MACDataRxBytes

Total number of MAC data bytes received

MACControlTxBytes

Total number of MAC control bytes transmitted

MACControlRxBytes

Total number of MAC control bytes received

MACTxQueueOverflow

Total number of MAC transmission queue overflows

MACTxFails

Total number of MAC transmission failures

MACRx

Total number of MAC frames successfully received

MACDataRx

Total number of MAC data frames (destined to the node) successfully received

MACDataRxAC_BE

Total number of MAC data frames successfully received at each AC

MACDataRxAC_BK

MACDataRxAC_VI

MACDataRxAC_VO

MACAggRxAC_BE

Total number of MAC aggregated frames received at each AC, in which at least one subframe is successful

MACAggRxAC_BK

MACAggRxAC_VI

MACAggRxAC_VO

MACAggRx

Total number of MAC aggregated frames received

MACDuplicateAMPDURx

Total number of MAC aggregated duplicate frames received

MACNonHTRx

Total number of MAC non-high throughput (non-HT) frames received

MACHTRx

Total number of MAC HT frames received

MACVHTRx

Total number of MAC very-high throughput (VHT) frames received

MACHESURx

Total number of MAC high-efficiency single user (HE-SU) frames received

MACHEEXTSURx

Total number of MAC HE extended SU (HE-EXT-SU) frames received

MACHEMURx

Total number of HE-multi user (HE-MU) frames received

MACRxDrop

Total number of MAC frames dropped at MAC

MACCRCFailures

Total number of MAC frames received with cyclic redundancy check (CRC) failures

MACAckRx

Total number of MAC ACK frames received

MACRTSRx

Total number of MAC RTS frames received

MACCTSRx

Total number of MAC CTS frames received

MACBARx

Total number of MAC BA frames received

MACRespErrors

Total number of MAC errored response frames ( CTS, ACK, and BA) received, while waiting for response frames

MACNonRespFrames

Total number of MAC frames received, other than the response frame, while waiting for response frame

MACOthersFramesInWaitForResp

Total number of MAC response frames (destined to other nodes) received, while waiting for the corresponding response frame

IdleStateTime

Time spent in idle state in microseconds

ContendStateTime

Time spent in contention state in microseconds

SendingDataStateTime

Time spent in transmission state in microseconds

WaitForRxStateTime

Time spent in wait for response state in microseconds

EIFSStateTime

Time spent in extended interframe space (EIFS) state (microseconds)

RxStateTime

Time spent in reception state in microseconds

MACThroughput

MAC layer throughput

MACThroughputAC_BE

MAC layer throughput per AC

MACThroughputAC_BK

MACThroughputAC_VI

MACThroughputAC_VO

MACAverageTimePerFrame

Average time spent by packet in MAC, including retransmissions

MACTxSuccess

Number of acknowledged MPDUs or A-MPDU subframes

PacketLossRatio

Ratio of number of lost packets to total number of sent packets

MACMaxQueueLengthAC_BE

Maximum queue length (for each AC) reached during simulation

MACMaxQueueLengthAC_BK

MACMaxQueueLengthAC_VI

MACMaxQueueLengthAC_VO

MACDuplicateRxAC_BE

Total number of duplicate MAC frames of each AC dropped at MAC

MACDuplicateRxAC_BK

MACDuplicateRxAC_VI

MACDuplicateRxAC_VO

MACRTSSuccess

Total number of successful RTS transmissions

MACRecentFrameStatusTimestamp

Timestamp at which recent MAC frame transmission status is known

MACNumBasicNavUpdates

Total number of network allocation vector (NAV) updates

This table shows the statistics captured at the PHY.

Statistic ParameterDescription

PhyNumTransmissions

Total number of waveforms transmitted

PhyTxBytes

Total number of payload bytes transmitted by PHY

PhyTxTime

Amount of time for which PHY is transmitting

EnergyDetectionsLessThanED

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

TotalRxInterferenceTime

Total duration of interference experienced while reception is in progress

RxTriggersWhilePrevRxIsInProgress

Total number of receptions while previous reception is in progress

RxTriggersWhileTxInProgress

Total number of receptions while transmission is in progress

PhyPreambleDecodeFailures

Total number of PHY preamble failures

PhyHeaderDecodeFailures

Total number of PHY header decode failures

PhyRx

Total number of waveforms successfully received

PhyRxDrop

Total number of receiving waveforms dropped

PHYRxBytes

Total number of payload bytes received at PHY

Add Custom Statistics

You can add custom statistics at any layer of a WLAN node by using these helper objects based on the specific layer.

  • hApplication for the APP

  • hEDCAMAC for the MAC

  • hPHYTxInterface and hPHYRxInterface for the PHY

To add your own custom statistic parameter, follow these steps.

  1. Open the helper object corresponding to the layer in which you want to add the custom statistic parameter.

  2. In the 'properties', specify a custom statistic parameter.

  3. In the concerned functions, add your code to update the custom statistic parameter.

  4. In the getMetricsList function of the helper object corresponding to the layer, add the custom statistic parameter in the availableMetrics cell array.

  5. Run the simulation.

The custom statistic parameter appears in the statisticsTable workspace variable.

Related Topics