read_all_sas: Read all `.sas7bdat` files in a directory

Description

Read all .sas7bdat files in a directory. Formats can be applied from a procformat.sas SAS file, from a .

Usage

read_all_sas(
  path,
  ...,
  format_file = "procformat.sas",
  clean_names_fun = NULL,
  datetime_extraction = "guess",
  verbose = getOption("edc_read_verbose", 1)
)

Value

a list containing one dataframe for each .xpt file in the folder, the extraction date (datetime_extraction), and a summary of all imported tables (.lookup).

Arguments

path: [character(1)]
the path to the directory containing all .sas7bdat files.
...: unused
format_file: [character(1)]
the path to the file that should be used to apply formats. See details. Use NULL to not apply formats.
clean_names_fun: [function]
a function to clean column names, e.g. tolower, janitor::clean_names(),...
datetime_extraction: [POSIXt(1)]
the datetime of the data extraction. Default to the most common date of last modification in directory.
verbose: [logical(1)]
one of c(0, 1, 2). The higher, the more information will be printed.

Format file

format_file should contain the information about SAS formats. It can be either

a procformat.sas file, containing the whole PROC FORMAT
a catalog file (.sas7bcat)
or a data file (.csv or .sas7bdat) containing 3 columns: the SAS format name (repeated), each level, and its associated label. Use options(edc_var_format_name="xxx", edc_var_level="xxx", edc_var_label="xxx") to specify the names of the columns.