Assign reaction conditions to students — assignReactions • maudr

Randomly assigns each student one substrate and one inhibition type (excluding "no_inhibition"), then creates a paired condition for "no_inhibition". Each student therefore has two rows: one inhibited and one uninhibited reaction. The function writes a metadata Excel file to the timestamped assignments_output folder.

Usage

assignReactions(
  student_file = NULL,
  enzyme_file = NULL,
  project_path = getOption("maudr.project_path", "."),
  seed = 1234,
  verbose = TRUE
)

Arguments

student_file: Optional path to Excel file containing student list with columns student_no, first_name, and surname.
enzyme_file: Optional path to Excel file containing enzyme parameters (e.g. reaction_parameters.xlsx).
project_path: Path to the top-level project folder created by initialiseProject(). Defaults to the path registered by the most recent call to initialiseProject(), falling back to the current working directory.
seed: Random seed for reproducibility (default = 1234).
verbose: Logical; if TRUE (default), prints progress messages.

Value

Invisibly returns a list with:

timestamp: Timestamp string identifying the output folder.
metadata: A tibble with all student–reaction assignments.

Details

If no input files are provided, demo datasets bundled with the package are used automatically.

Examples

if (FALSE) { # \dontrun{
proj <- initialiseProject()
assignReactions(project_path = proj, seed = 4321)
} # }