readoecd (version 0.3.0)

get_oecd_inequality: Get OECD income inequality data

Description

Downloads (and caches) the Gini coefficient of disposable income for OECD member countries from the OECD Income Distribution Database (IDD).

Usage

get_oecd_inequality(countries = "all", start_year = 1990, refresh = FALSE)

Value

A data frame with columns:

country

ISO 3166-1 alpha-3 country code (character)

country_name

English country name (character)

year

Calendar year (integer)

series

"GINI" (character)

value

Gini coefficient of disposable income (numeric)

unit

"Gini coefficient (0-1)" (character)

Arguments

countries

Character vector of ISO 3166-1 alpha-3 country codes, or "all" for all available OECD members. Defaults to "all". Run list_oecd_countries() to see available codes.

start_year

Numeric. Earliest year to include. Defaults to 1990.

refresh

Logical. If TRUE, re-download even if a cached copy exists. Defaults to FALSE.

Details

The Gini coefficient measures income inequality on a scale from 0 (perfect equality) to 1 (maximum inequality). Disposable income is household income after taxes and transfers. The series follows the OECD METH2012 methodology where available for consistency across countries and time.

Examples

# \donttest{
gini <- get_oecd_inequality(c("AUS", "GBR", "USA", "DNK"), start_year = 2000)
head(gini)
# }