Tutorials

Detailed tutorials, from scratch, for localdatasus. You will learn how to download Brazilian health data by neighborhood, make maps and understand where the numbers come from.

You don’t need much programming experience: every step has ready-to-copy code.

A note on language

The package, like its Brazilian data sources, uses Portuguese names: obitos = deaths, nascimentos = births, agravos = notifiable diseases, internacoes = hospitalizations, bairro = neighborhood, anos = years, por = “by” (breakdown). These tutorials translate everything along the way.

The full package documentation, with the reference for every function, is at https://hendesson.github.io/localdatasus/ (in Portuguese).

#	Tutorial	What you will learn	Reading time
1	1. Getting started	Install the package, see which data exist and download your first table of deaths by neighborhood.	10 min
2	2. Deaths, births and notifiable diseases	Filter by cause (ICD-10), break down by sex or age, combine years and change places.	15 min
3	3. Maps	Ready-made maps in one line: static maps for papers and interactive maps to explore.	10 min
4	4. Hospitalizations and postal codes	Hospitalizations by neighborhood in any state, individual records, and your own tables with postal codes.	20 min
5	5. How it works	Where the data come from, how names become IBGE neighborhoods, and the limitations.	15 min
6	6. Errors and help	What each error code (LDS-01 to LDS-23) means and how to fix it.	5 min
7	7. One example for each ICD chapter	Deaths (SIM) and hospitalizations (SIH) by neighborhood for every ICD-10 chapter, in places across all regions.	10 min
8	8. Consultations, SAMU and health facilities	Primary care in Curitiba, SAMU emergency calls in Recife and health facilities in any municipality.	15 min