# Decomposition by Groups for GEI

### Description

Decomposes by population subgroups a generalized entropy inequality measure within a vector.

### Usage

1 |

### Arguments

`x` |
Numeric vector with non-negative values (strictly positive
when |

`z` |
Factor who determines the subgroups. |

`w` |
Numeric vector of sampling weigths (optional). |

`alpha` |
Parameter of the generalized entropy index. Theil index ( |

`ELMO` |
When |

### Value

A list of class `"ICI"`

with components:

`ineq` |
a list with components |

`decomp` |
a list with components |

`intra` |
a list with components |

`ws` |
a list with components |

`nas` |
a list with |

### References

Cowell F.A. (2000) Measurement of Inequality. In Atkinson A.B., Bourguignon F.
(Eds.) *Handbook of Income Distribution*. Elsevier, Vol. 1, pp. 87-166.

Elbers C., Lanjouw P., Mistiaen J.A., Ozler B. (2005)
*Re-Interpreting
Sub-Group Inequality Decompositions*. World Bank, World Bank Policy Research
Working Paper 3687, 42 p.

### See Also

`calcGEI`

### Examples

1 2 3 4 5 6 | ```
data(hhbudgets)
decompGEI(hhbudgets[,"ingreso"], hhbudgets[,"estructura"], alpha=4)
summary(hhbudgets[,"tenencia"]) #35 NA's
decompGEI(x=hhbudgets[,"transporte"], z=hhbudgets[,"tenencia"], w=hhbudgets[,"factor"], ELMO=FALSE)
summary(decompGEI(x=hhbudgets[,"transporte"], z=hhbudgets[,"tenencia"], w=hhbudgets[,"factor"], alpha=1.5))
``` |