mml

Class CPT

java.lang.Object

la.la.Value

la.la.Function

la.la.Function.Native

mml.UPModel

mml.UPFunctionModel

mml.CPT

All Implemented Interfaces:

java.lang.Comparable<Value>

public class CPT
extends UPFunctionModel

CPT -- Conditional Probability Table -- an (UnParameterised) FunctionModel, from an input datum with a working n(), such as a Value.Discrete or a Tuple of Discretes, to a Model of the output datum. The fully parameterised Model is CPT.M. In the simplest situation the output datum is modelled by MultiState Models but there is greater generality.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	CPT.M CPT.M, a fully parameterised Function Model, being a conditional probability table.

Nested classes/interfaces inherited from class mml.UPFunctionModel

UPFunctionModel.Est, UPFunctionModel.K

Nested classes/interfaces inherited from class mml.UPModel

UPModel.Transform

Nested classes/interfaces inherited from class la.la.Function.Native

Function.Native.WithInverse

Nested classes/interfaces inherited from class la.la.Function

Function.Cts2Cts, Function.Cts2Cts2Cts, Function.CtsD2CtsD, Function.HasInverse, Function.Native, Function.Native2, Function.Native3

Nested classes/interfaces inherited from class la.la.Value

Value.Atomic, Value.Bool, Value.Char, Value.Chars, Value.Cts, Value.Defer, Value.Discrete, Value.Enum, Value.Inc_Or, Value.Int, Value.Lambda, Value.List, Value.Maybe, Value.Option, Value.Real, Value.Scannable, Value.Structured, Value.Triv, Value.Tuple

Field Summary

Fields

Modifier and Type	Field and Description
Value	lwb lwb, upb, the bounds on the input datum.
int	lwb_n lwb_n, upb_n, the bounds on the input datum, as ints.
Value	upb lwb, upb, the bounds on the input datum.
int	upb_n lwb_n, upb_n, the bounds on the input datum, as ints.
UPModel	upm The UnParameterised Model to be parameterised for each case (Value) of the input datum.

Fields inherited from class mml.UPModel

dp

Fields inherited from class la.la.Value

C, comparator, CR, E, eight, ffalse, five, fiveR, four, fourR, half, negCR, negOne, negOneR, negTenR, nilVal, nine, None, one, oneR, PI, PIby2, point01, point1, point5, point9, quarter, seven, six, ten, tenR, three, threeR, triv, ttrue, two, twoR, zero, zeroR

Constructor Summary

Constructors

Constructor and Description
CPT(Value dp) Given problem-definition parameters, dp = (lwb,upb,upm), construct an (UnParameterised) CPT with (upb_n - lwb_n + 1) entries, each entry being (eventually) an fully parameterised upm-Model.

Method Summary

Modifier and Type	Method and Description
UPFunctionModel.Est	estimator(Value ps) Return an Estimator of fully parameterised CPTs -- of CPT.M.
CPT.M	sp2Model(double msg1, double msg2, Value sps) Given sps, a Vector of statistical parameters, one for each input Value (that is, one for each entry of the CPT), return a fully parameterised CPT Model.
Vector	stats(boolean add, Value ss0, Value ss1) Calls upon upm.stats(add,.,.).
Vector	stats(Vector ds, int lo, int hi) Given a data-set, ds, calculate sufficient statistics (of the output datum) for each possible case (Value) of the input datum.

Methods inherited from class mml.UPFunctionModel

apply

Methods inherited from class mml.UPModel

defnParams, main, stats, stats, toString, transform

Methods inherited from class la.la.Function

bOp, fromBop, fromUop, type, uOp

Methods inherited from class la.la.Value

AoM, bOp, compareTo, cons, cts, elt, errMsg, error, force, isTuple, just, n, nElts, nlAoM, pair, print, quad, real, RTE, triple, tuple, UOE, x

Methods inherited from class java.lang.Object

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

Field Detail

lwb

public final Value lwb

lwb, upb, the bounds on the input datum. Note, the bounds and the input datum have the same Type which may even be Tuple of Discrete Values.

upb

public final Value upb

lwb, upb, the bounds on the input datum. Note, the bounds and the input datum have the same Type which may even be Tuple of Discrete Values.

lwb_n

public final int lwb_n

lwb_n, upb_n, the bounds on the input datum, as ints.

upb_n

public final int upb_n

lwb_n, upb_n, the bounds on the input datum, as ints.

upm

public final UPModel upm

The UnParameterised Model to be parameterised for each case (Value) of the input datum.

Constructor Detail

CPT

public CPT(Value dp)

Given problem-definition parameters, dp = (lwb,upb,upm), construct an (UnParameterised) CPT with (upb_n - lwb_n + 1) entries, each entry being (eventually) an fully parameterised upm-Model.

Method Detail

stats

public Vector stats(Vector ds,
                    int lo,
                    int hi)

Given a data-set, ds, calculate sufficient statistics (of the output datum) for each possible case (Value) of the input datum. Uses upm.stats(.,.,.). (TODO: Implementation is multi-pass ELSE need INCREMENTAL suff stats. Which IS Possible now!) More on stats here.

Specified by:

stats in class UPModel

stats

public Vector stats(boolean add,
                    Value ss0,
                    Value ss1)

Calls upon upm.stats(add,.,.).

Specified by:

stats in class UPModel

sp2Model

public CPT.M sp2Model(double msg1,
                      double msg2,
                      Value sps)

Given sps, a Vector of statistical parameters, one for each input Value (that is, one for each entry of the CPT), return a fully parameterised CPT Model.

Specified by:

sp2Model in class UPFunctionModel

estimator

public UPFunctionModel.Est estimator(Value ps)

Return an Estimator of fully parameterised CPTs -- of CPT.M. The parameter, 'ps' (e.g., on a prior), is passed to the per-case-Estimator, upm.estimator(ps).

Overrides:

estimator in class UPModel