LteRealisticChannelModel

Package: simu5g.stack.phy.ChannelModel

LteRealisticChannelModel

simple module

This module implements the functions for a model representing the 2D channel in the LTE specification 3GPP TR 36.803. It includes the computation of:

  • path loss (both line-of-sight and non-line-of-sight),
  • fading (Jakes or Rayleigh model),
  • log-normal shadowing,
  • inter-cell interference. These effects are utilized to compute the Signal to Interference-plus-Noise Ratio (SINR).

Inheritance diagram

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

Known subclasses

Name Type Description
NRChannelModel simple module

This channel model implements path loss, LOS probability, and shadowing according to the following specifications: 3GPP TR 36.873, "Study on 3D channel model for LTE", v12.7.0, December 2017

Extends

Name Type Description
LteChannelModel simple module

This is the base module for developing more realistic models of the radio channel. It primarily provides the initialization of parameters such as the reference to the Component Carrier (CC) and its associated parameters related to the channel model itself.

Parameters

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

optional
componentCarrierModule string "carrierAggregation.componentCarrier[0]"

component carrier for this channel model
shadowing bool true

Enable/disable shadowing
scenario string "URBAN_MACROCELL"

Pathloss scenario from ITU -->
nodeb_height double 25m

eNodeB height -->
building_height double 20m

Building height -->
inside_building bool false

determines if the UE is inside a building
street_wide double 20m
ue_height double 1.5m
tolerateMaxDistViolation bool false
useTorus bool false
correlation_distance double 50m
targetBler double 0.01

Target bler used to compute feedback -->
harqReduction double 0.2

HARQ reduction -->
lambdaMinTh double 0.02

Rank indicator tracefile -->
lambdaMaxTh double 0.2
lambdaRatioTh double 20
antennaGainUe double 0dBi

Antenna Gain of UE -->
antennGainEnB double 18dBi

Antenna Gain of eNodeB -->
antennGainMicro double 5dBi

Antenna Gain of Micro node -->
thermalNoise double -104.5dBm

Thermal Noise for 10 MHz of Bandwidth -->
ue_noise_figure double 7dBm

Ue noise figure -->
bs_noise_figure double 5dBm

eNodeB noise figure -->
cable_loss double 2dB

Cable Loss -->
dynamic_los bool false

If true enable the possibility to switch dinamically the LOS/NLOS pathloss computation -->
fixed_los bool false

If dynamic-los is false this parameter, if true, compute LOS pathloss otherwise compute NLOS pathloss -->
fading bool true

Enable/disable fading -->
fading_type string "JAKES"

Fading type (JAKES or RAYGHLEY) -->
fading_paths int 6

If jakes fading this parameter specify the number of path (tap channel) -->
delay_rms double 363ns
bgCell_interference bool true

if true, enables the inter-cell interference computation for UL and DL connections from background cells -->
extCell_interference bool true

if true, enables the inter-cell interference computation for DL connections from external cells (maybe this is obsolete and should be removed) -->
downlink_interference bool false

if true, enables the inter-cell interference computation for DL connections -->
uplink_interference bool false

if true, enables the interference computation for UL connections -->
d2d_interference bool true

if true, enables the interference computation for D2D connections -->
enable_extCell_los 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 LteRealisticChannelModel

Signals

Name Type Unit Description
measuredSinrDl
rcvdSinrUl
rcvdSinrDl

statistics
rcvdSinrD2D
measuredSinrUl

Statistics

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

Source code

//
// This module implements the functions for a model representing the 2D channel in the LTE
// specification 3GPP TR 36.803. It includes the computation of:
// - path loss (both line-of-sight and non-line-of-sight),
// - fading (Jakes or Rayleigh model),
// - log-normal shadowing,
// - inter-cell interference.
// These effects are utilized to compute the Signal to Interference-plus-Noise Ratio (SINR).
//
//
simple LteRealisticChannelModel extends LteChannelModel
{
    parameters:
        @class("LteRealisticChannelModel");

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

        // Pathloss scenario from ITU -->
        string scenario @enum(INDOOR_HOTSPOT,URBAN_MICROCELL,URBAN_MACROCELL,RURAL_MACROCELL,SUBURBAN_MACROCELL,UNKNOW_SCENARIO) = default("URBAN_MACROCELL");

        // eNodeB height -->
        double nodeb_height @unit(m) = default(25m);
        // Building height -->
        double building_height @unit(m) = default(20m);
        // determines if the UE is inside a building
        bool inside_building = default(false);

        double street_wide @unit(m) = default(20m);
        double ue_height @unit(m) = default(1.5m);
        bool tolerateMaxDistViolation = default(false);
        bool useTorus = default(false);

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

        // Target bler used to compute feedback -->
        double targetBler = default(0.01);
        // HARQ reduction -->
        double harqReduction = default(0.2);

        // Rank indicator tracefile -->
        double lambdaMinTh = default(0.02);
        double lambdaMaxTh = default(0.2);
        double lambdaRatioTh = default(20);

        // Antenna Gain of UE -->
        double antennaGainUe @unit(dBi) = default(0dBi);
        // Antenna Gain of eNodeB -->
        double antennGainEnB @unit(dBi) = default(18dBi);
        // Antenna Gain of 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 ue_noise_figure @unit(dBm) = default(7dBm);
        // eNodeB noise figure -->
        double bs_noise_figure @unit(dBm) = default(5dBm);
        // Cable Loss -->
        double cable_loss @unit(dB) = default(2dB);

        // If true enable the possibility to switch dinamically the LOS/NLOS pathloss computation -->
        bool dynamic_los = default(false);
        // If dynamic-los is false this parameter, if true, compute LOS pathloss otherwise compute NLOS pathloss -->
        bool fixed_los = default(false);
        // Enable/disable fading -->
        bool fading = default(true);
        // Fading type (JAKES or RAYGHLEY) -->
        string fading_type @enum(RAYLEIGH,JAKES) = default("JAKES");
        // If jakes fading this parameter specify the number of path (tap channel) -->
        int fading_paths = default(6);

        double delay_rms @unit(s) = default(363ns);

        // if true, enables the inter-cell interference computation for UL and DL connections from background cells -->
        bool bgCell_interference = default(true);
        // if true, enables the inter-cell interference computation for DL connections from external cells (maybe this is obsolete and should be removed) -->
        bool extCell_interference = default(true);
        // if true, enables the inter-cell interference computation for DL connections -->
        bool downlink_interference = default(false);
        // if true, enables the interference computation for UL connections -->
        bool uplink_interference = default(false);
        // if true, enables the interference computation for D2D connections -->
        bool d2d_interference = default(true);

        bool enable_extCell_los = default(true);

        // collection of SINR statistics can be disabled because it might be quite time-consuming
        bool collectSinrStatistics = default(true);

        // statistics
        @signal[rcvdSinrDl];
        @statistic[rcvdSinrDl](title="SINR measured at packet reception, DL"; unit="dB"; source="rcvdSinrDl"; record=mean,vector);
        @signal[rcvdSinrUl];
        @statistic[rcvdSinrUl](title="SINR measured at packet reception, UL"; unit="dB"; source="rcvdSinrUl"; record=mean,vector);
        @signal[rcvdSinrD2D];
        @statistic[rcvdSinrD2D](title="SINR measured at packet reception, D2D"; unit="dB"; source="rcvdSinrD2D"; record=mean,vector);

        @signal[measuredSinrDl];
        @statistic[measuredSinrDl](title="SINR measured at feedback computation, DL"; unit="dB"; source="measuredSinrDl"; record=mean,vector);
        @signal[measuredSinrUl];
        @statistic[measuredSinrUl](title="SINR measured at feedback computation, UL"; unit="dB"; source="measuredSinrUl"; record=mean,vector);
}
File: src/stack/phy/ChannelModel/LteRealisticChannelModel.ned

This documentation is released under the Creative Commons license