Package de.uka.ipd.sdq.dsexplore.analysis.featurecompletions

Class FeatureEvaluator

java.lang.Object

de.uka.ipd.sdq.dsexplore.analysis.AbstractAnalysis

de.uka.ipd.sdq.dsexplore.analysis.featurecompletions.FeatureEvaluator

All Implemented Interfaces:

IAnalysis

public class FeatureEvaluator
extends AbstractAnalysis
implements IAnalysis

Field Summary

Fields inherited from class de.uka.ipd.sdq.dsexplore.analysis.AbstractAnalysis

blackboard, criteriaList, criterionToAspect, qualityAttribute

Constructor Summary

Constructors

Constructor	Description
FeatureEvaluator()

Method Summary

Modifier and Type	Method	Description
void	analyse(PCMPhenotype pheno, IProgressMonitor monitor)	Analyses the current PCM instance from the blackboard.
List<org.opt4j.core.Criterion>	getCriterions()	Can only be called after initialisation (#initialise(MDSDBlackboard, ILaunchConfiguration, ILaunch, IProgressMonitor)).
boolean	hasObjectivePerUsageScenario()	Returns whether this analysis provides one objective per usage scenario.
void	initialise(DSEWorkflowConfiguration configuration)	Saves the passed Run Configuration information so that we do not have to pass them as parameters all the time.
IAnalysisResult	retrieveResultsFor(PCMPhenotype pheno, org.opt4j.core.Criterion criterion)	This method can only be called after calling a #analyse() for this phenotype and the current PCM models of this candidate have to be in the Blackboard partition LoadPCMModelsIntoBlackboardJob.PCM_MODELS_PARTITION_ID FIXME: Make this method independent of the blackboard state.
void	setBlackboard(de.uka.ipd.sdq.workflow.mdsd.blackboard.MDSDBlackboard blackboard)

Methods inherited from class de.uka.ipd.sdq.dsexplore.analysis.AbstractAnalysis

canEvaluateAspect, getPCMInstance, getQualityAttribute, hasStatisticResultsFor, initialiseCriteria

Methods inherited from class java.lang.Object

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

Methods inherited from interface de.uka.ipd.sdq.dsexplore.analysis.IAnalysis

getQualityAttribute, hasStatisticResultsFor

Constructor Detail

FeatureEvaluator

public FeatureEvaluator()

Method Detail

analyse

public void analyse(PCMPhenotype pheno,
                    IProgressMonitor monitor)
             throws CoreException,
                    de.uka.ipd.sdq.workflow.jobs.UserCanceledException,
                    de.uka.ipd.sdq.workflow.jobs.JobFailedException,
                    AnalysisFailedException

Description copied from interface: IAnalysis

Analyses the current PCM instance from the blackboard. This method can only be called after calling #initialise(MDSDBlackboard, ILaunchConfiguration, ILaunch). The PCM instance for this PCMPhenotype has to be copied to the Blackboard into partition LoadPCMModelsIntoBlackboardJob.PCM_MODELS_PARTITION_ID before callings this. Otherwise, a wrong PCM model is analysed. The Analysis has to store the results for this PCMPhenotype, so that IAnalysis.retrieveResultsFor(PCMPhenotype, Criterion) can be called on it multiple times. The results should be stored in a memory-efficient way.

Specified by:

analyse in interface IAnalysis

Parameters:

pheno - TODO

Throws:

CoreException

de.uka.ipd.sdq.workflow.jobs.UserCanceledException

de.uka.ipd.sdq.workflow.jobs.JobFailedException

AnalysisFailedException

initialise

public void initialise(DSEWorkflowConfiguration configuration)
                throws CoreException

Description copied from interface: IAnalysis

Saves the passed Run Configuration information so that we do not have to pass them as parameters all the time. For real analyses, you need to call setBlackboard before this so that the objectives can be determined from the usage model. For the AnalysisProxy it is ok to call this first, you then need to call setBlackboard before calling IAnalysis.analyse(PCMPhenotype, IProgressMonitor), #retrieveLastResultsForObjective(Objective), #getObjectives(), or IAnalysis.hasObjectivePerUsageScenario().

Specified by:

initialise in interface IAnalysis

Throws:

CoreException

getCriterions

public List<org.opt4j.core.Criterion> getCriterions()
                                             throws CoreException

Description copied from interface: IAnalysis

Can only be called after initialisation (#initialise(MDSDBlackboard, ILaunchConfiguration, ILaunch, IProgressMonitor)).

Specified by:

getCriterions in interface IAnalysis

Overrides:

getCriterions in class AbstractAnalysis

Returns:

Throws:

CoreException

retrieveResultsFor

public IAnalysisResult retrieveResultsFor(PCMPhenotype pheno,
                                          org.opt4j.core.Criterion criterion)
                                   throws CoreException,
                                          AnalysisFailedException

Description copied from interface: IAnalysis

This method can only be called after calling a #analyse() for this phenotype and the current PCM models of this candidate have to be in the Blackboard partition LoadPCMModelsIntoBlackboardJob.PCM_MODELS_PARTITION_ID FIXME: Make this method independent of the blackboard state. Currently, the SimuComAnalysis and the LQN analyses still require the current PCM model to be on the blackboard.

Specified by:

retrieveResultsFor in interface IAnalysis

Parameters:

pheno - TODO

Returns:

Throws:

CoreException

AnalysisFailedException

hasObjectivePerUsageScenario

public boolean hasObjectivePerUsageScenario()
                                     throws CoreException

Description copied from interface: IAnalysis

Returns whether this analysis provides one objective per usage scenario. This method can be called before calling #initialise(MDSDBlackboard, ILaunchConfiguration, ILaunch, IProgressMonitor).

Specified by:

hasObjectivePerUsageScenario in interface IAnalysis

Throws:

CoreException

setBlackboard

public void setBlackboard(de.uka.ipd.sdq.workflow.mdsd.blackboard.MDSDBlackboard blackboard)

Specified by:

setBlackboard in interface IAnalysis