Skip to content

Commit 1ab5b6b

Browse files
committed
Merge branch 'release/0.1.1'
2 parents dce31ae + e986281 commit 1ab5b6b

File tree

6 files changed

+30
-23
lines changed

6 files changed

+30
-23
lines changed

.github/workflows/pkgdown.yaml

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -15,6 +15,7 @@ permissions: read-all
1515
jobs:
1616
pkgdown:
1717
runs-on: ubuntu-latest
18+
environment: github-pages
1819
# Only restrict concurrency for non-PR jobs
1920
concurrency:
2021
group: pkgdown-${{ github.event_name != 'pull_request' || github.run_id }}

CITATION.cff

Lines changed: 12 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -2,10 +2,10 @@
22
# Visit https://bit.ly/cffinit to generate yours today!
33

44
cff-version: 1.2.0
5-
title: Fill a REDCap Project with synthetic data
5+
title: REDCap Filler - an R package that fills a REDCap Project with synthetic data
66
message:
7-
If you use this software, please cite it using the
8-
metadata from this file.
7+
If you use this software, please cite it with the metadata
8+
in CITATION.cff or https://doi.org/10.5281/zenodo.15635725
99
type: software
1010
authors:
1111
- family-names: Chase
@@ -38,16 +38,20 @@ repository-code:
3838
url:
3939
https://ctsit.github.io/redcapfiller/
4040
abstract:
41-
Fill a REDCap Project with synthetic data based on the project
42-
design and a minimal set of inputs.
41+
REDCap Filler is an R package that can fill a REDCap project
42+
with synthetic data using the project design and a minimal
43+
set of paramaters as input. It uses the REDCap API to read
44+
a project's design and write the synthetic data back to the
45+
project.
4346
keywords:
4447
- redcap
48+
- redcap api
4549
- clinical science
4650
- data management
4751
- synthetic data
4852
identifiers:
4953
- type: doi
50-
value: 10.5281/zenodo.15634676
54+
value: 10.5281/zenodo.15635725
5155
license: Apache-2.0
52-
version: 0.1.0
53-
date-released: '2025-06-10'
56+
version: 0.1.1
57+
date-released: '2025-06-11'

DESCRIPTION

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
Package: redcapfiller
22
Type: Package
33
Title: Fill a REDCap Project with synthetic data
4-
Version: 0.1.0
4+
Version: 0.1.1
55
Authors@R: c(
66
person("Philip", "Chase",
77
email = "pbc@ufl.edu",

LICENSE.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,5 @@
1+
# Apache 2.0 License
2+
13
Copyright 2025 University of Florida
24

35
Licensed under the Apache License, Version 2.0 (the "License");

NEWS.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,8 @@
1+
# redcapfiller 0.1.1 (released 2025-06-11)
2+
- Fix initial release errors (@pbchase, #36)
3+
14
# redcapfiller 0.1.0 (released 2025-06-10)
5+
* Initial release (@pbchase, @saipavan10-git, @ljwoodley)
26
* Works on **classic projects** and **longitudinal projects**.
37
* Uses the REDCap API to read the project design and write the generated data.
48
* Fills categorical fields (providing a uniform random distribution).
@@ -10,4 +14,3 @@
1014
* Does not violate basic data constraints defined in the data dictionary (e.g., validation types, ranges where applicable).
1115
* Populates specified events in longitudinal projects.
1216
* Fills a specified number of records.
13-
* Authors: @pbchase, @saipavan10-git, @ljwoodley

README.md

Lines changed: 10 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,14 @@
11
[REDCap Filler](https://github.com/ctsit/redcapfiller)
22
=======
33

4-
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.
4+
[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.15635725.svg)](https://doi.org/10.5281/zenodo.15635725)
5+
[![R-CMD-check](https://github.com/ctsit/redcapfiller/actions/workflows/R-CMD-check.yaml/badge.svg)](https://github.com/ctsit/redcapfiller/actions/workflows/R-CMD-check.yaml)
6+
7+
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.
58

69
### Installation
710

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:
912

1013
```r
1114
install.packages("remotes") # Run this line if the 'remotes' package hasn't been installed already.
@@ -14,16 +17,16 @@ remotes::install_github("ctsit/redcapfiller")
1417

1518
### Using REDCap Filler
1619

17-
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.
1821

1922
### Limitations
2023

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.
2225

2326
* Works on **classic projects** and **longitudinal projects**.
2427
* Uses the REDCap API to read the project design and write the synthetic data.
2528
* 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.
2730
* Provides random-normal distributions for numeric and date fields.
2831
* Uses "Lorem ipsum" text for non-validated text fields.
2932
* 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
4447

4548
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:
4649

47-
1. Complete support for any text validation types missing currently.
50+
1. Complete support for any text validation types currently missing.
4851
2. Add support for **repeating events** and **repeating forms**.
4952
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.
5154
4. Allow configuration of inter-record and intra-record date offsets.
5255
5. Add support for evaluating **Branching Logic**.
5356
6. Add support for evaluating **Form Display Logic**.
@@ -57,9 +60,3 @@ This project aims to populate complex REDCap projects using the project design.
5760
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>).
5861

5962
We'd like to thank the REDCap Community for their advice and contributions to the design of REDCap Filler.
60-
61-
### Build status
62-
63-
<!-- badges: start -->
64-
[![R-CMD-check](https://github.com/ctsit/redcapfiller/actions/workflows/R-CMD-check.yaml/badge.svg)](https://github.com/ctsit/redcapfiller/actions/workflows/R-CMD-check.yaml)
65-
<!-- badges: end -->

0 commit comments

Comments
 (0)