ineAtlas.data
Data repository for the ineAtlas R package
This is the companion data repository for the ineAtlas R package. It contains processed and standardized data from the Spanish Statistical Office (INE) Household Income Distribution Atlas (Atlas de Distribución de Renta de los Hogares), which combines administrative tax data with population statistics to provide detailed information about the income distribution and related socioeconomic indicators at multiple geographic levels in Spain. The repository also includes boundary files for census tracts.
Geographic levels
Data is available at three geographic levels:
- Municipality (Municipio)
- District (Distrito)
- Census tract (Sección censal)
Available datasets
The repository contains the following datasets:
| Dataset | Description | Files |
|---|---|---|
| Income | Income indicators including net/gross income per capita and household income | income_*.csv |
| Income sources | Income distribution by source (wages, pensions, benefits, etc.) | income_sources_*.csv |
| Demographics | Population characteristics including age structure and household composition | demographics_*.csv |
| Distribution by sex | Income distribution indicators disaggregated by sex | distribution_sex_*.csv |
| Distribution by sex and age | Income distribution indicators by sex and age groups | distribution_sex_age_*.csv |
| Distribution by sex and nationality | Income distribution indicators by sex and nationality status | distribution_sex_nationality_*.csv |
| Inequality indicators | Inequality metrics including Gini coefficient and P80/P20 ratio | gini_p80p20_*.csv |
| Census tract geometries | Census tract boundary files (2015-2022) | census_tracts_*.gpkg.zip |
Usage with ineAtlas package
While this data can be used independently, it’s designed to work seamlessly with the ineAtlas R package, which provides functions for easily accessing the data:
# install.packages("pak")
pak::pak("pablogguz/ineAtlas")
library(ineAtlas)See the ineAtlas package documentation for complete usage instructions and examples.
Updates
The data in this repository is updated when new releases of the Household Income Distribution Atlas are published by INE. Updates are processed using the pipeline in the main ineAtlas repository.
Metadata
You can find the metadata and full methodology in the Spanish Statistical Office (INE) website.
Data for the census tract geometries are sourced from the INE’s Digital Cartography Files.
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