IGAMMA Function (Gnumeric)
Calculate incomplete gamma values with Gnumeric IGAMMA. Choose lower or upper tails, regularization and real or imaginary components with checked examples.
Verification status: 17 reference, boundary and advanced-check formulas were recalculated with Gnumeric 1.12.57 ssconvert. Retained native records and independent calculations were checked. Version 1.12.62 was source-checked only. How formula examples are checked
Quick answer: =IGAMMA(3,2) gives 0.323323583817 in the tested Gnumeric 1.12.57 build.
Availability and version history
- Introduced: Gnumeric 1.12.10 release notes explicitly record this function being added.
- Supported in: Gnumeric 1.12.62; no retirement is established.
- Scope: Desktop Gnumeric with the Mathematics plugin. English comma-separated formulas are shown.
- Checked: October 14, 2026. Tables and the named advanced check were recalculated through 1.12.57 ssconvert. Current 1.12.62 source was inspected; the later release was not executed.
What IGAMMA returns
For positive a and nonnegative x, the lower incomplete gamma integral runs from 0 to x, while the upper integral runs from x to infinity. IGAMMA defaults to the lower result divided by Γ(a). This regularized value is often written P(a,x); its upper counterpart is Q(a,x). The final argument selects one real-valued component when the result is complex. Versioned function help.
Syntax and arguments
=IGAMMA(a,x[,lower[,regularize[,real]]])
| Argument | Meaning |
|---|---|
a |
Shape parameter. Use positive values for the ordinary gamma-integral/probability interpretation. |
x |
Integration limit. Nonnegative values keep that ordinary interpretation. |
lower |
TRUE, the default, selects the lower integral; FALSE selects the upper. |
regularize |
TRUE, the default, divides by Γ(a); FALSE leaves the integral unnormalized. |
real |
TRUE, the default, returns the real component; FALSE returns the imaginary component. |
Brackets mark optional arguments; do not type the brackets. Function implementation.
Reproducible examples
Ordinary results are rounded to twelve decimal places; tiny values use scientific notation. The eight reference rows were independently checked.
| Formula | Gnumeric 1.12.57 result |
|---|---|
=IGAMMA(2,1) |
0.264241117657 |
=IGAMMA(3,2) |
0.323323583817 |
=IGAMMA(2,1,FALSE()) |
0.735758882343 |
=IGAMMA(3,2,TRUE(),FALSE()) |
0.646647167634 |
=IGAMMA(0.5,1) |
0.84270079295 |
=IGAMMA(5,0) |
0 |
=IGAMMA(2,1,TRUE(),TRUE(),FALSE()) |
0 |
=IGAMMA(3,2,FALSE(),FALSE()) |
1.353352832366 |
Practical worksheet
For a gamma-distributed quantity with shape 2 and scale 1, =IGAMMA(2,1) gives approximately 0.264241117657 below x = 1. =IGAMMA(2,1,FALSE()) gives approximately 0.735758882343 above it. For a positive scale θ other than 1, use x/θ as the second argument. This probability interpretation assumes a positive shape and scale.
At shape 3, Γ(3) = 2. The table’s unregularized lower result is therefore twice the regularized result. Leaving the fourth argument at its default changes the mathematical quantity, not just its display format.
Advanced interpretation and checks
For integer shape 2, independent integration gives P(2,x) = 1 − exp(−x)(1 + x). At x = 1 this is 1 − 2/e. The executed complement check =IGAMMA(2,1)+IGAMMA(2,1,FALSE()) returned 1. Compute an upper tail directly rather than subtracting a lower result extremely close to 1, which can lose small-tail precision.
Negative x may produce a complex value. The tested a = 2.5, x = −1.8 case returned real component 0 and imaginary component approximately 5.056872568915. Use separate calls with the fifth argument TRUE and FALSE if both components matter; a zero real component alone does not mean the full value is zero.
Boundaries and troubleshooting
At nonpositive integer a, the ordinary defining integral or gamma quotient can be singular. The source has an explicit regularized extension: the tested lower results at a = 0 and a = −1 were both 1. These values must not be interpreted as probabilities from a valid positive-shape gamma distribution. Omitted optional arguments default to TRUE; an omitted required argument gives #N/A.
F5 is an actually empty cell. Listed errors are native error results, not mathematical zeroes.
| Formula | Gnumeric 1.12.57 result |
|---|---|
=IGAMMA(2.5,-1.8) |
0 |
=IGAMMA(2.5,-1.8,TRUE(),TRUE(),FALSE()) |
5.056872568915 |
=IGAMMA(0,1) |
1 |
=IGAMMA(-1,1) |
1 |
=IGAMMA(2,"abc") |
#VALUE! |
=IGAMMA(2,F5) |
0 |
=IGAMMA(2) |
#N/A |
=IGAMMA(2,1,TRUE(),TRUE(),TRUE(),0) |
#N/A |
Official evidence and checking scope
The retained workbook contained a deliberately stale SUM cache and an uncached SUM formula, both recalculated correctly. Native evidence covers the listed 1.12.57 cases; worksheet layouts and algebraic interpretations are independently specified explanations. Other locales, direct GUI entry and later-release output were not tested.