ribge R package

R package for (down)loading data from IBGE (Instituto Brasileiro de Geografia e Estatística)

data: population

Yearly population for municipalities. See: Estimativas de População & estatísticas/Estimativas de Populacao (or ftp://ftp.ibge.gov.br/Estimativas_de_Populacao/)

2007 data comes from Contegem da população: see https://www.ibge.gov.br/estatisticas/sociais/populacao/9065-contagem-da-populacao.html

2010 Census data gathered from: http://www.sidra.ibge.gov.br/bda/tabela/listabl.asp?z=t&o=25&i=P&c=1378

years avaiable: 2000-2022,2024-2025

see doc/populacao_sources.csv

data: GDP (gross domestic product) / PIB (produto interno bruto)

Municipalities GDP. See: Produto Interno Bruto dos Municípios

years avaiable: 1999-2023

data: cartography/territory

Municipalities area. See: Geociências » Organização do território » Estrutura territorial » Áreas Territoriais

years avaiable: 2015, 2020

data: price indexes & GDP deflator

INPC index. See: Índice de preços » INPC - Índice Nacional de Preços ao Consumidor

years avaiable: 1991+

IPCA index. See: Índice de preços » IPCA - Índice Nacional de Preços ao Consumidor Amplo

years avaiable: 1991+

SINAPI construction price index. See: Sistema Nacional de Pesquisa de Custos e Índices da Construção Civil & índice de preços » índices da construção civil

years avaiable: 1986+

GDP deflator. See: sistema de contas nacionais » contas nacionais

years avaiable: 1948+

statistical series API (series estatísticas)

Generic functions to gather data from Séries Históricas e Estatísticas website.

See avaiable series codes on doc/seriesEstatisticas.md.

municipalities codes: ibge/tse mapping

Mapping between IBGE's & TSE's municipalities names and codes.

Also avaiable as CSV file: IBGE vs TSE municipalities mapping.

See also TSE's municipalities csv file and TSE's municipalities with zones csv file

IPEA's & BCB's series (non-IBGE)

Function to gather data from Ipeadata

Function to gather data from BCB's Time Series Management System

install & load

# install.packages("devtools")
devtools::install_github("tbrugz/ribge")
library(ribge)

build from sources & load

#install.packages("devtools")
devtools::install_deps(".")
# check folder 'data-raw': if changes were made, changed scripts may need to be run
devtools::install(".")
#devtools::document()
#devtools::check(".")
library(ribge)

usage examples

population, main usage:

pop2000 <- populacao_municipios(2000)
# ...
pop2007 <- populacao_municipios(2007)
pop2008 <- populacao_municipios(2008)
pop2009 <- populacao_municipios(2009)
pop2010 <- populacao_municipios(2010)
pop2011 <- populacao_municipios(2011, dir="/tmp")
# ...
pop2021 <- populacao_municipios(2021)
pop2022 <- populacao_municipios(2022)
# 2023 not available
pop2024 <- populacao_municipios(2024)
pop2025 <- populacao_municipios(2025)

GDP (PIB) example:

# 18 variables
pib1999 <- pib_municipios(1999)
# ...
pib2009 <- pib_municipios(2009)

# 43 variables
pib2010 <- pib_municipios(2010)
# ...
pib2023 <- pib_municipios(2023)

inflation & GDP deflator:

inpc2015 <- precos_inpc(2015)
ipca2015 <- precos_ipca(2015)
sinapi2015 <- precos_sinapi(2015)
deflatorpib <- precos_deflatorpib()

municipalities area:

munArea <- area_municipios()              # defaults to 2020
munArea <- area_municipios(ano = 2015)

Gathering data from "séries estatísticas" (statistical series website):

# Efetivo dos rebanhos por tipo de rebanho
df <- series_estatisticas_carrega("PPM01_BR_ABS")
# Docentes com curso superior no ensino médio, rede pública e privada
df <- series_estatisticas_carrega("SEE10_BR_PERC", transpose = T)
# Taxa de desocupação das pessoas de 10 anos ou mais de idade, por sexo - todas localidades
df <- series_estatisticas_carrega_todas_localidades("PE62_RM_PERC", transpose = T)

# Ver `seriesEstatisticas` para prefixos de códigos:
seriesEstatisticas
View(seriesEstatisticas)

TSE municipalities:

tsemun <- tse_municipios()
# mapping between ibge & tse municipalities codes
data("municipioIbgeTseMap")

Ipeadata series:

# series 37667: real minimum wage / salário mínimo real
df <- ipea_serie_carrega(37667)

Brazil's central bank (BCB) series:

# series 193: Fipe IPC price index / Índice de Preços ao Consumidor da Fipe
df <- bcb_serie_carrega(193)

end notes

license: GPL-3