it.unitn.disi.smatch.data.ling.ISense 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.data.ling;

import it.unitn.disi.smatch.oracles.LinguisticOracleException;

import java.util.List;

/**
 * Interface for a dictionary sense.
 *
 * @author Aliaksandr Autayeu
 */
public interface ISense {

    /**
     * Returns sense id. The format of the sense id is up to the implementation of the linguistic oracle.
     *
     * @return sense id
     */
    String getId();

    /**
     * Returns a sense gloss, that is a textual description of the meaning.
     *
     * @return a gloss
     */
    String getGloss();

    /**
     * Get lemmas of this sense.
     *
     * @return lemmas
     */
    List getLemmas();

    /**
     * Returns "parents", that is hypernyms of the sense.
     *
     * @return hypernyms of the sense
     * @throws LinguisticOracleException LinguisticOracleException
     */
    List getParents() throws LinguisticOracleException;

    /**
     * Returns "parents", that is hypernyms of the sense, up to certain depth.
     *
     * @param depth a search depth
     * @return "parents"
     * @throws LinguisticOracleException LinguisticOracleException
     */
    List getParents(int depth) throws LinguisticOracleException;

    /**
     * Returns "children", that is hyponyms of the sense.
     *
     * @return "children"
     * @throws LinguisticOracleException LinguisticOracleException
     */
    List getChildren() throws LinguisticOracleException;

    /**
     * Returns "children", that is hyponyms of the sense, down to certain depth.
     *
     * @param depth a search depth
     * @return "children"
     * @throws LinguisticOracleException LinguisticOracleException
     */
    List getChildren(int depth) throws LinguisticOracleException;
}