net.sf.sparql.benchmarking.stats
Interface OperationStats

All Known Implementing Classes:
OperationStatsImpl

public interface OperationStats

Interface for classes that store and represent statistics about an operation

Author:
rvesse

Method Summary
 void add(OperationRun run)
          Adds information for the given run to the statistics
 void clear()
          Clears all run statistics
 long getActualAverageRuntime()
          Gets average runtime for the operation over all runs (arithmetic mean) based on the actual runtime
 double getActualOperationsPerHour()
          Calculates how many times this operation could be executed multi-threaded per hour based upon the getActualAverageRuntime()
 double getActualOperationsPerSecond()
          Calculates how many times this operation could be executed multi-threaded per second based upon the getActualAverageRuntime()
 long getActualRuntime()
          Gets the actual runtime for the operation over all runs (takes into account operations that run in parallel)
 long getAverageResponseTime()
          Gets the average response time over all runs (arithmetic mean) based on the total response time
 long getAverageResults()
          Gets the average number of results
 long getAverageRuntime()
          Gets the average runtime for the operation over all runs (arithmetic mean) based on the total runtime
 Map<Integer,List<OperationRun>> getCategorizedErrors()
          Gets the information for all errors grouped by category
 double getGeometricAverageRuntime()
          Gets the average runtime for the operation over all runs (geometric mean) based on the total runtime
 long getMaximumRuntime()
          Gets the maximum runtime for this operation over all runs
 long getMinimumRuntime()
          Gets the minimum runtime for this operation over all runs
 double getOperationsPerHour()
          Calculates how many times this operation could be executed single-threaded per hour based upon the average runtime of the operation
 double getOperationsPerSecond()
          Calculates how many times this operation could be executed single-threaded per second based upon the average runtime of the operation
 long getRunCount()
          Gets the number of runs for the operation
 Iterator<OperationRun> getRuns()
          Gets an iterator over the operation runs
 double getStandardDeviation()
          Gets the standard deviation for operation runtime
 ParallelTimer getTimer()
          Gets the parallel timer used to track actual runtime
 long getTotalErrors()
          Gets the total number of times this operation resulted in an error
 long getTotalResponseTime()
          Gets the total response time for the operations over all runs
 long getTotalResults()
          Gets the total number of results for this operation
 long getTotalRuntime()
          Gets the total runtime for the query over all runs
 double getVariance()
          Gets the variance for the operation runtimes
 void trim(int outliers)
          Trims the best and worst N runs
 

Method Detail

getRuns

Iterator<OperationRun> getRuns()
Gets an iterator over the operation runs

Returns:
Runs of the operation

getRunCount

long getRunCount()
Gets the number of runs for the operation

Returns:
Number of runs

getTotalRuntime

long getTotalRuntime()
Gets the total runtime for the query over all runs

Returns:
Total Runtime in nanoseconds

getActualRuntime

long getActualRuntime()
Gets the actual runtime for the operation over all runs (takes into account operations that run in parallel)

Returns:
Actual Runtime in nanoseconds

getTotalResponseTime

long getTotalResponseTime()
Gets the total response time for the operations over all runs

For non-streaming operations this will likely be equal to getTotalRuntime()

Returns:
Total response time

getAverageRuntime

long getAverageRuntime()
Gets the average runtime for the operation over all runs (arithmetic mean) based on the total runtime

Returns:
Arithmetic Average Runtime in nanoseconds

getAverageResponseTime

long getAverageResponseTime()
Gets the average response time over all runs (arithmetic mean) based on the total response time

For non-streaming operations this will likely be equal to getAverageRuntime()

Returns:
Average Response Time in nanoseconds

getGeometricAverageRuntime

double getGeometricAverageRuntime()
Gets the average runtime for the operation over all runs (geometric mean) based on the total runtime

Returns:
Geometric Average Runtime in nanoseconds

getActualAverageRuntime

long getActualAverageRuntime()
Gets average runtime for the operation over all runs (arithmetic mean) based on the actual runtime

Returns:
Arithmetic Average runtime in nanoseconds

getMinimumRuntime

long getMinimumRuntime()
Gets the minimum runtime for this operation over all runs

Returns:
Minimum Runtime in nanoseconds

getMaximumRuntime

long getMaximumRuntime()
Gets the maximum runtime for this operation over all runs

Returns:
Maximum Runtime in nanoseconds

getVariance

double getVariance()
Gets the variance for the operation runtimes

Returns:
Runtime Variance in nanoseconds

getStandardDeviation

double getStandardDeviation()
Gets the standard deviation for operation runtime

Returns:
Runtime Standard Deviation in nanoseconds

getTotalErrors

long getTotalErrors()
Gets the total number of times this operation resulted in an error

Returns:
Total number of errors

getCategorizedErrors

Map<Integer,List<OperationRun>> getCategorizedErrors()
Gets the information for all errors grouped by category

Returns:
Errors grouped by category

getTotalResults

long getTotalResults()
Gets the total number of results for this operation

Returns:
Total number of results

getAverageResults

long getAverageResults()
Gets the average number of results

Returns:
Average number of results

getOperationsPerSecond

double getOperationsPerSecond()
Calculates how many times this operation could be executed single-threaded per second based upon the average runtime of the operation

Returns:
Operations per Second

getActualOperationsPerSecond

double getActualOperationsPerSecond()
Calculates how many times this operation could be executed multi-threaded per second based upon the getActualAverageRuntime()

Returns:
Actual Operations per Second

getOperationsPerHour

double getOperationsPerHour()
Calculates how many times this operation could be executed single-threaded per hour based upon the average runtime of the operation

Returns:
Operations per Hour

getActualOperationsPerHour

double getActualOperationsPerHour()
Calculates how many times this operation could be executed multi-threaded per hour based upon the getActualAverageRuntime()

Returns:
Actual Operations per Hour

add

void add(OperationRun run)
Adds information for the given run to the statistics

Parameters:
run - Run information

clear

void clear()
Clears all run statistics


trim

void trim(int outliers)
Trims the best and worst N runs

Parameters:
outliers - Number of outliers to trim

getTimer

ParallelTimer getTimer()
Gets the parallel timer used to track actual runtime

Returns:
Parallel timer


Copyright © 2014. All Rights Reserved.