Title: | Income Polarization Index |
---|---|
Description: | The DER (or PaF) income polarization index as proposed by Duclos J. Y., Esteban, J. and Ray D. (2004). "Polarization: concepts, measurement, estimation". Econometrica, 72(6): 1737--1772. <doi:10.1111/j.1468-0262.2004.00552.x>. The index may be computed for a single or for a range of values of the alpha-parameter. Bootstrapping is also available. |
Authors: | Michail Tsagris [aut, cre] |
Maintainer: | Michail Tsagris <[email protected]> |
License: | GPL (>= 2) |
Version: | 1.0 |
Built: | 2025-02-24 19:19:47 UTC |
Source: | CRAN |
Description: The PaF income polarization index as proposed by Duclos J. Y., Esteban, J. and Ray D. (2004). "Polarization: concepts, measurement, estimation". Econometrica, 72(6): 1737–1772. The index may be computed for a single or for a range of values of the -parameter and bootstrapping is also available. In all cases, we first divide the data by
, where
is the mean (income), as described in Duclos, Esteban and Ray (2004). If you want to make the index comparable to the Gini index you should divide the alienation component (and the paf eventually) by 2.
Package: | DER |
Type: | Package |
Version: | 1.0 |
Date: | 2025-02-22 |
Michail Tsagris <[email protected]>.
Michail Tsagris [email protected]
Duclos J. Y., Esteban, J. and Ray D. (2004). Polarization: concepts, measurement, estimation. Econometrica, 72(6): 1737–1772.
Bootstrapping the decomposed PaF income polarization index
paf2.boot(y, a, R = 1000)
paf2.boot(y, a, R = 1000)
y |
A numeric vector with income data. |
a |
The value of |
R |
The number of bootstrap resamples to perform. |
The function computes the decomposed PaF index of Duclos, Esteban and Ray (2004) for a specific value of . The decomposition is with respect to the deprivation and surplus components as suggested by Araar (2008). The PaF index, the deprivation and surplus components, and also their bootstrap estimates, the estimated bias and the estimated standard error of each, and the confidence intervals are returned.
A list including:
boot |
A matrix with the bootstrap estimates. |
index |
The estimates. |
info |
A matrix with: the bootstrap based estimates, the bootstrap estimated bias of the estimates, the bootstrap estimated standard errors of the estimates, and the 95% percentile bootstrap confidence intervals for each component. |
Michail Tsagris.
R implementation and documentation: Michail Tsagris [email protected].
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.
y <- rgamma(100, 10, 0.01) paf2.boot(y, 0.25)
y <- rgamma(100, 10, 0.01) paf2.boot(y, 0.25)
Bootstrapping the PaF income polarization index
paf.boot(y, a, R = 1000)
paf.boot(y, a, R = 1000)
y |
A numeric vector with income data. |
a |
The value of |
R |
The number of bootstrap resamples to perform. |
The function compute the PaF index of Duclos, Esteban and Ray (2004) for a specific value of , the alienation and identification components, the 1 + normalized covariance, and also their bootstrap estimates, the estimated bias, the estimated standard error of each and the percentile bootstrap confidence interval for the PaF index are returned.
A list including:
boot |
A matrix with the bootstrap estimates. |
index |
The estimates. |
info |
A matrix with: the bootstrap based estimates, the bootstrap estimated bias of the estimates, the bootstrap estimated standard errors of the estimates, and the 95% percentile bootstrap confidence intervals for each component. |
Michail Tsagris.
R implementation and documentation: Michail Tsagris [email protected].
Duclos J. Y., Esteban, J. and Ray D. (2006). Polarization: concepts, measurement, estimation. In The Social Economics of Poverty (pp. 54–102). Routledge.
Duclos J. Y., Esteban, J. and Ray D. (2004). Polarization: concepts, measurement, estimation. Econometrica, 72(6): 1737–1772.
y <- rgamma(100, 10, 0.01) paf.boot(y, 0.25)
y <- rgamma(100, 10, 0.01) paf.boot(y, 0.25)
Many decomposed PaF income polarization indices
colpafs2(y, a)
colpafs2(y, a)
y |
A numeric matrix with income data. The PaF index will be computed for each column sperately. |
a |
The value of |
The function compute the decomposed PaF index of Duclos, Esteban and Ray (2004) for a specific value of , for each column of the matrix. The decomposition is with respect to the deprivation and surplus components as suggested by Araar (2008).
A matrix, where each row contains the PaF index, the deprivation and the surplus components.
Michail Tsagris.
R implementation and documentation: Michail Tsagris [email protected].
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.
y <- matrix( rgamma(100 * 10, 10, 0.01), ncol = 10 ) colpafs2(y, 0.25)
y <- matrix( rgamma(100 * 10, 10, 0.01), ncol = 10 ) colpafs2(y, 0.25)
Many PaF income polarization indices
colpafs(y, a)
colpafs(y, a)
y |
A numeric matrix with income data. The PaF index will be computed for each column sperately. |
a |
The value of |
The function compute the PaF index of Duclos, Esteban and Ray (2004) for a specific value of , for each column of the matrix.
A matrix, where each row contains the PaF index, the alienation (twice the Gini index) and identification components and 1 + the normalized covariance.
Michail Tsagris.
R implementation and documentation: Michail Tsagris [email protected].
Duclos J. Y., Esteban, J. and Ray D. (2006). Polarization: concepts, measurement, estimation. In The Social Economics of Poverty (pp. 54–102). Routledge.
Duclos J. Y., Esteban, J. and Ray D. (2004). Polarization: concepts, measurement, estimation. Econometrica, 72(6): 1737–1772.
y <- matrix( rgamma(100 * 10, 10, 0.01), ncol = 10 ) colpafs(y, 0.25)
y <- matrix( rgamma(100 * 10, 10, 0.01), ncol = 10 ) colpafs(y, 0.25)
The decomposed PaF income polarization index
paf2(y, a)
paf2(y, a)
y |
A numeric vector with income data. |
a |
The value of |
The function compute the decomposed PaF index of Duclos, Esteban and Ray (2004) for either a specific value, or for a range of values, of . The decomposition is with respect to the deprivation and surplus components as suggested by Araar (2008).
For a single value of , the function returns a vector with the PaF index, the deprivation and the surplus components. If a range of values of
are given, it will return a matrix with the same components, where each row corresponds to a specific value of
.
Michail Tsagris.
R implementation and documentation: Michail Tsagris [email protected].
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.
y <- rgamma(100, 10, 0.01) paf(y, 0.25) paf2( y, 0.25)
y <- rgamma(100, 10, 0.01) paf(y, 0.25) paf2( y, 0.25)
The PaF income polarization index
paf(y, a) pafF(y, a)
paf(y, a) pafF(y, a)
y |
A numeric vector with income data. |
a |
The value of |
The functions compute the PaF index of Duclos, Esteban and Ray (2004) for either a specific value, or for a range of values, of . The pafF() estimates the index using Eq. (8) and (9) in the paper, whereas paf() is faster as it uses Eq. (3) of the paper.
The paf() function, for a single value of , returns a vector with the PaF index, the alienation (twice the Gini index) and identification components and 1 + the normalized covariance. If a range of values of
are given, it will return a matrix with the same components, where each row corresponds to a specific value of
.
The pafF() function returns only the PaF index for either one or more values of .
Michail Tsagris.
R implementation and documentation: Michail Tsagris [email protected].
Duclos J. Y., Esteban, J. and Ray D. (2006). Polarization: concepts, measurement, estimation. In The Social Economics of Poverty (pp. 54–102). Routledge.
Duclos J. Y., Esteban, J. and Ray D. (2004). Polarization: concepts, measurement, estimation. Econometrica, 72(6): 1737–1772.
y <- rgamma(100, 10, 0.01) paf(y, 0.25) paf( y, c(0.25, 0.5, 0.75, 1) )
y <- rgamma(100, 10, 0.01) paf(y, 0.25) paf( y, c(0.25, 0.5, 0.75, 1) )