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

Go to download
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);

}