Brazilian Population Estimates

Provides Brazilian municipality population estimates from official and research sources, with functions to aggregate the data by state, health region, sex, and age group.

brpop: Brazilian population estimates

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

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.