```--------------------------------------------------------------------
help for ^ginidesc^
--------------------------------------------------------------------

Gini index, with within- and between-group inequality decomposition
--------------------------------------------------------------------

^ginidesc^ varname  [^[^fweights aweights^] if^ exp ^in^ range]
^,by^group^(groupvar)^ [^m^at^(^matname^)^ ^gk^mat^(^matname^)^]

This ado-file provides the Gini coefficient for the whole population,
for each subgroup specified in ^groupvar^, and its Pyatt's (1976)
decomposition in ^between^-, ^overlap^- and ^within^-group inequality.
^Groupvar^ is a categorical variable (not string) who determines the
subgroups in which the population will be divided.
It's mandatory that the command ^ineqdeco^ (S. P. Jenkins, 1998) are
installed.

Options (Saved results)
------------------------

^mat(matname)^    Define a 4*2 matrix containing the inequality
decomposition shown on the table displayed by the
command.

^gkmat(matname)^  Define a K*2 matrix containing the values of the ca-
tegorical variable in the first column, and the co-
rresponding Gini coefficients in the second one.

Examples
---------

^ginidesc ing, by(educ_al) m(a1) gk(a2)^

Pyatt's Inequality decomposition

-----------+-----------------------
Desig and |
Grupos    |     Indice       Part.
-----------+-----------------------
DESCOMP.  |
Between   |      0.262      52.472
Overlap   |      0.122      24.476
Within    |      0.115      23.053
-----------+-----------------------
TOTAL     |
Gini      |      0.499     100.000
-----------+-----------------------
Stored in matrix ^a1^

Gini Coefficient by subgroups
of ^ing^
-----------+-----------
K |     Gini_k
-----------+-----------
1 |      0.459
2 |      0.419
3 |      0.412
4 |      0.427
-----------+-----------
Stored in matrix ^a2^

Authors
--------

Roger Aliaga y Silvia Montoya <ieeracba@@satlink.com>
Instituto de Estudios de la Realidad Argentina y Latinoamericana
(IERAL) - Cordoba - Argentina

References
-----------

Pyatt, G. (1976) "On the Interpretation and Disaggregation of
Gini Coefficients", The Economic Journal, 86,(June), 243-255.

Also see
---------

@ineqdeco@
@ineqdec0@ if installed
@ineq@ if installed
@inequal@ [sg30: STB-23] if installed
```