Describes the structural model, the parameters with between-subject variability, the residual error and covariate effects. Nothing is compiled: the structure selects one of the precompiled closed-form models.
Arguments
- structure
"1cmt"or"2cmt".- route
"iv"(bolus, or infusion when the data haveRATE > 0) or"oral"(first-order absorption).- iiv
Character vector of parameters with log-normal between-subject variability.
- error
Residual error:
"additive","proportional","combined"or"log"(additive on the log scale; DV must be positive).- covariates
A list of formulas, one or more per parameter, such as
CL ~ (WT / 70)^0.75(fixed exponent),CL ~ (WT / 70)^b_wt(estimated exponent namedb_wt),CL ~ exp(b_age * (AGE - 40))(estimated) orCL ~ (SEX == 1)^b_sex(estimated effect of a category). Terms can be multiplied:CL ~ (WT / 70)^0.75 * (CRCL / 100)^b_crcl.Logical; estimate correlations between the random effects.
- ka_faster
Logical, oral models only. If
TRUE, the typical KA is constrained to be larger than the typical disposition rate (k = CL/V for 1-cmt, the fast rate alpha for 2-cmt) of a subject at the covariate reference values. This removes the flip-flop mode in which KA and the disposition rate swap. Use it only when absorption is known to be faster than distribution; it is wrong for flip-flop drugs such as many extended-release forms. The prior density on KA is kept and set to zero for KA <= rate (not renormalised). DefaultFALSE.