social_welfare_impact {GiniDecompLY}

Growth-redistribution impacts on social welfare function.

Description

This function provides a Growth-redistribution decomposition of effects (for each income source) on social welfare function defined by Amartya Sen (1970, ISBN:978-0-444-85127-7).

Usage

social_welfare_impact(.data, ..., .by = NULL, .wgt = NULL)

Arguments

.data

A data frame, or data frame extension (e.g. a tibble)

...

One or more unquoted expressions separated by commas indicating income sources to consider in the decomposition. Variable names can be used as if they were positions in the data frame.

.by

A column to group the calculations by.

.wgt

an optional vector of weights to apply in computation. Should be NULL or a numeric vector.

Details

It provides a set of indicators :

• income_source: Column indicating each income source passed into the function call.

• Share: Column indicating the share of the income source to the total income.

• Gini: Column showing the Gini index for each income source.

• Gini_corr: Column showing the Gini correlation between the income source and the total income.

• Growth_Effect: Column indicating the effect of growth in the income source on the Social Welfare Function.

• Redistribution_Effect: Column indicating the effect of redistribution of the income source on the Social Welfare Function.

• Total_Variation: Column adding up both effects to calculate the overall effect of each income source on the Social Welfare Function.

Value

An object of class data.frame containing all the calculated indicators. The data.frame is grouped by the columns passed into .by argument.

Examples

sample_income_data %>%
  social_welfare_impact(wage, self_employment_rev, farming_rev, other_rev,
  .wgt = sample_wgt)

social_welfare_impact(sample_income_data, 3:6, .by = region, .wgt = sample_wgt)