ineq {ineq}R Documentation

Inequality Measures

Description

computes the inequality within a vector according to the specified inequality measure

Usage

ineq(x,parameter=1,type=c("Gini","RS","Atkinson","Theil","Kolm","var","square.var","entropy"))

Gini(x)
RS(x)
Atkinson(x, parameter=0.5) 
Theil(x, parameter=0)
Kolm(x, parameter=1)
var.coeff(x, square=F)
entropy(x, parameter=0.5)

Arguments

x a vector containing at least non-negative elements
parameter parameter of the inequality measure
type character string giving the measure used to compute inequality. must be one of the strings in the default argument (the first character is sufficient). defaults to "Gini".

Details

ineq is just a wrapper for the inequality measures Gini, RS, Atkinson, Theil, Kolm,var.coeff, entropy.

Gini is the Gini coefficient, RS is the the Ricci-Schutz coefficient (also called Pietraīs measure), Atkinson gives Atkinsonīs measure and Kolm computes Kolmīs measure.

If the parameter in Theil is 0 Theilīs entropy measure is computed, for every other value Theilīs second measure is computed.

ineq(x, type="var") and var.coeff(x) respectively compute the coefficient of variation, while ineq(x,type="square.var") and var.coeff(x, square=T) compute the squared coefficient of variation.

entropy computes the generalized entropy, which is for parameter 1 equal to Theilīs entropy coefficient and for parameter 0 equal to the second measure of Theil.

Value

the value of the inequality measure

Author(s)

Achim Zeileis zeileis@ci.tuwien.ac.at

References

F A Cowell: Measurement of Inequality, 2000, in A B Atkinson / F Bourguignon (Eds): Handbook of Income Distribution, Amsterdam,

F A Cowell: Measuring Inequality, 1995 Prentice Hall/Harvester Wheatshef,

Marshall / Olkin: Inequalities: Theory of Majorization and Its Applications, New York 1979 (Academic Press).

See Also

conc, pov

Examples

# generate vector (of incomes)
x <- c(541, 1463, 2445, 3438, 4437, 5401, 6392, 8304, 11904, 22261)
# compute Gini coefficient
ineq(x)
# compute Atkinson coefficient with parameter=0.5
ineq(x, parameter=0.5, type="Atkinson")