A Discrete-Event Network Simulator
API
Loading...
Searching...
No Matches
interference-helper.h
Go to the documentation of this file.
1/*
2 * Copyright (c) 2005,2006 INRIA
3 *
4 * This program is free software; you can redistribute it and/or modify
5 * it under the terms of the GNU General Public License version 2 as
6 * published by the Free Software Foundation;
7 *
8 * This program is distributed in the hope that it will be useful,
9 * but WITHOUT ANY WARRANTY; without even the implied warranty of
10 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
11 * GNU General Public License for more details.
12 *
13 * You should have received a copy of the GNU General Public License
14 * along with this program; if not, write to the Free Software
15 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
16 *
17 * Author: Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
18 */
19
20#ifndef INTERFERENCE_HELPER_H
21#define INTERFERENCE_HELPER_H
22
23#include "phy-entity.h"
24
25#include "ns3/object.h"
26
27namespace ns3
28{
29
30class WifiPpdu;
31class WifiPsdu;
32class ErrorRateModel;
33
39class Event : public SimpleRefCount<Event>
40{
41 public:
51 ~Event();
52
64 Time GetStartTime() const;
70 Time GetEndTime() const;
76 Time GetDuration() const;
82 double GetRxPowerW() const;
89 double GetRxPowerW(const WifiSpectrumBandInfo& band) const;
102 void UpdateRxPowerW(const RxPowerWattPerChannelBand& rxPower);
112
113 private:
118};
119
127std::ostream& operator<<(std::ostream& os, const Event& event);
128
134{
135 public:
137 ~InterferenceHelper() override;
138
143 static TypeId GetTypeId();
144
150 void AddBand(const WifiSpectrumBandInfo& band);
151
157 bool HasBands() const;
158
166 void UpdateBands(const std::vector<WifiSpectrumBandInfo>& bands,
167 const FrequencyRange& freqRange);
168
174 void SetNoiseFigure(double value);
180 void SetErrorRateModel(const Ptr<ErrorRateModel> rate);
181
194 void SetNumberOfReceiveAntennas(uint8_t rx);
195
204 Time GetEnergyDuration(double energyW, const WifiSpectrumBandInfo& band);
205
218 Time duration,
220 bool isStartHePortionRxing = false);
221
227 void AddForeignSignal(Time duration, RxPowerWattPerChannelBand& rxPower);
245 uint16_t channelWidth,
246 const WifiSpectrumBandInfo& band,
247 uint16_t staId,
248 std::pair<Time, Time> relativeMpduStartStop) const;
259 double CalculateSnr(Ptr<Event> event,
260 uint16_t channelWidth,
261 uint8_t nss,
262 const WifiSpectrumBandInfo& band) const;
275 uint16_t channelWidth,
276 const WifiSpectrumBandInfo& band,
277 WifiPpduField header) const;
278
282 void NotifyRxStart();
289 void NotifyRxEnd(Time endTime, const FrequencyRange& freqRange);
290
297 void UpdateEvent(Ptr<Event> event, const RxPowerWattPerChannelBand& rxPower);
298
299 protected:
300 void DoDispose() override;
301
312 double CalculateSnr(double signal,
313 double noiseInterference,
314 uint16_t channelWidth,
315 uint8_t nss) const;
328 double CalculateChunkSuccessRate(double snir,
329 Time duration,
330 WifiMode mode,
331 const WifiTxVector& txVector,
332 WifiPpduField field) const;
345 double CalculatePayloadChunkSuccessRate(double snir,
346 Time duration,
347 const WifiTxVector& txVector,
348 uint16_t staId = SU_STA_ID) const;
349
350 private:
355 {
356 public:
363 NiChange(double power, Ptr<Event> event);
364 ~NiChange();
370 double GetPower() const;
376 void AddPower(double power);
382 Ptr<Event> GetEvent() const;
383
384 private:
385 double m_power;
387 };
388
392 using NiChanges = std::multimap<Time, NiChange>;
393
397 using NiChangesPerBand = std::map<WifiSpectrumBandInfo, NiChanges>;
398
402 using FirstPowerPerBand = std::map<WifiSpectrumBandInfo, double>;
403
410 bool HasBand(const WifiSpectrumBandInfo& band) const;
411
420 const FrequencyRange& freqRange) const;
421
429 void AppendEvent(Ptr<Event> event, bool isStartHePortionRxing);
430
441 NiChangesPerBand& nis,
442 const WifiSpectrumBandInfo& band) const;
443
454 double CalculateMuMimoPowerW(Ptr<const Event> event, const WifiSpectrumBandInfo& band) const;
455
471 uint16_t channelWidth,
472 NiChangesPerBand* nis,
473 const WifiSpectrumBandInfo& band,
474 uint16_t staId,
475 std::pair<Time, Time> window) const;
489 NiChangesPerBand* nis,
490 uint16_t channelWidth,
491 const WifiSpectrumBandInfo& band,
492 WifiPpduField header) const;
505 NiChangesPerBand* nis,
506 uint16_t channelWidth,
507 const WifiSpectrumBandInfo& band,
508 PhyEntity::PhyHeaderSections phyHeaderSections) const;
509
515 bool m_rxing;
516
524 NiChanges::iterator GetNextPosition(Time moment, NiChangesPerBand::iterator niIt);
532 NiChanges::iterator GetPreviousPosition(Time moment, NiChangesPerBand::iterator niIt);
533
543 NiChanges::iterator AddNiChangeEvent(Time moment,
544 NiChange change,
545 NiChangesPerBand::iterator niIt);
546
556 bool IsSameMuMimoTransmission(Ptr<const Event> currentEvent, Ptr<const Event> otherEvent) const;
557};
558
559} // namespace ns3
560
561#endif /* INTERFERENCE_HELPER_H */
handles interference calculations
Time m_endTime
end time
Time m_startTime
start time
Ptr< const WifiPpdu > GetPpdu() const
Return the PPDU.
Ptr< const WifiPpdu > m_ppdu
PPDU.
void UpdateRxPowerW(const RxPowerWattPerChannelBand &rxPower)
Update the received power (W) for all bands, i.e.
Time GetEndTime() const
Return the end time of the signal.
Time GetDuration() const
Return the duration of the signal.
double GetRxPowerW() const
Return the total received power (W).
RxPowerWattPerChannelBand m_rxPowerW
received power in watts per band
const RxPowerWattPerChannelBand & GetRxPowerWPerBand() const
Return the received power (W) for all bands.
Time GetStartTime() const
Return the start time of the signal.
void UpdatePpdu(Ptr< const WifiPpdu > ppdu)
Update the PPDU that initially generated the event.
Noise and Interference (thus Ni) event.
void AddPower(double power)
Add a given amount of power.
double GetPower() const
Return the power.
Ptr< Event > GetEvent() const
Return the event causes the corresponding NI change.
handles interference calculations
void SetNoiseFigure(double value)
Set the noise figure.
double m_noiseFigure
noise figure (linear)
Ptr< ErrorRateModel > GetErrorRateModel() const
Return the error rate model.
void AddForeignSignal(Time duration, RxPowerWattPerChannelBand &rxPower)
Add a non-Wifi signal to interference helper.
bool m_rxing
flag whether it is in receiving state
NiChanges::iterator AddNiChangeEvent(Time moment, NiChange change, NiChangesPerBand::iterator niIt)
Add NiChange to the list at the appropriate position and return the iterator of the new event.
std::map< WifiSpectrumBandInfo, NiChanges > NiChangesPerBand
Map of NiChanges per band.
double CalculateMuMimoPowerW(Ptr< const Event > event, const WifiSpectrumBandInfo &band) const
Calculate power of all other events preceding a given event that belong to the same MU-MIMO transmiss...
uint8_t m_numRxAntennas
the number of RX antennas in the corresponding receiver
bool IsBandInFrequencyRange(const WifiSpectrumBandInfo &band, const FrequencyRange &freqRange) const
Check whether a given band belongs to a given frequency range.
void DoDispose() override
Destructor implementation.
std::multimap< Time, NiChange > NiChanges
typedef for a multimap of NiChange
NiChangesPerBand m_niChanges
NI Changes for each band.
void UpdateBands(const std::vector< WifiSpectrumBandInfo > &bands, const FrequencyRange &freqRange)
Update the frequency bands that belongs to a given frequency range when the spectrum model is changed...
void SetErrorRateModel(const Ptr< ErrorRateModel > rate)
Set the error rate model for this interference helper.
bool HasBands() const
Check whether bands are already tracked by this interference helper.
double CalculatePayloadChunkSuccessRate(double snir, Time duration, const WifiTxVector &txVector, uint16_t staId=SU_STA_ID) const
Calculate the success rate of the payload chunk given the SINR, duration, and TXVECTOR.
Ptr< ErrorRateModel > m_errorRateModel
error rate model
Ptr< Event > Add(Ptr< const WifiPpdu > ppdu, Time duration, RxPowerWattPerChannelBand &rxPower, bool isStartHePortionRxing=false)
Add the PPDU-related signal to interference helper.
void NotifyRxStart()
Notify that RX has started.
NiChanges::iterator GetNextPosition(Time moment, NiChangesPerBand::iterator niIt)
Returns an iterator to the first NiChange that is later than moment.
FirstPowerPerBand m_firstPowers
first power of each band in watts
Time GetEnergyDuration(double energyW, const WifiSpectrumBandInfo &band)
bool IsSameMuMimoTransmission(Ptr< const Event > currentEvent, Ptr< const Event > otherEvent) const
Return whether another event is a MU-MIMO event that belongs to the same transmission and to the same...
double CalculateChunkSuccessRate(double snir, Time duration, WifiMode mode, const WifiTxVector &txVector, WifiPpduField field) const
Calculate the success rate of the chunk given the SINR, duration, and TXVECTOR.
double CalculatePayloadPer(Ptr< const Event > event, uint16_t channelWidth, NiChangesPerBand *nis, const WifiSpectrumBandInfo &band, uint16_t staId, std::pair< Time, Time > window) const
Calculate the error rate of the given PHY payload only in the provided time window (thus enabling per...
bool HasBand(const WifiSpectrumBandInfo &band) const
Check whether a given band is tracked by this interference helper.
void AddBand(const WifiSpectrumBandInfo &band)
Add a frequency band.
double CalculateNoiseInterferenceW(Ptr< Event > event, NiChangesPerBand &nis, const WifiSpectrumBandInfo &band) const
Calculate noise and interference power in W.
double CalculatePhyHeaderPer(Ptr< const Event > event, NiChangesPerBand *nis, uint16_t channelWidth, const WifiSpectrumBandInfo &band, WifiPpduField header) const
Calculate the error rate of the PHY header.
NiChanges::iterator GetPreviousPosition(Time moment, NiChangesPerBand::iterator niIt)
Returns an iterator to the last NiChange that is before than moment.
double CalculateSnr(Ptr< Event > event, uint16_t channelWidth, uint8_t nss, const WifiSpectrumBandInfo &band) const
Calculate the SNIR for the event (starting from now until the event end).
std::map< WifiSpectrumBandInfo, double > FirstPowerPerBand
Map of first power per band.
PhyEntity::SnrPer CalculatePhyHeaderSnrPer(Ptr< Event > event, uint16_t channelWidth, const WifiSpectrumBandInfo &band, WifiPpduField header) const
Calculate the SNIR at the start of the PHY header and accumulate all SNIR changes in the SNIR vector.
void AppendEvent(Ptr< Event > event, bool isStartHePortionRxing)
Append the given Event.
static TypeId GetTypeId()
Get the type ID.
void UpdateEvent(Ptr< Event > event, const RxPowerWattPerChannelBand &rxPower)
Update event to scale its received power (W) per band.
void NotifyRxEnd(Time endTime, const FrequencyRange &freqRange)
Notify that RX has ended.
double CalculatePhyHeaderSectionPsr(Ptr< const Event > event, NiChangesPerBand *nis, uint16_t channelWidth, const WifiSpectrumBandInfo &band, PhyEntity::PhyHeaderSections phyHeaderSections) const
Calculate the success rate of the PHY header sections for the provided event.
void SetNumberOfReceiveAntennas(uint8_t rx)
Set the number of RX antennas in the receiver corresponding to this interference helper.
PhyEntity::SnrPer CalculatePayloadSnrPer(Ptr< Event > event, uint16_t channelWidth, const WifiSpectrumBandInfo &band, uint16_t staId, std::pair< Time, Time > relativeMpduStartStop) const
Calculate the SNIR at the start of the payload and accumulate all SNIR changes in the SNIR vector for...
A base class which provides memory management and object aggregation.
Definition: object.h:89
std::map< WifiPpduField, PhyHeaderChunkInfo > PhyHeaderSections
A map of PhyHeaderChunkInfo elements per PPDU field.
Definition: phy-entity.h:326
Smart pointer class similar to boost::intrusive_ptr.
Definition: ptr.h:78
A template-based reference counting class.
Simulation virtual time values and global simulation resolution.
Definition: nstime.h:105
a unique identifier for an interface.
Definition: type-id.h:59
represent a single transmission mode
Definition: wifi-mode.h:51
This class mimics the TXVECTOR which is to be passed to the PHY in order to define the parameters whi...
WifiPpduField
The type of PPDU field (grouped for convenience)
Every class exported by the ns3 library is enclosed in the ns3 namespace.
std::ostream & operator<<(std::ostream &os, const Angles &a)
Definition: angles.cc:159
std::map< WifiSpectrumBandInfo, double > RxPowerWattPerChannelBand
A map of the received power (Watts) for each band.
Definition: phy-entity.h:77
static constexpr uint16_t SU_STA_ID
STA_ID to identify a single user (SU)
Definition: wifi-mode.h:35
Declaration of:
Struct defining a frequency range between minFrequency (MHz) and maxFrequency (MHz).
A struct for both SNR and PER.
Definition: phy-entity.h:147
WifiSpectrumBandInfo structure containing info about a spectrum band.