.-
help for ^poverty^                                     (STB-48: sg108)
.-

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

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

^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.
    
^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)]     
	^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.
        philippe.vankerm@@fundp.ac.be


Also see
--------

    STB: STB-48 sg108
On-line: help for @povdeco@ (if installed)