brpop: Brazilian population estimates

CRAN status CRAN downloads R-CMD-check

brpop provides annual population estimates for Brazilian municipalities and functions to aggregate them by state (UF), health region, sex, and age group. These data are useful for denominators in demographic and epidemiological indicators, including age- and sex-standardized rates.

Data sources

Source Years Detail Access
IBGE censuses, count, and annual estimates 2000–2025 Municipality totals Bundled with the package
DataSUS, original series 2000–2021 Municipality, sex, and age group Downloaded from Zenodo
DataSUS, revised series 2000–2024 Municipality, sex, and age group Downloaded from Zenodo
UFRN-PPGDem-LEPP 2010–2030 Municipality, sex, and age group Downloaded from Zenodo

The 2025 IBGE values are the revised municipal estimates sent to the TCU on 2026-01-13. The bundled IBGE series can therefore be used without an Internet connection. Larger sex- and age-specific files are hosted in the versioned brpop Zenodo deposit and cached locally by zendown after the first download.

Installation

The package is being prepared for re-release on CRAN. Install the development version from GitHub with:

# install.packages("remotes")
remotes::install_github("rfsaldanha/brpop")

After the CRAN release, the stable version can be installed with:

install.packages("brpop")

Quick start

library(brpop)

# Municipality totals from IBGE, including 2025
municipal <- mun_pop_totals(source = "ibge")
municipal_2025 <- municipal[municipal$year == 2025, ]

# State totals from the same source
state_2025 <- uf_pop_totals(source = "ibge")
state_2025 <- state_2025[state_2025$year == 2025, ]

# Health-region totals using the 449-region specification
health_region_2025 <- regsaude_pop_totals(
  type = "reg_saude_449",
  source = "ibge"
)
health_region_2025 <- health_region_2025[
  health_region_2025$year == 2025,
]

The established function names, arguments, source labels, and output column names are retained for compatibility with scripts written for earlier releases. See the function reference for the complete API and source-specific year coverage.

Data provenance

IBGE source workbooks and the reproducible preparation scripts are kept in data-raw. The latest official municipal files are available from the IBGE 2025 download directory.