Skip to contents

Get SAEB (Sistema de Avaliação da Educação Básica) data

Source: R/get-saeb.R
get_saeb.Rd

Downloads and processes microdata from SAEB, the Brazilian Basic Education Assessment System. SAEB evaluates educational quality through student performance assessments in Portuguese and Mathematics.

Usage

get_saeb(
  year,
  type = c("aluno", "escola", "diretor", "professor"),
  level = c("fundamental_medio", "educacao_infantil"),
  n_max = Inf,
  keep_zip = TRUE,
  quiet = FALSE
)

Arguments

year

The year of the assessment (2011, 2013, 2015, 2017, 2019, 2021, 2023).

type

Type of data to load. Options:

  • "aluno": Student results (default)

  • "escola": School questionnaire

  • "diretor": Principal questionnaire

  • "professor": Teacher questionnaire

level

For 2021 only, SAEB was split into two files:

  • "fundamental_medio": Elementary and High School (default)

  • "educacao_infantil": Early Childhood Education Ignored for other years.

n_max

Maximum number of rows to read. Default is Inf (all rows). Consider using a smaller value for exploration.

keep_zip

Logical. If TRUE, keeps the downloaded ZIP file in cache.

quiet

Logical. If TRUE, suppresses progress messages.

Value

A tibble with SAEB microdata in tidy format.

Details

SAEB is conducted biennially by INEP and assesses students in grades 5 and 9 of elementary school, and grade 3 of high school. The data includes:

  • Student performance scores in Portuguese and Mathematics

  • School infrastructure and management questionnaires

  • Teacher and principal profiles

Important notes:

  • SAEB files can be large (several hundred MB).

  • Use n_max to read a sample first for exploration.

  • Column names are standardized to lowercase with underscores.

  • In 2021, INEP split SAEB into two separate downloads (elementary/high school and early childhood). Use the level parameter to choose.

Data dictionary

For detailed information about variables, see INEP's documentation: https://www.gov.br/inep/pt-br/acesso-a-informacao/dados-abertos/microdados/saeb

Examples

if (FALSE) { # \dontrun{
# get student results for 2023
saeb <- get_saeb(2023, n_max = 10000)

# get school questionnaire data
saeb_escola <- get_saeb(2023, type = "escola")

# SAEB 2021: early childhood education
saeb_infantil <- get_saeb(2021, level = "educacao_infantil", n_max = 1000)
} # }