ineqJD (version 1.0)

gini: 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.

Value

index

String denoting computed index.

decomposition

array containing the decompositions.

x

object usually of class dataProcessed passed as input.

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.

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

# NOT RUN {
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
# }