Description

Abstract interface for random number generator classes.

Some known implementations are cMersenneTwister, cLCG32 and cAkaroaRNG. The actual RNG class to be used in simulations can be configured (a feature of the Envir library).

To switch to your own RNG, subclass cRNG, register your new class with the Register_Class() macro, then select it by adding the following to omnetpp.ini:

[General]
rng-class="MyClass"

See also cModule::getRNG().

Inheritance diagram for cRNG:

[legend]

Public Member Functions
virtual void	initialize (int seedSet, int rngId, int numRngs, int parsimProcId, int parsimNumPartitions, cConfiguration *cfg)=0

virtual void	selfTest ()=0

virtual uint64_t	getNumbersDrawn () const

virtual uint32_t	intRand ()=0

virtual uint32_t	intRandMax ()=0

virtual uint32_t	intRand (uint32_t n)=0

virtual double	doubleRand ()=0

virtual double	doubleRandNonz ()=0

virtual double	doubleRandIncl1 ()=0

double	doubleRandNonzIncl1 ()

Public Member Functions inherited from cObject
	cObject ()

	cObject (const cObject &other)=default

virtual	~cObject ()

virtual const char *	getClassName () const

virtual const char *	getName () const

bool	isName (const char *s) const

virtual const char *	getFullName () const

virtual std::string	getFullPath () const

virtual std::string	getClassAndFullName () const

virtual std::string	getClassAndFullPath () const

const cObject *	getThisPtr () const

virtual std::string	str () const

virtual std::ostream &	printOn (std::ostream &os) const

virtual cObject *	dup () const

virtual void	parsimPack (cCommBuffer *buffer) const

virtual void	parsimUnpack (cCommBuffer *buffer)

virtual cObject *	getOwner () const

virtual bool	isOwnedObject () const

virtual bool	isSoftOwner () const

virtual void	forEachChild (cVisitor *v)

cObject *	findObject (const char *name, bool deep=true)

virtual cClassDescriptor *	getDescriptor () const

void	copyNotSupported () const

Additional Inherited Members
Protected Member Functions inherited from cObject
virtual void	take (cOwnedObject *obj)

virtual void	drop (cOwnedObject *obj)

void	dropAndDelete (cOwnedObject *obj)

Member Function Documentation

◆ initialize()

virtual void initialize	(	int	seedSet,
		int	rngId,
		int	numRngs,
		int	parsimProcId,
		int	parsimNumPartitions,
		cConfiguration *	cfg
	)

pure virtual

Called by the simulation framework to set up the RNG at the start of a simulation run. Seed selection should take place here.

Implemented in cLCG32, and cMersenneTwister.

◆ selfTest()

virtual void selfTest ( )

pure virtual

Coarse test for the correctness of the RNG algorithm. It should detect platform-dependent bugs (e.g. caused by different word size or compiler anomaly). The method should throw an exception if something is wrong. It is invoked only once, when the simulation program starts up.

Implemented in cLCG32, and cMersenneTwister.