theil: Theil inequality index

Description Usage Arguments Details Value Author(s) References See Also Examples

Description

Calculating the Theil inequality index

Usage

1
theil(x, weighting = NULL, na.rm = TRUE)

Arguments

x

a numeric vector

weighting

a numeric weighting vector, e.g. population

na.rm

logical argument that indicates whether NA values should be excluded before computing results

Details

Since there are several Theil measures of inequality, this function uses the formulation from Stoermann (2009).

Value

A single numeric value of the Theil inequality index (0 < TI < 1).

Author(s)

Thomas Wieland

References

Portnov, B.A./Felsenstein, D. (2010): “On the suitability of income inequality measures for regional analysis: Some evidence from simulation analysis and bootstrapping tests”. In: Socio-Economic Planning Sciences, 44, 4, p. 212-219.

Stoermann, W. (2009): “Regionaloekonomik: Theorie und Politik”. Muenchen : Oldenbourg.

See Also

gini, herf, hoover

Examples

1
2
3
4
# Example from Stoermann (2009):
regincome <- c(10,10,10,20,50)
theil(regincome) 
# 0.2326302

Example output

[1] 0.2326302

REAT documentation built on Sept. 5, 2021, 5:18 p.m.