org.dllearner.algorithms.qtl

Class QTL2DisjunctiveMultiThreaded

java.lang.Object

org.dllearner.core.AbstractComponent

org.dllearner.core.AbstractCELA

org.dllearner.algorithms.qtl.QTL2DisjunctiveMultiThreaded

All Implemented Interfaces:

Cloneable, ClassExpressionLearningAlgorithm, Component, LearningAlgorithm, StoppableLearningAlgorithm

public class QTL2DisjunctiveMultiThreaded
extends AbstractCELA
implements Cloneable

A tree-based algorithm ... \todo add explanation

Field Summary

Fields inherited from class org.dllearner.core.AbstractCELA

MAX_NR_OF_RESULTS

Constructor Summary

Constructors

Constructor and Description
QTL2DisjunctiveMultiThreaded()
QTL2DisjunctiveMultiThreaded(PosNegLP learningProblem, AbstractReasonerComponent reasoner)
QTL2DisjunctiveMultiThreaded(PosNegLP lp, org.aksw.jena_sparql_api.core.QueryExecutionFactory qef)
QTL2DisjunctiveMultiThreaded(PosNegLP lp, SparqlEndpointKS ks)
QTL2DisjunctiveMultiThreaded(QTL2DisjunctiveMultiThreaded qtl) Copy constructor.

Method Summary

Modifier and Type	Method and Description
Object	clone()
EvaluatedRDFResourceTree	getBestSolution()
org.semanticweb.owlapi.model.OWLClassExpression	getCurrentlyBestDescription()
EvaluatedDescription	getCurrentlyBestEvaluatedDescription() Returns the best descriptions obtained so far.
QueryTreeHeuristic	getHeuristic()
SortedSet<EvaluatedRDFResourceTree>	getSolutions()
List<EvaluatedRDFResourceTree>	getSolutionsAsList()
long	getTimeBestSolutionFound()
void	init() Method to be called after the component has been configured.
boolean	isRunning() Returns whether the learning algorithm is running.
void	setBeta(double beta) Default value is 1.
void	setEntailment(Entailment entailment)
void	setHeuristic(QueryTreeHeuristic heuristic)
void	setKs(SparqlEndpointKS ks)
void	setMaxTreeComputationTimeInSeconds(double maxTreeComputationTimeInSeconds) Set the max.
void	setMaxTreeDepth(int maxTreeDepth)
void	setNegativeExampleTrees(Map<org.semanticweb.owlapi.model.OWLIndividual,RDFResourceTree> negativeExampleTrees)
void	setNoise(double noise)
void	setNoisePercentage(double noisePercentage)
void	setNrOfThreads(int nrOfThreads)
void	setPositiveExampleTrees(Map<org.semanticweb.owlapi.model.OWLIndividual,RDFResourceTree> positiveExampleTrees)
void	setReasoner(AbstractReasonerComponent reasoner)
void	setTreeFactory(QueryTreeFactory treeFactory)
void	start() Starts the algorithm.
void	stop() Stops the algorithm gracefully.

Methods inherited from class org.dllearner.core.AbstractCELA

changeLearningProblem, changeReasonerComponent, getAllowedConcepts, getAllowedDataProperties, getAllowedObjectProperties, getCurrentlyBestDescriptions, getCurrentlyBestDescriptions, getCurrentlyBestDescriptions, getCurrentlyBestEvaluatedDescriptions, getCurrentlyBestEvaluatedDescriptions, getCurrentlyBestEvaluatedDescriptions, getCurrentlyBestEvaluatedDescriptions, getCurrentlyBestMostGeneralEvaluatedDescriptions, getIgnoredConcepts, getIgnoredDataProperties, getIgnoredObjectProperties, getLearningProblem, getMaxExecutionTimeInSeconds, getReasoner, isUseMinimizer, setAllowedConcepts, setAllowedDataProperties, setAllowedObjectProperties, setIgnoredConcepts, setIgnoredDataProperties, setIgnoredObjectProperties, setLearningProblem, setMaxExecutionTime, setMaxExecutionTimeInSeconds, setRenderer, setUseMinimizer, supportedLearningProblems

Methods inherited from class org.dllearner.core.AbstractComponent

isInitialized

Methods inherited from class java.lang.Object

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

Constructor Detail

QTL2DisjunctiveMultiThreaded

public QTL2DisjunctiveMultiThreaded()

QTL2DisjunctiveMultiThreaded

public QTL2DisjunctiveMultiThreaded(PosNegLP learningProblem,
                                    AbstractReasonerComponent reasoner)

QTL2DisjunctiveMultiThreaded

public QTL2DisjunctiveMultiThreaded(PosNegLP lp,
                                    org.aksw.jena_sparql_api.core.QueryExecutionFactory qef)

QTL2DisjunctiveMultiThreaded

public QTL2DisjunctiveMultiThreaded(PosNegLP lp,
                                    SparqlEndpointKS ks)

QTL2DisjunctiveMultiThreaded

public QTL2DisjunctiveMultiThreaded(QTL2DisjunctiveMultiThreaded qtl)

Copy constructor.

Parameters:

qtl - the QTL2Disjunctive instance

Method Detail

init

public void init()
          throws ComponentInitException

Description copied from interface: Component

Method to be called after the component has been configured. Implementation of components can overwrite this method to perform setup and initialisation tasks for this component.

Specified by:

init in interface Component

Throws:

ComponentInitException - This exception is thrown if any exceptions occur within the initialisation process of this component. As component developer, you are encouraged to re-throw occurring exception as ComponentInitException and giving an error message as well as the actually exception by using the constructor ComponentInitException(String, Throwable).

setEntailment

public void setEntailment(Entailment entailment)

Parameters:

entailment - the entailment to set

setNrOfThreads

public void setNrOfThreads(int nrOfThreads)

start

public void start()

Description copied from interface: LearningAlgorithm

Starts the algorithm. It runs until paused, stopped, or a termination criterion has been reached.

Specified by:

start in interface LearningAlgorithm

stop

public void stop()

Description copied from interface: StoppableLearningAlgorithm

Stops the algorithm gracefully. A stopped algorithm cannot be resumed anymore. Use this method for cleanup and freeing memory.

Specified by:

stop in interface StoppableLearningAlgorithm

Overrides:

stop in class AbstractCELA

getCurrentlyBestDescription

public org.semanticweb.owlapi.model.OWLClassExpression getCurrentlyBestDescription()

Overrides:

getCurrentlyBestDescription in class AbstractCELA

Returns:

The best class OWLClassExpression found by the learning algorithm so far.

See Also:

AbstractCELA.getCurrentlyBestEvaluatedDescription()

getCurrentlyBestEvaluatedDescription

public EvaluatedDescription getCurrentlyBestEvaluatedDescription()

Description copied from class: AbstractCELA

Returns the best descriptions obtained so far.

Overrides:

getCurrentlyBestEvaluatedDescription in class AbstractCELA

Returns:

Best class class expression found so far.

isRunning

public boolean isRunning()

Description copied from interface: StoppableLearningAlgorithm

Returns whether the learning algorithm is running. Implementation should use a boolean status variable in their implementations of the start and resume methods.

Specified by:

isRunning in interface StoppableLearningAlgorithm

Overrides:

isRunning in class AbstractCELA

Returns:

True if the algorithm is running, false otherwise.

setReasoner

public void setReasoner(AbstractReasonerComponent reasoner)

Overrides:

setReasoner in class AbstractCELA

setNoisePercentage

public void setNoisePercentage(double noisePercentage)

Parameters:

noisePercentage - the noisePercentage to set

setNoise

public void setNoise(double noise)

Parameters:

noise - the noise to set

setBeta

public void setBeta(double beta)

Default value is 1. Lower values force importance of covering positive examples.

Parameters:

beta - the beta to set

setMaxTreeComputationTimeInSeconds

public void setMaxTreeComputationTimeInSeconds(double maxTreeComputationTimeInSeconds)

Set the max. execution time for the computation of a partial solution. If this value isn't set, the max. algorithm runtime will be used, thus, in worst case only one partial solution was computed.

Parameters:

maxTreeComputationTimeInSeconds - the max. computation for a partial solution tree

getHeuristic

public QueryTreeHeuristic getHeuristic()

Returns:

the heuristic

setHeuristic

public void setHeuristic(QueryTreeHeuristic heuristic)

Parameters:

heuristic - the heuristic to set

setTreeFactory

public void setTreeFactory(QueryTreeFactory treeFactory)

Parameters:

treeFactory - the treeFactory to set

getBestSolution

public EvaluatedRDFResourceTree getBestSolution()

getSolutions

public SortedSet<EvaluatedRDFResourceTree> getSolutions()

getSolutionsAsList

public List<EvaluatedRDFResourceTree> getSolutionsAsList()

setPositiveExampleTrees

public void setPositiveExampleTrees(Map<org.semanticweb.owlapi.model.OWLIndividual,RDFResourceTree> positiveExampleTrees)

Parameters:

positiveExampleTrees - the positive example trees to set

setNegativeExampleTrees

public void setNegativeExampleTrees(Map<org.semanticweb.owlapi.model.OWLIndividual,RDFResourceTree> negativeExampleTrees)

Parameters:

negativeExampleTrees - the negative example trees to set

setKs

@Autowired
public void setKs(SparqlEndpointKS ks)

Parameters:

ks - the ks to set

setMaxTreeDepth

public void setMaxTreeDepth(int maxTreeDepth)

Parameters:

maxTreeDepth - the maximum depth of the trees, if those have to be generated first. The default depth is 2.

getTimeBestSolutionFound

public long getTimeBestSolutionFound()

Returns:

the runtime in ms until the best solution was found

clone

public Object clone()
             throws CloneNotSupportedException

Overrides:

clone in class Object

Throws:

CloneNotSupportedException