net.sourceforge.fluxion.runcible.graph.mapping
Class MappingManager

java.lang.Object
  net.sourceforge.fluxion.runcible.graph.mapping.MappingManager

public class MappingManager
extends java.lang.Object

Javadocs go here.

Version:

1.0

Author:

Tony Burdett

Constructor Summary

MappingManager()

Method Summary

void	createMapping() Create a new, empty mapping ready to be developed.
void	createMapping(org.semanticweb.owl.model.OWLOntology sourceOntology, org.semanticweb.owl.model.OWLOntology targetOntology)
void	createMapping(org.semanticweb.owl.model.OWLOntology sourceOntology, org.semanticweb.owl.model.OWLOntology targetOntology, boolean upfrontGraphGeneration) Create a new mapping, with an option to specify whether the source and target graphs get generated upfront.
protected Graph	createSourceGraph()
protected Graph	createTargetGraph()
Mapping	getMapping()
ColorScheme	getSourceColours()
OWLGraph	getSourceGraph() Sets the URL that is the location for the ontology we're using in this mapping.
org.semanticweb.owl.model.OWLOntology	getSourceOntology()
ColorScheme	getTargetColours()
OWLGraph	getTargetGraph()
org.semanticweb.owl.model.OWLOntology	getTargetOntology()
void	loadMapping(java.net.URL mappingRules) Load a mapping from a mapping document.
void	setSourceColours(ColorScheme sourceColours)
void	setSourceOntology(org.semanticweb.owl.model.OWLOntology sourceOntology)
void	setTargetColours(ColorScheme targetColours)
void	setTargetOntology(org.semanticweb.owl.model.OWLOntology targetOntology)
void	unload() Remove an existing mapping.

Methods inherited from class java.lang.Object

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

Constructor Detail

MappingManager

public MappingManager()

Method Detail

getMapping

public Mapping getMapping()

createMapping

public void createMapping()

Create a new, empty mapping ready to be developed. This assumes that the sourceOntology and the targetOntology have already been set. If they have not, NullPointerExceptions will be thrown.

createMapping

public void createMapping(org.semanticweb.owl.model.OWLOntology sourceOntology,
                          org.semanticweb.owl.model.OWLOntology targetOntology)

createMapping

public void createMapping(org.semanticweb.owl.model.OWLOntology sourceOntology,
                          org.semanticweb.owl.model.OWLOntology targetOntology,
                          boolean upfrontGraphGeneration)
                   throws org.semanticweb.owl.inference.OWLReasonerException

Create a new mapping, with an option to specify whether the source and target graphs get generated upfront. If upfrontGraphGeneration is set to true, the MappingManager will attempt to construct source and target graphs by reasoning over the relevant ontologies, constructing all possible walk operations from all possible class descriptions, and attaching all possible data values. Essentially, this is a shortcut to getting a graph prepared, meaning you should only have to do the mappings not build the graph from scratch. We may need to add logic to reroot graphs. Also, there will need to be a considerable amount of pruning to whittle the graph down to just relevant stuff.

Parameters:

sourceOntology - the source ontology

targetOntology - the target ontology

upfrontGraphGeneration - whether to generate the graphs upfront. If false, equivalent to createMapping(org.semanticweb.owl.model.OWLOntology, org.semanticweb.owl.model.OWLOntology)

Throws:

org.semanticweb.owl.inference.OWLReasonerException - if the source or target ontologies failed to classify

loadMapping

public void loadMapping(java.net.URL mappingRules)
                 throws java.io.IOException

Load a mapping from a mapping document. This assumes that

Parameters:

mappingRules - the url to the mapping document

Throws:

java.io.IOException - if the file can't be accessed

unload

public void unload()

Remove an existing mapping.

getSourceOntology

public org.semanticweb.owl.model.OWLOntology getSourceOntology()

setSourceOntology

public void setSourceOntology(org.semanticweb.owl.model.OWLOntology sourceOntology)

getSourceGraph

public OWLGraph getSourceGraph()

Sets the URL that is the location for the ontology we're using in this mapping. If the URL for the source ontology is set when the URI for the source ontology is not set, then the URI will be discovered by loading the ontology at this URL. Otherwise, it is assumed that this URL points to the ontology described by the current source ontology URI - so if switching between ontologies in the mapping manager, make sure you unload() everything first.

Returns:

the source OWLGraph

getSourceColours

public ColorScheme getSourceColours()

setSourceColours

public void setSourceColours(ColorScheme sourceColours)

getTargetOntology

public org.semanticweb.owl.model.OWLOntology getTargetOntology()

setTargetOntology

public void setTargetOntology(org.semanticweb.owl.model.OWLOntology targetOntology)

getTargetGraph

public OWLGraph getTargetGraph()

getTargetColours

public ColorScheme getTargetColours()

setTargetColours

public void setTargetColours(ColorScheme targetColours)

createSourceGraph

protected Graph createSourceGraph()

createTargetGraph

protected Graph createTargetGraph()