BETADIST Function (Gnumeric)
BETADIST returns the left-tail cumulative probability of a beta model on a bounded interval.
Verification status: Selected formulas were recalculated with Gnumeric 1.12.57 using ssconvert and retained workbook results. Gnumeric 1.12.62 was source-checked only; this does not establish every edge case. How formula examples are checked
Quick answer: =BETADIST(0.2,2,3) returns approximately 0.1808. BETADIST returns the left-tail cumulative probability of a beta model on a bounded interval. It calculates the modeled probability that a value is at or below x; this legacy spelling has no density selector.
Availability and version history
- Introduced: Gnumeric 0.25, explicitly listed among the new functions in its release notes.
- Availability: Supported in Gnumeric 1.12.62 according to its function-specific registration. No retirement endpoint is established.
- Scope: Desktop Gnumeric with the fn-stat module enabled. Examples use English comma-separated formulas.
- Checked: October 14, 2026. Reference and boundary tables were recalculated by Gnumeric 1.12.57 and checked independently. The 1.12.62 contract was source-checked, not executed.
What the result means
For z=(x−a)/(b−a), the result is the regularized beta integral I_z(alpha,beta). On the standard interval, the density is proportional to z^(alpha−1)(1−z)^(beta−1). Although the help labels alpha and beta as scale parameters, they are the two shape parameters; the bounds supply the measurement scale. Official BETADIST reference.
Syntax and arguments
=BETADIST(x,alpha,beta [, a [, b]])
| Argument | Meaning |
|---|---|
| x | Value within the interval from a to b. |
| alpha, beta | Strictly positive shape parameters. |
| a, b | Optional lower and upper bounds; defaults are 0 and 1. |
Only the two interval bounds are optional. Brackets indicate optional arguments and are not typed. Use numeric cells or numeric inputs. The formulas use decimal points and commas; localized entry conventions require separate checks. Gnumeric 1.12.62 help and evaluator.
Reproducible examples
Enter each formula in a separate cell. The displayed references are rounded to twelve decimal places and agree with the recorded Gnumeric 1.12.57 recalculation within ordinary floating-point precision. Keep the stored result for subsequent calculations.
| Formula | Result, approximately |
|---|---|
=BETADIST(0.2,2,3) |
0.1808 |
=BETADIST(0.5,2,3) |
0.6875 |
=BETADIST(0.8,2,3) |
0.9728 |
=BETADIST(0,2,3) |
0 |
=BETADIST(1,2,3) |
1 |
=BETADIST(0.5,1,1) |
0.5 |
=BETADIST(14,2,3,10,20) |
0.5248 |
=BETADIST(0.12,2,3) |
0.07319808 |
Practical worksheet
Put threshold 0.5 in A2, shape 2 in B2 and shape 3 in C2. In D2 enter =BETADIST(A2,B2,C2), which gives 0.6875. This is the probability at or below 0.5, not a density of 0.6875 at that exact point. The complementary probability above 0.5 is =1-D2, or 0.3125.
Label B2 and C2 as shapes rather than observed mean and standard deviation. With alpha=2 and beta=3, the standard-interval mean is alpha/(alpha+beta)=0.4; entering 0.4 as alpha would specify a different model.
Advanced examples and checks
Change the measurement interval
Suppose the modeled quantity ranges from 10 to 20. =BETADIST(14,2,3,10,20) evaluates the same standardized point as =BETADIST(0.4,2,3) and gives 0.5248. Standardize the threshold together with the bounds; changing only x changes the probability.
For a central band, subtract two cumulative values with identical shapes and bounds. =BETADIST(0.8,2,3)-BETADIST(0.2,2,3) gives 0.792. A probability over an interval is a difference of CDFs, not a difference of beta-density heights.
Boundaries and common mistakes
The release rejects x outside [a,b], nonpositive shapes and a≥b with #NUM!. The endpoints themselves are valid: x=a returns 0 and x=b returns 1. There is no optional cumulative argument in this spelling; use the separately documented BETA.DIST contract if a density is needed. Bounds may be negative, provided a<b and x lies inside them.
The following are observed cell results from the same 1.12.57 command-line recalculation. F5 was genuinely empty. A blank is not necessarily an omitted argument or a valid observation, so validate required data instead of treating every defaulted zero as intentional.
| Formula | Observed in Gnumeric 1.12.57 |
|---|---|
=BETADIST(-0.1,2,3) |
#NUM! |
=BETADIST(0.5,0,3) |
#NUM! |
=BETADIST(0.5,2,3,1,1) |
#NUM! |
=BETADIST(F5,2,3) |
0 |
The fixtures do not certify every locale, extreme tail, imported type or newer binary build. The current wrapper agrees with the documented argument contract; shared numerical helpers can change between releases.