org.dllearner.algorithms.properties

Class DataPropertyHierarchyAxiomLearner<T extends org.semanticweb.owlapi.model.OWLDataPropertyAxiom>

java.lang.Object

org.dllearner.core.AbstractComponent

org.dllearner.core.AbstractAxiomLearningAlgorithm<T,V,S>

org.dllearner.algorithms.properties.PropertyAxiomLearner<org.semanticweb.owlapi.model.OWLDataProperty,T,org.semanticweb.owlapi.model.OWLDataPropertyAssertionAxiom>

org.dllearner.algorithms.properties.DataPropertyAxiomLearner<T>

org.dllearner.algorithms.properties.DataPropertyHierarchyAxiomLearner<T>

All Implemented Interfaces:

AxiomLearningAlgorithm<T>, Component, LearningAlgorithm

Direct Known Subclasses:

DisjointDataPropertyAxiomLearner, EquivalentDataPropertyAxiomLearner, SubDataPropertyOfAxiomLearner

public abstract class DataPropertyHierarchyAxiomLearner<T extends org.semanticweb.owlapi.model.OWLDataPropertyAxiom>
extends DataPropertyAxiomLearner<T>

A learning algorithm for data property hierarchy axioms.

Author:

Lorenz Buehmann

Field Summary

Fields

Modifier and Type	Field and Description
protected double	beta
protected static org.apache.jena.query.ParameterizedSparqlString	GIVEN_PROPERTY_OVERLAP_QUERY
protected static org.apache.jena.query.ParameterizedSparqlString	PROPERTY_OVERLAP_QUERY
protected static org.apache.jena.query.ParameterizedSparqlString	PROPERTY_OVERLAP_WITH_RANGE_QUERY
protected boolean	strictMode

Fields inherited from class org.dllearner.algorithms.properties.PropertyAxiomLearner

COUNT_QUERY, DISTINCT_OBJECTS_COUNT_QUERY, DISTINCT_SUBJECTS_COUNT_QUERY, GET_SAMPLE_QUERY, strictOWLMode, TRIPLES_COUNT_QUERY

Fields inherited from class org.dllearner.core.AbstractAxiomLearningAlgorithm

allowedNamespaces, axiomType, chunkCount, chunkSize, currentlyBestAxioms, df, entityToDescribe, existingAxioms, existingAxiomsTemplate, forceSPARQL_1_0_Mode, format, fullDataLoaded, iterativeQueryTemplate, ks, lastRowCount, learningProblem, logger, maxExecutionTimeInSeconds, maxFetchedRows, negExamplesQueryTemplate, offset, popularity, posExamplesQueryTemplate, progressMonitor, qef, reasoner, returnOnlyNewAxioms, sample, startTime, timeout, useSampling

Fields inherited from class org.dllearner.core.AbstractComponent

initialized

Constructor Summary

Constructors

Constructor and Description
DataPropertyHierarchyAxiomLearner(SparqlEndpointKS ks)

Method Summary

Modifier and Type	Method and Description
abstract T	getAxiom(org.semanticweb.owlapi.model.OWLDataProperty property, org.semanticweb.owlapi.model.OWLDataProperty otherProperty) Returns the hierarchy axiom based on the axiom type of the current learning algorithm between both properties.
protected SortedSet<org.semanticweb.owlapi.model.OWLDataProperty>	getCandidates() Returns the candidate properties for comparison.
Set<org.semanticweb.owlapi.model.OWLDataPropertyAssertionAxiom>	getNegativeExamples(EvaluatedAxiom<T> evAxiom)
Set<org.semanticweb.owlapi.model.OWLDataPropertyAssertionAxiom>	getPositiveExamples(EvaluatedAxiom<T> evAxiom)
protected org.apache.jena.query.ParameterizedSparqlString	getSampleQuery() The SPARQL CONSTRUCT query used to generate a sample for the given axiom type and entity.
protected void	run()
protected void	runBatched() In this method we try to compute the overlap with each property in one single SPARQL query.
void	setBeta(double beta)
void	setEntityToDescribe(org.semanticweb.owlapi.model.OWLDataProperty entityToDescribe)
void	setStrictMode(boolean strictMode)

Methods inherited from class org.dllearner.algorithms.properties.PropertyAxiomLearner

computeScore, getCountValue, getCountValue, getDistinctObjectsFrequency, getDistinctSubjectsFrequency, getPropertyPopularity, getPropertyPopularity, learnAxioms, setStrictOWLMode

Methods inherited from class org.dllearner.core.AbstractAxiomLearningAlgorithm

addFilterNamespace, addToMap, addToMap, computeScore, computeScore, convertLiteral, executeAskQuery, executeConstructQuery, executeSelectQuery, executeSelectQuery, explainScore, getAllClasses, getAxiomType, getBestEvaluatedAxiom, getCurrentlyBestAxioms, getCurrentlyBestAxioms, getCurrentlyBestAxioms, getCurrentlyBestAxioms, getCurrentlyBestEvaluatedAxiom, getCurrentlyBestEvaluatedAxioms, getCurrentlyBestEvaluatedAxioms, getCurrentlyBestEvaluatedAxioms, getCurrentlyBestEvaluatedAxioms, getEntityToDescribe, getEvaluatedFramentSize, getExistingAxioms, getLearningProblem, getMaxExecutionTimeInSeconds, getMaxFetchedRows, getReasoner, getRemainingRuntimeInMilliSeconds, init, isReturnOnlyNewAxioms, isTimeout, isUseSampling, printSubset, setForceSPARQL_1_0_Mode, setKs, setLearningProblem, setMaxExecutionTimeInSeconds, setMaxFetchedRows, setProgressMonitor, setQueryExecutionFactory, setReasoner, setReturnOnlyNewAxioms, setUseSampling, sortByValues, sortByValues, start, terminationCriteriaSatisfied, wasTimeout

Methods inherited from class org.dllearner.core.AbstractComponent

isInitialized

Methods inherited from class java.lang.Object

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

Field Detail

PROPERTY_OVERLAP_QUERY

protected static final org.apache.jena.query.ParameterizedSparqlString PROPERTY_OVERLAP_QUERY

PROPERTY_OVERLAP_WITH_RANGE_QUERY

protected static final org.apache.jena.query.ParameterizedSparqlString PROPERTY_OVERLAP_WITH_RANGE_QUERY

GIVEN_PROPERTY_OVERLAP_QUERY

protected static final org.apache.jena.query.ParameterizedSparqlString GIVEN_PROPERTY_OVERLAP_QUERY

strictMode

protected boolean strictMode

beta

protected double beta

Constructor Detail

DataPropertyHierarchyAxiomLearner

public DataPropertyHierarchyAxiomLearner(SparqlEndpointKS ks)

Method Detail

setEntityToDescribe

public void setEntityToDescribe(org.semanticweb.owlapi.model.OWLDataProperty entityToDescribe)

Overrides:

setEntityToDescribe in class PropertyAxiomLearner<org.semanticweb.owlapi.model.OWLDataProperty,T extends org.semanticweb.owlapi.model.OWLDataPropertyAxiom,org.semanticweb.owlapi.model.OWLDataPropertyAssertionAxiom>

Parameters:

entityToDescribe - the entityToDescribe to set

getSampleQuery

protected org.apache.jena.query.ParameterizedSparqlString getSampleQuery()

Description copied from class: AbstractAxiomLearningAlgorithm

The SPARQL CONSTRUCT query used to generate a sample for the given axiom type and entity.

Overrides:

getSampleQuery in class PropertyAxiomLearner<org.semanticweb.owlapi.model.OWLDataProperty,T extends org.semanticweb.owlapi.model.OWLDataPropertyAxiom,org.semanticweb.owlapi.model.OWLDataPropertyAssertionAxiom>

Returns:

the SPARQL query

run

protected void run()

Specified by:

run in class PropertyAxiomLearner<org.semanticweb.owlapi.model.OWLDataProperty,T extends org.semanticweb.owlapi.model.OWLDataPropertyAxiom,org.semanticweb.owlapi.model.OWLDataPropertyAssertionAxiom>

runBatched

protected void runBatched()

In this method we try to compute the overlap with each property in one single SPARQL query. This method might be much slower as the query is much more complex.

getAxiom

public abstract T getAxiom(org.semanticweb.owlapi.model.OWLDataProperty property,
                           org.semanticweb.owlapi.model.OWLDataProperty otherProperty)

Returns the hierarchy axiom based on the axiom type of the current learning algorithm between both properties. The relationship between both properties can be (1) subsumption, (2) equivalence or (3) disjointness.

Parameters:

property - the first property

otherProperty - the second property

Returns:

the hierarchy axiom

getCandidates

protected SortedSet<org.semanticweb.owlapi.model.OWLDataProperty> getCandidates()

Returns the candidate properties for comparison.

Returns:

the candidate properties

getPositiveExamples

public Set<org.semanticweb.owlapi.model.OWLDataPropertyAssertionAxiom> getPositiveExamples(EvaluatedAxiom<T> evAxiom)

Overrides:

getPositiveExamples in class AbstractAxiomLearningAlgorithm<T extends org.semanticweb.owlapi.model.OWLDataPropertyAxiom,org.semanticweb.owlapi.model.OWLDataPropertyAssertionAxiom,org.semanticweb.owlapi.model.OWLDataProperty>

getNegativeExamples

public Set<org.semanticweb.owlapi.model.OWLDataPropertyAssertionAxiom> getNegativeExamples(EvaluatedAxiom<T> evAxiom)

Overrides:

getNegativeExamples in class AbstractAxiomLearningAlgorithm<T extends org.semanticweb.owlapi.model.OWLDataPropertyAxiom,org.semanticweb.owlapi.model.OWLDataPropertyAssertionAxiom,org.semanticweb.owlapi.model.OWLDataProperty>

setBeta

public void setBeta(double beta)

Parameters:

beta - the beta to set

setStrictMode

public void setStrictMode(boolean strictMode)

Parameters:

strictMode - the strictMode to set