--------------------------------------------------------------------
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