5G-LENA: ns3::RealisticBeamformingAlgorithm Class Reference

Generate "Real" beamforming vectors This class is inherited by all algorithms that do not assume the perfect knowledge of the channel, but instead are performing the estimation of the channel based on measurements, e.g., based on SRS SINR/SNR measurement. More...

#include "realistic-beamforming-algorithm.h"

Inheritance diagram for ns3::RealisticBeamformingAlgorithm:

Collaboration diagram for ns3::RealisticBeamformingAlgorithm:

Classes
struct	DelayedUpdateInfo

struct	TriggerEventConf

Public Types
typedef Callback< void, const Ptr< NrSpectrumPhy > &, const Ptr< NrSpectrumPhy > & >	RealisticBfHelperCallback
	RunTask callback will be triggered when the event for updating the beamforming vectors occurs The parameters are: gnb spectrum phy, ue spectrum phy.

Public Member Functions
	RealisticBeamformingAlgorithm ()
	constructor

	~RealisticBeamformingAlgorithm () override
	destructor

int64_t	AssignStreams (int64_t stream)
	Assign a fixed random variable stream number to the random variables used by this model. Return the number of streams (possibly zero) that have been assigned. More...

virtual BeamformingVectorPair	GetBeamformingVectors ()
	Function that generates the beamforming vectors for a pair of communicating devices by using the direct-path beamforming vector for gNB and quasi-omni beamforming vector for UEs. More...

double	GetBeamSearchAngleStep () const

void	Install (const Ptr< NrSpectrumPhy > &gnbSpectrumPhy, const Ptr< NrSpectrumPhy > &ueSpectrumPhy, const Ptr< NrMacScheduler > &scheduler)

void	NotifySrsReport (uint16_t cellId, uint16_t rnti, double srsReport)
	Saves SRS report (SNR or SINR depending on the configuration) More...

void	NotifySrsSinrReport (uint16_t cellId, uint16_t rnti, double srsSinr)
	Saves SRS SINR report. More...

void	NotifySrsSnrReport (uint16_t cellId, uint16_t rnti, double srsSnr)
	Saves SRS SNR report. More...

void	SetBeamSearchAngleStep (double beamSearchAngleStep)
	Sets the value of BeamSearchAngleStep attribute. More...

void	SetUseSnrSrs (bool v)

bool	UseSnrSrs () const

Static Public Member Functions
static TypeId	GetTypeId ()
	Get the type id. More...

Detailed Description

RealisticBeamformingAlgorithm purpose is to generate beams for the pair of communicating devices based on the SRS measurements. Differently from IdealBeamformingAlgorithm this type of algorithm does not assume a perfect knowledge of the channel. It instead estimates the long-term fast fading channel component based on the received SRS. Accordingly, this approach could be used with any beamforming algorithm that makes use of the channel estimation, e.g., beam search method (e.g., such as the one implemented in CellScanBeamforming class). Note that the LOS type of method (e.g., such as the one implemented in DirectPathBeamforming class) does not use the channel matrix, but instead the angles of arrival and departure of the LOS path, and so, the proposed method is not valid for it. Currently, it is only compatible with the beam search method."

Definition at line 50 of file realistic-beamforming-algorithm.h.

Member Function Documentation

◆ AssignStreams()

int64_t ns3::RealisticBeamformingAlgorithm::AssignStreams ( int64_t stream )

Assign a fixed random variable stream number to the random variables used by this model. Return the number of streams (possibly zero) that have been assigned.

Parameters

stream the first stream index to use

Returns: the number of stream indices assigned by this model

Definition at line 46 of file realistic-beamforming-algorithm.cc.

◆ GetBeamformingVectors()

BeamformingVectorPair ns3::RealisticBeamformingAlgorithm::GetBeamformingVectors ( )

virtual

Function that generates the beamforming vectors for a pair of communicating devices by using the direct-path beamforming vector for gNB and quasi-omni beamforming vector for UEs.