com.singularsys.jepexamples.diagnostics

Class ThreadSpeedTest

java.lang.Object

com.singularsys.jepexamples.diagnostics.ThreadSpeedTest

Direct Known Subclasses:

RpThreadSpeed, ThreadSafeSpeedTest

public class ThreadSpeedTest
extends java.lang.Object

Tests evaluation using multiple threads. Subclasses can override methods to change how threads are constructed.

Author:

Richard Morris

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ThreadSpeedTest.EvaluationThread A thread which evaluates an expression multiple times.

Field Summary

Fields

Modifier and Type	Field and Description
protected Node	base Parsed expression
protected Jep	baseJep Base Jep instance
static int	MAX_LOOPS Number of loops to run
static int	MAX_THREADS Maximum number of threads to test.
static int	N_TERMS Number of terms in the expressions
static int	TOTAL_ITTS Total number of iterations for each step
protected java.lang.String	varName Name of variable

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	ThreadSpeedTest() Do nothing constructor for use by subclasses
	ThreadSpeedTest(java.lang.String expression, java.lang.String varName)

Method Summary

Modifier and Type	Method and Description
void	analyize() Prints some basic info about the expression
static java.lang.String	getExpression(int nTerms) Gets a expression to evaluate using an approximation to log "x^1/1-x^2/2+x^3/3-..."
int	go(int nThreads, int nItts, double minValue, double maxValue) Create and run threads.
void	loop(int maxThreads, int totalItts, int nLoops) Repeatedly execute threads.
static void	main(java.lang.String[] args) Run the thread test program.
java.lang.Thread	makeThread(int index, double min, double max, int nItts) Make a thread to evaluate an expression multiple times.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

N_TERMS

public static final int N_TERMS

Number of terms in the expressions

See Also:

Constant Field Values

MAX_LOOPS

public static final int MAX_LOOPS

Number of loops to run

See Also:

Constant Field Values

TOTAL_ITTS

public static final int TOTAL_ITTS

Total number of iterations for each step

See Also:

Constant Field Values

MAX_THREADS

public static final int MAX_THREADS

Maximum number of threads to test.

See Also:

Constant Field Values

baseJep

protected Jep baseJep

Base Jep instance

base

protected Node base

Parsed expression

varName

protected java.lang.String varName

Name of variable

Constructor Detail

ThreadSpeedTest

protected ThreadSpeedTest()

Do nothing constructor for use by subclasses

ThreadSpeedTest

public ThreadSpeedTest(java.lang.String expression,
                       java.lang.String varName)
                throws ParseException

Parameters:

expression - the expression

varName - name of the variable

Throws:

ParseException

Method Detail

go

public int go(int nThreads,
              int nItts,
              double minValue,
              double maxValue)
       throws JepException

Create and run threads. Calls makeThread to construct threads, then runs the threads simultaneously and calculated total time of execution.

Parameters:

nThreads - number of threads to run

nItts - number of iterations per thread

minValue - minimum variable value

maxValue - maximum variable value

Returns:

time taken to evaluate, does not include construction time

Throws:

JepException

makeThread

public java.lang.Thread makeThread(int index,
                                   double min,
                                   double max,
                                   int nItts)
                            throws JepException

Make a thread to evaluate an expression multiple times. Can be overridden to change how threads are created. This version uses ThreadSpeedTest.EvaluationThread

Parameters:

index - the number of this thread

min - minimum value for variable

max - maximum value for variable

nItts - number of iterations

Returns:

the thread

Throws:

JepException

loop

public void loop(int maxThreads,
                 int totalItts,
                 int nLoops)

Repeatedly execute threads. First run with 1 thread, then with 2 thread and so on upto maxThreads threads. The total iterations are divided among threads. Repeats the whole process nLoops times. Time statistics are gathered from all but the first loop and summary statistics printed on completion.

Parameters:

maxThreads -

totalItts -

nLoops - number of times

analyize

public void analyize()

Prints some basic info about the expression

getExpression

public static java.lang.String getExpression(int nTerms)

Gets a expression to evaluate using an approximation to log "x^1/1-x^2/2+x^3/3-..."

Parameters:

nTerms - number of terms

Returns:

a string with the expression

main

public static void main(java.lang.String[] args)

Run the thread test program.

Parameters:

args - If specified args[0] is maximum number of threads, args[1] is total number of iterations