Packet by packet interference. More...

#include "satellite-per-packet-interference.h"

Inheritance diagram for ns3::SatPerPacketInterference:

Collaboration diagram for ns3::SatPerPacketInterference:

Public Member Functions
	SatPerPacketInterference ()
	SatPerPacketInterference (SatEnums::ChannelType_t channelType, double rxBandwidthHz)
	~SatPerPacketInterference ()
void	DoDispose ()
void	SetRxBandwidth (double rxBandwidth)
Public Member Functions inherited from ns3::SatInterference
	SatInterference ()
	Constructor for Satellite interference base class.
	~SatInterference ()
	Destructor for Satellite interference base class.
Ptr< SatInterference::InterferenceChangeEvent >	Add (Time rxDuration, double rxPower, Address rxAddress)
	Adds interference power to interference object.
std::vector< std::pair< double, double > >	Calculate (Ptr< SatInterference::InterferenceChangeEvent > event)
	Calculates interference power for the given reference.
virtual bool	HasCollision (Ptr< SatInterference::InterferenceChangeEvent > event)
	Checks whether the packet has collided.
virtual void	NotifyRxEnd (Ptr< SatInterference::InterferenceChangeEvent > event)
	Notifies that RX is ended by a receiver.
virtual void	NotifyRxStart (Ptr< SatInterference::InterferenceChangeEvent > event)
	Notifies that RX is started by a receiver.
void	Reset (void)
	Resets current interference.

Static Public Member Functions
static TypeId	GetTypeId (void)
Static Public Member Functions inherited from ns3::SatInterference
static TypeId	GetTypeId (void)
	Derived from Object.

Protected Member Functions
virtual std::vector< std::pair< double, double > >	DoCalculate (Ptr< SatInterference::InterferenceChangeEvent > event)
	Calculates interference power for the given reference Sets final power at end time to finalPower.
virtual void	onInterferentEvent (long double timeRatio, double interferenceValue, double &ifPowerW)
	Helper function meant for subclasses to override.
virtual void	onOwnStartReached (double ifPowerW)
	Helper function meant for subclasses to override.

Private Types
typedef std::tuple< uint32_t, long double, bool >	InterferenceChange
typedef std::multimap< Time, InterferenceChange >	InterferenceChanges

Private Member Functions
	SatPerPacketInterference (const SatPerPacketInterference &o)
virtual Ptr< SatInterference::InterferenceChangeEvent >	DoAdd (Time rxDuration, double rxPower, Address rxAddress)
	Adds interference power to interference object.
virtual void	DoNotifyRxEnd (Ptr< SatInterference::InterferenceChangeEvent > event)
	Notifies that RX is ended by a receiver.
virtual void	DoNotifyRxStart (Ptr< SatInterference::InterferenceChangeEvent > event)
	Notifies that RX is started by a receiver.
virtual void	DoReset (void)
	Resets current interference.
SatPerPacketInterference &	operator= (const SatPerPacketInterference &o)

Private Attributes
SatEnums::ChannelType_t	m_channelType
bool	m_enableTraceOutput
InterferenceChanges	m_interferenceChanges
	interference change list
uint32_t	m_nextEventId
	event id for Events
long double	m_residualPowerW
	Residual power value for interference.
double	m_rxBandwidth_Hz
	RX Bandwidth in Hz.
std::set< uint32_t >	m_rxEventIds
	notified interference event IDs
bool	m_rxing
	flag to indicate that at least one receiving is on

Detailed Description

Packet by packet interference.

Interference is calculated separately for each packet by listening to all transmissions within the same SatChannel.

Definition at line 46 of file satellite-per-packet-interference.h.

Member Typedef Documentation

◆ InterferenceChange

typedef std::tuple<uint32_t, long double, bool> ns3::SatPerPacketInterference::InterferenceChange

private

Definition at line 158 of file satellite-per-packet-interference.h.

◆ InterferenceChanges

typedef std::multimap<Time, InterferenceChange> ns3::SatPerPacketInterference::InterferenceChanges

private

Definition at line 163 of file satellite-per-packet-interference.h.

Constructor & Destructor Documentation

◆ SatPerPacketInterference() [1/3]

ns3::SatPerPacketInterference::SatPerPacketInterference ( )

Definition at line 55 of file satellite-per-packet-interference.cc.

References m_channelType, m_enableTraceOutput, m_nextEventId, m_residualPowerW, m_rxBandwidth_Hz, and m_rxing.

Referenced by ns3::SatPerFragmentInterference::SatPerFragmentInterference(), ns3::SatPerFragmentInterference::SatPerFragmentInterference(), SatPerPacketInterference(), ns3::SatPerFragmentInterference::GetTypeId(), and operator=().

Here is the caller graph for this function:

◆ SatPerPacketInterference() [2/3]

ns3::SatPerPacketInterference::SatPerPacketInterference	(	SatEnums::ChannelType_t	channelType,
		double	rxBandwidthHz )

Parameters

channelType
rxBandwidthHz	Receiver bandwidth in Hertz

Definition at line 66 of file satellite-per-packet-interference.cc.

References m_channelType, m_enableTraceOutput, m_nextEventId, m_residualPowerW, m_rxBandwidth_Hz, and m_rxing.

◆ ~SatPerPacketInterference()

ns3::SatPerPacketInterference::~SatPerPacketInterference ( )

Definition at line 83 of file satellite-per-packet-interference.cc.

References ns3::SatInterference::Reset().

Here is the call graph for this function:

◆ SatPerPacketInterference() [3/3]

ns3::SatPerPacketInterference::SatPerPacketInterference ( const SatPerPacketInterference & o )

private

Parameters

o

References SatPerPacketInterference().

Here is the call graph for this function:

Member Function Documentation

◆ DoAdd()

Ptr< SatInterference::InterferenceChangeEvent > ns3::SatPerPacketInterference::DoAdd	(	Time	rxDuration,
		double	rxPower,
		Address	rxAddress )

privatevirtual

Adds interference power to interference object.

Parameters

rxDuration	Duration of the receiving.
rxPower	Receiving power.

Returns: the pointer to interference event as a reference of the addition

Implements ns3::SatInterference.

Definition at line 91 of file satellite-per-packet-interference.cc.

References m_interferenceChanges, m_nextEventId, m_residualPowerW, and m_rxing.

◆ DoCalculate()

std::vector< std::pair< double, double > > ns3::SatPerPacketInterference::DoCalculate ( Ptr< SatInterference::InterferenceChangeEvent > event )

protectedvirtual

Calculates interference power for the given reference Sets final power at end time to finalPower.

Parameters

event Reference event which for interference is calculated.

Returns: Final calculated power value at end of receiving

Implements ns3::SatInterference.

Reimplemented in ns3::SatPerFragmentInterference.

Definition at line 156 of file satellite-per-packet-interference.cc.

References m_channelType, m_enableTraceOutput, m_interferenceChanges, m_residualPowerW, m_rxBandwidth_Hz, m_rxing, onInterferentEvent(), and onOwnStartReached().

Referenced by ns3::SatPerFragmentInterference::DoCalculate().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ DoDispose()

void ns3::SatPerPacketInterference::DoDispose ( )

Definition at line 288 of file satellite-per-packet-interference.cc.

◆ DoNotifyRxEnd()

void ns3::SatPerPacketInterference::DoNotifyRxEnd ( Ptr< SatInterference::InterferenceChangeEvent > event )

privatevirtual

Notifies that RX is ended by a receiver.

Parameters

event Interference reference event of receiver

Implements ns3::SatInterference.

Definition at line 275 of file satellite-per-packet-interference.cc.

References m_rxEventIds, and m_rxing.

◆ DoNotifyRxStart()

void ns3::SatPerPacketInterference::DoNotifyRxStart ( Ptr< SatInterference::InterferenceChangeEvent > event )

privatevirtual

Notifies that RX is started by a receiver.

Parameters

event Interference reference event of receiver

Implements ns3::SatInterference.

Definition at line 264 of file satellite-per-packet-interference.cc.

References m_rxEventIds, and m_rxing.

◆ DoReset()

void ns3::SatPerPacketInterference::DoReset ( void )

privatevirtual

Resets current interference.

Implements ns3::SatInterference.

Definition at line 254 of file satellite-per-packet-interference.cc.

References m_interferenceChanges, m_residualPowerW, and m_rxing.

◆ GetTypeId()

TypeId ns3::SatPerPacketInterference::GetTypeId ( void )

static

Returns

Definition at line 46 of file satellite-per-packet-interference.cc.

References ns3::SatInterference::SatInterference().

Here is the call graph for this function:

◆ onInterferentEvent()

void ns3::SatPerPacketInterference::onInterferentEvent	(	long double	timeRatio,
		double	interferenceValue,
		double &	ifPowerW )

protectedvirtual

Helper function meant for subclasses to override.

Called during DoCalculate after the start of the event whose interferences are being calculated has been reached.

Update the current interference power by adding the power of the event being processed proportional to the remaining time until the end of the event whose interferences are being calculated.

Parameters

timeRatio	ratio of time compared to an event duration of the distance between the event being processed and the end of the event whose interferences are being calculated.
interferenceValue	the interference value of the event being processed.
ifPowerW	the current value of the interference for the event whose interferences are being calculated; which will be updated.

Reimplemented in ns3::SatPerFragmentInterference.

Definition at line 246 of file satellite-per-packet-interference.cc.

Referenced by DoCalculate().

Here is the caller graph for this function: