Contact

R.DGUMBEL Function (Gnumeric)

Statistical Intermediate Gnumeric Gnumeric 1.12.25

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

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.