VPC documentation
The VPC is a widely used diagnostic tool in pharmacometrics (see e.g. here), showing how certain statistics (percentiles) for observed data compare to those same statistics for data simulated from a model. Historically, these plots are most commonly created using PsN and Xpose, using NONMEM as the simulation engine) or with Monolix. The aim of this vpc package for R is to provide:
- fully R-based computation of the VPC with plotting handled by
ggplot2 - package that is more flexible regarding input (use simulated data from R, NONMEM, Monolix, Stan, or any other simulation tool)
- easier to customize, e.g. request any prediction / confidence interval or binning strategy upon plotting.
- easier to extend / theme
The package is available on CRAN, and is being developed at GitHub. This documentation is still in development, and should be seen as a more convenient overview of core functionality, compared to the more detailed in-package help. please let us know if you feel some essential information is missing.
Quick start
install.packages("vpc")
library("vpc")
vpc(sim = simple_data$sim, obs = simple_data$obs)
vpc(sim = simple_data$sim, obs = simple_data$obs, lloq = 20)
What's new
Recent additions to the package (see NEWS.md for the full changelog):
- Reference-corrected VPC (rcVPC) via the new
sim_refargument tovpc(). See Prediction / reference correction. - Additive (LTBS) prediction-correction with
pred_corr_method = "additive"(orltbs = TRUE), and consistent handling of censored data in pcVPCs. See Prediction / reference correction. - Per-stratum binning with
bin_by_strata = TRUE, or bins given per stratum as a list. See Binning. - Outlier areas:
show = list(outlier_areas = TRUE)highlights where an observed percentile falls outside the simulated confidence interval, as in Monolix VPCs. See Appearance. - Color stratification for
vpc_cens()withstratify_color. See Censored data. - Consistent handling of censored and missing data: censored values are
-Inf/Infthroughout, and missing values are never counted as censored. See Censored data. - Confidence interval of simulated Kaplan-Meier curves can now be set with
ci_siminvpc_tte(). See Time-to-event data. - Character (non-numeric) ID columns, e.g. from nlmixr2, are now supported.