RandomConcurrent_test::Experiment< GEN, threads > Struct Template Reference

Description

template<typename GEN, uint threads>
struct lib::test::RandomConcurrent_test::Experiment< GEN, threads >

Research setup to investigate concurrent access to a random generator.

From each test thread, the shared generator instance is invoked a huge number times (defined by NUM_INVOKES), thereby computing the mean value and checking for defect numbers outside the generator's definition range. This probe cycle is repeated several times (defined by NUM_SAMPLES) and the results are collected and evaluated afterwards to detect signs of a skewed distribution.

Template Parameters

GEN	a C++ compliant generator type
threads	number of threads to run in parallel

Remarks

Pseudo random number generation as such is not threadsafe, and pressing for concurrent access (as done here) will produce a corrupted internal generator state sooner or later. Under some circumstances however, theses glitches can be ignored, if quality of generated numbers actually does not matter.

Definition at line 114 of file random-concurrent-test.cpp.

Public Types
using	ResVal = GEN::result_type

Public Attributes
deque< tuple< double, uint > >	results
GEN	generator
const uint	N = NUM_INVOKES
const uint	REPEATS = NUM_SAMPLES / threads
ResVal	expect = (GEN::max() - GEN::min()) / 2
double	percentGlitches {0.0}
double	percentTilted {0.0}
bool	isFailure {false}

Public Member Functions
void	recordRun (double err, uint fails)
	Experiment (GEN &&fun)
void	perform ()
	run the experiment series

Additional Inherited Members
Static Public Member Functions inherited from Sync< CONF >
static Monitor &	getMonitor (Sync const *forThis)

Constructor & Destructor Documentation

Experiment()

template<typename GEN , uint threads>

Experiment ( GEN &&  fun )

inline

Definition at line 129 of file random-concurrent-test.cpp.

Member Typedef Documentation

ResVal

template<typename GEN , uint threads>

using ResVal = GEN::result_type

Definition at line 135 of file random-concurrent-test.cpp.

Member Function Documentation

recordRun()

template<typename GEN , uint threads>

void recordRun ( double  err, uint  fails  )

inline

Definition at line 120 of file random-concurrent-test.cpp.

References RandomConcurrent_test::Experiment< GEN, threads >::results.

Referenced by RandomConcurrent_test::Experiment< GEN, threads >::perform().

Here is the caller graph for this function:

perform()

template<typename GEN , uint threads>

void perform ( )

inline

run the experiment series

Definition at line 145 of file random-concurrent-test.cpp.

References RandomConcurrent_test::Experiment< GEN, threads >::expect, RandomConcurrent_test::Experiment< GEN, threads >::generator, RandomConcurrent_test::Experiment< GEN, threads >::isFailure, RandomConcurrent_test::Experiment< GEN, threads >::N, RandomConcurrent_test::Experiment< GEN, threads >::percentGlitches, RandomConcurrent_test::Experiment< GEN, threads >::percentTilted, RandomConcurrent_test::Experiment< GEN, threads >::recordRun(), RandomConcurrent_test::Experiment< GEN, threads >::REPEATS, and RandomConcurrent_test::Experiment< GEN, threads >::results.

Referenced by RandomConcurrent_test::investigate_concurrentAccess().

Here is the call graph for this function:

Here is the caller graph for this function:

Member Data Documentation

results

template<typename GEN , uint threads>

deque<tuple<double,uint> > results

Definition at line 117 of file random-concurrent-test.cpp.

Referenced by RandomConcurrent_test::Experiment< GEN, threads >::perform(), and RandomConcurrent_test::Experiment< GEN, threads >::recordRun().

generator

template<typename GEN , uint threads>

GEN generator

Definition at line 127 of file random-concurrent-test.cpp.

Referenced by RandomConcurrent_test::Experiment< GEN, threads >::perform().

N

template<typename GEN , uint threads>

const uint N = NUM_INVOKES

Definition at line 133 of file random-concurrent-test.cpp.

Referenced by RandomConcurrent_test::Experiment< GEN, threads >::perform().

REPEATS

template<typename GEN , uint threads>

const uint REPEATS = NUM_SAMPLES / threads

Definition at line 134 of file random-concurrent-test.cpp.

Referenced by RandomConcurrent_test::Experiment< GEN, threads >::perform().

expect

template<typename GEN , uint threads>

ResVal expect = (GEN::max() - GEN::min()) / 2

Definition at line 136 of file random-concurrent-test.cpp.

Referenced by RandomConcurrent_test::Experiment< GEN, threads >::perform().

percentGlitches

template<typename GEN , uint threads>

double percentGlitches {0.0}

Definition at line 139 of file random-concurrent-test.cpp.

Referenced by RandomConcurrent_test::Experiment< GEN, threads >::perform().

percentTilted

template<typename GEN , uint threads>

double percentTilted {0.0}

Definition at line 140 of file random-concurrent-test.cpp.

Referenced by RandomConcurrent_test::Experiment< GEN, threads >::perform().

isFailure

template<typename GEN , uint threads>

bool isFailure {false}

Definition at line 141 of file random-concurrent-test.cpp.

Referenced by RandomConcurrent_test::Experiment< GEN, threads >::perform().

Inheritance diagram for RandomConcurrent_test::Experiment< GEN, threads >:

Collaboration diagram for RandomConcurrent_test::Experiment< GEN, threads >:

---

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

• random-concurrent-test.cpp