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

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.

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

```