edu.uoregon.tau.perfexplorer.glue
Class DataSourceResult

Object
  AbstractResult
      DataSourceResult

All Implemented Interfaces:

PerformanceResult, Serializable

public class DataSourceResult
extends AbstractResult

Author:

khuck

See Also:

Serialized Form

Field Summary

static int	CUBE
static int	DYNAPROF
static int	GAMESS
static int	GOOGLE
static int	GPROF
static int	GPTL
static int	GYRO
static int	HPCTOOLKIT
static int	HPM
static int	IPM
static int	MPIP
static int	OMPP
static int	PARAVER
static int	PERIXML
static int	PPK
static int	PPROF
static int	PSRUN
static int	SNAP
static int	TAUPROFILE

Fields inherited from class AbstractResult

CALLS, EXCLUSIVE, INCLUSIVE, SUBROUTINES, USEREVENT_MAX, USEREVENT_MEAN, USEREVENT_MIN, USEREVENT_NUMEVENTS, USEREVENT_SUMSQR

Constructor Summary

DataSourceResult(int fileType, String[] sourceFiles, boolean fixNames)

Method Summary

double	getCalls(Integer thread, String event) This method will return the number of times that the specified event was called on the specified thread of execution.
double	getExclusive(Integer thread, String event, String metric) This method will return the exclusive value stored in the trial for the selected thread, event, metric combination.
double	getInclusive(Integer thread, String event, String metric) This method will return the inclusive value stored in the trial for the selected thread, event, metric combination.
String	getMainEvent() This method will return the name of the event which has the highest inclusive time value in the trial.
Integer	getOriginalThreads() This method will return the number of threads in the trial from which this data was derived.
double	getSubroutines(Integer thread, String event) This method will return the number of subroutines that the specified event had on the specified thread of execution.
Trial	getTrial() This method returns the Trial to which the performance data is related.
Integer	getTrialID() This method returns the ID of the Trial to which the performance data is related.
double	getUsereventMax(Integer thread, String event) This method will return the maximum value for the specified user event which was observed on the specified thread of execution.
double	getUsereventMean(Integer thread, String event) This method will return the mean value for the specified user event which was observed on the specified thread of execution.
double	getUsereventMin(Integer thread, String event) This method will return the minimum value for the specified user event which was observed on the specified thread of execution.
double	getUsereventNumevents(Integer thread, String event) This method will return the number of times that a specified user event happened on the specified thread of execution.
Set<String>	getUserEvents(Integer thread) This method will return a Set of Strings, which represent the names of the userevents for the specified thread in the trial.
double	getUsereventSumsqr(Integer thread, String event) This method will return the sum of squared values for the specified user event which was observed on the specified thread of execution.
void	putCalls(Integer thread, String event, double value) This method will save the specified value as the number of calls for the specified event on the specified thread of execution.
void	putDataPoint(Integer thread, String event, String metric, int type, double value) This method will store the specified value in the trial for the specified thread, event, metric, type combination.
void	putExclusive(Integer thread, String event, String metric, double value) This method will save the specified value as the exclusive value for the specified thread, event, metric combination.
void	putInclusive(Integer thread, String event, String metric, double value) This method will save the specified value as the inclusive value for the specified thread, event, metric combination.
void	putSubroutines(Integer thread, String event, double value) This method will save the specified value as the number of subroutines for the specified event on the specified thread of execution.
void	putUsereventMax(Integer thread, String event, double value) This method will save the maximum value for a specified user event which was observed on the specified thread of execution.
void	putUsereventMean(Integer thread, String event, double value) This method will save the mean value for a specified user event which was observed on the specified thread of execution.
void	putUsereventMin(Integer thread, String event, double value) This method will save the minimum value for a specified user event which was observed on the specified thread of execution.
void	putUsereventNumevents(Integer thread, String event, double value) This method will save the number of times that a specified user event happened on the specified thread of execution.
void	putUsereventSumsqr(Integer thread, String event, double value) This method will save the sum of squared values for the specified user event which was observed on the specified thread of execution.

Methods inherited from class AbstractResult

getDataPoint, getDataSource, getEventMap, getEvents, getFPMetric, getL1AccessMetric, getL1MissMetric, getL2AccessMetric, getL2MissMetric, getL3AccessMetric, getL3MissMetric, getMainInclusive, getMetrics, getName, getSortedByValue, getThreads, getTimeMetric, getTLBMissMetric, getTotalInstructionMetric, getTypes, getTypes, getUserEvents, setEventMap, setIgnoreWarnings, setMainInclusive, setName, setOriginalThreads, setTrial, setTrialID, toString, typeToString, updateEventMap

Methods inherited from class Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

CUBE

public static final int CUBE

See Also:

Constant Field Values

DYNAPROF

public static final int DYNAPROF

See Also:

Constant Field Values

GAMESS

public static final int GAMESS

See Also:

Constant Field Values

GOOGLE

public static final int GOOGLE

See Also:

Constant Field Values

GPROF

public static final int GPROF

See Also:

Constant Field Values

GPTL

public static final int GPTL

See Also:

Constant Field Values

GYRO

public static final int GYRO

See Also:

Constant Field Values

HPCTOOLKIT

public static final int HPCTOOLKIT

See Also:

Constant Field Values

HPM

public static final int HPM

See Also:

Constant Field Values

IPM

public static final int IPM

See Also:

Constant Field Values

MPIP

public static final int MPIP

See Also:

Constant Field Values

OMPP

public static final int OMPP

See Also:

Constant Field Values

PARAVER

public static final int PARAVER

See Also:

Constant Field Values

PERIXML

public static final int PERIXML

See Also:

Constant Field Values

PPK

public static final int PPK

See Also:

Constant Field Values

PPROF

public static final int PPROF

See Also:

Constant Field Values

PSRUN

public static final int PSRUN

See Also:

Constant Field Values

SNAP

public static final int SNAP

See Also:

Constant Field Values

TAUPROFILE

public static final int TAUPROFILE

See Also:

Constant Field Values

Constructor Detail

DataSourceResult

public DataSourceResult(int fileType,
                        String[] sourceFiles,
                        boolean fixNames)

Method Detail

getCalls

public double getCalls(Integer thread,
                       String event)

Description copied from interface: PerformanceResult

This method will return the number of times that the specified event was called on the specified thread of execution.

Specified by:

getCalls in interface PerformanceResult

Overrides:

getCalls in class AbstractResult

Parameters:

thread - The thread of interest

event - The event of interest

Returns:

the number of calls

getExclusive

public double getExclusive(Integer thread,
                           String event,
                           String metric)

Description copied from interface: PerformanceResult

This method will return the exclusive value stored in the trial for the selected thread, event, metric combination.

Specified by:

getExclusive in interface PerformanceResult

Overrides:

getExclusive in class AbstractResult

Parameters:

thread - The thread of interest

event - The event of interest

metric - The metric of interest

Returns:

the exclusive value

getInclusive

public double getInclusive(Integer thread,
                           String event,
                           String metric)

Description copied from interface: PerformanceResult

This method will return the inclusive value stored in the trial for the selected thread, event, metric combination.

Specified by:

getInclusive in interface PerformanceResult

Overrides:

getInclusive in class AbstractResult

Parameters:

thread - The thread of interest

event - The event of interest

metric - The metric of interest

Returns:

the inclusive value

getMainEvent

public String getMainEvent()

Description copied from interface: PerformanceResult

This method will return the name of the event which has the highest inclusive time value in the trial.

Specified by:

getMainEvent in interface PerformanceResult

Overrides:

getMainEvent in class AbstractResult

Returns:

the name of the main event

getOriginalThreads

public Integer getOriginalThreads()

Description copied from interface: PerformanceResult

This method will return the number of threads in the trial from which this data was derived.

Specified by:

getOriginalThreads in interface PerformanceResult

Overrides:

getOriginalThreads in class AbstractResult

Returns:

the originalThreads

getSubroutines

public double getSubroutines(Integer thread,
                             String event)

Description copied from interface: PerformanceResult

This method will return the number of subroutines that the specified event had on the specified thread of execution.

Specified by:

getSubroutines in interface PerformanceResult

Overrides:

getSubroutines in class AbstractResult

Parameters:

thread - The thread of interest

event - The event of interest

Returns:

the number of subroutines

getTrial

public Trial getTrial()

Description copied from interface: PerformanceResult

This method returns the Trial to which the performance data is related.

Specified by:

getTrial in interface PerformanceResult

Overrides:

getTrial in class AbstractResult

Returns:

the Trial

getTrialID

public Integer getTrialID()

Description copied from interface: PerformanceResult

This method returns the ID of the Trial to which the performance data is related.

Specified by:

getTrialID in interface PerformanceResult

Overrides:

getTrialID in class AbstractResult

Returns:

the trial's ID

getUsereventMax

public double getUsereventMax(Integer thread,
                              String event)

Description copied from interface: PerformanceResult

This method will return the maximum value for the specified user event which was observed on the specified thread of execution.

Specified by:

getUsereventMax in interface PerformanceResult

Overrides:

getUsereventMax in class AbstractResult

Parameters:

thread - The thread of interest

event - The event of interest

Returns:

the maximum value

getUsereventMean

public double getUsereventMean(Integer thread,
                               String event)

Description copied from interface: PerformanceResult

This method will return the mean value for the specified user event which was observed on the specified thread of execution.

Specified by:

getUsereventMean in interface PerformanceResult

Overrides:

getUsereventMean in class AbstractResult

Parameters:

thread - The thread of interest

event - The event of interest

Returns:

the mean value

getUsereventMin

public double getUsereventMin(Integer thread,
                              String event)

Description copied from interface: PerformanceResult

This method will return the minimum value for the specified user event which was observed on the specified thread of execution.

Specified by:

getUsereventMin in interface PerformanceResult

Overrides:

getUsereventMin in class AbstractResult

Parameters:

thread - The thread of interest

event - The event of interest

Returns:

the minimum value

getUsereventNumevents

public double getUsereventNumevents(Integer thread,
                                    String event)

Description copied from interface: PerformanceResult

This method will return the number of times that a specified user event happened on the specified thread of execution.

Specified by:

getUsereventNumevents in interface PerformanceResult

Overrides:

getUsereventNumevents in class AbstractResult

Parameters:

thread - The thread of interest

event - The event of interest

Returns:

the number of events

getUserEvents

public Set<String> getUserEvents(Integer thread)

Description copied from interface: PerformanceResult

This method will return a Set of Strings, which represent the names of the userevents for the specified thread in the trial.

Specified by:

getUserEvents in interface PerformanceResult

Overrides:

getUserEvents in class AbstractResult

Returns:

the set of userevent names

getUsereventSumsqr

public double getUsereventSumsqr(Integer thread,
                                 String event)

Description copied from interface: PerformanceResult

This method will return the sum of squared values for the specified user event which was observed on the specified thread of execution.

Specified by:

getUsereventSumsqr in interface PerformanceResult

Overrides:

getUsereventSumsqr in class AbstractResult

Parameters:

thread - The thread of interest

event - The event of interest

Returns:

the sum of squared values

putCalls

public void putCalls(Integer thread,
                     String event,
                     double value)

Description copied from interface: PerformanceResult

This method will save the specified value as the number of calls for the specified event on the specified thread of execution.

Specified by:

putCalls in interface PerformanceResult

Overrides:

putCalls in class AbstractResult

Parameters:

thread - The thread of interest

event - The event of interest

value - The value measured on that thread, event combination

putDataPoint

public void putDataPoint(Integer thread,
                         String event,
                         String metric,
                         int type,
                         double value)

Description copied from interface: PerformanceResult

This method will store the specified value in the trial for the specified thread, event, metric, type combination.

Specified by:

putDataPoint in interface PerformanceResult

Overrides:

putDataPoint in class AbstractResult

Parameters:

thread - The thread of interest

event - The event of interest

metric - The metric of interest

type - The type of data to return

value - The value The value of that type measured on that thread, event, metric combination

See Also:

PerformanceResult.putExclusive(java.lang.Integer, java.lang.String, java.lang.String, double), PerformanceResult.putInclusive(java.lang.Integer, java.lang.String, java.lang.String, double), PerformanceResult.putCalls(java.lang.Integer, java.lang.String, double), PerformanceResult.putSubroutines(java.lang.Integer, java.lang.String, double), AbstractResult.INCLUSIVE, AbstractResult.EXCLUSIVE, AbstractResult.CALLS, AbstractResult.SUBROUTINES, AbstractResult.USEREVENT_NUMEVENTS, AbstractResult.USEREVENT_MAX, AbstractResult.USEREVENT_MIN, AbstractResult.USEREVENT_MEAN, AbstractResult.USEREVENT_SUMSQR

putExclusive

public void putExclusive(Integer thread,
                         String event,
                         String metric,
                         double value)

Description copied from interface: PerformanceResult

This method will save the specified value as the exclusive value for the specified thread, event, metric combination.

Specified by:

putExclusive in interface PerformanceResult

Overrides:

putExclusive in class AbstractResult

Parameters:

thread - The thread of interest

event - The event of interest

metric - The metric of interest

value - The value measured on that thread, event, metric combination

putInclusive

public void putInclusive(Integer thread,
                         String event,
                         String metric,
                         double value)

Description copied from interface: PerformanceResult

This method will save the specified value as the inclusive value for the specified thread, event, metric combination.

Specified by:

putInclusive in interface PerformanceResult

Overrides:

putInclusive in class AbstractResult

Parameters:

thread - The thread of interest

event - The event of interest

metric - The metric of interest

value - The value measured on that thread, event, metric combination

putSubroutines

public void putSubroutines(Integer thread,
                           String event,
                           double value)

Description copied from interface: PerformanceResult

This method will save the specified value as the number of subroutines for the specified event on the specified thread of execution.

Specified by:

putSubroutines in interface PerformanceResult

Overrides:

putSubroutines in class AbstractResult

Parameters:

thread - The thread of interest

event - The event of interest

value - The value measured on that thread, event combination

putUsereventMax

public void putUsereventMax(Integer thread,
                            String event,
                            double value)

Description copied from interface: PerformanceResult

This method will save the maximum value for a specified user event which was observed on the specified thread of execution.

Specified by:

putUsereventMax in interface PerformanceResult

Overrides:

putUsereventMax in class AbstractResult

Parameters:

thread - The thread of interest

event - The event of interest

value - The maximum value

putUsereventMean

public void putUsereventMean(Integer thread,
                             String event,
                             double value)

Description copied from interface: PerformanceResult

This method will save the mean value for a specified user event which was observed on the specified thread of execution.

Specified by:

putUsereventMean in interface PerformanceResult

Overrides:

putUsereventMean in class AbstractResult

Parameters:

thread - The thread of interest

event - The event of interest

value - The mean value

putUsereventMin

public void putUsereventMin(Integer thread,
                            String event,
                            double value)

Description copied from interface: PerformanceResult

This method will save the minimum value for a specified user event which was observed on the specified thread of execution.

Specified by:

putUsereventMin in interface PerformanceResult

Overrides:

putUsereventMin in class AbstractResult

Parameters:

thread - The thread of interest

event - The event of interest

value - The minimum value

putUsereventNumevents

public void putUsereventNumevents(Integer thread,
                                  String event,
                                  double value)

Description copied from interface: PerformanceResult

This method will save the number of times that a specified user event happened on the specified thread of execution.

Specified by:

putUsereventNumevents in interface PerformanceResult

Overrides:

putUsereventNumevents in class AbstractResult

Parameters:

thread - The thread of interest

event - The event of interest

value - The number of events

putUsereventSumsqr

public void putUsereventSumsqr(Integer thread,
                               String event,
                               double value)

Description copied from interface: PerformanceResult

This method will save the sum of squared values for the specified user event which was observed on the specified thread of execution.

Specified by:

putUsereventSumsqr in interface PerformanceResult

Overrides:

putUsereventSumsqr in class AbstractResult

Parameters:

thread - The thread of interest

event - The event of interest

value - The sum of squared values