The full set of model parameters for the flat model includes `Vdist`, `Fgutabs`, and `Rblood2plasma`. Whether each one can be estimated from the data depends on what routes of administration are included in the data.
get_params_flat(
data,
lower_bound = ggplot2::aes(Vdist = 0.01, Fgutabs = 0, Fgutabs_Vdist = 0.01,
Rblood2plasma = 0.01),
upper_bound = ggplot2::aes(Vdist = 100, Fgutabs = 1, Fgutabs_Vdist = 100, Rblood2plasma
= 100),
param_units = ggplot2::aes(Vdist = paste0("(", unique(Dose.Units), ")", "/", "(",
unique(Conc.Units), ")"), Fgutabs = "unitless fraction", Fgutabs_Vdist = paste0("(",
unique(Conc.Units), ")", "/", "(", unique(Dose.Units), ")"), Rblood2plasma =
"unitless ratio")
)A `data.frame`with the following variables: - `param_name`: Character: Names of the model parameters - `param_units`: Character: Units of the model parameters - `optimize_param`: TRUE if each parameter is to be estimated from the data; FALSE otherwise - `use_param`: TRUE if each parameter is to be used in evaluating the model; FALSE otherwise -`lower_bounds`: Numeric: The lower bounds for each parameter - `upper_bounds`: Numeric: The upper bounds for each parameter - `start`: Numeric: The starting guesses for each parameter
The data set to be fitted (e.g. the result of [preprocess_data()])
A mapping specified using a call to [ggplot2::aes()], giving the lower bounds for each variable, as expressions which may include variables in `data`.
A mapping specified using a call to [ggplot2::aes()], giving the upper bounds for each variable, as expressions which may include variables in `data`.
A mapping specified using a call to [ggplot2::aes()], giving the units for each variable, as expressions which may include variables in `data`.
Caroline Ring
## IV data, no oral data
If IV dosing data are available, but no oral dosing data are available, then only the parameter `Vdist` will be estimated from the data. The parameter `Fgutabs` cannot be estimated from IV data alone and will not be used to evaluate the model.
## Oral data, no IV data
If oral dosing data are available, but no IV dosing data are available, then the parameters `Fgutabs` and `Vdist` cannot be identified separately. From oral data alone, only the ratio `Fgutabs/Vdist` can be identified. This ratio is represented by a single parameter named `Fgutabs_Vdist`. `Fgutabs` and `Vdist` will not be estimated nor used in model evaluation, but `Fgutabs_Vdist` will be estimated.
## Oral data and IV data
If both oral and IV dosing data are available, then `Vdist` and `Fgutabs` will both be estimated from the data.
# Blood and plasma data
If both blood and plasma data are available, then `Rblood2plasma` will be estimated from the data.
# Only one of blood or plasma data
If only one of blood or plasma data are available, then `Rblood2plasma` will be held constant at 1, not estimated from the data.
# Default lower and upper bounds for each parameter
## Default lower and upper bounds for `Vdist`
By default, the lower bound for `Vdist` is 0.01, and the upper bound for `Vdist` is 100. These values were chosen based on professional judgment.
## Default lower and upper bounds for `Fgutabs`
By default, the lower bound for `Fgutabs` is 0.0, and the upper bound for `Fgutabs` is 1. These are simply the bounds of the physically-meaningful range for a fraction.
## Default lower and upper bounds for `Fgutabs_Vdist`
By default, the lower bound for the ratio `Fgutabs_Vdist` is 0.01, and the upper bound is 100. These values were chosen based on professional judgment.
## Default lower and upper bounds for `Rblood2plasma`
By default, the lower bound for the blood:plasma partition coefficient `Rblood2plasma` is 0.01, and the upper bound is 100. These values were chosen based on professional judgment.
# Starting values for each parameter
Starting values for each parameter (starting guesses for the numerical optimizer) are derived from the data using [get_starts_flat()].
If the starting values returned by [get_starts_flat()] fall outside the bounds for any parameter(s), then the starting value will be reset to a value halfway between the lower and upper bounds for that parameter.
Other flat model functions:
auc_flat(),
cp_flat(),
get_starts_flat()
Other get_params functions:
get_params_1comp(),
get_params_1comp_cl(),
get_params_1comp_fup(),
get_params_2comp()
Other built-in model functions:
auc_1comp(),
auc_1comp_cl(),
auc_2comp(),
auc_flat(),
cp_1comp(),
cp_1comp_cl(),
cp_2comp(),
cp_2comp_dt(),
cp_flat(),
get_params_1comp(),
get_params_1comp_cl(),
get_params_1comp_fup(),
get_params_2comp(),
get_starts_1comp(),
get_starts_1comp_cl(),
get_starts_1comp_fup(),
get_starts_2comp(),
get_starts_flat(),
tkstats_2comp(),
transformed_params_2comp()