opennlp.tools.ml.model

Class AbstractModel

java.lang.Object

opennlp.tools.ml.model.AbstractModel

All Implemented Interfaces:

MaxentModel

Direct Known Subclasses:

GISModel, PerceptronModel, QNModel

public abstract class AbstractModel
extends java.lang.Object
implements MaxentModel

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	AbstractModel.ModelType

Constructor Summary

Constructors

Constructor and Description
AbstractModel(Context[] params, java.lang.String[] predLabels, IndexHashTable<java.lang.String> pmap, java.lang.String[] outcomeNames)
AbstractModel(Context[] params, java.lang.String[] predLabels, java.lang.String[] outcomeNames)
AbstractModel(Context[] params, java.lang.String[] predLabels, java.lang.String[] outcomeNames, int correctionConstant, double correctionParam)

Method Summary

Modifier and Type	Method and Description
java.lang.String	getAllOutcomes(double[] ocs) Return a string matching all the outcome names with all the probabilities produced by the eval(String[] context) method.
java.lang.String	getBestOutcome(double[] ocs) Return the name of the outcome corresponding to the highest likelihood in the parameter ocs.
java.lang.Object[]	getDataStructures() Provides the fundamental data structures which encode the maxent model information.
int	getIndex(java.lang.String outcome) Gets the index associated with the String name of the given outcome.
AbstractModel.ModelType	getModelType()
int	getNumOutcomes() Returns the number of outcomes for this model.
java.lang.String	getOutcome(int i) Return the name of an outcome corresponding to an int id.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface opennlp.tools.ml.model.MaxentModel

eval, eval, eval

Constructor Detail

AbstractModel

public AbstractModel(Context[] params,
                     java.lang.String[] predLabels,
                     IndexHashTable<java.lang.String> pmap,
                     java.lang.String[] outcomeNames)

AbstractModel

public AbstractModel(Context[] params,
                     java.lang.String[] predLabels,
                     java.lang.String[] outcomeNames)

AbstractModel

public AbstractModel(Context[] params,
                     java.lang.String[] predLabels,
                     java.lang.String[] outcomeNames,
                     int correctionConstant,
                     double correctionParam)

Method Detail

getBestOutcome

public final java.lang.String getBestOutcome(double[] ocs)

Return the name of the outcome corresponding to the highest likelihood in the parameter ocs.

Specified by:

getBestOutcome in interface MaxentModel

Parameters:

ocs - A double[] as returned by the eval(String[] context) method.

Returns:

The name of the most likely outcome.

getModelType

public AbstractModel.ModelType getModelType()

getAllOutcomes

public final java.lang.String getAllOutcomes(double[] ocs)

Return a string matching all the outcome names with all the probabilities produced by the eval(String[] context) method.

Specified by:

getAllOutcomes in interface MaxentModel

Parameters:

ocs - A double[] as returned by the eval(String[] context) method.

Returns:

String containing outcome names paired with the normalized probability (contained in the double[] ocs) for each one.

getOutcome

public final java.lang.String getOutcome(int i)

Return the name of an outcome corresponding to an int id.

Specified by:

getOutcome in interface MaxentModel

Parameters:

i - An outcome id.

Returns:

The name of the outcome associated with that id.

getIndex

public int getIndex(java.lang.String outcome)

Gets the index associated with the String name of the given outcome.

Specified by:

getIndex in interface MaxentModel

Parameters:

outcome - the String name of the outcome for which the index is desired

Returns:

the index if the given outcome label exists for this model, -1 if it does not.

getNumOutcomes

public int getNumOutcomes()

Description copied from interface: MaxentModel

Returns the number of outcomes for this model.

Specified by:

getNumOutcomes in interface MaxentModel

Returns:

The number of outcomes.

getDataStructures

public final java.lang.Object[] getDataStructures()

Provides the fundamental data structures which encode the maxent model information. This method will usually only be needed by GISModelWriters. The following values are held in the Object array which is returned by this method:

• index 0: opennlp.tools.ml.maxent.Context[] containing the model parameters
• index 1: java.util.Map containing the mapping of model predicates to unique integers
• index 2: java.lang.String[] containing the names of the outcomes, stored in the index of the array which represents their unique ids in the model.
• index 3: java.lang.Integer containing the value of the models correction constant
• index 4: java.lang.Double containing the value of the models correction parameter

Returns:

An Object[] with the values as described above.