ineAtlas: Access to Spanish Household Income Distribution Atlas Data

Description

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.

Author(s)

Maintainer: Pablo García Guzmán garciagp@ebrd.com [copyright holder]

See Also

Useful links:

• https://github.com/pablogguz/ineAtlas

• https://pablogguz.github.io/ineAtlas/

• Report bugs at https://github.com/pablogguz/ineAtlas/issues

Fetch data from the ineAtlas data repository

Description

Downloads and extracts compressed data files from the ineAtlas data repository, providing access to various socioeconomic indicators at different geographic levels.

Usage

get_atlas(category, level, cache = TRUE, cache_dir = tempdir())

Arguments

Value

A tibble containing the requested data. Distribution data will include additional columns for demographic breakdowns (sex, age, nationality). The data is automatically extracted from compressed files and cached locally if requested.

Note

Data files are stored compressed on the repository to reduce size and download times. The function handles decompression automatically.

Examples

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

# Get district level demographics without caching
demo_data <- get_atlas("demographics", "district", cache = FALSE)

# Get income distribution indicators by sex
sex_dist <- get_atlas("distribution_sex", "municipality")

# Get inequality indicators including Gini coefficient
gini_data <- get_atlas("gini_p80p20", "municipality")

Fetch 2021 Census data from the ineAtlas data repository

Description

Downloads and extracts compressed census data files from the ineAtlas data repository, providing access to detailed demographic, socioeconomic and housing indicators at different geographic levels from the 2021 Population and Housing Census.

Usage

get_census(level, cache = TRUE, cache_dir = tempdir())

Arguments

Value

A tibble containing the requested census data at the specified geographic level. The data includes demographic, socioeconomic and housing indicators from the 2021 Population and Housing Census. The data is automatically extracted from compressed files and cached locally if requested.

Note

Data files are stored compressed on the repository to reduce size and download times. The function handles decompression automatically. Census data is only available for 2021.

Examples

# Get municipality level census data
mun_data <- get_census("municipality")

# Get district level census data without caching
dist_data <- get_census("district", cache = FALSE)

# Get census tract level data
tract_data <- get_census("tract")

Get census tract boundary geometries

Description

Downloads and extracts census tract boundary files from the ineAtlas repository, returning an sf object with the geometries for the specified year.

Usage

get_tract_geom(year, cache = TRUE, cache_dir = tempdir())

Arguments

Value

An sf object containing census tract boundaries with the following columns:

• year: The reference year

• tract_code: Census tract identifier

• municipality: Municipality name

• province: Province name

• geometry: Census tract boundary geometry

Examples

# Get census tract boundaries for 2020
tracts_2020 <- get_tract_geom(2020)

# Get boundaries without caching
tracts_2019 <- get_tract_geom(2019, cache = FALSE)