org.dllearner.algorithms.properties

Class MultiPropertyAxiomLearner

java.lang.Object

org.dllearner.algorithms.properties.MultiPropertyAxiomLearner

public class MultiPropertyAxiomLearner
extends Object

This is a wrapper class to handle more than one property axiom type in a more intelligent way, e.g. when sampling is activated it might be better to generate a unique sample and apply the algorithms on that sample afterwards. Note that this only works for subsets of axiom types that have the same sample structure.
Additionally, this class is able to configure and run the algorithms in a parallel way.

Author:

Lorenz Buehmann

Constructor Summary

Constructors

Constructor and Description
MultiPropertyAxiomLearner(org.aksw.jena_sparql_api.core.QueryExecutionFactory qef)
MultiPropertyAxiomLearner(SparqlEndpointKS ks)

Method Summary

Modifier and Type	Method and Description
AbstractAxiomLearningAlgorithm	getAlgorithm(org.semanticweb.owlapi.model.AxiomType<? extends org.semanticweb.owlapi.model.OWLAxiom> axiomType)
Map<org.semanticweb.owlapi.model.AxiomType<? extends org.semanticweb.owlapi.model.OWLAxiom>,List<EvaluatedAxiom<org.semanticweb.owlapi.model.OWLAxiom>>>	getCurrentlyBestEvaluatedAxioms()
List<EvaluatedAxiom<org.semanticweb.owlapi.model.OWLAxiom>>	getCurrentlyBestEvaluatedAxioms(org.semanticweb.owlapi.model.AxiomType<? extends org.semanticweb.owlapi.model.OWLAxiom> axiomType)
List<EvaluatedAxiom<org.semanticweb.owlapi.model.OWLAxiom>>	getCurrentlyBestEvaluatedAxioms(org.semanticweb.owlapi.model.AxiomType<? extends org.semanticweb.owlapi.model.OWLAxiom> axiomType, double accuracyThreshold)
Set<org.semanticweb.owlapi.model.OWLObject>	getNegatives(org.semanticweb.owlapi.model.AxiomType<? extends org.semanticweb.owlapi.model.OWLAxiom> axiomType, EvaluatedAxiom<org.semanticweb.owlapi.model.OWLAxiom> axiom)
Set<org.semanticweb.owlapi.model.OWLObject>	getPositives(org.semanticweb.owlapi.model.AxiomType<? extends org.semanticweb.owlapi.model.OWLAxiom> axiomType, EvaluatedAxiom<org.semanticweb.owlapi.model.OWLAxiom> axiom)
static void	main(String[] args)
void	setAxiomTypes(Set<org.semanticweb.owlapi.model.AxiomType<? extends org.semanticweb.owlapi.model.OWLAxiom>> axiomTypes) Set the axiom types that will be processed.
void	setEntityToDescribe(org.semanticweb.owlapi.model.OWLEntity entity)
void	setMaxExecutionTime(long executionTimeDuration, TimeUnit executionTimeUnit) Set the maximum execution time.
void	setMaxNrOfThreads(int maxNrOfThreads)
void	setMaxSampleGenerationTime(long sampleGenerationTimeDuration, TimeUnit sampleGenerationTimeUnit) Set the maximum time to generate a sample.
void	setMultiThreaded(boolean multiThreaded)
void	setProgressMonitor(AxiomLearningProgressMonitor progressMonitor)
void	setUseSampling(boolean useSampling)
void	start()

Methods inherited from class java.lang.Object

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

Constructor Detail

MultiPropertyAxiomLearner

public MultiPropertyAxiomLearner(SparqlEndpointKS ks)

MultiPropertyAxiomLearner

public MultiPropertyAxiomLearner(org.aksw.jena_sparql_api.core.QueryExecutionFactory qef)

Method Detail

start

public void start()

getCurrentlyBestEvaluatedAxioms

public Map<org.semanticweb.owlapi.model.AxiomType<? extends org.semanticweb.owlapi.model.OWLAxiom>,List<EvaluatedAxiom<org.semanticweb.owlapi.model.OWLAxiom>>> getCurrentlyBestEvaluatedAxioms()

getCurrentlyBestEvaluatedAxioms

public List<EvaluatedAxiom<org.semanticweb.owlapi.model.OWLAxiom>> getCurrentlyBestEvaluatedAxioms(org.semanticweb.owlapi.model.AxiomType<? extends org.semanticweb.owlapi.model.OWLAxiom> axiomType)

getCurrentlyBestEvaluatedAxioms

public List<EvaluatedAxiom<org.semanticweb.owlapi.model.OWLAxiom>> getCurrentlyBestEvaluatedAxioms(org.semanticweb.owlapi.model.AxiomType<? extends org.semanticweb.owlapi.model.OWLAxiom> axiomType,
                                                                                                   double accuracyThreshold)

setProgressMonitor

public void setProgressMonitor(AxiomLearningProgressMonitor progressMonitor)

setEntityToDescribe

public void setEntityToDescribe(org.semanticweb.owlapi.model.OWLEntity entity)

setAxiomTypes

public void setAxiomTypes(Set<org.semanticweb.owlapi.model.AxiomType<? extends org.semanticweb.owlapi.model.OWLAxiom>> axiomTypes)

Set the axiom types that will be processed. Note, a sanity check is done such that only axiom types will be processed that correspond to the declared entity.

Parameters:

axiomTypes - the axiom types

getAlgorithm

public AbstractAxiomLearningAlgorithm getAlgorithm(org.semanticweb.owlapi.model.AxiomType<? extends org.semanticweb.owlapi.model.OWLAxiom> axiomType)

getPositives

public Set<org.semanticweb.owlapi.model.OWLObject> getPositives(org.semanticweb.owlapi.model.AxiomType<? extends org.semanticweb.owlapi.model.OWLAxiom> axiomType,
                                                                EvaluatedAxiom<org.semanticweb.owlapi.model.OWLAxiom> axiom)

getNegatives

public Set<org.semanticweb.owlapi.model.OWLObject> getNegatives(org.semanticweb.owlapi.model.AxiomType<? extends org.semanticweb.owlapi.model.OWLAxiom> axiomType,
                                                                EvaluatedAxiom<org.semanticweb.owlapi.model.OWLAxiom> axiom)

setUseSampling

public void setUseSampling(boolean useSampling)

Parameters:

useSampling - the useSampling to set

setMultiThreaded

public void setMultiThreaded(boolean multiThreaded)

Parameters:

multiThreaded - whether to enable multi-threaded execution (@see setMaxNrOfThreads)

setMaxNrOfThreads

public void setMaxNrOfThreads(int maxNrOfThreads)

Parameters:

maxNrOfThreads - the max. nr of threads

setMaxExecutionTime

public void setMaxExecutionTime(long executionTimeDuration,
                                TimeUnit executionTimeUnit)

Set the maximum execution time. Note, this value represents the total computation time of all axiom types that have been set, thus, it's recommended to increase the runtime.

Parameters:

executionTimeDuration - the execution time

executionTimeUnit - the time unit

setMaxSampleGenerationTime

public void setMaxSampleGenerationTime(long sampleGenerationTimeDuration,
                                       TimeUnit sampleGenerationTimeUnit)

Set the maximum time to generate a sample. Note, this value represents the time to compute a single sample, thus, this time is spend for each axiom type (resp. cluster of axiom types).

Parameters:

sampleGenerationTimeDuration - the sample generation time

sampleGenerationTimeUnit - the time unit

main

public static void main(String[] args)
                 throws Exception

Throws:

Exception