simulate_batch: Batch simulation of several effect scenarios

In cvasi: Calibration, Validation, and Simulation of TKTD Models

Batch simulation of several effect scenarios

Description

An effect scenario contains only one exposure level. Consequently, the simulation of an effect scenario (e.g. metsulfuron %>% simulate will return the results for one exposure level only). However, in a laboratory experiment examining the effects of different exposure levels on a biological system, a batch simulation approach would involve running multiple simulations with varying exposure or treatment conditions. To illustrate, if the objective is to examine the impact of a substance on cell growth, the simulation model could be designed to replicate the cell growth dynamics under varying concentrations of the substance. Each simulation run would represent a specific exposure level, ranging from low to high concentrations of the chemical. To simulate such a laboratory experiment, the simulate_batch function can be used. All exposure series are saved in the treatment argument. The first column contains the time, the second column the concentration, and the third column the trial name (exposure level, e.g. 'T1', 'T2', 'T3').

Usage

simulate_batch(model_base, treatments, param_sample = NULL)

Arguments

model_base	effect scenario object with mean parameters
treatments	treatments exposure levels as data frame (time, conc, trial)
param_sample	data.frame with parameter sample

Value

a data.frame with simulation results

Examples

exposure <- data.frame(time = Schmitt2013$t,
            conc = Schmitt2013$conc,
           trial = Schmitt2013$ID)

sim_result <- simulate_batch(model_base = metsulfuron,
                            treatments = exposure)

cvasi documentation built on Sept. 23, 2024, 9:08 a.m.