R.DGUMBEL Function (Gnumeric)
Evaluate Gumbel density with Gnumeric R.DGUMBEL. Interpret location and scale, reproduce standardization and use log density for tested extreme observations.
Verification status: 20 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.DGUMBEL(0,0,1) gives 0.367879441171 in Gnumeric 1.12.57.
Availability and version history
- Introduced: Introduced in Gnumeric 1.12.25 release notes.
- 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.DGUMBEL returns
R.DGUMBEL uses the maximum-type Gumbel density: with z=(x−location)/scale, density is EXP(−z−EXP(−z))/scale. Its optional mode returns the natural log density. Location is the mode, not the mean or median. Versioned function help.
Syntax and arguments
=R.DGUMBEL(x,location,scale[,give_log])
x, location and scale are required. Scale must be positive. Optional give_log defaults to FALSE. x and location share units, and scale is expressed in those units; the distribution permits negative observations.
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.DGUMBEL(0,0,1) |
0.367879441171 |
=R.DGUMBEL(1,0,1) |
0.254646380044 |
=R.DGUMBEL(-1,0,1) |
0.179374078734 |
=R.DGUMBEL(2.5,2,1) |
0.33070429889 |
=R.DGUMBEL(2,2,3) |
0.12262648039 |
=R.DGUMBEL(0,0,1,TRUE()) |
-1 |
=R.DGUMBEL(1,0,2) |
0.165352149445 |
=R.DGUMBEL(-2,-1,.5) |
0.00913256284 |
Practical worksheet
For location 0 and scale 1, the density at x=0 is EXP(−1), approximately 0.367879441171. At x=1 it is approximately 0.254646380044; at x=−1 it is approximately 0.179374078734, showing the asymmetric shape.
For location 2 and scale 3, the density at the mode is EXP(−1)/3, approximately 0.122626480390. The executed standardization check below multiplies this by 3 and subtracts the standard density at zero.
Advanced interpretation and checks
Log density is −z−EXP(−z)−LN(scale). For x=1000, location 0 and scale 1, the ordinary density underflows to zero in the tested engine, while the log density remains −1000.
At x=−100, the ordinary density also underflows, while the log result is approximately −2.688117141816E43. The two tails have different decay behavior. A returned ordinary zero at an extreme finite observation need not mean the mathematical density is exactly zero.
The saved advanced-check result for =R.DGUMBEL(2,2,3)*3-R.DGUMBEL(0,0,1) was 0.
Boundaries and troubleshooting
Zero or negative scale gives #NUM!. Negative x itself is valid. Numeric text is parsed, nonnumeric text gives #VALUE!, and empty F5 is evaluated as x=0. Incorrect arity gives #N/A.
The log form is useful for the tested extreme densities, but that does not guarantee that every tail-related function avoids underflow: a separate Gumbel cumulative helper can lose a tiny intermediate even in its log-tail mode. Distinguish a density, a cumulative probability and their logarithms when interpreting the result.
F5 is genuinely empty, rather than a cell containing an empty string.
| Formula | Gnumeric 1.12.57 result |
|---|---|
=R.DGUMBEL(0,0,0) |
#NUM! |
=R.DGUMBEL(0,0,-1) |
#NUM! |
=R.DGUMBEL(-100,0,1) |
0 |
=R.DGUMBEL(-100,0,1,TRUE()) |
-2.688117141816E+43 |
=R.DGUMBEL(1000,0,1) |
0 |
=R.DGUMBEL(1000,0,1,TRUE()) |
-1000 |
=R.DGUMBEL("2.5",2,1) |
0.33070429889 |
=R.DGUMBEL("abc",0,1) |
#VALUE! |
=R.DGUMBEL(F5,0,1) |
0.367879441171 |
=R.DGUMBEL(0,0) |
#N/A |
=R.DGUMBEL(0,0,1,0,1) |
#N/A |
Official evidence and checking scope
- Current worksheet callback
- Tested-version worksheet callback
- Current dgumbel calculation
- Tested-version dgumbel 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.