Access to Spanish Household Income Distribution Atlas Data

Provides access to granular socioeconomic indicators from the Spanish Statistical Office (INE) Household Income Distribution Atlas. The package downloads and processes data from a companion 'GitHub' repository (< https://github.com/pablogguz/ineAtlas.data/>) which contains processed versions of the official INE Atlas data. Functions are provided to fetch data at multiple geographic levels (municipalities, districts, and census tracts), including income indicators, demographic characteristics, and inequality metrics. The data repository is updated every year when new releases are published by INE.

ineAtlas

The goal of ineAtlas is to provide easy access to granular socioeconomic indicators from the Spanish Statistical Office (INE) Atlas de Distribución de Renta de los Hogares (Household Income Distribution Atlas). This dataset combines administrative tax data with population statistics to provide detailed information about the income distribution and related socioeconomic indicators at the municipal, district, and census tract levels.

Data structure

The data is organized into several categories and is available at three geographic levels:

Municipality (Municipio)
District (Distrito)
Census tract (Sección censal)

Available datasets

Dataset	Description
Income	Income indicators including net/gross (equivalised) income per capita
Income sources	Income indicators by source (wages, pensions, benefits, etc.)
Demographics	Population characteristics including age structure and household composition
Distribution by sex	Income distribution indicators disaggregated by sex
Distribution by sex and age	Income distribution indicators by sex and age categories
Distribution by sex, age and nationality	Income distribution indicators by sex and nationality status
Inequality indicators	Inequality metrics including Gini coefficient and P80/P20 ratio

All the data is stored in the accompanying ineAtlas.data repository. You can find the data dictionary and more information about the data structure at https://pablogguz.github.io/ineAtlas.data/.

Installation

You can install the released version of ineAtlas from CRAN with:

install.packages("ineAtlas")

Alternatively, you can install the development version from GitHub with:

# install.packages("pak")
pak::pak("pablogguz/ineAtlas")

Example

Here's a basic example of fetching census tract-level income data:

library(ineAtlas)

# Get municipality-level income data
income_data <- get_atlas("income", "tract")

# View the first few rows
head(income_data)

Contributing

Contributions are welcome! Please feel free to submit a pull request. For major changes, please open an issue first to discuss what you would like to change.

References

Spanish Statistical Office (2024). Household Income Distribution Atlas. Retrieved from https://www.ine.es/en/experimental/atlas/experimental_atlas_en.htm/ [Accessed October 29, 2024]

Latest data release: October 29, 2024