colpafs2: Many decomposed PaF income polarization indices

In DER: Income Polarization Index

Many decomposed PaF income polarization indices

Description

Many decomposed PaF income polarization indices

Usage

colpafs2(y, a, ncores = 1)

Arguments

y	A numeric matrix with income data. The PaF index will be computed for each column seperately.
a	The value of \alpha, a number between 0.25 and 1.
ncores	The number of cores to use. If greater than 1, parallel computing will take place. It is advisable to use it if you have many observations and or many variables, otherwise it will slow down the process. The default is 1, meaning that code is executed serially.

Details

The function compute the decomposed PaF index of Duclos, Esteban and Ray (2004) for a specific value of \alpha, for each column of the matrix. The decomposition is with respect to the deprivation and surplus components as suggested by Araar (2008).

Value

A matrix, where each row contains the PaF index, the deprivation and the surplus components.

Author(s)

Michail Tsagris and Christos Adam.

R implementation and documentation: Michail Tsagris [e-mail] and Christos Adam [e-mail].

References

Araar A. (2008). On the Decomposition of Polarization Indices: Illustrations with Chinese and Nigerian Household Surveys. CIRPEE Working Paper No. 08-06. https://papers.ssrn.com/sol3/papers.cfm?abstract_id=1136142

Duclos J. Y., Esteban, J. and Ray D. (2004). Polarization: concepts, measurement, estimation. Econometrica, 72(6): 1737–1772.

See Also

paf2, colpafs

Examples

y <- matrix( rgamma(100 * 10, 10, 0.01), ncol = 10 )
colpafs2(y, 0.25)

DER documentation built on Nov. 13, 2025, 1:07 a.m.