com.bayesserver.inference

Class LoopyBeliefQueryOptions

java.lang.Object

com.bayesserver.inference.LoopyBeliefQueryOptions

All Implemented Interfaces:

QueryOptions

public final class LoopyBeliefQueryOptions
extends Object
implements QueryOptions

Options that govern the calculations performed by Inference.query(com.bayesserver.inference.QueryOptions, com.bayesserver.inference.QueryOutput).

Constructor Summary

Constructors

Constructor and Description
LoopyBeliefQueryOptions() Initializes a new instance of the LoopyBeliefQueryOptions class.

Method Summary

Modifier and Type	Method and Description
Cancellation	getCancellation() Allows cancellation of a query.
boolean	getConflict() Gets a value indicating whether the conflict measure should be calculated in a call to Inference.query(com.bayesserver.inference.QueryOptions, com.bayesserver.inference.QueryOutput).
DecisionAlgorithm	getDecisionAlgorithm() Gets the algorithm to use when a network contains Decision nodes.
InconsistentEvidenceMode	getInconsistentEvidenceMode() Determines when an InconsistentEvidenceException is raied.
boolean	getLogLikelihood() Gets a value indicating whether the log-likelihood of a case should be calculated in a call to Inference.query(com.bayesserver.inference.QueryOptions, com.bayesserver.inference.QueryOutput).
PropagationMethod	getPropagation() Gets the propagation method to be used during inference.
QueryEvidenceMode	getQueryEvidenceMode() Determines whether evidence is retracted for each query.
Integer	getTerminalTime() Gets the terminal time, which is the time at which any terminal nodes in a Dynamic Bayesian Network connect to temporal nodes.
double	getTolerance() Gets the tolerance used to determine whether or not the approximate inference process has converged.
void	setCancellation(Cancellation value) Allows cancellation of a query.
void	setConflict(boolean value) Sets a value indicating whether the conflict measure should be calculated in a call to Inference.query(com.bayesserver.inference.QueryOptions, com.bayesserver.inference.QueryOutput).
void	setDecisionAlgorithm(DecisionAlgorithm value) Sets the algorithm to use when a network contains Decision nodes.
void	setInconsistentEvidenceMode(InconsistentEvidenceMode value) Determines when an InconsistentEvidenceException is raied.
void	setLogLikelihood(boolean value) Sets a value indicating whether the log-likelihood of a case should be calculated in a call to Inference.query(com.bayesserver.inference.QueryOptions, com.bayesserver.inference.QueryOutput).
void	setPropagation(PropagationMethod value) Sets the propagation method to be used during inference.
void	setQueryEvidenceMode(QueryEvidenceMode value) Determines whether evidence is retracted for each query.
void	setTerminalTime(Integer value) Sets the terminal time, which is the time at which any terminal nodes in a Dynamic Bayesian Network connect to temporal nodes.
void	setTolerance(double value) Sets the tolerance used to determine whether or not the approximate inference process has converged.

Methods inherited from class java.lang.Object

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

Constructor Detail

LoopyBeliefQueryOptions

public LoopyBeliefQueryOptions()

Initializes a new instance of the LoopyBeliefQueryOptions class.

Method Detail

getTolerance

public double getTolerance()

Gets the tolerance used to determine whether or not the approximate inference process has converged.

Returns:

The tolerance.

setTolerance

public void setTolerance(double value)

Sets the tolerance used to determine whether or not the approximate inference process has converged.

Parameters:

value - The tolerance.

getTerminalTime

public Integer getTerminalTime()

Gets the terminal time, which is the time at which any terminal nodes in a Dynamic Bayesian Network connect to temporal nodes.

Specified by:

getTerminalTime in interface QueryOptions

setTerminalTime

public void setTerminalTime(Integer value)

Sets the terminal time, which is the time at which any terminal nodes in a Dynamic Bayesian Network connect to temporal nodes.

Specified by:

setTerminalTime in interface QueryOptions

getPropagation

public PropagationMethod getPropagation()

Gets the propagation method to be used during inference. Default is PropagationMethod.SUM.

Specified by:

getPropagation in interface QueryOptions

setPropagation

public void setPropagation(PropagationMethod value)

Sets the propagation method to be used during inference. Default is PropagationMethod.SUM.

Specified by:

setPropagation in interface QueryOptions

getDecisionAlgorithm

public DecisionAlgorithm getDecisionAlgorithm()

Gets the algorithm to use when a network contains Decision nodes.

Specified by:

getDecisionAlgorithm in interface QueryOptions

setDecisionAlgorithm

public void setDecisionAlgorithm(DecisionAlgorithm value)

Sets the algorithm to use when a network contains Decision nodes.

Specified by:

setDecisionAlgorithm in interface QueryOptions

getCancellation

public Cancellation getCancellation()

Allows cancellation of a query. When cancelled, a CancellationException will be raised.

If Cancellation.getCancel() has been set to true, it should be reset to false, before a subsequent query.

Specified by:

getCancellation in interface QueryOptions

setCancellation

public void setCancellation(Cancellation value)

Allows cancellation of a query. When cancelled, a CancellationException will be raised.

If Cancellation.getCancel() has been set to true, it should be reset to false, before a subsequent query.

Specified by:

setCancellation in interface QueryOptions

getLogLikelihood

public boolean getLogLikelihood()

Gets a value indicating whether the log-likelihood of a case should be calculated in a call to Inference.query(com.bayesserver.inference.QueryOptions, com.bayesserver.inference.QueryOutput). If calculated the result can be obtained from QueryOutput.getLogLikelihood().

This should only be requested if required.

The natural log (base e) is calculated.

Specified by:

getLogLikelihood in interface QueryOptions

Returns:

true if the log-likelihood should be calculated; otherwise, false. Defaults to false.

setLogLikelihood

public void setLogLikelihood(boolean value)

Sets a value indicating whether the log-likelihood of a case should be calculated in a call to Inference.query(com.bayesserver.inference.QueryOptions, com.bayesserver.inference.QueryOutput). If calculated the result can be obtained from QueryOutput.getLogLikelihood().

This should only be requested if required.

The natural log (base e) is calculated.

Specified by:

setLogLikelihood in interface QueryOptions

Parameters:

value - true if the log-likelihood should be calculated; otherwise, false. Defaults to false.

getConflict

public boolean getConflict()

Gets a value indicating whether the conflict measure should be calculated in a call to Inference.query(com.bayesserver.inference.QueryOptions, com.bayesserver.inference.QueryOutput). If calculated the result can be obtained from QueryOutput.getConflict().

Conflict is a measure that detects evidence that is conflicting or rare. The greater the conflict value above zero, the more likely the evidence is in conflict, or rare.

Conflict = log((P(e1)P(e2)...P(ei)) / P(e)), where P(e1), P(e2) etc... are the likelihoods of each variable considered in isolation, and P(e) is the likelihood of the all the evidence together.

Specified by:

getConflict in interface QueryOptions

setConflict

public void setConflict(boolean value)

Sets a value indicating whether the conflict measure should be calculated in a call to Inference.query(com.bayesserver.inference.QueryOptions, com.bayesserver.inference.QueryOutput). If calculated the result can be obtained from QueryOutput.getConflict().

Conflict is a measure that detects evidence that is conflicting or rare. The greater the conflict value above zero, the more likely the evidence is in conflict, or rare.

Conflict = log((P(e1)P(e2)...P(ei)) / P(e)), where P(e1), P(e2) etc... are the likelihoods of each variable considered in isolation, and P(e) is the likelihood of the all the evidence together.

Specified by:

setConflict in interface QueryOptions

getQueryEvidenceMode

public QueryEvidenceMode getQueryEvidenceMode()

Determines whether evidence is retracted for each query. See QueryEvidenceMode for more information.

Specified by:

getQueryEvidenceMode in interface QueryOptions

setQueryEvidenceMode

public void setQueryEvidenceMode(QueryEvidenceMode value)

Determines whether evidence is retracted for each query. See QueryEvidenceMode for more information.

Specified by:

setQueryEvidenceMode in interface QueryOptions

getInconsistentEvidenceMode

public InconsistentEvidenceMode getInconsistentEvidenceMode()

Determines when an InconsistentEvidenceException is raied.

Specified by:

getInconsistentEvidenceMode in interface QueryOptions

setInconsistentEvidenceMode

public void setInconsistentEvidenceMode(InconsistentEvidenceMode value)

Determines when an InconsistentEvidenceException is raied.

Specified by:

setInconsistentEvidenceMode in interface QueryOptions