s2: Twice the area under the TIP curve

In rtip: Inequality, Welfare and Poverty Indices and Curves using the EU-SILC Data

Description

Estimates the poverty measure which is twice the area under the TIP curve.

Usage

s2(dataset, ipuc = "ipuc", hhcsw = "DB090", hhsize = "HX040",
  arpt.value = NULL, norm = FALSE, ci = NULL, rep = 1000,
  verbose = FALSE)

Arguments

dataset	a data.frame containing the variables.
ipuc	a character string indicating the variable name of the income per unit of consumption. Default is "ipuc".
hhcsw	a character string indicating the variable name of the household cross-sectional weight. Default is "DB090".
hhsize	a character string indicating the variable name of the household size. Default is "HX040".
arpt.value	the at-risk-of-poverty threshold to be used (see arpt). Default is NULL which calculates arpt with default parameters.
norm	logical; if TRUE, the area under the normalised TIP curve is then estimated (see tip).
ci	a scalar or vector containing the confidence level(s) of the required interval(s). Default does not calculate the confidence interval.
rep	a number to do the confidence interval using boostrap technique.
verbose	logical; if TRUE the confidence interval is plotted.

Details

It is computed using the equivalised disposable income. The equivalence scales that can be employed are the modified OECD scale or the parametric scale of Buhmann et al. (1988). The default is the modified OECD scale (see setupDataset).

This poverty index coincides with the Sen-Shorrocks-Thon index and the S(2,z) index of Sordo and Ramos (2011).

Value

The value of the poverty measure.

Author(s)

A. Berihuete, C.D. Ramos and M.A. Sordo

References

B. Buhmann et al. (1988) Equivalence scales, well-being, inequality and poverty: sensitivity estimates across ten countries using the Luxembourg Income Study (LIS) database, Review of Income and Wealth, 34, 115–142.

A.F. Shorrocks (1995) Revisiting the Sen poverty index, Econometrica, 63, 1225–1230.

D. Thon (1979) On measuring poverty, Review of Income and Wealth, 25, 429–439.

D. Thon (1983) A poverty measure, The Indian Economic Journal, 30, 55–70.

M.A. Sordo and C.D. Ramos (2011) Poverty comparisons when TIP curves intersect, SORT, 31, 65–80.

See Also

tip, setupDataset, arpt

Examples

data(eusilc2)
ATdataset <- setupDataset(eusilc2, country = "AT")
s2(ATdataset,arpt.value = arpt(ATdataset), norm = TRUE)

rtip documentation built on May 2, 2019, 7:55 a.m.