educabR (version 0.1.0)

get_ideb: Get IDEB (Índice de Desenvolvimento da Educação Básica) data

Description

Downloads and processes IDEB data from INEP. IDEB is the main indicator of education quality in Brazil, combining student performance (from SAEB) with grade promotion rates.

Usage

get_ideb(
  year,
  level = c("escola", "municipio"),
  stage = c("anos_iniciais", "anos_finais", "ensino_medio"),
  uf = NULL,
  quiet = FALSE
)

Value

A tibble with IDEB data in tidy format.

Arguments

year

The year of the IDEB (available: 2017, 2019, 2021, 2023).

level

The aggregation level:

• "escola": School level

• "municipio": Municipality level

stage

The education stage:

• "anos_iniciais": Early elementary (1st-5th grade)

• "anos_finais": Late elementary (6th-9th grade)

• "ensino_medio": High school

uf

Optional. Filter by state (UF code or abbreviation).

quiet

Logical. If TRUE, suppresses progress messages.

Data source

Official IDEB portal: https://www.gov.br/inep/pt-br/areas-de-atuacao/pesquisas-estatisticas-e-indicadores/ideb

Details

IDEB is calculated every two years since 2005 based on:

• Learning: Average scores in Portuguese and Mathematics from SAEB

• Flow: Grade promotion rate (inverse of repetition/dropout)

The index ranges from 0 to 10. Brazil's national goal is to reach 6.0 by 2022 (the level of developed countries in PISA).

Note: IDEB data is relatively small compared to other INEP datasets, so no n_max parameter is provided.

Examples

# \donttest{
# get school-level IDEB for early elementary in 2021
ideb_escolas <- get_ideb(2021, level = "escola", stage = "anos_iniciais")

# get municipality-level IDEB for São Paulo state
ideb_sp <- get_ideb(2021, level = "municipio", stage = "anos_iniciais", uf = "SP")

# get high school IDEB for all municipalities
ideb_em <- get_ideb(2023, level = "municipio", stage = "ensino_medio")
# }