BackgroundCellChannelModel

Package: simu5g.background.cell

BackgroundCellChannelModel

simple module

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.

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
display i=block/control
class BackgroundCellChannelModel

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