cdfBinomialInv
==============================================
Purpose
----------------
Computes the binomial quantile or inverse cumulative distribution function.
Format
----------------
.. function:: s = cdfBinomialInv(p, trials, prob)
:param p: Probabilities at which to compute the inverse of the Binomial cumulative distribution function. :math:`0 \lt p \lt 1`.
:type p: NxK matrix, Nx1 vector or scalar
:param trials: ExE conformable with *p*. :math:`trials > 0`.
:type trials: LxM matrix
:param prob: The probability of *success* on any given trial. ExE conformable with *p*. :math:`0 < prob < 1`.
:type prob: PxQ matrix
:return s: The number of successes.
:rtype s: NxK matrix, Nx1 vector or scalar
Examples
----------------
What is a reasonable range of wins for a basketball team playing 82 games in a season, with a 60% chance of winning any game?
For our example we will define a reasonable range as falling between the top and bottom deciles.
::
// Probability range
range = { .10, .9 };
// Number of trials
trials = 82;
// Probabiliy of success
prob = 0.6
// Call cdfBinomialInv
s = cdfBinomialInv(range, trials, prob);
print "s = " s;
After above code,
::
s =
43
55
This means that a team with a 60% chance of winning any one game would win between 43 and 55 games in 80% of seasons.
Remarks
-----------
For invalid inputs, :func:`cdfBinomialInv` will return a scalar error code
which, when its value is assessed by function :func:`scalerr`, corresponds to
the invalid input. If the first input is out of range, :func:`scalerr` will
return a 1; if the second is out of range, :func:`scalerr` will return a 2; etc.
.. seealso:: Functions :func:`cdfBinomial`, :func:`pdfBinomial`, :func:`cdfNegBinomial`, :func:`cdfNegBinomialInv`