-------------------------------------------------------------------------------
help for clorenz              (Araar Abdelkrim, 2005, CIRPEE: Laval University)
-------------------------------------------------------------------------------

Lorenz and concentration curves

        clorenz varlist, [ HWeight(varname) HSize(varname) HGroup(varname)
            RANK(varname) GENERalised(string) CTItle(string) DIF(string)
            LRES(string) SRES(string) DGRaph(string)]

where varlist is a list of variables.

Version 8.0 and higher.

Description
 
 
clorenz can produces the following distributional curves for a given list of
variables:
 
    . Lorenz curves
    . Generalised Lorenz curves
    . Concentration curves
    . Generalised concentartion curves
    . Deficit share curves

Linear interpolation is used to estimate these distributional curves for a
given percentile.
 
Options
 
hweight variable that indicates the sampling weight at household level.

hsize variable that indicates the household size. For example, if the variable
    of interest is income per capita, one should weight observations by the
    household size.
  
hgroup variable which indicates the household group. For example, this variable
    equals to 1 for households that live in rural area and 2 for those that
    live in urban area. When this option is used, varlist should contain only
    one variable. If values of the variable hgroup are labelled, the produced
    graphs contain automatically these labels.
 
rank option to indicate the ranking variable. If this variable is selected, the
    concentration curves are estimated instead of the Lorenz curves.
 
generalised If option yes is selected, the generalised Lorenz (concentration)
    curves are displayed instead of the Lorenz (concentration) curves.
 
ctitle To indicate the title of the produced graph.
 
dif If option yes is is selected, the difference between percentiles and the
    lorenz (concentration) curves are displayed.
 
lres If option yes is selected, coordinates of curves are listed.

sres To save coordinates of curves in a Stata file, indicate the name of this
    file with this option.

dgraph If option no is selected, the graph is not displayed. By default, the
    graph is displayed.


Examples
 
    . clorenz pccons pcy
    . clorenz pccons pcy, hsize(hhsize) hweight(popw)
    . clorenz pccons pcy, hsize(hhsize) hweight(popw) dif(yes)
    . clorenz food nfood, hsize(hhsize) hweight(popw) rank(pcy)
    . clorenz pccons pcy, hsize(hhsize) hweight(popw) generalised(yes)
    . clorenz pccons pcy, hsize(hhsize) hweight(popw) lres(yes)
        sres(coodinates)


More examples

    . http://132.203.59.36/DASP/examples/examples.htm

Author
    Araar Abdelkrim. If you observe any problems mailto:aabd@ecn.ulaval.ca