Distributive Analysis Stata Package (DASP)

Main objective of the DASP project

The main purpose of this project is to produce a comprehensive package of Stata modules to help analyze the distribution of living standards. It is hoped
that this will be useful for measurement as well as for policy purposes.

DASP is freely distributed and freely available. Please acknowledge its use by quoting it as:  

Araar Abdelkrim and Jean-Yves Duclos (2007), "DASP: Distributive Analysis  Stata Package", PEP, World Bank, UNDP and Université Laval.

Features of the DASP Package

  • Estimate the most popular statistics (indices, curves) used for the analysis of poverty, inequality, social welfare, and equity;
  • Estimate the differences in such statistics;
  • Estimate standard errors and confidence intervals by taking full account of survey design;
  • Support distributive analysis on more than one data base;
  • Perform the most popular distributive decomposition procedures;
  • Check for the ethical robustness of distributive comparisons;
  • Unify syntax and parameter use across various estimation procedures for distributive analysis.

Stata and distributive analysis

The Stata software has become a very popular tool to transform and process data. It comes with a large number of basic data management modules that are highly efficient for transformation of large datasets. The flexibility of Stata also enables programmers to provide specialized .adoroutines to add to the power of the software. This is indeed how DASPinteracts with Stata. DASP, which stands for Distributive Analysis Stata Package, is mainly designed to assist researchers and policy analysts interested in conducting distributive analysis with Stata.

 

Jump to:   About DASP   DASP Manuals   DASP Modules   Install DASP Modules    Contact

About DASP

Why use the Stata software?

The Stata software has become in the last 20 years a very popular tool to transform and process data. It comes with a large number of basic data management modules that are efficient for working with large datasets. The flexibility of Stata also enables programmers to provide specialized .ado routines to add to the power of the software.

How can DASP be helpful?

DASP (Distributive Analysis Stata Package) can be used to perform distributive analysis. 

What is already available in Stata for distributive analysis?

Some Stata .ado files already exist for the computation of some specific distributive indices or for plotting some distributive curves.  The available modules often have, however, the following disadvantages:

  • They do not have an unified syntax;
  • In some cases, basic options such as those for weighting data, are not available;
  • Standard errors are not provided or do not take into account survey survey design effects.

In which way does DASP differ from these available modules?

DASP's modules are designed to:

  • estimate most of the popular indices and curves in the field of distributive analysis;
  • support the use of more than one data base;
  • perform the most popular decomposition procedures;
  • unify the syntax and the provision of parameters;
  • provide systematically standard errors that take into account survey design effects.

Another program

Distributive Analysis / Analyse Distributive (DAD) [webpage coming soon]

  • Freely distributed (i.e., does not require purchasing any commercial software)

  • Very user friendly; 

  • Provides a broad coverage of distributive analysis;

  • Limited to 30 variables; 

  • Not designed to provide basic data processing tools;

  • Does not support the use of data with missing values.

DASP Manuals

User manual of DASP version 3.0

Araar, Abdelkrim, Jean-Yves Duclos (2021) "User Manual for Stata Package DASP: Version 3.0", PEP, World Bank, UNDP and Université Laval.

Recommended and freely available analytical manual 

Duclos Jean-Yves and Abdelkrim Araar (2006): Poverty and Equity
Measurement, Policy, and Estimation with DAD
, Berlin and Ottawa: Springer and IDRC

 

DASP Modules

Inequality

INEQ

Estimates inequality  indices and theirs standard errors taking full account of survey design.

- Gini index.
- Absolute Gini index.
- Concentration index.
- Absolute concentration index.
- Atkinson index.
- Generalised entropy index.
- Coefficient of variation index.
- Quantile ratio index.
- Share ratio index.

DINEQ Estimates the difference between inequality indices and its standard error taking full account of survey design.

Multidimensional inequality

IMDI Multidimensional inequality indices (Araar 2009)

Polarisation

IPOLA
 

Estimates the polarisation indices and theirs standard errors taking full account of survey design.

- Duclos Esteban and Ray index of polarization (2004).
- Foster and Wolfson (1992).
- Esteban, Gradin and Ray (1999).
- INaki Permanyer (2008).

DIPOLA
 

Etimates the difference between polarisation indices and its standard error taking full account of survey design

Poverty

IPOV

Estimates the poverty indices and their standard errors taking full account of survey design.

- FGT index.
- Normalised FGT index.
- EDE-FGT indices.
- Normalised EDE-FGT index.
- Watts poverty index.
- Sen-Shorrocks-Thon poverty indices.

DIPOV Estimates the difference between poverty indices and its standard error taking full account of survey design.

Multidimensional poverty

IMDPOV

 

Estimates the  multidimensional poverty indices and theirs standard errors taking full account of survey design.

- Chakravarty, Mukherjee, and Ranade (1998) MD poverty index.
- Extended Watts MD Poverty Index.
- Multiplicative FGT index.
- Tsui_2002 index.
- Intersection MD Poverty Index.
- Union Headcount MDl Poverty Index.
- Bourguignon and Chakravarty_2003 MD Poverty Index.
- Alkire and Foster (2011) MD Poverty Index.

IMODA

 

 

 

Multiple Overlapping Deprivation Analysis indices:

The imoda DASP module produces a series of multidimensional poverty indices in order to show the incidence of deprivation in each dimension. Further, this application estimates the incidence of multi-deprivation in the different combinations of dimensions.
 

Pro-poor

IPROPOOR

To estimate FGT pro-poor indices and its standard error taking full account of survey design. Indices are:

[1] Chen and Ravallion index (2003);
[2] Kakwani & Pernia (2000) index ;
[3] Kakwani, Khandker and Son (2003) -PEGR- index.

GICUR

To draw the growth incidence curve and its confidence interval.

CPROPOORP

To estimate absolute and relative pro-poor curves with the primal approach.

CPROPOORD To estimate absolute and relative pro-poor curves with the dual approach.

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Detailed description:

Let the following notation:

Q(p) : quantile at percentile p.
GL(p) : generalised Lorenz at percentile p.
mu : average income.

[1] First-order absolute pro-poor curves
Select one of the two curves:

DELTA(p) = Q_2(p) - Q_1(p)
Or
DELTA(p) = ( Q_2(p) - Q_1(p) ) / Q_1(p)


[2] Second-order absolute pro-poor curves

Select one of the two curves:

DELTA(p) = GL_2(p) - GL_1(p)
Or
DELTA(p) = ( GL_2(p) - GL_1(p) ) /GL_1(p)

[3] First-order relative pro-poor curves
Select the curve:

DELTA(p) = Q_2(p)/Q_1(p) - mu_2/mu_1

[4] Second-order relative pro-poor curves

Select the curve:

DELTA(p) = GL_2(p)/GL_1(p) - mu_2/mu_1

Poverty elasticities

EFGTGR

FGT-Elasticity with respect to growth in average income (Kakwani (1993)).

EFGTINEQ

FGT-Elasticity with respect to Gini inequality (Kakwani (1993)).

EFGTG

FGT-Elasticity with respect to the within/between group components of inequality.

EFGTC

FGT-Elasticity with respect to the within/between income components of inequality.

EFGTGRO Poverty elasticity -semi elasticity- with respect to growth with different approaches of estimation.
EFGTINE Poverty elasticity -semi elasticity- with respect to inequality with different approaches of estimation.

Poverty targeting

ITARGETG

The module itargetg produces the following estimates and curves for a given list of population groups:

  • Impact of targeting population groups on FGT indice

  • Impact of targeting population groups on FGT curves (along an axis of poverty lines)

  • The confridence interval of the impact of targeting population groups on FGT curves (along an axis of poverty lines).

OGTPR

Poverty and targeting by population groups with a fixed budget.

ITARGETG2D

Bi-dimensional poverty and targeting by population groups.

ITARGETC

The module itargetc produces the following estimates and curves for a given list of population groups:

  • Impact of targeting welfare components on FGT indice;

  • Impact of targeting welfare components on on FGT curves (along an axis of poverty lines);

  • The confidence interval of targeting welfare components on FGT curves (along an axis of poverty lines).

Decomposition

DFGTG

Decomposes FGT poverty indices by groups and provides standard errors on various elements of the decompositions.

DFGTGR To decompose the variation in FGT index between two periods into growth and redistribution
components. Approaches of decomposition are: (see the detailed description bellow).
  1. The Datt and Ravallion approach (1991).
  2. The Shapley approach.
DTCPOV To decompose poverty into transient and chronic components
  1. The Jallan and Ravallion (1998) approach.
  2. The Duclos, Araar and Giles (2006) approach.
DFGTS

The command dfgts decomposes the allevation of FGT poverty by income components and provides standard errors on elements of the decompositions. Without any source, the FGT index equals 1. The decomposition is performed using the Shapley value.

DENTROPYG Decomposes generalized entropy index of inequality by groups and provides standard errors on elements of the decompositions.
DIGINIG Decomposes the Gini index (or the absolute one) by population subgroups.
DIGINIS Decomposes the Gini index by income sources. Approaches of decomposition are:
  1. The Rao's approach (1969);
  2. The Lerman and Yitzhaki approach (1985);
  3. The Araar approach (2006).
DSGINIS Decomposes the Gini index by income sources with the Shapley approach.
DPOLAG Decomposes the Duclos, Esteban amd Ray polarization index  by population subgroups (Araar (2008) aproach).
DPOLAS Decomposes the Duclos, Esteban amd Ray polarization index  by income components (Araar (2008) aproach).
RBDINEQ

 

 

 

 

The command rbdineq use the regression based decomposition approach to decompose inequality indices by income covariates.
The decomposition is performed using the Shapley value or the analytical approach. With the Shapley approach, the user can
select among the following inequality indices:

  • Gini
  • Atkinson
  • Coefficient of variation
  • Generalised entropy
DSINEQS Decomposes inequality indices by income sources with the Shapley approach (Gini/Atkinson/Generalised Entropy/Coefficient of variantion).
DMDAFG

Decomposes Alkire and Foster (2007) multidimensional poverty indices by groups and provides standard errors on various elements of the decompositions.

DFGTG2D Sectoral decomposition of the change in FGT index between two periods.
DMDAFG Decomposes Alkire and Foster (2007) multidimensional poverty indices by groups and provides standard errors on various elements of the decompositions.
DMDAFS Decomposes Alkire and Foster (2007) M.D. poverty indices by dimensions using the Shapley value approach.

Dominance

DOMPOV

To test the poverty dominance and to estimate the critical values (values for witch the two dominance curves cross) .

DOMINEQ

To test the inequality dominance based on Lorenz curves and to estimate the critical values (percentile values for witch the two Lorenz curves cross).

DOMBDPOV

To estimate the differences between bi-dimensional multiplicative FGT poverty (BD-FGT) surfaces with confidence interval.

Curves

CLORENZ

Produces the following curves and theirs confidence intervals for a given list of variables:

  • Lorenz curves;

  • Generalized Lorenz curves;

  • Absolute Lorenz curves;

  • Concentration curves;

  • Generalized concentration curves;

  • Absolute concentration curves;

  • Deficit share curves;

  • Differences between curves.

DICLORENZ

Produces the difference between the following curve with confidence interval

  • (Generalized) Lorenz curves;

  • (Generalized) Concentration curves.

CFGT

Produces the following curves and theirs confidence intervalsfor a given list of variables:

  • Normalised FGT curves;

  • FGT curves.

DICFGT

Produces the difference between the following curve with confidence interval

  • Normalised FGT curves;

  • FGT curves.

CPOVERTY

Produces the following curves for a given list of variables:

  • Poverty gap curves;

  • Cumulative poverty curves.

CDOMC

 

Produces the following curve with confidence interval

  • Normalised consumption dominance curves;

  • Consumption dominance curves.

CDOMC2D

Produces the difference between the following curve with confidence interval

  • Normalised consumption dominance curves;

  • Consumption dominance.

CPROG


The module cprog produces the progressivity curves (PR(p)) for a given list of variables (components).


Let x be a gross income.
. A tax t is Tax Redistribution (TR) progressive if:
. PR(p) = L_x(p) - C_t(p) > 0 for all p in ]0, 1[

. A transfer b is Tax Redistribution (TR) progressive if:
. PR(p) = C_b(p) - L_x(p) > 0 for all p in ]0, 1[

. A tax t is Income Redistribution (IR) progressive if:
. PR(p) = C_x-t(p) - L_x(p) > 0 for all p in ]0, 1[

. A transfer b is Income Redistribution (IR) progressive
. PR(p) = C_x+b(p) - L_x(p) > 0 for all p in ]0, 1[
 

CPROGBT

The module cprogbt produces the progressivity curves to check if the tranfer b is more progressive that the tax t.(components).


Let x be a gross income.
. A transfer B is more Tax Redistribution (TR) than the tax T if:
. PR(p) = C_b(p) + C_t(p)- 2L_x(p) > 0 for all p in ]0, 1[


. A transfer B is more Income Redistribution (IR) than the tax T if:
. PR(p) = C_x+b(p) - C_x-t(p) > 0 for all p in ]0, 1[

Distributive tools

CDENSITY

Produces the density curves

C_QUANTILE

Produces the following curves for a given list of variables:

  • Quantile curves;

  • Normalised quantile curves;

QUINSH

Estimate the income shares and cumulative income shares by group quantiles (quartiles/quintiles/deciles/etc.). Graph bar of income shares can be plotted.

CNPE

Produces the following curves for a given list of variables:

  • Non parametric regression curves;

  • Non parametric derivative regression curves;

SJDENSITY

 

Produces a bidimensional joint density in the form of a surface. The Gaussian kernel approach is used to estimate that density.

SJDISTRUB

Produces a joint distribution function in the form of a two-dimensional surface.

IMEAN Estimates the statistic average -mean- and their standard errors taking full account of survey design.
DIMEAN Estimates the difference between averages -means-  and its standard error taking full account of survey design.
IPROP Estimates the statistic proportion of groups  and their standard errors taking full account of survey design.
DIPROP Estimates the difference change in proportion of groups  and theirs standard errors taking full account of survey design.

Benefit analysis

BIAN

Produces statistics based on the Benefit Incidence Analysis

IMBI

Marginal benefit incidence analysis

Disaggregating data

UNGROUP

The command ungroup generates disaggregated data using information on the aggregated data and on the form of the distribution to be assumed.

Install DASP

To install DASP 3.0 , execute the following:

 

Server 1

set more off
net from https://www.pep-net.org/sites/pep-net.org/files/dasp3
net install dasp_p1, force
net install dasp_p2, force
net install dasp_p3, force
net install dasp_p4, force
net install dasp_p5, force
net install dasp_p6, force
cap adddmenu profile.do _daspmenu
cap add_data_examples

 

Install DASP 3.0 with a zipped folder:

Download the zipped folder dasp3

1- Unzip  and copy the folder in a given directory, ex: C:/temp/dasp3
2- Run the following Stata commands:

set more off
net from C:/temp/dasp3
net install dasp_p1, force
net install dasp_p2, force
net install dasp_p3, force
net install dasp_p4, force
net install dasp_p5, force
net install dasp_p6, force
cap adddmenu profile.do _daspmenu
cap add_data_examples

 

Contact

For assistance, please contact Dr. Abdelkrim Araar at aabd@ecn.ulaval.ca

FUNDED BY

Logo global affairs canada
Logo Hewlett Foundation
Logo IDRC - CRDI Canada
Logo Mastercard Foundation
European Union
Fonds d'innovation pour le Développement
Global Education Analytics Institute