MyNixOS website logo
Description

Extract 'REDCap' Databases into Tidy 'Tibble's.

Convert 'REDCap' exports into tidy tables for easy handling of 'REDCap' repeat instruments and event arms.

REDCapTidieR

Lifecycle:stable R-CMD-check CRANstatus Codecov testcoverage OpenSSF BestPractices DOI

The REDCapTidieR package provides an elegant way to import data from a REDCapproject into an R environment. It builds upon the REDCapR package to query the REDCap API and then transforms the returned data into a set of tidytibbles.

REDCapTidieR is especially useful for dealing with complex REDCap projects that are longitudinal or include repeatinginstruments or both.

Installation

The release version can be installed from CRAN.

install.packages("REDCapTidieR")

You can install the development version of REDCapTidieR from GitHub:

devtools::install_github("CHOP-CGTInformatics/REDCapTidieR")

Usage

Use read_redcap() together with bind_tibbles() to import data from all instruments into your environment.

Demonstration of using the read_redcap() and bind_tibbles() functions

REDCapTidieR supports labelled data using the labelled package, and it can generate statistical summaries using the skimr package.

Read the Getting Started vignette to learn more.

In addition, you can easily create collaborator-friendly Excel files using the write_redcap_xlsx() function:

redcap_uri <- "https://my.institution.edu/redcap/api/"
token <- "123456789ABCDEF123456789ABCDEF04"

my_redcap_data <- read_redcap(redcap_uri, token)
write_redcap_xlsx(my_redcap_data, file = "my_redcap_data.xlsx")
Sample REDCapTidieR .xlsx output using write_redcap_xlsx()

To learn more about how to work with and customize the output, read the Exporting to Excel vignette.

Collaboration

We invite you to give feedback and collaborate with us! If you are familiar with GitHub and R packages, please feel free to submit a pull request. Please do let us know if REDCapTidieR fails for whatever reason with your database and submit a bug report by creating a GitHub issue.

Please note that this project is released with a Contributor Code of Conduct. By participating you agree to abide by its terms.

We’d like to thank the following folks for their advice and code contributions: Will Beasley and Paul Wildenhain.

Funding

This package was developed by the Children’s Hospital of Philadelphia Cell and Gene Therapy Informatics Team to support the needs of the Cellular Therapy and Transplant Section. The development was funded using the following sources:

  • Stephan Kadauke Start-up funds. Stephan Kadauke, PI, CHOP, 2018-2024

  • CHOP-based GMP cell manufacturing (MFG) for CAR T clinical trials. Stephan Grupp, PI; Stephan Kadauke, co-PI, CHOP, 2021-2023

Metadata

Version

1.1.1

License

Unknown

Platforms (75)

    Darwin
    FreeBSD
    Genode
    GHCJS
    Linux
    MMIXware
    NetBSD
    none
    OpenBSD
    Redox
    Solaris
    WASI
    Windows
Show all
  • aarch64-darwin
  • aarch64-genode
  • aarch64-linux
  • aarch64-netbsd
  • aarch64-none
  • aarch64_be-none
  • arm-none
  • armv5tel-linux
  • armv6l-linux
  • armv6l-netbsd
  • armv6l-none
  • armv7a-darwin
  • armv7a-linux
  • armv7a-netbsd
  • armv7l-linux
  • armv7l-netbsd
  • avr-none
  • i686-cygwin
  • i686-darwin
  • i686-freebsd
  • i686-genode
  • i686-linux
  • i686-netbsd
  • i686-none
  • i686-openbsd
  • i686-windows
  • javascript-ghcjs
  • loongarch64-linux
  • m68k-linux
  • m68k-netbsd
  • m68k-none
  • microblaze-linux
  • microblaze-none
  • microblazeel-linux
  • microblazeel-none
  • mips-linux
  • mips-none
  • mips64-linux
  • mips64-none
  • mips64el-linux
  • mipsel-linux
  • mipsel-netbsd
  • mmix-mmixware
  • msp430-none
  • or1k-none
  • powerpc-netbsd
  • powerpc-none
  • powerpc64-linux
  • powerpc64le-linux
  • powerpcle-none
  • riscv32-linux
  • riscv32-netbsd
  • riscv32-none
  • riscv64-linux
  • riscv64-netbsd
  • riscv64-none
  • rx-none
  • s390-linux
  • s390-none
  • s390x-linux
  • s390x-none
  • vc4-none
  • wasm32-wasi
  • wasm64-wasi
  • x86_64-cygwin
  • x86_64-darwin
  • x86_64-freebsd
  • x86_64-genode
  • x86_64-linux
  • x86_64-netbsd
  • x86_64-none
  • x86_64-openbsd
  • x86_64-redox
  • x86_64-solaris
  • x86_64-windows