|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface GibbsSamplingComponent
This is the interface that any AbstractModel has to implement if it should be used in a Gibbs Sampling.
Before starting a series of samplings the method initModelForSampling(int)
is called.
Than before starting a specific sampling the method extendSampling(int, boolean)
is
called. In the sampling the method drawParameters( Sample, double[] )
is used for
drawing the parameters from the posterior (and writing them to a file). After finishing the sampling the method
samplingStopped()
is called. After a sampling the methods
parseParameterSet(int, int)
and parseNextParameterSet()
will be used for computing for instance the (log-) likelihoods.
The method isInSamplingMode()
can be used to check whether an object is currently used
for sampling. If the object is in sampling mode, it should not support any other method for changing the parameters
than drawParameters( Sample, double[] )
and
parseParameterSet(int, int)
. Furthermore it is legal to throw an Exception when the
object is in sampling mode and a method for saving, cloning or training the parameters is called.
AbstractModel
,
AbstractMixtureModel
,
AbstractMixtureModel.Algorithm.GIBBS_SAMPLING
Method Summary | |
---|---|
void |
drawParameters(Sample data,
double[] weights)
This method draws the parameters of the model from the a posteriori density. |
void |
extendSampling(int sampling,
boolean append)
This method allows to extend a sampling. |
void |
initModelForSampling(int starts)
This method initializes the model for the sampling. |
boolean |
isInSamplingMode()
This method returns true if the object is currently used in a sampling, otherwise
false . |
boolean |
parseNextParameterSet()
This method allows the user to parse the next set of parameters (from a file). |
boolean |
parseParameterSet(int sampling,
int n)
This method allows the user to parse the set of parameters with index n of a certain
sampling (from a file). |
void |
samplingStopped()
This method is the opposite of the method extendSampling(int, boolean) . |
Method Detail |
---|
boolean parseParameterSet(int sampling, int n) throws Exception
n
of a certain
sampling
(from a file). The internal numbering should start with 0. The parameter set with index 0
is the initial (random) parameter set. It is recommended that a series of parameter sets is accessed by the
following lines:
for( sampling = 0; sampling < numSampling; sampling++ )
{
while( b )
{
//do something
b = parseNextParameterSet();
}
sampling
- the index of the samplingn
- the index of the parameter set
true
if the parameter set could be parsed
Exception
- if there is a problem with parsing the parametersparseNextParameterSet()
boolean parseNextParameterSet()
true
if the parameters could be parsed, otherwise false
parseParameterSet(int, int)
void initModelForSampling(int starts) throws IOException
starts
- the number of different sampling starts that will be done
IOException
- if something went wrongFile.createTempFile(String, String, java.io.File )
void extendSampling(int sampling, boolean append) throws IOException
sampling
- the index of the samplingappend
- whether to append the sampled parameters to an existing file or to overwrite the file
IOException
- if the file could not be handled correctlyvoid samplingStopped() throws IOException
extendSampling(int, boolean)
. It can be
used for closing any streams of writer, ...
IOException
- if something went wrongextendSampling(int, boolean)
void drawParameters(Sample data, double[] weights) throws Exception
data
- a sampleweights
- the (non-negative) weights for each sequence of the sample
Exception
- if there is a problem with drawing the parameters, the model is not initialized, ...initModelForSampling(int)
,
parseParameterSet(int, int)
,
parseNextParameterSet()
boolean isInSamplingMode()
true
if the object is currently used in a sampling, otherwise
false
.
true
if the object is currently used in a sampling
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |