augment_factorial: Add factorial conditions to existing rows

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

Add factorial conditions to existing rows

Description

Add factorial conditions to existing rows

Usage

augment_factorial(data, factors, coding = c("dummy", "effect", "level"))

Arguments

data	Input base data.frame, with at least one row.
factors	Named numeric vector of whole numbers giving the number of levels of each factor. Every entry must be at least 2.
coding	Factor coding passed to factorial_design(): "dummy" (the default), "effect" or "level".

Value

A simulab_sim base data.frame with one row per row of data crossed with every design condition, so nrow(data) * prod(factors) rows: the columns of data followed by one column per factor. The design component holds the distinct conditions, one row each.

Examples

data <- data.frame(id = 1:12)
result <- augment_factorial(data, factors = c(dose = 3L, timing = 2L))
head(result)

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