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.
Usage diagram¶
Used in compound modules¶
Name |
Type |
Description |
|---|---|---|
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