opendial.inference

Interface InferenceAlgorithm

All Known Implementing Classes:

NaiveInference, SamplingAlgorithm, SwitchingAlgorithm, VariableElimination

public interface InferenceAlgorithm

Generic interface for probabilistic inference algorithms. Three distinct types of queries are possible:

• probability queries of the form P(X1,...,Xn)
• utility queries of the form U(X1,...,Xn)
• reduction queries where a Bayesian network is reduced to a subset of variables X1,...,Xn

The interface contains 3 abstract methods (queryProb, queryUtil and reduce) that must be specified by all implementing classes. In addition, a set of default methods provide alternative ways to call the inference process (e.g. with one or several query variables, with or without evidence, etc.).

Method Summary

Modifier and Type	Method and Description
default MultivariateDistribution	queryProb(BNetwork network, java.util.Collection<java.lang.String> queryVars) Computes the probability distribution for the query variables, assuming no additional evidence.
default MultivariateDistribution	queryProb(BNetwork network, java.util.Collection<java.lang.String> queryVars, Assignment evidence) Computes the probability distribution for the query variables given the provided evidence.
default IndependentDistribution	queryProb(BNetwork network, java.lang.String queryVar) Computes the probability distribution for the query variable, assuming no additional evidence.
default IndependentDistribution	queryProb(BNetwork network, java.lang.String queryVar, Assignment evidence) Computes the probability distribution for the query variable given the provided evidence.
MultivariateDistribution	queryProb(Query.ProbQuery query) Computes the probability distribution for the query variables given the provided evidence, all specified in the query
default UtilityTable	queryUtil(BNetwork network, java.util.Collection<java.lang.String> queryVars) Computes the utility table for the query variables (typically action variables), assuming no additional evidence.
default UtilityTable	queryUtil(BNetwork network, java.util.Collection<java.lang.String> queryVars, Assignment evidence) Computes the utility table for the query variables (typically action variables), given the provided evidence.
default UtilityTable	queryUtil(BNetwork network, java.lang.String queryVar) Computes the utility table for the query variable (typically an action variable), assuming no additional evidence.
default UtilityTable	queryUtil(BNetwork network, java.lang.String queryVar, Assignment evidence) Computes the utility table for the query variable (typically an action variable), given the provided evidence
UtilityTable	queryUtil(Query.UtilQuery query) Computes the utility table for the query variables (typically action variables), given the provided evidence.
default BNetwork	reduce(BNetwork network, java.util.Collection<java.lang.String> queryVars) Generates a new Bayesian network that only contains a subset of variables in the original network, assuming no additional evidence.
default BNetwork	reduce(BNetwork network, java.util.Collection<java.lang.String> queryVars, Assignment evidence) Generates a new Bayesian network that only contains a subset of variables in the original network and integrates the provided evidence.
BNetwork	reduce(Query.ReduceQuery query) Generates a new Bayesian network that only contains a subset of variables in the original network and integrates the provided evidence.

Method Detail

queryProb

MultivariateDistribution queryProb(Query.ProbQuery query)

Computes the probability distribution for the query variables given the provided evidence, all specified in the query

Parameters:

query - the full query

Returns:

the resulting probability distribution failed to deliver a result

queryProb

default MultivariateDistribution queryProb(BNetwork network,
                                           java.util.Collection<java.lang.String> queryVars,
                                           Assignment evidence)

Computes the probability distribution for the query variables given the provided evidence.

Parameters:

network - the Bayesian network on which to perform the inference

queryVars - the collection of query variables

evidence - the evidence

Returns:

the resulting probability distribution failed to deliver a result

queryProb

default MultivariateDistribution queryProb(BNetwork network,
                                           java.util.Collection<java.lang.String> queryVars)

Computes the probability distribution for the query variables, assuming no additional evidence.

Parameters:

network - the Bayesian network on which to perform the inference

queryVars - the collection of query variables

Returns:

the resulting probability distribution failed to deliver a result

queryProb

default IndependentDistribution queryProb(BNetwork network,
                                          java.lang.String queryVar,
                                          Assignment evidence)

Computes the probability distribution for the query variable given the provided evidence.

Parameters:

network - the Bayesian network on which to perform the inference

queryVar - the (unique) query variable

evidence - the evidence

Returns:

the resulting probability distribution for the variable inference process failed to deliver a result

queryProb

default IndependentDistribution queryProb(BNetwork network,
                                          java.lang.String queryVar)

Computes the probability distribution for the query variable, assuming no additional evidence.

Parameters:

network - the Bayesian network on which to perform the inference

queryVar - the (unique) query variable

Returns:

the resulting probability distribution for the variable inference process failed to deliver a result

queryUtil

UtilityTable queryUtil(Query.UtilQuery query)

Computes the utility table for the query variables (typically action variables), given the provided evidence.

Parameters:

query - the full query

Returns:

the resulting utility table deliver a result

queryUtil

default UtilityTable queryUtil(BNetwork network,
                               java.util.Collection<java.lang.String> queryVars,
                               Assignment evidence)

Computes the utility table for the query variables (typically action variables), given the provided evidence.

Parameters:

network - the Bayesian network on which to perform the inference

queryVars - the query variables (usually action variables)

evidence - the additional evidence

Returns:

the resulting utility table for the query variables process failed to deliver a result

queryUtil

default UtilityTable queryUtil(BNetwork network,
                               java.util.Collection<java.lang.String> queryVars)

Computes the utility table for the query variables (typically action variables), assuming no additional evidence.

Parameters:

network - the Bayesian network on which to perform the inference

queryVars - the query variables (usually action variables)

Returns:

the resulting utility table for the query variables process failed to deliver a result

queryUtil

default UtilityTable queryUtil(BNetwork network,
                               java.lang.String queryVar)

Computes the utility table for the query variable (typically an action variable), assuming no additional evidence.

Parameters:

network - the Bayesian network on which to perform the inference

queryVar - the query variable

Returns:

the resulting utility table for the query variable process failed to deliver a result

queryUtil

default UtilityTable queryUtil(BNetwork network,
                               java.lang.String queryVar,
                               Assignment evidence)

Computes the utility table for the query variable (typically an action variable), given the provided evidence

Parameters:

network - the Bayesian network on which to perform the inference

queryVar - the query variable

evidence - the additional evidence

Returns:

the resulting utility table for the query variable process failed to deliver a result

reduce

BNetwork reduce(Query.ReduceQuery query)

Generates a new Bayesian network that only contains a subset of variables in the original network and integrates the provided evidence.

Parameters:

query - the full reduction query

Returns:

the reduced Bayesian network deliver a result

reduce

default BNetwork reduce(BNetwork network,
                        java.util.Collection<java.lang.String> queryVars,
                        Assignment evidence)

Generates a new Bayesian network that only contains a subset of variables in the original network and integrates the provided evidence.

Parameters:

network - the original Bayesian network

queryVars - the variables to retain

evidence - the additional evidence

Returns:

the new, reduced Bayesian network deliver a result

reduce

default BNetwork reduce(BNetwork network,
                        java.util.Collection<java.lang.String> queryVars)

Generates a new Bayesian network that only contains a subset of variables in the original network, assuming no additional evidence.

Parameters:

network - the original Bayesian network

queryVars - the variables to retain

Returns:

the new, reduced Bayesian network deliver a result