gini {ineqJD}

Point and synthetic Gini indexes

Description

Computes point and synthetic Gini indexes on a variable Y.

Usage

gini(x)

Arguments

x

List containing: 'yh', the vector of unique values of the variable Y whose Bonferroni index is computed; 'Phl', the matrix of absoute cumulative frequencies; 'Qhlk', the matrix of cumlative sums of Y or its sources. x is usually the result of dataProcessing function. More details are given in the "Details" section and dataProcessing help page.

Details

gini compute point and synthetic Gini indexes on a variable y, e.g. income, on a statistical population that could be partitioned in g subpopultions and could be considered as sum of c sources, e.g. income sources.

Value

index

String denoting computed index.

decomposition

array containing the decompositions.

x

object usually of class dataProcessed passed as input.

Author(s)

Alberto Arcagni, Igor Valli.

References

Zenga M., Valli I. (2018). Joint decomposition by Subpopulations and Sources of the Point and Synthetic Gini Indexes. Statistics and Applications, XVI (1).

Examples

G <- c(1, 2, 3, 1, 2, 3, 1, 1, 2, 3, 3, 3) # vector denoting group membership
X1 <- c(0, 0, 0, 500, 700, 300, 750, 1000, 500, 500, 500, 1000) # vector of the first source
X2 <- c(0, 0, 0, 500, 300, 700, 750, 500, 700, 700, 1000,600) # vector of the second source
data <- data.frame(G, X1, X2) # no sample weights are considered
x <- dataProcessing( # data preparation
  units = data[, c('X1', 'X2')],
  groups = data[, 'G'],
)
  
decomposition <- gini(x)
decomposition