Examples of aima.core.probability.CategoricalDistribution.multiplyBy()

• aima.core.probability.CategoricalDistribution.multiplyBy()
  Multiplication of this Distribution by a given multiplier, creating a new Distribution representing the product of the two. Note: Is equivalent to pointwise product calculation on factors.
  
  see: AIMA3e Figure 14.10 page 527.
  
  Note: Default Distribution multiplication is not commutative. The reason is because the order of the variables comprising a Distribution dictate the ordering of the values for that distribution. For example (the General case of Baye's rule, AIMA3e pg. 496), using this API method:
  
  P(Y | X) = (P(X | Y)P(Y))/P(X)
  
  is NOT true, due to multiplication of distributions not being commutative. However:
  
  P(Y | X) = (P(Y)P(X | Y))/P(X)
  
  is true, using this API.
  
  The default order of the variable of the Distribution returned is the order of the variables as they are seen, as read from the left to right term, for e.g.:
  
  P(Y)P(X | Y)
  
  would give a Distribution of the following form:
  Y, X
  
  i.e. an ordered union of the variables from the two distributions.
  To override the default order of the product use multiplyByPOS(). @param multiplier @return a new Distribution representing the product of this and thepassed in multiplier. The order of the variables comprising the product distribution is the ordered union of the left term (this) and the right term (multiplier). @see CategoricalDistribution#multiplyByPOS(CategoricalDistribution,RandomVariable)