Loads the declared design at its defaults. Named ... values are applied
with DeclareDesign::redesign(). The design object is the source of
truth for which names can be changed; see get_args(). Vector parameters
are wrapped so redesign() replaces the whole vector instead of sweeping.
A list-valued parameter (kind = "list") follows the same rule read
structurally: a bare list replaces the parameter whole, and a list whose
every element is itself a list sweeps over those lists, one design each. So
make_design("conjoint", levels_list = list(a = "x", b = "y")) builds one
design, and make_design("conjoint", levels_list = list(l1, l2)) builds two.
YAML coupled: drivers (for example m_arms) emit a message() when
dependents do not match in length; redesign() still runs.
Usage
make_design(
.design = c("two_arm_simple", "two_arm_flexible", "three_arm", "two_by_two",
"two_arm_block_cluster", "two_arm_with_blocks", "two_arm_attrition",
"factorial_2x2x2", "multiarm_trial", "pretest_posttest", "randomized_response",
"mediation_analysis", "binary_iv", "cluster_sampling", "factorial",
"process_tracing_bayes", "regression_discontinuity_polynomial", "spillover",
"two_arm_covariate", "audit_experiment", "audit_intervention", "baseline_over_N",
"blocked_and_clustered", "bootstrapped", "cluster_random_sampling",
"conditional_expectation", "conjoint", "covariate_adjustment",
"declaration_using_declare", "design_10_2", "design_10_4", "diff_in_diff",
"encouragement", "example_declaration", "factorial_2x2", "instrumental_variables",
"italian_village", "italian_village_bayes", "italian_village_continued",
"latent_variables", "lin_estimator", "linear_regression", "list_experiment",
"list_or_direct_questions", "logit_probit_ols", "matching", "multi_site_studies",
"multilevel", "multilevel_answer_strategies",
"network_experiment",
"pate_with_sampling", "population_estimands", "process_tracing", "random_forests",
"randomization_inference", "randomized_saturation", "regression_discontinuity",
"regression_discontinuity_fuzzy", "simple_random_sampling", "single_period_two_arm",
"stepped_wedge", "structural_estimation", "subgroup_effects", "survey_nonresponse",
"trust_game", "two_arm_bare_bones", "two_arm_block_rdss", "two_arm_rdss_1",
"two_arm_rdss_2", "two_arm_trial_rdss", "two_arm_with_blocks_rdss",
"two_outcome_model_a", "two_outcome_model_b", "uncertainty_over_effect_size",
"village_campaign", "17.1", "17.2", "11.1", "18.5", "9.5", "15.3", "11.4", "17.5",
"18.2", "10.1", "10.2", "10.4", "16.3", "18.8", "5.1", "18.7", "16.4", "9.1", "9.3",
"9.2", "15.6", "18.3", "13.1", "17.3", "17.4", "11.5", "16.2", "19.4", "15.4",
"15.5", "18.13", "4.1", "7.1", "16.1b", "19.1", "9.7", "18.12", "16.5", "16.6",
"15.1", "18.11", "18.10", "19.2", "18.6", "15.2", "17.6", "11.3", "18.4", "2.1",
"13.2", "18.1",
"2.2", "10.3a", "10.3b", "11.2", "12.1a"),
...
)Arguments
- .design
Design id or book alias. Defaults to
"two_arm_simple"(or the first installed design). Tab-completion offers the full library list. Dotted so that a design parameter such asdcannot partially match it.- ...
Named parameter values passed to
redesign(), and optionally.expand, whichredesign()uses to choose between crossing swept parameters (TRUE, the default) and zipping them (FALSE).
Details
In RStudio, Positron, and other tools that complete from formals, typing
make_design(" and pressing Tab lists installed design ids (and aliases).
See list_designs() for the same catalogue in the console.
Examples
make_design()
#> Research design with 6 steps
#>
#> Step 1 (parameters): declare_parameters(N = 1000, b = 0.2)
#> Step 2 (model): declare_model(N = N, Y_Z_0 = rnorm(n()), Y_Z_1 = Y_Z_0 + b)
#> Step 3 (inquiry): declare_inquiry(ATE = mean(Y_Z_1 - Y_Z_0))
#> Step 4 (assignment): declare_assignment(Z = complete_ra(n()))
#> Step 5 (measurement): declare_measurement(Y = Z * Y_Z_1 + (1 - Z) * Y_Z_0)
#> Step 6 (estimator): declare_estimator(Y ~ Z, .method = difference_in_means, inquiry = "ATE")
#>
#> Parameters and objects the design refers to:
#> name value kind declared steps
#> b 0.2 scalar TRUE 1, 2
#> N 1000 scalar TRUE 1, 2
make_design("two_arm_simple", b = 0.5)
#> Research design with 6 steps
#>
#> Step 1 (parameters): declare_parameters(N = 1000, b = 0.2)
#> Step 2 (model): declare_model(N = N, Y_Z_0 = rnorm(n()), Y_Z_1 = Y_Z_0 + b)
#> Step 3 (inquiry): declare_inquiry(ATE = mean(Y_Z_1 - Y_Z_0))
#> Step 4 (assignment): declare_assignment(Z = complete_ra(n()))
#> Step 5 (measurement): declare_measurement(Y = Z * Y_Z_1 + (1 - Z) * Y_Z_0)
#> Step 6 (estimator): declare_estimator(Y ~ Z, .method = difference_in_means, inquiry = "ATE")
#>
#> Parameters and objects the design refers to:
#> name value kind declared steps
#> b 0.5 scalar TRUE 1, 2
#> N 1000 scalar TRUE 1, 2
make_design("2.1", b = 0.5) # book alias
#> Research design with 7 steps
#>
#> Step 1 (parameters): declare_parameters(N = 1000, b = 0, n = 150)
#> Step 2 (model): declare_model(N = N, X = sample(c(0, 1), N, replace = TRUE), potential_outcomes(Y ~ b * X + runif(1, 0, 0.5) * Z + rnorm(N)))
#> Step 3 (inquiry): declare_inquiry(ATE = mean(Y_Z_1) - mean(Y_Z_0))
#> Step 4 (sampling): declare_sampling(S = complete_rs(N = N, n = n), filter = S == 1)
#> Step 5 (assignment): declare_assignment(Z = complete_ra(N))
#> Step 6 (measurement): declare_measurement(Y = reveal_outcomes(Y ~ Z))
#> Step 7 (estimator): declare_estimator(Y ~ Z, .method = difference_in_means, inquiry = "ATE")
#>
#> Parameters and objects the design refers to:
#> name value kind declared steps
#> b 0.5 scalar TRUE 1, 2
#> N 1000 scalar TRUE 1, 2, 4
#> n 150 scalar TRUE 1, 4