Learn R Programming

vardpoor (version 0.6.2)

linrmir: Linearization of the relative median income ratio

Description

Estimates the arelative median income ratio (defined as the ratio of the median equivalised disposable income of people aged above age to the median equivalised disposable income of those aged below 65) and computes linearized variable for variance estimation.

Usage

linrmir(Y, id=NULL, age,
  weight = NULL,
  sort = NULL,
  Dom = NULL,
  period = NULL,
  dataset = NULL,
  order_quant = 50,
  var_name = "lin_rmir")

Arguments

Y
Study variable (for example equalized disposable income). One dimensional object convertible to one-column data.table or variable name as character, column number.
id
Optional variable for unit ID codes. One dimensional object convertible to one-column data.table or variable name as character, column number.
weight
Optional weight variable. One dimensional object convertible to one-column data.table or variable name as character, column number.
age
Age variable. One dimensional object convertible to one-column data.table or variable name as character, column number.
sort
Optional variable to be used as tie-breaker for sorting. One dimensional object convertible to one-column data.table or variable name as character, column number.
Dom
Optional variables used to define population domains. If supplied, linearization of at-risk-of-poverty threshold is done for each domain. An object convertible to data.table or variable names as character vector, column numbers as numeric vec
period
Optional variable for survey period. If supplied, linearization of at-risk-of-poverty threshold is done for each survey period. Object convertible to data.table or variable names as character, column numbers as numeric vector.
dataset
Optional survey data object convertible to data.table.
order_quant
A numeric value in range $\left[ 0,100 \right]$ for $\alpha$ in the formula for at-risk-of-poverty threshold computation: $$\frac{p}{100} \cdot Z_{\frac{\alpha}{100}}.$$ For example, to compute the relative median income ratio to some percentage of medi
var_name
A character specifying the name of the linearized variable.

Value

  • A list with four objects are returned:
  • valueA data.table containing the estimated relative median income ratio.
  • linA data.table containing the linearized variables of the relative median income ratio.

Details

The implementation strictly follows the Eurostat definition.

References

Working group on Statistics on Income and Living Conditions (2015) Task 5 - Improvement and optimization of calculation of net change. LC- 139/15/EN, Eurostat. Jean-Claude Deville (1999). Variance estimation for complex statistics and estimators: linearization and residual techniques. Survey Methodology, 25, 193-203, URL http://www5.statcan.gc.ca/bsolc/olc-cel/olc-cel?lang=eng&catno=12-001-X19990024882.

See Also

varpoord , vardcrospoor, vardchangespoor

Examples

Run this code
data(eusilc)

dati <- data.table(IDd = 1:nrow(eusilc), eusilc)

# Full population
d <- linrmir(Y="eqIncome", id="IDd",  age="age", weight="rb050", 
                  Dom=NULL, dataset=dati, order_quant=50)
d$value

# By domains
dd <- linrmir(Y="eqIncome", id="IDd", age="age", weight="rb050", 
                     Dom="db040", dataset=dati, order_quant=50)

dd

Run the code above in your browser using DataLab