Reads a microdata dataset downloaded from the IPUMS Terra extract system.
read_terra_micro( data_file, ddi_file = NULL, data_layer = NULL, n_max = Inf, verbose = TRUE, var_attrs = c("val_labels", "var_label", "var_desc") )
data_file | Path to the data file, which can either be the .zip file directly downloaded from the IPUMS Terra website, a path to the unzipped version of that folder, or to the csv unzipped from the download. |
---|---|
ddi_file | (Optional) If the download is unzipped, path to the .xml file which provides usage and citation information for extract. |
data_layer | For .zip extracts with multiple datasets, the name of the
data to load. Accepts a character vector specifying the file name, or
|
n_max | Maximum number of observations to read from the data |
verbose | Logical, indicating whether to print progress information to console. |
var_attrs | Variable attributes to add from the DDI, defaults to
adding all (val_labels, var_label and var_desc). See
|
read_terra_micro
returns a tbl_df
with the tabular data. Use
read_ipums_sf
or read_ipums_sp
to read shape
data out of a microdata Terra extract.
Other ipums_read:
read_ipums_micro_chunked()
,
read_ipums_micro_yield()
,
read_ipums_micro()
,
read_ipums_sf()
,
read_nhgis()
,
read_terra_area()
,
read_terra_raster()
if (FALSE) { data <- read_terra_micro("2553_bundle.zip") }