cttc-3gpp-indoor-calibration.cc File Reference

Simulation script for the NR-MIMO Phase 1 system-level calibration. More...

#include "ns3/antenna-module.h"
#include "ns3/applications-module.h"
#include "ns3/config-store-module.h"
#include "ns3/core-module.h"
#include "ns3/internet-module.h"
#include "ns3/mobility-module.h"
#include "ns3/nr-eps-bearer-tag.h"
#include "ns3/nr-module.h"
#include "ns3/point-to-point-helper.h"

Include dependency graph for cttc-3gpp-indoor-calibration.cc:

Go to the source code of this file.

Functions
std::string	BuildFileNameString (std::string directoryName, std::string filePrefix, std::string tag)
std::string	BuildTag (bool gNbAntennaModel, bool ueAntennaModel, std::string scenario, double speed)
void	UeReceptionTrace (Nr3gppIndoorCalibration *scenario, RxPacketTraceParams params)
void	UeRssiPerProcessedChunkTrace (Nr3gppIndoorCalibration *scenario, double rssidBm)
void	UeSnrPerProcessedChunkTrace (Nr3gppIndoorCalibration *scenario, double snr)

Detailed Description

Simulation script for the NR-MIMO Phase 1 system-level calibration.

The scenario implemented in the present simulation script is according to the topology described in 3GPP TR 38.901 V17.0.0 (2022-03) Figure 7.2-1: "Layout of indoor office scenarios".

The simulation assumptions and the configuration parameters follow the evaluation assumptions agreed at 3GPP TSG RAN WG1 meeting #88, and which are summarised in R1-1703534 Table 1. In the following Figure is illustrated the scenario with the gNB positions which are represented with "x". The UE nodes are randomly uniformly dropped in the area. There are 10 UEs per gNB.

  +----------------------120 m------------------ +
  |                                              |
  |                                              |
  |      x      x      x      x      x-20m-x     |
  |                                        |     |
  50m                                     20m    |
  |                                        |     |
  |      x      x      x      x      x     x     |
  |                                              |
  |                                              |
  +----------------------------------------------+

The results of the simulation are files containing data that is being collected over the course of the simulation execution:

• SINR values for all the 120 UEs
• SNR values for all the 120 UEs
• RSSI values for all the 120 UEs

Additionally there are files that contain:

• UE positions
• gNB positions
• distances of UEs from the gNBs to which they are attached

The file names are created by default in the root project directory if not configured differently by setting resultsDirPath parameter of the Run() function.

The file names by default start with the prefixes such as "sinrs", "snrs", "rssi", "gnb-positions,", "ue-positions" which are followed by the string that briefly describes the configuration parameters that are being set in the specific simulation execution.

Definition in file cttc-3gpp-indoor-calibration.cc.

Function Documentation

BuildFileNameString()

std::string BuildFileNameString	(	std::string	directoryName,
		std::string	filePrefix,
		std::string	tag
	)

Function that creates the output file name for the results.

Parameters

directoryName	Directory name
filePrefix	The prefix for the file name, e.g. sinr, snr,..
tag	A tag that contains some simulation run specific values in order to be able to distinguish the results file for different runs for different parameters configuration

Returns

returns The full path file name string

Definition at line 209 of file cttc-3gpp-indoor-calibration.cc.

BuildTag()

std::string BuildTag	(	bool	gNbAntennaModel,
		bool	ueAntennaModel,
		std::string	scenario,
		double	speed
	)

Creates a string tag that contains some simulation run specific values in order to be able to distinguish the results files for different runs for different parameters.

Parameters

gNbAntennaModel	gNb antenna model
ueAntennaModel	UE antenna model
scenario	The indoor scenario to be used
speed	The speed of UEs in km/h

Returns

the parameter specific simulation name

Definition at line 227 of file cttc-3gpp-indoor-calibration.cc.

UeReceptionTrace()

void UeReceptionTrace	(	Nr3gppIndoorCalibration *	scenario,
		RxPacketTraceParams	params
	)

A callback function that redirects a call to the scenario instance.

Parameters

scenario	A pointer to a simulation instance
params	RxPacketTraceParams structure containing RX parameters

Definition at line 265 of file cttc-3gpp-indoor-calibration.cc.

UeRssiPerProcessedChunkTrace()

void UeRssiPerProcessedChunkTrace	(	Nr3gppIndoorCalibration *	scenario,
		double	rssidBm
	)

A callback function that redirects a call to the scenario instance.

Parameters

scenario	A pointer to a simulation instance
rssidBm	rssidBm RSSI value in dBm

Definition at line 287 of file cttc-3gpp-indoor-calibration.cc.

UeSnrPerProcessedChunkTrace()

void UeSnrPerProcessedChunkTrace	(	Nr3gppIndoorCalibration *	scenario,
		double	snr
	)

A callback function that redirects a call to the scenario instance.

Parameters

scenario	A pointer to a simulation instance
snr	SNR value

Definition at line 276 of file cttc-3gpp-indoor-calibration.cc.