16#include "ns3/double.h"
18#include "ns3/net-device.h"
20#include "ns3/pointer.h"
21#include "ns3/simulator.h"
22#include "ns3/string.h"
55 TypeId(
"ns3::ThreeGppSpectrumPropagationLossModel")
57 .SetGroupName(
"Spectrum")
61 "The channel model. It needs to implement the MatrixBasedChannelModel interface",
113 size_t sAntNumElems = sW.
GetSize();
114 size_t uAntNumElems = uW.
GetSize();
115 NS_ASSERT(uAntNumElems == params->m_channel.GetNumRows());
116 NS_ASSERT(sAntNumElems == params->m_channel.GetNumCols());
118 <<
" s antenna elements, and with "
119 <<
" s ports: " << sAnt->GetNumPorts()
120 <<
" u ports: " << uAnt->GetNumPorts());
121 NS_ASSERT_MSG((sAnt !=
nullptr) && (uAnt !=
nullptr),
"Improper call to the method");
122 size_t numClusters = params->m_channel.GetNumPages();
130 for (
auto sPortIdx = 0; sPortIdx < sAnt->GetNumPorts(); sPortIdx++)
132 for (
auto uPortIdx = 0; uPortIdx < uAnt->GetNumPorts(); uPortIdx++)
134 for (
size_t cIndex = 0; cIndex < numClusters; cIndex++)
136 longTerm->Elem(uPortIdx, sPortIdx, cIndex) =
151 uint16_t cIndex)
const
156 auto sPortElems = sAnt->GetNumElemsPerPort();
157 auto uPortElems = uAnt->GetNumElemsPerPort();
158 auto startS = sAnt->ArrayIndexFromPortIndex(sPortIdx, 0);
159 auto startU = uAnt->ArrayIndexFromPortIndex(uPortIdx, 0);
160 std::complex<double> txSum(0, 0);
162 auto sIndex = startS;
167 const auto uElemsPerPort = uAnt->GetHElemsPerPort();
168 const auto sElemsPerPort = sAnt->GetHElemsPerPort();
169 for (
size_t tIndex = 0; tIndex < sPortElems; tIndex++, sIndex++)
171 std::complex<double> rxSum(0, 0);
172 auto uIndex = startU;
173 for (
size_t rIndex = 0; rIndex < uPortElems; rIndex++, uIndex++)
175 rxSum += uW[uIndex - startU] * params->m_channel(uIndex, sIndex, cIndex);
176 auto testV = (rIndex % uElemsPerPort);
177 auto ptInc = uElemsPerPort - 1;
180 auto incVal = uAnt->GetNumColumns() - uElemsPerPort;
185 txSum += sW[sIndex - startS] * rxSum;
186 auto testV = (tIndex % sElemsPerPort);
187 auto ptInc = sElemsPerPort - 1;
190 size_t incVal = sAnt->GetNumColumns() - sElemsPerPort;
203 const Vector& sSpeed,
204 const ns3::Vector& uSpeed,
207 bool isReverse)
const
212 size_t numCluster = channelMatrix->m_channel.GetNumPages();
217 double factor = 2 * M_PI * slotTime *
GetFrequency() / 3e8;
222 NS_ASSERT(numCluster <= channelParams->m_alpha.size());
223 NS_ASSERT(numCluster <= channelParams->m_D.size());
228 NS_ASSERT(numCluster <= longTerm->GetNumPages());
231 bool isSameDir = (channelParams->m_nodeIds == channelMatrix->m_nodeIds);
237 using DPV = std::vector<std::pair<double, double>>;
239 const auto& cachedAngleSincos = channelParams->m_cachedAngleSincos;
240 const DPV& zoa = cachedAngleSincos[isSameDir ? MBCM::ZOA_INDEX : MBCM::ZOD_INDEX];
241 const DPV& zod = cachedAngleSincos[isSameDir ? MBCM::ZOD_INDEX : MBCM::ZOA_INDEX];
242 const DPV& aoa = cachedAngleSincos[isSameDir ? MBCM::AOA_INDEX : MBCM::AOD_INDEX];
243 const DPV& aod = cachedAngleSincos[isSameDir ? MBCM::AOD_INDEX : MBCM::AOA_INDEX];
245 for (
size_t cIndex = 0; cIndex < numCluster; cIndex++)
258 double alpha = channelParams->m_alpha[cIndex];
259 double D = channelParams->m_D[cIndex];
264 ((zoa[cIndex].first * aoa[cIndex].second * uSpeed.x +
265 zoa[cIndex].first * aoa[cIndex].first * uSpeed.y + zoa[cIndex].second * uSpeed.z) +
266 (zod[cIndex].
first * aod[cIndex].
second * sSpeed.x +
267 zod[cIndex].first * aod[cIndex].first * sSpeed.y + zod[cIndex].second * sSpeed.z) +
269 doppler[cIndex] = std::complex<double>(cos(tempDoppler), sin(tempDoppler));
285 if (!rxParams->precodingMatrix)
289 auto vit = rxParams->psd->ValuesBegin();
291 while (vit != rxParams->psd->ValuesEnd())
294 *vit = std::norm(rxParams->spectrumChannelMatrix->Elem(0, 0, rbIdx));
301 NS_ASSERT_MSG(rxParams->psd->GetValuesN() == rxParams->spectrumChannelMatrix->GetNumPages(),
302 "RX PSD and the spectrum channel matrix should have the same number of RBs ");
310 *rxParams->spectrumChannelMatrix * (*rxParams->precodingMatrix);
317 for (
uint32_t rbIdx = 0; rbIdx < rxParams->psd->GetValuesN(); ++rbIdx)
319 (*rxParams->psd)[rbIdx] = 0.0;
321 for (
size_t txStream = 0; txStream < psd.
GetNumRows(); ++txStream)
323 (*rxParams->psd)[rbIdx] += std::real(psd(txStream, txStream, rbIdx));
339 bool isReverse)
const
341 size_t numCluster = channelMatrix->m_channel.GetNumPages();
342 auto numRb = inPsd->GetValuesN();
344 auto directionalLongTerm = isReverse ? longTerm->Transpose() : (*longTerm);
352 double rbWidth = inPsd->ConstBandsBegin()->fh - inPsd->ConstBandsBegin()->fl;
354 if (channelParams->m_cachedDelaySincos.GetNumRows() != numRb ||
355 channelParams->m_cachedDelaySincos.GetNumCols() != numCluster ||
356 channelParams->m_cachedRbWidth != rbWidth)
358 channelParams->m_cachedRbWidth = rbWidth;
360 auto sbit = inPsd->ConstBandsBegin();
361 for (
unsigned i = 0; i < numRb; i++)
363 double fsb = (*sbit).fc;
364 for (std::size_t cIndex = 0; cIndex < numCluster; cIndex++)
366 double delay = -2 * M_PI * fsb * (channelParams->m_delay[cIndex]);
367 channelParams->m_cachedDelaySincos(i, cIndex) =
368 std::complex<double>(cos(delay), sin(delay));
375 auto delaySincosCopy = channelParams->m_cachedDelaySincos;
376 for (
size_t iRb = 0; iRb < inPsd->GetValuesN(); iRb++)
378 for (std::size_t cIndex = 0; cIndex < numCluster; cIndex++)
380 delaySincosCopy(iRb, cIndex) *= doppler[cIndex];
388 auto vit = inPsd->ValuesBegin();
391 while (vit != inPsd->ValuesEnd())
395 auto sqrtVit = sqrt(*vit);
396 for (
auto rxPortIdx = 0; rxPortIdx < numRxPorts; rxPortIdx++)
398 for (
auto txPortIdx = 0; txPortIdx < numTxPorts; txPortIdx++)
400 std::complex<double> subsbandGain(0.0, 0.0);
401 for (
size_t cIndex = 0; cIndex < numCluster; cIndex++)
403 subsbandGain += directionalLongTerm(rxPortIdx, txPortIdx, cIndex) *
404 delaySincosCopy(iRb, cIndex);
408 chanSpct->Elem(rxPortIdx, txPortIdx, iRb) = sqrtVit * subsbandGain;
430 channelMatrix->IsReverse(aPhasedArrayModel->GetId(), bPhasedArrayModel->GetId());
431 auto sAntenna = isReverse ? bPhasedArrayModel : aPhasedArrayModel;
432 auto uAntenna = isReverse ? aPhasedArrayModel : bPhasedArrayModel;
438 sW = aPhasedArrayModel->GetBeamformingVector();
439 uW = bPhasedArrayModel->GetBeamformingVector();
443 sW = bPhasedArrayModel->GetBeamformingVector();
444 uW = aPhasedArrayModel->GetBeamformingVector();
448 bool notFound =
false;
451 uint64_t longTermId =
457 NS_LOG_DEBUG(
"found the long term component in the map");
463 update = (
m_longTermMap[longTermId]->m_channel->m_generatedTime !=
464 channelMatrix->m_generatedTime ||
473 if (update || notFound)
477 longTerm =
CalcLongTerm(channelMatrix, sAntenna, uAntenna);
479 longTermItem->m_longTerm = longTerm;
480 longTermItem->m_channel = channelMatrix;
481 longTermItem->m_sW = std::move(sW);
482 longTermItem->m_uW = std::move(uW);
500 NS_LOG_FUNCTION(
this << spectrumSignalParams << a << b << aPhasedArrayModel
501 << bPhasedArrayModel);
505 NS_ASSERT_MSG(aPhasedArrayModel,
"Antenna not found for node " << aId);
506 NS_LOG_DEBUG(
"a node " << aId <<
" antenna " << aPhasedArrayModel);
507 NS_ASSERT_MSG(bPhasedArrayModel,
"Antenna not found for node " << bId);
508 NS_LOG_DEBUG(
"b node " << bId <<
" antenna " << bPhasedArrayModel);
511 m_channelModel->GetChannel(a, b, aPhasedArrayModel, bPhasedArrayModel);
517 GetLongTerm(channelMatrix, aPhasedArrayModel, bPhasedArrayModel);
520 channelMatrix->IsReverse(aPhasedArrayModel->GetId(), bPhasedArrayModel->GetId());
529 aPhasedArrayModel->GetNumPorts(),
530 bPhasedArrayModel->GetNumPorts(),
Hold a value for an Attribute.
This class can be used to hold variables of floating point type such as 'double' or 'float'.
MatrixArray< T > HermitianTranspose() const
Function that performs the Hermitian transpose of this MatrixArray and returns a new matrix that is t...
This is an interface for a channel model that can be described by a channel matrix,...
static const uint8_t AOA_INDEX
index of the AOA value in the m_angle array
static const uint8_t ZOD_INDEX
index of the ZOD value in the m_angle array
static const uint8_t AOD_INDEX
index of the AOD value in the m_angle array
static const uint8_t ZOA_INDEX
index of the ZOA value in the m_angle array
static uint64_t GetKey(uint32_t a, uint32_t b)
Generate a unique value for the pair of unsigned integer of 32 bits, where the order does not matter,...
spectrum-aware propagation loss model that is compatible with PhasedArrayModel type of ns-3 antenna
Smart pointer class similar to boost::intrusive_ptr.
static Time Now()
Return the current simulation virtual time.
Hold variables of type string.
3GPP Spectrum Propagation Loss Model
void GetChannelModelAttribute(const std::string &name, AttributeValue &value) const
Returns the value of an attribute belonging to the associated MatrixBasedChannelModel instance.
Ptr< SpectrumSignalParameters > DoCalcRxPowerSpectralDensity(Ptr< const SpectrumSignalParameters > spectrumSignalParams, Ptr< const MobilityModel > a, Ptr< const MobilityModel > b, Ptr< const PhasedArrayModel > aPhasedArrayModel, Ptr< const PhasedArrayModel > bPhasedArrayModel) const override
Computes the received PSD.
Ptr< MatrixBasedChannelModel > m_channelModel
the model to generate the channel matrix
Ptr< MatrixBasedChannelModel::Complex3DVector > GenSpectrumChannelMatrix(Ptr< SpectrumValue > inPsd, Ptr< const MatrixBasedChannelModel::Complex3DVector > longTerm, Ptr< const MatrixBasedChannelModel::ChannelMatrix > channelMatrix, Ptr< const MatrixBasedChannelModel::ChannelParams > channelParams, PhasedArrayModel::ComplexVector doppler, uint8_t numTxPorts, uint8_t numRxPorts, bool isReverse) const
Computes the frequency-domain channel matrix with the dimensions numRxPorts*numTxPorts*numRBs.
Ptr< const MatrixBasedChannelModel::Complex3DVector > GetLongTerm(Ptr< const MatrixBasedChannelModel::ChannelMatrix > channelMatrix, Ptr< const PhasedArrayModel > aPhasedArrayModel, Ptr< const PhasedArrayModel > bPhasedArrayModel) const
Looks for the long term component in m_longTermMap.
void SetChannelModel(Ptr< MatrixBasedChannelModel > channel)
Set the channel model object.
Ptr< const MatrixBasedChannelModel::Complex3DVector > CalcLongTerm(Ptr< const MatrixBasedChannelModel::ChannelMatrix > channelMatrix, Ptr< const PhasedArrayModel > sAnt, Ptr< const PhasedArrayModel > uAnt) const
Computes the long term component.
~ThreeGppSpectrumPropagationLossModel() override
Destructor.
std::unordered_map< uint64_t, Ptr< const LongTerm > > m_longTermMap
map containing the long term components
double GetFrequency() const
Get the operating frequency.
int64_t DoAssignStreams(int64_t stream) override
Assign a fixed random variable stream number to the random variables used by this model.
void SetChannelModelAttribute(const std::string &name, const AttributeValue &value)
Sets the value of an attribute belonging to the associated MatrixBasedChannelModel instance.
Ptr< MatrixBasedChannelModel > GetChannelModel() const
Get the channel model object.
void DoDispose() override
Destructor implementation.
static TypeId GetTypeId()
Get the type ID.
Ptr< SpectrumSignalParameters > CalcBeamformingGain(Ptr< const SpectrumSignalParameters > params, Ptr< const MatrixBasedChannelModel::Complex3DVector > longTerm, Ptr< const MatrixBasedChannelModel::ChannelMatrix > channelMatrix, Ptr< const MatrixBasedChannelModel::ChannelParams > channelParams, const Vector &sSpeed, const Vector &uSpeed, uint8_t numTxPorts, uint8_t numRxPorts, bool isReverse) const
Computes the beamforming gain and applies it to the TX PSD.
std::complex< double > CalculateLongTermComponent(Ptr< const MatrixBasedChannelModel::ChannelMatrix > params, Ptr< const PhasedArrayModel > sAnt, Ptr< const PhasedArrayModel > uAnt, uint16_t sPortIdx, uint16_t uPortIdx, uint16_t cIndex) const
Computes a longTerm component from a specific port of s device to the specific port of u device and f...
ThreeGppSpectrumPropagationLossModel()
Constructor.
double GetSeconds() const
Get an approximation of the time stored in this instance in the indicated unit.
a unique identifier for an interface.
TypeId SetParent(TypeId tid)
Set the parent TypeId.
size_t GetNumRows() const
#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...
Ptr< const AttributeAccessor > MakePointerAccessor(T1 a1)
Create an AttributeAccessor for a class data member, or a lone class get functor or set method.
Ptr< AttributeChecker > MakePointerChecker()
Create a PointerChecker for a type.
#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_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.
Ptr< T > Create(Ts &&... args)
Create class instances by constructors with varying numbers of arguments and return them by Ptr.
Every class exported by the ns3 library is enclosed in the ns3 namespace.
MatrixArray< std::complex< double > > ComplexMatrixArray
Create an alias for MatrixArray using complex type.