de.jstacs.models.discrete.inhomogeneous
Class FSDAGModel

java.lang.Object
  de.jstacs.models.AbstractModel
      de.jstacs.models.discrete.DiscreteGraphicalModel
          de.jstacs.models.discrete.inhomogeneous.InhomogeneousDGM
              de.jstacs.models.discrete.inhomogeneous.DAGModel
                  de.jstacs.models.discrete.inhomogeneous.FSDAGModel

All Implemented Interfaces:

InstantiableFromParameterSet, Model, Storable, Cloneable

Direct Known Subclasses:

FSDAGModelForGibbsSampling

public class FSDAGModel
extends DAGModel

This class can be used for any discrete fixed structure DAG model (FSDAGModel).

Author:

Jens Keilwagen

Field Summary

Fields inherited from class de.jstacs.models.discrete.inhomogeneous.DAGModel

constraints

Fields inherited from class de.jstacs.models.discrete.inhomogeneous.InhomogeneousDGM

DEFAULT_STREAM, sostream

Fields inherited from class de.jstacs.models.discrete.DiscreteGraphicalModel

params, trained

Fields inherited from class de.jstacs.models.AbstractModel

alphabets, length

Constructor Summary

FSDAGModel(FSDAGMParameterSet params)
This is the main constructor.

FSDAGModel(StringBuffer xml)
This is the constructor for Storable.

Method Summary

void	drawParameters(Sample data, double[] weights, int[][] graph) This method draws the parameters of the model from the a posteriori density.
String	getInstanceName() Should return a short instance name such as iMM(0), BN(2), ...
byte	getMaximalMarkovOrder() This method returns the maximal used markov order if possible.
String	getStructure() Returns a string representation of the graph.
protected String	getXMLTag()
protected void	set(DGMParameterSet params, boolean trained) Sets the parameters as internal parameters and does some essential computations.
static void	train(Model[] models, int[][] graph, double[][] weights, Sample... data) Computes the models with structure graph
void	train(Sample data, double[] weights) Trains the Model object given the data as Sample using the specified weights.
void	train(Sample data, double[] weights, int[][] graph) Computes the model with structure graph

Methods inherited from class de.jstacs.models.discrete.inhomogeneous.DAGModel

checkAcyclic, clone, createConstraints, drawParameters, emitSample, estimateParameters, getFurtherModelInfos, getLogPriorTerm, getLogProbFor, getNumericalCharacteristics, getProbFor, setFurtherModelInfos, toString

Methods inherited from class de.jstacs.models.discrete.inhomogeneous.InhomogeneousDGM

check, setOutputStream

Methods inherited from class de.jstacs.models.discrete.DiscreteGraphicalModel

fromXML, getCurrentParameterSet, getDescription, getESS, isTrained, toXML

Methods inherited from class de.jstacs.models.AbstractModel

getAlphabetContainer, getCharacteristics, getLength, getLogProbFor, getLogProbFor, getLogProbFor, getLogProbFor, getPriorTerm, getProbFor, getProbFor, set, setNewAlphabetContainerInstance, train

Methods inherited from class java.lang.Object

equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

FSDAGModel

public FSDAGModel(FSDAGMParameterSet params)
           throws CloneNotSupportedException,
                  IllegalArgumentException,
                  NonParsableException

This is the main constructor. It creates an new instance from the given parameter set.

Parameters:

params - the parameter set

Throws:

CloneNotSupportedException - if the parameter set could not be cloned

IllegalArgumentException - if the parameter set is not instantiated

NonParsableException - if the parameter set is not parsable

FSDAGModel

public FSDAGModel(StringBuffer xml)
           throws NonParsableException

This is the constructor for Storable.

Parameters:

xml - the xml representation

Throws:

NonParsableException - if the representation could not be parsed.

Method Detail

getInstanceName

public String getInstanceName()

Description copied from interface: Model

Should return a short instance name such as iMM(0), BN(2), ...

Returns:

a short instance name

getMaximalMarkovOrder

public byte getMaximalMarkovOrder()

Description copied from interface: Model

This method returns the maximal used markov order if possible.

Specified by:

getMaximalMarkovOrder in interface Model

Overrides:

getMaximalMarkovOrder in class AbstractModel

Returns:

maximal used markov order

getXMLTag

protected String getXMLTag()

Specified by:

getXMLTag in class DiscreteGraphicalModel

Returns:

the XML tag that is used in fromXML() and toXML()

See Also:

DiscreteGraphicalModel.fromXML(StringBuffer), DiscreteGraphicalModel.toXML()

train

public void train(Sample data,
                  double[] weights)
           throws Exception

Description copied from interface: Model

Trains the Model object given the data as Sample using the specified weights. The weight at position i belongs to the element at position i. So the array weight should have the number of sequences in the sample as dimension. (Optionally it is possible to use weight == null if all weights have the value one.)
This method should work non-incrementally. That means the result of the following series: train(data1); train(data2) should be a fully trained model over data2 and not over data1+data2. All parameters of the model were given by the call of the constructor.

Parameters:

data - the given sequences

weights - the weights of the elements, each weight should be non-negative

Throws:

Exception - an Exception should be thrown if the training did not succeed (e.g. the weights dimension of weights and number of samples does not match).

See Also:

Sample.getElementAt(int), Sample.ElementEnumerator

train

public void train(Sample data,
                  double[] weights,
                  int[][] graph)
           throws Exception

Computes the model with structure graph

Parameters:

data - the sample

weights - the weights for the sequences in the sample

graph - the graph

Throws:

Exception - if something went wrong

drawParameters

public void drawParameters(Sample data,
                           double[] weights,
                           int[][] graph)
                    throws Exception

This method draws the parameters of the model from the a posteriori density. For drawing from the prior you have to set the data and their weights to null. Furthermore this method enables you to specify a new graph structure.

Parameters:

data - a sample or null

weights - the (positive) weights for each sequence of the sample or null

graph - the graph or null for the current graph

Throws:

Exception

train

public static void train(Model[] models,
                         int[][] graph,
                         double[][] weights,
                         Sample... data)
                  throws Exception

Computes the models with structure graph

Parameters:

models - an array of AbstractModels containing only instances of FSDAGModel

data - the sample

weights - the weights for the sequences in the sample

graph - the graph

Throws:

Exception - if something went wrong

set

protected void set(DGMParameterSet params,
                   boolean trained)
            throws CloneNotSupportedException,
                   NonParsableException

Description copied from class: DiscreteGraphicalModel

Sets the parameters as internal parameters and does some essential computations. Used in fromParameterSet-methods.

Overrides:

set in class InhomogeneousDGM

Parameters:

params - the new ParameterSet

trained - the indicator for the model

Throws:

CloneNotSupportedException - if the parmeterSet could not be cloned

NonParsableException - if the parameters of the model could not be parsed

getStructure

public String getStructure()

Description copied from class: InhomogeneousDGM

Returns a string representation of the graph.

Overrides:

getStructure in class DAGModel

Returns:

a string representation of the graph