aima.core.probability.ProbabilityDistribution Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of aima-core Show documentation

AIMA-Java Core Algorithms from the book Artificial Intelligence a Modern Approach 3rd Ed.

There is a newer version: 3.0.0

package aima.core.probability;

import java.util.Set;

import aima.core.probability.proposition.AssignmentProposition;

/**
 * Artificial Intelligence A Modern Approach (3rd Edition): page 487.

 * 

 * A probability distribution is a function that assigns probabilities to events
 * (sets of possible worlds).

 * 

 * Note: This definition is slightly different than that given in AIMA3e
 * pg. 487, which in this API corresponds to a CategoricalDistribution.
 * 
 * @see Probability Distribution
 * 
 * @author Ciaran O'Reilly
 */
public interface ProbabilityDistribution {
	/**
	 * @return a consistent ordered Set (e.g. LinkedHashSet) of the random
	 *         variables this probability distribution is for.
	 */
	Set getFor();

	/**
	 * 
	 * @param rv
	 *            the Random Variable to be checked.
	 * @return true if this Distribution is for the passed in Random Variable,
	 *         false otherwise.
	 */
	boolean contains(RandomVariable rv);

	/**
	 * Get the value for the provided set of values for the random variables
	 * comprising the Distribution (ordering and size of each must equal and
	 * their domains must match).
	 * 
	 * @param eventValues
	 *            the values for the random variables comprising the
	 *            Distribution
	 * @return the value for the possible worlds associated with the assignments
	 *         for the random variables comprising the Distribution.
	 */
	double getValue(Object... eventValues);

	/**
	 * Get the value for the provided set of AssignmentPropositions for the
	 * random variables comprising the Distribution (size of each must equal and
	 * their random variables must match).
	 * 
	 * @param eventValues
	 *            the assignment propositions for the random variables
	 *            comprising the Distribution
	 * @return the value for the possible worlds associated with the assignments
	 *         for the random variables comprising the Distribution.
	 */
	double getValue(AssignmentProposition... eventValues);
}