Set of values corresponding to a given SpectrumModel. More...
#include "spectrum-value.h"
Public Types | |
typedef void(* | TracedCallback) (Ptr< SpectrumValue > value) |
TracedCallback signature for SpectrumValue. | |
Public Member Functions | |
SpectrumValue () | |
SpectrumValue (Ptr< const SpectrumModel > sm) | |
SpectrumValue constructor. | |
Bands::const_iterator | ConstBandsBegin () const |
Bands::const_iterator | ConstBandsEnd () const |
Values::const_iterator | ConstValuesBegin () const |
Values::const_iterator | ConstValuesEnd () const |
Ptr< SpectrumValue > | Copy () const |
Ptr< const SpectrumModel > | GetSpectrumModel () const |
SpectrumModelUid_t | GetSpectrumModelUid () const |
uint32_t | GetValuesN () const |
Get the number of values stored in the array. | |
SpectrumValue & | operator*= (const SpectrumValue &rhs) |
Multiply *this by the Right Hand Side of the operator, component by component. | |
SpectrumValue & | operator*= (double rhs) |
Multiply every component of *this by the value of the Right Hand Side of the operator. | |
SpectrumValue & | operator+= (const SpectrumValue &rhs) |
Add the Right Hand Side of the operator to *this, component by component. | |
SpectrumValue & | operator+= (double rhs) |
Add the value of the Right Hand Side of the operator to all components of *this. | |
SpectrumValue & | operator-= (const SpectrumValue &rhs) |
Subtract the Right Hand Side of the operator from *this, component by component. | |
SpectrumValue & | operator-= (double rhs) |
Subtract the value of the Right Hand Side of the operator from all components of *this. | |
SpectrumValue & | operator/= (const SpectrumValue &rhs) |
Divide *this by the Right Hand Side of the operator, component by component. | |
SpectrumValue & | operator/= (double rhs) |
Divide every component of *this by the value of the Right Hand Side of the operator. | |
SpectrumValue | operator<< (int n) const |
left shift operator | |
SpectrumValue & | operator= (double rhs) |
Assign each component of *this to the value of the Right Hand Side of the operator. | |
SpectrumValue | operator>> (int n) const |
right shift operator | |
double & | operator[] (size_t index) |
Access value at given frequency index. | |
const double & | operator[] (size_t index) const |
Access value at given frequency index. | |
const double & | ValuesAt (uint32_t pos) const |
Get the value element at the position. | |
Values::iterator | ValuesBegin () |
Values::iterator | ValuesEnd () |
Public Member Functions inherited from ns3::SimpleRefCount< SpectrumValue > | |
SimpleRefCount () | |
Default constructor. | |
SimpleRefCount (const SimpleRefCount &o) | |
Copy constructor. | |
uint32_t | GetReferenceCount () const |
Get the reference count of the object. | |
SimpleRefCount & | operator= (const SimpleRefCount &o) |
Assignment operator. | |
void | Ref () const |
Increment the reference count. | |
void | Unref () const |
Decrement the reference count. | |
Private Member Functions | |
void | Add (const SpectrumValue &x) |
Add a SpectrumValue (element to element addition) | |
void | Add (double s) |
Add a flat value to all the current elements. | |
void | ChangeSign () |
Change the values sign. | |
void | Divide (const SpectrumValue &x) |
Divides by a SpectrumValue (element to element division) | |
void | Divide (double s) |
Divides by a flat value to all the current elements. | |
void | Exp (double base) |
Modifies each element so that it is the base raised to each element value. | |
void | Log () |
Applies a Log to each the elements. | |
void | Log10 () |
Applies a Log10 to each the elements. | |
void | Log2 () |
Applies a Log2 to each the elements. | |
void | Multiply (const SpectrumValue &x) |
Multiplies for a SpectrumValue (element to element multiplication) | |
void | Multiply (double s) |
Multiplies for a flat value to all the current elements. | |
void | Pow (double exp) |
Modifies each element so that it each element is raised to the exponent. | |
void | ShiftLeft (int n) |
Shift the values to the left. | |
void | ShiftRight (int n) |
Shift the values to the right. | |
void | Subtract (const SpectrumValue &x) |
Subtracts a SpectrumValue (element by element subtraction) | |
void | Subtract (double s) |
Subtracts a flat value to all the current elements. | |
Private Attributes | |
Ptr< const SpectrumModel > | m_spectrumModel |
The spectrum model. | |
Values | m_values |
Set of values which implement the codomain of the functions in the Function Space defined by SpectrumValue. | |
Set of values corresponding to a given SpectrumModel.
This class implements a Function Space which can represent any function
Every instance of this class represent a particular function . The domain of the function space, i.e., , is implemented by Bands. The codomain of the function space is implemented by Values.
To every possible value of corresponds a different Function Space. Mathematical operations are defined in this Function Space; these operations are implemented by means of operator overloading.
The intended use of this class is to represent frequency-dependent things, such as power spectral densities, frequency-dependent propagation losses, spectral masks, etc.
Definition at line 59 of file spectrum-value.h.
typedef void(* ns3::SpectrumValue::TracedCallback) (Ptr< SpectrumValue > value) |
TracedCallback signature for SpectrumValue.
[in] | value | Value of the traced variable. |
Ptr<SpectrumPhy>
argument is deprecated and will be changed to Ptr<const SpectrumPhy>
in a future release. Definition at line 507 of file spectrum-value.h.
ns3::SpectrumValue::SpectrumValue | ( | Ptr< const SpectrumModel > | sm | ) |
SpectrumValue constructor.
sm | pointer to the SpectrumModel which implements the set of frequencies to which the values will be referring. |
Definition at line 34 of file spectrum-value.cc.
ns3::SpectrumValue::SpectrumValue | ( | ) |
Definition at line 30 of file spectrum-value.cc.
|
private |
Add a SpectrumValue (element to element addition)
x | SpectrumValue |
Definition at line 101 of file spectrum-value.cc.
References m_spectrumModel, m_values, and NS_ASSERT.
Referenced by operator+=(), and Subtract().
|
private |
Add a flat value to all the current elements.
s | flat value |
Definition at line 118 of file spectrum-value.cc.
References m_values.
|
private |
Bands::const_iterator ns3::SpectrumValue::ConstBandsBegin | ( | ) | const |
Definition at line 89 of file spectrum-value.cc.
References ns3::SpectrumModel::Begin(), and m_spectrumModel.
Referenced by ns3::ShannonSpectrumErrorModel::EvaluateChunk().
Bands::const_iterator ns3::SpectrumValue::ConstBandsEnd | ( | ) | const |
Definition at line 95 of file spectrum-value.cc.
References ns3::SpectrumModel::End(), and m_spectrumModel.
Referenced by ns3::ShannonSpectrumErrorModel::EvaluateChunk().
Values::const_iterator ns3::SpectrumValue::ConstValuesBegin | ( | ) | const |
Definition at line 65 of file spectrum-value.cc.
References m_values.
Referenced by ns3::LteUePhy::ComputeAvgSinr(), ns3::LteAmc::CreateCqiFeedbacks(), ns3::LteEnbPhy::CreatePuschCqiReport(), ns3::LteEnbPhy::CreateSrsCqiReport(), WifiOfdmMaskSlopesTestCase::DoRun(), ns3::ShannonSpectrumErrorModel::EvaluateChunk(), ns3::LteUePhy::GenerateCqiRsrpRsrq(), ns3::LteMiErrorModel::GetPcfichPdcchError(), ns3::operator<<(), and ns3::LteUePhy::ReportRsReceivedPower().
Values::const_iterator ns3::SpectrumValue::ConstValuesEnd | ( | ) | const |
Definition at line 71 of file spectrum-value.cc.
References m_values.
Referenced by ns3::LteUePhy::ComputeAvgSinr(), ns3::LteAmc::CreateCqiFeedbacks(), ns3::LteEnbPhy::CreatePuschCqiReport(), ns3::LteEnbPhy::CreateSrsCqiReport(), WifiOfdmMaskSlopesTestCase::DoRun(), ns3::ShannonSpectrumErrorModel::EvaluateChunk(), ns3::LteUePhy::GenerateCqiRsrpRsrq(), ns3::LteMiErrorModel::GetPcfichPdcchError(), ns3::operator<<(), and ns3::LteUePhy::ReportRsReceivedPower().
Ptr< SpectrumValue > ns3::SpectrumValue::Copy | ( | ) | const |
Definition at line 377 of file spectrum-value.cc.
References m_spectrumModel.
Referenced by ns3::SpectrumSignalParameters::SpectrumSignalParameters(), ns3::LrWpanInterferenceHelper::GetSignalPsd(), and LteUplinkSrsSinrTestCase::ReportSinr().
|
private |
Divides by a SpectrumValue (element to element division)
x | SpectrumValue |
Definition at line 182 of file spectrum-value.cc.
References m_spectrumModel, m_values, and NS_ASSERT.
Referenced by operator/=().
|
private |
Divides by a flat value to all the current elements.
s | flat value |
Definition at line 199 of file spectrum-value.cc.
References m_values, and NS_LOG_FUNCTION.
|
private |
Modifies each element so that it is the base raised to each element value.
base | the base |
Definition at line 269 of file spectrum-value.cc.
References m_values, and NS_LOG_FUNCTION.
Ptr< const SpectrumModel > ns3::SpectrumValue::GetSpectrumModel | ( | ) | const |
Definition at line 59 of file spectrum-value.cc.
References m_spectrumModel.
Referenced by SpectrumValueTestCase::DoRun(), ns3::LteChunkProcessor::EvaluateChunk(), ns3::SpectrumAnalyzer::GenerateReport(), ns3::LrWpanPhy::GetRxSpectrumModel(), and ns3::HalfDuplexIdealPhy::GetRxSpectrumModel().
SpectrumModelUid_t ns3::SpectrumValue::GetSpectrumModelUid | ( | ) | const |
Definition at line 53 of file spectrum-value.cc.
References ns3::SpectrumModel::GetUid(), and m_spectrumModel.
Referenced by LteDownlinkPowerControlSpectrumValueTestCase::DoRun(), LteNoisePsdTestCase::DoRun(), and LteTxPsdTestCase::DoRun().
uint32_t ns3::SpectrumValue::GetValuesN | ( | ) | const |
Get the number of values stored in the array.
Definition at line 642 of file spectrum-value.cc.
References m_values.
|
private |
Applies a Log to each the elements.
Definition at line 308 of file spectrum-value.cc.
References m_values, and NS_LOG_FUNCTION.
|
private |
Applies a Log10 to each the elements.
Definition at line 282 of file spectrum-value.cc.
References m_values, and NS_LOG_FUNCTION.
|
private |
Applies a Log2 to each the elements.
Definition at line 295 of file spectrum-value.cc.
References m_values, and NS_LOG_FUNCTION.
|
private |
Multiplies for a SpectrumValue (element to element multiplication)
x | SpectrumValue |
Definition at line 153 of file spectrum-value.cc.
References m_spectrumModel, m_values, and NS_ASSERT.
Referenced by operator*=().
|
private |
Multiplies for a flat value to all the current elements.
s | flat value |
Definition at line 170 of file spectrum-value.cc.
References m_values.
SpectrumValue & ns3::SpectrumValue::operator*= | ( | const SpectrumValue & | rhs | ) |
Multiply *this by the Right Hand Side of the operator, component by component.
rhs | the Right Hand Side |
Definition at line 571 of file spectrum-value.cc.
References Multiply().
SpectrumValue & ns3::SpectrumValue::operator*= | ( | double | rhs | ) |
Multiply every component of *this by the value of the Right Hand Side of the operator.
rhs | the Right Hand Side |
Definition at line 599 of file spectrum-value.cc.
References Multiply().
SpectrumValue & ns3::SpectrumValue::operator+= | ( | const SpectrumValue & | rhs | ) |
Add the Right Hand Side of the operator to *this, component by component.
rhs | the Right Hand Side |
Definition at line 557 of file spectrum-value.cc.
References Add().
SpectrumValue & ns3::SpectrumValue::operator+= | ( | double | rhs | ) |
Add the value of the Right Hand Side of the operator to all components of *this.
rhs | the Right Hand Side |
Definition at line 585 of file spectrum-value.cc.
References Add().
SpectrumValue & ns3::SpectrumValue::operator-= | ( | const SpectrumValue & | rhs | ) |
Subtract the Right Hand Side of the operator from *this, component by component.
rhs | the Right Hand Side |
Definition at line 564 of file spectrum-value.cc.
References Subtract().
SpectrumValue & ns3::SpectrumValue::operator-= | ( | double | rhs | ) |
Subtract the value of the Right Hand Side of the operator from all components of *this.
rhs | the Right Hand Side |
Definition at line 592 of file spectrum-value.cc.
References Subtract().
SpectrumValue & ns3::SpectrumValue::operator/= | ( | const SpectrumValue & | rhs | ) |
Divide *this by the Right Hand Side of the operator, component by component.
rhs | the Right Hand Side |
Definition at line 578 of file spectrum-value.cc.
References Divide().
SpectrumValue & ns3::SpectrumValue::operator/= | ( | double | rhs | ) |
Divide every component of *this by the value of the Right Hand Side of the operator.
rhs | the Right Hand Side |
Definition at line 606 of file spectrum-value.cc.
References Divide().
SpectrumValue ns3::SpectrumValue::operator<< | ( | int | n | ) | const |
left shift operator
n | position to shift |
Definition at line 625 of file spectrum-value.cc.
SpectrumValue & ns3::SpectrumValue::operator= | ( | double | rhs | ) |
Assign each component of *this to the value of the Right Hand Side of the operator.
rhs |
Definition at line 613 of file spectrum-value.cc.
References m_values.
SpectrumValue ns3::SpectrumValue::operator>> | ( | int | n | ) | const |
right shift operator
n | position to shift |
Definition at line 634 of file spectrum-value.cc.
double & ns3::SpectrumValue::operator[] | ( | size_t | index | ) |
Access value at given frequency index.
index | the given frequency index |
Definition at line 41 of file spectrum-value.cc.
References m_values.
const double & ns3::SpectrumValue::operator[] | ( | size_t | index | ) | const |
Access value at given frequency index.
index | the given frequency index |
Definition at line 47 of file spectrum-value.cc.
References m_values.
|
private |
Modifies each element so that it each element is raised to the exponent.
exp | the exponent |
Definition at line 256 of file spectrum-value.cc.
References m_values, and NS_LOG_FUNCTION.
|
private |
Shift the values to the left.
n | number of positions to shift |
Definition at line 224 of file spectrum-value.cc.
References m_values.
|
private |
Shift the values to the right.
n | number of positions to shift |
Definition at line 240 of file spectrum-value.cc.
References m_values.
|
private |
Subtracts a SpectrumValue (element by element subtraction)
x | SpectrumValue |
Definition at line 130 of file spectrum-value.cc.
References m_spectrumModel, m_values, and NS_ASSERT.
Referenced by operator-=().
|
private |
Subtracts a flat value to all the current elements.
s | flat value |
Definition at line 147 of file spectrum-value.cc.
References Add().
Get the value element at the position.
pos | position |
Definition at line 648 of file spectrum-value.cc.
References m_values.
Values::iterator ns3::SpectrumValue::ValuesBegin | ( | ) |
Definition at line 77 of file spectrum-value.cc.
References m_values.
Values::iterator ns3::SpectrumValue::ValuesEnd | ( | ) |
Definition at line 83 of file spectrum-value.cc.
References m_values.
|
friend |
arg | the argument |
Definition at line 360 of file spectrum-value.cc.
|
friend |
arg | the argument |
Definition at line 549 of file spectrum-value.cc.
|
friend |
arg | the argument |
Definition at line 533 of file spectrum-value.cc.
|
friend |
arg | the argument |
Definition at line 541 of file spectrum-value.cc.
|
friend |
x | the operand |
Definition at line 321 of file spectrum-value.cc.
|
friend |
multiplication component-by-component (Schur product)
lhs | Left Hand Side of the operator |
rhs | Right Hand Side of the operator |
Definition at line 455 of file spectrum-value.cc.
|
friend |
multiplication by a scalar
lhs | Left Hand Side of the operator |
rhs | Right Hand Side of the operator |
Definition at line 463 of file spectrum-value.cc.
|
friend |
multiplication of a scalar
lhs | Left Hand Side of the operator |
rhs | Right Hand Side of the operator |
Definition at line 471 of file spectrum-value.cc.
|
friend |
addition operator
lhs | Left Hand Side of the operator |
rhs | Right Hand Side of the operator |
Definition at line 406 of file spectrum-value.cc.
|
friend |
addition operator
lhs | Left Hand Side of the operator |
rhs | Right Hand Side of the operator |
Definition at line 414 of file spectrum-value.cc.
|
friend |
unary plus operator
rhs | Right Hand Side of the operator |
Definition at line 503 of file spectrum-value.cc.
|
friend |
addition operator
lhs | Left Hand Side of the operator |
rhs | Right Hand Side of the operator |
Definition at line 422 of file spectrum-value.cc.
|
friend |
subtraction operator
lhs | Left Hand Side of the operator |
rhs | Right Hand Side of the operator |
Definition at line 430 of file spectrum-value.cc.
|
friend |
subtraction operator
lhs | Left Hand Side of the operator |
rhs | Right Hand Side of the operator |
Definition at line 439 of file spectrum-value.cc.
|
friend |
unary minus operator
rhs | Right Hand Side of the operator |
Definition at line 509 of file spectrum-value.cc.
|
friend |
subtraction operator
lhs | Left Hand Side of the operator |
rhs | Right Hand Side of the operator |
Definition at line 447 of file spectrum-value.cc.
|
friend |
division component-by-component
lhs | Left Hand Side of the operator |
rhs | Right Hand Side of the operator |
Definition at line 479 of file spectrum-value.cc.
|
friend |
division by a scalar
lhs | Left Hand Side of the operator |
rhs | Right Hand Side of the operator |
Definition at line 487 of file spectrum-value.cc.
|
friend |
division of a scalar
lhs | Left Hand Side of the operator |
rhs | Right Hand Side of the operator |
Definition at line 495 of file spectrum-value.cc.
|
friend |
lhs | the base |
rhs | the exponent |
Definition at line 525 of file spectrum-value.cc.
|
friend |
lhs | the base |
rhs | the exponent |
Definition at line 517 of file spectrum-value.cc.
|
friend |
x | the operand |
Definition at line 347 of file spectrum-value.cc.
|
friend |
x | the operand |
Definition at line 334 of file spectrum-value.cc.
|
private |
The spectrum model.
Definition at line 590 of file spectrum-value.h.
Referenced by Add(), ConstBandsBegin(), ConstBandsEnd(), Copy(), Divide(), GetSpectrumModel(), GetSpectrumModelUid(), Multiply(), and Subtract().
|
private |
Set of values which implement the codomain of the functions in the Function Space defined by SpectrumValue.
There is no restriction on what these values represent (a transmission power density, a propagation loss, etc.).
Definition at line 599 of file spectrum-value.h.
Referenced by Add(), ChangeSign(), ConstValuesBegin(), ConstValuesEnd(), Divide(), Exp(), GetValuesN(), Log(), Log10(), Log2(), Multiply(), operator=(), operator[](), Pow(), ShiftLeft(), ShiftRight(), Subtract(), ValuesAt(), ValuesBegin(), and ValuesEnd().