ns3 mmWave traces

This wiki page lists the meaning of the values in the file traces generated by ns3-mmWave. In particular, we use the mc-twoenbs.cc example as a reference.

Please notice that it is always possible to take a look at the helper classes to understand (and eventually modify) the content of the traces.

Data traces

According to the simulation setup, it is possible to generate PDCP and RLC logs in the LTE format or with a packet by packet log.

RxPacketTrace.txt

This file is generated by the MmWavePhyRxTrace. It lists all the DL and UL data packets received by the MmWaveSpectrumPhy classes. Each row has the following format:

mode time frame subF 1stSym symbol# cellId rnti ccId tbSize mcs rv SINR(dB) corrupt TBler, where:

• mode is DL if the packet has been received by an UE, UL if the packet has been received by an eNB
• time the reception time
• frame the frame index
• subF the subframe index
• 1stSym the index of the first symbol
• symbol# the number of allocated symbols
• cellId the cell ID
• rnti the RNTI
• ccId the component carrier ID
• tbSize the transport block size
• mcs the MCS value
• rv the number of HARQ retransmissions
• SINR(dB) the SINR value
• corrupt is 0 if the TB has been correctly received, 1 otherwise
• TBler the TB error rate

Dl[Ul]Rlc[Pdcp]Stats.txt

These files are generated either in MmWaveBearerStatsCalculator or LteBearerStatsCalculator classes. For the first class, each row contains the following:

Tx Time CellId RNTI LCID packetSize for each transmitted packet (by default, we don't log PDCP TX: it is possible to enable them by uncommenting the m_txPdu trace in McEnbPdcp, LtePdcp and McUePdcp.

Rx Time CellId RNTI LCID packetSize delay for each received packet. The delay is in nanoseconds.

X2Stats.txt

This file is generated by CoreNetworkStatsCalculator, and its name can be modified using the attributes of this class. Each line logs the reception of an X2 packet:

Time SourceCellId TargetCellId size delay

RlcAmBufferSize.txt

This file is generated by the LteRlcAm class to log (every 10 ms) the occupancy of the buffer with packets received by the PDCP but not yet transmitted. Each line contains:

Time RNTI LCID bufferSize

Mobility traces

The following files are generated by MmWaveBearerStatsConnector, and their name can be modified using the attributes of this class.

CellIdStatsHandover.txt

Each row is generated when an UE completes a handover successfully, i.e., when the RRC transitions from CONNECTED_HANDOVER to CONNECTED_NORMALLY after a successful RA. The content of each row is:

Time IMSI RNTI TargetCellId

EnbHandoverStartStats.txt

Each row is generated when the target eNB starts the handover procedure, either by sending the RRC Connection Reconfiguration message. The content of each row is:

Time IMSI RNTI SourceCellId TargetCellId

EnbHandoverEndStats.txt

Each row is generated when the target eNB completes the handover procedure successfully, either by sending the UE Context Release message or the Secondary Cell Handover Completed message (for secondary cell handovers). The content of each row is:

Time IMSI RNTI TargetCellId

UeHandoverStartStats.txt

Each row is generated when an UE starts a handover, i.e., when the UE receives a RRC Connection Reconfiguration message with MobilityControlInformation. The content of each row is:

Time IMSI RNTI SourceCellId TargetCellId

UeHandoverEndStats.txt

Each row is generated when an UE completes a handover successfully, i.e., when the RRC transitions from CONNECTED_HANDOVER to CONNECTED_NORMALLY after a successful RA. The content of each row is:

Time IMSI RNTI TargetCellId

---

The following files are generated by McStatsCalculator, and their name can be modified using the attributes of this class.

CellIdStats.txt

Each row is generated when an UE switches between an LTE and mmWave cell or vice versa, i.e., when the RRC receives a RRC Connection Switch message. The content of each row is:

Time IMSI CellId RNTI

MmWaveSwitchStats.txt

Each row is generated when an UE switches between a mmWave and an LTE cell, i.e., when the RRC receives a RRC Connection Switch message towards a mmWave cell. The content of each row is:

Time IMSI CellId RNTI

LteSwitchStats.txt

Each row is generated when an UE switches between an LTE and a mmWave cell, i.e., when the RRC receives a RRC Connection Switch message towards an LTE cell. The content of each row is:

Time IMSI CellId RNTI

SINR

The following files are generated by MmWaveBearerStatsConnector, and their name can be modified using the attributes of this class.

MmWaveSinrTime.txt

Log the SINR of the UE with respect to mmWave cells as measured with the uplink sounding procedure.

Time IMSI CellId SINR[dB]

LteSinrTime.txt

Log the SINR of the UE with respect to LTE cells as measured with the CQIs in LteUePhy.

Time RNTI CellId SINR