rtip (version 1.1.1)

rmpg: Relative median at-risk-of-poverty gap

Description

Estimates the relative median at-risk-of-poverty gap which is the difference between the at-risk-of-poverty threshold and the median equivalised disposable income of people below the at-risk-of-poverty threshold, expressed as a percentage of this threshold.

Usage

rmpg(dataset, ipuc = "ipuc", hhcsw = "DB090", hhsize = "HX040",
  arpt.value = NULL, 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.

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.

Value

The value of the relative median at-risk-of-poverty gap.

Details

The equivalised disposable income is calculated using the standard equivalence scale (called the modified OECD scale) recommended by Eurostat. The parametric scale of Buhmann et al. (1988) can also be used. The default is the modified OECD scale (see setupDataset).

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.

http://ec.europa.eu/eurostat/statistics-explained/index.php/Glossary:Relative_median_at-risk-of-poverty_gap

See Also

arpt, setupDataset

Examples

# NOT RUN {
data(eusilc2)
ATdataset <- setupDataset(eusilc2, country = "AT")
rmpg(ATdataset,arpt.value = arpt(ATdataset))

# }