it.unitn.disi.smatch.oracles.ISenseMatcher Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of s-match Show documentation

A version of S-Match semantic matching framework for Open Data

The newest version!

package it.unitn.disi.smatch.oracles;

import it.unitn.disi.common.components.IConfigurable;
import it.unitn.disi.smatch.data.ling.ISense;

import java.util.List;

/**
 * An interface to sense matchers.
 *
 * @author Mikalai Yatskevich [email protected]
 * @author Aliaksandr Autayeu
 */
public interface ISenseMatcher extends IConfigurable {

    /**
     * Returns semantic relation holding between two sets of senses.
     *
     * @param sourceSenses source set of senses
     * @param targetSenses target set of senses
     * @return a relation
     * @throws SenseMatcherException SenseMatcherException
     */
    public char getRelation(List sourceSenses, List targetSenses) throws SenseMatcherException;

    /**
     * Checks whether the source is more general than target.
     *
     * @param source source sense
     * @param target target sense
     * @return whether relation holds
     * @throws SenseMatcherException SenseMatcherException
     */
    public boolean isSourceMoreGeneralThanTarget(ISense source, ISense target) throws SenseMatcherException;

    /**
     * Checks whether the source is less general than target.
     *
     * @param source source sense
     * @param target target sense
     * @return whether relation holds
     * @throws SenseMatcherException SenseMatcherException
     */
    public boolean isSourceLessGeneralThanTarget(ISense source, ISense target) throws SenseMatcherException;

    /**
     * Checks whether the source is a synonym of the target.
     *
     * @param source source sense
     * @param target target sense
     * @return whether relation holds
     * @throws SenseMatcherException SenseMatcherException
     */
    public boolean isSourceSynonymTarget(ISense source, ISense target) throws SenseMatcherException;

    /**
     * Checks whether the source is disjoint with the target.
     *
     * @param source source sense
     * @param target target sense
     * @return whether relation holds
     * @throws SenseMatcherException SenseMatcherException
     */
    public boolean isSourceOppositeToTarget(ISense source, ISense target) throws SenseMatcherException;
}