edu.cs.ai.kreator.models
Class StructureLearner

java.lang.Object
  edu.cs.ai.kreator.models.Learner
      edu.cs.ai.kreator.models.StructureLearner

All Implemented Interfaces:

ModelComponent

public abstract class StructureLearner
extends Learner

This class models an abstract structure learner i.e. a learner that takes some data and computes a valid structure (knowledgebase) without calculating any parameter values.

Author:

Matthias Thimm, Tim Janus

Constructor Summary

StructureLearner()

Method Summary

static java.util.List<StructureLearner>	getAllStructureLearners() This method returns a comprehensive list of all structure-learners currently available in the system.
static StructureLearner	getStructureLearnerById(java.lang.String id) Returns a structure-learner with the given identification string.
static java.util.List<StructureLearner>	getStructureLearnersFor(java.lang.Class<?> kbClass) Returns a list of all structure-learners capable of learner the given knowledge base type.
abstract Knowledgebase	learnModel(java.util.Collection<? extends AtomExpression> data)

Methods inherited from class edu.cs.ai.kreator.models.Learner

incorporateClosedWorldAssumption

Methods inherited from class java.lang.Object

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

Methods inherited from interface edu.cs.ai.kreator.models.ModelComponent

getDescription, getId, getSupportedKnowledgeBaseClass

Constructor Detail

StructureLearner

public StructureLearner()

Method Detail

getStructureLearnersFor

public static java.util.List<StructureLearner> getStructureLearnersFor(java.lang.Class<?> kbClass)

Returns a list of all structure-learners capable of learner the given knowledge base type.

Parameters:

kbClass - a knowledge base class.

Returns:

a list of learners capable of learning the given knowledge base type.

getStructureLearnerById

public static StructureLearner getStructureLearnerById(java.lang.String id)
                                                throws UnknownLearnerIdException

Returns a structure-learner with the given identification string.

Parameters:

a - learner id

Returns:

a structure-learner with the given identification string

Throws:

UnknownLearnerIdException

getAllStructureLearners

public static java.util.List<StructureLearner> getAllStructureLearners()

This method returns a comprehensive list of all structure-learners currently available in the system.

Returns:

a comprehensive list of all structure-learners currently available in the system.

learnModel

public abstract Knowledgebase learnModel(java.util.Collection<? extends AtomExpression> data)
                                  throws AbortedLearningException,
                                         GeneralLearningException

Parameters:

data - a collection of atom expressions.

Returns:

a knowledge base.

Throws:

AbortedLearningException - if the user aborted the learning.

GeneralLearningException - if something went wrong during learning.