------------------------------------------------------------------------------- help forapovertyJoao Pedro Azevedo -------------------------------------------------------------------------------

Poverty Measures (revised)

apovertyvarlist[weight] [ifexp] [inexp] [,line(#)varpl(varname)gen(newvarname)allhh2apgpgrigrwstakthonfgt1fgt2fgt3fgt4fgt5fgt6fgt7fgt8fgt9chu1chu2chu3chu4chu5]

aweights,fweights andpweights are allowed; see help weights.

Description

apovertycomputes 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 thevarlistvariable created will refered to this last income variable.

allrequests 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 ratioapg: aggregate poverty gappgr: poverty gap ratio [FGT(1)]igr: income gap ratiow: Watts indexs: Sen indextak: Takayama indexthon: Thon indexfgt1: 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.10chu2: Clark, Ulph and Hemming index with beta of 0.25chu3: Clark, Ulph and Hemming index with beta of 0.50chu4: Clark, Ulph and Hemming index with beta of 0.75chu5: Clark, Ulph and Hemming index with beta of 0.90

Saved Results

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

AuthorJoao Pedro Azevedo jazevedo@ipea.gov.br IPEA

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

Also seeOn-line: help for povdeco & poverty if installed