simulate_ttest: Simulate a two-group design

In simulab: Simulates a Wide Variety of Data Shapes, Sizes and Distributions

Simulate a two-group design

Description

Simulate a two-group design

Usage

simulate_ttest(
  n_a = 50L,
  n_b = 50L,
  mean_a = NULL,
  mean_b = NULL,
  sd_a = 1,
  sd_b = 1,
  labels = c("A", "B"),
  outcome = "outcome",
  seed = NULL,
  batch = NULL
)

Arguments

n_a, n_b	Group sample sizes, each defaulting to 50.
mean_a, mean_b	Group means. A mean left NULL (the default) is drawn from the standard normal distribution and rounded to two decimals, inside the same seeded draw as the data, and is reported in the parameters table.
sd_a, sd_b	Positive group standard deviations.
labels	Two group labels.
outcome	Name of the outcome variable.
seed	Optional random seed.
batch	Optional single positive whole number. When given, the simulator runs batch times and returns a plain list of batch results, each exactly what the same call without batch returns. With a seed, every dataset gets its own seed drawn from seed, so the whole batch is reproducible; without one the datasets are consecutive draws from the session's random-number stream. The default NULL returns a single result.

Value

A simulab_sim base data.frame with one row per observation and columns id, group and outcome (renamed by outcome). Two tidy tables come from as.data.frame(): what = "parameters" has one row per group with columns group, n, mean and sd; what = "effects" has a single row with columns contrast, mean_difference, pooled_sd and cohens_d, the population Cohen's d formed from the sample-size-weighted pooled standard deviation.

Examples

result <- simulate_ttest(n_a = 40, n_b = 40, mean_a = 0, mean_b = 0.6, seed = 1)
head(result)
as.data.frame(result, what = "parameters")

# With no arguments, the group means are drawn and reported.
drawn <- simulate_ttest(seed = 1)
as.data.frame(drawn, what = "parameters")

simulab documentation built on Oct. 15, 2026, 5:08 p.m.