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 &&
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));
183 TxSpectrumModelInfoMap_t::const_iterator
198 txInfoIterator = ret.first;
208 if (rxSpectrumModelUid != txSpectrumModelUid &&
211 NS_LOG_LOGIC(
"Creating converter between SpectrumModelUid "
212 << txSpectrumModelUid <<
" and " << rxSpectrumModelUid);
215 auto ret2 = txInfoIterator->second.m_spectrumConverterMap.insert(
216 std::make_pair(rxSpectrumModelUid, converter));
223 NS_LOG_LOGIC(
"SpectrumModelUid " << txSpectrumModelUid <<
" already present");
225 return txInfoIterator;
242 NS_LOG_LOGIC(
"txSpectrumModelUid " << txSpectrumModelUid);
245 auto txInfoIteratorerator =
249 NS_LOG_LOGIC(
"converter map for TX SpectrumModel with Uid " << txInfoIteratorerator->first);
251 "converter map size: " << txInfoIteratorerator->second.m_spectrumConverterMap.size());
253 << txInfoIteratorerator->second.m_spectrumConverterMap.begin()->first);
259 SpectrumModelUid_t rxSpectrumModelUid = rxInfoIterator->second.m_rxSpectrumModel->GetUid();
260 NS_LOG_LOGIC(
"rxSpectrumModelUids " << rxSpectrumModelUid);
263 if (txSpectrumModelUid == rxSpectrumModelUid)
266 convertedTxPowerSpectrum = txParams->
psd;
270 NS_LOG_LOGIC(
"converting txPowerSpectrum SpectrumModelUids "
271 << txSpectrumModelUid <<
" --> " << rxSpectrumModelUid);
272 auto rxConverterIterator =
273 txInfoIteratorerator->second.m_spectrumConverterMap.find(rxSpectrumModelUid);
274 if (rxConverterIterator == txInfoIteratorerator->second.m_spectrumConverterMap.end())
279 convertedTxPowerSpectrum = rxConverterIterator->second.Convert(txParams->
psd);
282 for (
auto rxPhyIterator = rxInfoIterator->second.m_rxPhys.begin();
283 rxPhyIterator != rxInfoIterator->second.m_rxPhys.end();
286 NS_ASSERT_MSG((*rxPhyIterator)->GetRxSpectrumModel()->GetUid() == rxSpectrumModelUid,
287 "SpectrumModel change was not notified to MultiModelSpectrumChannel "
288 "(i.e., AddRx should be called again after model is changed)");
290 if ((*rxPhyIterator) != txParams->
txPhy)
295 if (rxNetDevice && txNetDevice)
298 if (rxNetDevice->GetNode()->GetId() == txNetDevice->GetNode()->GetId())
301 "Skipping the pathloss calculation among different antennas of the "
302 "same node, not supported yet by any pathloss model in ns-3.");
314 rxParams->
psd = Copy<SpectrumValue>(convertedTxPowerSpectrum);
319 if (txMobility && receiverMobility)
321 double txAntennaGain = 0;
322 double rxAntennaGain = 0;
323 double propagationGainDb = 0;
324 double pathLossDb = 0;
329 NS_LOG_LOGIC(
"txAntennaGain = " << txAntennaGain <<
" dB");
330 pathLossDb -= txAntennaGain;
333 DynamicCast<AntennaModel>((*rxPhyIterator)->GetAntenna());
337 rxAntennaGain = rxAntenna->
GetGainDb(rxAngles);
338 NS_LOG_LOGIC(
"rxAntennaGain = " << rxAntennaGain <<
" dB");
339 pathLossDb -= rxAntennaGain;
345 NS_LOG_LOGIC(
"propagationGainDb = " << propagationGainDb <<
" dB");
346 pathLossDb -= propagationGainDb;
348 NS_LOG_LOGIC(
"total pathLoss = " << pathLossDb <<
" dB");
363 double pathGainLinear = std::pow(10.0, (-pathLossDb) / 10.0);
364 *(rxParams->
psd) *= pathGainLinear;
375 uint32_t dstNode = rxNetDevice->GetNode()->GetId();
406 params->txPhy->GetMobility(),
412 DynamicCast<PhasedArrayModel>(
params->txPhy->GetAntenna());
414 DynamicCast<PhasedArrayModel>(receiver->
GetAntenna());
417 "PhasedArrayModel instances should be installed at both TX and RX "
418 "SpectrumPhy in order to use PhasedArraySpectrumPropagationLoss.");
422 params->txPhy->GetMobility(),
453 for (
const auto& phyIt : rxInfoIterator->second.m_rxPhys)
457 return (*phyIt).GetDevice();
Class holding the azimuth and inclination angles of spherical coordinates.
virtual double GetGainDb(Angles a)=0
this method is expected to be re-implemented by each antenna model
Vector GetPosition() const
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.
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...
bool IsOrthogonal(const SpectrumModel &other) const
Check if another SpectrumModels has bands orthogonal to our bands.
SpectrumModelUid_t GetUid() const
virtual void StartRx(Ptr< SpectrumSignalParameters > params)=0
Notify the SpectrumPhy instance of an incoming signal.
virtual Ptr< Object > GetAntenna() const =0
Get the AntennaModel used by this SpectrumPhy instance for transmission and/or reception.
virtual Ptr< MobilityModel > GetMobility() const =0
Get the associated MobilityModel instance.
virtual Ptr< NetDevice > GetDevice() const =0
Get the associated NetDevice instance.
Ptr< const SpectrumModel > GetSpectrumModel() const
SpectrumModelUid_t GetSpectrumModelUid() const
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.
Time MicroSeconds(uint64_t value)
Construct a Time in the indicated unit.
Every class exported by the ns3 library is enclosed in the ns3 namespace.
uint32_t SpectrumModelUid_t
Uid for SpectrumModels.
std::ostream & operator<<(std::ostream &os, const Angles &a)
params
Fit Fluctuating Two Ray model to the 3GPP TR 38.901 using the Anderson-Darling goodness-of-fit ##.
Ptr< AntennaModel > txAntenna
The AntennaModel instance that was used to transmit this signal.
Ptr< SpectrumPhy > txPhy
The SpectrumPhy instance that is making the transmission.
virtual Ptr< SpectrumSignalParameters > Copy() const
make a "virtual" copy of this class, where "virtual" refers to the fact that if the actual object is ...
Ptr< SpectrumValue > psd
The Power Spectral Density of the waveform, in linear units.