Declare and Diagnose Research Designs
Overview
Researchers can characterize and learn about the properties of research designs before implementation using `DeclareDesign`. Ex ante declaration and diagnosis of designs can help researchers clarify the strengths and limitations of their designs and to improve their properties, and can help readers evaluate a research strategy prior to implementation and without access to results. It can also make it easier for designs to be shared, replicated, and critiqued.
- Bug fix: replaced unexported rlang internal
quo_get_env()with the exportedget_env()inaaa.Randdeclare_potential_outcomes.R. The unexported function caused test failures on CRAN when rlang updated its export list. - Bug fix: replaced
enquo()withsubstitute()in+.ddto correctly capture step expressions under the new rlang C API. Thanks to Lionel Henry (@lionel-) for the fix. - Added
CausalQueries,rdrobust, andrdsstoSuggeststo satisfy CRAN dependency checks for tests that use those packages. - Made top-level test setup use soft package loads so checks pass when suggested packages are not locally installed.
- Improved
print.design()output: clearer labels, deduplication of parameter names across environments, and truncation of long values in the printed parameter table. - Added example to
select_diagnosands()documentation showing use of thealphaargument.
From NEWS.md in the release
Install
Health
NOTER code for possible problemsr-devel-linux-x86_64-debian-clang, r-devel-linux-x86_64-debian-gcc, r-devel-linux-x86_64-fedora-clang, r-devel-linux-x86_64-fedora-gcc, r-devel-windows-x86_64
Found calls to structure() using deprecated special names: DeclareDesign/tests/testthat/test-describe_variable.R (.Names: 1) DeclareDesign/tests/testthat/test-diagnosands.R (.Label: 3) DeclareDesign/tests/testthat/test-estimands.R (.Names: 6, .Label: 1) DeclareDesign/tests/testthat/test-expand-design.R (.Dim: 4, .Dimnames: 4) DeclareDesign/tests/testthat/test-model.R (.Label: 1) DeclareDesign/tests/testthat/test-reshape-diagnosis.R (.Label: 1) DeclareDesign/tests/testthat/test-scaffolding.R (.Label: 1, .Names: 1) '.Names' should be changed to 'names'. '.Label' should be changed to 'levels'. '.Dim' should be changed to 'dim'. '.Dimnames' should be changed to 'dimnames'.
- NOTE8 OK, 5 NOTENow
- NOTE10 OK, 3 NOTE2026-07-16
- OK13 OK2026-05-06
- ERROR13 OK, 1 ERROR2026-04-07
- OK14 OK2026-03-10
Documentation
- Help pages
- 39 (8 internal)includes a package overview page
- Examples that run
- 97%30 run in a plain check · 1 never run
- Exported functions with examples
- 85%
- Documented parameters
- 93%
- Return-value docs
- 64%
- Help pages citing references
- 0%
Downloads
Repository
- PRs merged (all time)
- 91%
- Median days to close, 50 most recently updated closed issues
- 317
- Median days to close, 50 most recently updated closed PRs
- 2
Stars over time
Forks over time
Releases over time
Issues over time
PRs over time
Commits over time
Commit identities over time
10 development-tooling and community-health practices detected across 6 families in the upstream repository
Checks run against github.com/declaredesign/declaredesign on 2026-10-18.
The R CMD check workflow runs on Linux, macOS and Windows, and on R-devel
GitHub Pages site last deployed 2018-05-28
Show all practicesHide 2 practices
This repository shows signs of AI coding tools.
- Claude Codefirst seen 2026-08-08Commits: at least 6 crediting it in the message
- Claude Opus 56 commits · Aug to Sep 2026
Dependencies
Installing DeclareDesign adds 17 packages (11 with compiled code, 8.9 MB of source tarballs). Heaviest: Rcpp 1.8 MB, RcppEigen 1.7 MB, vctrs 1.0 MB.
Code & Tests
People & History
Previously maintained by Graeme Blair (0.10.0 to 1.0.10).
Pick two releases to compare their code metrics.
- 1.1.1Latest
- RR 4.6.0 released · 2026-04-24
- 1.1.0
- RR 4.5.0 released · 2025-04-11
- RR 4.4.0 released · 2024-04-24
- 1.0.102024-04-21 · diff ↗
- 1.0.82024-03-07 · diff ↗
- 1.0.62024-01-17 · diff ↗
- 1.0.42023-08-08 · diff ↗
- RR 4.3.0 released · 2023-04-21
- 1.0.22023-01-10 · diff ↗
- 1.0.0
- RR 4.2.0 released · 2022-04-22
- 0.30.0
- 0.28.0
- RR 4.1.0 released · 2021-05-18
Show 12 earlier eventsHide 12 earlier events
- 0.26.02021-02-14 · diff ↗ ·
removed 3 exports
compare_design_estimands, reveal_outcomes, reveal_outcomes_handleradded 8 exports
compare_design_inquiries, declare_inquiries, declare_inquiry, declare_model, draw_estimand, draw_inquiries, draw_inquiry, vars - 0.24.02020-11-14 · diff ↗ ·
removed 1 export
get_estimandsadded 6 exports
declare_measurement, declare_test, label_estimator, label_test, reveal_outcomes, tidy_try - RR 4.0.0 released · 2020-04-24
- 0.22.02020-03-24 · diff ↗
- 0.20.0
- 0.18.02019-04-30 · diff ↗ ·
added 6 exports
compare_design_code, compare_design_data, compare_design_estimands, compare_design_estimates, compare_design_summaries, compare_designs - RR 3.6.0 released · 2019-04-26
- 0.16.0
- 0.14.02019-01-07 · diff ↗
- 0.12.02018-11-09 · diff ↗ ·
removed 1 export
declare_designadded 5 exports
diagnose_designs, draw_estimands, draw_estimates, simulate_designs, tidy - 0.10.02018-07-29
- RR 3.5.0 released · 2018-04-23
Package metadata
- First published
- 2018-07-29
- Total releases
- 19 / 8 yrs
- License
- MIT + file LICENSE OSI
- Minimum R
- ≥ 4.1.0
- Download size
- 127 KB
Cite
Cite this package
Run in R for the authors' entry:
citation("DeclareDesign")The package provides a citation file, so citation() returns the authors' own entry.
Cite the R Observatory
For a number measured here: a download total, a coverage figure, an archival date.
From data release v2026-10-20, which the citation names so these numbers can be found later. More on citing and the projects behind them.