27#include <ns3/angles.h>
28#include <ns3/antenna-model.h>
29#include <ns3/double.h>
31#include <ns3/mobility-model.h>
32#include <ns3/net-device.h>
34#include <ns3/object.h>
35#include <ns3/packet-burst.h>
36#include <ns3/packet.h>
37#include <ns3/propagation-delay-model.h>
38#include <ns3/propagation-loss-model.h>
39#include <ns3/simulator.h>
61 for (
auto it = rhs.begin(); it != rhs.end(); ++it)
63 for (
auto jt = it->second.m_spectrumConverterMap.begin();
64 jt != it->second.m_spectrumConverterMap.end();
67 lhs <<
"(" << it->first <<
"," << jt->first <<
") ";
74 : m_txSpectrumModel(txSpectrumModel)
79 : m_rxSpectrumModel(rxSpectrumModel)
101 static TypeId tid =
TypeId(
"ns3::MultiModelSpectrumChannel")
103 .SetGroupName(
"Spectrum")
123 auto phyIt = std::find(rxInfoIterator->second.m_rxPhys.begin(),
124 rxInfoIterator->second.m_rxPhys.end(),
126 if (phyIt != rxInfoIterator->second.m_rxPhys.end())
128 rxInfoIterator->second.m_rxPhys.erase(phyIt);
143 "phy->GetRxSpectrumModel () returned 0. Please check that the RxSpectrumModel is "
144 "already set for the phy before calling MultiModelSpectrumChannel::AddRx (phy)");
152 auto [rxInfoIterator, inserted] =
157 rxInfoIterator->second.m_rxPhys.push_back(phy);
169 if (rxSpectrumModelUid != txSpectrumModelUid &&
170 !txSpectrumModel->IsOrthogonal(*rxSpectrumModel))
172 NS_LOG_LOGIC(
"Creating converter between SpectrumModelUid "
173 << txSpectrumModel->GetUid() <<
" and " << rxSpectrumModelUid);
175 auto ret2 = txInfoIterator->second.m_spectrumConverterMap.insert(
176 std::make_pair(rxSpectrumModelUid, converter));
183TxSpectrumModelInfoMap_t::const_iterator
198 txInfoIterator = ret.first;
208 if (rxSpectrumModelUid != txSpectrumModelUid &&
209 !txSpectrumModel->IsOrthogonal(*rxSpectrumModel))
211 NS_LOG_LOGIC(
"Creating converter between SpectrumModelUid "
212 << txSpectrumModelUid <<
" and " << rxSpectrumModelUid);
214 auto ret2 = txInfoIterator->second.m_spectrumConverterMap.insert(
215 std::make_pair(rxSpectrumModelUid, converter));
222 NS_LOG_LOGIC(
"SpectrumModelUid " << txSpectrumModelUid <<
" already present");
224 return txInfoIterator;
239 auto txMobility = txParams->txPhy->GetMobility();
240 auto txSpectrumModelUid = txParams->psd->GetSpectrumModelUid();
241 NS_LOG_LOGIC(
"txSpectrumModelUid " << txSpectrumModelUid);
247 SpectrumModelUid_t rxSpectrumModelUid = rxInfoIterator->second.m_rxSpectrumModel->GetUid();
248 NS_LOG_LOGIC(
"rxSpectrumModelUids " << rxSpectrumModelUid);
250 for (
auto rxPhyIterator = rxInfoIterator->second.m_rxPhys.begin();
251 rxPhyIterator != rxInfoIterator->second.m_rxPhys.end();
254 NS_ASSERT_MSG((*rxPhyIterator)->GetRxSpectrumModel()->GetUid() == rxSpectrumModelUid,
255 "SpectrumModel change was not notified to MultiModelSpectrumChannel "
256 "(i.e., AddRx should be called again after model is changed)");
258 if ((*rxPhyIterator) != txParams->txPhy)
260 auto rxNetDevice = (*rxPhyIterator)->GetDevice();
261 auto txNetDevice = txParams->txPhy->GetDevice();
263 if (rxNetDevice && txNetDevice)
266 if (rxNetDevice->GetNode()->GetId() == txNetDevice->GetNode()->GetId())
269 "Skipping the pathloss calculation among different antennas of the "
270 "same node, not supported yet by any pathloss model in ns-3.");
281 auto rxParams = txParams->Copy();
282 rxParams->psd = Copy<SpectrumValue>(txParams->psd);
285 auto receiverMobility = (*rxPhyIterator)->GetMobility();
287 if (txMobility && receiverMobility)
289 auto txAntennaGain{0.0};
290 auto rxAntennaGain{0.0};
291 auto propagationGainDb{0.0};
292 auto pathLossDb{0.0};
293 if (rxParams->txAntenna)
295 Angles txAngles(receiverMobility->GetPosition(), txMobility->GetPosition());
296 txAntennaGain = rxParams->txAntenna->GetGainDb(txAngles);
297 NS_LOG_LOGIC(
"txAntennaGain = " << txAntennaGain <<
" dB");
298 pathLossDb -= txAntennaGain;
300 auto rxAntenna = DynamicCast<AntennaModel>((*rxPhyIterator)->GetAntenna());
303 Angles rxAngles(txMobility->GetPosition(), receiverMobility->GetPosition());
304 rxAntennaGain = rxAntenna->GetGainDb(rxAngles);
305 NS_LOG_LOGIC(
"rxAntennaGain = " << rxAntennaGain <<
" dB");
306 pathLossDb -= rxAntennaGain;
312 NS_LOG_LOGIC(
"propagationGainDb = " << propagationGainDb <<
" dB");
313 pathLossDb -= propagationGainDb;
315 NS_LOG_LOGIC(
"total pathLoss = " << pathLossDb <<
" dB");
330 auto pathGainLinear = std::pow(10.0, (-pathLossDb) / 10.0);
331 *(rxParams->psd) *= pathGainLinear;
342 auto dstNode = rxNetDevice->GetNode()->GetId();
369 const auto txSpectrumModelUid = params->psd->GetSpectrumModelUid();
370 const auto rxSpectrumModelUid = receiver->GetRxSpectrumModel()->GetUid();
372 auto txInfoIteratorerator =
376 NS_LOG_LOGIC(
"converter map for TX SpectrumModel with Uid " << txInfoIteratorerator->first);
378 "converter map size: " << txInfoIteratorerator->second.m_spectrumConverterMap.size());
380 << txInfoIteratorerator->second.m_spectrumConverterMap.begin()->first);
383 if (txSpectrumModelUid == rxSpectrumModelUid)
386 convertedPsd = params->psd;
390 NS_LOG_LOGIC(
"converting txPowerSpectrum SpectrumModelUids "
391 << txSpectrumModelUid <<
" --> " << rxSpectrumModelUid);
392 auto rxConverterIterator =
393 txInfoIteratorerator->second.m_spectrumConverterMap.find(rxSpectrumModelUid);
394 if (rxConverterIterator == txInfoIteratorerator->second.m_spectrumConverterMap.end())
399 convertedPsd = rxConverterIterator->second.Convert(params->psd);
400 NS_LOG_LOGIC(
"convertedPsd " << convertedPsd->GetValuesN());
402 params->psd = convertedPsd;
407 params->txPhy->GetMobility(),
408 receiver->GetMobility());
412 auto txPhasedArrayModel = DynamicCast<PhasedArrayModel>(params->txPhy->GetAntenna());
413 auto rxPhasedArrayModel = DynamicCast<PhasedArrayModel>(receiver->GetAntenna());
416 "PhasedArrayModel instances should be installed at both TX and RX "
417 "SpectrumPhy in order to use PhasedArraySpectrumPropagationLoss.");
421 params->txPhy->GetMobility(),
422 receiver->GetMobility(),
426 receiver->StartRx(params);
452 for (
const auto& phyIt : rxInfoIterator->second.m_rxPhys)
456 return (*phyIt).GetDevice();
Class holding the azimuth and inclination angles of spherical coordinates.
This SpectrumChannel implementation can handle the presence of SpectrumPhy instances which can use di...
void RemoveRx(Ptr< SpectrumPhy > phy) override
Remove a SpectrumPhy from a channel.
Ptr< NetDevice > GetDevice(std::size_t i) const override
std::size_t GetNDevices() const override
void AddRx(Ptr< SpectrumPhy > phy) override
Add a SpectrumPhy to a channel, so it can receive packets.
TxSpectrumModelInfoMap_t m_txSpectrumModelInfoMap
Data structure holding, for each TX SpectrumModel, all the converters to any RX SpectrumModel,...
std::size_t m_numDevices
Number of devices connected to the channel.
void DoDispose() override
Destructor implementation.
void StartTx(Ptr< SpectrumSignalParameters > params) override
Used by attached PHY instances to transmit signals on the channel.
TxSpectrumModelInfoMap_t::const_iterator FindAndEventuallyAddTxSpectrumModel(Ptr< const SpectrumModel > txSpectrumModel)
This method checks if m_rxSpectrumModelInfoMap contains an entry for the given TX SpectrumModel.
static TypeId GetTypeId()
Get the type ID.
virtual void StartRx(Ptr< SpectrumSignalParameters > params, Ptr< SpectrumPhy > receiver)
Used internally to reschedule transmission after the propagation delay.
MultiModelSpectrumChannel()
RxSpectrumModelInfoMap_t m_rxSpectrumModelInfoMap
Data structure holding, for each RX spectrum model, all the corresponding SpectrumPhy instances.
double CalcRxPower(double txPowerDbm, Ptr< MobilityModel > a, Ptr< MobilityModel > b) const
Returns the Rx Power taking into account all the PropagationLossModel(s) chained to the current one.
Smart pointer class similar to boost::intrusive_ptr.
The Rx spectrum model information.
RxSpectrumModelInfo(Ptr< const SpectrumModel > rxSpectrumModel)
Constructor.
static EventId Schedule(const Time &delay, FUNC f, Ts &&... args)
Schedule an event to expire after delay.
static void ScheduleWithContext(uint32_t context, const Time &delay, FUNC f, Ts &&... args)
Schedule an event with the given context.
Defines the interface for spectrum-aware channel implementations.
TracedCallback< Ptr< SpectrumSignalParameters > > m_txSigParamsTrace
Traced callback for SpectrumSignalParameters in StartTx requests.
void DoDispose() override
Destructor implementation.
Ptr< SpectrumTransmitFilter > m_filter
Transmit filter to be used with this channel.
Ptr< PropagationDelayModel > m_propagationDelay
Propagation delay model to be used with this channel.
Ptr< SpectrumPropagationLossModel > m_spectrumPropagationLoss
Frequency-dependent propagation loss model to be used with this channel.
Ptr< PhasedArraySpectrumPropagationLossModel > m_phasedArraySpectrumPropagationLoss
Frequency-dependent propagation loss model to be used with this channel.
TracedCallback< Ptr< const SpectrumPhy >, Ptr< const SpectrumPhy >, double > m_pathLossTrace
The PathLoss trace source.
TracedCallback< Ptr< const MobilityModel >, Ptr< const MobilityModel >, double, double, double, double > m_gainTrace
The Gain trace source.
Ptr< PropagationLossModel > m_propagationLoss
Single-frequency propagation loss model to be used with this channel.
double m_maxLossDb
Maximum loss [dB].
Class which implements a converter between SpectrumValue which are defined over different SpectrumMod...
Simulation virtual time values and global simulation resolution.
The Tx spectrum model information.
TxSpectrumModelInfo(Ptr< const SpectrumModel > txSpectrumModel)
Constructor.
a unique identifier for an interface.
TypeId SetParent(TypeId tid)
Set the parent TypeId.
#define NS_ASSERT(condition)
At runtime, in debugging builds, if this condition is not true, the program prints the source file,...
#define NS_ASSERT_MSG(condition, message)
At runtime, in debugging builds, if this condition is not true, the program prints the message to out...
#define NS_FATAL_ERROR(msg)
Report a fatal error with a message and terminate.
#define NS_LOG_COMPONENT_DEFINE(name)
Define a Log component with a specific name.
#define NS_LOG_DEBUG(msg)
Use NS_LOG to output a message of level LOG_DEBUG.
#define NS_LOG_LOGIC(msg)
Use NS_LOG to output a message of level LOG_LOGIC.
#define NS_LOG_FUNCTION(parameters)
If log level LOG_FUNCTION is enabled, this macro will output all input parameters separated by ",...
#define NS_OBJECT_ENSURE_REGISTERED(type)
Register an Object subclass with the TypeId system.
std::map< SpectrumModelUid_t, TxSpectrumModelInfo > TxSpectrumModelInfoMap_t
Container: SpectrumModelUid_t, TxSpectrumModelInfo.
Every class exported by the ns3 library is enclosed in the ns3 namespace.
std::ostream & operator<<(std::ostream &os, const Angles &a)