com.articulate.sigma.nlg.VerbProperties Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of sigma-component Show documentation

Sigma knowledge engineering system is an system for developing, viewing and debugging theories in first order logic. It works with Knowledge Interchange Format (KIF) and is optimized for the Suggested Upper Merged Ontology (SUMO) www.ontologyportal.org.

There is a newer version: 2.10

Show newest version

package com.articulate.sigma.nlg;

import java.util.List;

/**
 * An interface for obtaining verb behavior in specific situations, e.g. what case roles operate in a
 * subject position for a particular verb?
 * We expect multiple experimental implementations of this, coming from VerbNet, FrameNet, etc.
 * FIXME: perhaps rename to "VerbBehavior"?
 */
public interface VerbProperties {
    public static enum Polarity {AFFIRMATIVE, NEGATIVE}

    /******************************************************************************************
     * Return a list of case roles for the given verb and the given grammar role. The list consists
     * of the case roles which, for this verb, are most likely to fill the given grammar role. The list will
     * be in order of likelihood, from most likely to less likely. For example ("give", SUBJECT) will return
     * [CaseRole.AGENT]; ("give", DIRECT_OBJECT) will return [CaseRole.PATIENT]; ("give", INDIRECT_OBJECT) will
     * return [CaseRole.DESTINATION].
     * @param verb
     *   the verb in infinitive form
     * @param grammarRole
     * @return
     */
    public List getCaseRolesForGrammarRole(String verb, SVOElement.SVOGrammarPosition grammarRole);

    /******************************************************************************************
     * Return a list of prepositions for the given verb and the given case role. The list consists
     * of the prepositions which, for this verb, are most likely to precede the entity filling the given case role.
     * An empty string means "no preposition". The list will be in order of likelihood, from most likely to less likely.
     * For example ("give", Patient) will return "" because for this verb the Patient role does not take a preposition.
     * But ("give", DESTINATION) will return "to".
     * @param verb
     *   the verb in infinitive form
     * @param caseRole
     * @return
     *  the strings most likely to be used for this verb and case role, where empty string means "no preposition"
     */
    public List getPrepositionForCaseRole(String verb, CaseRole caseRole);

}