You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
REDCap Filler provides a testing and development service to users of Vanderbilt University's [REDCap](https://projectredcap.org/). It generates and loads synthetic test data into a REDCap project, using the project's design to guide test data generation. This data-driven process allows rapid data creation with minimal effort. This provides a low-cost way to test many of the project features. It provides test data as input for reporting and other downstream processes.
REDCap Filler provides a testing and development service to users of Vanderbilt University's [REDCap](https://projectredcap.org/). It generates and loads synthetic test data into a REDCap project, using the project's design to guide test data generation. This data-driven process allows rapid data creation with minimal effort. This provides a low-cost way to test many of the project features. It creates test data as input for reporting and other downstream processes.
5
8
6
9
### Installation
7
10
8
-
The redcapfiller package is only available as source code on GitHub. Install it from github inside R or RStudio using the `remotes` package:
11
+
The redcapfiller package is only available as source code on GitHub. Install it from GitHub inside R or RStudio using the `remotes` package:
9
12
10
13
```r
11
14
install.packages("remotes") # Run this line if the 'remotes' package hasn't been installed already.
See https://ctsit.github.io/redcapfiller/articles/getting_started.html to learn how to use redcapfiller.
20
+
See [Getting started with redcapfiller](https://ctsit.github.io/redcapfiller/articles/getting_started.html) to learn how to use redcapfiller.
18
21
19
22
### Limitations
20
23
21
-
REDCap Filler does not yet understand all the dimensions of a modern REDCap project. It can fill the categorical fields. It can fill unvalidated text field and the text validation types date, datetime, email, integer, number, phone, and zipcode. It ignores all other field types and validation types and will not attempt to fill them. Filler can fill classic and longitudinal projects, but not if they have repeating forms, repeating events, or randomization enabled. It does not honor form display logic and ignores all fields governed by branching logic.
24
+
REDCap Filler does not yet understand all the dimensions of a modern REDCap project. It can fill the categorical fields. It can fill unvalidated text fields and the text validation types date, datetime, email, integer, number, phone, and zip code. It ignores all other field types and validation types and will not attempt to fill them. Filler can fill classic and longitudinal projects, but not if they have repeating forms, repeating events, or randomization enabled. It does not honor form display logic and ignores all fields governed by branching logic.
22
25
23
26
* Works on **classic projects** and **longitudinal projects**.
24
27
* Uses the REDCap API to read the project design and write the synthetic data.
25
28
* Fills categorical fields (providing a uniform random distribution).
26
-
* Fills unvalidated text fields and fields with common text validation types: date, datetime, email, integer, number, phone, and zipcode.
29
+
* Fills unvalidated text fields and fields with common text validation types: date, datetime, email, integer, number, phone, and zip code.
27
30
* Provides random-normal distributions for numeric and date fields.
28
31
* Uses "Lorem ipsum" text for non-validated text fields.
29
32
* Injects simple default randomness where practicable for other types.
@@ -44,10 +47,10 @@ REDCap Filler does not yet understand all the dimensions of a modern REDCap proj
44
47
45
48
This project aims to populate complex REDCap projects using the project design. If the REDCap API exposes a design dimension, we plan to use that to guide how the Filler populates projects. Yet, that will take some time to develop fully. This is the proposed timeline of features:
46
49
47
-
1. Complete support for any text validation types missing currently.
50
+
1. Complete support for any text validation types currently missing.
48
51
2. Add support for **repeating events** and **repeating forms**.
49
52
3. Skip randomization fields to allow support for projects with **randomization**.
50
-
3. Allow user specification of non-uniform distributions for categorical fields and non-default distributions for ranged fields.
53
+
4. Allow users to specify non-uniform distributions for categorical fields and non-default distributions for range fields.
51
54
4. Allow configuration of inter-record and intra-record date offsets.
52
55
5. Add support for evaluating **Branching Logic**.
53
56
6. Add support for evaluating **Form Display Logic**.
@@ -57,9 +60,3 @@ This project aims to populate complex REDCap projects using the project design.
57
60
We encourage input and collaboration. If you're familiar with GitHub and R packages, submit a [pull request](https://github.com/ctsit/redcapfiller/pulls). If you'd like to report a bug or suggest, please create a GitHub [issue](https://github.com/ctsit/redcapfiller/issues); issues are usually a good place to ask public questions, too. However, email Philip if you prefer an offline dialog (<pbc@ufl.edu>).
58
61
59
62
We'd like to thank the REDCap Community for their advice and contributions to the design of REDCap Filler.
0 commit comments