Download and Process Brazilian Education Data from INEP
Overview
Download and process public education data from INEP (Instituto Nacional de Estudos e Pesquisas Educacionais Anísio Teixeira). Provides functions to access microdata from the School Census (Censo Escolar), ENEM (Exame Nacional do Ensino Médio), SAEB (Sistema de Avaliação da Educação Básica), Higher Education Census (Censo da Educação Superior), ENADE (Exame Nacional de Desempenho dos Estudantes), ENCCEJA (Exame Nacional para Certificação de Competências de Jovens e Adultos), IDD (Indicador de Diferença entre os Desempenhos Observado e Esperado), CPC (Conceito Preliminar de Curso), IGC (Índice Geral de Cursos), CAPES graduate education data, FUNDEB (Fundo de Manutencao e Desenvolvimento da Educacao Basica), IDEB (Índice de Desenvolvimento da Educação Básica), and other educational datasets. Returns data in tidy format ready for analysis. Data source: INEP Open Data Portal https://www.gov.br/inep/pt-br/acesso-a-informacao/dados-abertos.
This release fixes two bugs that returned the **wrong data without any
error or warning**. If you used get_saeb(type = "aluno") or
get_encceja() with educabR 1.1.0 or earlier, please re-check your
results: see the first two items below.
Bug fixes
get_saeb()gains aserieargument and no longer loads the wrong grade silently (#21). Since 2013 INEP ships one student file per grade (TS_ALUNO_2EF.csv,TS_ALUNO_5EF.csv,TS_ALUNO_9EF.csv, ...), andtype = "aluno"used to read whichever came first alphabetically: the 2nd grade in 2019-2023, the 3rd year of high school in 2013-2017, so the 5th and 9th grades were unreachable in every edition. Nowserie = "5ef"(or5) picks the file by exact name; when an edition has several grades andserieis missing,get_saeb()stops and lists them. For 2011,type = "aluno"now readsTS_RESULTADO_ALUNO(proficiency results) instead of the student questionnaire.
Show all changes in 1.2.0Hide the rest of the changes in 1.2.0
get_encceja()gainstype = c("regular", "ppl")and now reads the national regular exam by default. Each edition ships a regular file (REG_NAC/REGULAR, 260-940 MB) and a much smaller file for people deprived of liberty (PPL_NAC/PPL), andget_encceja()used to load whichever matched first: the PPL file in 2014, 2017-2020 and 2022-2025.type = "ppl"keeps that file reachable.- ENCCEJA years now exclude 2015, 2016 and 2021: INEP published no microdata for those editions (the download URLs return 404), so
get_encceja()rejects them up front instead of failing at download.
New features
get_enem()andget_enem_itens()now support the 2025 edition, published by INEP in 2026. The 2025 zip keeps the split layout introduced in 2024 (PARTICIPANTES_2025.csv,RESULTADOS_2025.csv,ITENS_PROVA_2025.csv), so only the known-years list changed.get_encceja()now supports the 2025 edition (same file set as 2024:REG_NAC,PPL_NAC,PPL_NAC_QSE,ITENS_PROVA).
Both editions were detected by the portfolio source monitor and
validated against the live INEP files.
From NEWS.md in the release
Install
Health
- OK13 OK2026-08-05
- NOTE12 OK, 1 NOTE2026-08-01
- OK12 OK2026-04-25
- NOTE13 OK, 1 NOTE2026-04-08
- OK14 OK2026-03-10
Documentation
- Help pages
- 67 (42 internal)includes a package overview page
- Examples that run
- 8%2 run in a plain check · 23 never run
- Exported functions with examples
- 100%
- Documented parameters
- 100%
- Return-value docs
- 100%
- Help pages citing references
- 0%
- Basic Education Assessments: SAEB, ENCCEJA, and ENEM by School HTML
- educabR and the alternatives HTML
- Education Funding: FUNDEB HTML
- Getting Started with educabR HTML
- Higher and Graduate Education: Census, ENADE, IDD, CPC, IGC, and CAPES HTML
- How has ENEM performance evolved by state? HTML
- How to compare CPC indicators between public and private institutions? HTML
- Mapping education indicators with geobr HTML
- What does school infrastructure look like across Brazil? HTML
- Which municipalities improved the most in IDEB? HTML
Downloads
Repository
- PRs merged (all time)
- 100%
- Median days to close, 50 most recently updated closed issues
- 0
- Median days to close, 50 most recently updated closed PRs
- 0
Stars over time
Forks over time
Releases over time
Issues over time
Commits over time
Commit identities over time
12 development-tooling and community-health practices detected across 9 families in the upstream repository
Checks run against github.com/sidneybissoli/educabr on 2026-10-18.
The R CMD check workflow runs on Linux, macOS and Windows, and on R-devel
The repository owner accepts GitHub Sponsors
GitHub Pages site last deployed 2026-10-17 · The repository has a site deploy workflow
pkgdown site last built 2026-10-17
Show all practicesHide 5 practices
This repository shows signs of AI coding tools.
- Claude Codefirst seen 2026-01-26Seen in the repository: CLAUDE.mdNamed in .Rbuildignore: .claude, CLAUDE.mdNamed in .gitignore: .claudePull request it wrote: opened by a project memberCommits: at least 139 crediting it in the message
- Claude Opus 4.683 commits · Feb to Apr 2026
- Claude Opus 4.513 commits · Jan 2026
- Claude Opus 5.55 commits · Oct 2026
- Claude Opus 4.74 commits · May 2026
- Claude Fable 5.11 commit · Sep 2026
1 more model not listed. Some of these counts are a minimum, because the search stopped before the oldest commits.
Dependencies
Code & Tests
People & History
Pick two releases to compare their code metrics.
- 1.2.0Latest
- 1.1.02026-08-23 · diff ↗
- 1.0.02026-05-27 · diff ↗
- RR 4.6.0 released · 2026-04-24
- 0.9.12026-04-06 · diff ↗
- 0.9.02026-04-03 · diff ↗ ·
added 12 exports
get_capes, get_censo_superior, get_cpc, get_enade, get_encceja, get_enem_escola, get_fundeb_distribution, get_fundeb_enrollment, get_idd, get_igc, get_saeb, list_censo_superior_files - 0.1.32026-03-05 · diff ↗
- unarchivedReturned to CRAN2026-02-19
- archivedRemoved from CRAN2026-02-19policy violation Using and leaving behind a file in ~
- 0.1.22026-02-19 · diff ↗
- 0.1.02026-02-03
- RR 4.5.0 released · 2025-04-11
Package metadata
- First published
- 2026-02-03
- Total releases
- 8 / 1 yrs
- License
- MIT + file LICENSE OSI
- Minimum R
- ≥ 4.1.0
- Download size
- 5.1 MB
Cite
Cite this package
Run in R for the authors' entry:
citation("educabR")The package provides a citation file, so citation() returns the authors' own entry.
It points to 10.5281/zenodo.19410201.
The repository also keeps a CITATION.cff.
Cite the R Observatory
For a number measured here: a download total, a coverage figure, an archival date.
From data release v2026-10-21, which the citation names so these numbers can be found later. More on citing and the projects behind them.