Download microdata of family records from Brazil's census
Source:R/read_families.R
read_families.Rd
Download microdata of family records from Brazil's census. Data collected in the sample component of the questionnaire.
Usage
read_families(
year = 2000,
columns = NULL,
add_labels = NULL,
as_data_frame = FALSE,
showProgress = TRUE,
cache = TRUE
)
Arguments
- year
Numeric. Year of reference in the format
yyyy
. Defaults to2000
.- columns
String. A vector of column names to keep. The rest of the columns are not read. Defaults to
NULL
and read all columns.- add_labels
Character. Whether the function should add labels to the responses of categorical variables. When
add_labels = "pt"
, the function adds labels in Portuguese. Defaults toNULL
.- 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.
See also
Other Microdata:
read_emigration()
,
read_households()
,
read_mortality()
,
read_population()