void EnterNodeLikelihood_bn ( node_bn*  node,   const prob_bn*  likelihood )

Enters a likelihood finding for node, which is a finding that is not completely certain (it is sometimes called "virtual evidence").

likelihood is a vector containing one probability for each state of node.

node must be a discrete or discretized nature node (i.e. not a utility or decision node).

By calling it several times, you can combine the effects of several independent partial observations. If you don't want the likelihood findings to accumulate, call RetractNodeFindings_bn between calls.

The likelihood finding is equivalent to the following scenario:

   Notice that each component of a likelihood vector is between 0 and 1 inclusive, they must not all be zero, and they aren't required to sum to 1.

If you enter several accumulating likelihood findings for a node, they should correspond to observations that are independent given the value of the node (if not, look up "likelihood finding, not independent" in the index).

If the net has auto-updating (see SetNetAutoUpdate_bn), then a belief updating will be done to reflect the new finding before this function returns (otherwise it will just be done when needed).

Version:

This function is available in all versions.

See also:

EnterFinding_bn  To enter a certain finding that a node is in some state
EnterFindingNot_bn  To indicate that node isn't in some state
GetNodeLikelihood_bn  To retrieve the likelihood finding entered
RetractNodeFindings_bn  To remove the findings entered

Example:

See GetNodeFinding_bn