tidyREDCap

Helper functions for processing REDCap data in R

https://github.com/raymondbalise/tidyredcap

Science Score: 23.0%

This score indicates how likely this project is to be science-related based on various indicators:

○
CITATION.cff file
✓
codemeta.json file
Found codemeta.json file
○
.zenodo.json file
○
DOI references
○
Academic publication links
✓
Committers with academic emails
7 of 10 committers (70.0%) from academic institutions
○
Institutional organization owner
○
JOSS paper metadata
○
Scientific vocabulary similarity
Low similarity (15.0%) to scientific vocabulary

Last synced: 10 months ago · JSON representation

Repository

Helper functions for processing REDCap data in R

Basic Info

Host: GitHub
Owner: RaymondBalise
License: other
Language: R
Default Branch: master
Homepage: https://raymondbalise.github.io/tidyREDCap/
Size: 1.69 MB

Statistics

Stars: 8
Watchers: 3
Forks: 5
Open Issues: 23
Releases: 0

Created over 6 years ago · Last pushed 12 months ago

Metadata Files

Readme License

README.md

tidyREDCap

tidyREDCap is an R package with functions for processing REDCap data.

'REDCap' (Research Electronic Data CAPture; https://projectredcap.org) is a web-enabled application for building and managing surveys and databases developed at Vanderbilt University.

What tidyREDCap Functions Can Do for You?

Load All Data from REDCap into R with One Line of Code

💥 NEW in Version 1.1 💥 import_instruments() includes the repeat number for repeated instruments/forms/questionnaires.
import_instruments() will use an API call to load every instrument/questionnaire into its own R dataset. If the REDCap project is longitudinal or has repeated instruments, the function will remove blank records.

Show the Field Labels Inside RStudio

After loading data into R using RStudio with the import_instruments() function, you can see both the variable name and the text that appears to users of REDCap. All you need to do is click on the dataset's name in the Environment tab or use the View() function. The column headings will include both the variable name and the Field Label from REDCap.
💥 NEW in Version 1.1 💥 Functions coming from packages outside of tidyREDCap may not understand what to do with labeled variables. So, tidyREDCap includes a new drop_labels() function that will allow you to strip the labels before using functions that want unlabeled data.

Working with Choose One Questions

make_choose_one_table(): print a janitor::tabyl() style table with a variable label. This function lets you print one choice from a choose all that apply question.

Working with Choose All that Apply Questions

REDCap exports the responses to a choose all that apply question into many similarly named questions. tidyREDCap helps summarize the responses with two functions:

make_binary_word(): converts all the responses into a single descriptive "word"
make_choose_all_table(): converts all the responses into a single summary table

Working with Repeated Measures

Projects that have repeated assessments with different questionnaires/instruments export with holes in the CSV. tidyREDCap will parse the export and create tables for any of the questionnaires/instruments:

make_instrument(): makes a tibble for a questionnaire/instrument

What are the tidyREDCap Websites?

Main Page: https://raymondbalise.github.io/tidyREDCap/
User Guides: https://raymondbalise.github.io/tidyREDCap/articles/
Development Site: https://github.com/RaymondBalise/tidyREDCap

Where Can I Find tidyREDCap?

Offical Release

You can get the latest official release of tidyREDCap from CRAN. install.packages("tidyREDCap")

Development Release

Run these two lines of code to install tidyREDCap from GitHub (this requires RTools for Windows or Xcode for Mac to be installed on your computer):

if (!requireNamespace("devtools")) install.packages("devtools") devtools::install_github("RaymondBalise/tidyREDCap")

What is new on the development release?

💥 NEW in Version 1.1.0.9000 💥 adds make_yes_no() function to convert "checked" or "yes"-like answers to "Yes" and other answers to "No or Unknown".
💥 NEW in Version 1.1.0.9000 💥 adds make_yes_no_unknown() function to convert "checked" or "yes"-like answers to "Yes"", unchecked or "no"-like answers to "No" and other answers to "Unknown".

What if I Find a Problem?

We are currently in active development of tidyREDCap. If one of our functions does not work the way that you expect, or if one of our functions is broken, please submit an issue ticket (using a reproducible example) to our issues page. If you have a cool idea for our next new function, also submit an issue ticket. If you are an R developer and want so contribute to this package, please submit an issue ticket or a pull request.

Who Are Our Supporters?

The development of this package was supported by:

Healing Communities Study: Developing and Testing and Integrated Approach to Address the Opioid Crisis-New York State.
- National Institute on Drug Abuse, 1 UM1 DA049415
CTN-0094 Individual Level Predictive Modeling of Opioid Use Disorder Treatment Outcome.
- Florida Node Alliance Of The Drug Abuse Clinical Trials Network NIDA UG1 DA013720
University of Miami Center for HIV and Researching Mental Health (CHARM)
- NIH 1P30MH116867-01A1
University of Miami, Sylvester Comprehensive Cancer Center
Florida International University, Stempel College of Public Health

Owner

Name: Raymond R. Balise, PhD
Login: RaymondBalise
Kind: user
Location: Miami, Florida
Company: University of Miami

Website: https://derailment.netlify.com/
Twitter: raymondBalise
Repositories: 5
Profile: https://github.com/RaymondBalise

Associate Professor, Biostatistics

GitHub Events

Total

Create event: 2
Issues event: 1
Release event: 1
Issue comment event: 3
Push event: 5
Pull request review event: 1
Pull request event: 2
Fork event: 1

Last Year

Create event: 2
Issues event: 1
Release event: 1
Issue comment event: 3
Push event: 5
Pull request review event: 1
Pull request event: 2
Fork event: 1

Committers

Last synced: over 2 years ago

All Time

Total Commits: 176
Total Committers: 10
Avg Commits per committer: 17.6
Development Distribution Score (DDS): 0.347

Past Year

Commits: 37
Committers: 4
Avg Commits per committer: 9.25
Development Distribution Score (DDS): 0.189

Top Committers

Name	Email	Commits
Raymond R. Balise	b**e@m**u	115
Anna Calderon	a**8@m**u	19
wfd14	w**4@m**u	14
Gabriel J. Odom	g**m@f**u	13
gabrielodom	g**m@b**u	9
Will Beasley	w**y@h**m	2
Layla Bouzoubaa	l**8@m**u	1
Gabriel J. Odom	g**5@m**u	1
Lionel Henry	l**y@g**m	1
AnnaCalderon	5****n	1

Committer Domains (Top 20 + Academic)

miami.edu: 4 med.miami.edu: 1 baylor.edu: 1 fiu.edu: 1

Issues and Pull Requests

Last synced: 11 months ago

All Time

Total issues: 49
Total pull requests: 26
Average time to close issues: 3 months
Average time to close pull requests: 23 days
Total issue authors: 14
Total pull request authors: 8
Average comments per issue: 1.06
Average comments per pull request: 0.58
Merged pull requests: 19
Bot issues: 0
Bot pull requests: 0

Past Year

Issues: 2
Pull requests: 3
Average time to close issues: N/A
Average time to close pull requests: 5 days
Issue authors: 1
Pull request authors: 3
Average comments per issue: 0.0
Average comments per pull request: 0.67
Merged pull requests: 1
Bot issues: 0
Bot pull requests: 0

View more stats

Top Authors

Issue Authors

RaymondBalise (22)
gabrielodom (6)
wdefreitas (4)
TIngchangW (2)
alnajar (2)
wibeasley (2)
labouz (2)
reedthomasklein (1)
darthpathos76 (1)
AnnaCalderon (1)
drstormR (1)
spgarbet (1)
llrs (1)
ha0ye (1)

Pull Request Authors

AnnaCalderon (8)
RaymondBalise (7)
kyleGrealis (4)
wibeasley (4)
wdefreitas (2)
dylanpieper (1)
wdefreit (1)
labouz (1)
lionel- (1)

Top Labels

Issue Labels

enhancement (6) bug (3) build request (2) documentation (2)

Pull Request Labels

Packages

Total packages: 1
Total downloads:
- cran 374 last-month
Total docker downloads: 21,613

Total dependent packages: 0
Total dependent repositories: 0
Total versions: 7
Total maintainers: 1

cran.r-project.org: tidyREDCap

Helper Functions for Working with 'REDCap' Data

Homepage: https://raymondbalise.github.io/tidyREDCap/index.html
Documentation: http://cran.r-project.org/web/packages/tidyREDCap/tidyREDCap.pdf
License: MIT + file LICENSE
Latest release: 1.1.2
published almost 2 years ago

Versions: 7
Dependent Packages: 0
Dependent Repositories: 0
Downloads: 374 Last month
Docker Downloads: 21,613

Rankings

Forks count: 17.8%

Stargazers count: 21.1%

Average: 26.3%

Downloads: 27.3%

Dependent packages count: 29.8%

Dependent repos count: 35.5%

Maintainers (1)

balise@miami.edu

Last synced: 11 months ago

Dependencies

DESCRIPTION cran

R >= 3.5.0 depends
dplyr * imports
janitor * imports
magrittr * imports
purrr * imports
rlang * imports
stringr * imports
tibble * imports
tidyr * imports
knitr * suggests
redcapAPI * suggests
rmarkdown * suggests
testthat >= 2.1.0 suggests