Package com.bayesserver.inference

Class DefaultEvidence

java.lang.Object

com.bayesserver.inference.DefaultEvidence

All Implemented Interfaces:

Evidence

public final class DefaultEvidence
extends Object
implements Evidence

Represents the evidence, or case data (e.g. row in a database) used in a query. Evidence is always associated with a particular network, however if necessary can be detached or attached to an instance of an inference engine. This has the follwing advantages: - Evidence can be set before an inference engine is created, or retained when an inference engine is destroyed. - Evidence can be switched between inference engines. - An inference engine can switch between different evidence instances.

Constructor Summary

Constructors

Constructor	Description
DefaultEvidence(DefaultEvidence evidence)	Initializes a new instance of the DefaultEvidence class, copying data from an existing DefaultEvidence object.
DefaultEvidence(Evidence evidence)	Initializes a new instance of the DefaultEvidence class, and copies the evidence from another instance.
DefaultEvidence(Network network)	Initializes a new instance of the DefaultEvidence class, with the target Bayesian network.

Method Summary

Modifier and Type	Method	Description
void	beginUpdate()	Disables change notifications (if present), until Evidence.endUpdate() is called.
void	clear()	Clears any evidence on all variables.
void	clear(Node node)	Clears evidence on a node's variables.
void	clear(Node node, Integer time)	Clears evidence on a node's single variable.
void	clear(Variable variable)	Clears any evidence on a variable.
void	clear(Variable variable, Integer time)	Clears evidence on a variable at the specified time.
void	copy(Evidence evidence)	Replaces the current evidence, with that from another Evidence instance.
void	copy(Evidence evidence, Variable variable)	Replaces the current evidence for an individual variable, with that from another Evidence instance.
void	copy(Evidence evidence, Variable variable, Integer time)	Replaces the current evidence for an individual variable at a specific time, with that from another Evidence instance.
void	endUpdate()	Enables change notifications (if available).
Double	get(Node node)	Gets the hard evidence value for a particular node's variable, or returns null if the EvidenceType equals EvidenceType.NONE or EvidenceType.SOFT.
void	get(Node node, Double[] destination, int destinationStart, int startTime, int count)	Gets the evidence for a node's single temporal variable.
Double	get(Node node, Integer time)	Gets the evidence for a node with a single variable at the specified time.
Double	get(Variable variable)	Gets the hard evidence for a discrete variable or continuous variable, or returns null if the EvidenceType equals EvidenceType.NONE or EvidenceType.SOFT.
void	get(Variable variable, Double[] destination, int destinationStart, int startTime, int count)	Gets the evidence for a temporal variable.
Double	get(Variable variable, Integer time)	Gets the evidence for a discrete variable at the specified time.
EvidenceType	getEvidenceType(Node node)	Returns the type of evidence currently set for a node with a single variable.
EvidenceType	getEvidenceType(Node node, Integer time)	Returns the type of evidence currently set for a node with a single variable at a given time.
EvidenceType	getEvidenceType(Variable variable)	Returns the type of evidence currently set for a variable (if any).
EvidenceType	getEvidenceType(Variable variable, Integer time)	Returns the type of evidence currently set for a variable at a given time.
EvidenceTypes	getEvidenceTypes(Node node)	Gets the type of evidence (if any) and whether or not it is an intervention (do-operator).
EvidenceTypes	getEvidenceTypes(Node node, Integer time)	Gets the type of evidence (if any) and whether or not it is an intervention (do-operator).
EvidenceTypes	getEvidenceTypes(Variable variable)	Gets the type of evidence (if any) and whether or not it is an intervention (do-operator).
EvidenceTypes	getEvidenceTypes(Variable variable, Integer time)	Gets the type of evidence (if any) and whether or not it is an intervention (do-operator).
double	getLogWeight()	Gets the natural logarithm of Evidence.getWeight().
Integer	getMaxTime()	Gets the maximum time containing evidence.
Integer	getMaxTime(Variable variable)	Gets the maximum time containing evidence for a variable.
Network	getNetwork()	Gets the Bayesian network that is the the target of the evidence.
Integer	getState(Node node)	Gets the hard evidence state for node with a single variable, or returns null if the EvidenceType equals EvidenceType.NONE or EvidenceType.SOFT.
Integer	getState(Node node, Integer time)	Gets the hard evidence state for node with a single variable, or returns null if the EvidenceType equals EvidenceType.NONE or EvidenceType.SOFT.
Integer	getState(Variable variable)	Gets the hard evidence state for a particular variable, or returns null if the EvidenceType equals EvidenceType.NONE or EvidenceType.SOFT.
Integer	getState(Variable variable, Integer time)	Gets the hard evidence state for a particular variable, or returns null if the EvidenceType equals EvidenceType.NONE or EvidenceType.SOFT.
void	getStates(Node node, double[] buffer)	Fills out a buffer containing the soft evidence for a node with a single variable.
void	getStates(Node node, double[] buffer, Integer time)	Fills out a buffer containing the soft evidence for a node with a single variable at a specified time.
void	getStates(Table table)	Fills out a table containing the soft evidence for a particular variable.
void	getStates(Variable variable, double[] buffer)	Fills out a buffer containing the soft evidence for a particular variable.
void	getStates(Variable variable, double[] buffer, Integer time)	Fills out a buffer containing the soft evidence for a particular variable at a specified time.
void	getVariables(Variable[] buffer)	Fills out a buffer with all variables that have either hard or soft evidence.
double	getWeight()	Gets a weight that can be applied to the evidence.
void	load(InputStream input)	Loads evidence from the specified stream.
void	load(String fileName)	Loads evidence from the specified file.
void	loadFromString(String value)	Loads evidence from a string using UTF-8 encoding.
void	loadFromString(String value, String charSetName)	Loads evidence from a string using the specified encoding.
void	save(OutputStream output)	Saves the evidence to the specified stream.
void	save(String fileName)	Saves the specified to the specified file.
String	saveToString()	Saves evidence to a string, with UTF-8 encoding.
String	saveToString(String charSetName)	Saves evidence to a string, with the specified encoding.
void	set(Node node, Double value)	Sets a node's variable to a particular value (hard evidence).
void	set(Node node, Double[] source, int sourceStart, int startTime, int count)	Sets temporal evidence on a node with a single variable.
void	set(Node node, Double value, Integer time)	Sets evidence on a node's single variable at a specified time.
void	set(Variable variable, Double value)	Sets a variable to a particular value (hard evidence).
void	set(Variable variable, Double[] source, int sourceStart, int startTime, int count)	Sets temporal evidence on a variable.
void	set(Variable variable, Double value, Integer time)	Sets evidence on a variable at a specified time.
void	set(Variable variable, Double value, Integer time, InterventionType interventionType)	Sets evidence on the variable, in the form of an intervention (do-operator).
void	setLogWeight(double value)	Sets the natural logarithm of Evidence.getWeight().
void	setState(Node node, Integer state)	Sets evidence on a node with a single discrete variable to a particular state (hard evidence).
void	setState(Node node, Integer state, Integer time)	Sets evidence on a node with a single discrete variable to a particular state (hard evidence) specifiying a time if the node is temporal.
void	setState(State state)	Sets evidence on a discrete state (hard evidence).
void	setState(State state, Integer time)	Sets evidence on a discrete state (hard evidence) at a particular time (zero based).
void	setState(State state, Integer time, InterventionType interventionType)	Sets evidence on a discrete state (hard evidence), in the form of an intervention (do-operator).
void	setState(Variable variable, Integer state)	Sets a discrete variable to a particular state (hard evidence).
void	setState(Variable variable, Integer state, Integer time)	Sets a discrete variable to a particular state (hard evidence), specifiying a time if the state belongs to a variable whose node is temporal.
void	setStates(Node node, double[] values)	Sets soft evidence for a discrete node with a single variable.
void	setStates(Node node, double[] values, Integer time)	Sets soft evidence for a discrete node with a single variable, at a specified time.
void	setStates(Variable variable, double[] values)	Sets soft evidence for a particular discrete variable.
void	setStates(Variable variable, double[] values, Integer time)	Sets soft evidence for a particular discrete variable at a specified time.
void	setWeight(double value)	Sets a weight that can be applied to the evidence.
int	size()	Gets the count of variables with either hard, soft or temporal evidence set.

Methods inherited from class java.lang.Object

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

Constructor Detail

DefaultEvidence

public DefaultEvidence(Network network)

Initializes a new instance of the DefaultEvidence class, with the target Bayesian network.

Parameters:

network - The target Network.

DefaultEvidence

public DefaultEvidence(Evidence evidence)

Initializes a new instance of the DefaultEvidence class, and copies the evidence from another instance.

Parameters:

evidence - The evidence to copy.

DefaultEvidence

public DefaultEvidence(DefaultEvidence evidence)

Initializes a new instance of the DefaultEvidence class, copying data from an existing DefaultEvidence object.

Parameters:

evidence - The evidence.

Method Detail

size

public int size()

Gets the count of variables with either hard, soft or temporal evidence set.

Specified by:

size in interface Evidence

Returns:

The count of variables with evidence.

getNetwork

public Network getNetwork()

Gets the Bayesian network that is the the target of the evidence.

Specified by:

getNetwork in interface Evidence

Returns:

The Network.

getWeight

public double getWeight()

Gets a weight that can be applied to the evidence. Default value is 1. Value must be positive. A weight can be applied to a case, to give it more or less importance during learning or inference. For example, if a database has groups of records that are identical, each group can be represented by a single case with a weight equal to the number in that group.

Note that setting the weight to anything but 1, will effect the QueryOutput.getLogLikelihood() statistic.

Specified by:

getWeight in interface Evidence

setWeight

public void setWeight(double value)

Sets a weight that can be applied to the evidence. Default value is 1. Value must be positive. A weight can be applied to a case, to give it more or less importance during learning or inference. For example, if a database has groups of records that are identical, each group can be represented by a single case with a weight equal to the number in that group.

Note that setting the weight to anything but 1, will effect the QueryOutput.getLogLikelihood() statistic.

Specified by:

setWeight in interface Evidence

getLogWeight

public double getLogWeight()

Gets the natural logarithm of Evidence.getWeight().

Specified by:

getLogWeight in interface Evidence

setLogWeight

public void setLogWeight(double value)

Sets the natural logarithm of Evidence.getWeight().

Specified by:

setLogWeight in interface Evidence

beginUpdate

public void beginUpdate()

Disables change notifications (if present), until Evidence.endUpdate() is called. Calls to Evidence.beginUpdate() can be nested, in which case notifications only continue after the final call to Evidence.endUpdate().

Specified by:

beginUpdate in interface Evidence

clear

public void clear(Variable variable,
                  Integer time)

Clears evidence on a variable at the specified time.

Specified by:

clear in interface Evidence

Parameters:

variable - The variable whose evidence you want to clear.

time - The time at which to clear evidence. Can be null.

clear

public void clear(Node node,
                  Integer time)

Clears evidence on a node's single variable.

Specified by:

clear in interface Evidence

Parameters:

node - A node with a single variable whose evidence you want to clear.

time - The time at which to clear evidence. Can be null.

clear

public void clear(Variable variable)

Clears any evidence on a variable.

Specified by:

clear in interface Evidence

Parameters:

variable - The variable to clear evidence on.

clear

public void clear(Node node)

Clears evidence on a node's variables.

Specified by:

clear in interface Evidence

Parameters:

node - The node whose variables you want to clear evidence on.

Throws:

NullPointerException - [node] is null.

clear

public void clear()

Clears any evidence on all variables.

Specified by:

clear in interface Evidence

copy

public void copy(Evidence evidence)

Replaces the current evidence, with that from another Evidence instance.

Specified by:

copy in interface Evidence

Parameters:

evidence - The source evidence to copy from.

copy

public void copy(Evidence evidence,
                 Variable variable)

Replaces the current evidence for an individual variable, with that from another Evidence instance. For temporal variables, evidence is copied from the source at all times.

Specified by:

copy in interface Evidence

Parameters:

evidence - The source evidence to copy from.

variable - The variable to copy evidence for.

copy

public void copy(Evidence evidence,
                 Variable variable,
                 Integer time)

Replaces the current evidence for an individual variable at a specific time, with that from another Evidence instance.

Specified by:

copy in interface Evidence

Parameters:

evidence - The source evidence to copy from.

variable - The variable to copy evidence for.

time - The time at which to copy evidence.

endUpdate

public void endUpdate()

Enables change notifications (if available). A corresponding call must first be made to Evidence.beginUpdate() to disable notifications.

Specified by:

endUpdate in interface Evidence

get

public Double get(Variable variable)

Gets the hard evidence for a discrete variable or continuous variable, or returns null if the EvidenceType equals EvidenceType.NONE or EvidenceType.SOFT.

Specified by:

get in interface Evidence

Parameters:

variable - The discrete or continuous variable.

Returns:

The evidence for the variable, or null if the EvidenceType does not equal EvidenceType.HARD.

get

public Double get(Variable variable,
                  Integer time)

Gets the evidence for a discrete variable at the specified time.

Specified by:

get in interface Evidence

Parameters:

variable - The variable.

time - The time at which to retrieve evidence. Can be null.

Returns:

The evidence for the variable at the specified time.

get

public Double get(Node node,
                  Integer time)

Gets the evidence for a node with a single variable at the specified time.

Specified by:

get in interface Evidence

Parameters:

node - A node with a single variable.

time - The time to retrieve evidence for. Can be null.

Returns:

The evidence. Can be null.

get

public void get(Variable variable,
                Double[] destination,
                int destinationStart,
                int startTime,
                int count)

Gets the evidence for a temporal variable.

Specified by:

get in interface Evidence

Parameters:

variable - The temporal variable.

destination - The destination buffer which will be filled with the evidence values.

destinationStart - The position in the buffer to start copying.

startTime - The time to start copying from.

count - The number of evidence values to copy.

get

public void get(Node node,
                Double[] destination,
                int destinationStart,
                int startTime,
                int count)

Gets the evidence for a node's single temporal variable.

Specified by:

get in interface Evidence

Parameters:

node - A node with a single temporal variable.

destination - The destination buffer which will be filled with the evidence values.

destinationStart - The position in the buffer to start copying.

startTime - The time to start copying from.

count - The number of evidence values to copy.

get

public Double get(Node node)

Gets the hard evidence value for a particular node's variable, or returns null if the EvidenceType equals EvidenceType.NONE or EvidenceType.SOFT.

Specified by:

get in interface Evidence

Parameters:

node - A node with a single variable in question.

Returns:

The evidence value for the node's variable, or null if the EvidenceType does not equal EvidenceType.HARD.

getEvidenceType

public EvidenceType getEvidenceType(Variable variable)

Returns the type of evidence currently set for a variable (if any).

Specified by:

getEvidenceType in interface Evidence

Parameters:

variable - The variable in question.

Returns:

The EvidenceType.

getEvidenceType

public EvidenceType getEvidenceType(Node node)

Returns the type of evidence currently set for a node with a single variable.

Specified by:

getEvidenceType in interface Evidence

Parameters:

node - The node in question.

Returns:

The EvidenceType.

getEvidenceType

public EvidenceType getEvidenceType(Node node,
                                    Integer time)

Returns the type of evidence currently set for a node with a single variable at a given time.

Specified by:

getEvidenceType in interface Evidence

Parameters:

node - The node in question.

time - The time at which evidence is set. Can be null.

Returns:

The EvidenceType.

getEvidenceType

public EvidenceType getEvidenceType(Variable variable,
                                    Integer time)

Returns the type of evidence currently set for a variable at a given time.

Specified by:

getEvidenceType in interface Evidence

Parameters:

variable - The variable in question.

time - The time at which evidence is set. Can be null.

Returns:

The EvidenceType.

getEvidenceTypes

public EvidenceTypes getEvidenceTypes(Variable variable)

Gets the type of evidence (if any) and whether or not it is an intervention (do-operator).

Specified by:

getEvidenceTypes in interface Evidence

Parameters:

variable - The variable in question.

Returns:

The EvidenceTypes.

getEvidenceTypes

public EvidenceTypes getEvidenceTypes(Node node)

Gets the type of evidence (if any) and whether or not it is an intervention (do-operator).

Specified by:

getEvidenceTypes in interface Evidence

Parameters:

node - The node in question.

Returns:

The EvidenceTypes.

getEvidenceTypes

public EvidenceTypes getEvidenceTypes(Node node,
                                      Integer time)

Gets the type of evidence (if any) and whether or not it is an intervention (do-operator).

Specified by:

getEvidenceTypes in interface Evidence

Parameters:

node - The node in question.

time - The time at which evidence is set. Can be null.

Returns:

The EvidenceTypes.

getEvidenceTypes

public EvidenceTypes getEvidenceTypes(Variable variable,
                                      Integer time)

Gets the type of evidence (if any) and whether or not it is an intervention (do-operator).

Specified by:

getEvidenceTypes in interface Evidence

Parameters:

variable - The variable in question.

time - The time at which evidence is set. Can be null.

Returns:

The EvidenceTypes.

getMaxTime

public Integer getMaxTime(Variable variable)

Gets the maximum time containing evidence for a variable.

Specified by:

getMaxTime in interface Evidence

Parameters:

variable - The variable to check.

Returns:

The maximum zero based time at which evidence is present for the variable or null if no evidence is present.

getMaxTime

public Integer getMaxTime()

Gets the maximum time containing evidence.

Specified by:

getMaxTime in interface Evidence

Returns:

The maximum zero based time at which evidence is present for any variable or null if no evidence is present.

getState

public Integer getState(Variable variable)

Gets the hard evidence state for a particular variable, or returns null if the EvidenceType equals EvidenceType.NONE or EvidenceType.SOFT.

Specified by:

getState in interface Evidence

Parameters:

variable - The variable.

Returns:

The zero based index of the State with hard evidence set, or null if the EvidenceType does not equal EvidenceType.HARD..

getState

public Integer getState(Variable variable,
                        Integer time)

Gets the hard evidence state for a particular variable, or returns null if the EvidenceType equals EvidenceType.NONE or EvidenceType.SOFT.

Specified by:

getState in interface Evidence

Parameters:

variable - The variable.

time - Time at which to retrieve evidence, if the variable belongs to a temporal node, otherwise null.

Returns:

The zero based index of the State with hard evidence set, or null if the EvidenceType does not equal EvidenceType.HARD..

getState

public Integer getState(Node node)

Gets the hard evidence state for node with a single variable, or returns null if the EvidenceType equals EvidenceType.NONE or EvidenceType.SOFT.

Specified by:

getState in interface Evidence

Parameters:

node - The node with a single discrete variable.

Returns:

The zero based index of the State with hard evidence set, or null if the EvidenceType does not equal EvidenceType.HARD..

getState

public Integer getState(Node node,
                        Integer time)

Gets the hard evidence state for node with a single variable, or returns null if the EvidenceType equals EvidenceType.NONE or EvidenceType.SOFT.

Specified by:

getState in interface Evidence

Parameters:

node - The node with a single discrete variable.

time - Time at which to retrieve evidence, if the node is temporal, otherwise null.

Returns:

The zero based index of the State with hard evidence set, or null if the EvidenceType does not equal EvidenceType.HARD..

getStates

public void getStates(Variable variable,
                      double[] buffer)

Fills out a buffer containing the soft evidence for a particular variable. If the variable does not have soft evidence, the method will succeed, however it is better to use another version of Get. The resulting values will depend on the current EvidenceType for the variable:EvidenceType.NONE - All values will equal 1.EvidenceType.HARD - All values will equal 0, except at the hard evidence state, where the value will equal 1.EvidenceType.NONE - The soft evidence values will be used.

Specified by:

getStates in interface Evidence

Parameters:

variable - The variable to retrieve evidence for.

buffer - A buffer whose values are replaced with the current evidence.

getStates

public void getStates(Node node,
                      double[] buffer)

Fills out a buffer containing the soft evidence for a node with a single variable. If the variable does not have soft evidence, the method will succeed, however it is better to use another version of Get. The resulting values will depend on the current EvidenceType for the variable:EvidenceType.NONE - All values will equal 1.EvidenceType.HARD - All values will equal 0, except at the hard evidence state, where the value will equal 1.EvidenceType.NONE - The soft evidence values will be used.

Specified by:

getStates in interface Evidence

Parameters:

node - A node with a single variable to retrieve evidence for.

buffer - A buffer whose values are replaced with the current evidence.

getStates

public void getStates(Table table)

Fills out a table containing the soft evidence for a particular variable. If the variable does not have soft evidence, the method will succeed, however it is better to use another version of Get. The resulting values will depend on the current EvidenceType for the variable:EvidenceType.NONE - All values will equal 1.EvidenceType.HARD - All values will equal 0, except at the hard evidence state, where the value will equal 1.EvidenceType.NONE - The soft evidence values will be used.

Specified by:

getStates in interface Evidence

Parameters:

table - A Table containing a single Variable.

getStates

public void getStates(Node node,
                      double[] buffer,
                      Integer time)

Fills out a buffer containing the soft evidence for a node with a single variable at a specified time. If the variable does not have soft evidence, the method will succeed, however it is better to use another version of Get. The resulting values will depend on the current EvidenceType for the variable:EvidenceType.NONE - All values will equal 1.EvidenceType.HARD - All values will equal 0, except at the hard evidence state, where the value will equal 1.EvidenceType.NONE - The soft evidence values will be used.

Specified by:

getStates in interface Evidence

Parameters:

node - A node with a single variable to retrieve evidence for.

buffer - A buffer whose values are replaced with the current evidence.

time - The time at which to retrieve evidence. Can be null. Used by Dynamic Bayesian networks.

getStates

public void getStates(Variable variable,
                      double[] buffer,
                      Integer time)

Fills out a buffer containing the soft evidence for a particular variable at a specified time. If the variable does not have soft evidence, the method will succeed, however it is better to use another version of Get. The resulting values will depend on the current EvidenceType for the variable:EvidenceType.NONE - All values will equal 1.EvidenceType.HARD - All values will equal 0, except at the hard evidence state, where the value will equal 1.EvidenceType.NONE - The soft evidence values will be used.

Specified by:

getStates in interface Evidence

Parameters:

variable - The variable to retrieve evidence for.

buffer - A buffer whose values are replaced with the current evidence.

time - The time at which to retrieve evidence. Can be null. Used by Dynamic Bayesian networks.

getVariables

public void getVariables(Variable[] buffer)

Fills out a buffer with all variables that have either hard or soft evidence. The buffer must have length equal to or greater than the current Evidence.size().

Specified by:

getVariables in interface Evidence

Parameters:

buffer - A container for any variables with evidence. It must have length equal to or greater than the current Evidence.size().

load

public void load(InputStream input)
          throws XMLStreamException

Loads evidence from the specified stream.

Specified by:

load in interface Evidence

Parameters:

input - The input stream.

Throws:

XMLStreamException

load

public void load(String fileName)
          throws IOException,
                 XMLStreamException

Loads evidence from the specified file.

Specified by:

load in interface Evidence

Parameters:

fileName - Name of the file.

Throws:

IOException

XMLStreamException

save

public void save(OutputStream output)
          throws XMLStreamException

Saves the evidence to the specified stream.

Specified by:

save in interface Evidence

Parameters:

output - The output stream.

Throws:

XMLStreamException

save

public void save(String fileName)
          throws IOException,
                 XMLStreamException

Saves the specified to the specified file.

Specified by:

save in interface Evidence

Parameters:

fileName - Name of the file.

Throws:

IOException

XMLStreamException

saveToString

public String saveToString(String charSetName)
                    throws XMLStreamException

Saves evidence to a string, with the specified encoding.

Specified by:

saveToString in interface Evidence

Parameters:

charSetName - The encoding to use.

Returns:

The evidence persisted to a string.

Throws:

XMLStreamException

saveToString

public String saveToString()
                    throws XMLStreamException

Saves evidence to a string, with UTF-8 encoding.

Specified by:

saveToString in interface Evidence

Returns:

The evidence persisted to a string.

Throws:

XMLStreamException

loadFromString

public void loadFromString(String value,
                           String charSetName)
                    throws UnsupportedEncodingException,
                           XMLStreamException

Loads evidence from a string using the specified encoding.

Specified by:

loadFromString in interface Evidence

Parameters:

value - The persisted string value of the evidence.

charSetName - The encoding the evidence was originally saved in.

Throws:

UnsupportedEncodingException

XMLStreamException

loadFromString

public void loadFromString(String value)
                    throws UnsupportedEncodingException,
                           XMLStreamException

Loads evidence from a string using UTF-8 encoding.

Specified by:

loadFromString in interface Evidence

Parameters:

value - The persisted string value of the evidemce.

Throws:

UnsupportedEncodingException

XMLStreamException

set

public void set(Variable variable,
                Double[] source,
                int sourceStart,
                int startTime,
                int count)

Sets temporal evidence on a variable.

Specified by:

set in interface Evidence

Parameters:

variable - The variable to set evidence on.

source - The evidence values.

sourceStart - The position in [source] to start copying from.

startTime - The time to start copying at.

count - The number of values to copy.

set

public void set(Node node,
                Double[] source,
                int sourceStart,
                int startTime,
                int count)

Sets temporal evidence on a node with a single variable.

Specified by:

set in interface Evidence

Parameters:

node - A node with a single variable to set evidence on.

source - The evidence values.

sourceStart - The position in [source] to start copying from.

startTime - The time to start copying at.

count - The number of values to copy.

set

public void set(Variable variable,
                Double value)

Sets a variable to a particular value (hard evidence).

Specified by:

set in interface Evidence

Parameters:

variable - The variable to set evidence on.

value - The value to set, or null to clear the evidence.

set

public void set(Node node,
                Double value,
                Integer time)

Sets evidence on a node's single variable at a specified time.

Specified by:

set in interface Evidence

Parameters:

node - A node with a single variable to set evidence on.

value - The value to set, or null to clear the evidence.

time - The time at which to set evidence. Can be null.

set

public void set(Variable variable,
                Double value,
                Integer time)

Sets evidence on a variable at a specified time.

Specified by:

set in interface Evidence

Parameters:

variable - The variable to set evidence on.

value - The value to set, or null to clear the evidence.

time - The time at which to set evidence. Can be null.

set

public void set(Variable variable,
                Double value,
                Integer time,
                InterventionType interventionType)

Sets evidence on the variable, in the form of an intervention (do-operator).

Specified by:

set in interface Evidence

Parameters:

variable - The variable to set evidence on.

value - The value to set, or null to clear the evidence.

time - The time at which to set evidence, if the node is temporal, otherwise null.

interventionType - Whether or not the evidence is an intervention.

set

public void set(Node node,
                Double value)

Sets a node's variable to a particular value (hard evidence).

Specified by:

set in interface Evidence

Parameters:

node - A node with a single variable to set evidence on.

value - The value to set, or null to clear the evidence.

setState

public void setState(Variable variable,
                     Integer state)

Sets a discrete variable to a particular state (hard evidence).

Specified by:

setState in interface Evidence

Parameters:

variable - The discrete variable to set evidence on.

state - The zero based index of the state to set, or null to clear the evidence.

setState

public void setState(Variable variable,
                     Integer state,
                     Integer time)

Sets a discrete variable to a particular state (hard evidence), specifiying a time if the state belongs to a variable whose node is temporal.

Specified by:

setState in interface Evidence

Parameters:

variable - The discrete variable to set evidence on.

state - The zero based index of the state to set, or null to clear the evidence.

time - The time at which to set evidence, if the state belongs to a variable whose node is temporal, otherwise null.

setState

public void setState(State state)

Sets evidence on a discrete state (hard evidence).

Specified by:

setState in interface Evidence

Parameters:

state - The state to set, cannot be null.

setState

public void setState(State state,
                     Integer time,
                     InterventionType interventionType)

Sets evidence on a discrete state (hard evidence), in the form of an intervention (do-operator).

Specified by:

setState in interface Evidence

Parameters:

state - The state to set, cannot be null.

time - The time at which to set evidence, if the node is temporal, otherwise null.

interventionType - Whether or not the evidence is an intervention.

setState

public void setState(State state,
                     Integer time)

Sets evidence on a discrete state (hard evidence) at a particular time (zero based).

Specified by:

setState in interface Evidence

Parameters:

state - The state to set, cannot be null.

time - The time at which to set evidence, if the node is temporal, otherwise null.

setState

public void setState(Node node,
                     Integer state)

Sets evidence on a node with a single discrete variable to a particular state (hard evidence).

Specified by:

setState in interface Evidence

Parameters:

node - The node with a single discrete variable to set evidence on.

state - The zero based index of the state to set, or null to clear the evidence.

setState

public void setState(Node node,
                     Integer state,
                     Integer time)

Sets evidence on a node with a single discrete variable to a particular state (hard evidence) specifiying a time if the node is temporal.

Specified by:

setState in interface Evidence

Parameters:

node - The node with a single discrete variable to set evidence on.

state - The zero based index of the state to set, or null to clear the evidence.

time - The time at which to set evidence, if the node is temporal, otherwise null.

setStates

public void setStates(Variable variable,
                      double[] values)

Sets soft evidence for a particular discrete variable. If the evidence [values] are not actual soft evidence (e.g. {1, 0, 0} or {1, 1, 1} then the evidence will be stored correctly but the EvidenceType will not be EvidenceType.SOFT.

Specified by:

setStates in interface Evidence

Parameters:

variable - The variable to set evidence on.

values - An array of soft evidence values.

setStates

public void setStates(Node node,
                      double[] values)

Sets soft evidence for a discrete node with a single variable. If the evidence [values] are not actual soft evidence (e.g. {1, 0, 0} or {1, 1, 1} then the evidence will be stored correctly but the EvidenceType will not be EvidenceType.SOFT.

Specified by:

setStates in interface Evidence

Parameters:

node - The node with a single variable to set evidence on.

values - An array of soft evidence values.

setStates

public void setStates(Node node,
                      double[] values,
                      Integer time)

Sets soft evidence for a discrete node with a single variable, at a specified time. If the evidence [values] are not actual soft evidence (e.g. {1, 0, 0} or {1, 1, 1} then the evidence will be stored correctly but the EvidenceType will not be EvidenceType.SOFT.

Specified by:

setStates in interface Evidence

Parameters:

node - The node with a single variable to set evidence on.

values - An array of soft evidence values.

time - The time at which to set evidence. Can be null. Used by Dynamic Bayesian networks.

setStates

public void setStates(Variable variable,
                      double[] values,
                      Integer time)

Sets soft evidence for a particular discrete variable at a specified time. If the evidence [values] are not actual soft evidence (e.g. {1, 0, 0} or {1, 1, 1} then the evidence will be stored correctly but the EvidenceType will not be EvidenceType.SOFT.

Specified by:

setStates in interface Evidence

Parameters:

variable - The variable to set evidence on.

values - An array of soft evidence values.

time - The time at which to set evidence. Can be null. Used by Dynamic Bayesian networks.