org.dllearner.algorithms.fuzzydll
Class FuzzyCELOE

java.lang.Object
  org.dllearner.core.AbstractComponent
      org.dllearner.core.AbstractCELA
          org.dllearner.algorithms.fuzzydll.FuzzyCELOE

All Implemented Interfaces:

ClassExpressionLearningAlgorithm, Component, FuzzyClassExpressionLearningAlgorithm, LearningAlgorithm, StoppableLearningAlgorithm

public class FuzzyCELOE
extends AbstractCELA
implements FuzzyClassExpressionLearningAlgorithm

The CELOE (Class Expression Learner for Ontology Engineering) algorithm. It adapts and extends the standard supervised learning algorithm for the ontology engineering use case.

Author:

Jens Lehmann

Field Summary

Fields inherited from class org.dllearner.core.AbstractCELA

MAX_NR_OF_RESULTS

Constructor Summary

FuzzyCELOE(AbstractLearningProblem problem, AbstractReasonerComponent reasoner)

Method Summary

static Collection<ConfigOption<?>>	createConfigOptions()
int	getClassExpressionTests()
FuzzyCELOEConfigurator	getConfigurator() For each component, a configurator class is generated in package org.dllearner.core.configurators using the script { org.dllearner.scripts.ConfigJavaGenerator}.
double	getCurrentlyBestAccuracy()
Description	getCurrentlyBestDescription()
List<Description>	getCurrentlyBestDescriptions()
List<Description>	getCurrentlyBestDescriptions(int nrOfDescriptions)
EvaluatedDescription	getCurrentlyBestEvaluatedDescription() Returns the best descriptions obtained so far.
TreeSet<? extends EvaluatedDescription>	getCurrentlyBestEvaluatedDescriptions() Returns a sorted set of the best descriptions found so far.
List<? extends EvaluatedDescription>	getCurrentlyBestEvaluatedDescriptions(int nrOfDescriptions) Return the best currently found concepts up to some maximum count (no minimality filter used).
int	getMaximumHorizontalExpansion()
int	getMinimumHorizontalExpansion()
static String	getName()
FuzzyOENode	getSearchTreeRoot()
void	init() Method to be called after the component has been configured.
boolean	isRunning() Returns whether the learning algorithm is running.
void	start() Starts the algorithm.
void	stop() Stops the algorithm gracefully.
static Collection<Class<? extends AbstractLearningProblem>>	supportedLearningProblems()

Methods inherited from class org.dllearner.core.AbstractCELA

changeLearningProblem, changeReasonerComponent, getCurrentlyBestDescriptions, getCurrentlyBestEvaluatedDescriptions, getCurrentlyBestEvaluatedDescriptions, getCurrentlyBestMostGeneralEvaluatedDescriptions

Methods inherited from class java.lang.Object

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

Constructor Detail

FuzzyCELOE

public FuzzyCELOE(AbstractLearningProblem problem,
                  AbstractReasonerComponent reasoner)

Method Detail

getConfigurator

public FuzzyCELOEConfigurator getConfigurator()

Description copied from class: AbstractComponent

For each component, a configurator class is generated in package org.dllearner.core.configurators using the script { org.dllearner.scripts.ConfigJavaGenerator}. The configurator provides set and get methods for the configuration options of a component.

Specified by:

getConfigurator in class AbstractComponent

Returns:

An object allowing to configure this component.

supportedLearningProblems

public static Collection<Class<? extends AbstractLearningProblem>> supportedLearningProblems()

createConfigOptions

public static Collection<ConfigOption<?>> createConfigOptions()

getName

public static String getName()

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 rethrow occuring exception as ComponentInitException and giving an error message as well as the actualy exception by using the constructor ComponentInitException.ComponentInitException(String, Throwable).

getCurrentlyBestDescription

public Description getCurrentlyBestDescription()

Specified by:

getCurrentlyBestDescription in class AbstractCELA

Returns:

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

See Also:

AbstractCELA.getCurrentlyBestEvaluatedDescription()

getCurrentlyBestDescriptions

public List<Description> getCurrentlyBestDescriptions()

Overrides:

getCurrentlyBestDescriptions in class AbstractCELA

Returns:

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

See Also:

AbstractCELA.getCurrentlyBestEvaluatedDescriptions()

getCurrentlyBestEvaluatedDescription

public EvaluatedDescription getCurrentlyBestEvaluatedDescription()

Description copied from class: AbstractCELA

Returns the best descriptions obtained so far.

Specified by:

getCurrentlyBestEvaluatedDescription in class AbstractCELA

Returns:

Best class description found so far.

getCurrentlyBestEvaluatedDescriptions

public TreeSet<? extends EvaluatedDescription> getCurrentlyBestEvaluatedDescriptions()

Description copied from class: AbstractCELA

Returns a sorted set of the best descriptions found so far. We assume that they are ordered such that the best ones come in last. (In Java, iterators traverse a SortedSet in ascending order.)

Overrides:

getCurrentlyBestEvaluatedDescriptions in class AbstractCELA

Returns:

Best class descriptions found so far.

getCurrentlyBestAccuracy

public double getCurrentlyBestAccuracy()

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

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

Returns:

True if the algorithm is running, false otherwise.

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

getSearchTreeRoot

public FuzzyOENode getSearchTreeRoot()

getMaximumHorizontalExpansion

public int getMaximumHorizontalExpansion()

getMinimumHorizontalExpansion

public int getMinimumHorizontalExpansion()

getClassExpressionTests

public int getClassExpressionTests()

Returns:

the expressionTests

getCurrentlyBestDescriptions

public List<Description> getCurrentlyBestDescriptions(int nrOfDescriptions)

Specified by:

getCurrentlyBestDescriptions in interface ClassExpressionLearningAlgorithm

Specified by:

getCurrentlyBestDescriptions in interface FuzzyClassExpressionLearningAlgorithm

Overrides:

getCurrentlyBestDescriptions in class AbstractCELA

Parameters:

nrOfDescriptions - Limit for the number or returned descriptions.

Returns:

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

See Also:

AbstractCELA.getCurrentlyBestEvaluatedDescriptions(int)

getCurrentlyBestEvaluatedDescriptions

public List<? extends EvaluatedDescription> getCurrentlyBestEvaluatedDescriptions(int nrOfDescriptions)

Description copied from class: AbstractCELA

Return the best currently found concepts up to some maximum count (no minimality filter used).

Specified by:

getCurrentlyBestEvaluatedDescriptions in interface ClassExpressionLearningAlgorithm

Specified by:

getCurrentlyBestEvaluatedDescriptions in interface FuzzyClassExpressionLearningAlgorithm

Overrides:

getCurrentlyBestEvaluatedDescriptions in class AbstractCELA

Parameters:

nrOfDescriptions - Maximum number of descriptions returned.

Returns:

Return value is getCurrentlyBestDescriptions(nrOfDescriptions, 0.0, false).