```-------------------------------------------------------------------------------
help for mpovline                                            Joao Pedro Azevedo
Viviane Sanfelice
-------------------------------------------------------------------------------

Calculate FGT0, FGT1 and FGT2 by intervals of multiple welfare lines.

mpovline welfarevar [weight] [if exp] [in exp], [ varpl(varname)
lines(numlist) indicator(string) mpl(numlist) max ]

fweights and aweights are allowed; see help weights. See help weight.

Description

mpovline calculate FGT0, FGT1 and FGT2 by intervals of multiple welfare
lines. It is useful to calculate headcount for the poor, vulnerable and
middle class lines as proposed by Ferreira et al (2012), and the
respective FGT1 and FGT2 reported by Azevedo and Sanfelice (2012).

Where

welfarevar is the welfare aggregate variable.

Options

varpl(varname) poverty line variables.

lines(numlist) sets of values for the poverty lines.

indicator(string) poverty indicators. fgt0, fgt1, fgt2 are the currently
supported options. fgt0 is the indicator default.

mpl(numlist) to calculate the poverty indicators by range using multiples
of the poverty line. Must be combined with the varpl option

max poverty indicators for the range between the last line and the
maximun value of welfarevarIt is quite sensitive to outliers.

Saved Results

mpovline returns results in r() format.
By typing return list, the following results are reported:

Matrices
r(b)                 matrix in long format. The first column represents
the index used, the sencond the range of the
poverty line used and the last column reports the
poverty numbers.
r(fgt)               short version of the matrix r(b) with results by
indicator. r(fgt0), r(fgt1) and r(fgt2) if
indicator option specified.
r(obs)               matrix with the number of observation by range of
the lines.

Obs: On the reported matrices
Indicator label: 0 - FGT(0); 1 - FGT(1); 2 - FGT(2).
Line label: 1 represents the first range; 2 the second, and so on. The
last number indicates the range from the last line and the maximun value
if the option max is specified.

Examples

. mpovline percapitainc, varpl(pline1 plin2)

. mpovline percapitainc [w=weight], line(100 500) in(fgt0 fgt1 fgt2)

. mpovline percapitainc [w=weight], varpl(pline) mpl(1 3.5 6)

Headcount for moderate poverty, vunerable and middle class in terms of
\$4USD a day, \$4 to 10USD a day and \$10 to 50USD a day, respectively.

. mpovline percapitainc [w=weight], varpl(lp_4usd_ppp) mpl(1 2.5 12.5)
or
. mpovline percapitainc [w=weight], line(121.68 304.2 1521)
or
. mpovline percapitainc [w=weight], varpl(lp_4usd_ppp lp_10usd_ppp
lp_50usd_ppp)

References

Azevedo, Joao Pedro and Viviane Sanfelice (2012) "The rise of the middle
class in Latin America". World Bank (mimeo).

Ferreira, Francisco H.G.; Messina, Julian; Rigolini, Jamele; López-Calva,
Luis-Felipe; Lugo, Maria Ana; Vakis, Renos. (2013) Economic Mobility and
the Rise of the Latin American Middle Class. Washington, DC: World Bank.

Foster, James; Joel Greer and Erik Thorbecke (1984) "A class of
decomposablepoverty measures". Econometrica. 2 81: 761–766.

Lopez-Calva, Luis F. and Eduardo Ortiz-Juarez (2011) "A Vulnerability
Approach to the Definition of the Middle Class". Policy Research Working
Paper, World Bank, n. 5902.

Authors

Joao Pedro Azevedo, jazevedo@worldbank.org
Viviane Sanfelice, vsanfelice@worldbank.org

Acknowledgements

This program was developed by the  LAC Team for Statistical Development
(2012), in the Latin American and Caribbean Poverty Reduction and
Economic Managment Group of the World Bank.

Also see

Online:  help for apoverty; ainequal; wbopendata; adecomp; drdecomp;
skdecomp (if installed)

```