.-
help for ^poverty^ (Philippe Van Kerm)
.-
Poverty Measures
----------------
^poverty^ varname [^if^ exp] [^in^ range] ^[^weight^]^ [^, ^options]
^aweight^s and ^fweight^s are allowed; see help @weights@.
Description
-----------
^poverty^ computes a series of poverty measures based on the (income)
distribution described by varname.
The poverty measures that can be computed by ^poverty^ are:
headcount ratio 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.
Options
-------
^l^ine^(^#^)^ 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.
^g^en^(^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.
^A^ll 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)]
^APG^ : aggregate poverty gap
^PGR^ : poverty gap ratio [FGT(1)]
^IGR^ : income gap ratio
^W^ : Watts index
^S^ : Sen index
^TA^k : Takayama index
^TH^on : 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
-------------
S_1 = total number of observations in the data
S_2 = number of observations used to compute the indices
S_3 = weighted number of observations
S_4 = value of the poverty line
S_5 = weighted number of observations identified as poor
(the following results are only available if the measure has been requested)
S_6 = headcount ratio [FGT(0)]
S_7 = aggregate poverty gap
S_8 = poverty gap ratio [FGT(1)]
S_9 = income gap ratio
S_10 = Watts index
S_11 = FGT(0.5)
S_12 = FGT(1.5)
S_13 = FGT(2)
S_14 = FGT(2.5)
S_15 = FGT(3)
S_16 = FGT(3.5)
S_17 = FGT(4)
S_18 = FGT(4.5)
S_19 = FGT(5)
S_20 = Clark et al. index (0.10)
S_21 = Clark et al. index (0.25)
S_22 = Clark et al. index (0.5)
S_23 = Clark et al. index (0.75)
S_24 = Clark et al. index (0.90)
S_25 = Sen index
S_26 = Thon index
S_27 = Takayama index
Author
------
Philippe VAN KERM
University of Namur, Department of Economics
Rempart de la Vierge 8
B-5000 Namur, Belgium.
Also see
--------
on-line: @povdeco@ if installed