it.unitn.disi.smatch
Interface IMatchManager

All Known Implementing Classes:

MatchManager

public interface IMatchManager

Interface to matching related functionalites.
The following code can be used in order to obtain an instance of IMatchManager interface
IMatchManager mm=it.unitn.disi.smatch.MatchManager.getInstance();

Author:

Mikalai Yatskevich mikalai.yatskevich@comlab.ox.ac.uk, Aliaksandr Autayeu avtaev@gmail.com

Method Summary

IContext	classify(IContext ctxSource) Performs the second step of the semantic matching algorithm
IMatchMatrix	elementLevelMatching(IContext sourceContext, IContext targetContext) Performs the third step of semantic matching algorithm
IMatchMatrix	filter(java.util.Vector args) Performs additional filtering step executed after 4th step of semantic matching algorithm
IContext	loadContext(java.lang.String fileName) Uses current Loader in order to load the context from external source into internal datastructucture
IMapping	match(IContext sourceContext, IContext targetContext) Performs the whole matching process
IContext	offline(IContext ctxSource, java.lang.String ctxsSourceFile) Performs the first two steps of the semantic matching algorithm and render the results by current IContextRenderer
IMapping	online(IContext sourceContext, IContext targetContext) Performs the last two steps of the semantic matching algorithm, filtering and render the results by current IMappingRender
IContext	preprocess(IContext ctxSource) Performs the first step of the semantic matching algorithm
void	renderContext(IContext ctxSource, java.lang.String fileName) Renders context to screen,file or database
IMapping	renderMapping(java.util.Vector args) Renders mappings into appropriate format
void	setProperties(java.util.Properties properites) Set up the matching properties A list of parameters which influence on the matching process workflow name of the class which implements IWordNetMatcher interface WNmatcher = it.unitn.disi.smatch.oracles.wordnet.InMemoryWordNet name of the class which implements ILinguisticOracle interface LinguisticOracle = it.unitn.disi.smatch.oracles.wordnet.WordNet name of the class which implements IClassifier interface Classifier = it.unitn.disi.smatch.classifiers.DefaultClassifier name of the class which implements IPreprocessor interface Preprocessor = it.unitn.disi.smatch.preprocessors.DefaultPreprocessor name of the class which implements IMatcherLibrary interface MatcherLibrary = it.unitn.disi.smatch.matchers.element.MatcherLibrary name of the class which implements ILoader interface Loader = it.unitn.disi.smatch.loaders.CTXMLLoader name of the class which implements IMappingRenderer interface MappingRenderer = it.unitn.disi.smatch.renderers.mapping.DefaultHTMLMappingRenderer name of the class which implements IContextRenderer interface ContextRenderer = it.unitn.disi.smatch.renderers.context.CTXMLContextRenderer name of the class which implements IFilter interface Filter = it.unitn.disi.smatch.filters.DefaultFilter
IMatchMatrix	structureLevelMatching(IContext sourceContext, IContext targetContext, IMatchMatrix ClabMatrix) Performs the fourth step of semantic matching algorithm

Method Detail

setProperties

void setProperties(java.util.Properties properites)

Set up the matching properties A list of parameters which influence on the matching process workflow

name of the class which implements IWordNetMatcher interface
WNmatcher = it.unitn.disi.smatch.oracles.wordnet.InMemoryWordNet

name of the class which implements ILinguisticOracle interface
LinguisticOracle = it.unitn.disi.smatch.oracles.wordnet.WordNet

name of the class which implements IClassifier interface
Classifier = it.unitn.disi.smatch.classifiers.DefaultClassifier

name of the class which implements IPreprocessor interface
Preprocessor = it.unitn.disi.smatch.preprocessors.DefaultPreprocessor

name of the class which implements IMatcherLibrary interface
MatcherLibrary = it.unitn.disi.smatch.matchers.element.MatcherLibrary

name of the class which implements ILoader interface
Loader = it.unitn.disi.smatch.loaders.CTXMLLoader

name of the class which implements IMappingRenderer interface
MappingRenderer = it.unitn.disi.smatch.renderers.mapping.DefaultHTMLMappingRenderer

name of the class which implements IContextRenderer interface
ContextRenderer = it.unitn.disi.smatch.renderers.context.CTXMLContextRenderer

name of the class which implements IFilter interface
Filter = it.unitn.disi.smatch.filters.DefaultFilter

Parameters:

properites -

preprocess

IContext preprocess(IContext ctxSource)

Performs the first step of the semantic matching algorithm

Parameters:

ctxSource - interface to context to be preprocessed

Returns:

interface to preprocessed context

classify

IContext classify(IContext ctxSource)

Performs the second step of the semantic matching algorithm

Parameters:

ctxSource - interface to preprocessed context without concept at node formulas

Returns:

interface to preprocessed without concept at node formulas

renderContext

void renderContext(IContext ctxSource,
                   java.lang.String fileName)

Renders context to screen,file or database

Parameters:

ctxSource - context to be rendered

fileName - string which defines output device

elementLevelMatching

IMatchMatrix elementLevelMatching(IContext sourceContext,
                                  IContext targetContext)
                                  throws SMatchException

Performs the third step of semantic matching algorithm

Parameters:

sourceContext -

targetContext -

Returns:

interface to matrix of semantic relations between atomic concepts of labels in the contexts

Throws:

SMatchException

structureLevelMatching

IMatchMatrix structureLevelMatching(IContext sourceContext,
                                    IContext targetContext,
                                    IMatchMatrix ClabMatrix)
                                    throws SMatchException

Performs the fourth step of semantic matching algorithm

Parameters:

sourceContext -

targetContext -

ClabMatrix - interface to matrix of semantic relations between atomic concepts of labels in the contexts

Returns:

interface to matrix of semantic relations between concepts at nodes in the contexts

Throws:

SMatchException

filter

IMatchMatrix filter(java.util.Vector args)

Performs additional filtering step executed after 4th step of semantic matching algorithm

Parameters:

args - parameters to the filtering process (as in DefaultFilter implementation)
0 element fileName name of file for intermediate filtering results
1 element IMatchMatrix CnodMatrix matrix of semantic relations between concepts at nodes
2 element IMatchMatrix ClabMatrix matrix of semantic relations between concepts of labels
3 element IContext sourceContext
4 element IContext targetContext
all the other elements are reserved for future use

Returns:

interface to filtered matrix of semantic relations between concepts at nodes (CnodMatrix)

renderMapping

IMapping renderMapping(java.util.Vector args)

Renders mappings into appropriate format

Parameters:

args - parameters to the rendering process (as in DefaultHTMLMappingRenderer implementation)
0 element fileName name of file for intermediate filtering results
1 element IMatchMatrix CnodMatrix matrix of semantic relations between concepts at nodes
2 element IMatchMatrix ClabMatrix matrix of semantic relations between concepts of labels
3 element IContext sourceContext
4 element IContext targetContext

offline

IContext offline(IContext ctxSource,
                 java.lang.String ctxsSourceFile)

Performs the first two steps of the semantic matching algorithm and render the results by current IContextRenderer

Parameters:

ctxSource - interface to context to be preprocessed

ctxsSourceFile - a string passed to IContextRenderer implementation

Returns:

interface to preprocessed context

online

IMapping online(IContext sourceContext,
                IContext targetContext)
                throws SMatchException

Performs the last two steps of the semantic matching algorithm, filtering and render the results by current IMappingRender

Parameters:

sourceContext - interface to preprocessed context to be matched

targetContext - interface to preprocessed context to be matched

Returns:

interface to resulting mapping

Throws:

SMatchException

match

IMapping match(IContext sourceContext,
               IContext targetContext)
               throws SMatchException

Performs the whole matching process

Parameters:

sourceContext - interface to context to be matched

targetContext - interface to context to be matched

Returns:

interface to resulting mapping

Throws:

SMatchException

loadContext

IContext loadContext(java.lang.String fileName)
                     throws SMatchException

Uses current Loader in order to load the context from external source into internal datastructucture

Parameters:

fileName - a string passed to current Loader

Returns:

interface to internal context representation

Throws:

SMatchException