bridges.benchmark.SortingBenchmark Class Reference

Benchmarks sorting algorithm. More...

Inheritance diagram for bridges.benchmark.SortingBenchmark:

Public Member Functions
	SortingBenchmark (LineChart p)
void	setMaxSize (int size)
	Puts a cap on the largest array to be used.
void	setBaseSize (int size)
	Smallest array to be used.
void	setIncrement (int inc)
	Sets the increment for the benchmark size.
void	setGeometric (double base)
	Sets a geometric progression for the benchmark size.
void	linearRange (int baseSize, int maxSize, int nbPoint)
	The benchmark will sample a range with a fixed number of points.
void	geometricRange (int baseSize, int maxSize, double base)
	The benchmark will sample a range using in geometrically increasing sequence.
void	setGenerator (String generatorName)
String	getGenerator ()
void	run (String algoName, Consumer< int[]> runnable)
	benchmark a particular algorithm
Public Member Functions inherited from bridges.benchmark.Benchmark
void	setTimeCap (long cap_in_ms)
	sets an upper bound to the time of a run.
long	getTimeCap ()
	Return time limit of a run.

Additional Inherited Members
Package Functions inherited from bridges.benchmark.Benchmark
	Benchmark (LineChart plot, long timeCap)
	Benchmark (LineChart plot)
Package Attributes inherited from bridges.benchmark.Benchmark
LineChart	plot

Detailed Description

Benchmarks sorting algorithm.

Benchmarks sorting algorithms and add time series to a LineChart.

The benchmark goes from an initial size controlled by setBaseSize() to a largest size controlled by setMaxSize(). One can also set a maximum time spent on a particular run using setTimeCap().

The benchmark goes from a array size of n to the next one of geoBase * n + increment, where the base is controlled by setGeometric() and increment is controlled by setIncrement(). For simpler use one can set a purley linear sampling with linearRange() or a purely geometric one with geometricRange().

The sorting algorithms must have for prototype: static void mysort(int[]); and can be passed to the run function for being benchmarked. A typical use would look something like

LineChart lc;
SortingBenchmark sb (lc);
sb.linearRange (100, 1000, 5);
sb.run("mysortingalgorithm", MyClass.mysort);

Author

Erik Saule

Date

07/20/2019

Constructor & Destructor Documentation

SortingBenchmark()

bridges.benchmark.SortingBenchmark.SortingBenchmark

(

LineChart

p

)

Member Function Documentation

geometricRange()

void bridges.benchmark.SortingBenchmark.geometricRange	(	int	baseSize,
		int	maxSize,
		double	base
	)

The benchmark will sample a range using in geometrically increasing sequence.

The benchmark will sample the range [baseSize; maxSize] using a geometric distribution in base base. That is to say, it will sample baseSize, base*baseSize, base*base*baseSize, ...

Parameters

baseSize	lower bound of the range sampled
maxSize	upper bound of the range sampled
base	base of the geometric increase

getGenerator()

String bridges.benchmark.SortingBenchmark.getGenerator

(

)

linearRange()

void bridges.benchmark.SortingBenchmark.linearRange	(	int	baseSize,
		int	maxSize,
		int	nbPoint
	)

The benchmark will sample a range with a fixed number of points.

The benchmark will sample about nbPoint equally distributed in the range [baseSize; maxSize]

Parameters

baseSize	lower bound of the range sampled
maxSize	upper bound of the range sampled
nbPoint	number of sample

run()

void bridges.benchmark.SortingBenchmark.run	(	String	algoName,
		Consumer< int[]>	runnable
	)

benchmark a particular algorithm

Parameters

algoName	Screen name of the algorithm
runnable	the actual algorithm

setBaseSize()

void bridges.benchmark.SortingBenchmark.setBaseSize

(

int

size

)

Smallest array to be used.

Parameters

size	of the smallest array to use/

setGenerator()

void bridges.benchmark.SortingBenchmark.setGenerator

(

String

generatorName

)

Parameters

generatorName

possible values are "random", "inorder", "reverseorder", "fewdifferentvalues", "almostsorted"

setGeometric()

void bridges.benchmark.SortingBenchmark.setGeometric

(

double

base

)

Sets a geometric progression for the benchmark size.

Parameters

base	new base of the geometric progression

setIncrement()

void bridges.benchmark.SortingBenchmark.setIncrement

(

int

inc

)

Sets the increment for the benchmark size.

Parameters

inc	new value of the increment

setMaxSize()

void bridges.benchmark.SortingBenchmark.setMaxSize

(

int

size

)

Puts a cap on the largest array to be used.

Parameters

size	Maximum size considered

---

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

• /home/erik/work/bridges/bridges-java/src/main/java/bridges/benchmark/SortingBenchmark.java