Rapid Easy Synthesis to Inform Data Extraction
Overview
Assists researchers with planning analysis prior to obtaining data from Trusted Research Environments (TREs), also known as safe havens. Marginal distributions of one or more related data frames can be exported from a TRE and imported elsewhere, where data can be synthesised from them, with or without user specified correlations, by sampling from a multivariate cumulative distribution (copula). The International Stroke Trial (IST) is included as an example dataset under the ODC-By licence, Sandercock et al. (2011) doi:10.7488/ds/104, Sandercock et al. (2011) doi:10.1186/1745-6215-12-101.
Breaking changes
export_empty_cor_matrix()andimport_cor_matrix()are defunct, correlations are now specified using thecorrelationsparameter ofsynthesise_data()with the newcorrelation()function.- The
correlation_matrixparameter ofsynthesise_data()is no longer supported. synthesise_data()returns a named list of data frames for marginals obtained from multiple data frames.- Requires R >= 4.1.0.
New features
- Marginal distributions can be obtained from multiple related data frames, linked by a subject identifier, using
get_marginal_distributions().
Show all changes in 0.4.0Hide the rest of the changes in 0.4.0
correlation()creates a correlation between two variables, categorical variables are correlated using a single category (factor_name.x/factor_name.y) and variables of multiple data frames usingdf_name,df_name.xanddf_name.y, including correlations between data frames.summary()method for RESIDE objects, a higher level summary thanprint().print()shows the 10 most common categories of each categorical variable, useprint(x, full = TRUE)to print every category.- New vignette, a worked example using multiple tables from the pharmaversesdtm package.
Bug fixes
synthesise_data()keeps whitespace in categories.synthesise_data()maintains the number of subjects of each data frame.- Categorical marginal distributions are maintained when synthesising with correlations.
From NEWS.md in the release
Install
Health
- OK13 OK2026-10-17
- NOTE13 NOTE2026-09-08
- ERROR12 NOTE, 1 ERROR2026-09-07
- NOTE13 NOTE2026-06-09
- ERROR12 NOTE, 1 ERROR2026-06-08
Show 1 earlier changeHide 1 earlier change
- NOTE3 OK, 11 NOTE2026-03-10
Documentation
- Help pages
- 14 (2 internal)includes a package overview page
- Examples that run
- 100%9 run in a plain check
- Exported functions with examples
- 100%
- Documented parameters
- 100%
- Return-value docs
- 100%
- Help pages citing references
- 7%
Downloads
Repository
- PRs merged (all time)
- 96%
- Median days to close, 50 most recently updated closed issues
- 15
- Median days to close, 50 most recently updated closed PRs
- 0
Stars over time
Forks over time
Releases over time
Issues over time
Commits over time
11 development-tooling and community-health practices detected across 6 families in the upstream repository
Checks run against github.com/hehta/reside on 2026-10-21.
The R CMD check workflow runs on Linux, macOS and Windows, and on R-devel
GitHub Pages site last deployed 2026-09-30 · The repository has a site deploy workflow
pkgdown site last built 2026-09-30
Show all practicesHide 2 practices
Dependencies
Code & Tests
Datasets
People & History
Pick two releases to compare their code metrics.
- 0.4.0Latest
- RR 4.6.0 released · 2026-04-24
- RR 4.5.0 released · 2025-04-11
- 0.3.22024-10-17
- RR 4.4.0 released · 2024-04-24
Package metadata
- First published
- 2024-10-17
- Total releases
- 2 / 2 yrs
- License
- GPL (>= 3) OSI
- Minimum R
- ≥ 4.1.0
- Bundled data
- 503 KB / 1 file
- Download size
- 598 KB
Cite
Cite this package
Run in R for the authors' preferred citation:
citation("RESIDE")This package has no citation file, so citation() returns this entry built from DESCRIPTION.
The repository also keeps a CITATION.cff.
Cite the R Observatory
For a number measured here: a download total, a coverage figure, an archival date.
From data release v2026-10-25, which the citation names so these numbers can be found later. More on citing and the projects behind them.