Package org.aksw.deer.enrichments

Class DereferencingEnrichmentOperator

java.lang.Object

org.aksw.faraday_cage.engine.AbstractExecutionNode<T>

org.aksw.faraday_cage.engine.AbstractParameterizedExecutionNode<Model>

org.aksw.deer.enrichments.AbstractParameterizedEnrichmentOperator

org.aksw.deer.enrichments.DereferencingEnrichmentOperator

All Implemented Interfaces:

DeerExecutionNode, EnrichmentOperator, ParameterizedEnrichmentOperator, Learnable, ReverseLearnable, SelfConfigurable, ParameterizedDeerExecutionNode, ExecutionNode<Model>, Parameterized, Plugin, org.pf4j.ExtensionPoint

@Extension
public class DereferencingEnrichmentOperator
extends AbstractParameterizedEnrichmentOperator
implements ReverseLearnable, SelfConfigurable

An EnrichmentOperator for dereferencing.

Dereferencing is a method of expanding knowledge of resources that belong to an external knowledge base. We define a dereferencing operation as the following sequence of operations:

1. Query the local model for starting resources ?x that belong to an external knowledge base
2. Query the external knowledge base for triples (?x, d, ?y), where d is a defined property path in the external knowledge base.
3. Add all results to the local model in the form of (?x, i, ?y), where i is the property name under which they should be imported.

Configuration

:operations

Each operation corresponds to one dereferencing operation, allowing multiple dereferencing operations being carried out by a single DereferencingEnrichmentOperator. Each entry may contain the following properties:

:lookUpProperty range: resource
Determines the starting resources ?x as all objects of triples having the value of :lookUpProperty as predicate.

:lookUpPrefix [required] range: string
Determines the starting resources ?x as all objects of triples having the value of :lookUpProperty as predicate.

:dereferencingProperty [required] range: resource
Look up the values to be imported to the local model in the external knowledge base using the property defined by the value of :dereferencingProperty.

:importProperty [required] range: resource
Add looked up values to starting resources using the value of :importProperty.

Example

Nested Class Summary

Nested classes/interfaces inherited from interface org.aksw.faraday_cage.engine.ExecutionNode

ExecutionNode.DegreeBounds

Field Summary

Fields

Modifier and Type	Field	Description
static Property	DEREFERENCING_PROPERTY
static Property	IMPORT_PROPERTY
static Property	LOOKUP_PREFIX
static Property	LOOKUP_PROPERTY
static Property	OPERATION
static Property	USE_SPARQL_ENDPOINT

Constructor Summary

Constructors

Constructor	Description
DereferencingEnrichmentOperator()

Method Summary

Modifier and Type	Method	Description
ValidatableParameterMap	createParameterMap()	Create an uninitialized ParameterMap to be filled by the ExecutionGraphGenerator.
ExecutionNode.DegreeBounds	getLearnableDegreeBounds()
void	initializeOperations()
ValidatableParameterMap	learnParameterMap(List<Model> inputs, Model target, ValidatableParameterMap prototype)
double	predictApplicability(List<Model> inputs, Model target)
List<Model>	reverseApply(List<Model> inputs, Model target)
protected List<Model>	safeApply(List<Model> models)

Methods inherited from class org.aksw.deer.enrichments.AbstractParameterizedEnrichmentOperator

deepCopy, getDegreeBounds, getType

Methods inherited from class org.aksw.faraday_cage.engine.AbstractParameterizedExecutionNode

getParameterMap, getValidationModelFor, initParameters, isInitialized

Methods inherited from class org.aksw.faraday_cage.engine.AbstractExecutionNode

apply, getId, getInDegree, getOutDegree, initDegrees, initPluginId

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.aksw.faraday_cage.engine.ExecutionNode

apply, getInDegree, getOutDegree, initDegrees

Methods inherited from interface org.aksw.faraday_cage.engine.Parameterized

getParameterMap, initParameters, isInitialized

Methods inherited from interface org.aksw.faraday_cage.engine.Plugin

getId, initPluginId, isInitialized

Field Details

LOOKUP_PROPERTY

public static final Property LOOKUP_PROPERTY

LOOKUP_PREFIX

public static final Property LOOKUP_PREFIX

DEREFERENCING_PROPERTY

public static final Property DEREFERENCING_PROPERTY

IMPORT_PROPERTY

public static final Property IMPORT_PROPERTY

OPERATION

public static final Property OPERATION

USE_SPARQL_ENDPOINT

public static final Property USE_SPARQL_ENDPOINT

Constructor Details

DereferencingEnrichmentOperator

public DereferencingEnrichmentOperator()

Method Details

createParameterMap

public ValidatableParameterMap createParameterMap()

Description copied from interface: Parameterized

Create an uninitialized ParameterMap to be filled by the ExecutionGraphGenerator.

Specified by:

createParameterMap in interface Parameterized

Returns:

uninitialized ParameterMap containing all allowed Parameter

initializeOperations

public void initializeOperations()

safeApply

protected List<Model> safeApply(List<Model> models)

Specified by:

safeApply in class AbstractExecutionNode<Model>

predictApplicability

public double predictApplicability(List<Model> inputs,
 Model target)

Specified by:

predictApplicability in interface ReverseLearnable

reverseApply

public List<Model> reverseApply(List<Model> inputs,
 Model target)

Specified by:

reverseApply in interface ReverseLearnable

learnParameterMap

public ValidatableParameterMap learnParameterMap(List<Model> inputs,
 Model target,
 ValidatableParameterMap prototype)

Specified by:

learnParameterMap in interface SelfConfigurable

getLearnableDegreeBounds

public ExecutionNode.DegreeBounds getLearnableDegreeBounds()

Specified by:

getLearnableDegreeBounds in interface Learnable