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 unicast nonmesh MAC service data units (MSDUs) transmitted, including retransmissions

MACDataTxAC_BE

Total number of unicast nonmesh MSDUs of each AC transmitted, including retransmissions

MACDataTxAC_BK

MACDataTxAC_VI

MACDataTxAC_VO

MACBroadcastDataTx

Total number of broadcast MSDUs transmitted

MACBroadcastDataTxAC_BE

Total number of broadcast MSDUs of each AC transmitted

MACBroadcastDataTxAC_BK

MACBroadcastDataTxAC_VI

MACBroadcastDataTxAC_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

MACMSDUTx

Total number of MSDUs transmitted

MACMSDUTxAC_BE

Total number of MSDUs of each AC transmitted

MACMSDUTxAC_BK

MACMSDUTxAC_VI

MACMSDUTxAC_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

MACMUBARTx

Total number of MAC multiuser (MU) block ACK request (BAR) frames transmitted

MACRTSTx

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

MACMURTSTx

Total number of MAC MU-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 unicast nonmesh MAC data frames (destined to the node) received successfully

MACDataRxAC_BE

Total number of unicast nonmesh MAC data frames (destined to the node) of each AC received successfully

MACDataRxAC_BK

MACDataRxAC_VI

MACDataRxAC_VO

MACBroadcastDataRx

Total number of MAC broadcast data frames received successfully

MACBroadcastDataRxAC_BE

Total number of MAC broadcast data frames of each AC received successfully

MACBroadcastDataRxAC_BK

MACBroadcastDataRxAC_VI

MACBroadcastDataRxAC_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

MACAMPDUDecodeFailures

Total number of received MAC aggregated frames in which no delimiter is found

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

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

MACMURTSSuccess

Total number of successful MU-RTS transmissions

MACRecentFrameStatusTimestamp

Timestamp at which recent MAC frame transmission status is known

MACNumBasicNavUpdates

Total number of network allocation vector (NAV) updates

MACMeshDataTx

Total number of unicast mesh MSDUs transmitted, including retransmissions

MACMeshDataTxAC_BE

Total number of unicast mesh MSDUs of each AC transmitted, including retransmissions

MACMeshDataTxAC_BK

MACMeshDataTxAC_VI

MACMeshDataTxAC_VO

MACMeshDataRx

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

MACMeshDataRxAC_BE

Total number of unicast mesh MAC data frames (destined to the node) of each AC received successfully

MACMeshDataRxAC_BK

MACMeshDataRxAC_VI

MACMeshDataRxAC_VK

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

This table shows the mesh statistics.

Statistic ParameterDescription

MeshForwardTx

Total number of MSDUs pushed into MAC queue for forwarding

MeshForwardTxAC_BE

Total number of MSDUs of each AC pushed into MAC queue for forwarding

MeshForwardTxAC_BK

MeshForwardTxAC_VI

MeshForwardTxAC_VO

MeshForwardTxBytes

Total number of data bytes pushed into MAC queue for forwarding

MeshForwardTxBytesAC_BE

Total number of data bytes of each AC pushed into MAC queue for forwarding

MeshForwardTxBytesAC_BK

MeshForwardTxBytesAC_VI

MeshForwardTxBytesAC_VO

MeshForwardDrop

Total number of MSDUs dropped while forwarding because no further path exists

MeshDuplicateDrop

Total number of duplicate MSDUs dropped

MeshInsufficientTTLDrop

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 APP

  • hEDCAMAC for the MAC

  • hPHYTxInterface and hPHYRxInterface for the PHY

  • hMeshBridge for mesh

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