Method Detail

• createInterval

  ConfidenceInterval createInterval(int numberOfTrials,
                                  int numberOfSuccesses,
                                  double confidenceLevel)
                                    throws NotStrictlyPositiveException,
                                           NotPositiveException,
                                           NumberIsTooLargeException,
                                           OutOfRangeException

  Create a confidence interval for the true probability of success of an unknown binomial distribution with the given observed number of trials, successes and confidence level.

  Preconditions:

  • numberOfTrials must be positive
  • numberOfSuccesses may not exceed numberOfTrials
  • confidenceLevel must be strictly between 0 and 1 (exclusive)

  Parameters:

  numberOfTrials - number of trials

  numberOfSuccesses - number of successes

  confidenceLevel - desired probability that the true probability of success falls within the returned interval

  Returns:

  Confidence interval containing the probability of success with probability confidenceLevel

  Throws:

  NotStrictlyPositiveException - if numberOfTrials <= 0.

  NotPositiveException - if numberOfSuccesses < 0.

  NumberIsTooLargeException - if numberOfSuccesses > numberOfTrials.

  OutOfRangeException - if confidenceLevel is not in the interval (0, 1).