Download census tract-level aggregate data from Brazil's censuses.
Usage
read_tracts(
year = 2010,
dataset = NULL,
as_data_frame = FALSE,
showProgress = TRUE,
cache = TRUE
)
Arguments
- year
Numeric. Year of reference in the format
yyyy
. Defaults to2010
.- dataset
Character. The dataset to be opened. Options currently include
c("Basico", "Domicilio", "DomicilioRenda", "Responsavel", "ResponsavelRenda", "Pessoa", "PessoaRenda", "Entorno")
. Preliminary results of the 2022 census are available with"Preliminares"
.- as_data_frame
Logical. When
FALSE
(Default), the function returns an Arrow Dataset, which allows users to work with larger-than-memory data. IfTRUE
, the function returnsdata.frame
.- showProgress
Logical. Defaults to
TRUE
display download progress bar. The progress bar only reflects only the downloading time, not the time to load the data to memory.- cache
Logical. Whether the function should read the data cached locally, which is much faster. Defaults to
TRUE
. The first time the user runs the function,censobr
will download the file and store it locally so that the file only needs to be download once. IfFALSE
, the function will download the data again and overwrite the local file.
Examples
library(censobr)
# return data as arrow Dataset
df <- read_tracts(year = 2010,
dataset = 'PessoaRenda',
showProgress = FALSE)
#> Downloading data and storing it locally for future use.
# return data as data.frame
df <- read_tracts(year = 2010,
dataset = 'Basico',
as_data_frame = TRUE,
showProgress = FALSE)
#> Downloading data and storing it locally for future use.
#> Warning: Potentially unsafe or invalid elements have been discarded from R metadata.
#> ℹ Type: "externalptr"
#> → If you trust the source, you can set `options(arrow.unsafe_metadata = TRUE)` to preserve them.