mml

Class BestOf

java.lang.Object

la.la.Value

la.la.Function

la.la.Function.Native

mml.UPModel

mml.BestOf

All Implemented Interfaces:

java.lang.Comparable<Value>

public class BestOf
extends UPModel

The UnParameterised BestOf Model – choose the best one out of a given Tuple of alternative UnParameterised Models. The alternatives are put in upms[]; all are considered to be equally likely apriori. All members of upms[] must of course be Models of the same kind of data, but their sufficient statistics and the parameters of their estimators and their parameterised Models can differ, one from another. The fully parameterised BestOf-Model is BestOf.M.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	BestOf.M The fully parameterised Model; BestOf is the UnParameterised Model.

Nested classes/interfaces inherited from class mml.UPModel

UPModel.Est, 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
UPModel[]	upms The alternative UnParameterised Models from which 'this' BestOf is to choose just one in estimating BestOf.M.

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
BestOf(Value upms) The problem definition parameter 'upms' is a Tuple of UnParameterised Models; saved as upms[].

Method Summary

Modifier and Type	Method and Description
UPModel.Est	estimator(Value ps) Return an Estimator of a fully parameterised BestOf.M Model (essentially pick the best of the upms[]).
BestOf.M	sp2Model(double msg1, double msg2, Value sp) Given first- and second-part message lengths, msg1 and msg2, and statistical parameter(s), sp, return a fully parameterised BestOf.M Model.
Value.Tuple	stats(boolean add, Value ss0, Value ss1) Combine statistics ss0 and ss1, either ss0 "+" ss1, or ss0 "-" ss1, depending on 'add' being true or false.
Value.Tuple	stats(Vector ds, int lo, int hi) Calculate the sufficient statistics of ds[lo,hi) for all possible alternatives upms[.].

Methods inherited from class mml.UPModel

apply, 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

upms

public final UPModel[] upms

The alternative UnParameterised Models from which 'this' BestOf is to choose just one in estimating BestOf.M.

Constructor Detail

BestOf

public BestOf(Value upms)

The problem definition parameter 'upms' is a Tuple of UnParameterised Models; saved as upms[].

Method Detail

sp2Model

public BestOf.M sp2Model(double msg1,
                         double msg2,
                         Value sp)

Given first- and second-part message lengths, msg1 and msg2, and statistical parameter(s), sp, return a fully parameterised BestOf.M Model.

Specified by:

sp2Model in class UPModel

stats

public Value.Tuple stats(Vector ds,
                         int lo,
                         int hi)

Calculate the sufficient statistics of ds[lo,hi) for all possible alternatives upms[.]. Return a Tuple of these sufficient statistics. Note that M.stats(...) is simpler because one of the alternatives has been chosen in M.

Specified by:

stats in class UPModel

stats

public Value.Tuple stats(boolean add,
                         Value ss0,
                         Value ss1)

Combine statistics ss0 and ss1, either ss0 "+" ss1, or ss0 "-" ss1, depending on 'add' being true or false. Return a Tuple of these sufficient statistics.

Specified by:

stats in class UPModel

estimator

public UPModel.Est estimator(Value ps)

Return an Estimator of a fully parameterised BestOf.M Model (essentially pick the best of the upms[]). Estimator's parameter 'ps' must be a Tuple having one element (possibly trivial) per upms[.].estimator().

Overrides:

estimator in class UPModel