------------------------------------------------------------------------------- help forchangemeanJoao Pedro Azevedo Samuel Franco -------------------------------------------------------------------------------

Income and Inequalily Contribution on Poverty Variation

changemeanvarlist[weight] [ifexp] [inrange] [ ,by(groupvar)base(refcat)varpl(varname)pline(number)hh2pgrigrwfgt1fgt2fgt3fgt4fgt5fgt6fgt7fgt8fgt9chu1chu2chu3chu4chu5sthontak]

fweights, are allowed; see help weights.

Description

changemeandecompose the poverty gap among two or more subgroups by income and inequality. Several measures of poverty can be used. If no specific measures is requested the default value is the head count ratio [FGT(0)]. This version of the program does not support the computation of multiple poverty measures.

varlistIncome variable

Options

by(groupvar)provide the variable name that defided the groups of comparison. The default comparation group is computed as half the median of varlist.

base(refcat)sets the value of the comparation categoric group that defided the base group. If the base category was not definedchangemeanwill use the first category.

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

pline(#)sets the value of the poverty line. The default poverty line is computed as half the median of varname.The following options specify the poverty measure to be computed.

h: headcount ratio [FGT(0)] (default value)h2: extremem poverty headcount ratiopgr: 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

RemarksThe output table of change mean describe the following indicators:

IndexPresents the comparision categories.

BaseliShows the poverty rate (head count ratio) of the individuals on the base line category.

OriginShows the poverty rate (head count ratio) of the individuals on each one of the comparison categories.

IncomePoverty rate of the baseline group with the average income of the comparsion group.

InequaPoverty rate of the baseline group with the inequality of the comparsion group.

GapPoverty gap (head count ratio of base line category - head count ratio of comparsin category).

RawIncRaw contribution of the income differential on the poverty gap.

RawIneRaw contribution of the inequality differential on the poverty gap.

RelIncRelative contribution of the income differential on the poverty gap.

RelIneRelative contribution of the inequality differential on the poverty gap.

Examples. changemean rdpc

. changemean rdpc [fw=peso]

. changemean rdpc [fw=peso], by(educa)

. changemean rdpc [fw=peso], by(educa) varpl(lp)

. changemean rdpc [fw=peso], by(educa) line(240)

. changemean rdpc [fw=peso], by(educa) base(1)

. changemean rdpc [fw=peso], by(educa) base(1) varpl(lp)

. changemean rdpc [fw=peso], by(educa) base(3) line(240)

AuthorsJoao Pedro Azevedo jazevedo@worldbank.org

Samuel Franco sam@ipea.gov.br