Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/DeclareDesign/DeclareDesign
DeclareDesign: Declare and Diagnose Research Designs
https://github.com/DeclareDesign/DeclareDesign
design r research simulations
Last synced: about 2 months ago
JSON representation
DeclareDesign: Declare and Diagnose Research Designs
- Host: GitHub
- URL: https://github.com/DeclareDesign/DeclareDesign
- Owner: DeclareDesign
- License: other
- Created: 2017-03-21T20:06:16.000Z (almost 8 years ago)
- Default Branch: main
- Last Pushed: 2024-04-20T01:18:26.000Z (8 months ago)
- Last Synced: 2024-10-28T17:26:33.297Z (2 months ago)
- Topics: design, r, research, simulations
- Language: R
- Homepage: https://declaredesign.org
- Size: 13.7 MB
- Stars: 100
- Watchers: 14
- Forks: 12
- Open Issues: 26
-
Metadata Files:
- Readme: README.Rmd
- License: LICENSE
Awesome Lists containing this project
README
---
output:
github_document
title: "DeclareDesign: Declare and Diagnose Research Designs"
---
```{r echo=FALSE, message = FALSE, warning = FALSE, error = FALSE}
set.seed(42)
options(digits=2)
library(tidyverse)
library(knitr)
knitr::opts_chunk$set(warning = FALSE, error = FALSE, message = FALSE)
```
[](https://cran.r-project.org/package=DeclareDesign)
[](https://r-pkg.org/pkg/DeclareDesign)
[](https://github.com/DeclareDesign/DeclareDesign/actions)
[](https://codecov.io/gh/DeclareDesign/DeclareDesign)
[](https://softwarecite.com/package/DeclareDesign)
DeclareDesign is a system for describing research designs in code and simulating them in order to understand their properties. Because DeclareDesign employs a consistent grammar of designs, you can focus on the intellectually challenging part -- designing good research studies -- without having to code up simulations from scratch. For more, see [declaredesign.org](https://declaredesign.org).
## Installation
To install the latest stable release of **DeclareDesign**, please ensure that you are running version 3.5 or later of R and run the following code:
```{r, eval=F}
install.packages("DeclareDesign")
```
## Usage
Designs are declared by adding together design elements. Here's a minimal example that describes a 100 unit randomized controlled trial with a binary outcome. Half the units are assigned to treatment and the remainder to control. The true value of the average treatment effect is 0.05 and it will be estimated with the difference-in-means estimator. The diagnosis shows that the study is unbiased but underpowered.
```{r, eval = TRUE, message=FALSE}
library(DeclareDesign)
design <-
declare_model(
N = 100,
potential_outcomes(Y ~ rbinom(N, size = 1, prob = 0.5 + 0.05 * Z))
) +
declare_inquiry(ATE = 0.05) +
declare_assignment(Z = complete_ra(N, m = 50)) +
declare_measurement(Y = reveal_outcomes(Y ~ Z)) +
declare_estimator(Y ~ Z, .method = lm_robust, inquiry = "ATE")
diagnosands <-
declare_diagnosands(bias = mean(estimate - estimand),
power = mean(p.value <= 0.05))
diagnosis <- diagnose_design(design, diagnosands = diagnosands)
```
```{r, eval = FALSE}
diagnosis
```
```{r, echo = FALSE}
knitr::kable(get_diagnosands(diagnosis) %>% select(-term, -design), col.names = c("Inquiry", "Estimator", "Outcome", "Bias", "SE(Bias)", "Power", "SE(Power)", "n sims"), digits = 3)
```
## Companion software
The core DeclareDesign package relies on four companion packages, each of which is useful in its own right.
1. [randomizr](https://declaredesign.org/r/randomizr/): Easy to use tools for common forms of random assignment and sampling.
2. [fabricatr](https://declaredesign.org/r/fabricatr/): Imagine your data before you collect it.
3. [estimatr](https://declaredesign.org/r/estimatr/): Fast estimators for social scientists.
4. [DesignLibrary](https://declaredesign.org/r/designlibrary/): Templates to quickly adopt and adapt common research designs.
## Learning DeclareDesign
1. To get started, have a look at this vignette on [the idea behind DeclareDesign](https://declaredesign.org/getting-started/), which covers the main functionality of the software.
2. For an explanation of the philosophy behind DeclareDesign, examples in code and words of declaring and diagnosing common research designs in the social sciences, as well as examples of how to incorporate DeclareDesign into your own research, see the book [Research Design in the Social Sciences](https://book.declaredesign.org) (Blair, Coppock, Humphreys, 2023).
## Package structure
Each of these `declare_*()` functions returns a *function*.
1. `declare_model()` (describes dimensions and distributions over the variables, including potential outcomes)
2. `declare_inquiry()` (takes variables in the model and calculates estimand value)
3. `declare_sampling()` (takes a population and selects a sample)
4. `declare_assignment()` (takes a population or sample and adds treatment assignments)
5. `declare_measurement()` (takes data and adds measured values)
6. `declare_estimator()` (takes data produced by sampling, assignment, and measurement and returns estimates linked to inquiries)
7. `declare_test()` (takes data produced by sampling, assignment, and measurement and returns the result of a test)
To *declare a design*, connect the components of your design with the + operator.
Once you have declared your design, there are four core post-design-declaration commands used to modify or diagnose your design:
1. `diagnose_design()` (takes a design and returns simulations and diagnosis)
2. `draw_data()` (takes a design and returns a single draw of the data)
3. `draw_estimates()` (takes a design and returns a single simulation of estimates)
4. `draw_estimands()` (takes a design and returns a single simulation of estimands)
A few other features:
1. A designer is a function that takes parameters (e.g., `N`) and returns a design. `expand_design()` is a function of a designer and parameters that return a design.
2. You can change the diagnosands with `declare_diagnosands()`.
---
This project was generously supported by a grant from the [Laura and John Arnold Foundation](http://www.arnoldfoundation.org) and seed funding from [EGAP](http://egap.org).