-------------------------------------------------------------------------------
help for apoverty                                            Joao Pedro Azevedo
-------------------------------------------------------------------------------

Poverty Measures (revised)

        apoverty varlist [weight] [if exp] [in exp] [, line(#) varpl(varname)
               gen(newvarname) all h h2 apg pgr igr w s tak thon fgt1 fgt2 fgt3
               fgt4 fgt5 fgt6 fgt7 fgt8 fgt9 chu1 chu2 chu3 chu4 chu5 ]

     aweights, fweights and pweights are allowed; see help weights.


Description

     apoverty computes a series of poverty measures based on the (income)
distribution described by varname. It is a revised and upgraded version of
poverty published by Philippe Van Kerm.

The poverty measures that can be computed by

     headcount ratio extreme poverty hratio aggregate poverty gap
     poverty gap ratio income gap ratio Watts index
     Sen index Takayama index Thon index,

and series of Foster, Greer and Thorbecke indices with parameters :
     0.5, 1.5, 2, 2.5, 3, 3.5, 4, 4.5, 5
     Clark et al. indices with parameters :
     0.1, 0.25, 0.5, 0.75, 0.9


     The poverty line is either directly specified by the user or computed
relative to the median of varname (half or two-third), see under "options"
below. The extreme poverty line is directly speciefied as half of the poverty
line used in the exercise.

Up to 5 variables can be specified in varlist.

Options

    line(#) sets the value of the poverty line. If # is set equal to -1, the
    poverty line is computed as half the median of varname. If # is set equal
    to -2, it is computed as two-third of the median of varname. Default is
    -1.

    varpl(varname) provide the variable name containing the values of the
    poverty line.

    gen(newvarname) creates a new variable that takes on the value of 1 for
    all observations identified as poor and 0 for observations identified as
    non-poor. "newvarname" is set to missing for observations with missing
    "varname" or falling outside the ^if in^ statements. If more than one
    variable is specified on the varlist variable created will refered to
    this last income variable.

    all requests that all possible measures are computed and reported.  By
    default, no measure is produced.


The following options specify the measures to be computed and reported.

    h : headcount ratio [FGT(0)]
    h2 : extremem poverty headcount ratio
    apg : aggregate poverty gap
    pgr : poverty gap ratio [FGT(1)]
    igr : income gap ratio
    w : Watts index
    s : Sen index
    tak : Takayama index
    thon : Thon index
    fgt1 : Foster, Greer and Thorbecke -FGT(0.5)-
    fgt2 : Foster, Greer and Thorbecke -FGT(1.5)-
    fgt3 : Foster, Greer and Thorbecke -FGT(2)-
    fgt4 : Foster, Greer and Thorbecke -FGT(2.5)-
    fgt5 : Foster, Greer and Thorbecke -FGT(3)-
    fgt6 : Foster, Greer and Thorbecke -FGT(3.5)-
    fgt7 : Foster, Greer and Thorbecke -FGT(4)-
    fgt8 : Foster, Greer and Thorbecke -FGT(4.5)-
    fgt9 : Foster, Greer and Thorbecke -FGT(5)-
    chu1 : Clark, Ulph and Hemming index with beta of 0.10
    chu2 : Clark, Ulph and Hemming index with beta of 0.25
    chu3 : Clark, Ulph and Hemming index with beta of 0.50
    chu4 : Clark, Ulph and Hemming index with beta of 0.75
    chu5 : Clark, Ulph and Hemming index with beta of 0.90

Saved Results

     apoverty returns results in r() format.  [Important notice: When multiple
variables are entered in varlist, returned results are for all inequality
measures of the variable listed.]

Author

     Joao Pedro Azevedo
     jazevedo@ipea.gov.br
     IPEA

This is a modified version of the ado poverty2 written by Philippe Van Kerm.

Also see

On-line:  help for povdeco & poverty if installed