loads wave files, applies all rules (variable, harmonization, boundary, drop/retain), derives variables, runs validation checks, and writes outputs (merged SAV, JSONL log, JSON summary, text report).
Arguments
- recipe
a parsed recipe list (from
load_recipe()), or a path to a recipe file.- data_dir
character. directory containing wave data files.
- output_dir
character. directory for output files.
- strict
logical. if
TRUE, abort before writing any outputs when a validation check withseverity: errorfails or cannot be evaluated, or when a wave's selected file violates itsexpected_releasepin; the defaultFALSEpreserves the historical report-and-continue behavior.- overwrite
logical. if
FALSE, abort instead of overwriting an existing merged output file. defaultTRUEpreserves prior behavior.
Value
a list (invisibly) with elements data, log, validation,
summary, recipe, provenance (package and recipe versions, input
file md5 hashes, release decisions, strictness, timestamp), and
valid_for_analysis (TRUE when no error-severity check failed or was
unevaluable and all release pins matched).