qsim {mrgsolve} | R Documentation |
Basic, simple simulation from model object
Description
This is just a lighter version of mrgsim()
, with fewer options but with
better efficiency in certain cases. See Details.
Usage
qsim(
x,
data,
idata = no_idata_set(),
obsonly = FALSE,
tgrid = NULL,
recsort = 1,
tad = FALSE,
Req = NULL,
outvars = Req,
skip_init_calc = FALSE,
output = "mrgsims"
)
Arguments
x |
the model object. |
data |
can be either event object or data set. |
idata |
a matrix or data frame of model parameters,
one parameter per row (see |
obsonly |
if |
tgrid |
a tgrid object; or a numeric vector of simulation times
or another object with an |
recsort |
record sorting flag. Default value is 1. Possible values
are 1,2,3,4: 1 and 2 put doses in a data set after padded observations at
the same time; 3 and 4 put those doses before padded observations at the
same time. 2 and 4 will put doses scheduled through |
tad |
when |
Req |
synonym for |
outvars |
output items to request; if missing, then only captured items will be returned in the output. |
skip_init_calc |
don't use |
output |
output data type; the default is |
Details
qsim()
mainly cuts some of the overhead from the simulation. So, the
primary efficiency gain from using qsim()
comes when the simulation
executes very quickly. It is unlikely you will see a big performance
difference between qsim()
and mrgsim()
when the model is difficult to
solve or if there is a large input data set.
There is no pipeline interface for this function; all configuration options
(see Arguments) must be passed as formal arguments to the function.
You can't carry_out
, Request
specific columns, or pass items in for update.
Some other limitations, but only convenience-related. See Arguments for
available options. Specifically, there is no ...
argument for this function.
Use the update()
method to update the model object.
See Also
mrgsim_q()
, mrgsim()
, mrgsim_variants
Examples
mod <- mrgsolve::house()
dose <- ev(amt = 100)
out <- qsim(mod,dose)