# benfUC: Benford's Distribution In VGAM: Vector Generalized Linear and Additive Models

 Benford R Documentation

## Benford's Distribution

### Description

Density, distribution function, quantile function, and random generation for Benford's distribution.

### Usage

```dbenf(x, ndigits = 1, log = FALSE)
pbenf(q, ndigits = 1, lower.tail = TRUE, log.p = FALSE)
qbenf(p, ndigits = 1, lower.tail = TRUE, log.p = FALSE)
rbenf(n, ndigits = 1)
```

### Arguments

 `x, q` Vector of quantiles. See `ndigits`. `p` vector of probabilities. `n` number of observations. A single positive integer. Else if `length(n) > 1` then the length is taken to be the number required. `ndigits` Number of leading digits, either 1 or 2. If 1 then the support of the distribution is {1,...,9}, else {10,...,99}. `log, log.p` Logical. If `log.p = TRUE` then all probabilities `p` are given as `log(p)`. `lower.tail` Same meaning as in `pnorm` or `qnorm`.

### Details

Benford's Law (aka the significant-digit law) is the empirical observation that in many naturally occuring tables of numerical data, the leading significant (nonzero) digit is not uniformly distributed in 1:9. Instead, the leading significant digit (=D, say) obeys the law

P(D=d) = log10(1 + 1/d)

for d=1,…,9. This means the probability the first significant digit is 1 is approximately 0.301, etc.

Benford's Law was apparently first discovered in 1881 by astronomer/mathematician S. Newcombe. It started by the observation that the pages of a book of logarithms were dirtiest at the beginning and progressively cleaner throughout. In 1938, a General Electric physicist called F. Benford rediscovered the law on this same observation. Over several years he collected data from different sources as different as atomic weights, baseball statistics, numerical data from Reader's Digest, and drainage areas of rivers.

Applications of Benford's Law has been as diverse as to the area of fraud detection in accounting and the design computers.

Benford's distribution has been called “a” logarithmic distribution; see `logff`.

### Value

`dbenf` gives the density, `pbenf` gives the distribution function, and `qbenf` gives the quantile function, and `rbenf` generates random deviates.

### Author(s)

T. W. Yee and Kai Huang

### References

Benford, F. (1938). The Law of Anomalous Numbers. Proceedings of the American Philosophical Society, 78, 551–572.

Newcomb, S. (1881). Note on the Frequency of Use of the Different Digits in Natural Numbers. American Journal of Mathematics, 4, 39–40.

### Examples

```dbenf(x <- c(0:10, NA, NaN, -Inf, Inf))
pbenf(x)

## Not run:
xx <- 1:9
barplot(dbenf(xx), col = "lightblue", xlab = "Leading digit",
ylab = "Probability", names.arg = as.character(xx),
main = "Benford's distribution", las = 1)

hist(rbenf(1000), border = "blue", prob = TRUE,
main = "1000 random variates from Benford's distribution",
xlab = "Leading digit", sub="Red is the true probability",
breaks = 0:9 + 0.5, ylim = c(0, 0.35), xlim = c(0, 10.0))
lines(xx, dbenf(xx), col = "red", type = "h")
points(xx, dbenf(xx), col = "red")

## End(Not run)
```

VGAM documentation built on July 6, 2022, 5:05 p.m.