fm_construct {FuzzyPovertyR}R Documentation

Fuzzy monetary poverty estimation

Description

fm_construct constructs fuzzy monetary poverty estimates.

Usage

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
)

Arguments

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.

Details

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)$

Value

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.

Examples

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)

[Package FuzzyPovertyR version 2.0.1 Index]