rem-example.cc File Reference

REM Creation Example. More...

#include "ns3/antenna-module.h"
#include "ns3/applications-module.h"
#include "ns3/buildings-module.h"
#include "ns3/config-store.h"
#include "ns3/core-module.h"
#include "ns3/internet-module.h"
#include "ns3/ipv4-global-routing-helper.h"
#include "ns3/log.h"
#include "ns3/mobility-module.h"
#include "ns3/nr-helper.h"
#include "ns3/nr-module.h"
#include "ns3/nr-point-to-point-epc-helper.h"
#include "ns3/point-to-point-helper.h"

Include dependency graph for rem-example.cc:

Go to the source code of this file.

Detailed Description

REM Creation Example.

This example describes how to setup a simulation using NrRadioEnvironmentMapHelper.

We provide a number of simulation parameters that can be configured in the command line, such as the number of UEs per cell or the number of rows and columns of the gNB and Ue antennas. Please have a look at the possible parameters to know what you can configure through the command line. The user can also specify the type of REM map (BeamShape/CoverageArea/UeCoverage) he wishes to generate with some of the following commands:

$ ./ns3 run "rem-example --simTag=d --remMode=CoverageArea"
$ ./ns3 run "rem-example --simTag=u --remMode=UeCoverage"
$ ./ns3 run "rem-example --simTag=b1 --remMode=BeamShape --typeOfRem=DlRem"
$ ./ns3 run "rem-example --simTag=b2 --remMode=BeamShape --typeOfRem=UlRem"

DL or UL REM map can be selected by passing to the rem helper the desired transmitting device(s) (RTD(s)) and receiving device (RRD), which for the DL case correspond to gNB(s) and UE and for the UL case to UE(s) and gNB.

The output of the REM includes a map with the SNR values, a map with the SINR and a map with IPSD values (aggregated rx Power in each rem point). Note that in case there is only one gNB configured, the SNR/SINR maps will be the same.

The output of this example are REM csv files from which can be generated REM figures with the following command:

$ gnuplot -p nr-rem-{simTag}-gnbs.txt nr-rem-{simTag}-ues.txt nr-rem-{simTag}-buildings.txt
nr-rem-{simTag}-plot-rem.gnuplot 

If no simTag is specified then to plot run the following command:

$ gnuplot -p nr-rem--gnbs.txt nr-rem--ues.txt nr-rem--buildings.txt nr-rem--plot-rem.gnuplot

And the following files will be generated (in the root project folder if not specified differently): nr-rem–sinr.png, nr-rem–snr.png and nr-rem–ipsd.png

Definition in file rem-example.cc.