Tr38901ChannelModel

Package: simu5g.stack.phy.channelmodel

Tr38901ChannelModel

simple module

StochasticChannelModel preset with the propagation formulas of 3GPP TR 38.901, "Study on channel model for frequencies from 0.5 to 100 GHz", v16.1.0, December 2019. It differs from its base type only in the pathLossType default; there is no C++ class of its own behind the name. Note that the study supplies the path loss, LOS probability, shadowing and angular attenuation only; the rest of the link model is the same for every propagation study.

This is the default channel model of the gNodeB NIC and of the NR side of the NR UE NIC.

Inheritance diagram

The following diagram shows inheritance relationships for this type. Unresolved types are missing from the diagram.

Extends

Name Type Description
StochasticChannelModel simple module

The full PHY link model: everything between a transmitted air frame and the decision on whether it was received. The channel impairments are modeled statistically -- drawn from the distributions of a 3GPP propagation study, rather than computed from the geometry of an actual environment -- which is what sets this model apart from IdealChannelModel, where there are no impairments at all, only a configured packet error rate.

Parameters

Name Type Default value Description
binderModule string "binder"
cellInfoModule string "^.^.cellInfo"

Optional

componentCarrierModule string "carrierAggregation.componentCarrier[0]"

Component carrier for this channel model

pathLossType string "Tr38901"

Which 3GPP propagation study supplies the path loss formulas

shadowing bool true

Enable/disable shadowing

scenario string "URBAN_MACROCELL"

Path loss scenario, in ITU terminology

nodebHeight double 25m

eNodeB height

buildingHeight double 20m

Building height

insideBuilding bool false

Determines if the UE is inside a building

useBuildingPenetrationHighLossModel bool false

Enable the high-loss building penetration model (table 7.4.3-2 in TR 38.901); only used with pathLossType="Tr38901"

streetWidth double 20m
ueHeight double 1.5m
tolerateMaxDistViolation bool false
useTorus bool false
correlationDistance double 50m
targetBler double 0.01

Target BLER used to compute feedback

harqReduction double 0.2

Factor the error probability is multiplied by for each HARQ retransmission

antennaGainUe double 0dBi

Antenna gain of the UE

antennGainEnB double 18dBi

Antenna gain of the eNodeB

antennGainMicro double 5dBi

Antenna gain of the micro node

thermalNoise double -104.5dBm

Thermal noise for 10 MHz of bandwidth

ueNoiseFigure double 7dBm

UE noise figure

bsNoiseFigure double 5dBm

eNodeB noise figure

cableLoss double 2dB

Cable loss

dynamicLos bool false

Whether LOS/NLOS is drawn per link from the scenario's LOS probability; when false, it is fixed to fixedLos

fixedLos bool false

LOS state of every link when dynamicLos is false: true = LOS, false = NLOS

fading bool true

Enable/disable fading

fadingType string "JAKES"

Fading type (JAKES or RAYLEIGH)

numFadingPaths int 6

If Jakes fading, this parameter specifies the number of paths (tap channel)

delayRms double 363ns
bgCellInterference bool true

Whether interference from background cells is included in the SINR, in both UL and DL

extCellInterference bool true

Whether interference from external cells is included in the DL SINR (TODO possibly obsolete)

downlinkInterference bool false

Whether interference from other base stations is included in the DL SINR

uplinkInterference bool false

Whether interference from the UEs of other cells is included in the UL SINR

enableExtCellLos bool true
collectSinrStatistics bool true

Collection of SINR statistics can be disabled because it might be quite time-consuming

Properties

Name Value Description
display i=block/classifier2
class StochasticChannelModel

Signals

Name Type Unit Description
rcvdSinrDl

Statistics

rcvdSinrUl
measuredSinrDl
measuredSinrUl

Statistics

Name Title Source Record Unit Interpolation Mode Description
rcvdSinrDl SINR measured at packet reception, DL rcvdSinrDl mean, vector dB
rcvdSinrUl SINR measured at packet reception, UL rcvdSinrUl mean, vector dB
measuredSinrDl SINR measured at feedback computation, DL measuredSinrDl mean, vector dB
measuredSinrUl SINR measured at feedback computation, UL measuredSinrUl mean, vector dB

Source code

//
// ~StochasticChannelModel preset with the propagation formulas of
// 3GPP TR 38.901, "Study on channel model for frequencies from 0.5 to 100 GHz",
// v16.1.0, December 2019. It differs from its base type only in the
// pathLossType default; there is no C++ class of its own behind the name. Note
// that the study supplies the path loss, LOS probability, shadowing and angular
// attenuation only; the rest of the link model is the same for every
// propagation study.
//
// This is the default channel model of the gNodeB NIC and of the NR side of the
// NR UE NIC.
//
simple Tr38901ChannelModel extends StochasticChannelModel
{
    parameters:
        pathLossType = default("Tr38901");
}
File: src/simu5g/stack/phy/channelmodel/Tr38901ChannelModel.ned