[Stable]

The generalised g-and-h distribution is a flexible distribution used to model univariate data, similar to the g-k distribution. It is known for its ability to handle skewness and heavy-tailed behavior.

dist_gh(A, B, g, h, c = 0.8)

Arguments

A

Vector of A (location) parameters.

B

Vector of B (scale) parameters. Must be positive.

g

Vector of g parameters.

h

Vector of h parameters. Must be non-negative.

c

Vector of c parameters (used for generalised g-and-h). Often fixed at 0.8 which is the default.

Details

We recommend reading this documentation on pkgdown which renders math nicely. https://pkg.mitchelloharawild.com/distributional/reference/dist_gh.html

In the following, let \(X\) be a g-and-h random variable with parameters A = \(A\), B = \(B\), g = \(g\), h = \(h\), and c = \(c\).

Support: \((-\infty, \infty)\)

Mean: Does not have a closed-form expression. Approximated numerically.

Variance: Does not have a closed-form expression. Approximated numerically.

Probability density function (p.d.f):

The g-and-h distribution does not have a closed-form expression for its density. The density is approximated numerically from the quantile function. The distribution is defined through its quantile function:

$$ Q(u) = A + B \left( 1 + c \frac{1 - \exp(-gz(u))}{1 + \exp(-gz(u))} \right) \exp(h z(u)^2/2) z(u) $$

where \(z(u) = \Phi^{-1}(u)\) is the standard normal quantile function.

Cumulative distribution function (c.d.f):

Does not have a closed-form expression. The cumulative distribution function is approximated numerically by inverting the quantile function.

Quantile function:

$$ Q(p) = A + B \left( 1 + c \frac{1 - \exp(-g\Phi^{-1}(p))}{1 + \exp(-g\Phi^{-1}(p))} \right) \exp(h (\Phi^{-1}(p))^2/2) \Phi^{-1}(p) $$

where \(\Phi^{-1}(p)\) is the standard normal quantile function.

Examples

dist <- dist_gh(A = 0, B = 1, g = 0, h = 0.5)
dist
#> <distribution[1]>
#> [1] gh(A = 0, B = 1, g = 0, h = 0.5)

mean(dist)
#> [1] 0
variance(dist)
#> [1] NA
support(dist)
#> <support_region[1]>
#> [1] R
generate(dist, 10)
#> [[1]]
#>  [1] -0.71819397 -0.05017333  0.43546285 -0.69914654  1.60095259 -0.23876286
#>  [7] -3.22695726 -2.64522679 -5.86703619 -0.86796843
#> 

density(dist, 2)
#> [1] 0.05993837
density(dist, 2, log = TRUE)
#> [1] -2.814438

cdf(dist, 4)
#> [1] 0.9634416

quantile(dist, 0.7)
#> [1] 0.5617207