Assess the expected information content wrt parameters, given a dosing and observation schedule.

informationContent_IQRnlmeProject.Rd

This function allows to predict the information content in data of future studies, given the planned dosing and observation schedules. All with respect to parameters in a predefined model structure.

informationContent_IQRnlmeProject(
  projectPath,
  ...,
  sampling = NULL,
  output = NULL,
  dosing = NULL,
  pertSize = 10,
  filename = NULL,
  verbose = TRUE
)

Arguments

projectPath

Path to an NLME project folder - from this project both the structural model and the population mean parameterization is obtained.

...

Additional arguments, passed to the simulator as options. see sim_IQRmodel for integrator options.

sampling

Vector with sampling times (for all considered OUTPUTs in the model the same). It is possible to also define sampling as a list of these lists explained above to be able to code for several different study arms or studies. In this case also the "dosing" input argument needs to be a list - as long as the sampling list.

output

A vector with model output names (OUTPUT1, OUTPUT2, etc.) which are considered for the analysis. By default all present OUTPUT* are used. The same sampling is applied to all outputs (for now ... can be changed if desired).

dosing

An single IQRdosing object or a list of IQRdosing objects. Such a list needs to have the same length as the corresponding sampling list.

pertSize

Relative parameter perturbations are used (in percent)

filename

Path where to write out the resulting figures as a PDF file.

verbose

Logical. If TRUE then informative input might be shown in the console.

Value

If no filename is provided, then the resulting plot is returned as a ggplot object with the plotting data attached as attribute plotData

Details

It is simply based on sensitivity analysis wrt to changes in the model parameters and correlation of the sensitivity trajectories.

Assessed will be the impact of changes in single model parameters on the readout at given observation times. The median of these predicted observations will be calculated and normalized sensitivities plotted as barplot.

What is this function good for? Just an example: If you have densly sampled data from Phase II studies and get a load of sparsly sampled Phase III data in. Then this function might support you in the selection of the parameters that you want to consider for refitting on all data together.

Covariates, random effects, residual errors are NOT taken into account! Population mean estimates of parameters are used!

See also

Other IQRnlmeProject: IQRnlmeEst(), IQRnlmeProject(), addCovariateToModelSpec_IQRest(), addPar_modelSpec(), as_IQRnlmeProjectMulti(), as_IQRnlmeProject(), bootstrap_IQRnlmeProject(), compareModels_IQRnlmeProjectMulti(), convertETAINDIVPRED_IQRnlmeProject(), covariateEffect_IQRnlmeProject(), data_IQRest(), dosing_IQRest(), duplicate_IQRnlmeProject(), eigenvalues_IQRnlmeProject(), exportVirtualSubjects_IQRnlmeProject(), getData_IQRnlmeProject(), getETAs_IQRnlmeProject(), getEst_IQRnlmeProject(), getHeader_IQRnlmeProject(), getIndivParameters_IQRnlmeProject(), getIndivPredictions_IQRnlmeProject(), getModel_IQRnlmeProject(), getObsPred_IQRnlmeProject(), getPopParameters_IQRnlmeProject(), getResults_IQRnlmeProjectMulti(), getResults_IQRnlmeProject(), hasrun_IQRnlmeProjectMulti(), hasrun_IQRnlmeProject(), is_IQRnlmeEst(), is_IQRnlmeProjectMulti(), is_IQRnlmeProject(), is_MONOLIX_IQRnlmeProject(), is_NLMIXR_IQRnlmeProject(), is_NONMEM_IQRnlmeProject(), modelSpec_IQRest(), outlier_IQRnlmeProject(), plot.IQRnlmeProjectMulti(), plot.IQRnlmeProject(), plotBLQVPC_IQRdataVPC(), plotConvergence_IQRnlmeProject(), plotETACOV_IQRnlmeProject(), plotETA_IQRnlmeProject(), plotGOF_IQRnlmeProject(), plotINDIVSIM_IQRnlmeProject(), plotINDIV_IQRnlmeProject(), plotVPC_IQRdataVPC(), pred_IQRnlmeProject(), print.IQRnlmeEst(), print.IQRnlmeProjectMulti(), print.IQRnlmeProject(), print_modelSpec(), run_IQRnlmeProjectMulti(), run_IQRnlmeProject(), sample_IQRnlmeProject(), scm_IQRnlmeProject(), summary.IQRnlmeProjectMulti(), summary.IQRnlmeProject(), summaryComments_IQRnlmeProjectMulti(), summaryCorrelations_IQRnlmeProjectMulti(), summaryCovariates_IQRnlmeProjectMulti(), summaryParameters_IQRnlmeProjectMulti(), vpc_IQRnlmeProject()

Other Sensitivity Analysis: print.IQRsensitivity(), sensitivity_IQRmodel()