mirror of
https://github.com/agdamsbo/REDCapCAST.git
synced 2024-11-22 13:30:23 +01:00
Compare commits
No commits in common. "7948bfc65da474207da0e2491fd10770b82310b6" and "5979b972e11e45ef2377f66ce7598d8324e99bc8" have entirely different histories.
7948bfc65d
...
5979b972e1
@ -20,6 +20,7 @@ export(strsplitx)
|
||||
importFrom(REDCapR,redcap_event_instruments)
|
||||
importFrom(REDCapR,redcap_metadata_read)
|
||||
importFrom(REDCapR,redcap_read)
|
||||
importFrom(dplyr,left_join)
|
||||
importFrom(keyring,key_get)
|
||||
importFrom(keyring,key_list)
|
||||
importFrom(keyring,key_set)
|
||||
|
4
NEWS.md
4
NEWS.md
@ -4,9 +4,7 @@
|
||||
|
||||
* Fix: `ds2dd()`: uses correct default dd column names. Will be deprecated.
|
||||
|
||||
* Fix: `easy_redcap()`: fixed to actually allow project naming. also specifically asks for uri. widening updated to work.
|
||||
|
||||
* Fix: `redcap_wider()`: updated to accept more formats and allow handling of simple projects without repeating instruments and not longitudinal.
|
||||
* Fix: `easy_redcap()`: fixed to actually allow project naming. also specifically asks for uri.
|
||||
|
||||
* Fix: `read_redcap_tables()`: now handles non-longitudinal project without repeatable instruments.
|
||||
|
||||
|
@ -92,13 +92,13 @@ REDCap_split <- function(records,
|
||||
metadata <-
|
||||
as.data.frame(process_user_input(metadata))
|
||||
|
||||
# Process repeat instrument names to match the redcap naming
|
||||
records$redcap_repeat_instrument <- clean_redcap_name(records$redcap_repeat_instrument)
|
||||
|
||||
|
||||
# Get the variable names in the dataset
|
||||
vars_in_data <- names(records)
|
||||
|
||||
# Process repeat instrument names to match the redcap naming
|
||||
if (is.repeated_longitudinal(records)){
|
||||
records$redcap_repeat_instrument <- clean_redcap_name(records$redcap_repeat_instrument)
|
||||
|
||||
# Match arg for forms
|
||||
forms <- match.arg(forms, c("repeating", "all"))
|
||||
|
||||
@ -116,7 +116,6 @@ REDCap_split <- function(records,
|
||||
as.character(records$redcap_repeat_instrument)
|
||||
)
|
||||
}
|
||||
}
|
||||
|
||||
# Standardize variable names for metadata
|
||||
# names(metadata) <- metadata_names
|
||||
@ -139,8 +138,6 @@ REDCap_split <- function(records,
|
||||
)
|
||||
)
|
||||
|
||||
|
||||
|
||||
if ("redcap_repeat_instrument" %in% vars_in_data) {
|
||||
# Variables to be at the beginning of each repeating instrument
|
||||
repeat_instrument_fields <- grep("^redcap_repeat.*",
|
||||
@ -199,5 +196,5 @@ REDCap_split <- function(records,
|
||||
}
|
||||
|
||||
out
|
||||
}
|
||||
|
||||
}
|
||||
|
@ -10,7 +10,7 @@ get_api_key <- function(key.name) {
|
||||
if (key.name %in% keyring::key_list()$service) {
|
||||
keyring::key_get(service = key.name)
|
||||
} else {
|
||||
keyring::key_set(service = key.name, prompt = "Provide REDCap API key:")
|
||||
keyring::key_set(service = key.name, prompt = "Write REDCap API key:")
|
||||
keyring::key_get(service = key.name)
|
||||
}
|
||||
}
|
||||
@ -19,25 +19,41 @@ get_api_key <- function(key.name) {
|
||||
#' Secure API key storage and data acquisition in one
|
||||
#'
|
||||
#' @param project.name The name of the current project (for key storage with
|
||||
#' `keyring::key_set()`, using the default keyring)
|
||||
#' `keyring::key_set()`)
|
||||
#' @param widen.data argument to widen the exported data
|
||||
#' @param uri REDCap database API uri
|
||||
#' @param ... arguments passed on to `REDCapCAST::read_redcap_tables()`
|
||||
#'
|
||||
#' @return data.frame or list depending on widen.data
|
||||
#' @importFrom purrr reduce
|
||||
#' @importFrom dplyr left_join
|
||||
#' @export
|
||||
easy_redcap <- function(project.name, widen.data=TRUE, uri, ...) {
|
||||
easy_redcap <- function(project.name, widen.data = TRUE, uri, ...) {
|
||||
key <- get_api_key(key.name = paste0(project.name, "_REDCAP_API"))
|
||||
|
||||
out <- read_redcap_tables(
|
||||
uri = uri,
|
||||
token = key,
|
||||
uri = uri,
|
||||
...
|
||||
)
|
||||
|
||||
if (widen.data){
|
||||
all_names <- out |>
|
||||
lapply(names) |>
|
||||
Reduce(c, x = _) |>
|
||||
unique()
|
||||
|
||||
if (widen.data) {
|
||||
if (!any(c("redcap_event_name", "redcap_repeat_instrument") %in%
|
||||
all_names)) {
|
||||
if (length(out) == 1) {
|
||||
out <- out[[1]]
|
||||
} else {
|
||||
out <- out |> purrr::reduce(dplyr::left_join)
|
||||
}
|
||||
} else {
|
||||
out <- out |> redcap_wider()
|
||||
}
|
||||
}
|
||||
|
||||
out
|
||||
}
|
||||
|
@ -31,40 +31,47 @@ read_redcap_tables <- function(uri,
|
||||
events = NULL,
|
||||
forms = NULL,
|
||||
raw_or_label = "label",
|
||||
split_forms = "all") {
|
||||
split_forms = "all",
|
||||
generics = c(
|
||||
"redcap_event_name",
|
||||
"redcap_repeat_instrument",
|
||||
"redcap_repeat_instance"
|
||||
)) {
|
||||
|
||||
|
||||
# Getting metadata
|
||||
m <-
|
||||
REDCapR::redcap_metadata_read(redcap_uri = uri, token = token)[["data"]]
|
||||
REDCapR::redcap_metadata_read (redcap_uri = uri, token = token)[["data"]]
|
||||
|
||||
if (!is.null(fields)){
|
||||
|
||||
if (!is.null(fields)) {
|
||||
fields_test <- fields %in% unique(m$field_name)
|
||||
|
||||
if (any(!fields_test)) {
|
||||
print(paste0("The following field names are invalid: ", paste(fields[!fields_test], collapse = ", "), "."))
|
||||
if (any(!fields_test)){
|
||||
print(paste0("The following field names are invalid: ", paste(fields[!fields_test],collapse=", "),"."))
|
||||
stop("Not all supplied field names are valid")
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
if (!is.null(forms)) {
|
||||
if (!is.null(forms)){
|
||||
|
||||
forms_test <- forms %in% unique(m$form_name)
|
||||
|
||||
if (any(!forms_test)) {
|
||||
print(paste0("The following form names are invalid: ", paste(forms[!forms_test], collapse = ", "), "."))
|
||||
if (any(!forms_test)){
|
||||
print(paste0("The following form names are invalid: ", paste(forms[!forms_test],collapse=", "),"."))
|
||||
stop("Not all supplied form names are valid")
|
||||
}
|
||||
}
|
||||
|
||||
if (!is.null(events)) {
|
||||
arm_event_inst <- REDCapR::redcap_event_instruments(
|
||||
redcap_uri = uri,
|
||||
token = token
|
||||
)
|
||||
if (!is.null(events)){
|
||||
arm_event_inst <- REDCapR::redcap_event_instruments(redcap_uri = uri,
|
||||
token = token)
|
||||
|
||||
event_test <- events %in% unique(arm_event_inst$data$unique_event_name)
|
||||
|
||||
if (any(!event_test)) {
|
||||
print(paste0("The following event names are invalid: ", paste(events[!event_test], collapse = ", "), "."))
|
||||
if (any(!event_test)){
|
||||
print(paste0("The following event names are invalid: ", paste(events[!event_test],collapse=", "),"."))
|
||||
stop("Not all supplied event names are valid")
|
||||
}
|
||||
}
|
||||
@ -88,17 +95,28 @@ read_redcap_tables <- function(uri,
|
||||
}
|
||||
|
||||
# Processing metadata to reflect focused dataset
|
||||
m <- focused_metadata(m, names(d))
|
||||
if (!is.null(c(fields,forms,events))){
|
||||
m <- focused_metadata(m,names(d))
|
||||
}
|
||||
|
||||
|
||||
|
||||
if (any(generics %in% names(d))){
|
||||
# Splitting
|
||||
out <- REDCap_split(d,
|
||||
l <- REDCap_split(d,
|
||||
m,
|
||||
forms = split_forms,
|
||||
primary_table_name = ""
|
||||
)
|
||||
primary_table_name = "")
|
||||
|
||||
sanitize_split(out)
|
||||
# Sanitizing split list by removing completely empty rows apart from colnames
|
||||
# in "generics"
|
||||
sanitize_split(l,c(names(d)[1],generics))
|
||||
} else {
|
||||
# If none of generics are present, the data base is not longitudinal,
|
||||
# and does not have repeatable events, and therefore splitting does not
|
||||
# make sense. But now we handle that as well.
|
||||
d
|
||||
}
|
||||
|
||||
}
|
||||
|
||||
|
@ -5,70 +5,40 @@ utils::globalVariables(c("redcap_wider",
|
||||
#' @title Redcap Wider
|
||||
#' @description Converts a list of REDCap data frames from long to wide format.
|
||||
#' Handles longitudinal projects, but not yet repeated instruments.
|
||||
#' @param data A list of data frames.
|
||||
#' @param list A list of data frames.
|
||||
#' @param event.glue A dplyr::glue string for repeated events naming
|
||||
#' @param inst.glue A dplyr::glue string for repeated instruments naming
|
||||
#' @return The list of data frames in wide format.
|
||||
#' @export
|
||||
#' @importFrom tidyr pivot_wider
|
||||
#' @importFrom tidyselect all_of
|
||||
#' @importFrom purrr reduce
|
||||
#'
|
||||
#' @examples
|
||||
#' # Longitudinal
|
||||
#' list1 <- list(data.frame(record_id = c(1,2,1,2),
|
||||
#' list <- list(data.frame(record_id = c(1,2,1,2),
|
||||
#' redcap_event_name = c("baseline", "baseline", "followup", "followup"),
|
||||
#' age = c(25,26,27,28)),
|
||||
#' data.frame(record_id = c(1,2),
|
||||
#' redcap_event_name = c("baseline", "baseline"),
|
||||
#' gender = c("male", "female")))
|
||||
#' redcap_wider(list1)
|
||||
#' # Simpel with two instruments
|
||||
#' list2 <- list(data.frame(record_id = c(1,2),
|
||||
#' age = c(25,26)),
|
||||
#' data.frame(record_id = c(1,2),
|
||||
#' gender = c("male", "female")))
|
||||
#' redcap_wider(list2)
|
||||
#' # Simple with single instrument
|
||||
#' list3 <- list(data.frame(record_id = c(1,2),
|
||||
#' age = c(25,26)))
|
||||
#' redcap_wider(list3)
|
||||
#' # Longitudinal with repeatable instruments
|
||||
#' list4 <- list(data.frame(record_id = c(1,2,1,2),
|
||||
#' redcap_event_name = c("baseline", "baseline", "followup", "followup"),
|
||||
#' age = c(25,26,27,28)),
|
||||
#' data.frame(record_id = c(1,1,1,1,2,2,2,2),
|
||||
#' redcap_event_name = c("baseline", "baseline", "followup", "followup",
|
||||
#' "baseline", "baseline", "followup", "followup"),
|
||||
#' redcap_repeat_instrument = "walk",
|
||||
#' redcap_repeat_instance=c(1,2,1,2,1,2,1,2),
|
||||
#' dist = c(40, 32, 25, 33, 28, 24, 23, 36)),
|
||||
#' data.frame(record_id = c(1,2),
|
||||
#' redcap_event_name = c("baseline", "baseline"),
|
||||
#' gender = c("male", "female")))
|
||||
#'redcap_wider(list4)
|
||||
#' redcap_wider(list)
|
||||
redcap_wider <-
|
||||
function(data,
|
||||
function(list,
|
||||
event.glue = "{.value}_{redcap_event_name}",
|
||||
inst.glue = "{.value}_{redcap_repeat_instance}") {
|
||||
all_names <- unique(do.call(c, lapply(list, names)))
|
||||
|
||||
if (!is.repeated_longitudinal(data)) {
|
||||
if (is.list(data)) {
|
||||
if (length(data) == 1) {
|
||||
out <- data[[1]]
|
||||
} else {
|
||||
out <- data |> purrr::reduce(dplyr::left_join)
|
||||
}
|
||||
} else if (is.data.frame(data)){
|
||||
out <- data
|
||||
if (!any(c("redcap_event_name", "redcap_repeat_instrument") %in%
|
||||
all_names)) {
|
||||
stop(
|
||||
"The dataset does not include a 'redcap_event_name' variable.
|
||||
redcap_wider only handles projects with repeating instruments or
|
||||
longitudinal projects"
|
||||
)
|
||||
}
|
||||
|
||||
id.name <- all_names[1]
|
||||
|
||||
} else {
|
||||
|
||||
id.name <- do.call(c, lapply(data, names))[[1]]
|
||||
|
||||
l <- lapply(data, function(i) {
|
||||
l <- lapply(list, function(i) {
|
||||
rep_inst <- "redcap_repeat_instrument" %in% names(i)
|
||||
|
||||
if (rep_inst) {
|
||||
@ -111,17 +81,13 @@ redcap_wider <-
|
||||
names_glue = event.glue
|
||||
)
|
||||
s[colnames(s) != "redcap_event_name"]
|
||||
} else {
|
||||
i[colnames(i) != "redcap_event_name"]
|
||||
}
|
||||
} else {
|
||||
i
|
||||
}
|
||||
} else
|
||||
(i[colnames(i) != "redcap_event_name"])
|
||||
} else
|
||||
(i)
|
||||
})
|
||||
|
||||
out <- data.frame(Reduce(f = dplyr::full_join, x = l))
|
||||
}
|
||||
## Additional conditioning is needed to handle repeated instruments.
|
||||
|
||||
out
|
||||
data.frame(Reduce(f = dplyr::full_join, x = l))
|
||||
}
|
||||
|
||||
|
245
R/utils.r
245
R/utils.r
@ -1,3 +1,5 @@
|
||||
|
||||
|
||||
#' focused_metadata
|
||||
#' @description Extracts limited metadata for variables in a dataset
|
||||
#' @param metadata A dataframe containing metadata
|
||||
@ -6,6 +8,7 @@
|
||||
#' @export
|
||||
#'
|
||||
focused_metadata <- function(metadata, vars_in_data) {
|
||||
|
||||
if (any(c("tbl_df", "tbl") %in% class(metadata))) {
|
||||
metadata <- data.frame(metadata)
|
||||
}
|
||||
@ -14,11 +17,9 @@ focused_metadata <- function(metadata, vars_in_data) {
|
||||
field_type <- grepl(".*[Ff]ield[._][Tt]ype$", names(metadata))
|
||||
|
||||
fields <-
|
||||
metadata[
|
||||
!metadata[, field_type] %in% c("descriptive", "checkbox") &
|
||||
metadata[!metadata[, field_type] %in% c("descriptive", "checkbox") &
|
||||
metadata[, field_name] %in% vars_in_data,
|
||||
field_name
|
||||
]
|
||||
field_name]
|
||||
|
||||
# Process checkbox fields
|
||||
if (any(metadata[, field_type] == "checkbox")) {
|
||||
@ -28,21 +29,18 @@ focused_metadata <- function(metadata, vars_in_data) {
|
||||
|
||||
# Processing
|
||||
checkbox_basenames <-
|
||||
metadata[
|
||||
metadata[, field_type] == "checkbox" &
|
||||
metadata[metadata[, field_type] == "checkbox" &
|
||||
metadata[, field_name] %in% vars_check,
|
||||
field_name
|
||||
]
|
||||
field_name]
|
||||
|
||||
fields <- c(fields, checkbox_basenames)
|
||||
|
||||
}
|
||||
|
||||
# Process instrument status fields
|
||||
form_names <-
|
||||
unique(metadata[, grepl(
|
||||
".*[Ff]orm[._][Nn]ame$",
|
||||
names(metadata)
|
||||
)][metadata[, field_name]
|
||||
unique(metadata[, grepl(".*[Ff]orm[._][Nn]ame$",
|
||||
names(metadata))][metadata[, field_name]
|
||||
%in% fields])
|
||||
|
||||
form_complete_fields <- paste0(form_names, "_complete")
|
||||
@ -56,34 +54,33 @@ focused_metadata <- function(metadata, vars_in_data) {
|
||||
timestamp_fields <- timestamps
|
||||
|
||||
fields <- c(fields, timestamp_fields)
|
||||
|
||||
}
|
||||
|
||||
# Process ".*\\.factor" fields supplied by REDCap's export data R script
|
||||
if (any(grepl("\\.factor$", vars_in_data))) {
|
||||
factor_fields <-
|
||||
do.call(
|
||||
"rbind",
|
||||
do.call("rbind",
|
||||
apply(fields,
|
||||
1,
|
||||
function(x, y) {
|
||||
field_indices <- grepl(paste0("^", x[1], "\\.factor$"), y)
|
||||
if (any(field_indices)) {
|
||||
if (any(field_indices))
|
||||
data.frame(
|
||||
field_name = y[field_indices],
|
||||
form_name = x[2],
|
||||
stringsAsFactors = FALSE,
|
||||
row.names = NULL
|
||||
)
|
||||
}
|
||||
},
|
||||
y = vars_in_data
|
||||
)
|
||||
)
|
||||
y = vars_in_data))
|
||||
|
||||
fields <- c(fields, factor_fields[, 1])
|
||||
|
||||
}
|
||||
|
||||
metadata[metadata[, field_name] %in% fields, ]
|
||||
|
||||
}
|
||||
|
||||
#' clean_redcap_name
|
||||
@ -97,18 +94,13 @@ focused_metadata <- function(metadata, vars_in_data) {
|
||||
#' @return vector or data frame, same format as input
|
||||
#' @export
|
||||
#'
|
||||
clean_redcap_name <- function(x) {
|
||||
gsub(
|
||||
" ", "_",
|
||||
gsub(
|
||||
"[' ']$", "",
|
||||
gsub(
|
||||
"[^a-z0-9' '_]", "",
|
||||
clean_redcap_name <- function(x){
|
||||
|
||||
gsub(" ", "_",
|
||||
gsub("[' ']$","",
|
||||
gsub("[^a-z0-9' '_]", "",
|
||||
tolower(x)
|
||||
)
|
||||
)
|
||||
)
|
||||
}
|
||||
)))}
|
||||
|
||||
|
||||
#' Sanitize list of data frames
|
||||
@ -124,18 +116,15 @@ clean_redcap_name <- function(x) {
|
||||
#'
|
||||
sanitize_split <- function(l,
|
||||
generic.names = c(
|
||||
"record_id",
|
||||
"redcap_event_name",
|
||||
"redcap_repeat_instrument",
|
||||
"redcap_repeat_instance"
|
||||
)) {
|
||||
generic.names <- c(get_id_name(l),
|
||||
generic.names,
|
||||
paste0(names(l), "_complete"))
|
||||
|
||||
lapply(l, function(i) {
|
||||
if (ncol(i) > 2) {
|
||||
s <- data.frame(i[, !colnames(i) %in% generic.names])
|
||||
i[!apply(is.na(s), MARGIN = 1, FUN = all), ]
|
||||
i[!apply(is.na(s), MARGIN = 1, FUN = all),]
|
||||
} else {
|
||||
i
|
||||
}
|
||||
@ -143,19 +132,6 @@ sanitize_split <- function(l,
|
||||
}
|
||||
|
||||
|
||||
#' Get the id name
|
||||
#'
|
||||
#' @param data data frame or list
|
||||
#'
|
||||
#' @return character vector
|
||||
get_id_name <- function(data) {
|
||||
if ("list" %in% class(data)) {
|
||||
do.call(c, lapply(data, names))[[1]]
|
||||
} else {
|
||||
names(data)[[1]]
|
||||
}
|
||||
}
|
||||
|
||||
#' Match fields to forms
|
||||
#'
|
||||
#' @param metadata A data frame containing field names and form names
|
||||
@ -167,23 +143,20 @@ get_id_name <- function(data) {
|
||||
#'
|
||||
#'
|
||||
match_fields_to_form <- function(metadata, vars_in_data) {
|
||||
|
||||
metadata <- data.frame(metadata)
|
||||
|
||||
field_form_name <- grepl(".*([Ff]ield|[Ff]orm)[._][Nn]ame$", names(metadata))
|
||||
field_type <- grepl(".*[Ff]ield[._][Tt]ype$", names(metadata))
|
||||
field_form_name <- grepl(".*([Ff]ield|[Ff]orm)[._][Nn]ame$",names(metadata))
|
||||
field_type <- grepl(".*[Ff]ield[._][Tt]ype$",names(metadata))
|
||||
|
||||
fields <- metadata[
|
||||
!metadata[, field_type] %in% c("descriptive", "checkbox"),
|
||||
field_form_name
|
||||
]
|
||||
fields <- metadata[!metadata[,field_type] %in% c("descriptive", "checkbox"),
|
||||
field_form_name]
|
||||
|
||||
names(fields) <- c("field_name", "form_name")
|
||||
|
||||
# Process instrument status fields
|
||||
form_names <- unique(metadata[, grepl(
|
||||
".*[Ff]orm[._][Nn]ame$",
|
||||
names(metadata)
|
||||
)])
|
||||
form_names <- unique(metadata[,grepl(".*[Ff]orm[._][Nn]ame$",
|
||||
names(metadata))])
|
||||
form_complete_fields <- data.frame(
|
||||
field_name = paste0(form_names, "_complete"),
|
||||
form_name = form_names,
|
||||
@ -203,65 +176,57 @@ match_fields_to_form <- function(metadata, vars_in_data) {
|
||||
)
|
||||
|
||||
fields <- rbind(fields, timestamp_fields)
|
||||
|
||||
}
|
||||
|
||||
# Process checkbox fields
|
||||
if (any(metadata[, field_type] == "checkbox")) {
|
||||
checkbox_basenames <- metadata[
|
||||
metadata[, field_type] == "checkbox",
|
||||
field_form_name
|
||||
]
|
||||
if (any(metadata[,field_type] == "checkbox")) {
|
||||
checkbox_basenames <- metadata[metadata[,field_type] == "checkbox",
|
||||
field_form_name]
|
||||
|
||||
checkbox_fields <-
|
||||
do.call(
|
||||
"rbind",
|
||||
do.call("rbind",
|
||||
apply(checkbox_basenames,
|
||||
1,
|
||||
function(x, y) {
|
||||
function(x, y)
|
||||
data.frame(
|
||||
field_name =
|
||||
y[grepl(paste0("^", x[1], "___((?!\\.factor).)+$"),
|
||||
y,
|
||||
perl = TRUE
|
||||
)],
|
||||
y, perl = TRUE)],
|
||||
form_name = x[2],
|
||||
stringsAsFactors = FALSE,
|
||||
row.names = NULL
|
||||
)
|
||||
},
|
||||
y = vars_in_data
|
||||
)
|
||||
)
|
||||
),
|
||||
y = vars_in_data))
|
||||
|
||||
fields <- rbind(fields, checkbox_fields)
|
||||
|
||||
}
|
||||
|
||||
# Process ".*\\.factor" fields supplied by REDCap's export data R script
|
||||
if (any(grepl("\\.factor$", vars_in_data))) {
|
||||
factor_fields <-
|
||||
do.call(
|
||||
"rbind",
|
||||
do.call("rbind",
|
||||
apply(fields,
|
||||
1,
|
||||
function(x, y) {
|
||||
field_indices <- grepl(paste0("^", x[1], "\\.factor$"), y)
|
||||
if (any(field_indices)) {
|
||||
if (any(field_indices))
|
||||
data.frame(
|
||||
field_name = y[field_indices],
|
||||
form_name = x[2],
|
||||
stringsAsFactors = FALSE,
|
||||
row.names = NULL
|
||||
)
|
||||
}
|
||||
},
|
||||
y = vars_in_data
|
||||
)
|
||||
)
|
||||
y = vars_in_data))
|
||||
|
||||
fields <- rbind(fields, factor_fields)
|
||||
|
||||
}
|
||||
|
||||
fields
|
||||
|
||||
}
|
||||
|
||||
#' Split a data frame into separate tables for each form
|
||||
@ -291,12 +256,10 @@ match_fields_to_form <- function(metadata, vars_in_data) {
|
||||
#'
|
||||
#' # Create the fields
|
||||
#' fields <- matrix(
|
||||
#' c(
|
||||
#' "form_a_name", "form_a",
|
||||
#' c("form_a_name", "form_a",
|
||||
#' "form_a_age", "form_a",
|
||||
#' "form_b_name", "form_b",
|
||||
#' "form_b_gender", "form_b"
|
||||
#' ),
|
||||
#' "form_b_gender", "form_b"),
|
||||
#' ncol = 2, byrow = TRUE
|
||||
#' )
|
||||
#'
|
||||
@ -306,17 +269,14 @@ split_non_repeating_forms <-
|
||||
function(table, universal_fields, fields) {
|
||||
forms <- unique(fields[[2]])
|
||||
|
||||
x <- lapply(
|
||||
forms,
|
||||
function(x) {
|
||||
table[names(table) %in% union(
|
||||
universal_fields,
|
||||
fields[fields[, 2] == x, 1]
|
||||
)]
|
||||
}
|
||||
)
|
||||
x <- lapply(forms,
|
||||
function (x) {
|
||||
table[names(table) %in% union(universal_fields,
|
||||
fields[fields[, 2] == x, 1])]
|
||||
})
|
||||
|
||||
structure(x, names = forms)
|
||||
|
||||
}
|
||||
|
||||
|
||||
@ -335,7 +295,7 @@ split_non_repeating_forms <-
|
||||
#'
|
||||
#' @examples
|
||||
#' test <- c("12 months follow-up", "3 steps", "mRS 6 weeks", "Counting to 231 now")
|
||||
#' strsplitx(test, "[0-9]", type = "around")
|
||||
#' strsplitx(test,"[0-9]",type="around")
|
||||
strsplitx <- function(x,
|
||||
split,
|
||||
type = "classic",
|
||||
@ -346,33 +306,26 @@ strsplitx <- function(x,
|
||||
out <- base::strsplit(x = x, split = split, perl = perl, ...)
|
||||
} else if (type == "before") {
|
||||
# split before the delimiter and keep it
|
||||
out <- base::strsplit(
|
||||
x = x,
|
||||
out <- base::strsplit(x = x,
|
||||
split = paste0("(?<=.)(?=", split, ")"),
|
||||
perl = TRUE,
|
||||
...
|
||||
)
|
||||
...)
|
||||
} else if (type == "after") {
|
||||
# split after the delimiter and keep it
|
||||
out <- base::strsplit(
|
||||
x = x,
|
||||
out <- base::strsplit(x = x,
|
||||
split = paste0("(?<=", split, ")"),
|
||||
perl = TRUE,
|
||||
...
|
||||
)
|
||||
...)
|
||||
} else if (type == "around") {
|
||||
# split around the defined delimiter
|
||||
|
||||
out <- base::strsplit(gsub(
|
||||
"~~", "~", # Removes double ~
|
||||
gsub(
|
||||
"^~", "", # Removes leading ~
|
||||
out <- base::strsplit(gsub("~~", "~", # Removes double ~
|
||||
gsub("^~", "", # Removes leading ~
|
||||
gsub(
|
||||
# Splits and inserts ~ at all delimiters
|
||||
paste0("(", split, ")"), "~\\1~", x
|
||||
)
|
||||
)
|
||||
), "~")
|
||||
))), "~")
|
||||
|
||||
} else {
|
||||
# wrong type input
|
||||
stop("type must be 'classic', 'after', 'before' or 'around'!")
|
||||
@ -392,36 +345,37 @@ strsplitx <- function(x,
|
||||
#' @export
|
||||
#'
|
||||
#' @examples
|
||||
#' d2w(c(2:8, 21))
|
||||
#' d2w(data.frame(2:7, 3:8, 1), lang = "da", neutrum = TRUE)
|
||||
#' d2w(c(2:8,21))
|
||||
#' d2w(data.frame(2:7,3:8,1),lang="da",neutrum=TRUE)
|
||||
#'
|
||||
#' ## If everything=T, also larger numbers are reduced.
|
||||
#' ## Elements in the list are same length as input
|
||||
#' d2w(list(2:8, c(2, 6, 4, 23), 2), everything = TRUE)
|
||||
#' d2w(list(2:8,c(2,6,4,23),2), everything=TRUE)
|
||||
#'
|
||||
d2w <- function(x, lang = "en", neutrum = FALSE, everything = FALSE) {
|
||||
d2w <- function(x, lang = "en", neutrum=FALSE, everything=FALSE) {
|
||||
|
||||
# In Danish the written 1 depends on the counted word
|
||||
if (neutrum) nt <- "t" else nt <- "n"
|
||||
|
||||
# A sapply() call with nested lapply() to handle vectors, data.frames and lists
|
||||
convert <- function(x, lang, neutrum) {
|
||||
zero_nine <- data.frame(
|
||||
zero_nine = data.frame(
|
||||
num = 0:9,
|
||||
en = c(
|
||||
"zero",
|
||||
"one",
|
||||
"two",
|
||||
"three",
|
||||
"four",
|
||||
"five",
|
||||
"six",
|
||||
"seven",
|
||||
"eight",
|
||||
"nine"
|
||||
'zero',
|
||||
'one',
|
||||
'two',
|
||||
'three',
|
||||
'four',
|
||||
'five',
|
||||
'six',
|
||||
'seven',
|
||||
'eight',
|
||||
'nine'
|
||||
),
|
||||
da = c(
|
||||
"nul",
|
||||
paste0("e", nt),
|
||||
paste0("e",nt),
|
||||
"to",
|
||||
"tre",
|
||||
"fire",
|
||||
@ -447,45 +401,18 @@ d2w <- function(x, lang = "en", neutrum = FALSE, everything = FALSE) {
|
||||
# Also converts numbers >9 to single digits and writes out
|
||||
# Uses strsplitx()
|
||||
if (everything) {
|
||||
out <- sapply(x, function(y) {
|
||||
do.call(c, lapply(y, function(z) {
|
||||
v <- strsplitx(z, "[0-9]", type = "around")
|
||||
Reduce(paste, sapply(v, convert, lang = lang, neutrum = neutrum))
|
||||
out <- sapply(x,function(y){
|
||||
do.call(c,lapply(y,function(z){
|
||||
v <- strsplitx(z,"[0-9]",type="around")
|
||||
Reduce(paste,sapply(v,convert,lang = lang, neutrum = neutrum))
|
||||
}))
|
||||
|
||||
})
|
||||
} else {
|
||||
out <- sapply(x, convert, lang = lang, neutrum = neutrum)
|
||||
out <- sapply(x,convert,lang = lang, neutrum = neutrum)
|
||||
}
|
||||
|
||||
if (is.data.frame(x)) out <- data.frame(out)
|
||||
|
||||
out
|
||||
}
|
||||
|
||||
#' Test if repeatable or longitudinal
|
||||
#'
|
||||
#' @param data data set
|
||||
#' @param generics default is "redcap_event_name", "redcap_repeat_instrument"
|
||||
#' and "redcap_repeat_instance"
|
||||
#'
|
||||
#' @return logical
|
||||
#' @examples
|
||||
#' is.repeated_longitudinal(c("record_id", "age", "record_id", "gender"))
|
||||
#' is.repeated_longitudinal(redcapcast_data)
|
||||
#' is.repeated_longitudinal(list(redcapcast_data))
|
||||
is.repeated_longitudinal <- function(data, generics = c(
|
||||
"redcap_event_name",
|
||||
"redcap_repeat_instrument",
|
||||
"redcap_repeat_instance"
|
||||
)) {
|
||||
if ("list" %in% class(data)) {
|
||||
names <- data |>
|
||||
lapply(names) |>
|
||||
purrr::list_c()
|
||||
} else if ("data.frame" %in% class(data)) {
|
||||
names <- names(data)
|
||||
} else if ("character" %in% class(data)) {
|
||||
names <- data
|
||||
}
|
||||
any(generics %in% names)
|
||||
}
|
||||
|
@ -3,10 +3,6 @@
|
||||
redcapcast_data <- REDCapR::redcap_read(redcap_uri = keyring::key_get("DB_URI"),
|
||||
token = keyring::key_get("cast_api"),
|
||||
raw_or_label = "label"
|
||||
)$data |> dplyr::tibble()
|
||||
|
||||
# redcapcast_data <- easy_redcap(project.name = "redcapcast_pacakge",
|
||||
# uri = keyring::key_get("DB_URI"),
|
||||
# widen.data = FALSE)
|
||||
)$data
|
||||
|
||||
usethis::use_data(redcapcast_data, overwrite = TRUE)
|
||||
|
Binary file not shown.
@ -22,11 +22,11 @@ returns characters in same format as input
|
||||
Convert single digits to words
|
||||
}
|
||||
\examples{
|
||||
d2w(c(2:8, 21))
|
||||
d2w(data.frame(2:7, 3:8, 1), lang = "da", neutrum = TRUE)
|
||||
d2w(c(2:8,21))
|
||||
d2w(data.frame(2:7,3:8,1),lang="da",neutrum=TRUE)
|
||||
|
||||
## If everything=T, also larger numbers are reduced.
|
||||
## Elements in the list are same length as input
|
||||
d2w(list(2:8, c(2, 6, 4, 23), 2), everything = TRUE)
|
||||
d2w(list(2:8,c(2,6,4,23),2), everything=TRUE)
|
||||
|
||||
}
|
||||
|
@ -8,7 +8,7 @@ easy_redcap(project.name, widen.data = TRUE, uri, ...)
|
||||
}
|
||||
\arguments{
|
||||
\item{project.name}{The name of the current project (for key storage with
|
||||
`keyring::key_set()`, using the default keyring)}
|
||||
`keyring::key_set()`)}
|
||||
|
||||
\item{widen.data}{argument to widen the exported data}
|
||||
|
||||
|
@ -1,17 +0,0 @@
|
||||
% Generated by roxygen2: do not edit by hand
|
||||
% Please edit documentation in R/utils.r
|
||||
\name{get_id_name}
|
||||
\alias{get_id_name}
|
||||
\title{Get the id name}
|
||||
\usage{
|
||||
get_id_name(data)
|
||||
}
|
||||
\arguments{
|
||||
\item{data}{data frame or list}
|
||||
}
|
||||
\value{
|
||||
character vector
|
||||
}
|
||||
\description{
|
||||
Get the id name
|
||||
}
|
@ -1,28 +0,0 @@
|
||||
% Generated by roxygen2: do not edit by hand
|
||||
% Please edit documentation in R/utils.r
|
||||
\name{is.repeated_longitudinal}
|
||||
\alias{is.repeated_longitudinal}
|
||||
\title{Test if repeatable or longitudinal}
|
||||
\usage{
|
||||
is.repeated_longitudinal(
|
||||
data,
|
||||
generics = c("redcap_event_name", "redcap_repeat_instrument", "redcap_repeat_instance")
|
||||
)
|
||||
}
|
||||
\arguments{
|
||||
\item{data}{data set}
|
||||
|
||||
\item{generics}{default is "redcap_event_name", "redcap_repeat_instrument"
|
||||
and "redcap_repeat_instance"}
|
||||
}
|
||||
\value{
|
||||
logical
|
||||
}
|
||||
\description{
|
||||
Test if repeatable or longitudinal
|
||||
}
|
||||
\examples{
|
||||
is.repeated_longitudinal(c("record_id", "age", "record_id", "gender"))
|
||||
is.repeated_longitudinal(redcapcast_data)
|
||||
is.repeated_longitudinal(list(redcapcast_data))
|
||||
}
|
@ -12,7 +12,8 @@ read_redcap_tables(
|
||||
events = NULL,
|
||||
forms = NULL,
|
||||
raw_or_label = "label",
|
||||
split_forms = "all"
|
||||
split_forms = "all",
|
||||
generics = c("redcap_event_name", "redcap_repeat_instrument", "redcap_repeat_instance")
|
||||
)
|
||||
}
|
||||
\arguments{
|
||||
|
@ -5,13 +5,13 @@
|
||||
\title{Redcap Wider}
|
||||
\usage{
|
||||
redcap_wider(
|
||||
data,
|
||||
list,
|
||||
event.glue = "{.value}_{redcap_event_name}",
|
||||
inst.glue = "{.value}_{redcap_repeat_instance}"
|
||||
)
|
||||
}
|
||||
\arguments{
|
||||
\item{data}{A list of data frames.}
|
||||
\item{list}{A list of data frames.}
|
||||
|
||||
\item{event.glue}{A dplyr::glue string for repeated events naming}
|
||||
|
||||
@ -25,36 +25,11 @@ Converts a list of REDCap data frames from long to wide format.
|
||||
Handles longitudinal projects, but not yet repeated instruments.
|
||||
}
|
||||
\examples{
|
||||
# Longitudinal
|
||||
list1 <- list(data.frame(record_id = c(1,2,1,2),
|
||||
list <- list(data.frame(record_id = c(1,2,1,2),
|
||||
redcap_event_name = c("baseline", "baseline", "followup", "followup"),
|
||||
age = c(25,26,27,28)),
|
||||
data.frame(record_id = c(1,2),
|
||||
redcap_event_name = c("baseline", "baseline"),
|
||||
gender = c("male", "female")))
|
||||
redcap_wider(list1)
|
||||
# Simpel with two instruments
|
||||
list2 <- list(data.frame(record_id = c(1,2),
|
||||
age = c(25,26)),
|
||||
data.frame(record_id = c(1,2),
|
||||
gender = c("male", "female")))
|
||||
redcap_wider(list2)
|
||||
# Simple with single instrument
|
||||
list3 <- list(data.frame(record_id = c(1,2),
|
||||
age = c(25,26)))
|
||||
redcap_wider(list3)
|
||||
# Longitudinal with repeatable instruments
|
||||
list4 <- list(data.frame(record_id = c(1,2,1,2),
|
||||
redcap_event_name = c("baseline", "baseline", "followup", "followup"),
|
||||
age = c(25,26,27,28)),
|
||||
data.frame(record_id = c(1,1,1,1,2,2,2,2),
|
||||
redcap_event_name = c("baseline", "baseline", "followup", "followup",
|
||||
"baseline", "baseline", "followup", "followup"),
|
||||
redcap_repeat_instrument = "walk",
|
||||
redcap_repeat_instance=c(1,2,1,2,1,2,1,2),
|
||||
dist = c(40, 32, 25, 33, 28, 24, 23, 36)),
|
||||
data.frame(record_id = c(1,2),
|
||||
redcap_event_name = c("baseline", "baseline"),
|
||||
gender = c("male", "female")))
|
||||
redcap_wider(list4)
|
||||
redcap_wider(list)
|
||||
}
|
||||
|
@ -6,7 +6,7 @@
|
||||
\usage{
|
||||
sanitize_split(
|
||||
l,
|
||||
generic.names = c("redcap_event_name", "redcap_repeat_instrument",
|
||||
generic.names = c("record_id", "redcap_event_name", "redcap_repeat_instrument",
|
||||
"redcap_repeat_instance")
|
||||
)
|
||||
}
|
||||
|
@ -36,12 +36,10 @@ universal_fields <- c("id")
|
||||
|
||||
# Create the fields
|
||||
fields <- matrix(
|
||||
c(
|
||||
"form_a_name", "form_a",
|
||||
c("form_a_name", "form_a",
|
||||
"form_a_age", "form_a",
|
||||
"form_b_name", "form_b",
|
||||
"form_b_gender", "form_b"
|
||||
),
|
||||
"form_b_gender", "form_b"),
|
||||
ncol = 2, byrow = TRUE
|
||||
)
|
||||
|
||||
|
@ -26,5 +26,5 @@ easing the split around the defined delimiter, see example.
|
||||
}
|
||||
\examples{
|
||||
test <- c("12 months follow-up", "3 steps", "mRS 6 weeks", "Counting to 231 now")
|
||||
strsplitx(test, "[0-9]", type = "around")
|
||||
strsplitx(test,"[0-9]",type="around")
|
||||
}
|
||||
|
@ -3,11 +3,10 @@
|
||||
#devtools::install_github("pegeler/REDCapRITS/R@longitudinal-data")
|
||||
|
||||
# Debugging reading in longitudinal datasets ------------------------------
|
||||
# setwd(here::here(""))
|
||||
|
||||
# Reading in the files
|
||||
file_paths <- file.path(
|
||||
"test-data/test_splitr",
|
||||
"../test-data/test_splitr/",
|
||||
c(
|
||||
records = "WARRIORtestForSoftwa_DATA_2018-06-21_1431.csv",
|
||||
metadata = "WARRIORtestForSoftwareUpgrades_DataDictionary_2018-06-21.csv"
|
||||
|
@ -35,7 +35,7 @@ redcapcast_meta |> gt::gt()
|
||||
list <-
|
||||
REDCap_split(records = redcapcast_data,
|
||||
metadata = redcapcast_meta,
|
||||
forms = "repeating")|> sanitize_split()
|
||||
forms = "repeating")
|
||||
str(list)
|
||||
```
|
||||
|
||||
@ -43,7 +43,7 @@ str(list)
|
||||
list <-
|
||||
REDCap_split(records = redcapcast_data,
|
||||
metadata = redcapcast_meta,
|
||||
forms = "all") |> sanitize_split()
|
||||
forms = "all")
|
||||
str(list)
|
||||
```
|
||||
|
||||
@ -60,7 +60,7 @@ The function works very similar to the `REDCapR::redcap_read()` in allowing to s
|
||||
## Pivotting to wider format
|
||||
|
||||
```{r}
|
||||
redcap_wider(list) |> str()
|
||||
# redcap_wider(ds)
|
||||
```
|
||||
|
||||
|
||||
|
Loading…
Reference in New Issue
Block a user