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

Class SimuComAnalysis

java.lang.Object

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

de.uka.ipd.sdq.dsexplore.analysis.simucom.SimuComAnalysis

All Implemented Interfaces:

IAnalysis

public class SimuComAnalysis
extends AbstractAnalysis
implements IAnalysis

Starts a SimuCom Analysis for the design space exploration.

Field Summary

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

blackboard, criteriaList, criterionToAspect, qualityAttribute

Constructor Summary

Constructors

Constructor	Description
SimuComAnalysis()

Method Summary

Modifier and Type	Method	Description
void	analyse(PCMPhenotype pheno, IProgressMonitor monitor)	Calls SimuCom.
DSEConstantsContainer.QualityAttribute	getQualityAttribute()	Returns a String that represents the quality attribute that this analysis determines.
boolean	hasObjectivePerUsageScenario()	Returns whether this analysis provides one objective per usage scenario.
boolean	hasStatisticResultsFor()	Returns whether this analysis also provides statistics for the objectives.
void	initialise(DSEWorkflowConfiguration configuration)	Saves the passed Run Configuration information so that we do not have to pass them as parameters all the time.
IStatisticAnalysisResult	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, getCriterions, getPCMInstance, 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

getCriterions

Constructor Detail

SimuComAnalysis

public SimuComAnalysis()

Method Detail

analyse

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

Calls SimuCom. Before doing so, it calls the ConfigurationHelper to update the ILaunchConfiguration and stores the PCMInstance to files, so that SimuCom can read it as usual. After the SimuCom run, the analysis results are extracted from the sensorFramework data sources and returned. The returned IAnalysisResult is a SimuComAnalysisResult which does not store the results directly, but provides access to the underlying sensorFramework data sources. 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:

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

AnalysisFailedException

CoreException

See Also:

de.uka.ipd.sdq.dsexplore.analysis.IAnalysis#analyse(PCMPhenotype, de.uka.ipd.sdq.dsexplore.PCMInstance)

initialise

public void initialise(DSEWorkflowConfiguration configuration)
                throws CoreException

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

See Also:

de.uka.ipd.sdq.dsexplore.analysis.IAnalysis#initialise(org.eclipse.debug.core.ILaunchConfiguration, java.lang.String, org.eclipse.debug.core.ILaunch, org.eclipse.core.runtime.IProgressMonitor)

retrieveResultsFor

public IStatisticAnalysisResult 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

getQualityAttribute

public DSEConstantsContainer.QualityAttribute getQualityAttribute()
                                                           throws CoreException

Description copied from interface: IAnalysis

Returns a String that represents the quality attribute that this analysis determines. This method can be called without initialization.

Specified by:

getQualityAttribute in interface IAnalysis

Overrides:

getQualityAttribute in class AbstractAnalysis

Returns:

Throws:

CoreException

hasStatisticResultsFor

public boolean hasStatisticResultsFor()
                               throws CoreException

Description copied from interface: IAnalysis

Returns whether this analysis also provides statistics for the objectives. This method can be called without initialization.

Specified by:

hasStatisticResultsFor in interface IAnalysis

Overrides:

hasStatisticResultsFor in class AbstractAnalysis

Returns:

Throws:

CoreException

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