https://github.com/chop-cgtinformatics/redcaptidier
Makes it easy to read REDCap Projects into R
https://github.com/chop-cgtinformatics/redcaptidier
r redcap redcap-api tidy-data
Last synced: 3 months ago
JSON representation
Makes it easy to read REDCap Projects into R
- Host: GitHub
- URL: https://github.com/chop-cgtinformatics/redcaptidier
- Owner: CHOP-CGTInformatics
- License: other
- Created: 2022-07-19T18:20:14.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2026-02-17T21:20:05.000Z (3 months ago)
- Last Synced: 2026-02-18T03:12:58.019Z (3 months ago)
- Topics: r, redcap, redcap-api, tidy-data
- Language: HTML
- Homepage: https://chop-cgtinformatics.github.io/REDCapTidieR/
- Size: 29.4 MB
- Stars: 40
- Watchers: 4
- Forks: 12
- Open Issues: 21
-
Metadata Files:
- Readme: README.Rmd
- Changelog: NEWS.md
- License: LICENSE
Awesome Lists containing this project
README
---
output: github_document
---
```{r, include = FALSE}
knitr::opts_chunk$set(
collapse = TRUE,
comment = "#>",
fig.path = "man/figures/README-",
out.width = "100%"
)
```
# REDCapTidieR 
[](https://lifecycle.r-lib.org/articles/stages.html#stable)
[](https://github.com/CHOP-CGTInformatics/REDCapTidieR/actions/workflows/R-CMD-check.yaml)
[](https://CRAN.R-project.org/package=REDCapTidieR)
[](https://cran.r-project.org/package=REDCapTidieR)
[](https://cran.r-project.org/package=REDCapTidieR)
[](https://app.codecov.io/gh/CHOP-CGTInformatics/REDCapTidieR?branch=main)
[](https://bestpractices.coreinfrastructure.org/projects/6845)
The REDCapTidieR package provides an elegant way to [import](https://chop-cgtinformatics.github.io/REDCapTidieR/articles/glossary.html#import) data from a [REDCap](https://projectredcap.org/) [project](https://chop-cgtinformatics.github.io/REDCapTidieR/articles/glossary.html#project) into an R environment. It builds upon the [REDCapR](https://ouhscbbmc.github.io/REDCapR/) package to query the [REDCap API](https://chop-cgtinformatics.github.io/REDCapTidieR/articles/glossary.html#redcap-api) and then transforms the returned data into a set of [tidy](https://chop-cgtinformatics.github.io/REDCapTidieR/articles/glossary.html#tidy) [tibbles](https://chop-cgtinformatics.github.io/REDCapTidieR/articles/glossary.html#tibble).
REDCapTidieR is especially useful for dealing with complex REDCap projects that are [longitudinal](https://chop-cgtinformatics.github.io/REDCapTidieR/articles/glossary.html#longitudinal-project) or include [repeating](https://chop-cgtinformatics.github.io/REDCapTidieR/articles/glossary.html#repeating) [instruments](https://chop-cgtinformatics.github.io/REDCapTidieR/articles/glossary.html#instrument) or both.
## Installation
The release version can be installed from [CRAN](https://cran.r-project.org/package=REDCapTidieR).
```r
install.packages("REDCapTidieR")
```
You can install the development version of REDCapTidieR from [GitHub](https://github.com/CHOP-CGTInformatics/REDCapTidieR):
```r
devtools::install_github("CHOP-CGTInformatics/REDCapTidieR")
```
## Usage
Use `read_redcap()` together with `bind_tibbles()` to import data from all instruments into your environment.
REDCapTidieR supports labelled data using the [labelled](https://larmarange.github.io/labelled/) package, and it can generate statistical summaries using the [skimr](https://docs.ropensci.org/skimr/) package.
Read the [Getting Started vignette](https://chop-cgtinformatics.github.io/REDCapTidieR/articles/REDCapTidieR.html) to learn more.
In addition, you can easily create collaborator-friendly Excel files using the `write_redcap_xlsx()` function:
```{r, eval=FALSE}
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")
```
To learn more about how to work with and customize the output, read the [Exporting to Excel vignette](https://chop-cgtinformatics.github.io/REDCapTidieR/articles/export_to_xlsx.html).
## 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](https://github.com/CHOP-CGTInformatics/REDCapTidieR/pulls). Please do let us know if REDCapTidieR fails for whatever reason with your database and submit a bug report by creating a GitHub [issue](https://github.com/CHOP-CGTInformatics/REDCapTidieR/issues).
Please note that this project is released with a [Contributor Code of Conduct](https://github.com/CHOP-CGTInformatics/REDCapTidieR/blob/main/CONDUCT.md). 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](https://github.com/wibeasley) and [Paul Wildenhain](https://github.com/pwildenhain).
## Funding
This package was developed by the [Children's Hospital of Philadelphia](https://www.chop.edu) Cell and Gene Therapy Informatics Team to support the needs of the [Cellular Therapy and Transplant Section](https://www.chop.edu/centers-programs/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