.-
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 <philippe.vankerm@@fundp.ac.be>
	University of Namur, Department of Economics
	Rempart de la Vierge 8
	B-5000 Namur, Belgium.


Also see
--------

    	on-line: @povdeco@ if installed