Package: datasus 0.16.1

datasus: An Interface to Brazilian Public Health Data

Retrieves public health data from the Department of Informatics ('DATASUS') of the Brazilian Unified Health System ('Sistema Unico de Saude', 'SUS') through its online tabulation service and open-data catalog. It covers the Mortality Information System ('SIM'), Live Birth Information System ('SINASC'), Hospital Information System of the Unified Health System ('SIH/SUS'), Outpatient Information System of the Unified Health System ('SIA/SUS'), National Register of Health Establishments ('CNES'), Notifiable Diseases Information System ('SINAN'), National Immunization Program ('PNI'), Cancer Information System ('SISCAN'), and Food and Nutrition Surveillance System ('SISVAN'). Contemporary sources from the 'OpenDataSUS' portal include Events Supposedly Attributable to Vaccination or Immunization ('ESAVI'), influenza-like illness notifications from 'e-SUS Notifica', individual vaccination doses, coronavirus disease 2019 (COVID-19) hospital occupancy, and record-level mortality, live-birth and hospital-admission microdata. Curated schemas, selective columns, multipart downloads and chunk processing support memory-efficient analysis of large files. The package also provides grouped epidemiological indicators, confidence intervals, population-denominator joins, epidemiological calendars, moving averages and direct age standardization. An offline reference from the Brazilian Institute of Geography and Statistics (IBGE) supports territorial codes, joins and completion of geographic time series.

Authors:Renato Prado Siqueira [aut, cre]

datasus_0.16.1.tar.gz
datasus_0.16.1.zip(r-4.7-any)datasus_0.16.1.zip(r-4.6-any)datasus_0.16.1.zip(r-4.5-any)
datasus_0.16.1.tgz(r-4.6-any)datasus_0.16.1.tgz(r-4.5-any)
datasus_0.16.1.tar.gz(r-4.7-any)datasus_0.16.1.tar.gz(r-4.6-any)
datasus_0.16.1.tgz(r-4.6-emscripten)
manual.pdf |manual.html✨
DESCRIPTION |NEWS
card.svg |card.png
datasus/json (API)

# Install 'datasus' in R:
install.packages('datasus', repos = c('https://rpradosiqueira.r-universe.dev', 'https://cloud.r-project.org'))

Bug tracker:https://github.com/rpradosiqueira/datasus/issues

On CRAN:

Conda:

apibrasilbrazildatasushealth-data

7.18 score 34 stars 45 scripts 427 downloads 72 exports 42 dependencies

Last updated from:fd507d2658. Checks:9 OK. Indexed: yes.

TargetResultTimeFilesSyslog
linux-develOK137
source / vignettesOK207
linux-releaseOK142
macos-releaseOK108
macos-oldrelOK106
windows-develOK92
windows-releaseOK91
windows-oldrelOK85
wasm-releaseOK98

Exports:adicionar_territoriocalcular_indicadorcalcular_taxacalendario_epidemiologicocnescompletar_territoriosdatasus_catalogodatasus_dicionariodatasus_opcoesdatasus_padronizardatasus_provenienciadatasus_territoriosdatasus_validar_esquemaesaviesus_sindrome_gripalextrair_codigo_ibgefinanciamento_susintervalo_taxajuntar_populacaoletalidademedia_movelmicrodados_arquivosmicrodados_baixarmicrodados_catalogomicrodados_lernormalizar_codigo_ibgeocupacao_hospitalaropendatasus_arquivosopendatasus_baixaropendatasus_catalogoopendatasus_leropendatasus_processaropendatasus_recursospadronizar_idadepni_dosespni_imunizacoespopulacao_padraopopulacao_residenteproporcaosemana_epidemiologicasia_producaosih_microdadossih_morbidadesih_producaosimsim_evita10_brufsim_evita10_munsim_evita10_ufsim_evitb10_brufsim_evitb10_munsim_evitb10_ufsim_inf10_brufsim_inf10_munsim_inf10_ufsim_microdadossim_obt10_brufsim_obt10_munsim_obt10_ufsinansinan_denguesinan_mpoxsinascsinasc_microdadossinasc_nv_brufsinasc_nv_munsinasc_nv_ufsiscansisvansivep_gripetaxa_incidenciataxa_mortalidadevalidar_codigo_ibge

Dependencies:askpassbitbit64clicliprcpp11crayoncurldatasusrdplyrgenericsgluehmshttrhttr2jsonlitelifecyclemagrittrmimeopensslpillarpkgconfigprettyunitsprogresspurrrR6readrrlangrvestselectrstringistringrsystibbletidyrtidyselecttzdbutf8vctrsvroomwithrxml2

Accessing DATASUS tables
Overview | Discover datasets | Vital statistics | Health services and population | Surveillance, screening and financing | Provenance and reproducibility

Last update: 2026-07-26
Started: 2026-07-26

Geography and epidemiological analysis
Overview | Territorial reference | Add geography to observations | Make missing combinations explicit | Join population denominators | Rates, proportions and case fatality | Epidemiological calendar and moving averages | Direct age standardization

Last update: 2026-07-26
Started: 2026-07-26

Introduction to datasus
A R Interface to the DATASUS's data | Installation | Functions | Examples | SIM and SINASC | SIH/SUS, SIA/SUS and CNES | Population, hospital morbidity and SINAN | PNI, SISCAN, SISVAN and financing | OpenDataSUS microdata | Raw DBC/DBF microdata | Territorial reference | Epidemiological analysis | Query conventions

Last update: 2026-07-26
Started: 2017-06-12

Large files, raw microdata and provenance
Overview | Traditional DBC/DBF microdata | Inspect schemas before reading | Selected OpenDataSUS columns | Process CSV files in bounded memory | Cache and provenance | Practical strategy

Last update: 2026-07-26
Started: 2026-07-26

Modern surveillance data from OpenDataSUS
Overview | Search before downloading | Start with selected columns | Standardize an existing data frame | Detect schema drift | Resources split into multiple physical files | Provenance

Last update: 2026-07-26
Started: 2026-07-26

Readme and manuals

Help Manual

Help pageTopics
datasus: Brazilian public health datadatasus-package datasus
Add territorial attributes to a data frameadicionar_territorio
Aggregate epidemiological indicatorscalcular_indicador
Calculate crude epidemiological ratescalcular_taxa
Generate a Brazilian epidemiological calendarcalendario_epidemiologico
Query the National Registry of Health Establishments (CNES)cnes
Complete territorial and temporal combinationscompletar_territorios
List supported DATASUS datasetsdatasus_catalogo
Inspect curated DATASUS field dictionariesdatasus_dicionario
Inspect the options of a DATASUS querydatasus_opcoes
Standardize common fields in DATASUS microdatadatasus_padronizar
Retrieve DATASUS provenance metadatadatasus_proveniencia
List Brazilian territoriesdatasus_territorios
Validate curated DATASUS schemasdatasus_validar_esquema
Read anonymous ESAVI notificationsesavi
Read e-SUS Notifica mild influenza-like illness recordsesus_sindrome_gripal
Extract IBGE codes from DATASUS labelsextrair_codigo_ibge
Query legacy SUS financing tablesfinanciamento_sus
Calculate exact Poisson confidence intervals for ratesintervalo_taxa
Join validated population denominatorsjuntar_populacao
Calculate grouped case fatalityletalidade
Calculate moving averagesmedia_movel
Discover raw DATASUS microdata filesmicrodados_arquivos
Download raw DATASUS DBC filesmicrodados_baixar
List supported DATASUS microdata filesmicrodados_catalogo
Download and read raw DATASUS microdatamicrodados_ler
Normalize IBGE territorial codesnormalizar_codigo_ibge
Read COVID-19 hospital occupancy recordsocupacao_hospitalar
Expand downloadable files from OpenDataSUS resourcesopendatasus_arquivos
Download a resource from OpenDataSUSopendatasus_baixar
Search the OpenDataSUS catalogopendatasus_catalogo
Download and read tabular OpenDataSUS dataopendatasus_ler
Process large OpenDataSUS CSV resources in chunksopendatasus_processar
List resources from an OpenDataSUS datasetopendatasus_recursos
Directly standardize rates by agepadronizar_idade
Read individual PNI dose recordspni_doses
Query legacy immunization data from PNIpni_imunizacoes
Retrieve ready-made standard populationspopulacao_padrao
Query resident population estimatespopulacao_residente
Calculate grouped proportionsproporcao
Convert dates to Brazilian epidemiological weekssemana_epidemiologica
Query ambulatory production from SIA/SUSsia_producao
Read SIH hospitalization microdatasih_microdados
Query hospital morbidity from SIH/SUSsih_morbidade
Query hospital production from SIH/SUSsih_producao
Query mortality data from SIMsim
Scrapes SIM's ICD-10 evitale causes data from regionssim_evita10_bruf
Scrapes SIM's ICD-10 evitable causes data from citiessim_evita10_mun
Scrapes SIM's ICD-10 evitable causes data from ufssim_evita10_uf
Scrapes SIM's ICD-10 evitale causes data from regionssim_evitb10_bruf
Scrapes SIM's ICD-10 evitable causes data from citiessim_evitb10_mun
Scrapes SIM's ICD-10 evitable causes data from ufssim_evitb10_uf
Scrapes SIM's ICD-10 child mortality data from regionssim_inf10_bruf
Scrapes SIM's ICD-10 child mortality data from citiessim_inf10_mun
Scrapes SIM's ICD-10 child mortality data from ufssim_inf10_uf
Read SIM death microdatasim_microdados
Scrapes SIM's ICD-10 data from regionssim_obt10_bruf
Scrapes SIM's ICD-10 data from citiessim_obt10_mun
Scrapes SIM's ICD-10 data from UF'ssim_obt10_uf
Query notifiable diseases and conditions from SINANsinan
Read current SINAN dengue microdatasinan_dengue
Read current e-SUS SINAN Mpox microdatasinan_mpox
Query live-birth data from SINASCsinasc
Read SINASC live birth microdatasinasc_microdados
Scrapes SINASC data from regionssinasc_nv_bruf
Scrapes SINASC data from citiessinasc_nv_mun
Scrapes SINASC data from ufssinasc_nv_uf
Query cancer screening and diagnostic exams from SISCANsiscan
Query legacy nutritional surveillance data from SISVANsisvan
Read SIVEP-Gripe severe acute respiratory syndrome microdatasivep_gripe
Calculate grouped incidence ratestaxa_incidencia
Calculate grouped mortality ratestaxa_mortalidade
Validate IBGE territorial codesvalidar_codigo_ibge