REDCapCAST 24.1.2
Functions
Fix:
ds2dd(): uses correct default dd column names. Will be deprecated.NEW:
ds2dd_detailed(): extension of theds2dd(), which serves to preserve as much metadata as possible automatically. Depends on a group of helper functions also introduced. Of special note is theguess_time_only_filter(), which will try to guess which columns/variables should be formatted as time only formats. Supports hms time format. DETAILED INSTRUCTION AND VIGNETTE IS PENDING.NEW:
read_redcap_instrument()convenience function to retrieve complete instrument. Goes a little against the focused approach. DETAILED INSTRUCTION IS PENDING.
Other
I believe renv has now been added and runs correctly. After clone, do renv::restore() to install all necessary package to modify the package.
Whishes before CRAN release
Vignette for
ds2dd_detailed()Tests for
ds2dd_detailed()
REDCapCAST 24.1.1
CRAN release: 2024-01-09
Functions
- Fix:
read_redcap_tables(): checking form names based on data dictionary to allow handling of non-longitudinal projects. Prints invalid form names and invalid event names. If invalid form names are supplied toREDCapR::redcap_read()(which is the backbone), all forms are exported, which is not what we want with a focused approach. Invalid event names will give an output with a rather peculiar formatting. Checking of field names validity is also added.
REDCapCAST 23.12.1
CRAN release: 2023-12-20
One new function to ease secure dataset retrieval and a few bug fixes.
Functions
- New:
easy_redcap()function to ease the retrieval of a dataset withread_redcap_tables()withkeyring-package based key storage, which handles secure API set, storage and retrieval. Relies on a small helper function,get_api_key(), which wraps relevantkeyring-functions. Includes option to cast the data in a wide format with flagwiden.data. - Fix:
REDCap_split(): when using this function on its own, supplying a data set with check boxes would fail if metadata is supplied as a tibble. Metadata is now converted to data.frame. Fixed. - Fix:
read_redcap_tables(): fixed bug when supplying events.
REDCapCAST 23.6.2
CRAN release: 2023-07-04
This version marks the introduction of a few helper functions to handle database creation.
Functions
New:
ds2dd()function migrating from thestRoke-package. Assists in building a data dictionary for REDCap from a dataset.New:
strsplitx()function to ease the string splitting as an extension ofbase::strsplit(). Inspiration from https://stackoverflow.com/a/11014253/21019325 and https://www.r-bloggers.com/2018/04/strsplit-but-keeping-the-delimiter/.New:
d2n()function converts single digits to written numbers. Used to sanitize variable and form names in REDCap database creation. For more universal number to word I would suggestenglish::word()orxfun::numbers_to_words(), though I have not been testing these.
REDCapCAST 23.3.1
New name: REDCapCAST
To reflect new functions and the limitation to only working in R, I have changed the naming of the fork, while still, of course, maintaining the status as a fork.
The versioning has moved to a monthly naming convention.
The main goal this package is to keep the option to only export a defined subset of the whole dataset from the REDCap server as is made possible through the REDCapR::redcap_read() function, and combine it with the work put into the REDCapRITS package and the handling of longitudinal projects and/or projects with repeated instruments.
Functions:
read_redcap_tables()NEW: this function is mainly an implementation of the combined use ofREDCapR::readcap_read()andREDCap_split()to maintain the focused nature ofREDCapR::readcap_read(), to only download the specified data. Also implements tests of valid form names and event names. The usual fall-back solution was to get all data.redcap_wider()NEW: this function pivots the long data frames fromread_redcap_tables()usingtidyr::pivot_wider().focused_metadata()NEW: a hidden helper function to enable a focused data acquisition approach to handle only a subset of metadata corresponding to the focused dataset.