Negative binomial distribution with parameters \(r\) (number of successful trials) and \(p\) (probability of success).

expValNBinom(
  size,
  prob = (1/(1 + beta)),
  beta = ((1 - prob)/prob),
  nb_tries = FALSE
)

varNBinom(
  size,
  prob = (1/(1 + beta)),
  beta = ((1 - prob)/prob),
  nb_tries = FALSE
)

mgfNBinom(
  t,
  size,
  prob = (1/(1 + beta)),
  beta = ((1 - prob)/prob),
  nb_tries = FALSE
)

pgfNBinom(
  t,
  size,
  prob = (1/(1 + beta)),
  beta = ((1 - prob)/prob),
  nb_tries = FALSE
)

Arguments

size

Number of successful trials.

prob

Probability of success in each trial.

beta

Alternative parameterization of the negative binomial distribution where beta = (1 - p) / p.

nb_tries

logical; if FALSE (default) number of trials until the rth success, otherwise, number of failures until the rth success.

t

t.

Value

Function :

  • expValNBinom gives the expected value.

  • varNBinom gives the variance.

  • mgfNBinom gives the moment generating function (MGF).

  • pgfNBinom gives the probability generating function (PGF).

Invalid parameter values will return an error detailing which parameter is problematic.

Details

When \(k\) is the number of failures until the \(r\)th success, with a probability \(p\) of a success, the negative binomial has density: $$\left(\frac{r + k - 1}{k}\right) (p)^{r} (1 - p)^{k}$$ for \(k \in \{0, 1, \dots \}\)

When \(k\) is the number of trials until the \(r\)th success, with a probability \(p\) of a success, the negative binomial has density: $$\left(\frac{k - 1}{r - 1}\right) (p)^{r} (1 - p)^{k - r}$$ for \(k \in \{r, r + 1, r + 2, \dots \}\)

The alternative parameterization of the negative binomial with parameter \(\beta\), and \(k\) being the number of trials, has density: $$\frac{\Gamma(r + k)}{\Gamma(r) k!} \left(\frac{1}{1 + \beta}\right)^{r}% \left(\frac{\beta}{1 + \beta}\right)^{k - r}$$ for \(k \in \{0, 1, \dots \}\)

Examples

# Where k is the number of trials for a rth success
expValNBinom(size = 2, prob = .4)
#> [1] 3

# Where k is the number of failures before a rth success
expValNBinom(size = 2, prob = .4, nb_tries = TRUE)
#> [1] 5

# With alternative parameterization where k is the number of trials
expValNBinom(size = 2, beta = 1.5)
#> [1] 3


# Where k is the number of trials for a rth success
varNBinom(size = 2, prob = .4)
#> [1] 7.5

# Where k is the number of failures before a rth success
varNBinom(size = 2, prob = .4, nb_tries = TRUE)
#> [1] 7.5

# With alternative parameterization where k is the number of trials
varNBinom(size = 2, beta = 1.5)
#> [1] 7.5

mgfNBinom(t = 1, size = 4, prob = 0.5)
#> [1] 3.756821

pgfNBinom(t = 5, size = 3, prob = 0.3)
#> [1] -0.001728