R.PF Function (Gnumeric)
Evaluate F-distribution probabilities in Gnumeric with R.PF. Choose the correct tail and degree order, use natural logs, and check zero and error boundaries.
Verification status: 21 reference, boundary and advanced-check formulas were recalculated with Gnumeric 1.12.57 ssconvert. Saved identities, the blank input and numerical results were independently checked. Gnumeric 1.12.62 was source-checked only. How formula examples are checked
Quick answer: =R.PF(1,2,2) gives 0.5 in Gnumeric 1.12.57.
Availability and version history
- Introduced: First release not established; present in the retained 1.12.57 source.
- Supported in: Gnumeric 1.12.62; no retirement is established.
- Scope: Desktop Gnumeric with its Statistical Functions From R plugin. English comma-separated formulas are shown.
- Checked: October 14, 2026. Tables and the named advanced check use 1.12.57 ssconvert. Current 1.12.62 source was inspected; that release was not executed.
What R.PF returns
R.PF returns the lower cumulative F probability by default. FALSE selects the upper tail. The first degree belongs to the numerator of the F ratio, and the second to the denominator. Versioned function help.
Syntax and arguments
=R.PF(x,numerator_df,denominator_df[,lower_tail[,log_p]])
- x: real cutoff; at or below zero the lower probability is zero.
- numerator_df, denominator_df: required positive real parameters.
- lower_tail: optional TRUE for the lower cumulative probability; FALSE requests the upper tail.
- log_p: optional FALSE. TRUE uses natural-log probabilities, not base-10 logarithms.
Brackets mark optional arguments; do not type them. Current worksheet implementation.
Reproducible examples
These self-contained formulas were recalculated natively. Ordinary-domain results were checked against independent mathematics; source guards explain the boundary cases. Results are rounded to twelve decimal places, or thirteen significant digits for small nonzero values. This is presentation precision, not a universal accuracy guarantee.
| Formula | Gnumeric 1.12.57 result |
|---|---|
=R.PF(1,2,2) |
0.5 |
=R.PF(2,2,2) |
0.666666666667 |
=R.PF(.5,2,2) |
0.333333333333 |
=R.PF(1.5,2,3) |
0.646446609407 |
=R.PF(1,2.5,7.5) |
0.56985813401 |
=R.PF(2,2,2,FALSE()) |
0.333333333333 |
=R.PF(2,2,2,TRUE(),TRUE()) |
-0.405465108108 |
=R.PF(2,2,2,FALSE(),TRUE()) |
-1.098612288668 |
Practical worksheet
With degrees 2 and 2, the CDF is x/(1+x) for x≥0. At x=2, R.PF gives 2/3; the upper-tail mode gives 1/3. The result is a probability, unlike the density returned by R.DF.
For an F statistic constructed as a specified sample-variance ratio, pass the matching sample-count-minus-one degrees in that same order. An upper-tail probability can be relevant to a pre-specified directional variance comparison, but this function does not choose or perform the entire test for you.
Advanced interpretation and checks
The beta representation uses z=d1x/(d2+d1x) and shapes d1/2,d2/2. It explains why the argument is not a raw beta probability. Direct upper-tail evaluation avoids subtracting a near-one result when the desired probability is small.
For positive x, reciprocity gives F(x;d1,d2)+F(1/x;d2,d1)=1. The saved check uses x=2, d1=5 and d2=10. For the simple degrees-2 model, the interval 0.5<X≤2 has probability 2/3−1/3=1/3.
The saved advanced-check result for =R.PF(2,5,10)+R.PF(.5,10,5) was 1.
Boundaries and troubleshooting
Zero and negative cutoffs return lower probability zero; the corresponding upper probability is one. Their log probabilities are respectively negative infinity, displayed as #NUM!, and zero. Invalid nonpositive degrees are rejected rather than treated as a zero-cutoff shortcut.
Fractional positive degrees are retained. Empty F5 becomes zero, nonnumeric text produces #VALUE!, and missing or extra arguments produce #N/A. Log mode reports LN(probability), so its negative output should not be formatted as an ordinary probability percentage.
F5 is genuinely empty, rather than a cell containing an empty string.
| Formula | Gnumeric 1.12.57 result |
|---|---|
=R.PF(-1,2,3) |
0 |
=R.PF(0,2,3) |
0 |
=R.PF(0,2,3,TRUE(),TRUE()) |
#NUM! |
=R.PF(0,2,3,FALSE(),TRUE()) |
0 |
=R.PF(1,0,3) |
#NUM! |
=R.PF(1,2,0) |
#NUM! |
=R.PF(1,-1,3) |
#NUM! |
=R.PF(1,2,-1) |
#NUM! |
=R.PF("abc",2,3) |
#VALUE! |
=R.PF(F5,2,3) |
0 |
=R.PF(1,2) |
#N/A |
=R.PF(1,2,3,1,0,1) |
#N/A |
Official evidence and checking scope
- Current worksheet callback
- Tested-version worksheet callback
- Current pf calculation
- Tested-version pf calculation
- Nonfinite worksheet-value handling
- Statistical Functions From R plugin declaration
The relevant complete worksheet callback and main calculation helper are unchanged between the inspected versions. That does not establish later-version numerical execution. Both stale and uncached SUM controls recalculated correctly. Native XML preserves the R.* identities. The secondary ODF export keeps these calls in the ORG.GNUMERIC namespace; it does not establish execution in another product. GUI entry, other locales and other spreadsheet products were not tested.