org.eclipse.test.internal.performance.results
Class ConfigResults

java.lang.Object
  org.eclipse.test.internal.performance.results.AbstractResults
      org.eclipse.test.internal.performance.results.ConfigResults

All Implemented Interfaces:

java.lang.Comparable

public class ConfigResults
extends AbstractResults

Class to handle results for an Eclipse performance test box (called a configuration). It gives access to results for each build on which this configuration has been run.

See Also:

BuildResults

Field Summary

Fields inherited from class org.eclipse.test.internal.performance.results.AbstractResults

BOXES, CONFIGS, DEFAULT_DIM, SUPPORTED_DIMS, VERSION, VERSION_REF

Constructor Summary

ConfigResults(AbstractResults parent, int id)

Method Summary

java.lang.String	getBaselineBuildName() Returns the baseline build name used to compare results with.
BuildResults	getBaselineBuildResults() Returns the most recent baseline build results.
BuildResults	getBaselineBuildResults(java.lang.String buildName) Return the baseline build results run just before the given build name.
double	getBaselineBuildValue() Returns the most recent baseline build result value.
BuildResults	getBuildResults(java.lang.String buildName) Return the results for the given build name.
java.util.List	getBuilds(java.lang.String buildPattern) Returns the build results matching a given pattern.
java.util.List	getBuildsMatchingPrefixes(java.util.List prefixes) Returns a list of build results which names starts with one of the given prefixes.
double[]	getCurrentBuildDeltaInfo() Return the deviation value and its associated standard error for the default dimension (currently InternalDimensions.ELAPSED_PROCESS).
double	getCurrentBuildError() Returns the error of the current build results
java.lang.String	getCurrentBuildName() Returns the current build name.
BuildResults	getCurrentBuildResults() Returns the current build results.
double	getCurrentBuildValue() Returns the current build result value.
double	getDelta() Returns the delta between current and baseline builds results.
java.lang.String	getDescription() Returns the configuration description (currently the box name).
double	getError() Returns the standard error of the delta between current and baseline builds results.
double[]	getStatistics(java.util.List prefixes) Get all dimension builds default dimension statistics for a given list of build prefixes.
double[]	getStatistics(java.util.List prefixes, int dim_id) Get all dimension builds statistics for a given list of build prefixes and a given dimension.
boolean	isBaselined() Returns whether the configuration has results for the performance baseline build or not.
boolean	isValid() Returns whether the configuration has results for the performance current build or not.
java.util.List	lastNightlyBuildNames(int n) Returns the 'n' last nightly build names.

Methods inherited from class org.eclipse.test.internal.performance.results.AbstractResults

compareTo, copyFile, equals, getBuildDate, getBuildDate, getChildren, getName, getParent, getResults, hashCode, size, timeChrono, timeEnd, timeString, toString

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

ConfigResults

public ConfigResults(AbstractResults parent,
                     int id)

Method Detail

getBaselineBuildName

public java.lang.String getBaselineBuildName()

Returns the baseline build name used to compare results with.

Returns:

The name of the baseline build

See Also:

getBaselineBuildResults()

getBaselineBuildResults

public BuildResults getBaselineBuildResults()

Returns the most recent baseline build results.

Returns:

The baseline build results.

See Also:

BuildResults

getBaselineBuildResults

public BuildResults getBaselineBuildResults(java.lang.String buildName)

Return the baseline build results run just before the given build name.

Parameters:

buildName - The build name

Returns:

The baseline results preceeding the given build name or null if none was found.

getBaselineBuildValue

public double getBaselineBuildValue()

Returns the most recent baseline build result value.

Returns:

The value of the most recent baseline build results.

getDescription

public java.lang.String getDescription()

Returns the configuration description (currently the box name).

Returns:

The configuration description (currently the box name).

getBuildResults

public BuildResults getBuildResults(java.lang.String buildName)

Return the results for the given build name.

Parameters:

buildName - The build name

Returns:

The results for the given build name or null if none was found.

getBuilds

public java.util.List getBuilds(java.lang.String buildPattern)

Returns the build results matching a given pattern.

Parameters:

buildPattern - The pattern of searched builds

Returns:

The list of the builds which names match the given pattern. The list is ordered by build results date.

getBuildsMatchingPrefixes

public java.util.List getBuildsMatchingPrefixes(java.util.List prefixes)

Returns a list of build results which names starts with one of the given prefixes.

Parameters:

prefixes - List of expected prefixes

Returns:

A list of builds which names start with one of the given patterns.

getCurrentBuildDeltaInfo

public double[] getCurrentBuildDeltaInfo()

Return the deviation value and its associated standard error for the default dimension (currently InternalDimensions.ELAPSED_PROCESS).

Returns:

an array of double. First number is the deviation itself and the second is the standard error.

getCurrentBuildError

public double getCurrentBuildError()

Returns the error of the current build results

Returns:

the error made during the current build measure

getCurrentBuildName

public java.lang.String getCurrentBuildName()

Returns the current build name.

Returns:

The name of the current build

See Also:

getCurrentBuildResults()

getCurrentBuildResults

public BuildResults getCurrentBuildResults()

Returns the current build results.

This build is currently the last integration or nightly build which has performance results in the database. It may differ from the PerformanceResults.getName().

Returns:

The current build results.

See Also:

BuildResults

getCurrentBuildValue

public double getCurrentBuildValue()

Returns the current build result value.

Returns:

The value of the current build results.

getDelta

public double getDelta()

Returns the delta between current and baseline builds results.

Returns:

the delta

getError

public double getError()

Returns the standard error of the delta between current and baseline builds results.

Returns:

the delta

See Also:

getDelta()

getStatistics

public double[] getStatistics(java.util.List prefixes)

Get all dimension builds default dimension statistics for a given list of build prefixes.

Parameters:

prefixes - List of prefixes to filter builds. If null then all the builds are taken to compute statistics.

Returns:

An array of double built as follows: - 0: numbers of values - 1: mean of values - 2: standard deviation of these values - 3: coefficient of variation of these values

getStatistics

public double[] getStatistics(java.util.List prefixes,
                              int dim_id)

Get all dimension builds statistics for a given list of build prefixes and a given dimension.

Parameters:

prefixes - List of prefixes to filter builds. If null then all the builds are taken to compute statistics.

dim_id - The id of the dimension on which the statistics must be computed

Returns:

An array of double built as follows: - 0: numbers of values - 1: mean of values - 2: standard deviation of these values - 3: coefficient of variation of these values

isBaselined

public boolean isBaselined()

Returns whether the configuration has results for the performance baseline build or not.

Returns:

true if the configuration has results for the performance baseline build, false otherwise.

isValid

public boolean isValid()

Returns whether the configuration has results for the performance current build or not.

Returns:

true if the configuration has results for the performance current build, false otherwise.

lastNightlyBuildNames

public java.util.List lastNightlyBuildNames(int n)

Returns the 'n' last nightly build names.

Parameters:

n - Number of last nightly builds to return

Returns:

Last n nightly build names preceding current.