BackgroundCellChannelModel

Package: simu5g.background.cell

simple module BackgroundCellChannelModel

Configures the channel parameters associated with a BackgroundCell. It is used to compute the channel quality for background UEs (refer to the BackgroundUe module), which in turn is essential for deriving the correct allocation of time-frequency resources via the Adaptive Modulation and Coding mechanism.

simu5g.background.cell.BackgroundCellChannelModelBackgroundCellChannelModelsimple

Usage diagram

Used in compound modules

Name

Type

Description

BackgroundCell

compound module

Implements a lightweight model for a 4G eNodeB or 5G gNodeB for generating configurable inter-cell interference in the simulated network.

Parameters

Name

Type

Default value

Description

binderModule

string

“binder”

Module references

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

streetWidth

double

20m

TODO width

ueHeight

double

1.5m

tolerateMaxDistViolation

bool

false

correlationDistance

double

50m

antennaGainUe

double

0dBi

Antenna gain of the UE, relative to an isotropic antenna

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 the other background cells is included in the SINR, in both UL and DL

downlinkInterference

bool

true

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

uplinkInterference

bool

true

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

Properties

Name

Value

Description

class

BackgroundCellChannelModel

display

i=block/control

Source code

//
// Configures the channel parameters associated with a ~BackgroundCell. It is used
// to compute the channel quality for background UEs (refer to the ~BackgroundUe module), which in
// turn is essential for deriving the correct allocation of time-frequency resources via the
// Adaptive Modulation and Coding mechanism.
//
simple BackgroundCellChannelModel
{
    parameters:
        @display("i=block/control");
        @class("BackgroundCellChannelModel");

        // Module references
        string binderModule = default("binder");

        // Enable/disable shadowing
        bool shadowing = default(true);

        // Path loss scenario, in ITU terminology
        string scenario @enum(INDOOR_HOTSPOT,URBAN_MICROCELL,URBAN_MACROCELL,RURAL_MACROCELL,SUBURBAN_MACROCELL,UNKNOWN_SCENARIO) = default("URBAN_MACROCELL");

        // eNodeB height
        double nodebHeight @unit(m) = default(25m);
        // Building height
        double buildingHeight @unit(m) = default(20m);
        // Determines if the UE is inside a building
        bool insideBuilding = default(false);

        double streetWidth @unit(m) = default(20m); // TODO width
        double ueHeight @unit(m) = default(1.5m);
        bool tolerateMaxDistViolation = default(false);

        double correlationDistance @unit(m) = default(50m);

        // Antenna gain of the UE, relative to an isotropic antenna
        double antennaGainUe @unit(dBi) = default(0dBi);
        // Antenna gain of the eNodeB
        double antennGainEnB @unit(dBi) = default(18dBi);
        // Antenna gain of the micro node
        double antennGainMicro @unit(dBi) = default(5dBi);
        // Thermal noise for 10 MHz of bandwidth
        double thermalNoise @unit(dBm) = default(-104.5dBm);
        // UE noise figure
        double ueNoiseFigure @unit(dBm) = default(7dBm);
        // eNodeB noise figure
        double bsNoiseFigure @unit(dBm) = default(5dBm);
        // Cable loss
        double cableLoss @unit(dB) = default(2dB);

        // Whether LOS/NLOS is drawn per link from the scenario's LOS probability; when false, it is fixed to fixedLos
        bool dynamicLos = default(false);
        // LOS state of every link when dynamicLos is false: true = LOS, false = NLOS
        bool fixedLos = default(false);
        // Enable/disable fading
        bool fading = default(true);
        // Fading type (JAKES or RAYLEIGH)
        string fadingType @enum(RAYLEIGH,JAKES) = default("JAKES");
        // If Jakes fading, this parameter specifies the number of paths (tap channel)
        int numFadingPaths = default(6);
        double delayRms @unit(s) = default(363ns);

        // Whether interference from the other background cells is included in the SINR, in both UL and DL
        bool bgCellInterference = default(true);
        // Whether interference from other base stations is included in the DL SINR
        bool downlinkInterference = default(true);
        // Whether interference from the UEs of other cells is included in the UL SINR
        bool uplinkInterference = default(true);
}

File: src/simu5g/background/cell/BackgroundCellChannelModel.ned