#include <crng.h>

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:

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

virtual void	selfTest ()=0

virtual unsigned long	getNumbersDrawn () const

virtual unsigned long	intRand ()=0

virtual unsigned long	intRandMax ()=0

virtual unsigned long	intRand (unsigned long 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)

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

const cObject *	getThisPtr () const

virtual std::string	str () const

virtual _OPPDEPRECATED std::string	info () const

virtual _OPPDEPRECATED std::string	detailedInfo () 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 void	forEachChild (cVisitor *v)

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

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.