fs_var: Fuzzy supplementary poverty estimation.

In FuzzyPovertyR: Estimation of Fuzzy Poverty Measures

Fuzzy supplementary poverty estimation.

Description

Fuzzy supplementary poverty estimation.

Usage

fs_var(
  data,
  weight = NULL,
  ID = NULL,
  dimensions,
  HCR,
  breakdown = NULL,
  alpha,
  rho = NULL,
  type = "bootstrap_naive",
  R = 500,
  M = NULL,
  stratum,
  psu,
  f = 0.01,
  Xs,
  total,
  verbose = TRUE
)

Arguments

data	A matrix or data frame of items
weight	A numeric vector of sampling weights of length nrow(step1). if NULL weights will set equal to n (n = sample size)
ID	A numeric or character vector of IDs. if NULL (the default) it is set as the row sequence
dimensions	A numeric vector (of length ncol(data)) of assignments of items in data to dimensions
HCR	The value of the head count ratio used to compute alpha so that the expected value of the membership function equals HCR
breakdown	A factor of sub-domains to calculate estimates for (using the same alpha). If numeric will be coerced to a factor
alpha	The value of the exponent in equations of "verma", "verma1999" and "TFR". If NULL it is calculated so that it equates the expectation of the membership function to HCR.
rho	Optional critical value to be used for calculation of weights in the Kendall correlation matrix. If NULL rho is set equal to the point of largest gap between the ordered set of correlation values encountered (see Betti and Verma, 2008)
type	The variance estimation method chosen. One between bootstrap_naive (default), bootstrap_calibrated or jackknife
R	The number of bootstrap replicates. Default is 500
M	The size of bootstrap samples. Default is nrow(data)
stratum	The vector identifying the stratum (if 'jackknife' is chosen as variance estimation technique)
psu	The vector identifying the psu (if 'jackknife' is chosen as variance estimation technique)
f	The finite population correction fraction (if 'jackknife' is chosen as variance estimation technique
Xs	A matrix (i x j) of calibration variables. i number of units, j number of variables
total	A Vector of population totals of dimension 1 x j
verbose	Logical. whether to print the proceeding of the variance estimation procedure

Value

An object of class FuzzySupplementary containing the estimated variance.

References

Betti, G., & Verma, V. (2008). Fuzzy measures of the incidence of relative poverty and deprivation: a multi-dimensional perspective. Statistical Methods and Applications, 17, 225-250.

Betti, G., Gagliardi, F., Lemmi, A., & Verma, V. (2015). Comparative measures of multidimensional deprivation in the European Union. Empirical Economics, 49(3), 1071-1100.

Betti, G., Gagliardi, F., & Verma, V. (2018). Simplified Jackknife variance estimates for fuzzy measures of multidimensional poverty. International Statistical Review, 86(1), 68-86.

Examples

#This example is based on the dataset eusilc included in the package
#The  variance of the FS index is compute without breakdown
#and using an alpha = 2

#############
##Bootstrap##
#############

fs_var(data = eusilc[,4:23], weight = eusilc$DB090, ID = NULL,
       dimensions = c(1,1,1,1,2,2,2,2,2,3,3,3,3,4,4,4,4,5,5,5),
       breakdown = NULL, alpha = 2,
       rho = NULL, type = 'bootstrap_naive', M = NULL, R = 2, verbose = TRUE)

FuzzyPovertyR documentation built on Oct. 3, 2024, 5:06 p.m.