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