Test checks if Wifi spectrum values for OFDM are generated properly. More...

Inheritance diagram for WifiOfdmMaskSlopesTestCase:

Collaboration diagram for WifiOfdmMaskSlopesTestCase:

Public Types
typedef std::pair< uint32_t, double >	IndexPowerPair
	typedef for a pair of sub-band index and relative power value (dBr)

typedef std::vector< IndexPowerPair >	IndexPowerVect
	typedef for a vector of pairs of sub-band index and relative power value (dBr)

Public Types inherited from ns3::TestCase
enum class	Duration { QUICK = 1 , EXTENSIVE = 2 , TAKES_FOREVER = 3 }
	How long the test takes to execute. More...

using	instead = Duration

Public Member Functions
	WifiOfdmMaskSlopesTestCase (const std::string &name, WifiStandard standard, WifiPhyBand band, uint16_t channelWidth, const IndexPowerVect &maskRefs, double tolerance, std::size_t precision, const std::vector< bool > &puncturedSubchannels=std::vector< bool >{})
	Constructor.

	~WifiOfdmMaskSlopesTestCase () override=default

Public Member Functions inherited from ns3::TestCase
	TestCase (const TestCase &)=delete

virtual	~TestCase ()
	Destructor.

std::string	GetName () const

TestCase &	operator= (const TestCase &)=delete

Private Member Functions
void	DoRun () override
	Implementation to actually run this TestCase.

void	DoSetup () override
	Implementation to do any local setup required for this TestCase.

void	InterpolateAndAppendValues (IndexPowerVect &vect, IndexPowerPair start, IndexPowerPair stop) const
	Interpolate PSD values for indexes between provided start and stop and append to provided vector.

Private Attributes
Ptr< SpectrumValue >	m_actualSpectrum
	actual spectrum value

WifiPhyBand	m_band
	the wifi PHY band to use for the test

uint16_t	m_channelWidth
	the channel width in MHz to use for the test

IndexPowerVect	m_expectedPsd
	expected power values

std::size_t	m_precision
	precision for double calculations (in decimals)

std::vector< bool >	m_puncturedSubchannels
	bitmap indicating whether a 20 MHz subchannel is punctured or not (only used for 802.11ax and later)

WifiStandard	m_standard
	the wifi standard to use for the test

double	m_tolerance
	tolerance (in dB)

Additional Inherited Members
Static Public Attributes inherited from ns3::TestCase
static constexpr auto	EXTENSIVE = Duration::EXTENSIVE

static constexpr auto	QUICK = Duration::QUICK

static constexpr auto	TAKES_FOREVER

Protected Member Functions inherited from ns3::TestCase
	TestCase (std::string name)
	Constructor.

void	AddTestCase (TestCase *testCase, Duration duration=Duration::QUICK)
	Add an individual child TestCase to this test suite.

TestCase *	GetParent () const
	Get the parent of this TestCase.

bool	IsStatusFailure () const
	Check if any tests failed.

bool	IsStatusSuccess () const
	Check if all tests passed.

void	SetDataDir (std::string directory)
	Set the data directory where reference trace files can be found.

void	ReportTestFailure (std::string cond, std::string actual, std::string limit, std::string message, std::string file, int32_t line)
	Log the failure of this TestCase.

bool	MustAssertOnFailure () const
	Check if this run should assert on failure.

bool	MustContinueOnFailure () const
	Check if this run should continue on failure.

std::string	CreateDataDirFilename (std::string filename)
	Construct the full path to a file in the data directory.

std::string	CreateTempDirFilename (std::string filename)
	Construct the full path to a file in a temporary directory.

Detailed Description

Test checks if Wifi spectrum values for OFDM are generated properly.

Different test cases are configured by defining different standards and bandwidth.

Definition at line 40 of file wifi-transmit-mask-test.cc.

Member Typedef Documentation

◆ IndexPowerPair

typedef std::pair<uint32_t, double> WifiOfdmMaskSlopesTestCase::IndexPowerPair

typedef for a pair of sub-band index and relative power value (dBr)

Definition at line 46 of file wifi-transmit-mask-test.cc.

◆ IndexPowerVect

typedef std::vector<IndexPowerPair> WifiOfdmMaskSlopesTestCase::IndexPowerVect

typedef for a vector of pairs of sub-band index and relative power value (dBr)

Definition at line 51 of file wifi-transmit-mask-test.cc.

Constructor & Destructor Documentation

◆ WifiOfdmMaskSlopesTestCase()

WifiOfdmMaskSlopesTestCase::WifiOfdmMaskSlopesTestCase	(	const std::string &	name,
		WifiStandard	standard,
		WifiPhyBand	band,
		uint16_t	channelWidth,
		const IndexPowerVect &	maskRefs,
		double	tolerance,
		std::size_t	precision,
		const std::vector< bool > &	puncturedSubchannels = `std::vector<bool>{}`
	)

Constructor.

Parameters

name	test reference name
standard	selected standard
band	selected PHY band
channelWidth	channel width (in MHz)
maskRefs	vector of expected power values and corresponding indexes of generated PSD (only start and stop indexes/values given)
tolerance	tolerance (in dB)
precision	precision (in decimals)
puncturedSubchannels	bitmap indicating whether a 20 MHz subchannel is punctured or not (only for 802.11ax and later)

Definition at line 106 of file wifi-transmit-mask-test.cc.

References NS_LOG_FUNCTION.

◆ ~WifiOfdmMaskSlopesTestCase()

WifiOfdmMaskSlopesTestCase::~WifiOfdmMaskSlopesTestCase ( )

overridedefault

Member Function Documentation

◆ DoRun()

void WifiOfdmMaskSlopesTestCase::DoRun ( )

overrideprivatevirtual

Implementation to actually run this TestCase.

Subclasses should override this method to conduct their tests.

Implements ns3::TestCase.

Definition at line 284 of file wifi-transmit-mask-test.cc.

References ns3::SpectrumValue::ConstValuesBegin(), ns3::SpectrumValue::ConstValuesEnd(), m_actualSpectrum, m_expectedPsd, m_tolerance, NS_LOG_FUNCTION, NS_LOG_INFO, NS_LOG_LOGIC, and NS_TEST_EXPECT_MSG_EQ_TOL.

Here is the call graph for this function:

◆ DoSetup()

void WifiOfdmMaskSlopesTestCase::DoSetup ( )

overrideprivatevirtual

Implementation to do any local setup required for this TestCase.

Subclasses should override this method to perform any costly per-test setup before DoRun is invoked.

Reimplemented from ns3::TestCase.

Definition at line 130 of file wifi-transmit-mask-test.cc.

References ns3::WifiSpectrumValueHelper::CreateHeOfdmTxPowerSpectralDensity(), ns3::WifiSpectrumValueHelper::CreateHtOfdmTxPowerSpectralDensity(), ns3::WifiSpectrumValueHelper::CreateOfdmTxPowerSpectralDensity(), InterpolateAndAppendValues(), m_actualSpectrum, m_band, m_channelWidth, m_expectedPsd, m_puncturedSubchannels, m_standard, NS_ASSERT, NS_FATAL_ERROR, NS_LOG_FUNCTION, NS_LOG_INFO, ns3::WIFI_PHY_BAND_2_4GHZ, ns3::WIFI_PHY_BAND_5GHZ, ns3::WIFI_PHY_BAND_6GHZ, ns3::WIFI_STANDARD_80211a, ns3::WIFI_STANDARD_80211ac, ns3::WIFI_STANDARD_80211ax, ns3::WIFI_STANDARD_80211g, ns3::WIFI_STANDARD_80211n, and ns3::WIFI_STANDARD_80211p.

Here is the call graph for this function:

◆ InterpolateAndAppendValues()

void WifiOfdmMaskSlopesTestCase::InterpolateAndAppendValues	(	IndexPowerVect &	vect,
		IndexPowerPair	start,
		IndexPowerPair	stop
	)		const

private

Interpolate PSD values for indexes between provided start and stop and append to provided vector.

Parameters

vect	vector of sub-band index and relative power value pairs to which interpolated values should be appended
start	pair of sub-band index and relative power value (dBr) for interval start
stop	pair of sub-band index and relative power value (dBr) for interval stop

Definition at line 254 of file wifi-transmit-mask-test.cc.

References m_precision, m_tolerance, NS_ASSERT, NS_LOG_FUNCTION, NS_LOG_LOGIC, and ns3::TestDoubleIsEqual().

Referenced by DoSetup().

Here is the call graph for this function:

Here is the caller graph for this function:

Member Data Documentation

◆ m_actualSpectrum

Ptr<SpectrumValue> WifiOfdmMaskSlopesTestCase::m_actualSpectrum

private

actual spectrum value

Definition at line 100 of file wifi-transmit-mask-test.cc.

Referenced by DoRun(), and DoSetup().

◆ m_band

WifiPhyBand WifiOfdmMaskSlopesTestCase::m_band

private

the wifi PHY band to use for the test

Definition at line 95 of file wifi-transmit-mask-test.cc.

Referenced by DoSetup().

◆ m_channelWidth

uint16_t WifiOfdmMaskSlopesTestCase::m_channelWidth

private

the channel width in MHz to use for the test

Definition at line 96 of file wifi-transmit-mask-test.cc.

Referenced by DoSetup().

◆ m_expectedPsd

IndexPowerVect WifiOfdmMaskSlopesTestCase::m_expectedPsd

private

expected power values

Definition at line 101 of file wifi-transmit-mask-test.cc.

Referenced by DoRun(), and DoSetup().

◆ m_precision

std::size_t WifiOfdmMaskSlopesTestCase::m_precision

private

precision for double calculations (in decimals)

Definition at line 103 of file wifi-transmit-mask-test.cc.

Referenced by InterpolateAndAppendValues().

◆ m_puncturedSubchannels

std::vector<bool> WifiOfdmMaskSlopesTestCase::m_puncturedSubchannels

private

bitmap indicating whether a 20 MHz subchannel is punctured or not (only used for 802.11ax and later)

Definition at line 98 of file wifi-transmit-mask-test.cc.

Referenced by DoSetup().

◆ m_standard

WifiStandard WifiOfdmMaskSlopesTestCase::m_standard

private

the wifi standard to use for the test

Definition at line 94 of file wifi-transmit-mask-test.cc.

Referenced by DoSetup().

◆ m_tolerance

double WifiOfdmMaskSlopesTestCase::m_tolerance

private

tolerance (in dB)

Definition at line 102 of file wifi-transmit-mask-test.cc.

Referenced by DoRun(), and InterpolateAndAppendValues().

The documentation for this class was generated from the following file:

src/wifi/test/wifi-transmit-mask-test.cc

Public Types

Public Member Functions

Private Member Functions

Private Attributes

Additional Inherited Members

Detailed Description

Member Typedef Documentation

◆ IndexPowerPair

◆ IndexPowerVect

Constructor & Destructor Documentation

◆ WifiOfdmMaskSlopesTestCase()

◆ ~WifiOfdmMaskSlopesTestCase()

Member Function Documentation

◆ DoRun()

◆ DoSetup()

◆ InterpolateAndAppendValues()

Member Data Documentation

◆ m_actualSpectrum

◆ m_band

◆ m_channelWidth

◆ m_expectedPsd

◆ m_precision

◆ m_puncturedSubchannels

◆ m_standard

◆ m_tolerance