REDCap Name Conversion
This merge request introduces two new functions:
-
validate_var_name()
, which is vectorized over a string input and validates that the string(s) conform to the CAM standard for R naming (e.g.GGG.TTT.Optional.Var_name
; see man page for more detail). I also decided to begin unit testing with this function, so this introduces a new test folder following the format for using the testthat package. -
rename_redcap_vars()
, which takes a data frame with raw redcap data and the metadata/data dictionary and uses that data dictionary to rename variables using the ideal name in the field annotation. This is an initial working version and is intended to allow others at CAM to begin working on other sections of the POTS pipeline. Remaining issues (to be addressed with a future merge request):- The function does not fix the
redcap_event_name
fields orinstrument_name_complete
fields yet as they do not show up in the data dictionary. - Type conversions from REDCap types to R types.
- Addition to data frame attributes with important information (e.g. labels + values, etc.)
- The function does not fix the
I'm not sure if I should expand the scope of this function to include the last 2 bullets or if those should be separate functions in our pipeline. @kp390, I've asked you to review the changes here, but if you are swamped, we can switch to @mpp44. I'd like to have these merged to master by Monday so @ea601 can download data from REDCap with this and test the functions for processing inventories that she's been working on!