fm_construct {FuzzyPovertyR} | R Documentation |
fm_construct
constructs fuzzy monetary poverty estimates.
fm_construct(
predicate,
weight = NULL,
fm = "verma",
ID = NULL,
HCR,
interval = c(1, 10),
alpha = NULL,
hh.size,
z_min,
z_max,
z1,
z2,
b,
z,
breakdown = NULL,
data = NULL,
verbose = FALSE
)
predicate |
A numeric vector representing the poverty predicate (i.e. income or expenditure) |
weight |
A numeric vector of sampling weights. if NULL simple random sampling weights will be used. |
fm |
The membership function (default is "verma". Other options are "ZBM", "belhadj", "chakravarty", "cerioli", "verma1999" and "TFR". See Betti et. al (2023) The fuzzy approach to poverty measurement. Research handbook of measuring poverty and deprivation (ed. by J. Silber)) |
ID |
A numeric or character vector of IDs. if NULL (the default) it is set as the row sequence. |
HCR |
If fm="verma" or fm="verma1999" or fm="TFR" . The value of the head count ratio. |
interval |
If fm="verma" or fm="verma1999" or fm="TFR". A numeric vector of length two to look for the value of alpha (if not supplied). |
alpha |
If fm="verma" or fm="verma1999" or fm="TFR". The value of the exponent in equation $E(mu)^(alpha-1) = HCR$. If NULL it is calculated so that it equates the expectation of the membership function to HCR |
hh.size |
If fm="ZBM". A numeric vector of household size. |
z_min |
A parameter of the membership function if fm="belhadj2011" |
z_max |
A parameter of the membership function if fm="belhadj2011" |
z1 |
A parameter of the membership function if fm="belhadj2015" or fm="cerioli" |
z2 |
A parameter of the membership function if fm="belhadj2015" or fm="cerioli" |
b |
A parameter of the membership function if fm="belhadj2015". The shape parameter (if b=1 the mf is linear between z1 and z2) |
z |
A parameter of the membership function if fm="chakravarty". |
breakdown |
A factor of sub-domains to calculate estimates for (using the same alpha). |
data |
an optional data frame containing the variables to be used. |
verbose |
Logical. whether to print the proceeding of the procedure. |
It implements the fuzzy set approach to monetary poverty measurement where the usual dichotomy poor (1) not-poor(0) is replaced with a continuum score in $(0,1)$
an object of class FuzzyMonetary containing the (fuzzy) membership function for each individual in the sample,
the estimated expected value (estimate
) of the function and the parameters of the
membership functions (supplied or calculated). If breakdown is supplied it gives an output for each level.
data(eusilc)
HCR <- .154
hh.size <- sample(1:4, 1000, replace = TRUE)
fm_construct(predicate = eusilc$eq_income, weight = eusilc$DB090,
fm = "verma", HCR = HCR, ID = eusilc$ID)