deprived: Specify a deprivation cutoff for use in 'compute_mpi'

In mpindex: Multidimensional Poverty Index (MPI) via the Alkire-Foster Method

Specify a deprivation cutoff for use in compute_mpi

Description

A helper that captures a bare deprivation cutoff expression and optional per-indicator settings for use inside the deprivations argument of compute_mpi.

Usage

deprived(.cutoff, .data = NULL, collapse_fn = NULL, set_na_equal_to = 0, ...)

Arguments

.cutoff	A bare logical expression evaluated against the indicator's data frame. Rows where this evaluates to TRUE are considered deprived.
.data	An optional data frame to use for this indicator instead of the primary .data passed to compute_mpi. Useful when one or more indicators are at a different unit of analysis (e.g. person-level roster).
collapse_fn	An optional function applied to collapse roster-level data to the unit-of-analysis level (e.g. max to flag a household as deprived if any member is deprived). If NULL (default), no collapsing is performed. NAs are removed before calling the function; if all values are NA the result is NA.
set_na_equal_to	Coerce NA deprivation values to 0 (not deprived, default) or 1 (deprived).
...	Reserved; passing old dotted names (e.g. .collapse_fn) triggers a helpful error.

Value

An object of class mpi_d.

See Also

compute_mpi

Examples

deprived(drinking_water == 2)
deprived(undernourished == 1 & age < 70, .data = df_household_roster, collapse_fn = max)

mpindex documentation built on Oct. 4, 2026, 5:07 p.m.